Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Defines

     Specifies the macros and defines used by the Wlan APIs.

Modules

 DebugDefines
 

Macros

#define DEFAULT_CONF_AR_INITIALIZER   { 5, 1, TX_RATE_AUTO, TX_RATE_AUTO, 10, 5, 3 }
 
#define M2M_802_1X_MSCHAP2_FLAG   0x01
 
#define M2M_802_1X_PREPEND_DOMAIN_FLAG   0x40
 
#define M2M_802_1X_TLS_CLIENT_CERTIFICATE   1
 
#define M2M_802_1X_TLS_FLAG   0x02
 
#define M2M_802_1X_UNENCRYPTED_USERNAME_FLAG   0x80
 
#define M2M_AP_CMD_BASE   70
 
#define M2M_AUTH_1X_CERT_LEN_MAX   1584
 
#define M2M_AUTH_1X_PASSWORD_LEN_MAX   256
 
#define M2M_AUTH_1X_PRIVATEKEY_LEN_MAX   256
 
#define M2M_AUTH_1X_USER_LEN_MAX   100
 
#define M2M_BUFFER_MAX_SIZE   (1600UL - 4)
 
#define M2M_CONFIG_CMD_BASE   1
 
#define M2M_CRED_ENCRYPT_FLAG   0x02
 
#define M2M_CRED_IS_ENCRYPTED_FLAG   0x20
 
#define M2M_CRED_IS_STORED_FLAG   0x10
 
#define M2M_CRED_STORE_FLAG   0x01
 
#define M2M_CRYPTO_CMD_BASE   1
 
#define M2M_CUST_IE_LEN_MAX   252
 
#define M2M_DEVICE_NAME_MAX   48
 
#define M2M_ETHERNET_HDR_LEN   14
 
#define M2M_ETHERNET_HDR_OFFSET   34
 
#define M2M_FASTCONNECT_DEFAULT_RSSI_THRESH   (-45)
 
#define M2M_GEN_CMD_BASE   105
 
#define M2M_LISTEN_INTERVAL   1
 
#define M2M_MAC_ADDRES_LEN   6
 
#define M2M_MAX_GRP_NUM_REQ   (127)
 
#define M2M_MAX_PSK_LEN   65
 
#define M2M_MAX_SSID_LEN   33
 
#define M2M_MIN_PSK_LEN   9
 
#define M2M_NTP_MAX_SERVER_NAME_LENGTH   32
 
#define M2M_OTA_CMD_BASE   100
 
#define M2M_SCAN_DEFAULT_NUM_PROBE   (2)
 
#define M2M_SCAN_DEFAULT_NUM_SLOTS   (2)
 
#define M2M_SCAN_DEFAULT_PASSIVE_SLOT_TIME   (300)
 
#define M2M_SCAN_DEFAULT_SLOT_TIME   (30)
 
#define M2M_SERVER_CMD_BASE   100
 
#define M2M_SHA256_CONTEXT_BUFF_LEN   (128)
 
#define M2M_STA_CMD_BASE   40
 
#define M2M_WIFI_CONN_BSSID_FLAG   0x01
 
#define MAX_HIDDEN_SITES   4
 
#define PSK_CALC_LEN   40
 
#define PWR_DEFAULT   PWR_HIGH
 
#define TLS_CERTS_CHUNKED_SIG_VALUE   0x6ec8
 
#define TLS_CRL_DATA_MAX_LEN   64
 
#define TLS_CRL_MAX_ENTRIES   10
 
#define TLS_CRL_TYPE_CERT_HASH   1
 
#define TLS_CRL_TYPE_NONE   0
 
#define TLS_FILE_NAME_MAX   48
 
#define TLS_SRV_SEC_MAX_FILES   8
 
#define TLS_SRV_SEC_START_PATTERN_LEN   8
 
#define WEP_104_KEY_SIZE   ((uint8)13)
 
#define WEP_104_KEY_STRING_SIZE   ((uint8)26)
 
#define WEP_40_KEY_SIZE   ((uint8)5)
 
#define WEP_40_KEY_STRING_SIZE   ((uint8)10)
 
#define WEP_KEY_MAX_INDEX   ((uint8)4)
 
#define WLAN_11B_RATES_INITIALIZER
 
#define WLAN_11BG_RATES_ASC_INITIALIZER
 
