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

 

  1. 1 概述
    1. 1.1 文档范围
    2. 1.2 概述
      1. 1.2.1 特性列表
    3. 1.3 主机驱动程序概述
    4. 1.4 可配置的信息元素
  2. 2 编写一个简单的联网应用程序
    1. 2.1 概述
      1. 2.1.1 基本示例代码
  3. 3 器件初始化
    1. 3.1 概述
    2. 3.2 主机接口
      1. 3.2.1 SPI 接口
      2. 3.2.2 UART 接口
        1. 3.2.2.1 更改 UART 波特率
  4. 4 器件配置
    1. 4.1 概述
    2. 4.2 器件参数
    3. 4.3 WLAN 参数
      1. 4.3.1 高级
    4. 4.4 网络参数
    5. 4.5 互联网和网络服务参数
    6. 4.6 电源管理参数
      1. 4.6.1 概述
      2. 4.6.2 电源策略
    7. 4.7 扫描参数
      1. 4.7.1 扫描策略
        1.       WLAN 连接
          1. 5.1 手动连接
            1. 5.1.1 STA
            2. 5.1.2 P2P
          2. 5.2 使用配置文件的连接
          3. 5.3 连接策略
          4. 5.4 与连接相关的异步事件
            1. 5.4.1 WLAN 事件
            2. 5.4.2 网络事件
            3. 5.4.3 不同连接场景的事件
          5. 5.5 使用 BSSID 进行 WLAN 连接
  5. 5 插座
    1. 5.1 概述
      1. 5.1.1 传输控制协议 (TCP)
      2. 5.1.2 用户数据报协议 (UDP)
    2. 5.2 套接字连接流程
    3. 5.3 TCP 连接流程
      1. 5.3.1 客户端
      2. 5.3.2 服务器端
    4. 5.4 UDP 连接流程
      1. 5.4.1 客户端
      2. 5.4.2 服务器端
    5. 5.5 套接字选项
      1. 5.5.1 阻塞与非阻塞
      2. 5.5.2 安全套接字
    6. 5.6 SimpleLink 支持的套接字 API
    7. 5.7 可用套接字的数量
    8. 5.8 数据包聚合
  6. 6 器件休眠
    1. 6.1 概述
  7. 7 配置
    1. 7.1 概述
    2. 7.2 SmartConfig
      1. 7.2.1 一般说明
      2. 7.2.2 使用方式/API
        1. 7.2.2.1 自动激活（开箱即用）
        2. 7.2.2.2 手动激活
        3. 7.2.2.3 停止智能配置
    3. 7.3 AP 模式
      1. 7.3.1 一般说明
      2. 7.3.2 使用方式/API
      3. 7.3.3 配置 AP 配置时的注意事项
    4. 7.4 WPS
      1. 7.4.1 一般说明
      2. 7.4.2 使用方式/API
      3. 7.4.3 使用 WPS 的示例
      4. 7.4.4 配置选项之间的权衡
  8. 8 安全性
    1. 8.1 WLAN 安全
      1. 8.1.1 个人
      2. 8.1.2 企业级
        1. 8.1.2.1 一般说明
        2. 8.1.2.2 使用方式/API
        3. 8.1.2.3 示例
        4. 8.1.2.4 限制
    2. 8.2 安全套接字
      1. 8.2.1 一般说明
      2. 8.2.2 使用方式/API
        1. 8.2.2.1 选择方法
        2. 8.2.2.2 选择密码套件
        3. 8.2.2.3 为套接字选择受保护的文件
        4. 8.2.2.4 设置域名以用于验证和 SNI
      3. 8.2.3 使用 SSL 的示例
      4. 8.2.4 支持的加密算法
    3. 8.3 限制
      1. 8.3.1 主要的已知限制
        1. 8.3.1.1 STA 模式
        2. 8.3.1.2 AP 模式
        3. 8.3.1.3 JavaScript 示例
        4. 8.3.1.4 主机驱动程序示例
  9. 9 AP 模式
    1. 9.1 一般说明
    2. 9.2 设置 AP 模式 – API
    3. 9.3 WLAN 参数配置 – API
    4. 9.4 WLAN 参数查询 – API
    5. 9.5 AP 网络配置
    6. 9.6 DHCP 服务器配置
    7. 9.7 设置器件 URN
    8. 9.8 发送到主机的异步事件
    9. 9.9 示例代码
  10. 10对等 (P2P) 模式
    1. 10.1 一般说明
      1. 10.1.1 范围
      2. 10.1.2 Wi-Fi Direct 优势
      3. 10.1.3 Wi-Fi Direct 支持和功能
      4. 10.1.4 限制
    2. 10.2 P2P API 和配置
      1. 10.2.1 配置 P2P 全局参数
        1. 10.2.1.1 设置 P2P 角色
        2. 10.2.1.2 设置 P2P 网络配置
        3. 10.2.1.3 设置 P2P 器件名称
        4. 10.2.1.4 设置 P2P 器件类型
        5. 10.2.1.5 设置 P2P 侦听通道和运行通道
      2. 10.2.2 配置 P2P 策略
        1. 10.2.2.1 配置 P2P 意图值和协商引发器
      3. 10.2.3 配置 P2P 配置文件连接策略
      4. 10.2.4 发现远程 P2P 对等器件
        1. 10.2.4.1 如何启动 P2P 发现
        2. 10.2.4.2 如何查看/获取 P2P 远程对等器件（网络 P2P 列表）
      5. 10.2.5 协商方法
      6. 10.2.6 手动连接 P2P
      7. 10.2.7 手动断开 P2P 连接
      8. 10.2.8 P2P 配置文件
      9. 10.2.9 删除 P2P 配置文件
    3. 10.3 P2P 连接事件
    4. 10.4 用例和配置
      1. 10.4.1 案例 1 – 固定式 P2P 客户端低功耗配置文件
      2. 10.4.2 案例 2 – 移动客户端低功耗配置文件
      3. 10.4.3 案例 3 – 固定的中心插入式配置文件
      4. 10.4.4 案例 4 – 移动中心配置文件
      5. 10.4.5 案例 5 – 移动通用型配置文件
    5. 10.5 示例代码
  11. 11HTTP 服务器
    1. 11.1  概述
    2. 11.2  支持的功能
    3. 11.3  HTTP Web 服务器说明
      1. 11.3.1 概述
        1. 11.3.1.1 详细信息
    4. 11.4  HTTP GET 处理
      1. 11.4.1 概述
      2. 11.4.2 默认网页
      3. 11.4.3 SimpleLink GET 令牌
      4. 11.4.4 用户定义的令牌
      5. 11.4.5 带有动态 HTML 内容的 HTML 示例代码
    5. 11.5  HTTP POST 处理
      1. 11.5.1 概述
      2. 11.5.2 SimpleLink POST 令牌
      3. 11.5.3 SimpleLink POST 操作
      4. 11.5.4 用户定义的令牌
      5. 11.5.5 发布后重定向
      6. 11.5.6 带有 POST 和动态 HTML 内容的 HTML 示例代码
    6. 11.6  内部网页
    7. 11.7  “强制 AP”模式支持
    8. 11.8  访问网页
      1. 11.8.1 工作站模式下的 SimpleLink
      2. 11.8.2 AP 模式下的 SimpleLink
    9. 11.9  HTTP 身份验证检查
    10. 11.10 使用 SimpleLink 驱动程序处理主机中的 HTTP 事件
    11. 11.11 SimpleLink 驱动程序连接 HTTP 网络服务器
      1. 11.11.1 启用或禁用 HTTP 服务器
      2. 11.11.2 配置 HTTP 端口号
      3. 11.11.3 启用或禁用身份验证检查
      4. 11.11.4 设置或获取身份验证名称、密码和领域
      5. 11.11.5 设置或获取域名
      6. 11.11.6 设置或获取 URN 名称
      7. 11.11.7 启用或禁用 ROM 网页访问
    12. 11.12 SimpleLink 预定义令牌
      1. 11.12.1 GET 值
      2. 11.12.2 POST 值
      3. 11.12.3 POST 操作
      4. 11.12.4 HTTP 服务器限制
  12. 12mDNS
    1. 12.1 概述
    2. 12.2 协议详细信息
    3. 12.3 实现
      1. 12.3.1 默认实现
      2. 12.3.2 184
      3. 12.3.3 启动和停止 mDNS
      4. 12.3.4 mDNS 查询 – 一次性
      5. 12.3.5 mDNS 查询 – 连续
      6. 12.3.6 mDNS 服务注册
    4. 12.4 支持的功能
    5. 12.5 限制
  13. 13串行闪存文件系统
    1. 13.1 概述
      1. 13.1.1 指令汇总
      2.      文件创建
      3.      文件打开
      4.      文件关闭
      5.      文件写入
      6.      文件读取
      7.      文件删除
      8.      文件信息
  14. 14Rx 滤波器
    1. 14.1 概述
    2. 14.2 详细说明
    3. 14.3 示例
    4. 14.4 创建树
    5. 14.5 主机 API
      1. 14.5.1 代码示例
    6. 14.6 注意事项和限制
  15. 15收发器模式
    1. 15.1  一般说明
    2. 15.2  使用方式/API
    3. 15.3  发送和接收
    4. 15.4  更改套接字属性
    5. 15.5  内部数据包发生器
    6. 15.6  发送 CW（载波）
    7. 15.7  连接策略和收发器模式
    8. 15.8  关于接收和发送的注意事项
      1. 15.8.1 接收
    9. 15.9  用例
      1. 15.9.1 嗅探器
    10. 15.10 持续发送
    11. 15.11 Ping
    12. 15.12 收发器模式限制
  16. 16Rx 统计信息
    1. 16.1 一般说明
    2. 16.2 使用方式/API
    3. 16.3 关于接收和发送的注意事项
    4. 16.4 用例
    5. 16.5 Rx 统计信息限制
      1.      API 概述
        1. 17.1 器件
        2. 17.2 NetCfg
        3. 17.3 WLAN
        4. 17.4 套接字
        5. 17.5 NetApp
        6. 17.6 文件系统
  17. 17异步事件
    1. 17.1 概述
    2. 17.2 WLAN 事件
    3. 17.3 Netapp 事件
    4. 17.4 套接字事件
    5. 17.5 器件事件
  18. 18可配置的信息元素
    1. 18.1 通用
    2. 18.2 应用接口
      1. 18.2.1 API 输出
    3. 18.3 所有信息元素的总大小上限
  19. 19调试
    1. 19.1 捕获 NWP 日志
      1. 19.1.1 概述
      2. 19.1.2 指令
        1. 19.1.2.1 为 CC32xx 配置引脚复用
        2. 19.1.2.2 终端设置
        3. 19.1.2.3 运行程序
        4. 19.1.2.4 发送给 TI 工程师
          1.        参考文献
            1.         A 主机驱动程序架构
              1.          A.1 概述
                1.           A.1.1 SimpleLink WiFi 主机驱动程序 – 与平台无关的部分
                2.           A.1.2 SimpleLink WiFi 主机驱动程序 – 与平台相关的部分
                3.           A.1.3 SimpleLink WiFi 驱动程序配置
                4.           A.1.4 用户应用程序
              2.          A.2 驱动程序数据流
                1.           A.2.1 传输层协议
                2.           A.2.2 命令和命令完成
                3.           A.2.3 数据事务
                  1.            A.2.3.1 数据发送（从主机到 SimpleLink 网络处理器）
                  2.            A.2.3.2 数据流控制
                  3.            A.2.3.3 数据接收（从 SimpleLink 网络处理器到主机）
                  4.            A.2.3.4 阻塞接收
                  5.            A.2.3.5 非阻塞接收
                    1.             B 错误代码
                      1.              B.1 错误代码
                        1.               C 如何生成证书、公钥和 CA
                          1.                C.1 证书生成
                            1.                 修订历史记录

