Controls the use of the WiFi WLAN module. More...

Functions
_i16	sl_WlanConnect (const _i8 pName, const _i16 NameLen, const _u8 pMacAddr, const SlWlanSecParams_t pSecParams, const SlWlanSecParamsExt_t pSecExtParams)
	Connect to wlan network as a station. More...

_i16	sl_WlanDisconnect (void)
	Wlan disconnect. More...

_i16	sl_WlanProfileAdd (const _i8 pName, const _i16 NameLen, const _u8 pMacAddr, const SlWlanSecParams_t pSecParams, const SlWlanSecParamsExt_t pSecExtParams, const _u32 Priority, const _u32 Options)
	Add profile. More...

_i16	sl_WlanProfileGet (const _i16 Index, _i8 pName, _i16 pNameLen, _u8 pMacAddr, SlWlanSecParams_t pSecParams, SlWlanGetSecParamsExt_t pSecExtParams, _u32 pPriority)
	Get profile. More...

_i16	sl_WlanProfileDel (const _i16 Index)
	Delete WLAN profile. More...

_i16	sl_WlanPolicySet (const _u8 Type, const _u8 Policy, _u8 *pVal, const _u8 ValLen)
	Set policy values. More...

_i16	sl_WlanPolicyGet (const _u8 Type, _u8 pPolicy, _u8 pVal, _u8 *pValLen)
	Get policy values. More...

_i16	sl_WlanGetNetworkList (const _u8 Index, const _u8 Count, SlWlanNetworkEntry_t *pEntries)
	Gets the WLAN scan operation results. More...

_i16	sl_WlanRxStatStart (void)
	Start collecting wlan RX statistics, for unlimited time. More...

_i16	sl_WlanRxStatStop (void)
	Stop collecting wlan RX statistic, (if previous called sl_WlanRxStatStart) More...

_i16	sl_WlanRxStatGet (SlWlanGetRxStatResponse_t *pRxStat, const _u32 Flags)
	Get wlan RX statistics. Upon calling this command, the statistics counters will be cleared. More...

_i16	sl_WlanProvisioning (_u8 ProvisioningCmd, _u8 RequestedRoleAfterSuccess, _u16 InactivityTimeoutSec, char *pSmartConfigKey, _u32 Flags)
	The simpleLink will switch to the appropriate role according to the provisioning mode requested and will start the provisioning process. More...

_i16	sl_WlanSetMode (const _u8 Mode)
	Wlan set mode. More...

_i16	sl_WlanSet (const _u16 ConfigId, const _u16 ConfigOpt, const _u16 ConfigLen, const _u8 *pValues)
	Setting WLAN configurations. More...

_i16	sl_WlanGet (const _u16 ConfigId, _u16 pConfigOpt, _u16 pConfigLen, _u8 *pValues)
	Getting WLAN configurations. More...

_i16	sl_WlanRxFilterAdd (SlWlanRxFilterRuleType_t RuleType, SlWlanRxFilterFlags_u Flags, const SlWlanRxFilterRule_u const pRule, const SlWlanRxFilterTrigger_t const pTrigger, const SlWlanRxFilterAction_t const pAction, SlWlanRxFilterID_t pFilterId)
	Adds new filter rule to the system. More...

Typedefs
typedef struct SlWlanEventSTAAdded_t	SlWlanEventSTARemoved_t

typedef struct SlWlanEventP2PClientAdded_t	SlWlanEventP2PClientRemoved_t

typedef struct SlWlanEventP2PDevFound_t	SlWlanEventP2PRequest_t

typedef _i8	SlWlanRxFilterID_t

typedef _u8	SlWlanRxFilterIdMask_t[128/8]

typedef _u8	SlWlanRxFilterSysFilters_t

typedef _u8	SlWlanRxFilterSysFiltersMask_t[SL_WLAN_RX_FILTER_MAX_SYS_FILTERS_SETS/8]

typedef _u8	SlWlanRxFilterRuleType_t

typedef _u8	SlWlanRxFilterFlags_u

typedef _u8	SlWlanRxFilterRuleHeaderCompareFunction_t

typedef _u8	SlWlanRxFilterTriggerCompareFunction_t

typedef _u8	SlWlanRxFilterRuleHeaderField_t

typedef _u8	SlWlanRxFilterRuleCombinationOperator_t

typedef _u8	SlWlanRxFilterTriggerRoles_t

typedef _u8	SlWlanRxFilterTriggerConnectionStates_t

typedef _u8	SlWlanRxFilterCounterId_t

typedef _u8	SlWlanRxFilterActionType_t

Enumerations
enum	SlWlanP2PWpsMethod_e { SL_WLAN_P2P_WPS_METHOD_DEFAULT, SL_WLAN_P2P_WPS_METHOD_PIN_USER, SL_WLAN_P2P_WPS_METHOD_PIN_MACHINE, SL_WLAN_P2P_WPS_METHOD_REKEY, SL_WLAN_P2P_WPS_METHOD_PBC, SL_WLAN_P2P_WPS_METHOD_REGISTRAR }

enum	SlWlanEventId_e { SL_WLAN_EVENT_CONNECT = 1, SL_WLAN_EVENT_DISCONNECT, SL_WLAN_EVENT_STA_ADDED, SL_WLAN_EVENT_STA_REMOVED, SL_WLAN_EVENT_P2P_CONNECT, SL_WLAN_EVENT_P2P_DISCONNECT, SL_WLAN_EVENT_P2P_CLIENT_ADDED, SL_WLAN_EVENT_P2P_CLIENT_REMOVED, SL_WLAN_EVENT_P2P_DEVFOUND, SL_WLAN_EVENT_P2P_REQUEST, SL_WLAN_EVENT_P2P_CONNECTFAIL, SL_WLAN_EVENT_RXFILTER, SL_WLAN_EVENT_PROVISIONING_STATUS, SL_WLAN_EVENT_PROVISIONING_PROFILE_ADDED, SL_WLAN_EVENT_MAX }

enum	SlWlanRateIndex_e { SL_WLAN_RATE_1M = 1, SL_WLAN_RATE_2M = 2, SL_WLAN_RATE_5_5M = 3, SL_WLAN_RATE_11M = 4, SL_WLAN_RATE_6M = 6, SL_WLAN_RATE_9M = 7, SL_WLAN_RATE_12M = 8, SL_WLAN_RATE_18M = 9, SL_WLAN_RATE_24M = 10, SL_WLAN_RATE_36M = 11, SL_WLAN_RATE_48M = 12, SL_WLAN_RATE_54M = 13, SL_WLAN_RATE_MCS_0 = 14, SL_WLAN_RATE_MCS_1 = 15, SL_WLAN_RATE_MCS_2 = 16, SL_WLAN_RATE_MCS_3 = 17, SL_WLAN_RATE_MCS_4 = 18, SL_WLAN_RATE_MCS_5 = 19, SL_WLAN_RATE_MCS_6 = 20, SL_WLAN_RATE_MCS_7 = 21, SL_WLAN_MAX_NUM_RATES = 0xFF }

enum	SlWlanP2pDevPwdMethod_e { SL_WLAN_DEV_PW_DEFAULT = 0, SL_WLAN_DEV_PW_PIN_KEYPAD = 1, SL_WLAN_DEV_PW_PUSH_BUTTON = 4, SL_WLAN_DEV_PW_PIN_DISPLAY = 5 }

enum	SlWlanMode_e { ROLE_STA = 0, ROLE_RESERVED = 1, ROLE_AP = 2, ROLE_P2P = 3 }

enum	SlWlanConnStatusFlags_e { SL_WLAN_DISCONNECTED = 0, SL_WLAN_CONNECTED_STA, SL_WLAN_CONNECTED_P2PCL, SL_WLAN_CONNECTED_P2PGO, SL_WLAN_AP_CONNECTED_STATIONS }

Detailed Description

Controls the use of the WiFi WLAN module.

Connection features, such as: profiles, policies, SmartConfig(tm)
Advanced WLAN features, such as: scans, rx filters and rx statistics collection

Function Documentation

_i16 sl_WlanConnect	(	const _i8 *	pName,
		const _i16	NameLen,
		const _u8 *	pMacAddr,
		const SlWlanSecParams_t *	pSecParams,
		const SlWlanSecParamsExt_t *	pSecExtParams
	)

Connect to wlan network as a station.

Parameters

