TI's CC3100 websocket camera demo with Arducam mini ov5642 and freertos. Should work with other M3's. Work in progress test demo.

Dependencies:   mbed

Committer:
dflet
Date:
Fri Sep 11 15:38:33 2015 +0000
Revision:
1:e448e81c416f
Parent:
0:400d8e75a8d0
Removed some debud.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dflet 0:400d8e75a8d0 1 /*
dflet 0:400d8e75a8d0 2 * wlan.h - CC31xx/CC32xx Host Driver Implementation
dflet 0:400d8e75a8d0 3 *
dflet 0:400d8e75a8d0 4 * Copyright (C) 2014 Texas Instruments Incorporated - http://www.ti.com/
dflet 0:400d8e75a8d0 5 *
dflet 0:400d8e75a8d0 6 *
dflet 0:400d8e75a8d0 7 * Redistribution and use in source and binary forms, with or without
dflet 0:400d8e75a8d0 8 * modification, are permitted provided that the following conditions
dflet 0:400d8e75a8d0 9 * are met:
dflet 0:400d8e75a8d0 10 *
dflet 0:400d8e75a8d0 11 * Redistributions of source code must retain the above copyright
dflet 0:400d8e75a8d0 12 * notice, this list of conditions and the following disclaimer.
dflet 0:400d8e75a8d0 13 *
dflet 0:400d8e75a8d0 14 * Redistributions in binary form must reproduce the above copyright
dflet 0:400d8e75a8d0 15 * notice, this list of conditions and the following disclaimer in the
dflet 0:400d8e75a8d0 16 * documentation and/or other materials provided with the
dflet 0:400d8e75a8d0 17 * distribution.
dflet 0:400d8e75a8d0 18 *
dflet 0:400d8e75a8d0 19 * Neither the name of Texas Instruments Incorporated nor the names of
dflet 0:400d8e75a8d0 20 * its contributors may be used to endorse or promote products derived
dflet 0:400d8e75a8d0 21 * from this software without specific prior written permission.
dflet 0:400d8e75a8d0 22 *
dflet 0:400d8e75a8d0 23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
dflet 0:400d8e75a8d0 24 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
dflet 0:400d8e75a8d0 25 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
dflet 0:400d8e75a8d0 26 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
dflet 0:400d8e75a8d0 27 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
dflet 0:400d8e75a8d0 28 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
dflet 0:400d8e75a8d0 29 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
dflet 0:400d8e75a8d0 30 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
dflet 0:400d8e75a8d0 31 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
dflet 0:400d8e75a8d0 32 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
dflet 0:400d8e75a8d0 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
dflet 0:400d8e75a8d0 34 *
dflet 0:400d8e75a8d0 35 */
dflet 0:400d8e75a8d0 36
dflet 0:400d8e75a8d0 37 /*****************************************************************************/
dflet 0:400d8e75a8d0 38 /* Include files */
dflet 0:400d8e75a8d0 39 /*****************************************************************************/
dflet 0:400d8e75a8d0 40 #include "cc3100_simplelink.h"
dflet 0:400d8e75a8d0 41
dflet 0:400d8e75a8d0 42 #ifndef WLAN_H_
dflet 0:400d8e75a8d0 43 #define WLAN_H_
dflet 0:400d8e75a8d0 44
dflet 0:400d8e75a8d0 45 namespace mbed_cc3100 {
dflet 0:400d8e75a8d0 46
dflet 0:400d8e75a8d0 47 /*****************************************************************************/
dflet 0:400d8e75a8d0 48 /* Macro declarations */
dflet 0:400d8e75a8d0 49 /*****************************************************************************/
dflet 0:400d8e75a8d0 50
dflet 0:400d8e75a8d0 51 /*!
dflet 0:400d8e75a8d0 52
dflet 0:400d8e75a8d0 53 \addtogroup wlan
dflet 0:400d8e75a8d0 54 @{
dflet 0:400d8e75a8d0 55
dflet 0:400d8e75a8d0 56 */
dflet 0:400d8e75a8d0 57
dflet 0:400d8e75a8d0 58 const uint8_t SL_BSSID_LENGTH = (6);
dflet 0:400d8e75a8d0 59 const uint8_t MAXIMAL_SSID_LENGTH = (32);
dflet 0:400d8e75a8d0 60
dflet 0:400d8e75a8d0 61 const uint8_t NUM_OF_RATE_INDEXES = (20);
dflet 0:400d8e75a8d0 62 const uint8_t SIZE_OF_RSSI_HISTOGRAM = (6);
dflet 0:400d8e75a8d0 63
dflet 0:400d8e75a8d0 64 /* WLAN Disconnect Reason Codes */
dflet 0:400d8e75a8d0 65 const uint8_t SL_DISCONNECT_RESERVED_0 = (0);
dflet 0:400d8e75a8d0 66 const uint8_t SL_DISCONNECT_UNSPECIFIED_REASON = (1);
dflet 0:400d8e75a8d0 67 const uint8_t SL_PREVIOUS_AUTHENTICATION_NO_LONGER_VALID = (2);
dflet 0:400d8e75a8d0 68 const uint8_t SL_DEAUTHENTICATED_BECAUSE_SENDING_STATION_IS_LEAVING = (3);
dflet 0:400d8e75a8d0 69 const uint8_t SL_DISASSOCIATED_DUE_TO_INACTIVITY = (4);
dflet 0:400d8e75a8d0 70 const uint8_t SL_DISASSOCIATED_BECAUSE_AP_IS_UNABLE_TO_HANDLE_ALL_CURRENTLY_ASSOCIATED_STATIONS = (5);
dflet 0:400d8e75a8d0 71 const uint8_t SL_CLASS_2_FRAME_RECEIVED_FROM_NONAUTHENTICATED_STATION = (6);
dflet 0:400d8e75a8d0 72 const uint8_t SL_CLASS_3_FRAME_RECEIVED_FROM_NONASSOCIATED_STATION = (7);
dflet 0:400d8e75a8d0 73 const uint8_t SL_DISASSOCIATED_BECAUSE_SENDING_STATION_IS_LEAVING_BSS = (8);
dflet 0:400d8e75a8d0 74 const uint8_t SL_STATION_REQUESTING_ASSOCIATION_IS_NOT_AUTHENTICATED_WITH_RESPONDING_STATION = (9);
dflet 0:400d8e75a8d0 75 const uint8_t SL_DISASSOCIATED_BECAUSE_THE_INFORMATION_IN_THE_POWER_CAPABILITY_ELEMENT_IS_UNACCEPTABLE = (10);
dflet 0:400d8e75a8d0 76 const uint8_t SL_DISASSOCIATED_BECAUSE_THE_INFORMATION_IN_THE_SUPPORTED_CHANNELS_ELEMENT_IS_UNACCEPTABLE = (11);
dflet 0:400d8e75a8d0 77 const uint8_t SL_DISCONNECT_RESERVED_1 = (12);
dflet 0:400d8e75a8d0 78 const uint8_t SL_INVALID_INFORMATION_ELEMENT = (13);
dflet 0:400d8e75a8d0 79 const uint8_t SL_MESSAGE_INTEGRITY_CODE_MIC_FAILURE = (14);
dflet 0:400d8e75a8d0 80 const uint8_t SL_FOUR_WAY_HANDSHAKE_TIMEOUT = (15);
dflet 0:400d8e75a8d0 81 const uint8_t SL_GROUP_KEY_HANDSHAKE_TIMEOUT = (16);
dflet 0:400d8e75a8d0 82 const uint8_t SL_RE_ASSOCIATION_REQUEST_PROBE_RESPONSE_BEACON_FRAME = (17);
dflet 0:400d8e75a8d0 83 const uint8_t SL_INVALID_GROUP_CIPHER = (18);
dflet 0:400d8e75a8d0 84 const uint8_t SL_INVALID_PAIRWISE_CIPHER = (19);
dflet 0:400d8e75a8d0 85 const uint8_t SL_INVALID_AKMP = (20);
dflet 0:400d8e75a8d0 86 const uint8_t SL_UNSUPPORTED_RSN_INFORMATION_ELEMENT_VERSION = (21);
dflet 0:400d8e75a8d0 87 const uint8_t SL_INVALID_RSN_INFORMATION_ELEMENT_CAPABILITIES = (22);
dflet 0:400d8e75a8d0 88 const uint8_t SL_IEEE_802_1X_AUTHENTICATION_FAILED = (23);
dflet 0:400d8e75a8d0 89 const uint8_t SL_CIPHER_SUITE_REJECTED_BECAUSE_OF_THE_SECURITY_POLICY = (24);
dflet 0:400d8e75a8d0 90 const uint8_t SL_DISCONNECT_RESERVED_2 = (25);
dflet 0:400d8e75a8d0 91 const uint8_t SL_DISCONNECT_RESERVED_3 = (26);
dflet 0:400d8e75a8d0 92 const uint8_t SL_DISCONNECT_RESERVED_4 = (27);
dflet 0:400d8e75a8d0 93 const uint8_t SL_DISCONNECT_RESERVED_5 = (28);
dflet 0:400d8e75a8d0 94 const uint8_t SL_DISCONNECT_RESERVED_6 = (29);
dflet 0:400d8e75a8d0 95 const uint8_t SL_DISCONNECT_RESERVED_7 = (30);
dflet 0:400d8e75a8d0 96 const uint8_t SL_DISCONNECT_RESERVED_8 = (31);
dflet 0:400d8e75a8d0 97 const uint8_t SL_USER_INITIATED_DISCONNECTION = (200);
dflet 0:400d8e75a8d0 98
dflet 0:400d8e75a8d0 99 /* Wlan error codes */
dflet 0:400d8e75a8d0 100 const int8_t SL_ERROR_KEY_ERROR = (-3);
dflet 0:400d8e75a8d0 101 const int8_t SL_ERROR_INVALID_ROLE = (-71);
dflet 0:400d8e75a8d0 102 const int8_t SL_ERROR_INVALID_SECURITY_TYPE = (-84);
dflet 0:400d8e75a8d0 103 const int8_t SL_ERROR_PASSPHRASE_TOO_LONG = (-85);
dflet 0:400d8e75a8d0 104 const int8_t SL_ERROR_WPS_NO_PIN_OR_WRONG_PIN_LEN = (-87);
dflet 0:400d8e75a8d0 105 const int8_t SL_ERROR_EAP_WRONG_METHOD = (-88);
dflet 0:400d8e75a8d0 106 const int8_t SL_ERROR_PASSWORD_ERROR = (-89);
dflet 0:400d8e75a8d0 107 const int8_t SL_ERROR_EAP_ANONYMOUS_LEN_ERROR = (-90);
dflet 0:400d8e75a8d0 108 const int8_t SL_ERROR_SSID_LEN_ERROR = (-91);
dflet 0:400d8e75a8d0 109 const int8_t SL_ERROR_USER_ID_LEN_ERROR = (-92);
dflet 0:400d8e75a8d0 110 const int8_t SL_ERROR_ILLEGAL_WEP_KEY_INDEX = (-95);
dflet 0:400d8e75a8d0 111 const int8_t SL_ERROR_INVALID_DWELL_TIME_VALUES = (-96);
dflet 0:400d8e75a8d0 112 const int8_t SL_ERROR_INVALID_POLICY_TYPE = (-97);
dflet 0:400d8e75a8d0 113 const int8_t SL_ERROR_PM_POLICY_INVALID_OPTION = (-98);
dflet 0:400d8e75a8d0 114 const int8_t SL_ERROR_PM_POLICY_INVALID_PARAMS = (-99);
dflet 0:400d8e75a8d0 115 const int16_t SL_ERROR_WIFI_ALREADY_DISCONNECTED = (-129);
dflet 0:400d8e75a8d0 116 const int8_t SL_ERROR_WIFI_NOT_CONNECTED = (-59);
dflet 0:400d8e75a8d0 117
dflet 0:400d8e75a8d0 118
dflet 0:400d8e75a8d0 119
dflet 0:400d8e75a8d0 120 const uint8_t SL_SEC_TYPE_OPEN = (0);
dflet 0:400d8e75a8d0 121 const uint8_t SL_SEC_TYPE_WEP = (1);
dflet 0:400d8e75a8d0 122 const uint8_t SL_SEC_TYPE_WPA = (2); /* deprecated */
dflet 0:400d8e75a8d0 123 const uint8_t SL_SEC_TYPE_WPA_WPA2 = (2);
dflet 0:400d8e75a8d0 124 const uint8_t SL_SEC_TYPE_WPS_PBC = (3);
dflet 0:400d8e75a8d0 125 const uint8_t SL_SEC_TYPE_WPS_PIN = (4);
dflet 0:400d8e75a8d0 126 const uint8_t SL_SEC_TYPE_WPA_ENT = (5);
dflet 0:400d8e75a8d0 127 const uint8_t SL_SEC_TYPE_P2P_PBC = (6);
dflet 0:400d8e75a8d0 128 const uint8_t SL_SEC_TYPE_P2P_PIN_KEYPAD = (7);
dflet 0:400d8e75a8d0 129 const uint8_t SL_SEC_TYPE_P2P_PIN_DISPLAY = (8);
dflet 0:400d8e75a8d0 130 const uint8_t SL_SEC_TYPE_P2P_PIN_AUTO = (9); /* NOT Supported yet */
dflet 0:400d8e75a8d0 131
dflet 0:400d8e75a8d0 132
dflet 0:400d8e75a8d0 133
dflet 0:400d8e75a8d0 134 const uint8_t SL_SCAN_SEC_TYPE_OPEN = (0);
dflet 0:400d8e75a8d0 135 const uint8_t SL_SCAN_SEC_TYPE_WEP = (1);
dflet 0:400d8e75a8d0 136 const uint8_t SL_SCAN_SEC_TYPE_WPA = (2);
dflet 0:400d8e75a8d0 137 const uint8_t SL_SCAN_SEC_TYPE_WPA2 = (3);
dflet 0:400d8e75a8d0 138
dflet 0:400d8e75a8d0 139
dflet 0:400d8e75a8d0 140
dflet 0:400d8e75a8d0 141 const uint8_t TLS = (0x1);
dflet 0:400d8e75a8d0 142 const uint8_t MSCHAP = (0x0);
dflet 0:400d8e75a8d0 143 const uint8_t PSK = (0x2);
dflet 0:400d8e75a8d0 144 const uint8_t TTLS = (0x10);
dflet 0:400d8e75a8d0 145 const uint8_t PEAP0 = (0x20);
dflet 0:400d8e75a8d0 146 const uint8_t PEAP1 = (0x40);
dflet 0:400d8e75a8d0 147 const uint8_t FAST = (0x80);
dflet 0:400d8e75a8d0 148
dflet 0:400d8e75a8d0 149 const uint8_t FAST_AUTH_PROVISIONING = (0x02);
dflet 0:400d8e75a8d0 150 const uint8_t FAST_UNAUTH_PROVISIONING = (0x01);
dflet 0:400d8e75a8d0 151 const uint8_t FAST_NO_PROVISIONING = (0x00);
dflet 0:400d8e75a8d0 152
dflet 0:400d8e75a8d0 153 const uint8_t EAPMETHOD_PHASE2_SHIFT = (8);
dflet 0:400d8e75a8d0 154 const uint8_t EAPMETHOD_PAIRWISE_CIPHER_SHIFT = (19);
dflet 0:400d8e75a8d0 155 const uint8_t EAPMETHOD_GROUP_CIPHER_SHIFT = (27);
dflet 0:400d8e75a8d0 156
dflet 0:400d8e75a8d0 157 const uint8_t WPA_CIPHER_CCMP = (0x1);
dflet 0:400d8e75a8d0 158 const uint8_t WPA_CIPHER_TKIP = (0x2);
dflet 0:400d8e75a8d0 159 const uint8_t CC31XX_DEFAULT_CIPHER = (WPA_CIPHER_CCMP | WPA_CIPHER_TKIP);
dflet 0:400d8e75a8d0 160
dflet 0:400d8e75a8d0 161 #define EAPMETHOD(phase1,phase2,pairwise_cipher,group_cipher) \
dflet 0:400d8e75a8d0 162 ((phase1) | \
dflet 0:400d8e75a8d0 163 ((phase2) << EAPMETHOD_PHASE2_SHIFT ) |\
dflet 0:400d8e75a8d0 164 ((uint32_t)(pairwise_cipher) << EAPMETHOD_PAIRWISE_CIPHER_SHIFT ) |\
dflet 0:400d8e75a8d0 165 ((uint32_t)(group_cipher) << EAPMETHOD_GROUP_CIPHER_SHIFT ))
dflet 0:400d8e75a8d0 166
dflet 0:400d8e75a8d0 167 /* phase1 phase2 pairwise_cipher group_cipher */
dflet 0:400d8e75a8d0 168 #define SL_ENT_EAP_METHOD_TLS EAPMETHOD(TLS , 0 , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 169 #define SL_ENT_EAP_METHOD_TTLS_TLS EAPMETHOD(TTLS , TLS , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 170 #define SL_ENT_EAP_METHOD_TTLS_MSCHAPv2 EAPMETHOD(TTLS , MSCHAP , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 171 #define SL_ENT_EAP_METHOD_TTLS_PSK EAPMETHOD(TTLS , PSK , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 172 #define SL_ENT_EAP_METHOD_PEAP0_TLS EAPMETHOD(PEAP0 , TLS , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 173 #define SL_ENT_EAP_METHOD_PEAP0_MSCHAPv2 EAPMETHOD(PEAP0 , MSCHAP , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 174 #define SL_ENT_EAP_METHOD_PEAP0_PSK EAPMETHOD(PEAP0 , PSK , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 175 #define SL_ENT_EAP_METHOD_PEAP1_TLS EAPMETHOD(PEAP1 , TLS , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 176 #define SL_ENT_EAP_METHOD_PEAP1_MSCHAPv2 EAPMETHOD(PEAP1 , MSCHAP , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 177 #define SL_ENT_EAP_METHOD_PEAP1_PSK EAPMETHOD(PEAP1 , PSK , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 178 #define SL_ENT_EAP_METHOD_FAST_AUTH_PROVISIONING EAPMETHOD(FAST , FAST_AUTH_PROVISIONING , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 179 #define SL_ENT_EAP_METHOD_FAST_UNAUTH_PROVISIONING EAPMETHOD(FAST , FAST_UNAUTH_PROVISIONING , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 180 #define SL_ENT_EAP_METHOD_FAST_NO_PROVISIONING EAPMETHOD(FAST , FAST_NO_PROVISIONING , CC31XX_DEFAULT_CIPHER , CC31XX_DEFAULT_CIPHER)
dflet 0:400d8e75a8d0 181
dflet 0:400d8e75a8d0 182 const uint8_t SL_LONG_PREAMBLE = (0);
dflet 0:400d8e75a8d0 183 const uint8_t SL_SHORT_PREAMBLE = (1);
dflet 0:400d8e75a8d0 184
dflet 0:400d8e75a8d0 185 const uint8_t SL_RAW_RF_TX_PARAMS_CHANNEL_SHIFT = (0);
dflet 0:400d8e75a8d0 186 const uint8_t SL_RAW_RF_TX_PARAMS_RATE_SHIFT = (6);
dflet 0:400d8e75a8d0 187 const uint8_t SL_RAW_RF_TX_PARAMS_POWER_SHIFT = (11);
dflet 0:400d8e75a8d0 188 const uint8_t SL_RAW_RF_TX_PARAMS_PREAMBLE_SHIFT = (15);
dflet 0:400d8e75a8d0 189
dflet 0:400d8e75a8d0 190 #define SL_RAW_RF_TX_PARAMS(chan,rate,power,preamble) \
dflet 0:400d8e75a8d0 191 ((chan << SL_RAW_RF_TX_PARAMS_CHANNEL_SHIFT) | \
dflet 0:400d8e75a8d0 192 (rate << SL_RAW_RF_TX_PARAMS_RATE_SHIFT) | \
dflet 0:400d8e75a8d0 193 (power << SL_RAW_RF_TX_PARAMS_POWER_SHIFT) | \
dflet 0:400d8e75a8d0 194 (preamble << SL_RAW_RF_TX_PARAMS_PREAMBLE_SHIFT))
dflet 0:400d8e75a8d0 195
dflet 0:400d8e75a8d0 196
dflet 0:400d8e75a8d0 197 /* wlan config application IDs */
dflet 0:400d8e75a8d0 198 const uint8_t SL_WLAN_CFG_AP_ID = (0);
dflet 0:400d8e75a8d0 199 const uint8_t SL_WLAN_CFG_GENERAL_PARAM_ID = (1);
dflet 0:400d8e75a8d0 200 const uint8_t SL_WLAN_CFG_P2P_PARAM_ID = (2);
dflet 0:400d8e75a8d0 201
dflet 0:400d8e75a8d0 202 /* wlan AP Config set/get options */
dflet 0:400d8e75a8d0 203 const uint8_t WLAN_AP_OPT_SSID = (0);
dflet 0:400d8e75a8d0 204 const uint8_t WLAN_AP_OPT_CHANNEL = (3);
dflet 0:400d8e75a8d0 205 const uint8_t WLAN_AP_OPT_HIDDEN_SSID = (4);
dflet 0:400d8e75a8d0 206 const uint8_t WLAN_AP_OPT_SECURITY_TYPE = (6);
dflet 0:400d8e75a8d0 207 const uint8_t WLAN_AP_OPT_PASSWORD = (7);
dflet 0:400d8e75a8d0 208 const uint8_t WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE = (9);
dflet 0:400d8e75a8d0 209 const uint8_t WLAN_GENERAL_PARAM_OPT_STA_TX_POWER = (10);
dflet 0:400d8e75a8d0 210 const uint8_t WLAN_GENERAL_PARAM_OPT_AP_TX_POWER = (11);
dflet 0:400d8e75a8d0 211
dflet 0:400d8e75a8d0 212 const uint8_t WLAN_P2P_OPT_DEV_NAME = (12);
dflet 0:400d8e75a8d0 213 const uint8_t WLAN_P2P_OPT_DEV_TYPE = (13);
dflet 0:400d8e75a8d0 214 const uint8_t WLAN_P2P_OPT_CHANNEL_N_REGS = (14);
dflet 0:400d8e75a8d0 215 const uint8_t WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT = (16);
dflet 0:400d8e75a8d0 216 const uint8_t WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS = (18); /* change the scan channels and RSSI threshold using this configuration option */
dflet 0:400d8e75a8d0 217
dflet 0:400d8e75a8d0 218 /* SmartConfig CIPHER options */
dflet 0:400d8e75a8d0 219 const uint8_t SMART_CONFIG_CIPHER_SFLASH = (0); /* password is not delivered by the application. The Simple Manager should */
dflet 0:400d8e75a8d0 220 /* check if the keys are stored in the Flash. */
dflet 0:400d8e75a8d0 221 const uint8_t SMART_CONFIG_CIPHER_AES = (1); /* AES (other types are not supported) */
dflet 0:400d8e75a8d0 222 const uint8_t SMART_CONFIG_CIPHER_NONE = (0xFF); /* do not check in the flash */
dflet 0:400d8e75a8d0 223
dflet 0:400d8e75a8d0 224
dflet 0:400d8e75a8d0 225 const uint8_t SL_POLICY_CONNECTION = (0x10);
dflet 0:400d8e75a8d0 226 const uint8_t SL_POLICY_SCAN = (0x20);
dflet 0:400d8e75a8d0 227 const uint8_t SL_POLICY_PM = (0x30);
dflet 0:400d8e75a8d0 228 const uint8_t SL_POLICY_P2P = (0x40);
dflet 0:400d8e75a8d0 229
dflet 0:400d8e75a8d0 230 #define VAL_2_MASK(position,value) ((1 & (value))<<(position))
dflet 0:400d8e75a8d0 231 #define MASK_2_VAL(position,mask) (((1 << position) & (mask)) >> (position))
dflet 0:400d8e75a8d0 232
dflet 0:400d8e75a8d0 233 #define SL_CONNECTION_POLICY(Auto,Fast,Open,anyP2P,autoSmartConfig) (VAL_2_MASK(0,Auto) | VAL_2_MASK(1,Fast) | VAL_2_MASK(2,Open) | VAL_2_MASK(3,anyP2P) | VAL_2_MASK(4,autoSmartConfig))
dflet 0:400d8e75a8d0 234 #define SL_SCAN_POLICY_EN(policy) (MASK_2_VAL(0,policy))
dflet 0:400d8e75a8d0 235 #define SL_SCAN_POLICY(Enable) (VAL_2_MASK(0,Enable))
dflet 0:400d8e75a8d0 236
dflet 0:400d8e75a8d0 237
dflet 0:400d8e75a8d0 238 const uint8_t SL_NORMAL_POLICY = (0);
dflet 0:400d8e75a8d0 239 const uint8_t SL_LOW_LATENCY_POLICY = (1);
dflet 0:400d8e75a8d0 240 const uint8_t SL_LOW_POWER_POLICY = (2);
dflet 0:400d8e75a8d0 241 const uint8_t SL_ALWAYS_ON_POLICY = (3);
dflet 0:400d8e75a8d0 242 const uint8_t SL_LONG_SLEEP_INTERVAL_POLICY = (4);
dflet 0:400d8e75a8d0 243
dflet 0:400d8e75a8d0 244 const uint8_t SL_P2P_ROLE_NEGOTIATE = (3);
dflet 0:400d8e75a8d0 245 const uint8_t SL_P2P_ROLE_GROUP_OWNER = (15);
dflet 0:400d8e75a8d0 246 const uint8_t SL_P2P_ROLE_CLIENT = (0);
dflet 0:400d8e75a8d0 247
dflet 0:400d8e75a8d0 248 const uint8_t SL_P2P_NEG_INITIATOR_ACTIVE = (0);
dflet 0:400d8e75a8d0 249 const uint8_t SL_P2P_NEG_INITIATOR_PASSIVE = (1);
dflet 0:400d8e75a8d0 250 const uint8_t SL_P2P_NEG_INITIATOR_RAND_BACKOFF = (2);
dflet 0:400d8e75a8d0 251
dflet 0:400d8e75a8d0 252 #define POLICY_VAL_2_OPTIONS(position,mask,policy) ((mask & policy) << position )
dflet 0:400d8e75a8d0 253
dflet 0:400d8e75a8d0 254 #define SL_P2P_POLICY(p2pNegType,p2pNegInitiator) (POLICY_VAL_2_OPTIONS(0,0xF,(p2pNegType > SL_P2P_ROLE_GROUP_OWNER ? SL_P2P_ROLE_GROUP_OWNER : p2pNegType)) | \
dflet 0:400d8e75a8d0 255 POLICY_VAL_2_OPTIONS(4,0x1,(p2pNegType > SL_P2P_ROLE_GROUP_OWNER ? 1:0)) | \
dflet 0:400d8e75a8d0 256 POLICY_VAL_2_OPTIONS(5,0x3, p2pNegInitiator))
dflet 0:400d8e75a8d0 257
dflet 0:400d8e75a8d0 258
dflet 0:400d8e75a8d0 259 /* Info elements */
dflet 0:400d8e75a8d0 260
dflet 0:400d8e75a8d0 261 const uint8_t INFO_ELEMENT_DEFAULT_ID = (0); /* 221 will be used */
dflet 0:400d8e75a8d0 262
dflet 0:400d8e75a8d0 263 /* info element size is up to 252 bytes (+ 3 bytes of OUI). */
dflet 0:400d8e75a8d0 264 const uint8_t INFO_ELEMENT_MAX_SIZE = (252);
dflet 0:400d8e75a8d0 265
dflet 0:400d8e75a8d0 266 /* For AP - the total length of all info elements is 300 bytes (for example - 4 info elements of 75 bytes each) */
dflet 0:400d8e75a8d0 267 const uint16_t INFO_ELEMENT_MAX_TOTAL_LENGTH_AP = (300);
dflet 0:400d8e75a8d0 268 /* For P2P - the total length of all info elements is 150 bytes (for example - 4 info elements of 40 bytes each) */
dflet 0:400d8e75a8d0 269 const uint8_t INFO_ELEMENT_MAX_TOTAL_LENGTH_P2P_GO (160);
dflet 0:400d8e75a8d0 270
dflet 0:400d8e75a8d0 271 const uint8_t INFO_ELEMENT_AP_ROLE = (0);
dflet 0:400d8e75a8d0 272 const uint8_t INFO_ELEMENT_P2P_GO_ROLE = (1);
dflet 0:400d8e75a8d0 273
dflet 0:400d8e75a8d0 274 /* we support up to 4 info elements per Role. */
dflet 0:400d8e75a8d0 275 const uint8_t MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED = (4);
dflet 0:400d8e75a8d0 276
dflet 0:400d8e75a8d0 277 const uint8_t INFO_ELEMENT_DEFAULT_OUI_0 = (0x08);
dflet 0:400d8e75a8d0 278 const uint8_t INFO_ELEMENT_DEFAULT_OUI_1 = (0x00);
dflet 0:400d8e75a8d0 279 const uint8_t INFO_ELEMENT_DEFAULT_OUI_2 = (0x28);
dflet 0:400d8e75a8d0 280
dflet 0:400d8e75a8d0 281 const uint32_t INFO_ELEMENT_DEFAULT_OUI = (0x000000); /* 08, 00, 28 will be used */
dflet 0:400d8e75a8d0 282
dflet 0:400d8e75a8d0 283
dflet 0:400d8e75a8d0 284 /*****************************************************************************/
dflet 0:400d8e75a8d0 285 /* Structure/Enum declarations */
dflet 0:400d8e75a8d0 286 /*****************************************************************************/
dflet 0:400d8e75a8d0 287
dflet 0:400d8e75a8d0 288 typedef enum {
dflet 0:400d8e75a8d0 289 RATE_1M = 1,
dflet 0:400d8e75a8d0 290 RATE_2M = 2,
dflet 0:400d8e75a8d0 291 RATE_5_5M = 3,
dflet 0:400d8e75a8d0 292 RATE_11M = 4,
dflet 0:400d8e75a8d0 293 RATE_6M = 6,
dflet 0:400d8e75a8d0 294 RATE_9M = 7,
dflet 0:400d8e75a8d0 295 RATE_12M = 8,
dflet 0:400d8e75a8d0 296 RATE_18M = 9,
dflet 0:400d8e75a8d0 297 RATE_24M = 10,
dflet 0:400d8e75a8d0 298 RATE_36M = 11,
dflet 0:400d8e75a8d0 299 RATE_48M = 12,
dflet 0:400d8e75a8d0 300 RATE_54M = 13,
dflet 0:400d8e75a8d0 301 RATE_MCS_0 = 14,
dflet 0:400d8e75a8d0 302 RATE_MCS_1 = 15,
dflet 0:400d8e75a8d0 303 RATE_MCS_2 = 16,
dflet 0:400d8e75a8d0 304 RATE_MCS_3 = 17,
dflet 0:400d8e75a8d0 305 RATE_MCS_4 = 18,
dflet 0:400d8e75a8d0 306 RATE_MCS_5 = 19,
dflet 0:400d8e75a8d0 307 RATE_MCS_6 = 20,
dflet 0:400d8e75a8d0 308 RATE_MCS_7 = 21,
dflet 0:400d8e75a8d0 309 MAX_NUM_RATES = 0xFF
dflet 0:400d8e75a8d0 310 } SlRateIndex_e;
dflet 0:400d8e75a8d0 311
dflet 0:400d8e75a8d0 312 typedef enum {
dflet 0:400d8e75a8d0 313 DEV_PW_DEFAULT=0,
dflet 0:400d8e75a8d0 314 DEV_PW_PIN_KEYPAD=1,
dflet 0:400d8e75a8d0 315 DEV_PW_PUSH_BUTTON=4,
dflet 0:400d8e75a8d0 316 DEV_PW_PIN_DISPLAY=5
dflet 0:400d8e75a8d0 317 } sl_p2p_dev_password_method;
dflet 0:400d8e75a8d0 318
dflet 0:400d8e75a8d0 319
dflet 0:400d8e75a8d0 320 typedef struct {
dflet 0:400d8e75a8d0 321 uint32_t status;
dflet 0:400d8e75a8d0 322 uint32_t ssid_len;
dflet 0:400d8e75a8d0 323 uint8_t ssid[32];
dflet 0:400d8e75a8d0 324 uint32_t private_token_len;
dflet 0:400d8e75a8d0 325 uint8_t private_token[32];
dflet 0:400d8e75a8d0 326 } slSmartConfigStartAsyncResponse_t;
dflet 0:400d8e75a8d0 327
dflet 0:400d8e75a8d0 328 typedef struct {
dflet 0:400d8e75a8d0 329 uint16_t status;
dflet 0:400d8e75a8d0 330 uint16_t padding;
dflet 0:400d8e75a8d0 331 } slSmartConfigStopAsyncResponse_t;
dflet 0:400d8e75a8d0 332
dflet 0:400d8e75a8d0 333 typedef struct {
dflet 0:400d8e75a8d0 334 uint16_t status;
dflet 0:400d8e75a8d0 335 uint16_t padding;
dflet 0:400d8e75a8d0 336 } slWlanConnFailureAsyncResponse_t;
dflet 0:400d8e75a8d0 337
dflet 0:400d8e75a8d0 338 typedef struct {
dflet 0:400d8e75a8d0 339 uint8_t connection_type;/* 0-STA,3-P2P_CL */
dflet 0:400d8e75a8d0 340 uint8_t ssid_len;
dflet 0:400d8e75a8d0 341 uint8_t ssid_name[32];
dflet 0:400d8e75a8d0 342 uint8_t go_peer_device_name_len;
dflet 0:400d8e75a8d0 343 uint8_t go_peer_device_name[32];
dflet 0:400d8e75a8d0 344 uint8_t bssid[6];
dflet 0:400d8e75a8d0 345 uint8_t reason_code;
dflet 0:400d8e75a8d0 346 uint8_t padding[2];
dflet 0:400d8e75a8d0 347 } slWlanConnectAsyncResponse_t;
dflet 0:400d8e75a8d0 348
dflet 0:400d8e75a8d0 349 typedef struct {
dflet 0:400d8e75a8d0 350 uint8_t go_peer_device_name[32];
dflet 0:400d8e75a8d0 351 uint8_t mac[6];
dflet 0:400d8e75a8d0 352 uint8_t go_peer_device_name_len;
dflet 0:400d8e75a8d0 353 uint8_t wps_dev_password_id;
dflet 0:400d8e75a8d0 354 uint8_t own_ssid[32];/* relevant for event sta-connected only */
dflet 0:400d8e75a8d0 355 uint8_t own_ssid_len;/* relevant for event sta-connected only */
dflet 0:400d8e75a8d0 356 uint8_t padding[3];
dflet 0:400d8e75a8d0 357 } slPeerInfoAsyncResponse_t;
dflet 0:400d8e75a8d0 358
dflet 0:400d8e75a8d0 359
dflet 0:400d8e75a8d0 360 typedef union {
dflet 0:400d8e75a8d0 361 slSmartConfigStartAsyncResponse_t smartConfigStartResponse; /*SL_WLAN_SMART_CONFIG_COMPLETE_EVENT*/
dflet 0:400d8e75a8d0 362 slSmartConfigStopAsyncResponse_t smartConfigStopResponse; /*SL_WLAN_SMART_CONFIG_STOP_EVENT */
dflet 0:400d8e75a8d0 363 slPeerInfoAsyncResponse_t APModeStaConnected; /* SL_WLAN_STA_CONNECTED_EVENT - relevant only in AP mode - holds information regarding a new STA connection */
dflet 0:400d8e75a8d0 364 slPeerInfoAsyncResponse_t APModestaDisconnected; /* SL_WLAN_STA_DISCONNECTED_EVENT - relevant only in AP mode - holds information regarding a STA disconnection */
dflet 0:400d8e75a8d0 365 slWlanConnectAsyncResponse_t STAandP2PModeWlanConnected; /* SL_WLAN_CONNECT_EVENT - relevant only in STA and P2P mode - holds information regarding a new connection */
dflet 0:400d8e75a8d0 366 slWlanConnectAsyncResponse_t STAandP2PModeDisconnected; /* SL_WLAN_DISCONNECT_EVENT - relevant only in STA and P2P mode - holds information regarding a disconnection */
dflet 0:400d8e75a8d0 367 slPeerInfoAsyncResponse_t P2PModeDevFound; /* SL_WLAN_P2P_DEV_FOUND_EVENT - relevant only in P2P mode */
dflet 0:400d8e75a8d0 368 slPeerInfoAsyncResponse_t P2PModeNegReqReceived; /* SL_WLAN_P2P_NEG_REQ_RECEIVED_EVENT - relevant only in P2P mode */
dflet 0:400d8e75a8d0 369 slWlanConnFailureAsyncResponse_t P2PModewlanConnectionFailure; /* SL_WLAN_CONNECTION_FAILED_EVENT - relevant only in P2P mode */
dflet 0:400d8e75a8d0 370
dflet 0:400d8e75a8d0 371 } SlWlanEventData_u;
dflet 0:400d8e75a8d0 372
dflet 0:400d8e75a8d0 373 typedef struct {
dflet 0:400d8e75a8d0 374 uint32_t Event;
dflet 0:400d8e75a8d0 375 SlWlanEventData_u EventData;
dflet 0:400d8e75a8d0 376 } SlWlanEvent_t;
dflet 0:400d8e75a8d0 377
dflet 0:400d8e75a8d0 378
dflet 0:400d8e75a8d0 379 typedef struct {
dflet 0:400d8e75a8d0 380 uint32_t ReceivedValidPacketsNumber; /* sum of the packets that been received OK (include filtered) */
dflet 0:400d8e75a8d0 381 uint32_t ReceivedFcsErrorPacketsNumber; /* sum of the packets that been dropped due to FCS error */
dflet 0:400d8e75a8d0 382 uint32_t ReceivedAddressMismatchPacketsNumber; /* sum of the packets that been received but filtered out by one of the HW filters */
dflet 0:400d8e75a8d0 383 int16_t AvarageDataCtrlRssi; /* average RSSI for all valid data packets received */
dflet 0:400d8e75a8d0 384 int16_t AvarageMgMntRssi; /* average RSSI for all valid management packets received */
dflet 0:400d8e75a8d0 385 uint16_t RateHistogram[NUM_OF_RATE_INDEXES]; /* rate histogram for all valid packets received */
dflet 0:400d8e75a8d0 386 uint16_t RssiHistogram[SIZE_OF_RSSI_HISTOGRAM]; /* RSSI histogram from -40 until -87 (all below and above\n RSSI will appear in the first and last cells */
dflet 0:400d8e75a8d0 387 uint32_t StartTimeStamp; /* the time stamp started collecting the statistics in uSec */
dflet 0:400d8e75a8d0 388 uint32_t GetTimeStamp; /* the time stamp called the get statistics command */
dflet 0:400d8e75a8d0 389 } SlGetRxStatResponse_t;
dflet 0:400d8e75a8d0 390
dflet 0:400d8e75a8d0 391
dflet 0:400d8e75a8d0 392 typedef struct {
dflet 0:400d8e75a8d0 393 uint8_t ssid[MAXIMAL_SSID_LENGTH];
dflet 0:400d8e75a8d0 394 uint8_t ssid_len;
dflet 0:400d8e75a8d0 395 uint8_t sec_type;
dflet 0:400d8e75a8d0 396 uint8_t bssid[SL_BSSID_LENGTH];
dflet 0:400d8e75a8d0 397 int8_t rssi;
dflet 0:400d8e75a8d0 398 int8_t reserved[3];
dflet 0:400d8e75a8d0 399 } Sl_WlanNetworkEntry_t;
dflet 0:400d8e75a8d0 400
dflet 0:400d8e75a8d0 401
dflet 0:400d8e75a8d0 402 typedef struct {
dflet 0:400d8e75a8d0 403 uint8_t Type;
dflet 0:400d8e75a8d0 404 int8_t* Key;
dflet 0:400d8e75a8d0 405 uint8_t KeyLen;
dflet 0:400d8e75a8d0 406 } SlSecParams_t;
dflet 0:400d8e75a8d0 407
dflet 0:400d8e75a8d0 408 typedef struct {
dflet 0:400d8e75a8d0 409 int8_t* User;
dflet 0:400d8e75a8d0 410 uint8_t UserLen;
dflet 0:400d8e75a8d0 411 int8_t* AnonUser;
dflet 0:400d8e75a8d0 412 uint8_t AnonUserLen;
dflet 0:400d8e75a8d0 413 uint8_t CertIndex; /* not supported */
dflet 0:400d8e75a8d0 414 uint32_t EapMethod;
dflet 0:400d8e75a8d0 415 } SlSecParamsExt_t;
dflet 0:400d8e75a8d0 416
dflet 0:400d8e75a8d0 417 typedef struct {
dflet 0:400d8e75a8d0 418 int8_t User[32];
dflet 0:400d8e75a8d0 419 uint8_t UserLen;
dflet 0:400d8e75a8d0 420 int8_t AnonUser[32];
dflet 0:400d8e75a8d0 421 uint8_t AnonUserLen;
dflet 0:400d8e75a8d0 422 uint8_t CertIndex; //not supported
dflet 0:400d8e75a8d0 423 uint32_t EapMethod;
dflet 0:400d8e75a8d0 424 } SlGetSecParamsExt_t;
dflet 0:400d8e75a8d0 425
dflet 0:400d8e75a8d0 426 typedef enum {
dflet 0:400d8e75a8d0 427 ROLE_STA = 0,
dflet 0:400d8e75a8d0 428 ROLE_AP = 2,
dflet 0:400d8e75a8d0 429 ROLE_P2P = 3,
dflet 0:400d8e75a8d0 430 ROLE_STA_ERR = -1, /* Failure to load MAC/PHY in STA role */
dflet 0:400d8e75a8d0 431 ROLE_AP_ERR = -ROLE_AP, /* Failure to load MAC/PHY in AP role */
dflet 0:400d8e75a8d0 432 ROLE_P2P_ERR = -ROLE_P2P /* Failure to load MAC/PHY in P2P role */
dflet 0:400d8e75a8d0 433 } SlWlanMode_t;
dflet 0:400d8e75a8d0 434
dflet 0:400d8e75a8d0 435 typedef struct {
dflet 0:400d8e75a8d0 436 uint32_t G_Channels_mask;
dflet 0:400d8e75a8d0 437 int32_t rssiThershold;
dflet 0:400d8e75a8d0 438 } slWlanScanParamCommand_t;
dflet 0:400d8e75a8d0 439
dflet 0:400d8e75a8d0 440
dflet 0:400d8e75a8d0 441 typedef struct {
dflet 0:400d8e75a8d0 442 uint8_t id;
dflet 0:400d8e75a8d0 443 uint8_t oui[3];
dflet 0:400d8e75a8d0 444 uint16_t length;
dflet 0:400d8e75a8d0 445 uint8_t data[252];
dflet 0:400d8e75a8d0 446 } sl_protocol_InfoElement_t;
dflet 0:400d8e75a8d0 447
dflet 0:400d8e75a8d0 448 typedef struct {
dflet 0:400d8e75a8d0 449 uint8_t index; /* 0 - MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED */
dflet 0:400d8e75a8d0 450 uint8_t role; /* bit0: AP = 0, GO = 1 */
dflet 0:400d8e75a8d0 451 sl_protocol_InfoElement_t ie;
dflet 0:400d8e75a8d0 452 } sl_protocol_WlanSetInfoElement_t;
dflet 0:400d8e75a8d0 453
dflet 0:400d8e75a8d0 454
dflet 0:400d8e75a8d0 455 class cc3100_wlan_rx_filters;
dflet 0:400d8e75a8d0 456 class cc3100_wlan
dflet 0:400d8e75a8d0 457 {
dflet 0:400d8e75a8d0 458
dflet 0:400d8e75a8d0 459 public:
dflet 0:400d8e75a8d0 460
dflet 0:400d8e75a8d0 461 cc3100_wlan(cc3100_driver &driver, cc3100_wlan_rx_filters &wlan_rx_filters);
dflet 0:400d8e75a8d0 462
dflet 0:400d8e75a8d0 463 ~cc3100_wlan();
dflet 0:400d8e75a8d0 464
dflet 0:400d8e75a8d0 465
dflet 0:400d8e75a8d0 466 /*****************************************************************************/
dflet 0:400d8e75a8d0 467 /* Function prototypes */
dflet 0:400d8e75a8d0 468 /*****************************************************************************/
dflet 0:400d8e75a8d0 469
dflet 0:400d8e75a8d0 470
dflet 0:400d8e75a8d0 471 /*!
dflet 0:400d8e75a8d0 472 \brief Connect to wlan network as a station
dflet 0:400d8e75a8d0 473
dflet 0:400d8e75a8d0 474 \param[in] pName up to 32 bytes in case of STA the name is the SSID of the Access Point
dflet 0:400d8e75a8d0 475 \param[in] NameLen name length
dflet 0:400d8e75a8d0 476 \param[in] pMacAddr 6 bytes for MAC address
dflet 0:400d8e75a8d0 477 \param[in] pSecParams Security parameters (use NULL key for SL_SEC_TYPE_OPEN)
dflet 0:400d8e75a8d0 478 Security types options: \n
dflet 0:400d8e75a8d0 479 - SL_SEC_TYPE_OPEN
dflet 0:400d8e75a8d0 480 - SL_SEC_TYPE_WEP
dflet 0:400d8e75a8d0 481 - SL_SEC_TYPE_WPA_WPA2
dflet 0:400d8e75a8d0 482 - SL_SEC_TYPE_WPA_ENT
dflet 0:400d8e75a8d0 483 - SL_SEC_TYPE_WPS_PBC
dflet 0:400d8e75a8d0 484 - SL_SEC_TYPE_WPS_PIN
dflet 0:400d8e75a8d0 485 \param[in] pSecExtParams Enterprise parameters (set NULL in case Enterprise parameters is not in use)
dflet 0:400d8e75a8d0 486
dflet 0:400d8e75a8d0 487 \return On success, zero is returned. On error, negative is returned
dflet 0:400d8e75a8d0 488 In case error number (-71) is returned, it indicates a connection was activated while the device it running in AP role
dflet 0:400d8e75a8d0 489
dflet 0:400d8e75a8d0 490 \sa sl_WlanDisconnect
dflet 0:400d8e75a8d0 491 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 492 \warning In this version only single enterprise mode could be used
dflet 0:400d8e75a8d0 493 SL_SEC_TYPE_WPA is a deprecated definition, the new definition is SL_SEC_TYPE_WPA_WPA2
dflet 0:400d8e75a8d0 494 */
dflet 0:400d8e75a8d0 495 #if _SL_INCLUDE_FUNC(sl_WlanConnect)
dflet 0:400d8e75a8d0 496 int16_t sl_WlanConnect(const signed char* pName, const int16_t NameLen, const uint8_t *pMacAddr, const SlSecParams_t* pSecParams, const SlSecParamsExt_t* pSecExtParams);
dflet 0:400d8e75a8d0 497 #endif
dflet 0:400d8e75a8d0 498
dflet 0:400d8e75a8d0 499 /*!
dflet 0:400d8e75a8d0 500 \brief wlan disconnect
dflet 0:400d8e75a8d0 501
dflet 0:400d8e75a8d0 502 Disconnect connection
dflet 0:400d8e75a8d0 503
dflet 0:400d8e75a8d0 504 \return 0 disconnected done, other already disconnected
dflet 0:400d8e75a8d0 505
dflet 0:400d8e75a8d0 506 \sa sl_WlanConnect
dflet 0:400d8e75a8d0 507 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 508 \warning
dflet 0:400d8e75a8d0 509 */
dflet 0:400d8e75a8d0 510 #if _SL_INCLUDE_FUNC(sl_WlanDisconnect)
dflet 0:400d8e75a8d0 511 int16_t sl_WlanDisconnect(void);
dflet 0:400d8e75a8d0 512 #endif
dflet 0:400d8e75a8d0 513
dflet 0:400d8e75a8d0 514 /*!
dflet 0:400d8e75a8d0 515 \brief add profile
dflet 0:400d8e75a8d0 516
dflet 0:400d8e75a8d0 517 When auto start is enabled, the device connects to a
dflet 0:400d8e75a8d0 518 station from the profiles table. Up to 7 profiles are
dflet 0:400d8e75a8d0 519 supported. If several profiles configured the device chose
dflet 0:400d8e75a8d0 520 the highest priority profile, within each priority group,
dflet 0:400d8e75a8d0 521 device will chose profile based on security policy, signal
dflet 0:400d8e75a8d0 522 strength, etc parameters.
dflet 0:400d8e75a8d0 523
dflet 0:400d8e75a8d0 524
dflet 0:400d8e75a8d0 525 \param[in] pName up to 32 bytes in case of STA the name is the
dflet 0:400d8e75a8d0 526 SSID of the Access Point
dflet 0:400d8e75a8d0 527 in case of P2P the name is the remote device name
dflet 0:400d8e75a8d0 528 \param[in] NameLen name length
dflet 0:400d8e75a8d0 529 \param[in] pMacAddr 6 bytes for MAC address
dflet 0:400d8e75a8d0 530 \param[in] pSecParams Security parameters - security type
dflet 0:400d8e75a8d0 531 (SL_SEC_TYPE_OPEN,SL_SEC_TYPE_WEP,SL_SEC_TYPE_WPA_WPA2,
dflet 0:400d8e75a8d0 532 SL_SEC_TYPE_P2P_PBC,SL_SEC_TYPE_P2P_PIN_KEYPAD,SL_SEC_TYPE_P2P_PIN_DISPLAY, SL_SEC_TYPE_WPA_ENT), key, and key length
dflet 0:400d8e75a8d0 533 in case of p2p security type pin the key refers to pin code
dflet 0:400d8e75a8d0 534 \param[in] pSecExtParams Enterprise parameters - identity, identity length,
dflet 0:400d8e75a8d0 535 Anonymous, Anonymous length, CertIndex (not supported,
dflet 0:400d8e75a8d0 536 certificates need to be placed in a specific file ID),
dflet 0:400d8e75a8d0 537 EapMethod.Use NULL in case Enterprise parameters is not in use
dflet 0:400d8e75a8d0 538
dflet 0:400d8e75a8d0 539 \param[in] Priority profile priority. Lowest priority: 0
dflet 0:400d8e75a8d0 540 \param[in] Options Not supported
dflet 0:400d8e75a8d0 541
dflet 0:400d8e75a8d0 542 \return On success, profile stored index is returned. On error, negative value is returned
dflet 0:400d8e75a8d0 543
dflet 0:400d8e75a8d0 544 \sa sl_WlanProfileGet , sl_WlanProfileDel
dflet 0:400d8e75a8d0 545 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 546 \warning Only one Enterprise profile is supported.
dflet 0:400d8e75a8d0 547 Please Note that in case of adding an existing profile (compared by pName,pMACAddr and security type)
dflet 0:400d8e75a8d0 548 the old profile will be deleted and the same index will be returned.
dflet 0:400d8e75a8d0 549 SL_SEC_TYPE_WPA is a deprecated definition, the new definition is SL_SEC_TYPE_WPA_WPA2
dflet 0:400d8e75a8d0 550
dflet 0:400d8e75a8d0 551 */
dflet 0:400d8e75a8d0 552 #if _SL_INCLUDE_FUNC(sl_WlanProfileAdd)
dflet 0:400d8e75a8d0 553 int16_t sl_WlanProfileAdd(const int8_t* pName,
dflet 0:400d8e75a8d0 554 const int16_t NameLen,
dflet 0:400d8e75a8d0 555 const uint8_t *pMacAddr,
dflet 0:400d8e75a8d0 556 const SlSecParams_t* pSecParams ,
dflet 0:400d8e75a8d0 557 const SlSecParamsExt_t* pSecExtParams,
dflet 0:400d8e75a8d0 558 const uint32_t Priority,
dflet 0:400d8e75a8d0 559 const uint32_t Options);
dflet 0:400d8e75a8d0 560 #endif
dflet 0:400d8e75a8d0 561
dflet 0:400d8e75a8d0 562 /*!
dflet 0:400d8e75a8d0 563 \brief get profile
dflet 0:400d8e75a8d0 564
dflet 0:400d8e75a8d0 565 read profile from the device
dflet 0:400d8e75a8d0 566
dflet 0:400d8e75a8d0 567 \param[in] Index profile stored index, if index does not exists
dflet 0:400d8e75a8d0 568 error is return
dflet 0:400d8e75a8d0 569 \param[out] pName up to 32 bytes, in case of sta mode the name of the Access Point
dflet 0:400d8e75a8d0 570 in case of p2p mode the name of the Remote Device
dflet 0:400d8e75a8d0 571 \param[out] pNameLen name length
dflet 0:400d8e75a8d0 572 \param[out] pMacAddr 6 bytes for MAC address
dflet 0:400d8e75a8d0 573 \param[out] pSecParams security parameters - security type
dflet 0:400d8e75a8d0 574 (SL_SEC_TYPE_OPEN, SL_SEC_TYPE_WEP, SL_SEC_TYPE_WPA_WPA2 or
dflet 0:400d8e75a8d0 575 SL_SEC_TYPE_WPS_PBC, SL_SEC_TYPE_WPS_PIN, SL_SEC_TYPE_WPA_ENT,SL_SEC_TYPE_P2P_PBC,SL_SEC_TYPE_P2P_PIN_KEYPAD or SL_SEC_TYPE_P2P_PIN_DISPLAY),
dflet 0:400d8e75a8d0 576 key and key length are not
dflet 0:400d8e75a8d0 577 in case of p2p security type pin the key refers to pin code
dflet 0:400d8e75a8d0 578 return due to security reasons.
dflet 0:400d8e75a8d0 579 \param[out] pSecExtParams enterprise parameters - identity, identity
dflet 0:400d8e75a8d0 580 length, Anonymous, Anonymous length
dflet 0:400d8e75a8d0 581 CertIndex (not supported), EapMethod.
dflet 0:400d8e75a8d0 582 \param[out] Priority profile priority
dflet 0:400d8e75a8d0 583
dflet 0:400d8e75a8d0 584 \return On success, Profile security type is returned (0 or positive number). On error, -1 is
dflet 0:400d8e75a8d0 585 returned
dflet 0:400d8e75a8d0 586
dflet 0:400d8e75a8d0 587 \sa sl_WlanProfileAdd , sl_WlanProfileDel
dflet 0:400d8e75a8d0 588 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 589 \warning
dflet 0:400d8e75a8d0 590 */
dflet 0:400d8e75a8d0 591 #if _SL_INCLUDE_FUNC(sl_WlanProfileGet)
dflet 0:400d8e75a8d0 592 int16_t sl_WlanProfileGet(const int16_t Index,int8_t* pName, int16_t *pNameLen, uint8_t *pMacAddr, SlSecParams_t* pSecParams, SlGetSecParamsExt_t* pSecExtParams, uint32_t *pPriority);
dflet 0:400d8e75a8d0 593 #endif
dflet 0:400d8e75a8d0 594
dflet 0:400d8e75a8d0 595 /*!
dflet 0:400d8e75a8d0 596 \brief Delete WLAN profile
dflet 0:400d8e75a8d0 597
dflet 0:400d8e75a8d0 598 Delete WLAN profile
dflet 0:400d8e75a8d0 599
dflet 0:400d8e75a8d0 600 \param[in] index number of profile to delete.Possible values are 0 to 6.
dflet 0:400d8e75a8d0 601 Index value 255 will delete all saved profiles
dflet 0:400d8e75a8d0 602
dflet 0:400d8e75a8d0 603 \return On success, zero is returned. On error, -1 is
dflet 0:400d8e75a8d0 604 returned
dflet 0:400d8e75a8d0 605
dflet 0:400d8e75a8d0 606 \sa sl_WlanProfileAdd , sl_WlanProfileGet
dflet 0:400d8e75a8d0 607 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 608 \warning
dflet 0:400d8e75a8d0 609 */
dflet 0:400d8e75a8d0 610 #if _SL_INCLUDE_FUNC(sl_WlanProfileDel)
dflet 0:400d8e75a8d0 611 int16_t sl_WlanProfileDel(const int16_t Index);
dflet 0:400d8e75a8d0 612 #endif
dflet 0:400d8e75a8d0 613
dflet 0:400d8e75a8d0 614 /*!
dflet 0:400d8e75a8d0 615 \brief Set policy values
dflet 0:400d8e75a8d0 616
dflet 0:400d8e75a8d0 617 \param[in] Type Type of policy to be modified. The Options are:\n
dflet 0:400d8e75a8d0 618 - SL_POLICY_CONNECTION
dflet 0:400d8e75a8d0 619 - SL_POLICY_SCAN
dflet 0:400d8e75a8d0 620 - SL_POLICY_PM
dflet 0:400d8e75a8d0 621 - SL_POLICY_P2P
dflet 0:400d8e75a8d0 622 \param[in] Policy The option value which depends on action type
dflet 0:400d8e75a8d0 623 \param[in] pVal An optional value pointer
dflet 0:400d8e75a8d0 624 \param[in] ValLen An optional value length, in bytes
dflet 0:400d8e75a8d0 625 \return On success, zero is returned. On error, -1 is
dflet 0:400d8e75a8d0 626 returned
dflet 0:400d8e75a8d0 627 \sa sl_WlanPolicyGet
dflet 0:400d8e75a8d0 628 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 629 \warning
dflet 0:400d8e75a8d0 630 \par
dflet 0:400d8e75a8d0 631 SL_POLICY_CONNECTION type defines three options available to connect the CC31xx device to the AP: \n
dflet 0:400d8e75a8d0 632
dflet 0:400d8e75a8d0 633 - If Auto Connect is set, the CC31xx device tries to automatically reconnect to one of its stored profiles, each time the connection fails or the device is rebooted.\n
dflet 0:400d8e75a8d0 634 To set this option, use: \n
dflet 0:400d8e75a8d0 635 <b> sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(1,0,0,0,0),NULL,0) </b>
dflet 0:400d8e75a8d0 636 - If Fast Connect is set, the CC31xx device tries to establish a fast connection to AP. \n
dflet 0:400d8e75a8d0 637 To set this option, use: \n
dflet 0:400d8e75a8d0 638 <b> sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,1,0,0,0),NULL,0) </b>
dflet 0:400d8e75a8d0 639 - (relevant for P2P mode only) - If Any P2P is set, CC31xx/CC32xx device tries to automatically connect to the first P2P device available, \n
dflet 0:400d8e75a8d0 640 supporting push button only. To set this option, use: \n
dflet 0:400d8e75a8d0 641 <b> sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,0,0,1,0),NULL,0) </b>
dflet 0:400d8e75a8d0 642 - For auto smart config upon restart (any command from Host will end this state) use: \n
dflet 0:400d8e75a8d0 643 <b> sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,0,0,0,1),NULL,0) </b> \n
dflet 0:400d8e75a8d0 644 The options above could be combined to a single action, if more than one action is required. \n
dflet 0:400d8e75a8d0 645 \par
dflet 0:400d8e75a8d0 646 SL_POLICY_SCAN defines system scan time interval.Default interval is 10 minutes. \n
dflet 0:400d8e75a8d0 647 After settings scan interval, an immediate scan is activated. The next scan will be based on the interval settings. \n
dflet 0:400d8e75a8d0 648 - For example, setting scan interval to 1 minute interval use: \n
dflet 0:400d8e75a8d0 649 uint32_t intervalInSeconds = 60; \n
dflet 0:400d8e75a8d0 650 #define SL_SCAN_ENABLE 1 \n<b>
dflet 0:400d8e75a8d0 651 sl_WlanPolicySet(SL_POLICY_SCAN,SL_SCAN_ENABLE, (uint8_t *)&intervalInSeconds,sizeof(intervalInSeconds)); </b>\n
dflet 0:400d8e75a8d0 652
dflet 0:400d8e75a8d0 653 - For example, disable scan: \n
dflet 0:400d8e75a8d0 654 #define SL_SCAN_DISABLE 0 \n<b>
dflet 0:400d8e75a8d0 655 sl_WlanPolicySet(SL_POLICY_SCAN,SL_SCAN_DISABLE,0,0); </b>\n
dflet 0:400d8e75a8d0 656 \par
dflet 0:400d8e75a8d0 657 SL_POLICY_PM defines a power management policy for Station mode only:
dflet 0:400d8e75a8d0 658 - For setting normal power management (default) policy use: <b> sl_WlanPolicySet(SL_POLICY_PM , SL_NORMAL_POLICY, NULL,0) </b>
dflet 0:400d8e75a8d0 659 - For setting low latency power management policy use: <b> sl_WlanPolicySet(SL_POLICY_PM , SL_LOW_LATENCY_POLICY, NULL,0) </b>
dflet 0:400d8e75a8d0 660 - For setting low power management policy use: <b> sl_WlanPolicySet(SL_POLICY_PM , SL_LOW_POWER_POLICY, NULL,0) </b>
dflet 0:400d8e75a8d0 661 - For setting always on power management policy use: <b> sl_WlanPolicySet(SL_POLICY_PM , SL_ALWAYS_ON_POLICY, NULL,0) </b>
dflet 0:400d8e75a8d0 662 - For setting Long Sleep Interval policy use: \n
dflet 0:400d8e75a8d0 663 uint16_t PolicyBuff[4] = {0,0,800,0}; // PolicyBuff[2] is max sleep time in mSec \n<b>
dflet 0:400d8e75a8d0 664 sl_WlanPolicySet(SL_POLICY_PM , SL_LONG_SLEEP_INTERVAL_POLICY, (uint8_t*)PolicyBuff,sizeof(PolicyBuff)); </b>\n
dflet 0:400d8e75a8d0 665
dflet 0:400d8e75a8d0 666 SL_POLICY_P2P defines p2p negotiation policy parameters for P2P role:
dflet 0:400d8e75a8d0 667 - To set intent negotiation value, set on of the following:
dflet 0:400d8e75a8d0 668 SL_P2P_ROLE_NEGOTIATE - intent 3
dflet 0:400d8e75a8d0 669 SL_P2P_ROLE_GROUP_OWNER - intent 15
dflet 0:400d8e75a8d0 670 SL_P2P_ROLE_CLIENT - intent 0
dflet 0:400d8e75a8d0 671 - To set negotiation initiator value (initiator policy of first negotiation action frame), set on of the following:
dflet 0:400d8e75a8d0 672 SL_P2P_NEG_INITIATOR_ACTIVE
dflet 0:400d8e75a8d0 673 SL_P2P_NEG_INITIATOR_PASSIVE
dflet 0:400d8e75a8d0 674 SL_P2P_NEG_INITIATOR_RAND_BACKOFF
dflet 0:400d8e75a8d0 675 For example: \n
dflet 0:400d8e75a8d0 676 <b>sl_WlanPolicySet(SL_POLICY_P2P, SL_P2P_POLICY(SL_P2P_ROLE_NEGOTIATE,SL_P2P_NEG_INITIATOR_RAND_BACKOFF),NULL,0) </b>
dflet 0:400d8e75a8d0 677
dflet 0:400d8e75a8d0 678 */
dflet 0:400d8e75a8d0 679 #if _SL_INCLUDE_FUNC(sl_WlanPolicySet)
dflet 0:400d8e75a8d0 680 int16_t sl_WlanPolicySet(const uint8_t Type , const uint8_t Policy, uint8_t *pVal,const uint8_t ValLen);
dflet 0:400d8e75a8d0 681 #endif
dflet 0:400d8e75a8d0 682 /*!
dflet 0:400d8e75a8d0 683 \brief get policy values
dflet 0:400d8e75a8d0 684
dflet 0:400d8e75a8d0 685 \param[in] Type SL_POLICY_CONNECTION, SL_POLICY_SCAN, SL_POLICY_PM,SL_POLICY_P2P \n
dflet 0:400d8e75a8d0 686
dflet 0:400d8e75a8d0 687 \param[in] Policy argument may be set to any value \n
dflet 0:400d8e75a8d0 688
dflet 0:400d8e75a8d0 689 \param[out] The returned values, depends on each policy type, will be stored in the allocated buffer pointed by pVal
dflet 0:400d8e75a8d0 690 with a maximum buffer length set by the calling function and pointed to by argument *pValLen
dflet 0:400d8e75a8d0 691
dflet 0:400d8e75a8d0 692 \return On success, zero is returned. On error, -1 is returned
dflet 0:400d8e75a8d0 693
dflet 0:400d8e75a8d0 694 \sa sl_WlanPolicySet
dflet 0:400d8e75a8d0 695
dflet 0:400d8e75a8d0 696 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 697
dflet 0:400d8e75a8d0 698 \warning The value pointed by the argument *pValLen should be set to a value different from 0 and
dflet 0:400d8e75a8d0 699 greater than the buffer length returned from the SL device. Otherwise, an error will be returned.
dflet 0:400d8e75a8d0 700
dflet 0:400d8e75a8d0 701 */
dflet 0:400d8e75a8d0 702 #if _SL_INCLUDE_FUNC(sl_WlanPolicyGet)
dflet 0:400d8e75a8d0 703 int16_t sl_WlanPolicyGet(const uint8_t Type , uint8_t Policy,uint8_t *pVal,uint8_t *pValLen);
dflet 0:400d8e75a8d0 704 #endif
dflet 0:400d8e75a8d0 705 /*!
dflet 0:400d8e75a8d0 706 \brief Gets the WLAN scan operation results
dflet 0:400d8e75a8d0 707
dflet 0:400d8e75a8d0 708 Gets scan results , gets entry from scan result table
dflet 0:400d8e75a8d0 709
dflet 0:400d8e75a8d0 710 \param[in] Index - Starting index identifier (range 0-19) for getting scan results
dflet 0:400d8e75a8d0 711 \param[in] Count - How many entries to fetch. Max is (20-"Index").
dflet 0:400d8e75a8d0 712 \param[out] pEntries - pointer to an allocated Sl_WlanNetworkEntry_t.
dflet 0:400d8e75a8d0 713 the number of array items should match "Count"
dflet 0:400d8e75a8d0 714 sec_type: SL_SCAN_SEC_TYPE_OPEN, SL_SCAN_SEC_TYPE_WEP, SL_SCAN_SEC_TYPE_WPA or SL_SCAN_SEC_TYPE_WPA2
dflet 0:400d8e75a8d0 715
dflet 0:400d8e75a8d0 716
dflet 0:400d8e75a8d0 717 \return Number of valid networks list items
dflet 0:400d8e75a8d0 718
dflet 0:400d8e75a8d0 719 \sa
dflet 0:400d8e75a8d0 720 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 721 \warning This command do not initiate any active scanning action
dflet 0:400d8e75a8d0 722 \par Example:
dflet 0:400d8e75a8d0 723 \code An example of fetching max 10 results:
dflet 0:400d8e75a8d0 724
dflet 0:400d8e75a8d0 725 Sl_WlanNetworkEntry_t netEntries[10];
dflet 0:400d8e75a8d0 726 int16_t resultsCount = sl_WlanGetNetworkList(0,10,&netEntries[0]);
dflet 0:400d8e75a8d0 727 for(i=0; i< resultsCount; i++)
dflet 0:400d8e75a8d0 728 {
dflet 0:400d8e75a8d0 729 printf("%s\n",netEntries[i].ssid);
dflet 0:400d8e75a8d0 730 }
dflet 0:400d8e75a8d0 731 \endcode
dflet 0:400d8e75a8d0 732 */
dflet 0:400d8e75a8d0 733 #if _SL_INCLUDE_FUNC(sl_WlanGetNetworkList)
dflet 0:400d8e75a8d0 734 int16_t sl_WlanGetNetworkList(const uint8_t Index, const uint8_t Count, Sl_WlanNetworkEntry_t *pEntries);
dflet 0:400d8e75a8d0 735 #endif
dflet 0:400d8e75a8d0 736
dflet 0:400d8e75a8d0 737 /*!
dflet 0:400d8e75a8d0 738 \brief Start collecting wlan RX statistics, for unlimited time.
dflet 0:400d8e75a8d0 739
dflet 0:400d8e75a8d0 740 \return On success, zero is returned. On error, -1 is returned
dflet 0:400d8e75a8d0 741
dflet 0:400d8e75a8d0 742 \sa sl_WlanRxStatStop sl_WlanRxStatGet
dflet 0:400d8e75a8d0 743 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 744 \warning
dflet 0:400d8e75a8d0 745 \par Example:
dflet 0:400d8e75a8d0 746 \code Getting wlan RX statistics:
dflet 0:400d8e75a8d0 747
dflet 0:400d8e75a8d0 748 void RxStatCollectTwice()
dflet 0:400d8e75a8d0 749 {
dflet 0:400d8e75a8d0 750 SlGetRxStatResponse_t rxStat;
dflet 0:400d8e75a8d0 751 int16_t rawSocket;
dflet 0:400d8e75a8d0 752 int8_t DataFrame[200];
dflet 0:400d8e75a8d0 753 struct SlTimeval_t timeval;
dflet 0:400d8e75a8d0 754 timeval.tv_sec = 0; // Seconds
dflet 0:400d8e75a8d0 755 timeval.tv_usec = 20000; // Microseconds. 10000 microseconds resolution
dflet 0:400d8e75a8d0 756
dflet 0:400d8e75a8d0 757 sl_WlanRxStatStart(); // set statistics mode
dflet 0:400d8e75a8d0 758
dflet 0:400d8e75a8d0 759 rawSocket = sl_Socket(SL_AF_RF, SL_SOCK_RAW, eChannel);
dflet 0:400d8e75a8d0 760 // set timeout - in case we have no activity for the specified channel
dflet 0:400d8e75a8d0 761 sl_SetSockOpt(rawSocket,SL_SOL_SOCKET,SL_SO_RCVTIMEO, &timeval, sizeof(timeval)); // Enable receive timeout
dflet 0:400d8e75a8d0 762 status = sl_Recv(rawSocket, DataFrame, sizeof(DataFrame), 0);
dflet 0:400d8e75a8d0 763
dflet 0:400d8e75a8d0 764 Sleep(1000); // sleep for 1 sec
dflet 0:400d8e75a8d0 765 sl_WlanRxStatGet(&rxStat,0); // statistics has been cleared upon read
dflet 0:400d8e75a8d0 766 Sleep(1000); // sleep for 1 sec
dflet 0:400d8e75a8d0 767 sl_WlanRxStatGet(&rxStat,0);
dflet 0:400d8e75a8d0 768
dflet 0:400d8e75a8d0 769 }
dflet 0:400d8e75a8d0 770 \endcode
dflet 0:400d8e75a8d0 771 */
dflet 0:400d8e75a8d0 772 #if _SL_INCLUDE_FUNC(sl_WlanRxStatStart)
dflet 0:400d8e75a8d0 773 int16_t sl_WlanRxStatStart(void);
dflet 0:400d8e75a8d0 774 #endif
dflet 0:400d8e75a8d0 775
dflet 0:400d8e75a8d0 776
dflet 0:400d8e75a8d0 777 /*!
dflet 0:400d8e75a8d0 778 \brief Stop collecting wlan RX statistic, (if previous called sl_WlanRxStatStart)
dflet 0:400d8e75a8d0 779
dflet 0:400d8e75a8d0 780 \return On success, zero is returned. On error, -1 is returned
dflet 0:400d8e75a8d0 781
dflet 0:400d8e75a8d0 782 \sa sl_WlanRxStatStart sl_WlanRxStatGet
dflet 0:400d8e75a8d0 783 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 784 \warning
dflet 0:400d8e75a8d0 785 */
dflet 0:400d8e75a8d0 786 #if _SL_INCLUDE_FUNC(sl_WlanRxStatStop)
dflet 0:400d8e75a8d0 787 int16_t sl_WlanRxStatStop(void);
dflet 0:400d8e75a8d0 788 #endif
dflet 0:400d8e75a8d0 789
dflet 0:400d8e75a8d0 790
dflet 0:400d8e75a8d0 791 /*!
dflet 0:400d8e75a8d0 792 \brief Get wlan RX statistics. upon calling this command, the statistics counters will be cleared.
dflet 0:400d8e75a8d0 793
dflet 0:400d8e75a8d0 794 \param[in] Flags should be 0 ( not applicable right now, will be added the future )
dflet 0:400d8e75a8d0 795 \param[in] pRxStat a pointer to SlGetRxStatResponse_t filled with Rx statistics results
dflet 0:400d8e75a8d0 796 \return On success, zero is returned. On error, -1 is returned
dflet 0:400d8e75a8d0 797
dflet 0:400d8e75a8d0 798 \sa sl_WlanRxStatStart sl_WlanRxStatStop
dflet 0:400d8e75a8d0 799 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 800 \warning
dflet 0:400d8e75a8d0 801 */
dflet 0:400d8e75a8d0 802 #if _SL_INCLUDE_FUNC(sl_WlanRxStatGet)
dflet 0:400d8e75a8d0 803 int16_t sl_WlanRxStatGet(SlGetRxStatResponse_t *pRxStat, const uint32_t Flags);
dflet 0:400d8e75a8d0 804 #endif
dflet 0:400d8e75a8d0 805
dflet 0:400d8e75a8d0 806
dflet 0:400d8e75a8d0 807 /*!
dflet 0:400d8e75a8d0 808 \brief Stop Smart Config procedure. Once Smart Config will be stopped,
dflet 0:400d8e75a8d0 809 Asynchronous event will be received - SL_OPCODE_WLAN_SMART_CONFIG_STOP_ASYNC_RESPONSE.
dflet 0:400d8e75a8d0 810
dflet 0:400d8e75a8d0 811 \param[in] none
dflet 0:400d8e75a8d0 812 \param[out] none
dflet 0:400d8e75a8d0 813
dflet 0:400d8e75a8d0 814 \return 0 - if Stop Smart Config is about to be executed without errors.
dflet 0:400d8e75a8d0 815
dflet 0:400d8e75a8d0 816 \sa sl_WlanSmartConfigStart
dflet 0:400d8e75a8d0 817 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 818 \warning
dflet 0:400d8e75a8d0 819
dflet 0:400d8e75a8d0 820 */
dflet 0:400d8e75a8d0 821 #if _SL_INCLUDE_FUNC(sl_WlanSmartConfigStop)
dflet 0:400d8e75a8d0 822 int16_t sl_WlanSmartConfigStop(void);
dflet 0:400d8e75a8d0 823 #endif
dflet 0:400d8e75a8d0 824
dflet 0:400d8e75a8d0 825 /*!
dflet 0:400d8e75a8d0 826 \brief Start Smart Config procedure
dflet 0:400d8e75a8d0 827 \par
dflet 0:400d8e75a8d0 828 The target of the procedure is to let the \n
dflet 0:400d8e75a8d0 829 device to gain the network parameters: SSID and Password (if network is secured) \n
dflet 0:400d8e75a8d0 830 and to connect to it once located in the network range. \n
dflet 0:400d8e75a8d0 831 An external application should be used on a device connected to any mobile network. \n
dflet 0:400d8e75a8d0 832 The external application will transmit over the air the network parameters in secured manner.\n
dflet 0:400d8e75a8d0 833 The Password may be decrypted using a Key. \n
dflet 0:400d8e75a8d0 834 The decryption method may be decided in the command or embedded in the Flash. \n
dflet 0:400d8e75a8d0 835 The procedure can be activated for 1-3 group ID in the range of BIT_0 - BIT_15 where the default group ID id 0 (BIT_0) \n
dflet 0:400d8e75a8d0 836 Once Smart Config has ended successfully, Asynchronous event will be received - \n
dflet 0:400d8e75a8d0 837 SL_OPCODE_WLAN_SMART_CONFIG_START_ASYNC_RESPONSE. \n
dflet 0:400d8e75a8d0 838 The Event will hold the SSID and an extra field that might have been delivered as well (i.e. - device name)
dflet 0:400d8e75a8d0 839
dflet 0:400d8e75a8d0 840 \param[in] groupIdBitmask - each bit represent a group ID that should be searched.
dflet 0:400d8e75a8d0 841 The Default group ID id BIT_0. 2 more group can be searched
dflet 0:400d8e75a8d0 842 in addition. The range is BIT_0 - BIT_15.
dflet 0:400d8e75a8d0 843 \param[in] chiper - 0: check in flash, 1 - AES, 0xFF - do not check in flash
dflet 0:400d8e75a8d0 844 \param[in] publicKeyLen - public key len (used for the default group ID - BIT_0)
dflet 0:400d8e75a8d0 845 \param[in] group1KeyLen - group ID1 length
dflet 0:400d8e75a8d0 846 \param[in] group2KeyLen - group ID2 length
dflet 0:400d8e75a8d0 847 \param[in] publicKey - public key (used for the default group ID - BIT_0)
dflet 0:400d8e75a8d0 848 \param[in] group1Key - group ID1 key
dflet 0:400d8e75a8d0 849 \param[in] group2Key - group ID2 key
dflet 0:400d8e75a8d0 850
dflet 0:400d8e75a8d0 851 \param[out] none
dflet 0:400d8e75a8d0 852
dflet 0:400d8e75a8d0 853 \return 0 - if Smart Config started successfully.
dflet 0:400d8e75a8d0 854
dflet 0:400d8e75a8d0 855 \sa sl_WlanSmartConfigStop
dflet 0:400d8e75a8d0 856 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 857 \warning
dflet 0:400d8e75a8d0 858 \par
dflet 0:400d8e75a8d0 859 \code An example of starting smart Config on group ID's 0 + 1 + 2
dflet 0:400d8e75a8d0 860
dflet 0:400d8e75a8d0 861 sl_WlanSmartConfigStart(7, //group ID's (BIT_0 | BIT_1 | BIT_2)
dflet 0:400d8e75a8d0 862 1, //decrypt key by AES method
dflet 0:400d8e75a8d0 863 16, //decryption key length for group ID0
dflet 0:400d8e75a8d0 864 16, //decryption key length for group ID1
dflet 0:400d8e75a8d0 865 16, //decryption key length for group ID2
dflet 0:400d8e75a8d0 866 "Key0Key0Key0Key0", //decryption key for group ID0
dflet 0:400d8e75a8d0 867 "Key1Key1Key1Key1", //decryption key for group ID1
dflet 0:400d8e75a8d0 868 "Key2Key2Key2Key2" //decryption key for group ID2
dflet 0:400d8e75a8d0 869 );
dflet 0:400d8e75a8d0 870 \endcode
dflet 0:400d8e75a8d0 871 */
dflet 0:400d8e75a8d0 872 #if _SL_INCLUDE_FUNC(sl_WlanSmartConfigStart)
dflet 0:400d8e75a8d0 873 int16_t sl_WlanSmartConfigStart(const uint32_t groupIdBitmask,
dflet 0:400d8e75a8d0 874 const uint8_t cipher,
dflet 0:400d8e75a8d0 875 const uint8_t publicKeyLen,
dflet 0:400d8e75a8d0 876 const uint8_t group1KeyLen,
dflet 0:400d8e75a8d0 877 const uint8_t group2KeyLen,
dflet 0:400d8e75a8d0 878 const uint8_t* publicKey,
dflet 0:400d8e75a8d0 879 const uint8_t* group1Key,
dflet 0:400d8e75a8d0 880 const uint8_t* group2Key);
dflet 0:400d8e75a8d0 881 #endif
dflet 0:400d8e75a8d0 882
dflet 0:400d8e75a8d0 883
dflet 0:400d8e75a8d0 884 /*!
dflet 0:400d8e75a8d0 885 \brief Wlan set mode
dflet 0:400d8e75a8d0 886
dflet 0:400d8e75a8d0 887 Setting WLAN mode
dflet 0:400d8e75a8d0 888
dflet 0:400d8e75a8d0 889 \param[in] mode - WLAN mode to start the CC31xx device. Possible options are:
dflet 0:400d8e75a8d0 890 - ROLE_STA - for WLAN station mode
dflet 0:400d8e75a8d0 891 - ROLE_AP - for WLAN AP mode
dflet 0:400d8e75a8d0 892 - ROLE_P2P -for WLAN P2P mode
dflet 0:400d8e75a8d0 893 \return 0 - if mode was set correctly
dflet 0:400d8e75a8d0 894 \sa sl_Start sl_Stop
dflet 0:400d8e75a8d0 895 \note belongs to \ref ext_api
dflet 0:400d8e75a8d0 896 \warning After setting the mode the system must be restarted for activating the new mode
dflet 0:400d8e75a8d0 897 \par Example:
dflet 0:400d8e75a8d0 898 \code
dflet 0:400d8e75a8d0 899 //Switch from any role to STA:
dflet 0:400d8e75a8d0 900 sl_WlanSetMode(ROLE_STA);
dflet 0:400d8e75a8d0 901 sl_Stop(0);
dflet 0:400d8e75a8d0 902 sl_Start(NULL,NULL,NULL);
dflet 0:400d8e75a8d0 903 \endcode
dflet 0:400d8e75a8d0 904
dflet 0:400d8e75a8d0 905 */
dflet 0:400d8e75a8d0 906 #if _SL_INCLUDE_FUNC(sl_WlanSetMode)
dflet 0:400d8e75a8d0 907 int16_t sl_WlanSetMode(const uint8_t mode);
dflet 0:400d8e75a8d0 908 #endif
dflet 0:400d8e75a8d0 909
dflet 0:400d8e75a8d0 910
dflet 0:400d8e75a8d0 911 /*!
dflet 0:400d8e75a8d0 912 \brief Internal function for setting WLAN configurations
dflet 0:400d8e75a8d0 913
dflet 0:400d8e75a8d0 914 \return On success, zero is returned. On error one of the following error codes returned:
dflet 0:400d8e75a8d0 915 - CONF_ERROR (-1)
dflet 0:400d8e75a8d0 916 - CONF_NVMEM_ACCESS_FAILED (-2)
dflet 0:400d8e75a8d0 917 - CONF_OLD_FILE_VERSION (-3)
dflet 0:400d8e75a8d0 918 - CONF_ERROR_NO_SUCH_COUNTRY_CODE (-4)
dflet 0:400d8e75a8d0 919
dflet 0:400d8e75a8d0 920
dflet 0:400d8e75a8d0 921 \param[in] ConfigId - configuration id
dflet 0:400d8e75a8d0 922 - <b>SL_WLAN_CFG_AP_ID</b>
dflet 0:400d8e75a8d0 923 - <b>SL_WLAN_CFG_GENERAL_PARAM_ID</b>
dflet 0:400d8e75a8d0 924 - <b>SL_WLAN_CFG_P2P_PARAM_ID</b>
dflet 0:400d8e75a8d0 925
dflet 0:400d8e75a8d0 926 \param[in] ConfigOpt - configurations option
dflet 0:400d8e75a8d0 927 - <b>SL_WLAN_CFG_AP_ID</b>
dflet 0:400d8e75a8d0 928 - <b>WLAN_AP_OPT_SSID</b> \n
dflet 0:400d8e75a8d0 929 Set SSID for AP mode. \n
dflet 0:400d8e75a8d0 930 This options takes <b>uint8_t</b> buffer as parameter
dflet 0:400d8e75a8d0 931 - <b>WLAN_AP_OPT_CHANNEL</b> \n
dflet 0:400d8e75a8d0 932 Set channel for AP mode. \n
dflet 0:400d8e75a8d0 933 The channel is dependant on the country code which is set. i.e. for "US" the channel should be in the range of [1-11] \n
dflet 0:400d8e75a8d0 934 This option takes <b>uint8_t</b> as a parameter
dflet 0:400d8e75a8d0 935 - <b>WLAN_AP_OPT_HIDDEN_SSID</b> \n
dflet 0:400d8e75a8d0 936 Set Hidden SSID Mode for AP mode.Hidden options: \n
dflet 0:400d8e75a8d0 937 0: disabled \n
dflet 0:400d8e75a8d0 938 1: Send empty (length=0) SSID in beacon and ignore probe request for broadcast SSID \n
dflet 0:400d8e75a8d0 939 2: Clear SSID (ASCII 0), but keep the original length (this may be required with some \n
dflet 0:400d8e75a8d0 940 clients that do not support empty SSID) and ignore probe requests for broadcast SSID \n
dflet 0:400d8e75a8d0 941 This option takes <b>uint8_t</b> as a parameter
dflet 0:400d8e75a8d0 942 - <b>WLAN_AP_OPT_SECURITY_TYPE</b> \n
dflet 0:400d8e75a8d0 943 Set Security type for AP mode. Security options are:
dflet 0:400d8e75a8d0 944 - Open security: SL_SEC_TYPE_OPEN
dflet 0:400d8e75a8d0 945 - WEP security: SL_SEC_TYPE_WEP
dflet 0:400d8e75a8d0 946 - WPA security: SL_SEC_TYPE_WPA_WPA2 \n
dflet 0:400d8e75a8d0 947 This option takes <b>uint8_t</b> pointer as a parameter
dflet 0:400d8e75a8d0 948 - <b>WLAN_AP_OPT_PASSWORD</b> \n
dflet 0:400d8e75a8d0 949 Set Password for for AP mode (for WEP or for WPA): \n
dflet 0:400d8e75a8d0 950 Password - for WPA: 8 - 63 characters \n
dflet 0:400d8e75a8d0 951 for WEP: 5 / 13 characters (ascii) \n
dflet 0:400d8e75a8d0 952 This options takes <b>uint8_t</b> buffer as parameter
dflet 0:400d8e75a8d0 953 - <b>SL_WLAN_CFG_GENERAL_PARAM_ID</b>
dflet 0:400d8e75a8d0 954 - <b> WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS </b> \n
dflet 0:400d8e75a8d0 955 Set scan parameters.
dflet 0:400d8e75a8d0 956 This option uses slWlanScanParamCommand_t as parameter
dflet 0:400d8e75a8d0 957 - <b>WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE</b> \n
dflet 0:400d8e75a8d0 958 Set Country Code for AP mode \n
dflet 0:400d8e75a8d0 959 This options takes <b>uint8_t</b> 2 bytes buffer as parameter
dflet 0:400d8e75a8d0 960 - <b>WLAN_GENERAL_PARAM_OPT_STA_TX_POWER</b> \n
dflet 0:400d8e75a8d0 961 Set STA mode Tx power level \n
dflet 0:400d8e75a8d0 962 Number between 0-15, as dB offset from max power (0 will set MAX power) \n
dflet 0:400d8e75a8d0 963 This options takes <b>uint8_t</b> as parameter
dflet 0:400d8e75a8d0 964 - <b>WLAN_GENERAL_PARAM_OPT_AP_TX_POWER</b>
dflet 0:400d8e75a8d0 965 Set AP mode Tx power level \n
dflet 0:400d8e75a8d0 966 Number between 0-15, as dB offset from max power (0 will set MAX power) \n
dflet 0:400d8e75a8d0 967 This options takes <b>uint8_t</b> as parameter
dflet 0:400d8e75a8d0 968 - <b>WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT</b>
dflet 0:400d8e75a8d0 969 Set Info Element for AP mode. \n
dflet 0:400d8e75a8d0 970 The Application can set up to MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED info elements per Role (AP / P2P GO). \n
dflet 0:400d8e75a8d0 971 To delete an info element use the relevant index and length = 0. \n
dflet 0:400d8e75a8d0 972 The Application can set up to MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED to the same role. \n
dflet 0:400d8e75a8d0 973 However, for AP - no more than INFO_ELEMENT_MAX_TOTAL_LENGTH_AP bytes can be stored for all info elements. \n
dflet 0:400d8e75a8d0 974 For P2P GO - no more than INFO_ELEMENT_MAX_TOTAL_LENGTH_P2P_GO bytes can be stored for all info elements. \n
dflet 0:400d8e75a8d0 975 This option takes sl_protocol_WlanSetInfoElement_t as parameter
dflet 0:400d8e75a8d0 976 - <b>SL_WLAN_CFG_P2P_PARAM_ID</b>
dflet 0:400d8e75a8d0 977 - <b>WLAN_P2P_OPT_DEV_TYPE</b> \n
dflet 0:400d8e75a8d0 978 Set P2P Device type.Maximum length of 17 characters. Device type is published under P2P I.E, \n
dflet 0:400d8e75a8d0 979 allows to make devices easier to recognize. \n
dflet 0:400d8e75a8d0 980 In case no device type is set, the default type is "1-0050F204-1" \n
dflet 0:400d8e75a8d0 981 This options takes <b>uint8_t</b> buffer as parameter
dflet 0:400d8e75a8d0 982 - <b>WLAN_P2P_OPT_CHANNEL_N_REGS</b> \n
dflet 0:400d8e75a8d0 983 Set P2P Channels. \n
dflet 0:400d8e75a8d0 984 listen channel (either 1/6/11 for 2.4GHz) \n
dflet 0:400d8e75a8d0 985 listen regulatory class (81 for 2.4GHz) \n
dflet 0:400d8e75a8d0 986 oper channel (either 1/6/11 for 2.4GHz) \n
dflet 0:400d8e75a8d0 987 oper regulatory class (81 for 2.4GHz) \n
dflet 0:400d8e75a8d0 988 listen channel and regulatory class will determine the device listen channel during p2p find listen phase \n
dflet 0:400d8e75a8d0 989 oper channel and regulatory class will determine the operating channel preferred by this device (in case it is group owner this will be the operating channel) \n
dflet 0:400d8e75a8d0 990 channels should be one of the social channels (1/6/11). In case no listen/oper channel selected, a random 1/6/11 will be selected.
dflet 0:400d8e75a8d0 991 This option takes pointer to <b>uint8_t[4]</b> as parameter
dflet 0:400d8e75a8d0 992
dflet 0:400d8e75a8d0 993 \param[in] ConfigLen - configurations len
dflet 0:400d8e75a8d0 994
dflet 0:400d8e75a8d0 995 \param[in] pValues - configurations values
dflet 0:400d8e75a8d0 996
dflet 0:400d8e75a8d0 997 \sa
dflet 0:400d8e75a8d0 998 \note
dflet 0:400d8e75a8d0 999 \warning
dflet 0:400d8e75a8d0 1000 \par Examples:
dflet 0:400d8e75a8d0 1001 \par
dflet 0:400d8e75a8d0 1002 <b> WLAN_AP_OPT_SSID: </b>
dflet 0:400d8e75a8d0 1003 \code
dflet 0:400d8e75a8d0 1004 uint8_t str[33];
dflet 0:400d8e75a8d0 1005 memset(str, 0, 33);
dflet 0:400d8e75a8d0 1006 memcpy(str, ssid, len); // ssid string of 32 characters
dflet 0:400d8e75a8d0 1007 sl_WlanSet(SL_WLAN_CFG_AP_ID, WLAN_AP_OPT_SSID, strlen(ssid), str);
dflet 0:400d8e75a8d0 1008 \endcode
dflet 0:400d8e75a8d0 1009 \par
dflet 0:400d8e75a8d0 1010 <b> WLAN_AP_OPT_CHANNEL: </b>
dflet 0:400d8e75a8d0 1011 \code
dflet 0:400d8e75a8d0 1012 uint8_t val = channel;
dflet 0:400d8e75a8d0 1013 sl_WlanSet(SL_WLAN_CFG_AP_ID, WLAN_AP_OPT_CHANNEL, 1, (uint8_t *)&val);
dflet 0:400d8e75a8d0 1014 \endcode
dflet 0:400d8e75a8d0 1015 \par
dflet 0:400d8e75a8d0 1016 <b> WLAN_AP_OPT_HIDDEN_SSID: </b>
dflet 0:400d8e75a8d0 1017 \code
dflet 0:400d8e75a8d0 1018 uint8_t val = hidden;
dflet 0:400d8e75a8d0 1019 sl_WlanSet(SL_WLAN_CFG_AP_ID, WLAN_AP_OPT_HIDDEN_SSID, 1, (uint8_t *)&val);
dflet 0:400d8e75a8d0 1020 \endcode
dflet 0:400d8e75a8d0 1021 \par
dflet 0:400d8e75a8d0 1022 <b> WLAN_AP_OPT_SECURITY_TYPE: </b>
dflet 0:400d8e75a8d0 1023 \code
dflet 0:400d8e75a8d0 1024 uint8_t val = SL_SEC_TYPE_WPA_WPA2;
dflet 0:400d8e75a8d0 1025 sl_WlanSet(SL_WLAN_CFG_AP_ID, WLAN_AP_OPT_SECURITY_TYPE, 1, (uint8_t *)&val);
dflet 0:400d8e75a8d0 1026 \endcode
dflet 0:400d8e75a8d0 1027 \par
dflet 0:400d8e75a8d0 1028 <b> WLAN_AP_OPT_PASSWORD: </b>
dflet 0:400d8e75a8d0 1029 \code
dflet 0:400d8e75a8d0 1030 uint8_t str[65];
dflet 0:400d8e75a8d0 1031 uint16_t len = strlen(password);
dflet 0:400d8e75a8d0 1032 memset(str, 0, 65);
dflet 0:400d8e75a8d0 1033 memcpy(str, password, len);
dflet 0:400d8e75a8d0 1034 sl_WlanSet(SL_WLAN_CFG_AP_ID, WLAN_AP_OPT_PASSWORD, len, (uint8_t *)str);
dflet 0:400d8e75a8d0 1035 \endcode
dflet 0:400d8e75a8d0 1036 \par
dflet 0:400d8e75a8d0 1037 <b> WLAN_GENERAL_PARAM_OPT_STA_TX_POWER: </b>
dflet 0:400d8e75a8d0 1038 \code
dflet 0:400d8e75a8d0 1039 uint8_t stapower=(uint8_t)power;
dflet 0:400d8e75a8d0 1040 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, WLAN_GENERAL_PARAM_OPT_STA_TX_POWER,1,(uint8_t *)&stapower);
dflet 0:400d8e75a8d0 1041 \endcode
dflet 0:400d8e75a8d0 1042 \par
dflet 0:400d8e75a8d0 1043 <b> WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS: </b>
dflet 0:400d8e75a8d0 1044 \code
dflet 0:400d8e75a8d0 1045 slWlanScanParamCommand_t ScanParamConfig;
dflet 0:400d8e75a8d0 1046 ScanParamConfig.G_Channels_mask = 0x01; // bit mask for channels:1 means channel 1 is enabled, 3 means channels 1 + 2 are enabled
dflet 0:400d8e75a8d0 1047 ScanParamConfig.rssiThershold = -70; // only for RSSI level which is higher than -70
dflet 0:400d8e75a8d0 1048 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID ,WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS,sizeof(slWlanScanParamCommand_t),(_u8*)&ScanParamConfig);
dflet 0:400d8e75a8d0 1049 \endcode
dflet 0:400d8e75a8d0 1050 \par
dflet 0:400d8e75a8d0 1051 <b> WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE: </b>
dflet 0:400d8e75a8d0 1052 \code
dflet 0:400d8e75a8d0 1053 uint8_t* str = (uint8_t *) country; // string of 2 characters. i.e. - "US"
dflet 0:400d8e75a8d0 1054 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE, 2, str);
dflet 0:400d8e75a8d0 1055 \endcode
dflet 0:400d8e75a8d0 1056 \par
dflet 0:400d8e75a8d0 1057 <b> WLAN_GENERAL_PARAM_OPT_AP_TX_POWER: </b>
dflet 0:400d8e75a8d0 1058 \code
dflet 0:400d8e75a8d0 1059 uint8_t appower=(uint8_t)power;
dflet 0:400d8e75a8d0 1060 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, WLAN_GENERAL_PARAM_OPT_AP_TX_POWER,1,(uint8_t *)&appower);
dflet 0:400d8e75a8d0 1061 \endcode
dflet 0:400d8e75a8d0 1062 \par
dflet 0:400d8e75a8d0 1063 <b> WLAN_P2P_OPT_DEV_TYPE: </b>
dflet 0:400d8e75a8d0 1064 \code
dflet 0:400d8e75a8d0 1065 uint8_t str[17];
dflet 0:400d8e75a8d0 1066 uint16_t len = strlen(device_type);
dflet 0:400d8e75a8d0 1067 memset(str, 0, 17);
dflet 0:400d8e75a8d0 1068 memcpy(str, device_type, len);
dflet 0:400d8e75a8d0 1069 sl_WlanSet(SL_WLAN_CFG_P2P_PARAM_ID, WLAN_P2P_OPT_DEV_TYPE, len, str);
dflet 0:400d8e75a8d0 1070 \endcode
dflet 0:400d8e75a8d0 1071 \par
dflet 0:400d8e75a8d0 1072 <b> WLAN_P2P_OPT_CHANNEL_N_REGS: </b>
dflet 0:400d8e75a8d0 1073 \code
dflet 0:400d8e75a8d0 1074 uint8_t str[4];
dflet 0:400d8e75a8d0 1075 str[0] = (uint8_t)11; // listen channel
dflet 0:400d8e75a8d0 1076 str[1] = (uint8_t)81; // listen regulatory class
dflet 0:400d8e75a8d0 1077 str[2] = (uint8_t)6; // oper channel
dflet 0:400d8e75a8d0 1078 str[3] = (uint8_t)81; // oper regulatory class
dflet 0:400d8e75a8d0 1079 sl_WlanSet(SL_WLAN_CFG_P2P_PARAM_ID, WLAN_P2P_OPT_CHANNEL_N_REGS, 4, str);
dflet 0:400d8e75a8d0 1080 \endcode
dflet 0:400d8e75a8d0 1081 \par
dflet 0:400d8e75a8d0 1082 <b> WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT: </b>
dflet 0:400d8e75a8d0 1083 \code
dflet 0:400d8e75a8d0 1084 sl_protocol_WlanSetInfoElement_t infoele;
dflet 0:400d8e75a8d0 1085 infoele.index = Index; // Index of the info element. range: 0 - MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED
dflet 0:400d8e75a8d0 1086 infoele.role = Role; // INFO_ELEMENT_AP_ROLE (0) or INFO_ELEMENT_P2P_GO_ROLE (1)
dflet 0:400d8e75a8d0 1087 infoele.ie.id = Id; // Info element ID. if INFO_ELEMENT_DEFAULT_ID (0) is set, ID will be set to 221.
dflet 0:400d8e75a8d0 1088 // Organization unique ID. If all 3 bytes are zero - it will be replaced with 08,00,28.
dflet 0:400d8e75a8d0 1089 infoele.ie.oui[0] = Oui0; // Organization unique ID first Byte
dflet 0:400d8e75a8d0 1090 infoele.ie.oui[1] = Oui1; // Organization unique ID second Byte
dflet 0:400d8e75a8d0 1091 infoele.ie.oui[2] = Oui2; // Organization unique ID third Byte
dflet 0:400d8e75a8d0 1092 infoele.ie.length = Len; // Length of the info element. must be smaller than 253 bytes
dflet 0:400d8e75a8d0 1093 memset(infoele.ie.data, 0, INFO_ELEMENT_MAX_SIZE);
dflet 0:400d8e75a8d0 1094 if ( Len <= INFO_ELEMENT_MAX_SIZE )
dflet 0:400d8e75a8d0 1095 {
dflet 0:400d8e75a8d0 1096 memcpy(infoele.ie.data, IE, Len); // Info element. length of the info element is [0-252]
dflet 0:400d8e75a8d0 1097 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID,WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT,sizeof(sl_protocol_WlanSetInfoElement_t),(uint8_t* ) &infoele);
dflet 0:400d8e75a8d0 1098 }
dflet 0:400d8e75a8d0 1099 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID,WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT,sizeof(sl_protocol_WlanSetInfoElement_t),(uint8_t* ) &infoele);
dflet 0:400d8e75a8d0 1100 \endcode
dflet 0:400d8e75a8d0 1101
dflet 0:400d8e75a8d0 1102 */
dflet 0:400d8e75a8d0 1103 #if _SL_INCLUDE_FUNC(sl_WlanSet)
dflet 0:400d8e75a8d0 1104 int16_t sl_WlanSet(const uint16_t ConfigId ,const uint16_t ConfigOpt, const uint16_t ConfigLen, const uint8_t *pValues);
dflet 0:400d8e75a8d0 1105 #endif
dflet 0:400d8e75a8d0 1106
dflet 0:400d8e75a8d0 1107 /*!
dflet 0:400d8e75a8d0 1108 \brief Internal function for getting WLAN configurations
dflet 0:400d8e75a8d0 1109
dflet 0:400d8e75a8d0 1110 \return On success, zero is returned. On error, -1 is
dflet 0:400d8e75a8d0 1111 returned
dflet 0:400d8e75a8d0 1112
dflet 0:400d8e75a8d0 1113 \param[in] ConfigId - configuration id
dflet 0:400d8e75a8d0 1114 - <b>SL_WLAN_CFG_AP_ID</b>
dflet 0:400d8e75a8d0 1115 - <b>SL_WLAN_CFG_GENERAL_PARAM_ID</b>
dflet 0:400d8e75a8d0 1116 - <b>SL_WLAN_CFG_P2P_PARAM_ID</b>
dflet 0:400d8e75a8d0 1117
dflet 0:400d8e75a8d0 1118 \param[out] pConfigOpt - get configurations option
dflet 0:400d8e75a8d0 1119 - <b>SL_WLAN_CFG_AP_ID</b>
dflet 0:400d8e75a8d0 1120 - <b>WLAN_AP_OPT_SSID</b> \n
dflet 0:400d8e75a8d0 1121 Get SSID for AP mode. \n
dflet 0:400d8e75a8d0 1122 Get up to 32 characters of SSID \n
dflet 0:400d8e75a8d0 1123 This options takes <b>uint8_t</b> as parameter
dflet 0:400d8e75a8d0 1124 - <b>WLAN_AP_OPT_CHANNEL</b> \n
dflet 0:400d8e75a8d0 1125 Get channel for AP mode. \n
dflet 0:400d8e75a8d0 1126 This option takes <b>uint8_t</b> as a parameter
dflet 0:400d8e75a8d0 1127 - <b>WLAN_AP_OPT_HIDDEN_SSID</b> \n
dflet 0:400d8e75a8d0 1128 Get Hidden SSID Mode for AP mode.Hidden options: \n
dflet 0:400d8e75a8d0 1129 0: disabled \n
dflet 0:400d8e75a8d0 1130 1: Send empty (length=0) SSID in beacon and ignore probe request for broadcast SSID \n
dflet 0:400d8e75a8d0 1131 2: Clear SSID (ASCII 0), but keep the original length (this may be required with some \n
dflet 0:400d8e75a8d0 1132 clients that do not support empty SSID) and ignore probe requests for broadcast SSID \n
dflet 0:400d8e75a8d0 1133 This option takes <b>uint8_t</b> as a parameter
dflet 0:400d8e75a8d0 1134 - <b>WLAN_AP_OPT_SECURITY_TYPE</b> \n
dflet 0:400d8e75a8d0 1135 Get Security type for AP mode. Security options are:
dflet 0:400d8e75a8d0 1136 - Open security: SL_SEC_TYPE_OPEN
dflet 0:400d8e75a8d0 1137 - WEP security: SL_SEC_TYPE_WEP
dflet 0:400d8e75a8d0 1138 - WPA security: SL_SEC_TYPE_WPA_WPA2 \n
dflet 0:400d8e75a8d0 1139 This option takes <b>uint8_t</b> as a parameter
dflet 0:400d8e75a8d0 1140 - <b>WLAN_AP_OPT_PASSWORD</b> \n
dflet 0:400d8e75a8d0 1141 Get Password for for AP mode (for WEP or for WPA): \n
dflet 0:400d8e75a8d0 1142 Returns password - string, fills up to 64 characters. \n
dflet 0:400d8e75a8d0 1143 This options takes <b>uint8_t</b> buffer as parameter
dflet 0:400d8e75a8d0 1144 - <b>SL_WLAN_CFG_GENERAL_PARAM_ID</b>
dflet 0:400d8e75a8d0 1145 - <b> WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS </b> \n
dflet 0:400d8e75a8d0 1146 Get scan parameters.
dflet 0:400d8e75a8d0 1147 This option uses slWlanScanParamCommand_t as parameter
dflet 0:400d8e75a8d0 1148 - <b>WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE</b> \n
dflet 0:400d8e75a8d0 1149 Get Country Code for AP mode \n
dflet 0:400d8e75a8d0 1150 This options takes <b>uint8_t</b> buffer as parameter
dflet 0:400d8e75a8d0 1151 - <b>WLAN_GENERAL_PARAM_OPT_STA_TX_POWER</b> \n
dflet 0:400d8e75a8d0 1152 Get STA mode Tx power level \n
dflet 0:400d8e75a8d0 1153 Number between 0-15, as dB offset from max power (0 indicates MAX power) \n
dflet 0:400d8e75a8d0 1154 This options takes <b>uint8_t</b> as parameter
dflet 0:400d8e75a8d0 1155 - <b>WLAN_GENERAL_PARAM_OPT_AP_TX_POWER</b>
dflet 0:400d8e75a8d0 1156 Get AP mode Tx power level \n
dflet 0:400d8e75a8d0 1157 Number between 0-15, as dB offset from max power (0 indicates MAX power) \n
dflet 0:400d8e75a8d0 1158 This options takes <b>uint8_t</b> as parameter
dflet 0:400d8e75a8d0 1159 - <b>SL_WLAN_CFG_P2P_PARAM_ID</b>
dflet 0:400d8e75a8d0 1160 - <b>WLAN_P2P_OPT_CHANNEL_N_REGS</b> \n
dflet 0:400d8e75a8d0 1161 Get P2P Channels. \n
dflet 0:400d8e75a8d0 1162 listen channel (either 1/6/11 for 2.4GHz) \n
dflet 0:400d8e75a8d0 1163 listen regulatory class (81 for 2.4GHz) \n
dflet 0:400d8e75a8d0 1164 oper channel (either 1/6/11 for 2.4GHz) \n
dflet 0:400d8e75a8d0 1165 oper regulatory class (81 for 2.4GHz) \n
dflet 0:400d8e75a8d0 1166 listen channel and regulatory class will determine the device listen channel during p2p find listen phase \n
dflet 0:400d8e75a8d0 1167 oper channel and regulatory class will determine the operating channel preferred by this device (in case it is group owner this will be the operating channel) \n
dflet 0:400d8e75a8d0 1168 channels should be one of the social channels (1/6/11). In case no listen/oper channel selected, a random 1/6/11 will be selected. \n
dflet 0:400d8e75a8d0 1169 This option takes pointer to <b>uint8_t[4]</b> as parameter
dflet 0:400d8e75a8d0 1170
dflet 0:400d8e75a8d0 1171 \param[out] pConfigLen - The length of the allocated memory as input, when the
dflet 0:400d8e75a8d0 1172 function complete, the value of this parameter would be
dflet 0:400d8e75a8d0 1173 the len that actually read from the device.
dflet 0:400d8e75a8d0 1174 If the device return length that is longer from the input
dflet 0:400d8e75a8d0 1175 value, the function will cut the end of the returned structure
dflet 0:400d8e75a8d0 1176 and will return SL_ESMALLBUF.
dflet 0:400d8e75a8d0 1177
dflet 0:400d8e75a8d0 1178
dflet 0:400d8e75a8d0 1179 \param[out] pValues - get configurations values
dflet 0:400d8e75a8d0 1180
dflet 0:400d8e75a8d0 1181 \sa sl_WlanSet
dflet 0:400d8e75a8d0 1182
dflet 0:400d8e75a8d0 1183 \note
dflet 0:400d8e75a8d0 1184
dflet 0:400d8e75a8d0 1185 \warning
dflet 0:400d8e75a8d0 1186
dflet 0:400d8e75a8d0 1187 \par Examples:
dflet 0:400d8e75a8d0 1188 \par
dflet 0:400d8e75a8d0 1189 <b> WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS: </b>
dflet 0:400d8e75a8d0 1190 \code
dflet 0:400d8e75a8d0 1191 slWlanScanParamCommand_t ScanParamConfig;
dflet 0:400d8e75a8d0 1192 uint16_t Option = WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS;
dflet 0:400d8e75a8d0 1193 uint16_t OptionLen = sizeof(slWlanScanParamCommand_t);
dflet 0:400d8e75a8d0 1194 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(uint8_t *)&ScanParamConfig);
dflet 0:400d8e75a8d0 1195 \endcode
dflet 0:400d8e75a8d0 1196 \par
dflet 0:400d8e75a8d0 1197 <b> WLAN_GENERAL_PARAM_OPT_AP_TX_POWER: </b>
dflet 0:400d8e75a8d0 1198 \code
dflet 0:400d8e75a8d0 1199 _i8 TXPower = 0;
dflet 0:400d8e75a8d0 1200 _u16 Option = WLAN_GENERAL_PARAM_OPT_AP_TX_POWER;
dflet 0:400d8e75a8d0 1201 _u16 OptionLen = sizeof(_i8);
dflet 0:400d8e75a8d0 1202 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(_u8 *)&TXPower);
dflet 0:400d8e75a8d0 1203 \endcode
dflet 0:400d8e75a8d0 1204 \par
dflet 0:400d8e75a8d0 1205 <b> WLAN_GENERAL_PARAM_OPT_STA_TX_POWER: </b>
dflet 0:400d8e75a8d0 1206 \code
dflet 0:400d8e75a8d0 1207 _i8 TXPower = 0;
dflet 0:400d8e75a8d0 1208 _u16 Option = WLAN_GENERAL_PARAM_OPT_STA_TX_POWER;
dflet 0:400d8e75a8d0 1209 _u16 OptionLen = sizeof(_i8);
dflet 0:400d8e75a8d0 1210
dflet 0:400d8e75a8d0 1211 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(uint8_t *)&TXPower);
dflet 0:400d8e75a8d0 1212 \endcode
dflet 0:400d8e75a8d0 1213 \par
dflet 0:400d8e75a8d0 1214 <b> WLAN_P2P_OPT_DEV_TYPE: </b>
dflet 0:400d8e75a8d0 1215 \code
dflet 0:400d8e75a8d0 1216 int8_t device_type[18];
dflet 0:400d8e75a8d0 1217 uint16_t len = 18;
dflet 0:400d8e75a8d0 1218 uint16_t config_opt = WLAN_P2P_OPT_DEV_TYPE;
dflet 0:400d8e75a8d0 1219 sl_WlanGet(SL_WLAN_CFG_P2P_PARAM_ID, &config_opt , &len, (uint8_t* )device_type);
dflet 0:400d8e75a8d0 1220 \endcode
dflet 0:400d8e75a8d0 1221 \par
dflet 0:400d8e75a8d0 1222 <b> WLAN_AP_OPT_SSID: </b>
dflet 0:400d8e75a8d0 1223 \code
dflet 0:400d8e75a8d0 1224 int8_t ssid[32];
dflet 0:400d8e75a8d0 1225 uint16_t len = 32;
dflet 0:400d8e75a8d0 1226 uint16_t config_opt = WLAN_AP_OPT_SSID;
dflet 0:400d8e75a8d0 1227 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt , &len, (uint8_t* )ssid);
dflet 0:400d8e75a8d0 1228 \endcode
dflet 0:400d8e75a8d0 1229 \par
dflet 0:400d8e75a8d0 1230 <b> WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE: </b>
dflet 0:400d8e75a8d0 1231 \code
dflet 0:400d8e75a8d0 1232 int8_t country[3];
dflet 0:400d8e75a8d0 1233 uint16_t len = 3;
dflet 0:400d8e75a8d0 1234 uint16_t config_opt = WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE;
dflet 0:400d8e75a8d0 1235 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID, &config_opt, &len, (uint8_t* )country);
dflet 0:400d8e75a8d0 1236 \endcode
dflet 0:400d8e75a8d0 1237 \par
dflet 0:400d8e75a8d0 1238 <b> WLAN_AP_OPT_CHANNEL: </b>
dflet 0:400d8e75a8d0 1239 \code
dflet 0:400d8e75a8d0 1240 int8_t channel;
dflet 0:400d8e75a8d0 1241 uint16_t len = 1;
dflet 0:400d8e75a8d0 1242 uint16_t config_opt = WLAN_AP_OPT_CHANNEL;
dflet 0:400d8e75a8d0 1243 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (uint8_t* )&channel);
dflet 0:400d8e75a8d0 1244 \endcode
dflet 0:400d8e75a8d0 1245 \par
dflet 0:400d8e75a8d0 1246 <b> WLAN_AP_OPT_HIDDEN_SSID: </b>
dflet 0:400d8e75a8d0 1247 \code
dflet 0:400d8e75a8d0 1248 uint8_t hidden;
dflet 0:400d8e75a8d0 1249 uint16_t len = 1;
dflet 0:400d8e75a8d0 1250 uint16_t config_opt = WLAN_AP_OPT_HIDDEN_SSID;
dflet 0:400d8e75a8d0 1251 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (uint8_t* )&hidden);
dflet 0:400d8e75a8d0 1252 \endcode
dflet 0:400d8e75a8d0 1253 \par
dflet 0:400d8e75a8d0 1254 <b> WLAN_AP_OPT_SECURITY_TYPE: </b>
dflet 0:400d8e75a8d0 1255 \code
dflet 0:400d8e75a8d0 1256 uint8_t sec_type;
dflet 0:400d8e75a8d0 1257 uint16_t len = 1;
dflet 0:400d8e75a8d0 1258 uint16_t config_opt = WLAN_AP_OPT_SECURITY_TYPE;
dflet 0:400d8e75a8d0 1259 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (uint8_t* )&sec_type);
dflet 0:400d8e75a8d0 1260 \endcode
dflet 0:400d8e75a8d0 1261 \par
dflet 0:400d8e75a8d0 1262 <b> WLAN_AP_OPT_PASSWORD: </b>
dflet 0:400d8e75a8d0 1263 \code
dflet 0:400d8e75a8d0 1264 uint8_t password[64];
dflet 0:400d8e75a8d0 1265 uint16_t len = 64;
dflet 0:400d8e75a8d0 1266 memset(password,0,64);
dflet 0:400d8e75a8d0 1267 uint16_t config_opt = WLAN_AP_OPT_PASSWORD;
dflet 0:400d8e75a8d0 1268 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (uint8_t* )password);
dflet 0:400d8e75a8d0 1269
dflet 0:400d8e75a8d0 1270 \endcode
dflet 0:400d8e75a8d0 1271 \par
dflet 0:400d8e75a8d0 1272 <b> WLAN_P2P_OPT_CHANNEL_N_REGS: </b>
dflet 0:400d8e75a8d0 1273 \code
dflet 0:400d8e75a8d0 1274 uint16_t listen_channel,listen_reg,oper_channel,oper_reg;
dflet 0:400d8e75a8d0 1275 uint16_t len = 4;
dflet 0:400d8e75a8d0 1276 uint16_t config_opt = WLAN_P2P_OPT_CHANNEL_N_REGS;
dflet 0:400d8e75a8d0 1277 uint8_t channel_n_regs[4];
dflet 0:400d8e75a8d0 1278 sl_WlanGet(SL_WLAN_CFG_P2P_PARAM_ID, &config_opt, &len, (uint8_t* )channel_n_regs);
dflet 0:400d8e75a8d0 1279 listen_channel = channel_n_regs[0];
dflet 0:400d8e75a8d0 1280 listen_reg = channel_n_regs[1];
dflet 0:400d8e75a8d0 1281 oper_channel = channel_n_regs[2];
dflet 0:400d8e75a8d0 1282 oper_reg = channel_n_regs[3];
dflet 0:400d8e75a8d0 1283 \endcode
dflet 0:400d8e75a8d0 1284 */
dflet 0:400d8e75a8d0 1285
dflet 0:400d8e75a8d0 1286 #if _SL_INCLUDE_FUNC(sl_WlanGet)
dflet 0:400d8e75a8d0 1287 int16_t sl_WlanGet(const uint16_t ConfigId, uint16_t *pConfigOpt,uint16_t *pConfigLen, uint8_t *pValues);
dflet 0:400d8e75a8d0 1288 #endif
dflet 0:400d8e75a8d0 1289
dflet 0:400d8e75a8d0 1290 private:
dflet 0:400d8e75a8d0 1291
dflet 0:400d8e75a8d0 1292 cc3100_driver &_driver;
dflet 0:400d8e75a8d0 1293 cc3100_wlan_rx_filters &_wlan_filters;
dflet 0:400d8e75a8d0 1294
dflet 0:400d8e75a8d0 1295 /*!
dflet 0:400d8e75a8d0 1296
dflet 0:400d8e75a8d0 1297 Close the Doxygen group.
dflet 0:400d8e75a8d0 1298 @}
dflet 0:400d8e75a8d0 1299
dflet 0:400d8e75a8d0 1300 */
dflet 0:400d8e75a8d0 1301
dflet 0:400d8e75a8d0 1302 };//class
dflet 0:400d8e75a8d0 1303
dflet 0:400d8e75a8d0 1304 }//namespace mbed_cc3100
dflet 0:400d8e75a8d0 1305
dflet 0:400d8e75a8d0 1306 #endif /* __WLAN_H__ */
dflet 0:400d8e75a8d0 1307
dflet 0:400d8e75a8d0 1308