11.12.1 GET 值

表 11-10 中显示了 GET 系统信息值。

表 11-10 系统信息
令牌名称值/用法
__SL_G_S.A系统运行时间返回自上次复位以来的系统运行时间，格式如下：
000 天 00:00:00
__SL_G_S.B器件名称 (URN)返回器件名称
__SL_G_S.C域名返回域名
__SL_G_S.D器件模式（角色）返回器件角色。
值：工作站、接入点、P2P
__SL_G_S.E器件角色工作站下拉菜单 select/not select
如果器件是工作站，则返回“selected”，否则返回“not_selected”。
__SL_G_S.F器件角色 AP下拉菜单 select/not select
如果器件是 AP，则返回“selected”，否则返回“not_selected”。
__SL_G_S.G器件角色 P2P下拉菜单 select/not select
如果器件处于 P2P 模式，则返回“selected”，否则返回“not_selected”。
__SL_G_S.H器件名称 URN（截断为 16 个字节）返回长度不超过 16 字节的 URN 字符串名称。更长的名称会被截断。
__SL_G_S.I系统需要复位（参数更改后）如果系统需要复位，则返回值为如下字符串：-- Some parameters were changed, System may require reset --，否则返回空字符串。
处理的每个内部 POST 都会导致此令牌返回 TRUE。
__SL_G_S.J获取系统时间和日期返回值为一个字符串，格式如下：
年, 月, 日, 小时, 分钟, 秒
__SL_G_S.K安全模式状态如果器件处于安全模式，则返回“Safe Mode”，否则返回空字符串。

