Wi-Fi management extension

The Wi-Fi management extension library adds an automatic connection feature to the Wi-Fi stack.

Overview

The automatic connection feature is implemented by adding a NET_REQUEST_WIFI_CONNECT_STORED command to Zephyr’s Wi-Fi L2 Layer. Credentials are pulled from the Wi-Fi credentials library.

Configuration

To use this library, enable the CONFIG_WIFI_MGMT_EXT Kconfig option.

For development purposes, you can set static Wi-Fi credentials configuration using the following Kconfig options:

• CONFIG_WIFI_CREDENTIALS_STATIC - This option enables static Wi-Fi configuration.

• CONFIG_WIFI_CREDENTIALS_STATIC_SSID - Wi-Fi SSID.

• CONFIG_WIFI_CREDENTIALS_STATIC_PASSWORD - Wi-Fi password.

• CONFIG_WIFI_CREDENTIALS_STATIC_TYPE_OPEN - Wi-Fi network uses no password.

• CONFIG_WIFI_CREDENTIALS_STATIC_TYPE_PSK - Wi-Fi network uses a password and WPA2-PSK security (default).

• CONFIG_WIFI_CREDENTIALS_STATIC_TYPE_PSK_SHA256 - Wi-Fi network uses a password and PSK-256 security.

• CONFIG_WIFI_CREDENTIALS_STATIC_TYPE_SAE - Wi-Fi network uses a password and SAE security.

• CONFIG_WIFI_CREDENTIALS_STATIC_TYPE_WPA_PSK - Wi-Fi network uses a password and WPA-PSK security.

Usage

The following code snippet shows how to use the Network Management command:

int ret;

struct net_if *iface = net_if_get_default();
int rc = net_mgmt(NET_REQUEST_WIFI_CONNECT_STORED, iface, NULL, 0);

if (rc) {
   printk("an error occurred when trying to auto-connect to a network. err: %d", rc);
}

Limitations

The library has the following limitations:

• It can only be used with Nordic Semiconductor’s hostap-based Wi-Fi stack. The Wi-Fi configuration is highly vendor-specific.

• The commands NET_REQUEST_WIFI_CONNECT and NET_REQUEST_WIFI_CONNECT_STORED clear the list of configured Wi-Fi networks in RAM. Automatic connection has to be requested again after directly requesting connection to a specific network.

API documentation

Header file: include/net/wifi_mgmt_ext.h

Source files: subsys/net/lib/wifi_mgmt_ext

group wifi_mgmt_ext

Library that adds an automatic connection feature to the Wi-Fi stack.

Defines

NET_REQUEST_WIFI_CONNECT_STORED

Enums

enum net_request_wifi_cmd_ext

Values:

enumerator NET_REQUEST_WIFI_CMD_CONNECT_STORED