Macros
#define	WIFI_1X_TLS_HS_FLAGS_DEFAULT

#define	WIFI_1X_TLS_HS_FLAGS_PEER_AUTH NBIT1

#define	WIFI_1X_TLS_HS_FLAGS_PEER_CERTTIMECHECK NBIT2

#define	WIFI_1X_TLS_HS_FLAGS_REQUIRE_TIME NBIT3

#define	WIFI_1X_TLS_HS_FLAGS_SESSION_CACHING NBIT4

#define	WIFI_1X_TLS_HS_FLAGS_SPECIFY_ROOTCERT NBIT6

Functions
static sint8	legacy_connect_prepare_msg (tstrM2mWifiConnHdr pstrConnHdr, tstrM2mWifiConnectLegacy_1_2 pstrConnect)

static sint8	m2m_validate_ap_parameters (CONST tstrM2MAPModeConfig *pstrM2MAPModeConfig)

static sint8	m2m_validate_scan_options (tstrM2MScanOption *ptstrM2MScanOption)

static void	m2m_wifi_cb (uint8 u8OpCode, uint16 u16DataSize, uint32 u32Addr)

static sint8	m2m_wifi_connect_prepare_msg (tenuCredStoreOption enuCredStoreOption, tenuM2mSecType enuAuthType, uint16 u16AuthSize, tstrNetworkId pstrNetworkId, tstrM2mWifiConnHdr pstrWifiConn)

uint32	m2m_wifi_get_chipId (void)
	Get the WINC Chip ID. More...

sint8	m2m_wifi_p2p (uint8 u8Channel)

sint8	m2m_wifi_p2p_disconnect (void)

sint8	m2m_wifi_wps (uint8 u8TriggerType, const char *pcPinNumber)
	Asynchronous API to engage the WINC Wi-Fi Protected Setup (enrollee) function. More...

sint8	m2m_wifi_wps_disable (void)
	Asynchronous API that disables Wi-Fi Protected Setup mode in the WINC. More...

Variables
static uint8	gau81xRootSha1 [20] = {0}

static tpfAppWifiCb	gpfAppWifiCb = NULL

static uint32	gu321xTlsHsFlags = WIFI_1X_TLS_HS_FLAGS_DEFAULT

static volatile uint8	gu8ChNum

#define WIFI_1X_TLS_HS_FLAGS_DEFAULT

Value:

(           \
            WIFI_1X_TLS_HS_FLAGS_PEER_AUTH          \
        |   WIFI_1X_TLS_HS_FLAGS_PEER_CERTTIMECHECK \
        |   WIFI_1X_TLS_HS_FLAGS_SESSION_CACHING    \
)

#define WIFI_1X_TLS_HS_FLAGS_PEER_AUTH NBIT1

Referenced by m2m_wifi_1x_get_option(), and m2m_wifi_1x_set_option().

#define WIFI_1X_TLS_HS_FLAGS_PEER_CERTTIMECHECK NBIT2

Referenced by m2m_wifi_1x_get_option(), and m2m_wifi_1x_set_option().

#define WIFI_1X_TLS_HS_FLAGS_REQUIRE_TIME NBIT3

Referenced by m2m_wifi_1x_get_option(), and m2m_wifi_1x_set_option().

#define WIFI_1X_TLS_HS_FLAGS_SESSION_CACHING NBIT4

Referenced by m2m_wifi_1x_get_option(), and m2m_wifi_1x_set_option().

#define WIFI_1X_TLS_HS_FLAGS_SPECIFY_ROOTCERT NBIT6

Referenced by m2m_wifi_1x_get_option(), and m2m_wifi_1x_set_option().

static sint8 legacy_connect_prepare_msg	(	tstrM2mWifiConnHdr *	pstrConnHdr,
		tstrM2mWifiConnectLegacy_1_2 *	pstrConnect
	)

static

static sint8 m2m_validate_ap_parameters ( CONST tstrM2MAPModeConfig * pstrM2MAPModeConfig )

static

References M2M_ERR, M2M_ERR_FAIL, M2M_MAX_SSID_LEN, m2m_strlen(), M2M_SUCCESS, M2M_WIFI_CH_1, M2M_WIFI_CH_14, M2M_WIFI_SEC_OPEN, M2M_WIFI_SEC_WEP, NULL, WEP_104_KEY_STRING_SIZE, WEP_40_KEY_STRING_SIZE, and WEP_KEY_MAX_INDEX.

