connman-services manual

critical

Image Types:
basesdk-amd64 / sdk-amd64 / target-armhf-internal / target-amd64
Image Deployment:
APT, OSTree
Type:
functional

Description

Tests Network connection management: ensuring that ConnMan can connect to actual networks is part of strategic network management functionality.


Pre Conditions

  1. The device must have wifi, otherwise skip this test.
  2. Please note that connman disables wifi by default on a fresh image. To enable:
  3. $ connmanctl enable wifi

  4. 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

  3. When run without arguments, connmanctl will launch in interactive mode with a "connmanctl>" prompt.
  4. Scan wifi:
  5. $ scan wifi

  6. Wait for "Scan completed for wifi" before continuing (this may take a few seconds and will appear above connmanctl prompt).
  7. Turn on the agent, to manage additional information if required:
  8. $ agent on

  9. connmanctl should return "Agent registered".
  10. List services available:
  11. $ services

  12. Select required service and use the "service ID" (second column) to connect:
  13. $ connect <service ID>

  14. If it's connecting to a wifi service that needs additional information connmanctl will output an "Agent RequestInput (…)" line followed by a prompt for the required information, such as "Passphrase? ".
  15. Ensure ConnMan returns "Connected <service ID>" before continuing.
  16. Quit from connmanctl interactive mode with:
  17. $ quit

  18. Use the tool to test different kind of security and ConnMan technology: Ethernet, Wi-Fi, cellular and Bluetooth.

Expected

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

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.