[in]	pName	Up to 32 bytes in case of STA the name is the SSID of the Access Point
[in]	NameLen	Name length
[in]	pMacAddr	6 bytes for MAC address
[in]	pSecParams	Security parameters (use NULL key for SL_WLAN_SEC_TYPE_OPEN) security types options: SL_WLAN_SEC_TYPE_OPEN SL_WLAN_SEC_TYPE_WEP SL_WLAN_SEC_TYPE_WEP_SHARED SL_WLAN_SEC_TYPE_WPA_WPA2 SL_WLAN_SEC_TYPE_WPA_ENT SL_WLAN_SEC_TYPE_WPS_PBC SL_WLAN_SEC_TYPE_WPS_PIN
[in]	pSecExtParams	Enterprise parameters (set NULL in case Enterprise parameters is not in use)

Returns: Zero on success, or negative error code on failure

See also: sl_WlanDisconnect

Note: Belongs to ext_api

Warning: In this version only single enterprise mode could be used
SL_WLAN_SEC_TYPE_WPA is a deprecated definition, the new definition is SL_WLAN_SEC_TYPE_WPA_WPA2

Example

Connect without security:
1 SlWlanSecParams_t secParams;

2 secParams.Key = "";

3 secParams.KeyLen = 0;

4 secParams.Type = SL_WLAN_SEC_TYPE_OPEN;

5 sl_WlanConnect("ssid_name", strlen("ssid_name"),0,&secParams,0);

_i16 sl_WlanDisconnect ( void )

Wlan disconnect.

Disconnect connection

Returns: Zero disconnected done successfully, other already disconnected

See also: sl_WlanConnect

Note: belongs to ext_api

Warning

_i16 sl_WlanGet	(	const _u16	ConfigId,
		_u16 *	pConfigOpt,
		_u16 *	pConfigLen,
		_u8 *	pValues
	)

Getting WLAN configurations.

Parameters

[in]	ConfigId	- configuration id SL_WLAN_CFG_AP_ID SL_WLAN_CFG_GENERAL_PARAM_ID SL_WLAN_CFG_P2P_PARAM_ID SL_WLAN_CFG_AP_ACCESS_LIST_ID SL_WLAN_RX_FILTERS_ID
[out]	pConfigOpt	- get configurations option SL_WLAN_CFG_AP_ID SL_WLAN_AP_OPT_SSID Get SSID for AP mode. Get up to 32 characters of SSID This options takes _u8 as parameter SL_WLAN_AP_OPT_CHANNEL Get channel for AP mode. This option takes _u8 as a parameter SL_WLAN_AP_OPT_HIDDEN_SSID Get Hidden SSID Mode for AP mode.Hidden options: 0: disabled 1: Send empty (length=0) SSID in beacon and ignore probe request for broadcast SSID 2: Clear SSID (ASCII 0), but keep the original length (this may be required with some clients that do not support empty SSID) and ignore probe requests for broadcast SSID This option takes _u8 as a parameter SL_WLAN_AP_OPT_SECURITY_TYPE Get Security type for AP mode. Security options are: Open security: SL_WLAN_SEC_TYPE_OPEN WEP security: SL_WLAN_SEC_TYPE_WEP WPA security: SL_WLAN_SEC_TYPE_WPA_WPA2 This option takes _u8 as a parameter SL_WLAN_AP_OPT_PASSWORD Get Password for for AP mode (for WEP or for WPA): Returns password - string, fills up to 64 characters. This options takes _u8 buffer as parameter SL_WLAN_AP_OPT_MAX_STATIONS Get Max AP allowed stations: This options takes _u8 buffer as parameter SL_WLAN_AP_OPT_MAX_STA_AGING Get AP aging time in seconds: This options takes _u16 buffer as parameter SL_WLAN_AP_ACCESS_LIST_NUM_ENTRIES Get AP access list number of entries: This options takes _u8 buffer as parameter SL_WLAN_CFG_AP_ACCESS_LIST_ID The option is the start index in the access list Get the AP access list from start index, the number of entries in the list is extracted from the request length. SL_WLAN_CFG_GENERAL_PARAM_ID SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS Get scan parameters. This option uses SlWlanScanParamCommand_t as parameter SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE Get Country Code for AP mode This options takes _u8 buffer as parameter SL_WLAN_GENERAL_PARAM_OPT_STA_TX_POWER Get STA mode Tx power level Number between 0-15, as dB offset from max power (0 indicates MAX power) This options takes _u8 as parameter SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER Get AP mode Tx power level Number between 0-15, as dB offset from max power (0 indicates MAX power) This options takes _u8 as parameter SL_WLAN_CFG_P2P_PARAM_ID SL_WLAN_P2P_OPT_CHANNEL_N_REGS Get P2P Channels. listen channel (either 1/6/11 for 2.4GHz) listen regulatory class (81 for 2.4GHz) oper channel (either 1/6/11 for 2.4GHz) oper regulatory class (81 for 2.4GHz) listen channel and regulatory class will determine the device listen channel during p2p find listen phase 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) 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. This option takes pointer to _u8[4] as parameter SL_WLAN_RX_FILTERS_ID SL_WLAN_RX_FILTER_STATE Retrieves the filters enable/disable status. The buffer input is SlWlanRxFilterRetrieveStateBuff_t SL_WLAN_RX_FILTER_SYS_STATE Retrieves the system filters enable/disable status. The buffer input is SlWlanRxFilterSysFiltersRetrieveStateBuff_t:
[out]	pConfigLen	- The length of the allocated memory as input, when the function complete, the value of this parameter would be the len that actually read from the device. If the device return length that is longer from the input value, the function will cut the end of the returned structure and will return SL_ESMALLBUF.
[out]	pValues	- get configurations values

Returns: Zero on success, or negative error code on failure

See also: sl_WlanSet

Note: In case the device was started as AP mode, but no SSID was set, the Get SSID will return "mysimplelink" and not "mysimplelink-xxyyzz"

Warning

Examples

SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS:
1 SlWlanScanParamCommand_t ScanParamConfig;

2 _u16 Option = SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS;

3 _u16 OptionLen = sizeof(SlWlanScanParamCommand_t);

4 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(_u8 *)&ScanParamConfig);
SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER:
1 _i32 TXPower = 0;

2 _u16 Option = SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER;

3 _u16 OptionLen = sizeof(TXPower);

4 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(_u8 *)&TXPower);
SL_WLAN_GENERAL_PARAM_OPTSTA_TX_POWER:
1 _i32 TXPower = 0;

2 _u16 Option = SL_WLAN_GENERAL_PARAM_OPT_STA_TX_POWER;

3 _u16 OptionLen = sizeof(TXPower);

4 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID ,&Option,&OptionLen,(_u8 *)&TXPower);
SL_WLAN_P2P_OPT_DEV_TYPE:
1 _i8 device_type[18];

2 _u16 len = 18;

3 _u16 config_opt = SL_WLAN_P2P_OPT_DEV_TYPE;

4 sl_WlanGet(SL_WLAN_CFG_P2P_PARAM_ID, &config_opt , &len, (_u8* )device_type);
SL_WLAN_AP_OPT_SSID:
1 _i8 ssid[33];

2 _u16 len = 33;

3 sl_Memset(ssid,0,33);

4 _u16 config_opt = SL_WLAN_AP_OPT_SSID;

5 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt , &len, (_u8* )ssid);
SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE:
1 _i8 country[3];

2 _u16 len = 3;

3 _u16 config_opt = SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE;

4 sl_WlanGet(SL_WLAN_CFG_GENERAL_PARAM_ID, &config_opt, &len, (_u8* )country);
SL_WLAN_AP_OPT_CHANNEL:
1 _i8 channel;

2 _u16 len = 1;

3 _u16 config_opt = SL_WLAN_AP_OPT_CHANNEL;

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8* )&channel);
SL_WLAN_AP_OPT_HIDDEN_SSID:
1 _u8 hidden;

2 _u16 len = 1;

3 _u16 config_opt = SL_WLAN_AP_OPT_HIDDEN_SSID;

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8* )&hidden);
SL_WLAN_AP_OPT_SECURITY_TYPE:
1 _u8 sec_type;

2 _u16 len = 1;

3 _u16 config_opt = SL_WLAN_AP_OPT_SECURITY_TYPE;

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8* )&sec_type);
SL_WLAN_AP_OPT_PASSWORD:
1 _u8 password[64];

2 _u16 len = 64;

3 sl_Memset(password,0,64);

4 _u16 config_opt = SL_WLAN_AP_OPT_PASSWORD;

5 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8* )password);
SL_WLAN_AP_OPT_MAX_STATIONS:
1 _u8 max_ap_stations

2 _u16 len = 1;

3 _u16 config_opt = SL_WLAN_AP_OPT_MAX_STATIONS;

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8 *)&max_ap_stations);
SL_WLAN_AP_OPT_MAX_STA_AGING:
1 _u16 ap_sta_aging;

