Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Enumeration/Typedef

Modules

 Function
 
 m2m_wifi_init
 Synchronous initialization functions for the WILC driver.
 
 m2m_wifi_deinit
 Synchronous deinitialization function to the WILC1000 driver.
 
 m2m_wifi_handle_events
 Synchronous M2M event handler function, responsible for handling interrupts received from the WILC firmware.
 
 m2m_wifi_connect
 Asynchronous wi-fi connection function to a specific AP.
 
 m2m_wifi_disconnect
 Synchronous wi-fi disconnection function, requesting a Wi-Fi disconnect from the currently connected AP.
 
 m2m_wifi_get_connection_info
 Asynchronous connection status retrieval function, retrieves the status information of the currently connected AP.
 
 m2m_wifi_set_mac_address
 Synchronous dual MAC address assigning to the WILC1500 .
 
 m2m_wifi_wps
 Asynchronous WPS triggering function.
 
 m2m_wifi_wps_disable
 Disable the NMC1500 WPS operation.
 
 m2m_wifi_p2p
 Asynchronous Wi-Fi direct (P2P) enabling mode function.
 
 m2m_wifi_p2p_disconnect
 Disable the NMC1500 device Wi-Fi direct mode (P2P).
 
 m2m_wifi_enable_ap
 Asychronous wi-fi hotspot enabling function.
 
 m2m_wifi_disable_ap
 Synchronous wi-fi hotspot disabling function.
 
 m2m_wifi_set_scan_options
 Synchronous wi-fi scan settings function.
 
 m2m_wifi_set_scan_region
 Synchronous wi-fi scan region setting function.
 
 m2m_wifi_request_scan
 Asynchronous wi-fi scan request on the given channel.
 
 m2m_wifi_get_num_ap_found
 Synchronous function to retrieve the number of AP's found in the last scan request, The function read the number of AP's from global variable which updated in the wi-fi callback fucntion through the M2M_WIFI_RESP_SCAN_DONE event.
 
 m2m_wifi_req_scan_result
 Synchronous call to read the AP information from the SCAN Result list with the given index.
 
 m2m_wifi_req_curr_rssi
 Asynchronous request for the current RSSI of the connected AP.
 
 m2m_wifi_get_otp_mac_address
 Request the MAC address stored on the OTP (one time programmable) memory of the device.
 
 m2m_wifi_get_mac_address
 Function to retrieve the current MAC address.
 
 m2m_wifi_set_sleep_mode
 Synchronous power-save mode setting function for the NMC1500.
 
 m2m_wifi_get_sleep_mode
 Synchronous power save mode retrieval function.
 

Data Structures

struct  tstr1xAuthCredentials
 Credentials for the user to authenticate with the AAA server (WPA-Enterprise Mode IEEE802.1x). More...
 
struct  tstrEthInitParam
 Structure to hold ethernet interface parameters. More...
 
struct  tstrM2MAPAssocInfo
 M2M association information of the connected station in the AP mode. More...
 
struct  tstrM2MAPConfig
 AP Configuration. More...
 
struct  tstrM2MAssocEntryInfo
 M2M association information of of an assoicated entry in the AP mode. More...
 
struct  tstrM2MConnInfo
 M2M Provisioning Information obtained from the HTTP Provisioning server. More...
 
struct  tstrM2MDataBufCtrl
 Structure holding the incoming buffer's data size information, indicating the data size of the buffer and the remaining buffer's data size . The data of the buffer which holds the packet sent to the host is placed in the tstrEthInitParam structure in the au8ethRcvBuf attribute. This following information is retreived in the host when an event M2M_WIFI_RESP_ETHERNET_RX_PACKET is received in the wi-fi callback function tpfAppWifiCb. More...
 
struct  tstrM2MDeviceNameConfig
 Device name. More...
 
struct  tstrM2MIfId
 Set Intrface ID. More...
 
struct  tstrM2MIPConfig
 Static IP configuration. More...
 
struct  tstrM2mIpRsvdPkt
 Received Packet Size and Data Offset. More...
 
struct  tstrM2mLsnInt
 Listen interval. More...
 
struct  tstrM2MMulticastMac
 M2M add/remove multicast mac address. More...
 
struct  tstrM2MP2PConnect
 Set the device to operate in the Wi-Fi Direct (P2P) mode. More...
 
struct  tstrM2MP2pDevInfo
 P2P Pin. More...
 
struct  tstrM2MPinInfo
 PIN Number (input) More...
 
struct  tstrM2mPsType
 Power Save Configuration. More...
 
struct  tstrM2mReqScanResult
 Scan Result Request. More...
 
struct  tstrM2MScan
 Wi-Fi Scan Request. More...
 
struct  tstrM2mScanDone
 Wi-Fi Scan Result. More...
 
struct  tstrM2MScanList
 Wi-Fi channel list regulation. More...
 
struct  tstrM2MScanOption
 
