ofono

Differences between revisions 27 and 55 (spanning 28 versions)
⇤ ← Revision 27 as of 2014-09-11 12:17:55 →
Size: 5335
Editor: alfonsosanchezbeato
Comment:
← Revision 55 as of 2016-06-30 14:24:21 → ⇥
Size: 5770
Editor: alfonsosanchezbeato
Comment:
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
 * here-location-service-provider/location connectivity API
Line 31: Line 32:
== Device Setup == === Forcing Screen On ===
Line 33: Line 34:
As these tests use oFono’s interfaces directly for testing, it’s sometimes necessary to stop some of the other components of the telephony stack in order to prevent interferrence with the test scripts. With this in mind, it’s best to In general, it can be a good idea to force the display to stay on as ofono and the modem's behavior does change slightly when the screen blanks ( for power-saving ). The screen can be forced to stay unlocked/on by running the following command as root on the device:
Line 35: Line 36:
As ‘root’:

1. Add ofono-scripts directory to PATH ( export PATH=/usr/share/ofono/scripts:$PATH )
2. Stop NetworkManager ( stop network-manager )
3. Stop urfkill ( stop urfkill )
4. Re-start ofono ( restart ofono )
5. Unless otherwise described, set the modem online ( online-modem )

At this point, run ‘list-modems’ to ensure that the modem has come online properly, and begin testing!		 {{{powerd-cli display on}}}
Line 65: Line 58:
 * Test that the device can sent outgoing text messages, and receive incoming text messages  * Test that the device can send outgoing MMS messages, and receive incoming MMS messages
 * Test that the device can send outgoing text messages, and receive incoming text messages
Line 68: Line 62:
 * Test that flight-mode can enabled/disabled and mobile data is properly restored