2 _u16 len = 2;

3 _u16 config_opt = SL_WLAN_AP_OPT_MAX_STA_AGING;

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8 *)&ap_sta_aging);
SL_WLAN_AP_ACCESS_LIST_NUM_ENTRIES:
1 _u8 aclist_num_entries;

2 _u16 config_opt = SL_WLAN_AP_ACCESS_LIST_NUM_ENTRIES;

3 _u16 len = sizeof(aclist_num_entries);

4 sl_WlanGet(SL_WLAN_CFG_AP_ID, &config_opt, &len, (_u8 *)&aclist_num_entries);
SL_WLAN_CFG_AP_ACCESS_LIST_ID:
1 _u8 aclist_mac[SL_WLAN_MAX_ACCESS_LIST_STATIONS][MAC_LEN];

2 unsigned char aclist_num_entries;

3 unsigned short config_opt;

4 unsigned short len;

5 int actual_aclist_num_entries;

6 unsigned short start_aclist_index;

7 unsigned short aclist_info_len;

8 int i;

9

10 start_aclist_index = 0;

11 aclist_info_len = 2*MAC_LEN;

12 sl_WlanGet(SL_WLAN_CFG_AP_ACCESS_LIST_ID, &start_aclist_index, &aclist_info_len, (_u8 *)&aclist_mac[start_aclist_index]);

13

14 actual_aclist_num_entries = aclist_info_len / MAC_LEN;

15 printf("-Print AP Deny list, num stations = %d\n", actual_aclist_num_entries);

16 for (i=0; i<actual_aclist_num_entries; i++)

17 {

18 _u8 *pMac = aclist_mac[i+start_aclist_index];

19 printf(" MAC %d: %02x:%02x:%02x:%02x:%02x:%02x\n", i, pMac[0], pMac[1], pMac[2], pMac[3], pMac[4], pMac[5]);

20 }
SL_WLAN_P2P_OPT_CHANNEL_N_REGS:
1 _u16 listen_channel,listen_reg,oper_channel,oper_reg;

2 _u16 len = 4;

3 _u16 config_opt = SL_WLAN_P2P_OPT_CHANNEL_N_REGS;

4 _u8 channel_n_regs[4];

5 sl_WlanGet(SL_WLAN_CFG_P2P_PARAM_ID, &config_opt, &len, (_u8* )channel_n_regs);

6 listen_channel = channel_n_regs[0];

7 listen_reg = channel_n_regs[1];

8 oper_channel = channel_n_regs[2];

9 oper_reg = channel_n_regs[3];
SL_WLAN_RX_FILTER_STATE:
1 int ret = 0;

2 SlWlanRxFilterIdMask_t FilterIdMask;

3 _u16 len = sizeof(SlWlanRxFilterIdMask_t);;

4 _u16 config_opt = SL_WLAN_RX_FILTER_STATE;

5 memset(FilterIdMask,0,sizeof(FilterIdMask));

6 ret = sl_WlanGet(SL_WLAN_RX_FILTERS_ID, &config_opt , &len, (_u8* )FilterIdMask);
SL_WLAN_RX_FILTER_SYS_STATE:
1 int ret = 0;

2 SlWlanRxFilterSysFiltersMask_t FilterSysIdMask;

3 _u16 len = sizeof(SlWlanRxFilterSysFiltersMask_t);;

4 _u16 config_opt = SL_WLAN_RX_FILTER_SYS_STATE;

5 memset(FilterSysIdMask,0,sizeof(FilterSysIdMask));

6 ret = sl_WlanGet(SL_WLAN_RX_FILTERS_ID, &config_opt , &len, (_u8* )FilterSysIdMask);
SL_WLAN_CONNECTION_INFO:
1 _i16 RetVal = 0 ;

2 _u16 Len = sizeof(SlWlanConnStatusParam_t) ;

3 SlWlanConnStatusParam_t WlanConnectInfo ;

4 RetVal = sl_WlanGet(SL_WLAN_CONNECTION_INFO, NULL , &Len, (_u8*)&WlanConnectInfo);

_i16 sl_WlanGetNetworkList	(	const _u8	Index,
		const _u8	Count,
		SlWlanNetworkEntry_t *	pEntries
	)

Gets the WLAN scan operation results.

Gets scan results , gets entry from scan result table

Parameters

[in]	Index	Starting index identifier (range 0-29) for getting scan results
[in]	Count	How many entries to fetch. Max is (30-"Index").
[out]	pEntries	Pointer to an allocated SlWlanNetworkEntry_t. The number of array items should match "Count" sec_type: SL_WLAN_SCAN_SEC_TYPE_OPEN SL_WLAN_SCAN_SEC_TYPE_WEP SL_WLAN_SCAN_SEC_TYPE_WPA SL_WLAN_SCAN_SEC_TYPE_WPA2

Returns: Number of valid networks list items

See also

Note: belongs to ext_api

Warning: This command do not initiate any active scanning action

Example

Fetching max 10 results:
1 SlWlanNetworkEntry_t netEntries[10];

2 _u8 i;

3 _i16 resultsCount = sl_WlanGetNetworkList(0,10,&netEntries[0]);

4 for(i=0; i< resultsCount; i++)

5 {

6 printf("%d. ",i+1);

7 printf("SSID: %.32s ",netEntries[i].Ssid);

8 printf("BSSID: %x:%x:%x:%x:%x:%x ",netEntries[i].Bssid[0],netEntries[i].Bssid[1],netEntries[i].Bssid[2],netEntries[i].Bssid[3],netEntries[i].Bssid[4],netEntries[i].Bssid[5]);

9 printf("Channel: %d ",netEntries[i].Channel);

10 printf("RSSI: %d ",netEntries[i].Rssi);

11 printf("Security type: %d ",SL_WLAN_SCAN_RESULT_SEC_TYPE_BITMAP(netEntries[i].SecurityInfo));

12 printf("Group Cipher: %d ",SL_WLAN_SCAN_RESULT_GROUP_CIPHER(netEntries[i].SecurityInfo));

13 printf("Unicast Cipher bitmap: %d ",SL_WLAN_SCAN_RESULT_UNICAST_CIPHER_BITMAP(netEntries[i].SecurityInfo));

14 printf("Key Mgmt suites bitmap: %d ",SL_WLAN_SCAN_RESULT_KEY_MGMT_SUITES_BITMAP(netEntries[i].SecurityInfo));

15 printf("Hidden SSID: %d\r\n",SL_WLAN_SCAN_RESULT_HIDDEN_SSID(netEntries[i].SecurityInfo));

16 }

_i16 sl_WlanPolicyGet	(	const _u8	Type,
		_u8 *	pPolicy,
		_u8 *	pVal,
		_u8 *	pValLen
	)

Get policy values.

Parameters

[in]	Type	SL_WLAN_POLICY_CONNECTION SL_WLAN_POLICY_SCAN SL_WLAN_POLICY_PM, SL_WLAN_POLICY_P2P
[out]	pPolicy	argument may be set to any value
[out]	pVal	The returned values, depends on each policy type, will be stored in the allocated buffer pointed by pVal with a maximum buffer length set by the calling function and pointed to by argument *pValLen
[out]	pValLen	actual value lenght

Returns: Zero on success, or negative error code on failure

See also: sl_WlanPolicySet

Note: belongs to ext_api

Warning: The value pointed by the argument *pValLen should be set to a value different from 0 and greater than the buffer length returned from the SL device. Otherwise, an error will be returned.

Example

SL_WLAN_POLICY_CONNECTION - Get connection policy:
1 _u8 Policy = 0;

2 int length = sizeof(PolicyOption);

3 int ret;

4 ret = sl_WlanPolicyGet(SL_WLAN_POLICY_CONNECTION ,&Policy,0,(_u8*)&length);

5

6 if (Policy & SL_WLAN_CONNECTION_POLICY( 1 , 1 , 0 , 0 ) )

7 {

8 printf("Connection Policy is set to Auto + Fast");

9 }
SL_WLAN_POLICY_SCAN - Get scan policy:
1 int ScanInterval = 0; //default value is 600 seconds

2 _u8 Policy = 0; //default value is 0 (disabled)

3 int ret;

4 length = sizeof(ScanInterval);

5 ret = sl_WlanPolicyGet(SL_WLAN_POLICY_SCAN ,&Policy,(_u8*)&ScanInterval,(_u8*)&length);

6

7 if (Policy & SL_WLAN_SCAN_POLICY( 0 , 1 ) )

8 {

9 printf("Scan Policy is set to Scan visible ssid ");

10 }