struct  tstrM2MScanRegion
 Wi-Fi channel regulation region information. More...
 
struct  tstrM2mSetMacAddress
 Sets the MAC address from application. It is only intended for testing purpose. This method is not used for production SW. Production SW reads MAC Address from EFUSE. More...
 
struct  tstrM2mTxPwrLevel
 Tx power level. More...
 
struct  tstrM2MUserMaxTxRate
 User specified Max Tx Rate. More...
 
struct  tstrM2mWifiConnect
 Wi-Fi Connect Request. More...
 
struct  tstrM2MWifiMonitorModeCtrl
 Wi-Fi Monitor Mode Filter. More...
 
struct  tstrM2MWifiRxPacketInfo
 Wi-Fi RX Frame Header. More...
 
struct  tstrM2mWifiscanResult
 Wi-Fi Scan Result. More...
 
struct  tstrM2MWifiSecInfo
 Authentication credentials to connect to a Wi-Fi network. More...
 
struct  tstrM2mWifiStateChanged
 Wi-Fi Connection State. More...
 
struct  tstrM2MWifiTxPacketInfo
 Wi-Fi Tx Packet Info. More...
 
struct  tstrM2mWifiWepParams
 WEP security key parameters. More...
 
struct  tstrM2MWPSConnect
 WPS Configuration parameters. More...
 
struct  tstrM2MWPSInfo
 WPS Result. More...
 
struct  tstrSystemTime
 Used for time storage. More...
 
struct  tstrWifiInitParam
 
Structure, holding the Wi-Fi configuration attributes such as the Wi-Fi callback, monitoring mode callback and Ethernet parameter initialization structure.
More...
 
union  tuCtrlStruct
 
union  tuniM2MWifiAuth
 Wi-Fi Security Parameters for all supported security modes. More...
 

Macros

#define PAD_SZ(x)   (4 - ((x) % 4))
 

Typedefs

typedef void(* tpfAppEthCb )(uint8 u8MsgType, void *pvMsg, void *pvCtrlBuf)
 Ethernet notification callback function receiving events as defined in the Wi-Fi reponses enumeration tenuM2mStaCmd. More...
 
typedef void(* tpfAppMonCb )(tstrM2MWifiRxPacketInfo *pstrWifiRxPacket, uint8 *pu8Payload, uint16 u16PayloadSize)
 Wi-Fi monitoring mode callback function. This function delivers all received wi-Fi packets through the Wi-Fi interface. Applications requiring to operate in the monitoring should call the asynchronous function m2m_wifi_enable_monitoring_mode and expect to receive the wi-fi packets through this callback function, when the event ....is received. To disable the monitoring mode a call to m2m_wifi_disable_monitoring_mode should be made. More...
 
typedef void(* tpfAppWifiCb )(uint8 u8MsgType, void *pvMsg)
 Wi-Fi's main callback function handler, for handling the M2M_WIFI events received on the Wi-Fi interface. Such notifications are received in response to Wi-Fi/P2P operations such as m2m_wifi_request_scan, m2m_wifi_connect. Wi-Fi/P2P operations are implemented in an asynchronous mode, and all incoming information/status are to be handled through this callback function when the corresponding notification is received. Applications are expected to assign this wi-fi callback function by calling m2m_wifi_init. More...
 

Enumerations

enum  tenuAntSelGpio {
  ANT_SWTCH_GPIO_NONE = 0,
  ANT_SWTCH_GPIO_SINLGE = 1,
  ANT_SWTCH_GPIO_DUAL = 2
}
 Antenna GPIO options. More...
 
enum  tenuAntSwitchMode {
  ANTENNA1 = 0,
  ANTENNA2 = 1,
  DIVERSITY = 2,
  NUM_ANT_MODE
}
 Antenna Switch Modes. More...
 
enum  tenuControlInterface {
  AP_INTERFACE =0,
  STATION_INTERFACE =1,
  P2P_INTERFACE =2
}
 
enum  tenuM2mApCmd {
  M2M_WIFI_REQ_ENABLE_AP = M2M_AP_CMD_BASE,
  M2M_WIFI_REQ_DISABLE_AP,
  M2M_WIFI_REQ_AP_ASSOC_INFO,
  M2M_WIFI_RESP_AP_ASSOC_INFO,
  M2M_WIFI_REQ_AP_BLACK_LIST
}
 This enum contains all the WILC commands while in AP mode. More...
 