表 11-11 中显示了 GET 版本信息。

表 11-11 版本信息
令牌名称值/用法
__SL_G_V.ANWP 版本返回带有版本信息的字符串
__SL_G_V.BMAC 版本—
__SL_G_V.CPHY 版本—
__SL_G_V.D硬件版本—

表 11-12 中显示了 GET 网络信息。

表 11-12 网络信息
令牌名称值/用法
工作站（和 P2P 客户端）
__SL_G_N.ASTA IP 地址字符串格式：xxx.yyy.zzz.ttt
__SL_G_N.BSTA 子网掩码—
__SL_G_N.CSTA 默认网关—
__SL_G_N.DMAC 地址字符串格式：00:11:22:33:44:55
__SL_G_N.ESTA DHCP 状态返回值：Enabled 或 Disabled
__SL_G_N.FSTA DHCP 禁用状态如果 DHCP 禁用，则返回 Checked，否则返回 Not_Checked。
用于 DHCP 单选按钮。
__SL_G_N.GSTA DHCP 启用状态如果 DHCP 启用，则返回 Checked，否则返回 Not_Checked。
用于 DHCP 单选按钮。
__SL_G_N.HSTA DNS 服务器字符串格式：xxx.yyy.zzz.ttt
DHCP 服务器
__SL_G_N.IDHCP 起始地址—
__SL_G_N.JDHCP 最后地址—
__SL_G_N.KDHCP 租用时间租用时间字符串（以秒为单位）
AP（和 P2P Go）
__SL_G_N.PAP IP 地址字符串格式：xxx.yyy.zzz.ttt
__SL_G_W.AAP 模式下的通道编号
__SL_G_W.BSSID
__SL_G_W.C安全类型返回值：Open、WEP、WPA
__SL_G_W.D安全类型 Open如果安全类型为 Open，则返回 Checked，否则返回 Not_Checked。
用于安全类型单选按钮 check/not checked。
__SL_G_W.E安全类型 WEP如果安全类型为 WEP，则返回 Checked，否则返回 Not_Checked。
用于安全类型单选按钮 check/not checked。
__SL_G_W.F安全类型 WPA如果安全类型为 WPA，则返回 Checked，否则返回 Not_Checked。
用于安全类型单选按钮 check/not checked。