Referenced by m2m_wifi_enable_ap_ext(), and m2m_wifi_start_provision_mode_ext().

static sint8 m2m_validate_scan_options ( tstrM2MScanOption * ptstrM2MScanOption )

static

References M2M_ERR, M2M_ERR_FAIL, M2M_SCAN_DEFAULT_NUM_PROBE, M2M_SUCCESS, NULL, tstrM2MScanOption::s8RssiThresh, tstrM2MScanOption::u8NumOfSlot, tstrM2MScanOption::u8ProbesPerSlot, and tstrM2MScanOption::u8SlotTime.

Referenced by m2m_wifi_set_scan_options().

static void m2m_wifi_cb	(	uint8	u8OpCode,
		uint16	u16DataSize,
		uint32	u32Addr
	)

static

References BYTE_0, BYTE_1, BYTE_2, BYTE_3, tstrM2mBleApiMsg::data, gpfAppWifiCb, gu8ChNum, hif_receive(), M2M_ERR, M2M_INFO, m2m_memcpy(), m2m_memset(), M2M_SUCCESS, M2M_WIFI_REQ_DHCP_CONF, M2M_WIFI_REQ_WPS, M2M_WIFI_REQRSP_DELETE_APID, M2M_WIFI_RESP_BLE_API_RECV, M2M_WIFI_RESP_CLIENT_INFO, M2M_WIFI_RESP_CON_STATE_CHANGED, M2M_WIFI_RESP_CONN_INFO, M2M_WIFI_RESP_CURRENT_RSSI, M2M_WIFI_RESP_DEFAULT_CONNECT, M2M_WIFI_RESP_ETHERNET_RX_PACKET, M2M_WIFI_RESP_GET_PRNG, M2M_WIFI_RESP_GET_SYS_TIME, M2M_WIFI_RESP_IP_CONFLICT, M2M_WIFI_RESP_MEMORY_RECOVER, M2M_WIFI_RESP_PROVISION_INFO, M2M_WIFI_RESP_SCAN_DONE, M2M_WIFI_RESP_SCAN_RESULT, M2M_WIFI_RESP_SET_GAIN_TABLE, NULL, tstrPrng::pu8RngBuff, rx_buf, tstrM2mIpCtrlBuf::u16DataSize, tstrM2mBleApiMsg::u16Len, tstrM2mIpRsvdPkt::u16PktOffset, tstrM2mIpRsvdPkt::u16PktSz, tstrPrng::u16PrngSize, tstrM2mIpCtrlBuf::u16RemainingDataSize, tstrM2mWifiStateChanged::u8CurrState, and tstrM2mScanDone::u8NumofCh.

Referenced by m2m_wifi_init_start().

static sint8 m2m_wifi_connect_prepare_msg	(	tenuCredStoreOption	enuCredStoreOption,
		tenuM2mSecType	enuAuthType,
		uint16	u16AuthSize,
		tstrNetworkId *	pstrNetworkId,
		tstrM2mWifiConnHdr *	pstrWifiConn
	)

static

References tstrM2mConnCredCmn::au8Bssid, tstrM2mConnCredCmn::au8Ssid, tstrNetworkId::enuChannel, M2M_CRED_ENCRYPT_FLAG, M2M_CRED_STORE_FLAG, M2M_ERR_FAIL, M2M_ERR_INVALID_ARG, M2M_MAC_ADDRES_LEN, M2M_MAX_SSID_LEN, m2m_memcpy(), m2m_memset(), M2M_SUCCESS, M2M_WIFI_CH_1, M2M_WIFI_CH_14, M2M_WIFI_CH_ALL, M2M_WIFI_CONN_BSSID_FLAG, M2M_WIFI_NUM_AUTH_TYPES, M2M_WIFI_SEC_INVALID, NULL, tstrNetworkId::pu8Bssid, tstrNetworkId::pu8Ssid, ret, tstrM2mWifiConnHdr::strConnCredCmn, tstrM2mWifiConnHdr::strConnCredHdr, tstrM2mConnCredHdr::u16CredSize, tstrM2mConnCredCmn::u8AuthType, tstrM2mConnCredHdr::u8Channel, tstrM2mConnCredHdr::u8CredStoreFlags, tstrM2mConnCredCmn::u8Options, tstrNetworkId::u8SsidLen, tstrM2mConnCredCmn::u8SsidLen, WIFI_CRED_DONTSAVE, WIFI_CRED_SAVE_ENCRYPTED, and WIFI_CRED_SAVE_UNENCRYPTED.