enum  tenuM2mConfigCmd {
  M2M_WIFI_REQ_RESTART = M2M_CONFIG_CMD_BASE,
  M2M_WIFI_REQ_SET_MAC_ADDRESS,
  M2M_WIFI_REQ_CURRENT_RSSI,
  M2M_WIFI_RESP_CURRENT_RSSI,
  M2M_WIFI_REQ_SET_DEVICE_NAME,
  M2M_WIFI_REQ_CUST_INFO_ELEMENT,
  M2M_WIFI_RESP_FIRMWARE_STRTED,
  M2M_WIFI_REQ_SET_TX_POWER,
  M2M_WIFI_REQ_SET_MAX_TX_RATE,
  M2M_WIFI_REQ_ENABLE_MCAST_FILTER,
  M2M_WIFI_REQ_DISABLE_MCAST_FILTER,
  M2M_WIFI_REQ_SET_ANT_SWITCH_MODE,
  M2M_WIFI_P2P_AUTH_RES,
  M2M_WIFI_REQ_HT_MIB_ENABLE
}
 This enum contains all the host commands used to configure the WILC board. More...
 
enum  tenuM2mConnChangedErrcode {
  M2M_ERR_NONE = ((uint8)0),
  M2M_ERR_AP_NOT_FOUND = ((uint8)1),
  M2M_ERR_AUTH_FAIL,
  M2M_ERR_ASSOC_FAIL,
  M2M_ERR_LINK_LOSS,
  M2M_ERR_SEC_CNTRMSR,
  M2M_ERR_STATION_IS_LEAVING,
  M2M_ERR_AP_OVERLOAD,
  M2M_ERR_UNKNOWN_FAIL
}
 
enum  tenuM2mConnState {
  M2M_WIFI_DISCONNECTED = 0,
  M2M_WIFI_CONNECTED,
  M2M_WIFI_UNDEF = 0xff
}
 Wi-Fi Connection State. More...
 
enum  tenuM2mP2pCmd {
  M2M_WIFI_REQ_ENABLE_P2P = M2M_P2P_CMD_BASE,
  M2M_WIFI_REQ_DISABLE_P2P
}
 This enum contains all the WILC commands while in P2P mode. More...
 
enum  tenuM2mScanCh {
  M2M_WIFI_CH_1 = ((uint8) 0),
  M2M_WIFI_CH_2,
  M2M_WIFI_CH_3,
  M2M_WIFI_CH_4,
  M2M_WIFI_CH_5,
  M2M_WIFI_CH_6,
  M2M_WIFI_CH_7,
  M2M_WIFI_CH_8,
  M2M_WIFI_CH_9,
  M2M_WIFI_CH_10,
  M2M_WIFI_CH_11,
  M2M_WIFI_CH_12,
  M2M_WIFI_CH_13,
  M2M_WIFI_CH_14,
  M2M_WIFI_CH_ALL = ((uint8) 255)
}
 Wi-Fi RF Channels. More...
 
enum  tenuM2mScanRegion {
  NORTH_AMERICA = ((uint8) 0),
  EUROPE = ((uint8) 1),
  ASIA = ((uint8) 2)
}
 Wi-Fi RF Channels. More...
 
enum  tenuM2mSecType {
  M2M_WIFI_SEC_INVALID = 0,
  M2M_WIFI_SEC_OPEN,
  M2M_WIFI_SEC_WPA_PSK,
  M2M_WIFI_SEC_WEP,
  M2M_WIFI_SEC_802_1X
}
 Wi-Fi Supported Security types. More...
 
enum  tenuM2mSsidMode {
  SSID_MODE_VISIBLE = 0,
  SSID_MODE_HIDDEN
}
 
enum  tenuM2mStaCmd {
  M2M_WIFI_REQ_CONNECT = M2M_STA_CMD_BASE,
  M2M_WIFI_REQ_GET_CONN_INFO,
  M2M_WIFI_RESP_CONN_INFO,
  M2M_WIFI_REQ_DISCONNECT,
  M2M_WIFI_RESP_CON_STATE_CHANGED,
  M2M_WIFI_REQ_SLEEP,
  M2M_WIFI_REQ_SCAN,
  M2M_WIFI_RESP_SCAN_DONE,
  M2M_WIFI_REQ_SCAN_RESULT,
  M2M_WIFI_RESP_SCAN_RESULT,
  M2M_WIFI_REQ_START_WPS,
  M2M_WIFI_REQ_DISABLE_WPS,
  M2M_WIFI_RES_WPS,
  M2M_WIFI_RESP_IP_CONFIGURED,
  M2M_WIFI_RESP_IP_CONFLICT,
  M2M_WIFI_REQ_ENABLE_MONITORING,
  M2M_WIFI_REQ_DISABLE_MONITORING,
  M2M_WIFI_RESP_WIFI_RX_PACKET,
  M2M_WIFI_REQ_SEND_WIFI_PACKET,
  M2M_WIFI_REQ_LSN_INT,
  M2M_WIFI_REQ_SEND_ETHERNET_PACKET,
  M2M_WIFI_RESP_ETHERNET_RX_PACKET,
  M2M_WIFI_REQ_SET_SCAN_OPTION,
  M2M_WIFI_REQ_SET_SCAN_REGION,
  M2M_WIFI_REQ_SET_SCAN_LIST,
  M2M_WIFI_REQ_SET_MAC_MCAST,
  M2M_WIFI_REQ_SET_P2P_IFC_ID,
  M2M_WIFI_RESP_PACKET_SENT,
  M2M_WIFI_REQ_CERT_ADD_CHUNK,
  M2M_WIFI_REQ_CERT_DOWNLOAD_DONE,
  M2M_WIFI_REQ_CHG_MONITORING_CHNL,
  M2M_WIFI_RESP_ANT_SWITCH_MODE,
  M2M_WIFI_REQ_P2P_AUTH
}
 This enum contains all the WILC commands while in Station mode. More...
 
