ZHCU938C 用户指南 | 德州仪器 TI.com.cn

ZHCU938C May 2018 – January 2021 CC3100 , CC3100MOD , CC3200 , CC3200MOD

17.3 WLAN

sl_WlanSetMode – WLAN 器件具有多种 WLAN 运行模式。默认情况下，该器件充当 WLAN 工作站，但也可以充当其他 WLAN 角色。不同的选项包括：

ROLE_STA – 针对 WLAN 工作站模式
ROLE_AP – 针对 WLAN AP 模式
ROLE_P2P – 针对 WLAN P2P 模式

注：

设置的模式功能仅在下一次器件启动时生效。

从任意角色切换到 WLAN AP 角色的示例：

sl_WlanSetMode(ROLE_AP);                
/*关闭和打开器件以使角色更改生效 */
sl_Stop(0);
sl_Start(NULL,NULL,NULL);

sl_WlanSet – 让用户配置不同的 WLAN 相关参数。使用的主参数是 ConfigID 和 ConfigOpt。

可能的 ConfigID 和 ConfigOpt 组合为：

SL_WLAN_CFG_GENERAL_PARAM_ID – 不同的通用 WLAN 参数如下：
- WLAN_GENERAL_PARAM_OPT_COUNTRY_CODE
- WLAN_GENERAL_PARAM_OPT_STA_TX_POWER – 设置 STA 模式 Tx 功率级别（一个 0 至 15 的数字），作为最大功率的 dB 偏移（0 将设置最大功率）。
- WLAN_GENERAL_PARAM_OPT_AP_TX_POWER – 设置 AP 模式 Tx 功率级别（一个 0 至 15 的数字），作为最大功率的 dB 偏移（0 将设置最大功率）。
SL_WLAN_CFG_AP_ID – 不同的 AP 配置选项如下：
- WLAN_AP_OPT_SSID
- WLAN_AP_OPT_CHANNEL
- WLAN_AP_OPT_HIDDEN_SSID – 将 AP 设置为隐藏或非隐藏
- WLAN_AP_OPT_SECURITY_TYPE – 可能的选项为：
  - 开放安全：SL_SEC_TYPE_OPEN
  - WEP 安全：SL_SEC_TYPE_WEP
  - WPA 安全：SL_SEC_TYPE_WPA
- WLAN_AP_OPT_PASSWORD – 设置 AP 模式的安全密码：
  - 对于 WPA：8 至 63 个字符
  - 对于 WEP：5 至 13 个字符 (ASCII)
SL_WLAN_CFG_P2P_PARAM_ID
- WLAN_P2P_OPT_DEV_NAME
- WLAN_P2P_OPT_DEV_TYPE
- WLAN_P2P_OPT_CHANNEL_N_REGS – 侦听通道和监管等级确定了 P2P 查找和侦听阶段的器件侦听通道。运行通道和监管等级确定了器件更适合的运行通道（如果器件是组所有者，则会使用该运行通道）。通道应该是社会通道之一（1、6 或 11）。如果未选择侦听通道或运行通道，则将随机选择 1、6 或 11。
- WLAN_GENERAL_PARAM_OPT_INFO_ELEMENT – 应用程序为每个角色 (AP/P2P GO) 设置 MAX_PRIVATE_INFO_ELEMENTS_SUPPORTED 个信息元素。若要删除信息元素，请使用相关索引和长度 = 0。应用程序可以为同一角色设置不超过 MAX_PRIVATE_INFO_ELEMENTS_SUPPORTED 的值。但是，对于 AP，可以为所有信息元素存储不超过 INFO_ELEMENT_MAX_TOTAL_LENGTH_AP 字节。对于 P2P GO，可以为所有信息元素存储不超过 INFO_ELEMENT_MAX_TOTAL_LENGTH_P2P_GO 字节。
- WLAN_GENERAL_PARAM_OPT_SCAN_PARAMS – 更改扫描通道和 RSSI 阈值

为 AP 模式设置 SSID 的示例：

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

sl_WlanGet – 让用户能够配置不同的 WLAN 相关参数。使用的主参数是 ConfigID 和 ConfigOpt。sl_WlanGet 的用法与 sl_WlanSet 类似。

sl_WlanConnect – 手动连接到 WLAN 网络

sl_WlanDisconnect – 断开 WLAN 连接

sl_WlanProfileAdd – 启用自动启动连接策略后，器件会根据配置文件表连接到 AP。最多支持七个配置文件。如果配置了多个配置文件，器件会选择优先级最高的配置文件。在每个优先级组中，器件根据以下参数按优先级降序选择配置文件：安全策略、信号强度。

sl_WlanProfileGet – 从器件读取 WLAN 配置文件

sl_WlanProfileDel – 删除现有配置文件

sl_WlanPolicySet – 管理以下 WLAN 功能的配置：

