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)

sint8	m2m_wifi_enable_firmware_logs (uint8 u8Enable)
	Enable or Disable logs in run time (Disable Firmware logs will enhance the firmware start-up time and performance) More...

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

sint8	m2m_wifi_handle_events (void *arg)
	Synchronous M2M event handler function. 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 uint8 *	gau8ethRcvBuf = NULL

static tpfAppEthCb	gpfAppEthCb = NULL

static tpfAppWifiCb	gpfAppWifiCb = NULL

static uint16	gu16ethRcvBufSize

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, gau8ethRcvBuf, gpfAppEthCb, gpfAppWifiCb, gu16ethRcvBufSize, 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, 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().

NMI_API sint8 m2m_wifi_enable_firmware_logs ( uint8 u8Enable )

Enable or Disable logs in run time (Disable Firmware logs will enhance the firmware start-up time and performance)

Enable or Disable logs in run time.

Parameters

[in] u8Enable Set 1 to enable the logs 0 for disable

Returns: The function SHALL return M2M_SUCCESS for success and a negative value otherwise.

See Also: DISABLE_FIRMWARE_LOGS (build option to disable logs from initializations)

Precondition: m2m_wifi_init

Warning

Enable or Disable logs in run time (Disable Firmware logs will enhance the firmware start-up time and performance).

Parameters

[in] u8Enable Set 1 to enable the logs, 0 for disable.

Precondition: Must be called after initialization through the following function m2m_wifi_init.

Returns: The function returns M2M_SUCCESS for success and a negative value otherwise.

See Also: DISABLE_FIRMWARE_LOGS (build option to disable logs from initializations) m2m_wifi_init

References hif_send(), M2M_REQ_GROUP_WIFI, M2M_SUCCESS, M2M_WIFI_REQ_SET_ENABLE_LOGS, NULL, and tstrM2mEnableLogs::u8Enable.

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_handle_events ( void * arg )

Synchronous M2M event handler function.

This function is responsible for handling interrupts received from the WINC firmware.
Applications should call this function periodically in-order to receive the events that are to
be handled by the callback functions implemented by the application.

Handle the various events received from the WINC.
Whenever an event happens in the WINC (e.g. Connection, Disconnection, DHCP, etc),
the WINC will interrupt the host to let it know that a new event has occurred. The host driver
will attempt to handle these events whenever the application decides to do so by calling
the m2m_wifi_handle_events function.
It is mandatory to call this function periodically and independently of any other condition.
It is ideal to include this function in the main and the most frequent loop of the
host application.

Precondition: Prior to receiving events, the WINC driver should have been successfully initialized by calling the m2m_wifi_init function.

Warning: Failure to successfully complete this function indicates bus errors and hence a fatal error that will prevent the application from proceeding.

Returns: The function returns M2M_SUCCESS for successful interrupt handling and a negative value otherwise.

References hif_handle_isr(), M2M_SUCCESS, m2m_wifi_get_state(), and WIFI_STATE_START.

Referenced by os_hif_task().

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, and tstrM2MP2PConnect::u8ListenChannel.

Referenced by os_m2m_wifi_p2p().

sint8 m2m_wifi_p2p_disconnect ( void )

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

Referenced by os_m2m_wifi_p2p_disconnect().

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

Asynchronous API to engage the WINC 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);
        }
    }
}