Referenced by m2m_wifi_connect_1x_mschap2(), m2m_wifi_connect_1x_tls(), m2m_wifi_connect_open(), m2m_wifi_connect_psk(), and m2m_wifi_connect_wep().

uint32 m2m_wifi_get_chipId ( void )

Get the WINC Chip ID.

Synchronous API to obtain the firmware WINC chip ID.

Returns: The function SHALL return chipID >0 or 0 for failure.; The function returns chipID > 0 or 0 for failure.

References nmi_get_chipid().

sint8 m2m_wifi_p2p ( uint8 u8Channel )

References hif_send(), M2M_ERR, M2M_ERR_FAIL, M2M_REQ_GROUP_WIFI, M2M_SUCCESS, M2M_WIFI_CH_1, M2M_WIFI_CH_11, M2M_WIFI_CH_6, M2M_WIFI_REQ_ENABLE_P2P, NULL, ret, and tstrM2MP2PConnect::u8ListenChannel.

sint8 m2m_wifi_p2p_disconnect ( void )

References hif_send(), M2M_REQ_GROUP_WIFI, M2M_SUCCESS, M2M_WIFI_REQ_DISABLE_P2P, NULL, and ret.

NMI_API sint8 m2m_wifi_wps	(	uint8	u8TriggerType,
		const char *	pcPinNumber
	)

Asynchronous API to engage the WINC Wi-Fi Protected Setup (enrollee) function.

Asynchronous API to engage the WINC IC's Wi-Fi Protected Setup (enrollee) function.

This function can be called to make the WINC enter WPS (Wi-Fi Protected Setup) mode. The result
is passed to the Wi-Fi notification callback with the event @ref M2M_WIFI_REQ_WPS.

Parameters

[in]	u8TriggerType	WPS Trigger method. This may be: WPS_PIN_TRIGGER Push button method WPS_PBC_TRIGGER Pin method
[in]	pcPinNumber	Valid only if the u8TriggerType is WPS_PIN_TRIGGER, this parameter contains the PIN number. The number must follow the format as given in the WSC1.0 specification.

Returns: The function returns M2M_SUCCESS if the command has been successfully queued to the WINC and a negative value otherwise.

Warning: This function is not allowed in AP or P2P modes.

Precondition