11 if (Policy & SL_WLAN_SCAN_POLICY( 1 , 0 ) )

12 {

13 printf("Scan Policy is set to Scan hidden ssid ");

14 }
SL_WLAN_POLICY_PM - Get power management policy:
1 _u8 Policy = 0;

2 int ret;

3 SlWlanPmPolicyParams_t PmPolicyParams;

4 length = sizeof(PmPolicyParams);

5 ret = sl_WlanPolicyGet(SL_POLICY_PM ,&Policy,&PmPolicyParams,(_u8*)&length);

6 if (Policy == SL_WLAN_LONG_SLEEP_INTERVAL_POLICY )

7 {

8 printf("Connection Policy is set to LONG SLEEP INTERVAL POLICY with inteval = %d ",PmPolicyParams.MaxSleepTimeMs);

9 }
SL_WLAN_POLICY_P2P - Get P2P policy:
1 _u8 Policy = 0;

2 int ret;

3 length = sizeof(Policy);

4 ret = sl_WlanPolicyGet(SL_WLAN_POLICY_P2P ,&Policy,0,(_u8*)&length);

5 //SL_WLAN_P2P_POLICY(p2pNegType , p2pNegInitiator)

6 if (Policy & SL_WLAN_P2P_POLICY(0,SL_WLAN_P2P_NEG_INITIATOR_RAND_BACKOFF) )

7 {

8 printf("P2P Policy is set to Rand backoff");

9 }

10 if (Policy & SL_WLAN_P2P_POLICY(SL_WLAN_P2P_ROLE_NEGOTIATE,0) )

11 {

12 printf("P2P Policy is set to Role Negotiate");

13 }

_i16 sl_WlanPolicySet	(	const _u8	Type,
		const _u8	Policy,
		_u8 *	pVal,
		const _u8	ValLen
	)

Set policy values.

Parameters

[in]	Type	Type of policy to be modified. The Options are: SL_WLAN_POLICY_CONNECTION SL_WLAN_POLICY_SCAN SL_WLAN_POLICY_PM SL_WLAN_POLICY_P2P
[in]	Policy	The option value which depends on action type
[in]	pVal	An optional value pointer
[in]	ValLen	An optional value length, in bytes

Returns: Zero on success or negative error code on failure.

Persistent: All parameters are System Persistent
Note that for SL_WLAN_POLICY_SCAN - only the interval will be saved.

See also: sl_WlanPolicyGet

Note: belongs to ext_api

Warning

Example

SL_WLAN_POLICY_CONNECTION:
defines options available to connect the CC31xx device to the AP: The options below could be combined to a single action, if more than one action is required.

Auto Connect: If 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. To set this option, use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_CONNECTION,SL_WLAN_CONNECTION_POLICY(1,0,0,0),NULL,0)
Fast Connect: If is set, the CC31xx device tries to establish a fast connection to AP. To set this option, use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_CONNECTION,SL_WLAN_CONNECTION_POLICY(0,1,0,0),NULL,0)
P2P: If is set (relevant for P2P mode only), CC31xx/CC32xx device tries to automatically connect to the first P2P device available, supporting push button only. To set this option, use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_CONNECTION,SL_WLAN_CONNECTION_POLICY(0,0,1,0),NULL,0)
Auto Provisioning - If is set, the CC31xx device will automatically start the provisioning process after a long period of disconnection when profiles exist to set this option, use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_CONNECTION,SL_WLAN_CONNECTION_POLICY(0,0,0,1),NULL,0)

SL_WLAN_POLICY_SCAN:
defines system scan time interval. interval is 10 minutes. After settings scan interval, an immediate scan is activated.
The next scan will be based on the interval settings. For AP scan, minimun interval is 10 seconds.

With hidden SSID: For example, setting scan interval to 1 minute interval use including hidden ssid:
1 _u32 intervalInSeconds = 60;

2 sl_WlanPolicySet(SL_WLAN_POLICY_SCAN,SL_WLAN_SCAN_POLICY(1,1), (_u8 *)&intervalInSeconds,sizeof(intervalInSeconds));
No hidden SSID: setting scan interval to 1 minute interval use, not including hidden ssid:
1 _u32 intervalInSeconds = 60;

2 sl_WlanPolicySet(SL_WLAN_POLICY_SCAN,SL_WLAN_SCAN_POLICY(1,0), (_u8 *)&intervalInSeconds,sizeof(intervalInSeconds));
Disable scan:
1 #define SL_WLAN_DISABLE_SCAN 0

2 _u32 intervalInSeconds = 0;

3 sl_WlanPolicySet(SL_WLAN_POLICY_SCAN,SL_WLAN_DISABLE_SCAN,(_u8 *)&intervalInSeconds,sizeof(intervalInSeconds));

SL_WLAN_POLICY_PM:
defines a power management policy for Station mode only:

Normal power management (default) policy use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_PM , SL_WLAN_NORMAL_POLICY, NULL,0)
Low latency power management policy use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_PM , SL_WLAN_LOW_LATENCY_POLICY, NULL,0)
Low power management policy use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_PM , SL_WLAN_LOW_POWER_POLICY, NULL,0)
Always on power management policy use:
1 sl_WlanPolicySet(SL_WLAN_POLICY_PM , SL_WLAN_ALWAYS_ON_POLICY, NULL,0)
Long Sleep Interval policy use:
1 SlWlanPmPolicyParams_t PmPolicyParams;

2 memset(&PmPolicyParams,0,sizeof(SlWlanPmPolicyParams_t));

3 PmPolicyParams.MaxSleepTimeMs = 800; //max sleep time in mSec

4 sl_WlanPolicySet(SL_WLAN_POLICY_PM , SL_WLAN_LONG_SLEEP_INTERVAL_POLICY, (_u8*)&PmPolicyParams,sizeof(PmPolicyParams));

SL_WLAN_POLICY_P2P:
defines p2p negotiation policy parameters for P2P role:

To set intent negotiation value, set on of the following:
SL_WLAN_P2P_ROLE_NEGOTIATE - intent 3
SL_WLAN_P2P_ROLE_GROUP_OWNER - intent 15
SL_WLAN_P2P_ROLE_CLIENT - intent 0
To set negotiation initiator value (initiator policy of first negotiation action frame), set on of the following:
SL_WLAN_P2P_NEG_INITIATOR_ACTIVE
SL_WLAN_P2P_NEG_INITIATOR_PASSIVE
SL_WLAN_P2P_NEG_INITIATOR_RAND_BACKOFF

1 sl_WlanPolicySet(SL_WLAN_POLICY_P2P, SL_WLAN_P2P_POLICY(SL_WLAN_P2P_ROLE_NEGOTIATE,SL_WLAN_P2P_NEG_INITIATOR_RAND_BACKOFF),NULL,0);

_i16 sl_WlanProfileAdd	(	const _i8 *	pName,
		const _i16	NameLen,
		const _u8 *	pMacAddr,
		const SlWlanSecParams_t *	pSecParams,
		const SlWlanSecParamsExt_t *	pSecExtParams,
		const _u32	Priority,
		const _u32	Options
	)

Add profile.

When auto start is enabled, the device connects to a station from the profiles table. Up to 7 profiles (SL_WLAN_MAX_PROFILES) are supported.
If several profiles configured the device chose the highest priority profile, within each priority group, device will chose profile based on security policy, signal strength, etc parameters.

Parameters

[in]	pName	Up to 32 bytes in case of STA the name is the SSID of the Access Point. In case of P2P the name is the remote device name.
[in]	NameLen	Name length
[in]	pMacAddr	6 bytes for MAC address
[in]	pSecParams	Security parameters (use NULL key for SL_WLAN_SEC_TYPE_OPEN) Security types options: SL_WLAN_SEC_TYPE_OPEN SL_WLAN_SEC_TYPE_WEP SL_WLAN_SEC_TYPE_WEP_SHARED SL_WLAN_SEC_TYPE_WPA_WPA2 SL_WLAN_SEC_TYPE_WPA_ENT SL_WLAN_SEC_TYPE_WPS_PBC SL_WLAN_SEC_TYPE_WPS_PIN
[in]	pSecExtParams	Enterprise parameters - identity, identity length, Anonymous, Anonymous length, CertIndex (not supported, certificates need to be placed in a specific file ID), EapMethod. Use NULL in case Enterprise parameters is not in use
[in]	Priority	Profile priority. Lowest priority: 0, Highest priority: 15.
[in]	Options	Not supported

Returns: Profile stored index on success, or negative error code on failure.

Persistent: Profiles are Persistent

See also: sl_WlanProfileGet , sl_WlanProfileDel

