Qt Device Utilities WiFi Tutorial

Importing NetworkSettings

Import the NetworkSettings module as follows:

import QtDeviceUtilities.NetworkSettings 1.0

Filtering WiFi Networks

In order to connect to WiFi instead of wired networks, set NetworkSettingsManager in a WiFi filtering mode:

Component.onCompleted: NetworkSettingsManager.services.type = NetworkSettingsType.Wifi;

After you have set the filter, NetworkSettingsManager.services contains the NetworkService objects services representing WiFi networks.

Connecting to WiFi

In order to connect to Wifi, invoke the connectService method on NetworkService.

If no passphrase is needed, connectService connects to a WiFi network and changes the connected property of the selected service.

If a passphrase is needed, NetworkSettingsManager.userAgent emits the showUserCredentialsInput signal. Before a WiFi network is connected, you must provide the passphrase via NetworkSettingsManager.userAgent.setPassPhrase.

To implement the passphrase handling, you must set a signal handler as follows:

Connections {
    target: NetworkSettingsManager.userAgent
    onShowUserCredentialsInput : {
    // obtain the passphrase and set it
    }
    onError: {
    // handle errors
    }
}

Implementing User Interface

When you are implementing a user interface for handling WiFi connections, remember that NetworkSettingsManager.services is designed to be used as a model. The Settings UI implementation uses it directly to display a list of available WiFi networks.

Handling WiFi connections and passphrases for list selections should be straightforward as described in Filtering WiFi Networks and Connecting to WiFi.