#define WLAN_11BGN_RATES_ASC_INITIALIZER
 
#define WLAN_11G_RATES_INITIALIZER
 
#define WLAN_11N_RATES_INITIALIZER
 

#define DEFAULT_CONF_AR_INITIALIZER   { 5, 1, TX_RATE_AUTO, TX_RATE_AUTO, 10, 5, 3 }
#define M2M_802_1X_MSCHAP2_FLAG   0x01

Flag to indicate 802.1x MsChapV2 credentials: domain/user-name/password.

Referenced by m2m_wifi_connect_1x_mschap2().

#define M2M_802_1X_PREPEND_DOMAIN_FLAG   0x40

Flag to indicate that the 802.1x domain name should be prepended to the user-name: "Domain\Username". If the flag is not set then domain name is appended to the user-name: "Username@Domain". (Note that the '@' or '\' must be included in the domain name.)

Referenced by m2m_wifi_connect_1x_mschap2(), and m2m_wifi_connect_1x_tls().

#define M2M_802_1X_TLS_CLIENT_CERTIFICATE   1

Info type used in tstrM2mWifiAuthInfoHdr to indicate Enterprise TLS client certificate.

Referenced by m2m_wifi_connect_1x_tls().

#define M2M_802_1X_TLS_FLAG   0x02

Flag to indicate 802.1x TLS credentials: domain/user-name/private-key/certificate.

Referenced by m2m_wifi_connect_1x_tls().

#define M2M_802_1X_UNENCRYPTED_USERNAME_FLAG   0x80

Flag to indicate that the 802.1x user-name should be sent (unencrypted) in the initial EAP identity response. Intended for use with EAP-TLS only.

Referenced by m2m_wifi_connect_1x_mschap2(), and m2m_wifi_connect_1x_tls().

#define M2M_AP_CMD_BASE   70

The base value of all the Access Point mode host commands opcodes.

#define M2M_AUTH_1X_CERT_LEN_MAX   1584

The maximum length (in bytes) of certificate for authentication with Enterprise TLS methods.

Referenced by m2m_wifi_connect_1x_tls().

#define M2M_AUTH_1X_PASSWORD_LEN_MAX   256

The maximum length (in ASCII characters) of password for authentication with Enterprise MSCHAPv2 methods.

Referenced by m2m_wifi_connect_1x_mschap2().

#define M2M_AUTH_1X_PRIVATEKEY_LEN_MAX   256

The maximum length (in bytes) of private key modulus for authentication with Enterprise TLS methods. Private key exponent must be the same length as modulus, pre-padded with 0s if necessary.

Referenced by m2m_wifi_connect_1x_tls().

#define M2M_AUTH_1X_USER_LEN_MAX   100

The maximum length (in ASCII characters) of domain name + username (including '@' or '\') for authentication with Enterprise methods.

Referenced by m2m_wifi_connect_1x_mschap2(), and m2m_wifi_connect_1x_tls().

#define M2M_BUFFER_MAX_SIZE   (1600UL - 4)

Maximum size for the shared packet buffer.

#define M2M_CONFIG_CMD_BASE   1

The base value of all the host configuration commands opcodes.

#define M2M_CRED_ENCRYPT_FLAG   0x02

Flag used in tstrM2mConnCredHdr to indicate that Wi-Fi connection credentials should be encrypted when stored in WINC flash.

Referenced by m2m_wifi_connect_prepare_msg().

#define M2M_CRED_IS_ENCRYPTED_FLAG   0x20

Flag used in tstrM2mConnCredHdr to indicate that Wi-Fi connection credentials are encrypted in WINC flash. May only be set by WINC firmware.

#define M2M_CRED_IS_STORED_FLAG   0x10

Flag used in tstrM2mConnCredHdr to indicate that Wi-Fi connection credentials are stored in WINC flash. May only be set by WINC firmware.

#define M2M_CRED_STORE_FLAG   0x01

Flag used in tstrM2mConnCredHdr to indicate that Wi-Fi connection credentials should be stored in WINC flash.

Referenced by m2m_wifi_connect_prepare_msg().

#define M2M_CRYPTO_CMD_BASE   1

The base value of all the crypto mode host commands opcodes. The crypto Have special group so can extended from 1-M2M_MAX_GRP_NUM_REQ

#define M2M_CUST_IE_LEN_MAX   252

The maximum size of IE (Information Element).

Referenced by m2m_wifi_set_cust_InfoElement().

#define M2M_DEVICE_NAME_MAX   48

Maximum Size for the device name including the NULL termination.

Referenced by m2m_wifi_set_device_name().

#define M2M_ETHERNET_HDR_LEN   14

Length of the Ethernet header in bytes.

Referenced by m2m_wifi_send_ethernet_pkt().

#define M2M_ETHERNET_HDR_OFFSET   34

The offset of the Ethernet header within the WLAN Tx Buffer.

Referenced by m2m_wifi_send_ethernet_pkt().

#define M2M_FASTCONNECT_DEFAULT_RSSI_THRESH   (-45)

The default threshold RSSI for fast reconnection to an AP.

#define M2M_GEN_CMD_BASE   105

The base value of additional host wifi command opcodes. Usage restrictions (eg STA mode only) should always be made clear at the API layer in any case.

#define M2M_LISTEN_INTERVAL   1

The STA uses the Listen Interval parameter to indicate to the AP how many beacon intervals it shall sleep before it retrieves the queued frames from the AP.

Referenced by main().

#define M2M_MAC_ADDRES_LEN   6

The size of the 802 MAC address.

Referenced by m2m_wifi_connect_prepare_msg().

#define M2M_MAX_GRP_NUM_REQ   (127)

max number of request in one group equal to 127 as the last bit reserved for config or data pkt

#define M2M_MAX_PSK_LEN   65

1 more than the WPA PSK length (in ASCII format). This matches the size of the WPA PSK/Passphrase buffer (max ASCII contents + 1-byte length field). Alternatively it matches the WPA PSK length (in ASCII format) + 1 byte NULL termination.

Referenced by m2m_validate_ap_parameters(), m2m_wifi_connect_psk(), m2m_wifi_connect_sc(), and socket_cb().

#define M2M_MAX_SSID_LEN   33

1 more than the max SSID length. This matches the size of SSID buffers (max SSID length + 1-byte length field).

Referenced by m2m_validate_ap_parameters(), m2m_wifi_connect_prepare_msg(), m2m_wifi_connect_sc(), m2m_wifi_delete_sc(), m2m_wifi_request_scan_ssid_list(), and socket_cb().

#define M2M_MIN_PSK_LEN   9

1 more than the minimum WPA PSK Passphrase length. It matches the minimum WPA PSK Passphrase length + 1 byte NULL termination.

Referenced by m2m_validate_ap_parameters().

#define M2M_NTP_MAX_SERVER_NAME_LENGTH   32

Maximum NTP server name length

Referenced by m2m_wifi_configure_sntp().

#define M2M_OTA_CMD_BASE   100

The base value of all the OTA mode host commands opcodes. The OTA Have special group so can extended from 1-M2M_MAX_GRP_NUM_REQ

#define M2M_SCAN_DEFAULT_NUM_PROBE   (2)

The default number of probes per scan slot.

Referenced by m2m_validate_scan_options().

#define M2M_SCAN_DEFAULT_NUM_SLOTS   (2)

The default number of scan slots used by the WINC board.

#define M2M_SCAN_DEFAULT_PASSIVE_SLOT_TIME   (300)

The passive scan slot default duration in ms.

#define M2M_SCAN_DEFAULT_SLOT_TIME   (30)

The default duration in miliseconds of an active scan slot used by the WINC board.

#define M2M_SERVER_CMD_BASE   100

The base value of all the power save mode host commands codes.

#define M2M_SHA256_CONTEXT_BUFF_LEN   (128)

sha256 context size

#define M2M_STA_CMD_BASE   40

The base value of all the station mode host commands opcodes.

#define M2M_WIFI_CONN_BSSID_FLAG   0x01

Flag used in tstrM2mConnCredCmn to indicate that Wi-Fi connection must be restricted to an AP with a certain BSSID.

Referenced by m2m_wifi_connect_prepare_msg().

#define MAX_HIDDEN_SITES   4

max number of hidden SSID supported by scan request

Referenced by m2m_wifi_request_scan_ssid_list().

#define PSK_CALC_LEN   40

PSK is 32 bytes generated either:

  • from 64 ASCII characters
  • by SHA1 operations on up to 63 ASCII characters 40 byte array is required during SHA1 operations, so we define PSK_CALC_LEN as 40.
#define PWR_DEFAULT   PWR_HIGH
#define TLS_CERTS_CHUNKED_SIG_VALUE   0x6ec8
#define TLS_CRL_DATA_MAX_LEN   64
#define TLS_CRL_MAX_ENTRIES   10
#define TLS_CRL_TYPE_CERT_HASH   1
#define TLS_CRL_TYPE_NONE   0
#define TLS_FILE_NAME_MAX   48

Maximum length for each TLS certificate file name including null terminator.

#define TLS_SRV_SEC_MAX_FILES   8

Maximum number of certificates allowed in TLS_SRV section.

Referenced by TlsSrvSecFopen().

#define TLS_SRV_SEC_START_PATTERN_LEN   8

Length of certificate struct start pattern.

Referenced by TlsSrvSecWriteCertChain().

#define WEP_104_KEY_SIZE   ((uint8)13)

The size in bytes of a 104-bit wep key.

#define WEP_104_KEY_STRING_SIZE   ((uint8)26)

The string length of a 104-bit wep key.

Referenced by m2m_validate_ap_parameters(), and m2m_wifi_connect_wep().

#define WEP_40_KEY_SIZE   ((uint8)5)

The size in bytes of a 40-bit wep key.

#define WEP_40_KEY_STRING_SIZE   ((uint8)10)

The string length of a 40-bit wep key.

Referenced by m2m_validate_ap_parameters(), and m2m_wifi_connect_wep().

#define WEP_KEY_MAX_INDEX   ((uint8)4)

WEP key index is in the range 1 to 4 inclusive. (This is decremented to result in an index in the range 0 to 3 on air.)

Referenced by m2m_validate_ap_parameters(), and m2m_wifi_connect_wep().

#define WLAN_11B_RATES_INITIALIZER
Value:
{ \
}
Definition: m2m_types.h:2787
Definition: m2m_types.h:2785
Definition: m2m_types.h:2786
Definition: m2m_types.h:2784
#define WLAN_11BG_RATES_ASC_INITIALIZER
Value:
{ \
}
Definition: m2m_types.h:2790
Definition: m2m_types.h:2791
Definition: m2m_types.h:2787
Definition: m2m_types.h:2789
Definition: m2m_types.h:2785
Definition: m2m_types.h:2794
Definition: m2m_types.h:2795
Definition: m2m_types.h:2793
Definition: m2m_types.h:2786
Definition: m2m_types.h:2788
Definition: m2m_types.h:2784
Definition: m2m_types.h:2792
#define WLAN_11BGN_RATES_ASC_INITIALIZER
Value:
{ \
}
Definition: m2m_types.h:2790
Definition: m2m_types.h:2791
Definition: m2m_types.h:2787
Definition: m2m_types.h:2789
Definition: m2m_types.h:2785
Definition: m2m_types.h:2794
Definition: m2m_types.h:2799
Definition: m2m_types.h:2798
Definition: m2m_types.h:2803
Definition: m2m_types.h:2800
Definition: m2m_types.h:2795
Definition: m2m_types.h:2793
Definition: m2m_types.h:2786
Definition: m2m_types.h:2802
Definition: m2m_types.h:2788
Definition: m2m_types.h:2796
Definition: m2m_types.h:2797
Definition: m2m_types.h:2784
Definition: m2m_types.h:2792
Definition: m2m_types.h:2801
#define WLAN_11G_RATES_INITIALIZER
Value:
{ \
}
Definition: m2m_types.h:2790
Definition: m2m_types.h:2791
Definition: m2m_types.h:2789
Definition: m2m_types.h:2794
Definition: m2m_types.h:2795
Definition: m2m_types.h:2793
Definition: m2m_types.h:2788
Definition: m2m_types.h:2792
#define WLAN_11N_RATES_INITIALIZER
Value:
{ \
}
Definition: m2m_types.h:2799
Definition: m2m_types.h:2798
Definition: m2m_types.h:2803
Definition: m2m_types.h:2800
Definition: m2m_types.h:2802
Definition: m2m_types.h:2796
Definition: m2m_types.h:2797
Definition: m2m_types.h:2801