Note: belongs to ext_api

Warning: Only one Enterprise profile is supported.
Please Note that in case of adding an existing profile (compared by pName,pMACAddr and security type) the old profile will be deleted and the same index will be returned.
SL_WLAN_SEC_TYPE_WPA is a deprecated definition, the new definition is SL_WLAN_SEC_TYPE_WPA_WPA2

_i16 sl_WlanProfileDel ( const _i16 Index )

Delete WLAN profile.

Delete WLAN profile

Parameters

[in] Index number of profile to delete. Possible values are 0 to 6.
Index value SL_WLAN_DEL_ALL_PROFILES will delete all saved profiles

Returns: Zero on success or a negative error code on failure

Persistent: Profile deletion is Persistent

See also: sl_WlanProfileAdd , sl_WlanProfileGet

Note: belongs to ext_api

Warning

_i16 sl_WlanProfileGet	(	const _i16	Index,
		_i8 *	pName,
		_i16 *	pNameLen,
		_u8 *	pMacAddr,
		SlWlanSecParams_t *	pSecParams,
		SlWlanGetSecParamsExt_t *	pSecExtParams,
		_u32 *	pPriority
	)

Get profile.

Read profile from the device

Parameters

[in]	Index	Profile stored index, if index does not exists error is return
[out]	pName	Up to 32 bytes, in case of sta mode the name of the Access Point In case of p2p mode the name of the Remote Device
[out]	pNameLen	Name length
[out]	pMacAddr	6 bytes for MAC address
[out]	pSecParams	Security parameters. Security types options: SL_WLAN_SEC_TYPE_OPEN SL_WLAN_SEC_TYPE_WEP SL_WLAN_SEC_TYPE_WEP_SHARED SL_WLAN_SEC_TYPE_WPA_WPA2 SL_WLAN_SEC_TYPE_WPA_ENT SL_WLAN_SEC_TYPE_WPS_PBC SL_WLAN_SEC_TYPE_WPS_PIN Key and key length are not return. In case of p2p security type pin the key refers to pin code return due to security reasons.
[out]	pSecExtParams	Enterprise parameters - identity, identity length, Anonymous, Anonymous length CertIndex (not supported), EapMethod.
[out]	pPriority	Profile priority

Returns: Profile security type is returned (0 or positive number) on success, or negative error code on failure

See also: sl_WlanProfileAdd , sl_WlanProfileDel

Note: belongs to ext_api

Warning

_i16 sl_WlanProvisioning	(	_u8	ProvisioningCmd,
		_u8	RequestedRoleAfterSuccess,
		_u16	InactivityTimeoutSec,
		char *	pSmartConfigKey,
		_u32	Flags
	)

The simpleLink will switch to the appropriate role according to the provisioning mode requested and will start the provisioning process.

Parameters

[in]	ProvisioningCmd	SL_WLAN_PROVISIONING_CMD_START_MODE_AP 0: Start AP provisioning (AP role) SL_WLAN_PROVISIONING_CMD_START_MODE_SC 1: Start Smart Config provisioning (STA role) SL_WLAN_PROVISIONING_CMD_START_MODE_APSC 2: Start AP+Smart Config provisioning (AP role) SL_WLAN_PROVISIONING_CMD_START_MODE_APSC_EXTERNAL_CONFIGURATION 3: Start AP + Smart Config + WAC provisioning (AP role) SL_WLAN_PROVISIONING_CMD_STOP 4: Stop provisioning SL_WLAN_PROVISIONING_CMD_ABORT_EXTERNAL_CONFIGURATIONC 5:
[in]	RequestedRoleAfterSuccess	The role that the simplelink will switch to in case of a successful provisioning. 0: STA 2: AP 0xFF: stay in current role (relevant only in provisioning_stop)
[in]	InactivityTimeoutSec	- The period of time (in seconds) the system waits before it automatically stops the provisioning process when no activity is detected. set to 0 in order to stop provisioning. Minimum InactivityTimeoutSec is 30 seconds.
[in]	pSmartConfigKey	Smart Config key: public key for smart config process (relevent for smart config only)
[in]	Flags	Can have the following values: SL_WLAN_PROVISIONING_CMD_FLAG_EXTERNAL_CONFIRMATION - Confirmation phase will be completed externaly by host (e.g. via cloud assist)

Returns: Zero on success, or negative error code on failure

See also

Warning

Example

Start Provisioning - start as STA after success with inactivity timeout of 10 minutes:
1 sl_WlanProvisioning(SL_WLAN_PROVISIONING_CMD_START_MODE_APSC, ROLE_STA, 600, "Key0Key0Key0Key0", 0x0);
Stop Provisioning:
1 sl_WlanProvisioning(SL_WLAN_PROVISIONING_CMD_STOP,0xFF,0,NULL, 0x0);
Start AP Provisioning with inactivity timeout of 10 minutes
1 sl_WlanProvisioning(SL_WLAN_PROVISIONING_CMD_START_MODE_APSC,ROLE_AP,600,NULL, 0x0);
Start AP Provisioning with inactivity timeout of 10 minutes and complete confirmation via user cloud assist
1 sl_WlanProvisioning(SL_WLAN_PROVISIONING_CMD_START_MODE_APSC, ROLE_AP, 600, NULL, SL_WLAN_PROVISIONING_CMD_FLAG_EXTERNAL_CONFIRMATION);

_i16 sl_WlanRxFilterAdd	(	SlWlanRxFilterRuleType_t	RuleType,
		SlWlanRxFilterFlags_u	Flags,
		const SlWlanRxFilterRule_u *const	pRule,
		const SlWlanRxFilterTrigger_t *const	pTrigger,
		const SlWlanRxFilterAction_t *const	pAction,
		SlWlanRxFilterID_t *	pFilterId
	)

Adds new filter rule to the system.

Parameters

[in]	RuleType	The rule type SL_WLAN_RX_FILTER_HEADER SL_WLAN_RX_FILTER_COMBINATION
[in]	Flags	Flags which set the type of header rule Args and sets the persistent flag SL_WLAN_RX_FILTER_BINARY SL_WLAN_RX_FILTER_PERSISTENT SL_WLAN_RX_FILTER_ENABLE
[in]	pRule	Determine the filter rule logic
[in]	pTrigger	Determine when the rule is triggered also sets rule parent.
[in]	pAction	Sets the action to be executed in case the match functions pass
[out]	pFilterId	The filterId which was created

Persistent: Save the filters for persistent can be done by calling with SL_WLAN_RX_FILTER_STORE

Returns: Zero on success, or negative error code on failure

See also

Note

Warning

_i16 sl_WlanRxStatGet	(	SlWlanGetRxStatResponse_t *	pRxStat,
		const _u32	Flags
	)

Get wlan RX statistics. Upon calling this command, the statistics counters will be cleared.

Parameters

[in]	pRxStat	Pointer to SlWlanGetRxStatResponse_t filled with Rx statistics results
[in]	Flags	Should be 0 ( not applicable right now, will be added the future )

Returns: Zero on success, or negative error code on failure

See also: sl_WlanRxStatStart sl_WlanRxStatStop

Note: Belongs to ext_api

Warning

_i16 sl_WlanRxStatStart ( void )

Start collecting wlan RX statistics, for unlimited time.

Parameters: None

Returns: Zero on success, or negative error code on failure

See also: sl_WlanRxStatStop sl_WlanRxStatGet

Note: Belongs to ext_api

Warning: This API is deprecated and should be removed for next release

Example

Getting wlan RX statistics:
1 void RxStatCollectTwice()

2 {

3 SlWlanGetRxStatResponse_t rxStat;

4 _i16 rawSocket;

5 _i8 DataFrame[200];

6 struct SlTimeval_t timeval;

7 timeval.tv_sec = 0; // Seconds

8 timeval.tv_usec = 20000; // Microseconds. 10000 microseconds resolution

9

10 sl_WlanRxStatStart(); // set statistics mode

11

12 rawSocket = sl_Socket(SL_AF_RF, SL_SOCK_RAW, eChannel);

13 // set timeout - in case we have no activity for the specified channel

14 sl_SetSockOpt(rawSocket,SL_SOL_SOCKET,SL_SO_RCVTIMEO, &timeval, sizeof(timeval)); // Enable receive timeout

15 status = sl_Recv(rawSocket, DataFrame, sizeof(DataFrame), 0);

16

17 Sleep(1000); // sleep for 1 sec

18 sl_WlanRxStatGet(&rxStat,0); // statistics has been cleared upon read

19 Sleep(1000); // sleep for 1 sec

20 sl_WlanRxStatGet(&rxStat,0);

21

22 }

