/******************************************************************************
MRF24WB0M Driver Management messages
Module for Microchip TCP/IP Stack
-Provides access to MRF24WB0M WiFi controller
-Reference: MRF24WB0M Data sheet, IEEE 802.11 Standard
*******************************************************************************
FileName: WFMgmtMsg.h
Dependencies: TCP/IP Stack header files
Processor: PIC18, PIC24F, PIC24H, dsPIC30F, dsPIC33F, PIC32
Compiler: Microchip C32 v1.10b or higher
Microchip C30 v3.22 or higher
Microchip C18 v3.34 or higher
Company: Microchip Technology, Inc.
Software License Agreement
Copyright (C) 2002-2010 Microchip Technology Inc. All rights reserved.
Microchip licenses to you the right to use, modify, copy, and distribute:
(i) the Software when embedded on a Microchip microcontroller or digital
signal controller product ("Device") which is integrated into
Licensee's product; or
(ii) ONLY the Software driver source files ENC28J60.c, ENC28J60.h,
ENCX24J600.c and ENCX24J600.h ported to a non-Microchip device used in
conjunction with a Microchip ethernet controller for the sole purpose
of interfacing with the ethernet controller.
You should refer to the license agreement accompanying this Software for
additional information regarding your rights and obligations.
THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY WARRANTY
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
NON-INFRINGEMENT. IN NO EVENT SHALL MICROCHIP BE LIABLE FOR ANY INCIDENTAL,
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST DATA, COST
OF PROCUREMENT OF SUBSTITUTE GOODS, TECHNOLOGY OR SERVICES, ANY CLAIMS BY
THIRD PARTIES (INCLUDING BUT NOT LIMITED TO ANY DEFENSE THEREOF), ANY CLAIMS
FOR INDEMNITY OR CONTRIBUTION, OR OTHER SIMILAR COSTS, WHETHER ASSERTED ON
THE BASIS OF CONTRACT, TORT (INCLUDING NEGLIGENCE), BREACH OF WARRANTY, OR
OTHERWISE.
Author Date Comment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
KH 27 Jan 2010 Updated for MRF24WB0M
******************************************************************************/
#ifndef __WF_MGMT_MSG_H
#define __WF_MGMT_MSG_H
/*----------------------------------------------*/
/* Management Message Request/Response Subtypes */
/*----------------------------------------------*/
typedef enum
{
/* Misc subtypes */
WF_SCAN_SUBTYPE = 1,
WF_JOIN_SUBTYPE = 2,
WF_AUTH_SUBTYPE = 3,
WF_ASSOC_SUBTYPE = 4,
WF_DISCONNECT_SUBTYPE = 5,
WF_DISASOCC_SUBTYPE = 6,
WF_SET_POWER_MODE_SUBTYPE = 7,
WF_SET_PM_KEY_SUBTYPE = 8,
WF_SET_WEP_MAP_SUBTYPE = 9,
WF_SET_WEP_KEY_SUBTYPE = 10,
WF_SET_TEMP_KEY_SUBTYPE = 11,
WF_CALC_PSK_KEY_SUBTYPE = 12,
WF_SET_WEP_KEY_ID_SUBTYPE = 13,
WF_CONFIG_KEY_SPACE_SUBTYPE = 14,
WF_SET_PARAM_SUBTYPE = 15,
WF_GET_PARAM_SUBTYPE = 16,
WF_ADHOC_CONNECT_SUBTYPE = 17,
WF_ADHOC_START_SUBTYPE = 18,
/* Connection Profile Message Subtypes */
WF_CP_CREATE_PROFILE_SUBTYPE = 21,
WF_CP_DELETE_PROFILE_SUBTYPE = 22,
WF_CP_GET_ID_LIST_SUBTYPE = 23,
WF_CP_SET_ELEMENT_SUBTYPE = 24,
WF_CP_GET_ELEMENT_SUBTYPE = 25,
/* Connection Algorithm Message Subtypes */
WF_CA_SET_ELEMENT_SUBTYPE = 26,
WF_CA_GET_ELEMENT_SUBTYPE = 27,
/* Connnection Manager Message Subtypes */
WF_CM_CONNECT_SUBYTPE = 28,
WF_CM_DISCONNECT_SUBYTPE = 29,
WF_CM_GET_CONNECTION_STATUS_SUBYTPE = 30,
WF_SCAN_START_SUBTYPE = 31,
WF_SCAN_GET_RESULTS_SUBTYPE = 32,
WF_CM_INFO_SUBTYPE = 33,
WF_SCAN_FOR_IE_SUBTYPE = 34, /* not yet supported */
WF_SCAN_IE_GET_RESULTS_SUBTYPE = 35, /* not yet supported */
WF_CM_GET_CONNECTION_STATISTICS_SUBYTPE = 36, /* not yet supported so moved here for now */
WF_NUM_REQUEST_SUBTYPES
} tMgmtMsgSubtypes;
/*-------------------------------------------------------------*/
/* Connection Profile Element IDs */
/* Used in conjunction with the WF_CP_SET_ELEMENT_SUBTYPE and */
/* WF_CP_GET_ELEMENT_SUBTYPE message subtypes */
/*-------------------------------------------------------------*/
typedef enum
{
WF_CP_ELEMENT_ALL = 0, /* sends all elements in CP struct */
WF_CP_ELEMENT_SSID = 1,
WF_CP_ELEMENT_BSSID = 2,
WF_CP_ELEMENT_SECURITY = 3,
WF_CP_ELEMENT_NETWORK_TYPE = 4,
WF_CP_ELEMENT_ADHOC_BEHAVIOR = 5,
WF_CP_ELEMENT_WEP_KEY_INDEX = 6
} tCPElementIds;
/*-------------------------------------------------------------*/
/* Connection Algorithm Element IDs */
/* Used in conjunction with the WF_CA_SET_ELEMENT_SUBTYPE and */
/* WF_CA_GET_ELEMENT_SUBTYPE message subtypes */
/*-------------------------------------------------------------*/
typedef enum
{
WF_CA_ELEMENT_ALL = 0,
WF_CA_ELEMENT_SCANTYPE = 1,
WF_CA_ELEMENT_RSSI = 2,
WF_CA_ELEMENT_CP_LIST = 3,
WF_CA_ELEMENT_LIST_RETRY_COUNT = 4,
WF_CA_ELEMENT_EVENT_NOTIFICATION_ACTION = 5,
WF_CA_ELEMENT_BEACON_TIMEOUT_ACTION = 6,
WF_CA_ELEMENT_DEAUTH_ACTION = 7,
WF_CA_ELEMENT_CHANNEL_LIST = 8,
WF_CA_ELEMENT_LISTEN_INTERVAL = 9,
WF_CA_ELEMENT_BEACON_TIMEOUT = 10,
WF_CA_ELEMENT_SCAN_COUNT = 11,
WF_CA_ELEMENT_MIN_CHANNEL_TIME = 12,
WF_CA_ELEMENT_MAX_CHANNEL_TIME = 13,
WF_CA_ELEMENT_PROBE_DELAY = 14
} tCAElementIds;
#if defined(WF_CM_DEBUG)
/*-------------------------------------------------------------*/
/* CM INFO IDs */
/* Used in conjunction with the WF_CM_INFO_SUBTYPE */
/*-------------------------------------------------------------*/
typedef enum
{
WF_CM_INFO_GET_FSM_STATS = 0,
WF_CM_INFO_CLEAR_FSM_STATS = 1
} tCMInfoID;
#endif
/* tWFParam - Names (ID's) of WF MAC configurable parameters. */
typedef enum
{
PARAM_MAC_ADDRESS = 1, /* the device MAC address (6 bytes) */
PARAM_REGIONAL_DOMAIN = 2, /* the device Regional Domain (1 byte) */
PARAM_RTS_THRESHOLD = 3, /* the RTS byte threshold 256 - 2347 (2 bytes) */
PARAM_LONG_FRAME_RETRY_LIMIT = 4, /* the long Frame Retry limit (1 byte) */
PARAM_SHORT_FRAME_RETRY_LIMIT = 5, /* the short Frame Retry limit (1 byte) */
PARAM_TX_LIFETIME_TU = 6, /* the Tx Request lifetime in TU's 0 - 4194303 (4 bytes) */
PARAM_RX_LIFETIME_TU = 7, /* the Rx Frame lifetime in TU's 0 - 4194303 (4 bytes) */
PARAM_SUPPLICANT_ON_OFF = 8, /* boolean 1 = on 0 = off (1 byte) */
PARAM_CONFIRM_DATA_TX_REQ = 9, /* boolean 1 = on 0 = off (1 byte) */
PARAM_MASTER_STATE = 10, /* master state of the MAC using enumerated values (1 byte) */
PARAM_HOST_ALERT_BITS = 11, /* a bit field which enables/disables various asynchronous */
/* indications from the MAC to the host (2 bytes) */
PARAM_NUM_MISSED_BEACONS = 12, /* number of consecutive beacons MAC can miss before it */
/* considers the network lost (1 byte) */
PARAM_DIFS_AND_EIFS = 13, /* delay intervals in usec DIFS and EIFS ( 2 * 2 bytes) */
PARAM_TX_POWER = 14, /* max and min boundaries for Tx power (2 * 2 bytes) */
PARAM_DEFAULT_DEST_MAC_ADDR = 15, /* stores a persistant destination MAC address for small */
/* Tx Requests (6 bytes) */
PARAM_WPA_INFO_ELEMENT = 16, /* stores a WPA info element (IE) in 802.11 IE format. Used */
/* in Assoc Request and Supplicant exchange (3 - 258 bytes) */
PARAM_RSN_INFO_ELEMENT = 17, /* stores a RSN info element (IE) in 802.11 IE format. Used */
/* in Assoc Request and Supplicant exchange (3 - 258 bytes) */
PARAM_ON_OFF_RADIO = 18, /* bool to force a radio state change 1 = on 0 = off (1 byte) */
PARAM_COMPARE_ADDRESS = 19, /* A MAC address used to filter received frames */
/* (sizeof(tAddressFilterInput) = 8 bytes) */
PARAM_SUBTYPE_FILTER = 20, /* Bitfield used to filter received frames based on type and */
/* sub-type (sizeof(tAddressFilterInput) = 4 bytes) */
PARAM_ACK_CONTROL = 21, /* Bitfield used to control the type of frames that cause ACK */
/* responses (sizeof(tAckControlInput) = 4 bytes) */
PARAM_STAT_COUNTERS = 22, /* Complete set of statistics counters that are maintained by */
/* the MAC */
PARAM_TX_THROTTLE_TABLE = 23, /* Custom Tx Rate throttle table to be used to control tx Rate */
PARAM_TX_THROTTLE_TABLE_ON_OFF = 24, /* A boolean to enable/disable use of the throttle Table and a */
/* tx rate to use if the throttle table is disabled */
PARAM_TX_CONTENTION_ARRAY = 25, /* Custom Retry contention ladder used for backoff calculation */
/* prior to a Tx attempt */
PARAM_SYSTEM_VERSION = 26, /* 2 byte representation of a version number for the ROM and */
/* Patch */
PARAM_STATUE_INFO = 27, /* MAC State information */
PARAM_SECURITY_CONTROL = 28, /* 2 byte data structure to enable/disable encryption */
PARAM_FACTORY_SET_TX_MAX_POWER = 29, /* gets the factory-set tx max power level */
PARAM_MRF24WB0M = 30 /* a set enables MRF24WB0M Mode, a get gets the version */
} tWFParam;
/* used in byte 2 of WF_CONNECTION_LOST_EVENT_SUBTYPE */
#define WF_CONNECTION_TEMPORARILY_LOST ((UINT8)0)
#define WF_CONNECTION_PERMANENTLY_LOST ((UINT8)1)
#define WF_FLASH_UPDATE_NOT_SUCCESSFUL ((UINT8)0)
#define WF_FLASH_UPDATE_SUCCESSFUL ((UINT8)1)
#define WF_MAX_TX_MGMT_MSG_SIZE (128)
#define DO_NOT_FREE_MGMT_BUFFER (0)
#define FREE_MGMT_BUFFER (1)
#define MGMT_RESP_1ST_DATA_BYTE_INDEX (4) /* first data byte of Mgmt response starts at index 4 */
#if 0
/*---------------------------------------------------------------------*/
/* Values that can appear in the result field of a management response */
/*---------------------------------------------------------------------*/
kZGMACResultSuccess = 1, // 1
kZGMACResultInvalidSubType, // 2
kZGMACResultCancelled, // 3
kZGMACResultFrameEol, // 4
kZGMACResultFrameRetryLimit, // 5
kZGMACResultFrameNoBss, // 6
kZGMACResultFrameTooBig, // 7
kZGMACResultFrameEncryptFailure, // 8
kZGMACResultInvalidParams, // 9
kZGMACResultAlreadyAuth, // 10
kZGMACResultAlreadyAssoc, // 11
kZGMACResultInsufficientRsrcs, // 12
kZGMACResultTimeout, // 13
kZGMACResultBadExchange, // 14 /* frame exchange problem with peer */
kZGMACResultAuthRefused, // 15 /* authenticating node refused our request */
kZGMACResultAsocRefused, // 16 /* associating node refused our request */
kZGMACResultReqInProgress, // 17 /* only one mlme request at a time allowed */
/* several requests first require that the Device successfully 'join' a network */
kZGMACResultNotJoined, // 18 /* operation requires that device be joined with target */
kZGMACResultNotAssoc, // 19 /* operation requires that device be associated with target */
kZGMACResultNotAuth, // 20 /* operation requires that device be authenticated with target */
kZGMACResultSupplicantFailed, // 21
kZGMACResultUnsupportedFeature, // 22
kZGMACResultRequestOutOfSync, // 23 /* Returned when a request is recognized but invalid given the current State of the MAC */
/* Connection Manager error codes */
kZGMACResultInvalidElementType, // 24
kZGMACResultInvalidProfileID, // 25
kZGMACResultInvalidDataLen, // 26
kZGMACResultInvalidSSIDLen, // 27
kZGMACResultInvalidSecType, // 28
kZGMACResultInvalidSecKeyLen, // 29
kZGMACResultInvalidWEPKeyID, // 30
kZGMACResultInvalidNetworkType, // 31
kZGMACResultInvalidAdhocMode, // 32
kZGMACResultInvalidScanType, // 33
kZGMACResultInvalidCPList, // 34
kZGMACResultInvalidChannelListLen, // 35
kZGMACResultNotConnected, // 36
kZGMACResultAlreadyConnecting, // 37
kZGMACResultDisconnectFailed, // 38
kZGMACResultNoStoredBssDesc // 39
#endif
#ifdef WF_DEBUG
/* this block of defines is used to check illegal reentry when in WF API functions */
#define WF_ENTERING_FUNCTION (1)
#define WF_LEAVING_FUNCTION (0)
/* bit masks for functions that need to be tracked when they are called */
#define WF_PROCESS_EVENT_FUNC ((UINT8)0x01)
#endif /* WF_DEBUG */
/*==========================================================================*/
/* TYPEDEFS */
/*==========================================================================*/
/* This structure describes the format of the first four bytes of all */
/* mgmt response messages received from the MRF24WB0M */
typedef struct mgmtRxHdrStruct
{
UINT8 type; /* always 0x02 */
UINT8 subtype; /* mgmt msg subtype */
UINT8 result; /* 1 if success, else failure */
UINT8 macState; /* not used */
} tMgmtMsgRxHdr;
typedef struct mgmtIndicateHdrStruct
{
UINT8 type; /* always WF_MGMT_INDICATE_MSG_TYPE (2) */
UINT8 subType; /* event type */
} tMgmtIndicateHdr;
/*==========================================================================*/
/* FUNCTION PROTOTYPES */
/*==========================================================================*/
void WaitForMgmtResponseAndReadData(UINT8 expectedSubtype,
UINT8 numDataBytes,
UINT8 startIndex,
UINT8 *p_data);
void SendMgmtMsg(UINT8 *p_header,
UINT8 headerLength,
UINT8 *p_data,
UINT8 dataLength);
void WaitForMgmtResponse(UINT8 expectedSubtype, UINT8 freeAction);
void SendGetParamMsg(UINT8 paramType, UINT8 *p_paramData, UINT8 paramDataLength);
void SendSetParamMsg(UINT8 paramType, UINT8 *p_paramData, UINT8 paramDataLength);
void WFProcessMgmtIndicateMsg(void);
void SignalMgmtConfirmReceivedEvent(void);
void WFSetConnectionState(UINT8 connectionState);
UINT8 WFGetConnectionState(void);
void WF_SetTxDataConfirm(UINT8 state); /* WF_ENABLED or WF_DISABLED */
void WF_GetTxDataConfirm(UINT8 *p_state); /* WF_ENABLED or WF_DISABLED */
BOOL WFisTxMgmtReady(void);
void WFFreeMgmtTx(void);
BOOL SendRAWManagementFrame(UINT16 bufLen);
void WFEnableMRF24WB0MMode(void);
void WFGetMRF24WB0MVersion(UINT8 *p_version);
/* When asserts are enabled, call this function. When asserts are not enabled compile it out */
#ifdef WF_DEBUG
/* if asserts enabled this function will be called */
void WFSetFuncState(UINT8 func, UINT8 state);
#else
/* if asserts disabled the function is no-op'ed */
#define WFSetFuncState(x,y)
#endif
#endif /* __WF_MGMT_MSG_H */
|