A Wi-Fi notification callback of type (tpfAppWifiCb MUST be implemented and registered at startup. Registering the callback is done through passing it to m2m_wifi_init.
The event M2M_WIFI_REQ_WPS must be handled in the callback to receive the WPS status.
The WINC device MUST be in IDLE or STA mode. If AP or P2P mode is active, the WPS will not be performed.
The m2m_wifi_handle_events MUST be called periodically to receive the responses in the callback.

See Also: tpfAppWifiCb m2m_wifi_init M2M_WIFI_REQ_WPS tenuWPSTrigger tstrM2MWPSInfo

Example

The code snippet shows an example of how wi-fi WPS is triggered .

#include "m2m_wifi.h"
#include "m2m_types.h"
void wifi_event_cb(uint8 u8WiFiEvent, void * pvMsg)
{
    switch(u8WiFiEvent)
    {
    case M2M_WIFI_REQ_WPS:
        {
            tstrM2MWPSInfo  *pstrWPS = (tstrM2MWPSInfo*)pvMsg;
            if(pstrWPS->u8AuthType != 0)
            {
                // establish Wi-Fi connection
                tstrNetworkId   strNetworkId = {NULL, pstrWPS->au8SSID, (uint8)strlen((char*)(pstrWPS->au8SSID)), pstrWPS->u8Ch};
                if(pstrWPS->u8AuthType == M2M_WIFI_SEC_OPEN)
                {
                    m2m_wifi_connect_open(WIFI_CRED_SAVE_ENCRYPTED, &strNetworkId);
                }
                else
                {
                    tstrAuthPsk     strAuthPsk = {NULL, pstrWPS->au8PSK, (uint8)strlen((char*)(pstrWPS->au8PSK))};
                    m2m_wifi_connect_psk(WIFI_CRED_SAVE_ENCRYPTED, &strNetworkId, &strAuthPsk);
                }
                printf("WPS SSID           : %s\n",pstrWPS->au8SSID);
                printf("WPS PSK            : %s\n",pstrWPS->au8PSK);
                printf("WPS SSID Auth Type : %s\n",pstrWPS->u8AuthType == M2M_WIFI_SEC_OPEN ? "OPEN" : "WPA/WPA2");
                printf("WPS Channel        : %d\n",pstrWPS->u8Ch);
            }
            else
            {
                printf("(ERR) WPS Is not enabled OR Timed out\n");
            }
        }
        break;
    default:
        break;
    }
}
int main()
{
    tstrWifiInitParam   param;
    param.pfAppWifiCb   = wifi_event_cb;
    if(!m2m_wifi_init(&param))
    {
        // Trigger WPS in Push button mode.
        m2m_wifi_wps(WPS_PBC_TRIGGER, NULL);
        while(1)
        {
            m2m_wifi_handle_events(NULL);
        }
    }
}

This function is called for the WINC to enter the WPS (Wi-Fi Protected Setup) mode. The result 
is passed to the Wi-Fi notification callback with the event @ref M2M_WIFI_REQ_WPS.

Parameters

[in]	u8TriggerType	WPS Trigger method. This may be: WPS_PIN_TRIGGER Push button method WPS_PBC_TRIGGER Pin method
[in]	pcPinNumber	PIN number for WPS PIN method. It is not used if the trigger type is WPS_PBC_TRIGGER. It must follow the rules stated by the WPS standard.

Precondition

A Wi-Fi notification callback of type (tpfAppWifiCb MUST be implemented and registered at startup. Registering the callback is done through passing it to m2m_wifi_init.
The event M2M_WIFI_REQ_WPS must be handled in the callback to receive the WPS status.
The WINC device MUST be in IDLE or STA mode. If AP mode is active, the WPS will not be performed.
The m2m_wifi_handle_events MUST be called periodically to receive the responses in the callback.

Warning: This function is not allowed in AP mode.

Returns: The function returns M2M_SUCCESS if the command has been successfully queued to the WINC and a negative value otherwise.

See Also: tpfAppWifiCb m2m_wifi_init M2M_WIFI_REQ_WPS tenuWPSTrigger tstrM2MWPSInfo

Example

The code snippet shows an example of how wi-fi WPS is triggered .

#include "m2m_wifi.h"
#include "m2m_types.h"
void wifi_event_cb(uint8 u8WiFiEvent, void * pvMsg)
{
    switch(u8WiFiEvent)
    {
    case M2M_WIFI_REQ_WPS:
        {
            tstrM2MWPSInfo  *pstrWPS = (tstrM2MWPSInfo*)pvMsg;
            if(pstrWPS->u8AuthType != 0)
            {
                // establish Wi-Fi connection
                tstrNetworkId   strNetworkId = {NULL, pstrWPS->au8SSID, (uint8)strlen((char*)(pstrWPS->au8SSID)), pstrWPS->u8Ch};
                if(pstrWPS->u8AuthType == M2M_WIFI_SEC_OPEN)
                {
                    m2m_wifi_connect_open(WIFI_CRED_SAVE_ENCRYPTED, &strNetworkId);
                }
                else
                {
                    tstrAuthPsk     strAuthPsk = {NULL, pstrWPS->au8PSK, (uint8)strlen((char*)(pstrWPS->au8PSK))};
                    m2m_wifi_connect_psk(WIFI_CRED_SAVE_ENCRYPTED, &strNetworkId, &strAuthPsk);
                }
                printf("WPS SSID           : %s\n",pstrWPS->au8SSID);
                printf("WPS PSK            : %s\n",pstrWPS->au8PSK);
                printf("WPS SSID Auth Type : %s\n",pstrWPS->u8AuthType == M2M_WIFI_SEC_OPEN ? "OPEN" : "WPA/WPA2");
                printf("WPS Channel        : %d\n",pstrWPS->u8Ch);
            }
            else
            {
                printf("(ERR) WPS Is not enabled OR Timed out\n");
            }
        }
        break;
        
    default:
        break;
    }
}
int main()
{
    tstrWifiInitParam   param;
    
    param.pfAppWifiCb   = wifi_event_cb;
    if(!m2m_wifi_init(&param))
    {
        // Trigger WPS in Push button mode.
        m2m_wifi_wps(WPS_PBC_TRIGGER, NULL);
        
        while(1)
        {
            m2m_wifi_handle_events(NULL);
        }
    }
}