_i16 sl_WlanRxStatStop ( void )

Stop collecting wlan RX statistic, (if previous called sl_WlanRxStatStart)

Parameters: None

Returns: Zero on success, or negative error code on failure

See also: sl_WlanRxStatStart sl_WlanRxStatGet

Note: Belongs to ext_api

Warning: This API is deprecated and should be removed for next release

_i16 sl_WlanSet	(	const _u16	ConfigId,
		const _u16	ConfigOpt,
		const _u16	ConfigLen,
		const _u8 *	pValues
	)

Setting WLAN configurations.

Parameters

[in]	ConfigId	- configuration id SL_WLAN_CFG_AP_ID SL_WLAN_CFG_GENERAL_PARAM_ID SL_WLAN_CFG_P2P_PARAM_ID SL_WLAN_RX_FILTERS_ID
[in]	ConfigOpt	- configurations option SL_WLAN_CFG_AP_ID SL_WLAN_AP_OPT_SSID Set SSID for AP mode. This options takes _u8 buffer as parameter SL_WLAN_AP_OPT_CHANNEL Set channel for AP mode. 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] This option takes _u8 as a parameter SL_WLAN_AP_OPT_HIDDEN_SSID Set Hidden SSID Mode for AP mode.Hidden options: 0: disabled 1: Send empty (length=0) SSID in beacon and ignore probe request for broadcast SSID 2: Clear SSID (ASCII 0), but keep the original length (this may be required with some clients that do not support empty SSID) and ignore probe requests for broadcast SSID This option takes _u8 as a parameter SL_WLAN_AP_OPT_SECURITY_TYPE Set Security type for AP mode. Security options are: Open security: SL_WLAN_SEC_TYPE_OPEN WEP security: SL_WLAN_SEC_TYPE_WEP WPA security: SL_WLAN_SEC_TYPE_WPA_WPA2 This option takes _u8 pointer as a parameter SL_WLAN_AP_OPT_PASSWORD Set Password for for AP mode (for WEP or for WPA): Password - for WPA: 8 - 63 characters for WEP: 5 / 13 characters (ascii) This options takes _u8 buffer as parameter SL_WLAN_AP_OPT_MAX_STATIONS Set Max AP stations - 1..4 - Note: can be less than the number of currently connected stations max_stations - 1 characters This options takes _u8 buffer as parameter SL_WLAN_AP_OPT_MAX_STA_AGING Set Max station aging time - default is 60 seconds max_stations - 2 characters This options takes _u16 buffer as parameter SL_WLAN_AP_ACCESS_LIST_MODE Set AP access list mode - DISABLE, DENY_LIST mode - 1 characters This options takes _u8 buffer as parameter SL_WLAN_AP_ACCESS_LIST_ADD_MAC Add MAC address to the AP access list: mac_addr - 6 characters This options takes _u8 buffer as parameter SL_WLAN_AP_ACCESS_LIST_DEL_MAC Del MAC address from the AP access list: mac_addr - 6 characters This options takes _u8 buffer as parameter SL_WLAN_AP_ACCESS_LIST_DEL_IDX Delete MAC address from index in the AP access list: index - 1 character This options takes _u8 buffer as parameter SL_WLAN_CFG_GENERAL_PARAM_ID SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE Set Country Code for AP mode This options takes _u8 2 bytes buffer as parameter SL_WLAN_GENERAL_PARAM_OPT_STA_TX_POWER Set STA mode Tx power level Number between 0-15, as dB offset from max power (0 will set MAX power) This options takes _u8 as parameter SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER Set AP mode Tx power level Number between 0-15, as dB offset from max power (0 will set MAX power) This options takes _u8 as parameter SL_WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT Set Info Element for AP mode. The Application can set up to SL_WLAN_MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED info elements per Role (AP / P2P GO). To delete an info element use the relevant index and length = 0. For AP - no more than SL_WLAN_INFO_ELEMENT_MAX_TOTAL_LENGTH_AP bytes can be stored for all info elements. For P2P GO - no more than SL_WLAN_INFO_ELEMENT_MAX_TOTAL_LENGTH_P2P_GO bytes can be stored for all info elements. This option takes SlWlanSetInfoElement_t as parameter SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS Set scan parameters: RSSI threshold and channel mask. SL_WLAN_GENERAL_PARAM_OPT_SUSPEND_PROFILES Set suspended profiles mask (set bits 2 and 4 to suspend profiles 2 and 4). SL_WLAN_GENERAL_PARAM_DISABLE_ENT_SERVER_AUTH This option enables to skip server authentication and is valid for one use, when manually connection to an enterprise network

                  - <b>SL_WLAN_CFG_P2P_PARAM_ID</b>
                      - <b>SL_WLAN_P2P_OPT_DEV_TYPE</b> \n
                              Set P2P Device type.Maximum length of 17 characters. Device type is published under P2P I.E, \n
                              allows to make devices easier to recognize. \n
                              In case no device type is set, the default type is "1-0050F204-1"  \n
                              This options takes <b>_u8</b> buffer as parameter
                      - <b>SL_WLAN_P2P_OPT_CHANNEL_N_REGS</b> \n
                             Set P2P Channels. \n
                             listen channel (either 1/6/11 for 2.4GHz) \n
                             listen regulatory class (81 for 2.4GHz)   \n
                             oper channel (either 1/6/11 for 2.4GHz)   \n
                             oper regulatory class (81 for 2.4GHz)     \n
                             listen channel and regulatory class will determine the device listen channel during p2p find listen phase \n
                             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
                             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.
                             This option takes pointer to <b>_u8[4]</b> as parameter

                  - <b>SL_WLAN_RX_FILTERS_ID</b>
                      - <b>SL_WLAN_RX_FILTER_STATE</b> \n
                              Enable or disable filters. The buffer input is SlWlanRxFilterOperationCommandBuff_t\n
                      - <b>SL_WLAN_RX_FILTER_SYS_STATE</b> \n
                              Enable or disable system filters. The buffer input is SlWlanRxFilterSysFiltersSetStateBuff_t\n
                      - <b>SL_WLAN_RX_FILTER_REMOVE</b> \n
                              Remove filters. The buffer input is SlWlanRxFilterOperationCommandBuff_t\n
                      - <b>SL_WLAN_RX_FILTER_STORE</b> \n
                              Save the filters as persistent. \n
                      - <b>SL_WLAN_RX_FILTER_UPDATE_ARGS</b> \n
                              Update filter arguments. The buffer input is SlWlanRxFilterUpdateArgsCommandBuff_t\n

Parameters

[in]	ConfigLen	- configurations len
[in]	pValues	- configurations values

Returns: Zero on success, or negative error code on failure

Persistent

System Persistent:

SL_WLAN_CFG_GENERAL_PARAM_ID
SL_WLAN_CFG_P2P_PARAM_ID

Reset:

SL_WLAN_CFG_AP_ID

Non- Persistent:

SL_WLAN_GENERAL_PARAM_DISABLE_ENT_SERVER_AUTH
See also

Note

Warning

Examples

SL_WLAN_AP_OPT_SSID:

 _u8  str[33];
 memset(str, 0, 33);
 memcpy(str, ssid, len);  // ssid string of 32 characters
 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_SSID, strlen(ssid), str);

SL_WLAN_AP_OPT_CHANNEL:
1 _u8 val = channel;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_CHANNEL, 1, (_u8 *)&val);
SL_WLAN_AP_OPT_HIDDEN_SSID:
1 _u8 val = hidden;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_HIDDEN_SSID, 1, (_u8 *)&val);
SL_WLAN_AP_OPT_SECURITY_TYPE:
1 _u8 val = SL_WLAN_SEC_TYPE_WPA_WPA2;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_SECURITY_TYPE, 1, (_u8 *)&val);
SL_WLAN_AP_OPT_PASSWORD:
1 _u8 str[65];

2 _u16 len = strlen(password);

3 memset(str, 0, 65);

4 memcpy(str, password, len);

