Making a Wi-Fi Connection


Connman is a connection manager daemon that lets you manage network connections over Wi-Fi* and is designed for use with embedded devices.

Starting connman

When the connman service starts, wpa_supplicant automatically starts. By default, connman starts at boot time. To prevent automatic start at boot time issue

systemctl disable connman.

Connman has a standard command line client connmanctl. It can run in two modes:

  • In command mode, commands are entered as arguments to the connmanctl command, just like systemctl
  • Interactive mode is started by typing connmanctl without arguments. The prompt will change to connmanctl> to indicate it is waiting for user commands.

You can enter the connmanctl command directly. Enter help to view all available commands. To exit from the connmanctl interactive shell, enter quit or press Ctrl+D. 

Scan Available Networks

To scan for available networks, use the commands:

connmanctl enable wifi
connmanctl scan wifi

To list the available networks found after a scan, enter the following connmanctl services:

Connect to an open AP

To connect to an open network, use the connmanctl connect command and enter the full “wifi_” name.

connmanctl connect wifi_000000000000_1234567890123456_managed_psk

Verify that you are connected to the network by entering the following:

connmanctl state

Connect to a protected AP

For protected access points, you will need to provide some information to the connman daemon at the very least a password or a passphrase.

The commands in this section show how to run connmanctl in interactive mode, which is required for running the agent command. To start interactive mode, enter the following: 


To scan for available Wi-Fi networks, enter the following:  

connmanctl> scan wifi

To list services, enter the following:

connmanctl> services

To register the agent to handle user requests, enter the following:

connmanctl> agent on

To connect to one of the protected services, enter the following:

connmanctl> connect <service>

where <service> is not the name of SSID but the full “wifi_” name.

You might have to enter a passphrase if the selected Wi-Fi network requires authentication. For a WPS connection, enter an empty string for the passphrase so the system can then ask you to enter the WPS PIN or WPS PBC. 

Troubleshooting - "Error getting VPN connections" message when entering connmanctl interface

When trying to access connmanctl, you may see a message similar to the following:

root@intel-corei7-64:~# connmanctl
Error getting VPN connections: The name net.connman.vpn was not provided by any .service

This message is normal and can be ignored.

Troubleshooting - "Not registered" message when trying to connect to Wi-Fi

If you see a "not registered" message when trying to connect the development platform to a Wi-Fi network, make sure that you have turned the agent on. From the command line, enter:

agent on


Tether requires the Wi-Fi* to first be enabled, and then connected via the CONNMAN service:

connmanctl tether wifi <ssid> <password>

The IP address must be manually set for the remote host connecting to the hotspot using the range of to

For more complete information about compiler optimizations, see our Optimization Notice.