表 11-13 中显示了 GET 工具。

表 11-13 工具
令牌名称值/用法
Ping 测试结果
__SL_G_T.AIP 地址字符串格式：xxx.yyy.zzz.ttt
__SL_G_T.B数据包大小
__SL_G_T.CPing 数
__SL_G_T.DPing 结果 – 总发送数发送的 Ping 总数
__SL_G_T.EPing 结果 – 成功发送数成功发送的 Ping 数
__SL_G_T.EPing 测试持续时间以秒为单位

表 11-14 中显示了 GET 连接策略状态

表 11-14 连接策略状态
令牌名称值/用法
__SL_G_P.E自动连接如果自动连接启用，则返回 Checked，否则返回 Not_Checked。
用于自动连接复选框。
__SL_G_P.F快速连接如果快速连接启用，则返回 Checked，否则返回 Not_Checked。
用于快速连接复选框。
__SL_G_P.G任何 P2P如果任何 P2P 启用，则返回 Checked，否则返回 Not_Checked。
用于任何 P2P 复选框。
__SL_G_P.P自动 SmartConfig如果自动 SmartConfig 启用，则返回 Checked，否则返回 Not_Checked。
用于自动 SmartConfig 复选框。

表 11-15 中显示了 GET 显示配置文件信息。

表 11-15 显示配置文件信息
令牌名称值/用法
__SL_G_PN1返回配置文件 1 SSIDSSID 字符串
__SL_G_PN2返回配置文件 2 SSID—
__SL_G_PN3返回配置文件 3 SSID—
__SL_G_PN4返回配置文件 4 SSID—
__SL_G_PN5返回配置文件 5 SSID—
__SL_G_PN6返回配置文件 6 SSID—
__SL_G_PN7返回配置文件 7 SSID—
__SL_G_PS1返回配置文件 1 安全状态返回值：Open、WEP、WPA、WPS、ENT、P2P_PBC、P2P_PIN 或 –（用于空配置文件）。
__SL_G_PS2返回配置文件 2 安全状态—
__SL_G_PS3返回配置文件 3 安全状态—
__SL_G_PS4返回配置文件 4 安全状态—
__SL_G_PS5返回配置文件 5 安全状态—
__SL_G_PS6返回配置文件 6 安全状态—
__SL_G_PS7返回配置文件 7 安全状态—
__SL_G_PP1返回配置文件 1 优先级配置文件优先级：0-7
__SL_G_PP2返回配置文件 2 优先级—
__SL_G_PP3返回配置文件 3 优先级—
__SL_G_PP4返回配置文件 4 优先级—
__SL_G_PP5返回配置文件 5 优先级—
__SL_G_PP6返回配置文件 6 优先级—
__SL_G_PP7返回配置文件 7 优先级—