5 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_PASSWORD, len, (_u8 *)str);
SL_WLAN_AP_OPT_MAX_STATIONS:
1 _u8 max_ap_stations = 3;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_MAX_STATIONS, sizeof(max_ap_stations), (_u8 *)&max_ap_stations);
SL_WLAN_AP_OPT_MAX_STA_AGING:
1 _u16 max_ap_sta_aging = 60;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_OPT_MAX_STA_AGING, sizeof(max_ap_sta_aging), (_u8 *)&max_ap_sta_aging);
SL_WLAN_AP_ACCESS_LIST_MODE:
1 _u8 access list_mode = SL_WLAN_AP_ACCESS_LIST_MODE_DENY_LIST;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_ACCESS_LIST_MODE, sizeof(access list_mode), (_u8 *)&access list_mode);
SL_WLAN_AP_ACCESS_LIST_ADD_MAC:
1 _u8 sta_mac[6] = { 0x00, 0x22, 0x33, 0x44, 0x55, 0x66 };

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_ACCESS_LIST_ADD_MAC, sizeof(sta_mac), (_u8 *)&sta_mac);
SL_WLAN_AP_ACCESS_LIST_DEL_MAC:
1 _u8 sta_mac[6] = { 0x00, 0x22, 0x33, 0x44, 0x55, 0x66 };

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_ACCESS_LIST_DEL_MAC, sizeof(sta_mac), (_u8 *)&sta_mac);
SL_WLAN_AP_ACCESS_LIST_DEL_IDX:
1 _u8 sta_index = 0;

2 sl_WlanSet(SL_WLAN_CFG_AP_ID, SL_WLAN_AP_ACCESS_LIST_DEL_IDX, sizeof(sta_index), (_u8 *)&sta_index);
SL_WLAN_GENERAL_PARAM_OPT_STA_TX_POWER:
1 _u8 stapower=(_u8)power;

2 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, SL_WLAN_GENERAL_PARAM_OPT_STA_TX_POWER,1,(_u8 *)&stapower);
SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE:
1 _u8* str = (_u8 *) country; // string of 2 characters. i.e. - "US"

2 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, SL_WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE, 2, str);
SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER:
1 _u8 appower=(_u8)power;

2 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, SL_WLAN_GENERAL_PARAM_OPT_AP_TX_POWER,1,(_u8 *)&appower);
SL_WLAN_GENERAL_PARAM_OPT_SUSPEND_PROFILES
1 _u32 suspendedProfilesMask=(_u32)mask;

2 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID, SL_WLAN_GENERAL_PARAM_OPT_SUSPEND_PROFILES,sizeof(suspendedProfilesMask),(_u32 *)&suspendedProfilesMask);
SL_WLAN_P2P_OPT_DEV_TYPE:
1 _u8 str[17];

2 _u16 len = strlen(device_type);

3 memset(str, 0, 17);

4 memcpy(str, device_type, len);

5 sl_WlanSet(SL_WLAN_CFG_P2P_PARAM_ID, SL_WLAN_P2P_OPT_DEV_TYPE, len, str);
SL_WLAN_P2P_OPT_CHANNEL_N_REGS
1 _u8 str[4];

2 str[0] = (_u8)11; // listen channel

3 str[1] = (_u8)81; // listen regulatory class

4 str[2] = (_u8)6; // oper channel

5 str[3] = (_u8)81; // oper regulatory class

6 sl_WlanSet(SL_WLAN_CFG_P2P_PARAM_ID, SL_WLAN_P2P_OPT_CHANNEL_N_REGS, 4, str);
SL_WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT:
1 SlWlanSetInfoElement_t infoele;

2 infoele.Index = Index; // Index of the info element. range: 0 - SL_WLAN_MAX_PRIVATE_INFO_ELEMENTS_SUPPROTED

3 infoele.Role = Role; // SL_WLAN_INFO_ELEMENT_AP_ROLE (0) or SL_WLAN_INFO_ELEMENT_P2P_GO_ROLE (1)

4 infoele.IE.Id = Id; // Info element ID. if SL_WLAN_INFO_ELEMENT_DEFAULT_ID (0) is set, ID will be set to 221.

5 // Organization unique ID. If all 3 bytes are zero - it will be replaced with 08,00,28.

6 infoele.IE.Oui[0] = Oui0; // Organization unique ID first Byte

7 infoele.IE.Oui[1] = Oui1; // Organization unique ID second Byte

8 infoele.IE.Oui[2] = Oui2; // Organization unique ID third Byte

9 infoele.IE.Length = Len; // Length of the info element. must be smaller than 253 bytes

10 memset(infoele.IE.Data, 0, SL_WLAN_INFO_ELEMENT_MAX_SIZE);

11 if ( Len <= SL_WLAN_INFO_ELEMENT_MAX_SIZE )

12 {

13 memcpy(infoele.IE.Data, IE, Len); // Info element. length of the info element is [0-252]

14 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID,SL_WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT,sizeof(SlWlanSetInfoElement_t),(_u8* ) &infoele);

15 }
SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS:
1 SlWlanScanParamCommand_t ScanParamConfig;

2 ScanParamConfig.RssiThershold = -70;

3 ScanParamConfig.ChannelsMask = 0x1FFF;

4 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID,SL_WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS,sizeof(ScanParamConfig),(_u8* ) &ScanParamConfig);
SL_WLAN_GENERAL_PARAM_DISABLE_ENT_SERVER_AUTH:
1 _u8 param = 1; // 1 means disable the server authentication

2 sl_WlanSet(SL_WLAN_CFG_GENERAL_PARAM_ID,SL_WLAN_GENERAL_PARAM_DISABLE_ENT_SERVER_AUTH,1,&param);
SL_WLAN_RX_FILTER_STORE:
1 sl_WlanSet(SL_WLAN_RX_FILTERS_ID, SL_WLAN_RX_FILTER_STORE, 0, NULL);

_i16 sl_WlanSetMode ( const _u8 Mode )

Wlan set mode.

Setting WLAN mode

Parameters

[in]

Mode

WLAN mode to start the CC31xx device. Possible options are

ROLE_STA - for WLAN station mode
ROLE_AP - for WLAN AP mode
ROLE_P2P -for WLAN P2P mode

Returns: Zero on success, or negative error code on failure

Persistent: Mode is Persistent

See also: sl_Start sl_Stop

Note: Belongs to ext_api

Warning: After setting the mode the system must be restarted for activating the new mode

Example

Switch from any role to STA:
1 sl_WlanSetMode(ROLE_STA);

2 sl_Stop(0);

3 sl_Start(NULL,NULL,NULL);

Data Structure Documentation

struct SlWlanSmartConfigStartAsyncResponse_t

Definition at line 436 of file wlan.h.

Data Fields
_u8	PrivateToken[32]
_u32	PrivateTokenLen
_u8	Ssid[32]
_u32	SsidLen
_u32	Status

struct SlWlanSmartConfigStopAsyncResponse_t

Definition at line 445 of file wlan.h.

Data Fields
_u16	Padding
_u16	Status

struct SlWlanConnFailureAsyncResponse_t

Definition at line 451 of file wlan.h.

Data Fields
_u16	Padding
_u16	Status

struct SlWlanProvisioningStatusAsyncResponse_t

Definition at line 457 of file wlan.h.

Data Fields
_u16	Padding
_u16	Status

struct SlWlanEventRxFilterInfo_t

Definition at line 476 of file wlan.h.

Data Fields
_u8	Type
_u8	UserActionIdBitmap[SL_WLAN_RX_FILTER_NUM_USER_EVENT_ID/8]

struct SlWlanEventConnect_t

Definition at line 492 of file wlan.h.

Data Fields
_u8	Bssid[6]
_u8	Padding
_u8	SsidLen
_u8	SsidName[32]

struct SlWlanEventDisconnect_t

Definition at line 500 of file wlan.h.

Data Fields
_u8	Bssid[6]
_u8	ReasonCode
_u8	SsidLen
_u8	SsidName[32]

struct SlWlanEventSTAAdded_t

Definition at line 508 of file wlan.h.

Data Fields
_u8	Mac[6]
_u8	Padding[2]

struct SlWlanEventP2PConnect_t

Definition at line 515 of file wlan.h.

Data Fields
_u8	Bssid[6]
_u8	GoDeviceName[32]
_u8	GoDeviceNameLen
_u8	Padding[3]
_u8	Reserved
_u8	SsidLen
_u8	SsidName[32]

struct SlWlanEventP2PDisconnect_t

Definition at line 526 of file wlan.h.

Data Fields
_u8	Bssid[6]
_u8	GoDeviceName[32]
_u8	GoDeviceNameLen
_u8	Padding[3]
_u8	ReasonCode
_u8	SsidLen
_u8	SsidName[32]

struct SlWlanEventP2PClientAdded_t

Definition at line 540 of file wlan.h.

Data Fields
_u8	ClDeviceName[32]
_u8	ClDeviceNameLen
_u8	Mac[6]
_u8	OwnSsid[32]
_u8	OwnSsidLen

struct SlWlanEventP2PDevFound_t

Definition at line 550 of file wlan.h.

Data Fields
_u8	GoDeviceName[32]
_u8	GoDeviceNameLen
_u8	Mac[6]
_u8	WpsMethod