SL_POLICY_CONNECTION – SL_POLICY_CONNECTION 类型可定义用于将 CC31xx 器件连接至 AP 的三个选项：
- 自动连接 – 每次连接失败或者器件重新进行引导后，CC31xx 器件都会尝试自动重新连接到其存储的配置文件之一。若要设置此选项，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(1,0,0,0,0),NULL,0)
```
- 快速连接 – CC31xx 器件尝试快速连接到 AP。若要设置此选项，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,1,0,0,0),NULL,0)
```
- P2P 连接 – 如果设置了“任何 P2P”模式，CC31xx 器件会尝试自动连接至可用的第一个 P2P 器件，仅支持使用按钮。若要设置此选项，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,0,0,1,0),NULL,0)
```
- 重新启动后自动 SmartConfig – 器件在 SmartConfig 模式下唤醒。主机发出的任何命令都会使此状态结束。若要设置此选项，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_CONNECTION,SL_CONNECTION_POLICY(0,0,0,0,1),NULL,0)
```
SL_POLICY_SCAN – 定义没有连接时的系统扫描时间间隔。默认间隔为 10 分钟。设置扫描间隔后，系统会立即激活扫描。下一次扫描基于间隔设置。若要将扫描间隔设置为 1 分钟，请使用以下示例：
```
unsigned long intervalInSeconds = 60;
#define SL_SCAN_ENABLE  1
sl_WlanPolicySet(SL_POLICY_SCAN,SL_SCAN_ENABLE, (unsigned char *)
&intervalInSeconds,sizeof(intervalInSeconds));
```
若要禁用扫描，请使用：
```
#define SL_SCAN_DISABLE  0
sl_WlanPolicySet(SL_POLICY_SCAN,SL_SCAN_DISABLE,0,0);
```
SL_POLICY_PM – 定义仅用于工作站模式的电源管理策略。共有四个可用的电源策略：
- SL_NORMAL_POLICY（默认）– 若要设置正常电源管理策略，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_PM , SL_NORMAL_POLICY, NULL,0)
```
- SL_ALWAYS_ON_POLICY – 若要设置始终开启电源管理策略，请使用：
  - ```
  sl_WlanPolicySet(SL_POLICY_PM , SL_ALWAYS_ON_POLICY, NULL,0)
```
- SL_LONG_SLEEP_INTERVAL_POLICY – 若要设置长时间睡眠间隔策略，请使用：
  - ```
  unsigned short PolicyBuff[4] = {0,0,800,0}; // 800 is max sleep time in mSec
  sl_WlanPolicySet(SL_POLICY_PM , SL_LONG_SLEEP_INTERVAL_POLICY, PolicyBuff,sizeof(PolicyBuff));
```
SL_POLICY_P2P – 为 P2P 角色定义 P2P 协商策略参数。若要设置意图协商值，请设置以下之一：
- SL_P2P_ROLE_NEGOTIATE – 意图 3
- SL_P2P_ROLE_GROUP_OWNER – 意图 15
- SL_P2P_ROLE_CLIENT – 意图 0
若要设置协商发起方值（第一个协商操作帧的发起方策略），请设置以下之一：
- SL_P2P_NEG_INITIATOR_ACTIVE
- SL_P2P_NEG_INITIATOR_PASSIVE
- SL_P2P_NEG_INITIATOR_RAND_BACKOFF
例如：
```
set sl_WlanPolicySet(SL_POLICY_P2P, SL_P2P_POLICY(SL_P2P_ROLE_NEGOTIATE,SL_P2P_NEG_INITIATOR_RAND_BACKOFF),NULL,0);
```

sl_WlanPolicyGet – 读取不同的 WLAN 策略设置。可能的选项包括：

SL_POLICY_CONNECTION
SL_POLICY_SCAN
SL_POLICY_PM
SL_POLICY_P2P

sl_WlanGetNetworkList – 获取最新的 WLAN 扫描结果

sl_WlanSmartConfigStart – 将器件置于 SmartConfig 状态。SmartConfig 成功结束后，将收到一个异步事件：SL_OPCODE_WLAN_SMART_CONFIG_START_ASYNC_RESPONSE。该事件包含 SSID 以及一个可能也已完成传递的额外字段（例如，器件名称）。

sl_WlanSmartConfigStop – 停止 SmartConfig 过程。停止 SmartConfig 后，将收到一个异步事件：SL_OPCODE_WLAN_SMART_CONFIG_STOP_ASYNC_RESPONSE

sl_WlanRxStatStart – 开始收集 WLAN Rx 统计信息（不限时间）

sl_WlanRxStatStop – 停止收集 WLAN Rx 统计信息

sl_WlanRxStatGet – 获取 WLAN Rx 统计信息。调用此命令后，统计信息计数器将被清除。返回的统计信息如下：

接收到的有效数据包数 – 正确接收的数据包总数（包括已过滤的数据包）
接收到的 FCS 错误数据包 – 由于 FCS 错误而丢弃的数据包总数
接收到的 PLCP 错误数据包 – 由于 PLCP 错误而丢弃的数据包总数
平均数据 RSSI – 接收到的所有有效数据包的平均 RSSI
平均管理 RSSI – 接收到的所有有效管理数据包的平均 RSSI
速率直方图 – 接收到的所有有效数据包的速率直方图
RSSI 直方图 – 从 -40 到 -87 的 RSSI 直方图（低于和高于 RSSI 的所有值都出现在第一个和最后一个单元中）
开始时间戳 – 开始收集统计信息的时间戳（以 µSec 为单位）
获取时间戳 – 读取统计信息的时间戳（以 µSec 为单位）