表 11-16 中显示了 GET P2P 信息。

表 11-16 P2P 信息
令牌名称值/用法
__SL_G_R.AP2P 器件名称字符串
__SL_G_R.BP2P 器件类型字符串
__SL_G_R.CP2P 侦听信道返回侦听信道编号的字符串
__SL_G_R.T侦听信道 1如果当前侦听信道为 1，则返回 Selected，否则返回 Not_selected。
用于侦听信道的下拉菜单。
__SL_G_R.U侦听信道 6如果当前侦听信道为 6，则返回 Selected，否则返回 Not_selected。
用于侦听信道的下拉菜单。
__SL_G_R.V侦听信道 11如果当前侦听信道为 11，则返回 Selected，否则返回 Not_selected。
用于侦听信道的下拉菜单。
__SL_G_R.EP2P 工作信道返回工作信道编号的字符串
__SL_G_R.W工作信道 1如果当前工作信道为 1，则返回 Selected，否则返回 Not_selected。
用于工作信道的下拉菜单。
__SL_G_R.X工作信道 6如果当前工作信道为 6，则返回 Selected，否则返回 Not_selected。
用于工作信道的下拉菜单。
__SL_G_R.Y工作信道 11如果当前工作信道为 11，则返回 Selected，否则返回 Not_selected。
用于工作信道的下拉菜单。
__SL_G_R.L协商意图值返回值：Group Owner、Negotiate、Client
__SL_G_R.M组所有者角色如果意图为组所有者，则返回 Checked，否则返回 Not_Checked。
用于协商意图单选按钮。
__SL_G_R.N协商角色如果意图为协商，则返回 Checked，否则返回 Not_Checked。
用于协商意图单选按钮。
__SL_G_R.O客户端角色如果意图为客户端，则返回 Checked，否则返回 Not_Checked。
用于协商意图单选按钮。
__SL_G_R.P协商发起方策略返回值：Active、Passive、Random Backoff
__SL_G_R.Q协商发起方主动如果协商发起方采用主动策略，则返回 Checked，否则返回 Not_Checked。
用于协商发起方策略单选按钮。
__SL_G_R.R协商发起方被动如果协商发起方采用被动策略，则返回 Checked，否则返回 Not_Checked。
用于协商发起方策略单选按钮。
__SL_G_R.S协商发起方随机退避如果协商发起方采用随机退避策略，则返回 Checked，否则返回 Not_Checked。
用于协商发起方策略单选按钮。