Line 72: Line 67:
The Dialer and Message Apps are dependent on ofono, although they use the ''phonesim'' driver vs. the usual ''rilmodem'' driver used on actual Touch devices. If a change is being made to the ofono core, plugins, or the upstart job ( packaged as ''ofono.override'' in lxc-android-config, then these autopilot tests should be run on the device. This can be done by running the following steps: The Dialer and Message Apps are dependent on ofono, although they use the ''phonesim'' driver vs. the usual ''rilmodem'' or ''mtk*modem'' drivers used on actual Touch devices. If significant changes have been made to the ofono core ( especially a new upstream release and/or changes involving DBus ), then these tests should be run. Otherwise, they can be considered optional. The tests can be run as follows:
Line 75: Line 70:
 * apt-get update
Line 76: Line 72:
 * reboot the device  * reboot the device, unlock the screen, and pin the screen on using: {{{sudo powerd-cli display on}}} ( on the device )
Line 78: Line 74:
   * phablet-test-run dialer_app
   * phablet-test-run messaging_app		    * phablet-test-run dialer_app; '''reboot'''
   * phablet-test-run messaging_app; '''reboot'''
Line 103: Line 99:
  * Emergency Calling
  * Call Hold / Swap
  * Multi``Party
 * [[/Netreg|Network Registration]]
 * Supplementary Services		   * [[/EmergencyCalling|Emergency Calling]]
  * [[/CallHoldSwap|Call Hold / Swap]]
  * [[MultiParty]]
  * [[/CallBarring|Call Barring]]
  * [[/CallForwarding|Call Forwarding]]
  * [[/CallWaiting|Call Waiting]]
  * [[/SupplementaryServices|Supplementary Services (CLIR, CLIP)]]
 * Network Registration
Line 110: Line 109:
 * GPRS
 * SMS		  * [[/GPRS|GPRS]]
 * [[/SMS|SMS]]
Line 113: Line 112:
 * [[/CallBarring|Call Barring]]
 * [[/CallForwarding|Call Forwarding]]
 * USSD Tests		  * Call Settings
 * [[/USSD Tests|USSD Tests]]
Line 117: Line 115:
 * [[/Bluetooth|Bluetooth]]

== Miscellaneous ==

Recent Intel-sponsored oFono Test Report ( documents test cases ):
 * http://lists.ofono.org/pipermail/ofono/attachments/20131004/aff2cf36/attachment-0001.xlsx

Description

This is a test plan for ofono as used by Ubuntu Touch. It does not cover scenarios and/or test cases for ofono installed on the desktop.

Dependants/Clients

  • connectivity-api
  • network-manager
  • powerd
  • telepathy-ofono
  • Dialer / Messaging Apps
  • network-indicator
  • urfkill
  • here-location-service-provider/location connectivity API

SIM Requirements

Unless specified otherwise, these tests should all be run with a valid unlocked SIM, preferably a primary operator SIM, not a MVNO SIM. The SIM should also be activated and proven to work for data, SMS, and voice before being used.

Dual SIM

This test plan was originally written to test a single SIM device. As dual-SIM support has been added to Ubuntu, it should be noted that this is visible to the rest of the system as a second modem instance. Where there's no difference with a single SIM device, the test cases have been left as is. It should be noted however that when verifying the test cases, you may need to take into account which SIM is being utilized and thus verify the correct modem instance ( /ril0 or /ril_1 ).

Most of the ofono scripts have been modified to work with dual-SIM devices, however if problems are encountered, please file a bug against the ofono (Ubuntu) package.

Forcing Screen On

In general, it can be a good idea to force the display to stay on as ofono and the modem's behavior does change slightly when the screen blanks ( for power-saving ). The screen can be forced to stay unlocked/on by running the following command as root on the device:

powerd-cli display on

Test Plan

Test target device: Nexus 4 with active SIM card Secondary/backup device: TBD

Initial set up:

  • Install latest image on phone
  • Install ofono from the silo PPA
  • Reboot the phone

Manual Tests

Most of the tests below use one or more scripts from the ofono-scripts packages. They're installed by default in the directory /usr/share/ofono/scripts.

Basic Tests

These tests should be run for every upload, as they cover the basic functionality that ofono provides.

  • Test that the device can make outgoing phone calls, and receive incoming phone calls
  • Test that the device can send outgoing MMS messages, and receive incoming MMS messages
  • Test that the device can send outgoing text messages, and receive incoming text messages
  • Test that incoming phone calls and text messages wake the device when the screen is off
  • Test that mobile data connection works by testing Internet connectivity ( launch the browser )
  • Test that flight-mode can enabled/disabled and mobile data is properly restored

  • Verify that no new crash files of ofono clients are found in /var/crash!

Dialer / Messaging Autopilot

The Dialer and Message Apps are dependent on ofono, although they use the phonesim driver vs. the usual rilmodem or mtk*modem drivers used on actual Touch devices. If significant changes have been made to the ofono core ( especially a new upstream release and/or changes involving DBus ), then these tests should be run. Otherwise, they can be considered optional. The tests can be run as follows:

  • make the device writable
  • apt-get update
  • apt-get install dialer-app-autopilot messaging-app-autopilot

  • reboot the device, unlock the screen, and pin the screen on using: sudo powerd-cli display on ( on the device )

  • On the desktop run the following command to run the tests:

    • phablet-test-run dialer_app; reboot

    • phablet-test-run messaging_app; reboot

When finished, run apt-get purge ofono-phonesim-autostart.

Note - it's also a good idea to run these tests on one or more non-RIL devices such as manta or flow to ensure that core ofono changes have not caused any issues with the ofono-phonesim package.

DBus Changes

If any DBus API changes are made ( ie. adding new interfaces, properties, modifying methods, ... ) then sanity checking network indicator and system settings is recommended.

Note - running some of the test cases defined by the client test plans is also a good idea:

The following is the list of function-specific test plans:

Miscellaneous

Recent Intel-sponsored oFono Test Report ( documents test cases ):

Process/Merges/TestPlans/ofono (last edited 2016-06-30 14:24:21 by alfonsosanchezbeato)