enum  tenuM2mWepAuthType {
  WEP_OPEN_SYSTEM = 1,
  WEP_SHARED_KEY = 2,
  WEP_ANY = 3
}
 WEP Authentication type. More...
 
enum  tenuM2mWepKeyIndex {
  M2M_WIFI_WEP_KEY_INDEX_1 = ((uint8) 1),
  M2M_WIFI_WEP_KEY_INDEX_2,
  M2M_WIFI_WEP_KEY_INDEX_3,
  M2M_WIFI_WEP_KEY_INDEX_4
}
 Index for WEP key Authentication. More...
 
enum  tenuP2pControlInterface {
  P2P_STA_CONCURRENCY_INTERFACE =0,
  P2P_AP_CONCURRENCY_INTERFACE =1
}
 enum holding P2P Control interface for different concurrency modes More...
 
enum  tenuP2PTrigger {
  P2P_PIN = 0,
  P2P_PBC = 4
}
 P2P Triggering Methods. More...
 
enum  tenuPowerSaveModes {
  M2M_NO_PS,
  M2M_PS_DEEP_AUTOMATIC
}
 Power Save Modes. More...
 
enum  tenuSubTypes {
  ASSOC_REQ = 0x00,
  ASSOC_RSP = 0x10,
  REASSOC_REQ = 0x20,
  REASSOC_RSP = 0x30,
  PROBE_REQ = 0x40,
  PROBE_RSP = 0x50,
  BEACON = 0x80,
  ATIM = 0x90,
  DISASOC = 0xA0,
  AUTH = 0xB0,
  DEAUTH = 0xC0,
  ACTION = 0xD0,
  PS_POLL = 0xA4,
  RTS = 0xB4,
  CTS = 0xC4,
  ACK = 0xD4,
  CFEND = 0xE4,
  CFEND_ACK = 0xF4,
  BLOCKACK_REQ = 0x84,
  BLOCKACK = 0x94,
  DATA = 0x08,
  DATA_ACK = 0x18,
  DATA_POLL = 0x28,
  DATA_POLL_ACK = 0x38,
  NULL_FRAME = 0x48,
  CFACK = 0x58,
  CFPOLL = 0x68,
  CFPOLL_ACK = 0x78,
  QOS_DATA = 0x88,
  QOS_DATA_ACK = 0x98,
  QOS_DATA_POLL = 0xA8,
  QOS_DATA_POLL_ACK = 0xB8,
  QOS_NULL_FRAME = 0xC8,
  QOS_CFPOLL = 0xE8,
  QOS_CFPOLL_ACK = 0xF8
}
 Enumeration for Wi-Fi MAC Frame subtype code (6-bit). The frame subtypes fall into one of the three frame type groups as defined in tenuWifiFrameType (MANAGEMENT, CONTROL & DATA). Values are defined as per the IEEE 802.11 standard. More...
 
enum  tenuTxDataRate {
  M2M_WIFI_TX_RATE_1_MBPS =0,
  M2M_WIFI_TX_RATE_2_MBPS,
  M2M_WIFI_TX_RATE_5_5_MBPS,
  M2M_WIFI_TX_RATE_6_MBPS,
  M2M_WIFI_TX_RATE_MCS0,
  M2M_WIFI_TX_RATE_9_MBPS,
  M2M_WIFI_TX_RATE_11_MBPS,
  M2M_WIFI_TX_RATE_12_MBPS,
  M2M_WIFI_TX_RATE_MCS1,
  M2M_WIFI_TX_RATE_18_MBPS,
  M2M_WIFI_TX_RATE_MCS2,
  M2M_WIFI_TX_RATE_24_MBPS,
  M2M_WIFI_TX_RATE_MCS3,
  M2M_WIFI_TX_RATE_36_MBPS,
  M2M_WIFI_TX_RATE_MCS4,
  M2M_WIFI_TX_RATE_48_MBPS,
  M2M_WIFI_TX_RATE_MCS5,
  M2M_WIFI_TX_RATE_54_MBPS,
  M2M_WIFI_TX_RATE_MCS6,
  M2M_WIFI_TX_RATE_MCS7
}
 This enum contains all the phy tx rates. More...
 