struct SlWlanEventP2PConnectFail_t

Definition at line 560 of file wlan.h.

Data Fields
_u16	Padding
_u16	Status

struct SlWlanEventProvisioningStatus_t

Definition at line 567 of file wlan.h.

Data Fields
_u8	ProvisioningStatus
_u32	Reserved
_u8	Role
_u8	Ssid[32]
_u8	Ssidlen
_u8	WlanStatus

struct SlWlanEventProvisioningProfileAdded_t

Definition at line 577 of file wlan.h.

Data Fields
_u8	Reserved[32]
_u32	ReservedLen
_u8	Ssid[32]
_u32	SsidLen
_u32	Status

union SlWlanEventData_u

Definition at line 587 of file wlan.h.

Data Fields
SlWlanEventConnect_t	Connect
SlWlanEventDisconnect_t	Disconnect
SlWlanEventP2PClientAdded_t	P2PClientAdded
SlWlanEventP2PClientRemoved_t	P2PClientRemoved
SlWlanEventP2PConnect_t	P2PConnect
SlWlanEventP2PConnectFail_t	P2PConnectFail
SlWlanEventP2PDevFound_t	P2PDevFound
SlWlanEventP2PDisconnect_t	P2PDisconnect
SlWlanEventP2PRequest_t	P2PRequest
SlWlanEventProvisioningProfileAdded_t	ProvisioningProfileAdded
SlWlanEventProvisioningStatus_t	ProvisioningStatus
SlWlanEventRxFilterInfo_t	RxFilterInfo
SlWlanEventSTAAdded_t	STAAdded
SlWlanEventSTARemoved_t	STARemoved

struct SlWlanEvent_t

Definition at line 607 of file wlan.h.

Data Fields
SlWlanEventData_u	Data
_u32	Id

struct SlWlanGetRxStatResponse_t

Definition at line 614 of file wlan.h.

Data Fields
_i16	AvarageDataCtrlRssi
_i16	AvarageMgMntRssi
_u32	GetTimeStamp
_u16	RateHistogram[SL_WLAN_NUM_OF_RATE_INDEXES]
_u32	ReceivedAddressMismatchPacketsNumber
_u32	ReceivedFcsErrorPacketsNumber
_u32	ReceivedValidPacketsNumber
_u16	RssiHistogram[SL_WLAN_SIZE_OF_RSSI_HISTOGRAM]
_u32	StartTimeStamp

struct SlWlanNetworkEntry_t

Definition at line 630 of file wlan.h.

Data Fields
_u8	Bssid[SL_WLAN_BSSID_LENGTH]
_i8	Channel
_i8	Reserved[1]
_i8	Rssi
_i16	SecurityInfo
_u8	Ssid[SL_WLAN_SSID_MAX_LENGTH]
_u8	SsidLen

struct SlWlanSecParams_t

Definition at line 641 of file wlan.h.

Data Fields
_i8 *	Key
_u8	KeyLen
_u8	Type

struct SlWlanSecParamsExt_t

Definition at line 648 of file wlan.h.

Data Fields
_i8 *	AnonUser
_u8	AnonUserLen
_u8	CertIndex
_u32	EapMethod
_i8 *	User
_u8	UserLen

struct SlWlanGetSecParamsExt_t

Definition at line 658 of file wlan.h.

Data Fields
_i8	AnonUser[32]
_u8	AnonUserLen
_u8	CertIndex
_u32	EapMethod
_i8	User[32]
_u8	UserLen

union SlWlanConnectionInfo_u

Definition at line 672 of file wlan.h.

Data Fields
SlWlanEventP2PConnect_t	P2PConnect
SlWlanEventConnect_t	StaConnect

struct SlWlanConnStatusParam_t

Definition at line 687 of file wlan.h.

Data Fields
SlWlanConnectionInfo_u	ConnectionInfo
_u8	ConnStatus
_u8	Mode
_u8	Reserved
_u8	SecType

struct SlWlanScanParamCommand_t

Definition at line 696 of file wlan.h.

Data Fields
_u32	ChannelsMask
_i32	RssiThershold

struct SlWlanInfoElement_t

Definition at line 703 of file wlan.h.

Data Fields
_u8	Data[252]
_u8	Id
_u16	Length
_u8	Oui[3]

struct SlWlanSetInfoElement_t

Definition at line 711 of file wlan.h.

Data Fields
SlWlanInfoElement_t	IE
_u8	Index
_u8	Role

struct SlWlanPmPolicyParams_t

Definition at line 719 of file wlan.h.

Data Fields
_u16	MaxSleepTimeMs
_u16	Reserved
_u16	Reserved2
_u16	Reserved3

struct SlWlanRxFilterPatternArg_t

Definition at line 751 of file wlan.h.

Data Fields
_u8	Length
_u16	Offset
_u8	Reserved
_u8	Value[16]

union SlWlanRxFilterHeaderArg_u

Definition at line 812 of file wlan.h.

Data Fields
_u8	Bssid[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][6]
_u32	EtherType[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]
_u32	FrameLength[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]
_u8	FrameSubtype[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]
_u8	Frametype[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]
_u8	FrametypeAscii[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][4]
_u8	IpProtocol[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]
_u8	IpProtocolAscii[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][5]
_u8	Ipv4[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][4]
_u8	Ipv4Ascii[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][16]
_u8	Ipv6[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][16]
_u8	IpVersion
_u8	IpVersionAscii[4]
_u8	Mac[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][6]
_u8	MacAscii[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS][18]
SlWlanRxFilterPatternArg_t	Pattern
_u16	Port[SL_WLAN_RX_FILTER_NUM_OF_FILTER_HEADER_ARGS]

struct SlWlanRxFilterRuleHeaderArgs_t

Definition at line 870 of file wlan.h.

Data Fields
_u8	Mask[16]
SlWlanRxFilterHeaderArg_u	Value

struct SlWlanRxFilterRuleHeader_t

Definition at line 879 of file wlan.h.

Data Fields
SlWlanRxFilterRuleHeaderArgs_t	Args
SlWlanRxFilterRuleHeaderCompareFunction_t	CompareFunc
SlWlanRxFilterRuleHeaderField_t	Field
_u8	Padding[2]

struct SlWlanRxFilterRuleCombination_t

Definition at line 899 of file wlan.h.

Data Fields
SlWlanRxFilterID_t	CombinationFilterId[SL_WLAN_RX_FILTER_RANGE_ARGS]
SlWlanRxFilterRuleCombinationOperator_t	Operator
_u8	Padding

union SlWlanRxFilterRule_u

Definition at line 908 of file wlan.h.

Data Fields
SlWlanRxFilterRuleCombination_t	Combination
SlWlanRxFilterRuleHeader_t	Header

struct SlWlanRxFilterTrigger_t

Definition at line 957 of file wlan.h.

Data Fields
SlWlanRxFilterTriggerCompareFunction_t	CompareFunction
SlWlanRxFilterTriggerConnectionStates_t	ConnectionState
SlWlanRxFilterCounterId_t	Counter
_u32	CounterVal
_u8	Padding[3]
SlWlanRxFilterID_t	ParentFilterID
SlWlanRxFilterTriggerRoles_t	Role

struct SlWlanRxFilterAction_t

Definition at line 985 of file wlan.h.

Data Fields
_u8	Counter
_u8	Padding[3]
_u16	Reserved
SlWlanRxFilterActionType_t	Type
_u8	UserId

struct SlWlanRxFilterOperationCommandBuff_t

Definition at line 996 of file wlan.h.

Data Fields
SlWlanRxFilterIdMask_t	FilterBitmap
_u8	Padding[4]

struct SlWlanRxFilterUpdateArgsCommandBuff_t

Definition at line 1004 of file wlan.h.

Data Fields
SlWlanRxFilterRuleHeaderArgs_t	Args
_u8	BinaryOrAscii
_u8	FilterId
_u8	Padding[2]

struct SlWlanRxFilterRetrieveStateBuff_t

Definition at line 1016 of file wlan.h.

Data Fields
SlWlanRxFilterIdMask_t	FilterIdMask

struct SlWlanRxFilterSysFiltersSetStateBuff_t

Definition at line 1023 of file wlan.h.

Data Fields
SlWlanRxFilterSysFiltersMask_t	FilterBitmap

struct SlWlanRxFilterSysFiltersRetrieveStateBuff_t

Definition at line 1030 of file wlan.h.

Data Fields
SlWlanRxFilterSysFiltersMask_t	FilterBitmap

Functions

Typedefs

Enumerations

Detailed Description

Function Documentation

Data Structure Documentation