Ubuntu Wiki

• Test plan for component: https://wiki.ubuntu.com/Process/Merges/TestPlans/ofono

• Component Checklist: https://wiki.ubuntu.com/Process/Merges/Checklists/Common

• Trunk URL: https://github.com/rilmodem/ofono

• Ubuntu Package URL (LP): http://launchpad.net/ubuntu/+source/ofono

---

1. Send a USSD command with a text reply

Purpose

This test case verifies that we can send simple USSD commands to the network. The commands that we can use depend on the operator. Many operators use USSD commands to retrieve the current line balance, for instance.

Steps

- send-ussd [modem] <string>
# This command will return a string with the text returned by the network.

Example strings:

Note - USSD codes are not standardized and each operator has its own ones. Therefore, the following codes only work for the specified operators.

<string> = “*118#” - returns the current time and date (Vodafone, Spain).
<string> = “*3282#” - triggers operator to send data usage report SMS ( AT&T, US )

2. Navigate through a USSD-based menu

Purpose

This test case verifies that we can establish a USSD dialogue with a network application. Some operator have menu driven applications that use USSD as bearer. They are invoked with an initial USSD command.

Requirements

This test case requires an operator that provides some feature that leverages USSD-based menuing.

NOTE - the major US operators don't support any features requiring USSD menuing, so this feature must be tested with a non-US SIM ( and possibly outside of the US if this test case doesn't work while roaming ).

Steps

- monitor-ofono
# The output will show the USSD requests coming from the network
# We open another shell window and send commands from there
- send-ussd [modem] <string>
# This command will return a string with the text returned by the network.
# We should see in the monitor-ofono window something like:
{SupplementaryServices} [/ril_0] RequestReceived Choose an option:
1.Top-up
2.Check balance
0.Exit

# We choose one menu option
- send-ussd [modem] “2”

# After this, we can have more menus, or the operator will do an
action like sending an SMS,  the network will set the USSD state
to idle stopping the dialogue, etc. The send-ussd script will wait
for input from the user whenever it receives a new network initiated
USSD request.

Example strings:

Note - USSD codes are not standardized and each operator has its own ones. Therefore, the following codes only work for the specified operators.

<string> = "*255#". Menu for managing gift vouchers (Vodafone, Spain).
<string> = "*123#". Menu for buying credit (pay as you go cards, Vodafone, Spain).

3. Receive a USSD notification

Purpose

This test case verifies that we can receive USSD notification from the network. Some operators use them to send, for instance, a notification with the remaining balance after sending an SMS or finishing a voice call.

Requirements

NOTE - There are not many operators that implement this. One known to do is Tesco UK, which sends USSD notifications with the remaining balance after sending a SMS for pays as you go SIMs.

Steps

- monitor-ofono
# Open another shell
- dial-number [modem] <number>
# Accept call to <number>
- hangup-all [modem]
# Check that we see a message in monitor-ofono of the form
{SupplementaryServices} [/ril_0] NotificationReceived <string>