enum  tenuWifiFrameType {
  MANAGEMENT = 0x00,
  CONTROL = 0x04,
  DATA_BASICTYPE = 0x08,
  RESERVED = 0x0C
}
 Enumeration for Wi-Fi MAC frame type codes (2-bit) The following types are used to identify the type of frame sent or received. Each frame type constitues a number of frame subtypes as defined in tenuSubTypes to specify the exact type of frame. Values are defined as per the IEEE 802.11 standard. More...
 
enum  tenuWPSTrigger {
  WPS_PIN_TRIGGER = 0,
  WPS_PBC_TRIGGER = 4
}
 WPS Triggering Methods. More...
 

Functions

NMI_API sint8 m2m_wifi_set_p2p_pin (uint8 *pu8PinNumber, uint8 u8PinLength)
 
NMI_API sint8 m2m_wifi_set_device_name (uint8 *pu8DeviceName, uint8 u8DeviceNameLength)
 Set the WILC1000 device name which is used as P2P device name. More...
 

#define PAD_SZ (   x)    (4 - ((x) % 4))

< Padding bytes for forcing 4-byte alignment

tpfAppEthCb

Ethernet notification callback function receiving events as defined in the Wi-Fi reponses enumeration tenuM2mStaCmd.

Parameters
[in]u8MsgTypeType of notification. Possible types are:
[in]pvMsgA pointer to a buffer containing the notification parameters (if any). It should be casted to the correct data type corresponding to the notification type. For example, it could be a pointer to the buffer holding the received frame in case of M2M_WIFI_RESP_ETHERNET_RX_PACKET event.
[in]pvControlBufA pointer to control buffer describing the accompanied message. To be casted to tstrM2MDataBufCtrl in case of M2M_WIFI_RESP_ETHERNET_RX_PACKET event.
See Also
m2m_wifi_init
tpfAppMonCb

Wi-Fi monitoring mode callback function. This function delivers all received wi-Fi packets through the Wi-Fi interface. Applications requiring to operate in the monitoring should call the asynchronous function m2m_wifi_enable_monitoring_mode and expect to receive the wi-fi packets through this callback function, when the event ....is received. To disable the monitoring mode a call to m2m_wifi_disable_monitoring_mode should be made.

Parameters
[in]pstrWifiRxPacketPointer to a structure holding the Wi-Fi packet header parameters.
[in]pu8PayloadPointer to the buffer holding the Wi-Fi packet payload information required by the application starting from the defined OFFSET by the application (when calling m2m_wifi_enable_monitoring_mode). Could hold a value of NULL, if the application does not need any data from the payload.
[in]u16PayloadSizeThe size of the payload in bytes.
See Also
m2m_wifi_enable_monitoring_mode
Warning
u16PayloadSize should not exceed the buffer size given through m2m_wifi_enable_monitoring_mode.
tpfAppWifiCb

Wi-Fi's main callback function handler, for handling the M2M_WIFI events received on the Wi-Fi interface. Such notifications are received in response to Wi-Fi/P2P operations such as m2m_wifi_request_scan, m2m_wifi_connect. Wi-Fi/P2P operations are implemented in an asynchronous mode, and all incoming information/status are to be handled through this callback function when the corresponding notification is received. Applications are expected to assign this wi-fi callback function by calling m2m_wifi_init.

Parameters
[in]u8MsgTypeType of notification. Possible types are: /ref M2M_WIFI_RESP_CON_STATE_CHANGED /ref M2M_WIFI_RESP_CONN_INFO /ref M2M_WIFI_REQ_WPS /ref M2M_WIFI_RESP_SCAN_DONE /ref M2M_WIFI_RESP_SCAN_RESULT /ref M2M_WIFI_RESP_CURRENT_RSSI /ref M2M_WIFI_RESP_DEFAULT_CONNECT /ref M2M_WIFI_RESP_ETHERNET_RX_PACKET

In case Monitoring mode is used: M2M_WIFI_RESP_WIFI_RX_PACKET

Parameters
[in]pvMsgA pointer to a buffer containing the notification parameters (if any). It should be Casted to the correct data type corresponding to the notification type.
See Also
tstrM2mWifiStateChanged tstrM2MWPSInfo tstrM2mScanDone tstrM2mWifiscanResult

Antenna GPIO options.

Enumerator
ANT_SWTCH_GPIO_NONE 

Antenna GPIO mode is turned OFF.

ANT_SWTCH_GPIO_SINLGE 

Antenna switch is ON in single antenna mode.

ANT_SWTCH_GPIO_DUAL 

Antenna switch is ON in dual antenna mode or diversity mode

Antenna Switch Modes.

Enumerator
ANTENNA1 

To select Antenna1 mode

ANTENNA2 

To select Antenna2 mode

DIVERSITY 

Antenna selection is ON in dual antenna mode or diversity mode

NUM_ANT_MODE 
Enumerator
AP_INTERFACE 
STATION_INTERFACE 
P2P_INTERFACE 

This enum contains all the WILC commands while in AP mode.

Enumerator
M2M_WIFI_REQ_ENABLE_AP 

