connman-services-switchover manual

critical

Image Types:
basesdk-amd64 / hmi-armhf / hmi-arm64 / hmi-amd64 / sdk-amd64
Image Deployment:
APT, OSTree
Type:
functional

Description

Tests Network connection management: ensuring that ConnMan can connect to actual networks even after the device under test is rebooted

Pre Conditions

  1. Ensure Rootfs is remounted as read/write.
    2. $ sudo mount -o remount,rw /
  2. Install dependencies
    3. $ sudo apt install wget
  3. Restart the system to restore the filesystem state to read-only before running the test.
    4. $ sudo reboot
  4. The device must have wifi, otherwise skip this test.
  5. A mobile Hot-Spot must be setup
  6. Please note that connman disables wifi by default on a fresh image. To enable:
    7. $ connmanctl enable wifi
  7. If it's already enabled, connmanctl will give the error "Error wifi: Already enabled" that may be ignored.

Execution Steps

  1. Run the ConnMan CLI Interface:
    2. $ connmanctl
  2. When run without arguments, connmanctl will launch in interactive mode with a "connmanctl>" prompt.
  3. Scan wifi:
    4. $connmanctl> scan wifi
  4. Wait for "Scan completed for wifi" before continuing (this may take a few seconds and will appear above connmanctl prompt).
  5. Turn on the agent, to manage additional information if required:
    6. $connmanctl> agent on
  6. connmanctl should return "Agent registered".
  7. List services available:
    8. $connmanctl> services
  8. Select required service and use the "service ID" (second column) to connect:
    9. $connmanctl> connect <service ID>
  9. If it's connecting to a Wi-Fi service that needs additional information connmanctl will output an "Agent RequestInput (…)" line followed by a prompt for the required information, such as "Passphrase? ".
  10. Ensure ConnMan returns "Connected <service ID>" before continuing.
  11. Quit from connmanctl interactive mode with:
    12. $connmanctl> quit
  12. On the terminal enter $wget www.google.com
  13. Wget is successfull and the connection is establised via Wi-Fi
  14. Disconnect from the Wi-Fi network
    15. $ connmanctl
    $connmanctl> scan wifi
  15. Connect to the mobile hot-spot that you have setup on your phone by entering the right password
  16. Quit from connmanctl interactive mode with:
    17. $connmanctl> quit
    $ connmanctl
    $connmanctl> scan wifi
    $ "Connect back to the Wi-Fi network"

Expected

If success "Connected <service ID>" will be printed by connmanctl, otherwise "Agent ReportError <service ID>" will be printed.

On executing the wget command the connection should succeed and you should be able to ping any website

On switching over from the mobile hot-spot to Wi-Fi network connman should not ask the user to re-enter the password for the Wi-Fi network

Notes

  • Warning: Connman changes are persistent (over reboot!). After finishing testing, it might be wise to perform the dhcp test to ensure that the network is in a sensible state.
  • For ALL tests the enable step will give an "In progress" error if the device is already enabled. This is to be expected.
  • When testing the SDK image in VirtualBox with an Asus USB-N10 Wireless adapter, firmware-realtek needs to be installed on the host.