5.4 On Demand Wi-Fi Connection

The host MCU application may establish a Wi-Fi connection on demand when all the required connection parameters (SSID, security credentials, and so on.) are known to the application. To start a Wi-Fi connection on demand, the application calls the following APIs based on the security type.

Table 5-1. List of APIs based on Security Type
Security TypeAPI
Openm2m_wifi_connect_open
WEPm2m_wifi_connect_wep
WPA/WPA2m2m_wifi_connect_psk
802.1x with MSCHAPv2m2m_wifi_connect_1x_mschap2
802.1x with TLSm2m_wifi_connect_1x_tls

Alternatively, the application can call the API m2m_wifi_connect to connect with an access point which supports Open, WEP, WPA/WPA2 and 802.1x with MSCHAPv2. m2m_wifi_connect is deprecated in v19.6.1 and is kept for legacy purpose.

Note: Using the API in the Table 5-1 implies that the host MCU application has prior knowledge of the connection parameters. For instance, connection parameters can be stored on nonvolatile storage attached to the host MCU.
The Wi-Fi on demand connection operation is described in the following figure.
Figure 5-2. On-demand Wi-Fi Connection