Enable AP mode command.

M2M_WIFI_REQ_DISABLE_AP 

Disable AP mode command.

M2M_WIFI_REQ_AP_ASSOC_INFO 

info about the associated stations.

M2M_WIFI_RESP_AP_ASSOC_INFO 

Assoc information response.

M2M_WIFI_REQ_AP_BLACK_LIST 

req. to add/remove station to black list.

This enum contains all the host commands used to configure the WILC board.

Enumerator
M2M_WIFI_REQ_RESTART 

Restart the WILC MAC layer.

M2M_WIFI_REQ_SET_MAC_ADDRESS 

Set the WILC mac addresses (not possible for production efused boards).

M2M_WIFI_REQ_CURRENT_RSSI 

Request the current connected AP RSSI.

M2M_WIFI_RESP_CURRENT_RSSI 

Rsponse to M2M_WIFI_REQ_CURRENT_RSSI with the RSSI value.

M2M_WIFI_REQ_SET_DEVICE_NAME 

Set the WILC device name property.

M2M_WIFI_REQ_CUST_INFO_ELEMENT 

Add Custom ELement to Beacon Managament Frame.

M2M_WIFI_RESP_FIRMWARE_STRTED 

respone message to indicate the firmware succefully started.

M2M_WIFI_REQ_SET_TX_POWER 

API to set TX power.

M2M_WIFI_REQ_SET_MAX_TX_RATE 

Limit the Tx rate to a user specific rate.

M2M_WIFI_REQ_ENABLE_MCAST_FILTER 

Request to enable multicast filter.

M2M_WIFI_REQ_DISABLE_MCAST_FILTER 

Request to disable multicast filter.

M2M_WIFI_REQ_SET_ANT_SWITCH_MODE 

Set antenna switch mode

M2M_WIFI_P2P_AUTH_RES 

Set p2p pin number

M2M_WIFI_REQ_HT_MIB_ENABLE 

Enable or disable 11n high throughput mode

Enumerator
M2M_ERR_NONE 

Indicate no error.

M2M_ERR_AP_NOT_FOUND 

Indicate that the WILC didn't find the requested AP.

M2M_ERR_AUTH_FAIL 

Indicate that the WILC board has failed to authenticate with the AP.

M2M_ERR_ASSOC_FAIL 

Indicate that the WILC board has failed to associate with the AP.

M2M_ERR_LINK_LOSS 

Indicate that the AP/STA is out of range.

M2M_ERR_SEC_CNTRMSR 

Indicate a disconnection because of security countermeasure.

M2M_ERR_STATION_IS_LEAVING 

Indicate that the station connected to WILC1000 is leaving

M2M_ERR_AP_OVERLOAD 

Indicate that the maximum number of STAs were connected

M2M_ERR_UNKNOWN_FAIL 

Indicate the other generic failures

Wi-Fi Connection State.

Enumerator
M2M_WIFI_DISCONNECTED 

Wi-Fi state is disconnected.

M2M_WIFI_CONNECTED 

Wi-Fi state is connected.

M2M_WIFI_UNDEF 

Undefined Wi-Fi State.

This enum contains all the WILC commands while in P2P mode.

Enumerator
M2M_WIFI_REQ_ENABLE_P2P 

Enable P2P mode command.

M2M_WIFI_REQ_DISABLE_P2P 

Disable P2P mode command.

Wi-Fi RF Channels.

Enumerator
M2M_WIFI_CH_1 
M2M_WIFI_CH_2 
M2M_WIFI_CH_3 
M2M_WIFI_CH_4 
M2M_WIFI_CH_5 
M2M_WIFI_CH_6 
M2M_WIFI_CH_7 
M2M_WIFI_CH_8 
M2M_WIFI_CH_9 
M2M_WIFI_CH_10 
M2M_WIFI_CH_11 
M2M_WIFI_CH_12 
M2M_WIFI_CH_13 
M2M_WIFI_CH_14 
M2M_WIFI_CH_ALL 

Wi-Fi RF Channels.

Enumerator
NORTH_AMERICA 
EUROPE 
ASIA 

Wi-Fi Supported Security types.

Wi-Fi Supported SSID types.

Enumerator
M2M_WIFI_SEC_INVALID 

Invalid security type.

M2M_WIFI_SEC_OPEN 

Wi-Fi network is not secured.

M2M_WIFI_SEC_WPA_PSK 

Wi-Fi network is secured with WPA/WPA2 personal(PSK).

M2M_WIFI_SEC_WEP 

Security type WEP (40 or 104) OPEN OR SHARED.

M2M_WIFI_SEC_802_1X 

Wi-Fi network is secured with WPA/WPA2 Enterprise.IEEE802.1x user-name/password authentication.

Enumerator
SSID_MODE_VISIBLE 

SSID is visible to others.

SSID_MODE_HIDDEN 

SSID is hidden.

This enum contains all the WILC commands while in Station mode.

Enumerator
M2M_WIFI_REQ_CONNECT 

Connect with AP command.

M2M_WIFI_REQ_GET_CONN_INFO 

Request connection information command.

M2M_WIFI_RESP_CONN_INFO 

Request connection information response.

M2M_WIFI_REQ_DISCONNECT 

Request to disconnect from AP command.

M2M_WIFI_RESP_CON_STATE_CHANGED 

Connection state changed response.

M2M_WIFI_REQ_SLEEP 

Set PS mode command.

M2M_WIFI_REQ_SCAN 

Request scan command.

M2M_WIFI_RESP_SCAN_DONE 

Scan complete notification response.

M2M_WIFI_REQ_SCAN_RESULT 

Request Scan results command.

M2M_WIFI_RESP_SCAN_RESULT 

Request Scan results resopnse.

M2M_WIFI_REQ_START_WPS 

Request WPS start command.

M2M_WIFI_REQ_DISABLE_WPS 

Request to disable WPS command.

M2M_WIFI_RES_WPS 

Response to WPS start command.

M2M_WIFI_RESP_IP_CONFIGURED 

This command is for internal use by the WILC and should not be used by the host driver.

M2M_WIFI_RESP_IP_CONFLICT 

Response indicating a conflict in obtained IP address. The user should re attempt the DHCP request.

M2M_WIFI_REQ_ENABLE_MONITORING 

Request to enable monitor mode command.

M2M_WIFI_REQ_DISABLE_MONITORING 

Request to disable monitor mode command.

M2M_WIFI_RESP_WIFI_RX_PACKET 

Indicate that a packet was received in monitor mode.

M2M_WIFI_REQ_SEND_WIFI_PACKET 

Send packet in monitor mode.

M2M_WIFI_REQ_LSN_INT 

Set WiFi listen interval.

M2M_WIFI_REQ_SEND_ETHERNET_PACKET 

Send ethernet packet.

M2M_WIFI_RESP_ETHERNET_RX_PACKET 

Receive ethernet packet.

M2M_WIFI_REQ_SET_SCAN_OPTION 

Set Scan options "slot time, slot number .. etc" .

M2M_WIFI_REQ_SET_SCAN_REGION 

Set scan region.

M2M_WIFI_REQ_SET_SCAN_LIST 

Set scan channel list.

M2M_WIFI_REQ_SET_MAC_MCAST 

Set the WILC multicast filters.

M2M_WIFI_REQ_SET_P2P_IFC_ID 

Set P2P control Interface

M2M_WIFI_RESP_PACKET_SENT 

Notification that the last packet sent to the firmware successfully. and the firmware is ready to receive the next packet

M2M_WIFI_REQ_CERT_ADD_CHUNK 

Download one chunk of the certification

M2M_WIFI_REQ_CERT_DOWNLOAD_DONE 

Certificate download done

M2M_WIFI_REQ_CHG_MONITORING_CHNL 

Change monitoring channel

M2M_WIFI_RESP_ANT_SWITCH_MODE 

Request connection information response.

M2M_WIFI_REQ_P2P_AUTH 

Request to enter p2p pin

WEP Authentication type.

Enumerator
WEP_OPEN_SYSTEM 
WEP_SHARED_KEY 
WEP_ANY 

Index for WEP key Authentication.

Enumerator
M2M_WIFI_WEP_KEY_INDEX_1 
M2M_WIFI_WEP_KEY_INDEX_2 
M2M_WIFI_WEP_KEY_INDEX_3 
M2M_WIFI_WEP_KEY_INDEX_4 

Index for WEP key Authentication

enum holding P2P Control interface for different concurrency modes

Enumerator
P2P_STA_CONCURRENCY_INTERFACE 

This interface is used for P2P-Station concurrency mode. Both Station and P2P should be on the same social channels(M2M_WIFI_CH_1, M2M_WIFI_CH_6 or M2M_WIFI_CH_11) in order to create P2P-Station concurrency mode.

P2P_AP_CONCURRENCY_INTERFACE 

P2P Triggering Methods.

Enumerator
P2P_PIN 

P2P-WPS is triggered in PIN method.

P2P_PBC 

P2P-WPS is triggered via push button.

Power Save Modes.

Enumerator
M2M_NO_PS 

Power save is disabled.

M2M_PS_DEEP_AUTOMATIC 

Power save is done automatically by the WILC. Achieve the highest possible power save.

Enumeration for Wi-Fi MAC Frame subtype code (6-bit). The frame subtypes fall into one of the three frame type groups as defined in tenuWifiFrameType (MANAGEMENT, CONTROL & DATA). Values are defined as per the IEEE 802.11 standard.

Remarks
The following sub-frame types are useful when the application developer requires to monitor the frame transmission and reception.
See Also
tenuWifiFrameType
Enumerator
ASSOC_REQ 

Sub-Types related to Management Sub-Types

ASSOC_RSP 
REASSOC_REQ 
REASSOC_RSP 
PROBE_REQ 
PROBE_RSP 
BEACON 
ATIM 
DISASOC 
AUTH 
DEAUTH 
ACTION 
PS_POLL 
RTS 
CTS 
ACK 
CFEND 
CFEND_ACK 
BLOCKACK_REQ 
BLOCKACK 
DATA 
DATA_ACK 
DATA_POLL 
DATA_POLL_ACK 
NULL_FRAME 
CFACK 
CFPOLL 
CFPOLL_ACK 
QOS_DATA 
QOS_DATA_ACK 
QOS_DATA_POLL 
QOS_DATA_POLL_ACK 
QOS_NULL_FRAME 
QOS_CFPOLL 
QOS_CFPOLL_ACK 

This enum contains all the phy tx rates.

Enumerator
M2M_WIFI_TX_RATE_1_MBPS 
M2M_WIFI_TX_RATE_2_MBPS 
M2M_WIFI_TX_RATE_5_5_MBPS 
M2M_WIFI_TX_RATE_6_MBPS 
M2M_WIFI_TX_RATE_MCS0 
M2M_WIFI_TX_RATE_9_MBPS 
M2M_WIFI_TX_RATE_11_MBPS 
M2M_WIFI_TX_RATE_12_MBPS 
M2M_WIFI_TX_RATE_MCS1 
M2M_WIFI_TX_RATE_18_MBPS 
M2M_WIFI_TX_RATE_MCS2 
M2M_WIFI_TX_RATE_24_MBPS 
M2M_WIFI_TX_RATE_MCS3 
M2M_WIFI_TX_RATE_36_MBPS 
M2M_WIFI_TX_RATE_MCS4 
M2M_WIFI_TX_RATE_48_MBPS 
M2M_WIFI_TX_RATE_MCS5 
M2M_WIFI_TX_RATE_54_MBPS 
M2M_WIFI_TX_RATE_MCS6 
M2M_WIFI_TX_RATE_MCS7 

Enumeration for Wi-Fi MAC frame type codes (2-bit) The following types are used to identify the type of frame sent or received. Each frame type constitues a number of frame subtypes as defined in tenuSubTypes to specify the exact type of frame. Values are defined as per the IEEE 802.11 standard.

Remarks
The following frame types are useful when the user application requires to monitor the frame transmission and reception.
See Also
tenuSubTypes
Enumerator
MANAGEMENT 

Wi-Fi Management frame (Probe Req/Resp, Beacon, Association Req/Resp ...etc).

CONTROL 

Wi-Fi Control frame (eg. ACK frame).

DATA_BASICTYPE 

Wi-Fi Data frame.

RESERVED 

WPS Triggering Methods.

Enumerator
WPS_PIN_TRIGGER 

WPS is triggered in PIN method.

WPS_PBC_TRIGGER 

WPS is triggered via push button.

NMI_API sint8 m2m_wifi_set_device_name ( uint8 pu8DeviceName,
uint8  u8DeviceNameLength 
)

Set the WILC1000 device name which is used as P2P device name.

m2m_wifi_set_device_name Set the WILC device name which is to be used as a P2P device name.

Parameters
[in]pu8DeviceNameBuffer holding the device name.
[in]u8DeviceNameLengthLength of the device name.
Returns
The function SHALL return M2M_SUCCESS for success and a negative value otherwise.
Warning
The Function called once after initialization.
Parameters
[in]pu8DeviceNameBuffer holding the device name.
[in]u8DeviceNameLengthLength of the device name. Should not exceed the maximum device name's length M2M_DEVICE_NAME_MAX.
Warning
The function called once after initialization.
Returns
The function returns M2M_SUCCESS for successful operations and a negative value otherwise.

References tstrM2MDeviceNameConfig::au8DeviceName, hif_send(), M2M_DEVICE_NAME_MAX, m2m_memcpy(), M2M_REQ_GRP_WIFI, M2M_WIFI_REQ_SET_DEVICE_NAME, and NULL.

Referenced by os_m2m_wifi_set_device_name_imp().

NMI_API sint8 m2m_wifi_set_p2p_pin ( uint8 pu8PinNumber,
uint8  u8PinLength 
)
Parameters
[in]pu8PinNumberPIN number for P2P PIN method. It must follow the rules stated by the WPS Standard.
[in]u8PinLengthLength of the PIN number. Should not exceed the maximum P2P_MAX_PIN_SIZE.
Warning
The function called once after initialization.
Returns
The function returns M2M_SUCCESS for successful operations and a negative value otherwise.

References tstrM2MPinInfo::au8Pin, hif_send(), m2m_memcpy(), M2M_REQ_GRP_WIFI, M2M_WIFI_P2P_AUTH_RES, and NULL.

Referenced by m2m_wifi_allow_p2p_connection(), and os_m2m_wifi_set_p2p_pin_imp().