4A-ESP8266_AT_Instruction_Set__CN.pages

Transcription

1 ESP8266 AT 集 版本 3.0 乐鑫信息科技 版权所有

2 关于本 手册 本 文档提供 ESP8266_NONOS_SDK 的 AT 说明 发布说明 日期 版本 发布说明 V1.5.3 首次发布 V1.5.4 更更新章节 和 V2.0.0 增加章节 , 更更新章节 V2.1.0 更更新章节 3.2,4.1 和 V2.1.1 增加附录 B V2.2 增加章节 ,3.2.23,4.2.39, 和 更更新章节 4.2.7,4.2.8 和附录 B V2.2.1 更更新章节 , 和 V2.2.2 增加章节 ,5.2.23, 更更新章节 增加章节 5.2.5,5.2.25,5.2.26, V3.0 更更新第 1 章, 章节 4.2.3,4.2.4,4.2.11,4.2.12, 附录 A 删除 AT+RFAUTOTRACE 文档变更更通知 用户可通过乐鑫官 网订阅 页 面 订阅技术 文档变更更的电 子邮件通知 证书下载 用户可通过乐鑫官 网证书下载 页 面 下载产品证书

3 目录 1. 前 言 客制化 AT 固件 编译 AT 工程 客制化功能 新增 自定义 AT 烧录 AT 固件 Mbit Flash, Map: 1024 KB KB Mbit Flash, Map: 1024 KB KB Mbit Flash Mbit Flash Mbit Flash, Map: 512 KB KB Mbit Flash, Map: 512 KB KB 说明 基础 AT 基础 AT 一览表 基础 AT 描述 AT 测试 AT 启动 AT+RST 重启模块 AT+GMR 查询版本信息 AT+GSLP 进 入 Deep-sleep 模式 ATE 开关回显功能 AT+RESTORE 恢复出 厂设置 AT+UART_CUR 设置 UART 当前临时设置, 不不保存到 Flash AT+UART_DEF 设置 UART 配置, 保存到 Flash AT+SLEEP 设置 sleep 模式... 12

4 AT+WAKEUPGPIO 设置 GPIO 唤醒 Light-sleep 模式 AT+RFPOWER 设置 RF TX Power 上限 AT+RFVDD 根据 VDD33 设置 RF TX Power AT+SYSRAM 查询系统当前剩余内存 AT+SYSADC 查询 ADC 值 AT+SYSIOSETCFG 设置 IO 工作模式 AT+SYSIOGETCFG 查询 IO 工作模式 AT+SYSGPIODIR 设置 GPIO 工作为输 入或输出 AT+SYSGPIOWRITE 设置 GPIO 的输出电平 AT+SYSGPIOREAD 读取 GPIO 的电平状态 AT+SYSMSG_CUR 设置当前系统消息, 不不保存到 flash AT+SYSMSG_DEF 设置默认系统消息, 保存到 flash 基础 AT 基础 Wi-Fi 功能 AT 一览表 基础 Wi-Fi 功能 AT 描述 AT+CWMODE_CUR 设置当前 Wi-Fi 模式, 不不保存到 Flash AT+CWMODE_DEF 设置当前 Wi-Fi 模式并保存到 Flash AT+CWJAP_CUR 临时连接 AP AT+CWJAP_DEF 连接 AP, 保存到 Flash AT+CWLAPOPT 设置 CWLAP 的属性 AT+CWLAP 扫描当前可 用的 AP AT+CWQAP 断开与 AP 的连接 AT+CWSAP_CUR 配置 ESP8266 SoftAP 当前参数 AT+CWSAP_DEF 配置 ESP8266 SoftAP 当前参数, 保存到 Flash AT+CWLIF 查询连接到 ESP8266 SoftAP 的 Station 信息 AT+CWDHCP_CUR 设置 DHCP, 不不保存到 Flash AT+CWDHCP_DEF 设置 DHCP, 保存到 Flash... 29

5 AT+CWDHCPS_CUR 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 不不保存到 Flash AT+CWDHCPS_DEF 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 保存到 Flash AT+CWAUTOCONN 上电是否 自动连接 AP AT+CIPSTAMAC_CUR 设置 ESP8266 Station 当前 MAC 地址, 不不保存到 Flash AT+CIPSTAMAC_DEF 设置 ESP8266 Station 当前 MAC 地址, 保存到 Flash AT+CIPAPMAC_CUR 设置 ESP8266 SoftAP 当前 MAC 地址, 不不保存到 Flash AT+CIPAPMAC_DEF 设置 ESP8266 SoftAP 默认 MAC 地址, 保存到 Flash AT+CIPSTA_CUR 设置 ESP8266 Station 的 IP 地址, 不不保存到 Flash AT+CIPSTA_DEF 设置 ESP8266 Station 的 IP 地址, 保存到 Flash AT+CIPAP_CUR 设置 ESP8266 SoftAP 的 IP 地址, 不不保存到 Flash AT+CIPAP_DEF 设置 ESP8266 SoftAP 的 IP 地址, 保存到 Flash AT+CWSTARTSMART 开启 SmartConfig AT+CWSTOPSMART 停 止 SmartConfig AT+CWSTARTDISCOVER 开启可被局域 网内微信探测模式 AT+CWSTOPDISCOVER 关闭可被局域 网内微信探测模式 AT+WPS 设置 WPS 功能 AT+MDNS 设置 MDNS 功能 AT+CWHOSTNAME 设置 ESP8266 Station 的主机名称 AT+CWCOUNTRY_CUR 设置 ESP8266 WiFi 国家码 AT+CWCOUNTRY_DEF 设置默认的 ESP8266 WiFi 国家码, 并保存到 flash TCP/IP 功能 AT TCP/IP 一览表 TCP/IP 描述 AT+CIPSTATUS 查询 网络连接信息 AT+CIPDOMAIN 域名解析功能 AT+CIPSTART 建 立 TCP 连接,UDP 传输或 SSL 连接 AT+CIPSSLSIZE 设置 SSL Buffer 容量量... 44

6 AT+CIPSSLCCONF 配置 SSL Client AT+CIPSEND 发送数据 AT+CIPSENDEX 发送数据 AT+CIPSENDBUF 数据写 入 TCP 发包缓存 AT+CIPBUFRESET 重新计数 AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态 AT+CIPCHECKSEQ 查询写 入 TCP 发包缓存的某包是否发送成功 AT+CIPCLOSEMODE 设置 TCP 连接的断开 方式 AT+CIPCLOSE 关闭 TCP/UDP/SSL 传输 AT+CIFSR 查询本地 IP 地址 AT+CIPMUX 设置多连接 AT+CIPSERVER 建 立 TCP 服务器器 AT+CIPSERVERMAXCONN 设置服务器器允许建 立的最 大连接数 * AT+CIPMODE 设置传输模式 AT+SAVETRANSLINK 保存透传到 Flash AT+CIPSTO 设置 TCP 服务器器超时时间 AT+PING Ping 功能 AT+CIUPDATE 通过 Wi-Fi 升级软件 AT+CIPDINFO 接收 网络数据时是否提示对端 IP 和端 口 IPD 接收 网络数据 AT+CIPRECVMODE 设置 TCP 连接的数据接收 方式 AT+CIPRECVDATA 被动接收模式时, 读取缓存的 TCP 数据 AT+CIPRECVLEN 被动接收模式时, 查询缓存 TCP 数据的 长度 AT+CIPSNTPCFG 设置时域和 SNTP 服务器器 AT+CIPSNTPTIME 查询 SNTP 时间 AT+CIPDNS_CUR 自定义 DNS 服务器器, 不不保存到 Flash AT+CIPDNS_DEF 自定义 DNS 服务器器, 保存到 Flash... 57

7 A. 附录 A B. 附录 B C. Q&A... 61

8 1. 前 言 1. 前 言 乐鑫官 方发布 ESP8266 AT 固件, 供 用户直接下载使 用 同时, 乐鑫也提供 AT 工程供 用户在乐鑫 AT 的基础上, 自 行行开发客制化 AT 固件 本 文包含客制化 AT 固件的 方法,AT 固件的烧录, 以及乐鑫已有的 AT 集说明 : 请确保正确的 BIN (/ESP8266_NONOS_SDK/bin/at) 已经参考 ESP8266_NONOS_SDK/bin/at 中 readme.txt 烧录到 ESP8266 模块, 再执 行行 文档中的 AT AT 底层已占 用 system_os_task 优先级 0 和 1, 如果 用户基于 AT 开发, 仅 支持建 立 一个优先级为 2 的任务 1.1. 客制化 AT 固件 编译 AT 工程 用户如需编译客制化 AT 源代码, 新增 自定义的 AT, 请将 example 中的 文件夹 at 拷 贝到对应版本的 ESP8266_NONOS_SDK 根 目录下, 再进 入 at 文件夹进 行行开发及编译 详细编译说明, 可参考 ESP8266 入 门指南 客制化功能 OTA 功能 : - 乐鑫发布的官 方 AT 固件, 默认 支持使 用 AT+CIUPDATE, 从乐鑫云下载升级到新版本的 AT 固件 - 如果 用户 自 行行客制化 AT 固件, 则需要 自 行行实现 OTA 升级功能, 从 用户 自 己的云端下载升级 自定义的新版本固件 乐鑫在 at_upgrade.c 中提供了了 OTA, 以供参考 SmartConfig 功能 : - 乐鑫发布的官 方 AT 固件, 默认 支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART. - 如果 用户 无需 SmartConfig 功能, 可以 自 行行重新编译 at, 在 user_config.h 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE, 从 而减 小 bin size, 节省内存 新增 自定义 AT 自定义 AT 命名时, 使 用英 文字符, 请勿使 用其他特殊字符或数字 Espressif! 1/!

9 1. 前 言 AT 基于 ESP8266_NONOS_SDK 编译,ESP8266_NONOS_SDK/example/at 中提供了了开发者 自定义 AT 的 乐鑫原本提供的 AT 以库 文件 libat.a 的形式提供, 将包含在编译 生成的 AT BIN 固件中 /ESP8266_NONOS_SDK/examples/at/user/user_main.c 中提供了了实现 自定义 AT 的, 可参考实现 结构体 at_funcationtype 用于定义 一条的四种类型, 类型定义如下表所示 类型定义类型描述说明 对应 AT+TEST=? at_testcmd 测试 AT 中注册的实现回调 建议功能 at_testcmdtest 返回参数的取值范围 若此参数注册为 NULL, 则 无测试 对应 AT+TEST? at_querycmd 查询 AT 中注册的实现回调 建议功能 at_querycmdtest 返回当前值 若此参数注册为 NULL, 则 无查询 对应格式 AT+TEST=parameter1,parameter2, at_setupcmd 设置 AT 中注册的实现回调 建议功能 at_setupcmdtest 设置参数值 若此参数注册为 NULL, 则 无设置 对应 AT+TEST at_execmd 执 行行 AT 中注册的实现回调 建议功能 at_execmdtest 执 行行某项操作 若此参数注册为 NULL, 则 无执 行行 1.2. 烧录 AT 固件 参考 ESP8266_NONOS_SDK/bin/at/readme.txt 进 行行烧录, 请使 用乐鑫官 方烧录 工具, 烧录时选择对应的 Flash 大 小 乐鑫官 方烧录 工具链接 : 从 ESP8266_NONOS_SDK_V3.0.0,AT_V1.7 起, 由于 AT bin size 增 大,AT 默认只 支持 1024 KB KB 的 flash map Espressif! 2/!

10 1. 前 言 Mbit Flash, Map: 1024 KB KB 使 用 Espressif 官 方烧录 工具, 烧录时选择 Flash size : 16 Mbit-C1 BIN 烧录地址说明 blank.bin 0x1FB000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0x1FC000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0xFE000 初始化 用户参数区, 详 见附录 blank.bin 0x1FE000 初始化系统参数区, 详 见附录 boot.bin 0x00000 主程序, 位于 /bin/at user new.5.bin 0x01000 主程序, 位于 /bin/at/ Mbit Flash, Map: 1024 KB KB 使 用 Espressif 官 方烧录 工具, 烧录时选择 Flash size:32 Mbit-C1 BIN 烧录地址说明 blank.bin 0x3FB000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0x3FC000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0xFE000 初始化 用户参数区, 详 见附录 blank.bin 0x3FE000 初始化系统参数区, 详 见附录 boot.bin 0x00000 主程序, 位于 /bin/at user new.5.bin 0x01000 主程序, 位于 /bin/at/ Mbit Flash 从 ESP8266_NONOS_SDK_V2.0.0,AT_V1.3 起,AT 固件可以使 用 4 Mbit Flash, 但不不 支持升级功能 BIN 烧录地址说明 blank.bin 0x78000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0x7C000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0x7A000 初始化 用户参数区, 详 见附录 Espressif! 3/!

11 1. 前 言 BIN 烧录地址 说明 blank.bin 0x7E000 初始化系统参数区, 详 见附录 eagle.flash.bin 0x00000 主程序, 位于 /bin/at/noboot eagle.irom0text.bin 0x10000 主程序, 位于 /bin/at/noboot Mbit Flash 固件升级功能 ( 对应 AT+CIUPDATE) 要求 Flash 容量量为 8 Mbit 或以上, 采 用 boot mode 的烧录 方式 使 用 Espressif 官 方烧录 工具, 烧录时选择 Flash size:8 Mbit BIN 烧录地址说明 blank.bin 0xFB000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0xFC000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0x7E000 初始化 用户参数区, 详 见附录 blank.bin 0xFE000 初始化系统参数区, 详 见附录 boot.bin 0x00000 主程序, 位于 /bin/at user new.2.bin 0x01000 主程序, 位于 /bin/at/ Mbit Flash, Map: 512 KB KB 使 用 Espressif 官 方烧录 工具, 烧录时选择 Flash size:16 Mbit BIN 烧录地址说明 blank.bin 0x1FB000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0x1FC000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0x7E000 初始化 用户参数区, 详 见附录 blank.bin 0x1FE000 初始化系统参数区, 详 见附录 boot.bin 0x00000 主程序, 位于 /bin/at user new.2.bin 0x01000 主程序, 位于 /bin/at/ Mbit Flash, Map: 512 KB KB 使 用 Espressif 官 方烧录 工具, 烧录时选择 Flash size:32 Mbit Espressif! 4/!

12 1. 前 言 BIN 烧录地址说明 blank.bin 0x3FB000 初始化 RF_CAL 参数区 esp_init_data_default.bin 0x3FC000 初始化其他射频参数区, 至少烧录 一次 当 RF_CAL 参数区初始化烧录时, 本区域也需烧录 blank.bin 0x7E000 初始化 用户参数区, 详 见附录 blank.bin 0x3FE000 初始化系统参数区, 详 见附录 boot.bin 0x00000 主程序, 位于 /bin/at user new.2.bin 0x01000 主程序, 位于 /bin/at/ Espressif! 5/!

13 2. 说明 2. 说明 AT 可以细分为四种类型 : 类型 格式 描述 测试 AT+<x>=? 该命令 用于该命令 用于查询设置的参数以及取值范围 查询 AT+<x>? 该命令 用于返回参数的当前值 设置 AT+<x>=< > 该命令 用于设置 用户 自定义的参数值 执 行行 AT+<x> 该命令 用于执 行行受模块内部程序控制的变参数不不可变的功能 : 不不是每条 AT 都具备上述 4 种类型的命令 [ ] 括号内为缺省值, 不不必填写或者可能不不显示 使 用双引号表示字符串串数据 string, 例例如 :AT+CWSAP="ESP756290"," ",1,4 默认波特率为 AT 必须 大写, 并且以回 车换 行行符结尾 (CR LF) Espressif! 6/!

14 3. 基础 AT 3. 基础 AT 3.1. 基础 AT 一览表 描述 AT AT+RST AT+GMR AT+GSLP ATE AT+RESTORE AT+UART_CUR AT+UART_DEF AT+SLEEP AT+WAKEUPGPIO AT+RFPOWER AT+RFVDD AT+SYSRAM AT+SYSADC AT+SYSIOSETCFG AT+SYSIOGETCFG AT+SYSGPIODIR AT+SYSGPIOWRITE AT+SYSGPIOREAD AT+SYSMSG_CUR AT+SYSMSG_DEF 测试 AT 启动重启模块查看版本信息进 入 Deep-sleep 模式开关回显功能恢复出 厂设置 UART 当前临时配置 UART 默认配置, 保存到 Flash 设置 sleep 模式设置 GPIO 唤醒 Light-sleep 模式设置 RF TX Power 上限根据 VDD33 设置 RF TX Power 查询系统当前剩余内存查询 ADC 值设置 IO 工作模式查询 IO 工作模式设置 GPIO 工作为输 入或输出设置 GPIO 的输出电平读取 GPIO 的电平状态设置当前系统消息设置默认系统消息 Espressif! 7/!

15 3. 基础 AT 3.2. 基础 AT 描述 AT 测试 AT 启动 执 行行 AT AT+RST 重启模块 执 行行 AT+RST AT+GMR 查询版本信息 执 行行 AT+GMR <AT version info> <SDK version info> <compile time> <AT version info>:at 版本信息 <SDK version info>:sdk 版本信息 <compile time>: 编译 生成时间 AT+GSLP 进 入 Deep-sleep 模式 设置 AT+GSLP=<time> <time> <time>: 设置 ESP8266 的睡眠时 长, 单位 : 毫秒 ESP8266 会在休眠设定时 长后 自动唤醒 Deep-sleep 功能需要硬件 支持, 将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB, 用作 Deep-sleep 唤醒 Espressif! 8/!

16 3. 基础 AT ATE 开关回显功能 执 行行 ATE ATE0: 关闭回显 ATE1: 开启回显 AT+RESTORE 恢复出 厂设置 执 行行 说明 AT+RESTORE 恢复出 厂设置, 将擦除所有保存到 Flash 的参数, 恢复为默认参数 恢复出 厂设置会导致机器器重启 Espressif! 9/!

17 3. 基础 AT! AT+UART_CUR 设置 UART 当前临时设置, 不不保存到 Flash 查询 : AT+UART_CUR? 设置 : AT+UART_CUR=<baudrate>,<databits>,<stopbits>,<parity>,<flow control> +UART_CUR:<baudrate>,<databits>,< stopbits>,<parity>,<flow control> 查询返回的是 UART 实际参数 值, 由于时钟分频的原因,UART 实 际参数值与设置值有 一定误差, 是正 常情况 例例如, 设置 UART 波特率为 时, 查询实际波特率值为 <baudrate>:uart 波特率 <databits>: 数据位 5:5 bit 数据位 6:6 bit 数据位 7:7 bit 数据位 8:8 bit 数据位 <stopbits>: 停 止位 1:1 bit 停 止位 2:1.5 bit 停 止位 3:2 bit 停 止位 <parity>: 校验位 0:None 1:Odd 2:Even <flow control>: 流控 0: 不不使能流控 1: 使能 RTS 2: 使能 CTS 3: 同时使能 RTS 和 CTS 1. 本设置不不保存在 Flash 2. 使 用流控需要硬件 支持流控 : MTCK 为 UART0 CTS MTDO 为 UART0 RTS 3. 波特率 支持范围 :110~115200*40 AT+UART_CUR=115200,8,1,0,3 Espressif! 10/!

18 3. 基础 AT! AT+UART_DEF 设置 UART 配置, 保存到 Flash 查询 : AT+UART_DEF? +UART_DEF:<baudrate>,<databits>,<s topbits>,<parity>,<flow control> <baudrate>:uart 波特率 <databits>: 数据位 5:5 bit 数据位 6:6 bit 数据位 7:7 bit 数据位 8:8 bit 数据位 <stopbits>: 停 止位 1:1 bit 停 止位 2:1.5 bit 停 止位 3:2 bit 停 止位 <parity>: 校验位 0:None 1:Odd 2:Even <flow control>: 流控 0: 不不使能流控 1: 使能 RTS 2: 使能 CTS 3: 同时使能 RTS 和 CTS 设置 : AT+UART_DEF=<baudrate>,<databits>,<stopbits>,<parity>,<flow control> 1. 本设置将保存在 Flash user parameter 区, 重新上电后仍 生效 2. 使 用流控需要硬件 支持流控 : MTCK 为 UART0 CTS MTDO 为 UART0 RTS 3. 波特率 支持范围 :110~115200*40 AT+UART_DEF=115200,8,1,0,3 Espressif! 11/!

19 3. 基础 AT AT+SLEEP 设置 sleep 模式 查询 : AT+SLEEP? 当前 sleep 模式 <sleep mode>: 0: 禁 用休眠模式 1:Light-sleep 模式 2:Modem-sleep 模式 设置 : AT+SLEEP=<sleep mode> 或 ERROR Sleep 模式仅在单 Station 模式下 生效 默认为 Modem-sleep 模式 AT+SLEEP= AT+WAKEUPGPIO 设置 GPIO 唤醒 Light-sleep 模式 设置 AT+WAKEUPGPIO=<enable>,<trigger_GPIO>,<trigger_level>[,<awake_GPIO>,<awake_level> ] <enable> 0: 禁 用 GPIO 唤醒 Light-sleep 功能 1: 使能 GPIO 唤醒 Light-sleep 功能 <trigger_gpio> 设置 用于唤醒 Light-sleep 的 GPIO, 有效范围 :[0, 15] <trigger_level> 0: 低电平唤醒 1: 高电平唤醒 [<awake_gpio>] 选填参数, 设置 Light-sleep 唤醒后的标志 GPIO, 有效范围 :[0, 15] [<awake_level>] 选填参数 0:Light-sleep 唤醒后置为低电平 1:Light-sleep 唤醒后置为 高电平 Espressif! 12/!

20 3. 基础 AT Light sleep 唤醒过程约 5 ms, 请等待 至少 5ms 后再发送 AT <trigger_gpio> 与 <awake_gpio> 不不能相同 由 <trigger_gpio> 触发 ESP8266 从 Light-sleep 唤醒之后, 如需再次进 入休眠时, ESP8266 将判断 <trigger_gpio> 的状态 : 如果 <trigger_gpio> 仍然处于唤醒状态, 则进 入 Modem-sleep 休眠 ; 如果 <trigger_gpio> 不不处于唤醒状态, 则进 入 Light-sleep 休眠 设置 GPIO0 低电平唤醒 Light-sleep 模式 : AT+WAKEUPGPIO=1,0,0 设置 GPIO0 高电平唤醒 Light-sleep 模式, 唤醒后, 将 GPIO13 设置为 高电平 : AT+WAKEUPGPIO=1,0,1,13,1 取消 GPIO 唤醒 Light-sleep 模式的功能 : AT+WAKEUPGPIO= AT+RFPOWER 设置 RF TX Power 上限 设置 AT+RFPOWER=<TX Power> <TX Power>:RF TX Power 值, 参数范围 :[0, 82], 单位 :0.25 dbm RF TX Power 的设置并不不精准, 此时设置的是 RF TX Power 的最 大值, 实际值可能 小于设置值 AT+RFPOWER= AT+RFVDD 根据 VDD33 设置 RF TX Power 查询 : 设置 : 执 行行 : AT+RFVDD? 功能 : 查询 ESP8266 AT+RFVDD=<VDD33> 功能 :ESP8266 根据传 入的 AT+RFVDD 功能 :ESP8266 自动根据实际 VDD33 的值 <VDD33> 调整 RF TX Power 的 VDD33 调整 RF TX Power +RFVDD:<VDD33> <VDD33>:VDD33 电压值, 单位 :1/1024 V <VDD33>:VDD33 电压值, 取值范围 :[1900, 3300] - 本查询必须在 TOUT 管脚悬空的情况下使 用, 否则, 查询返回 无效值 - 本查询必须在 TOUT 管脚悬空的情况下使 用 Espressif! 13/!

21 3. 基础 AT AT+RFVDD= AT+SYSRAM 查询系统当前剩余内存 查询 AT+SYSRAM? +SYSRAM:<RAM> <RAM>: 系统当前剩余内存, 单位 :byte AT+SYSADC 查询 ADC 值 查询 AT+SYSADC? +SYSADC:<ADC> <ADC>: 查询到的 ADC 值, 单位 :1/1024V AT+SYSIOSETCFG 设置 IO 工作模式 设置 AT+SYSIOSETCFG=<pin>,<mode>,<pull-up> <pin>:io 管脚号 <mode>:io 工作模式 <pull-up> 0: 不不使能上拉 1: 使能上拉 AT+SYSIO 系列列的使 用, 请参考 ESP8266 管脚清单 AT+SYSIOSETCFG=12,3,1 // 设置 GPIO12 工作为 GPIO 模式 AT+SYSIOGETCFG 查询 IO 工作模式 设置 AT+SYSIOGETCFG=<pin> +SYSIOGETCFG:<pin>,<mode>,<pull-up> Espressif! 14/!

22 3. 基础 AT <pin>:io 管脚号 <mode>:io 工作模式 <pull-up> 0: 不不使能上拉 1: 使能上拉 AT+SYSIO 系列列的使 用, 请参考 ESP8266 管脚清单 AT+SYSGPIODIR 设置 GPIO 工作为输 入或输出 设置 AT+SYSGPIODIR=<pin>,<dir> 如果成功, 提示 如果 IO 管脚不不处于 GPIO 模式, 则提示 NOT GPIO MODE! ERROR <pin>:gpio 号 <dir>: 0: 设置 GPIO 为输 入 1: 设置 GPIO 为输出 AT+SYSGPIO 系列列的使 用, 请参考 ESP8266 管脚清单 AT+SYSIOSETCFG=12,3,1 // 设置 GPIO12 工作为 GPIO 模式 AT+SYSGPIODIR=12,0 // 设置 GPIO12 为输入 AT+SYSGPIOWRITE 设置 GPIO 的输出电平 设置 AT+SYSGPIOWRITE=<pin>,<level> 如果成功, 提示 如果 IO 管脚不不处于输出模式, 则提示 NOT OUTPUT! ERROR Espressif! 15/!

23 3. 基础 AT <pin>:gpio 号 <level>: 0: 低电平 1: 高电平 AT+SYSGPIO 系列列的使 用, 请参考 ESP8266 管脚清单 AT+SYSIOSETCFG=12,3,1 // 设置 GPIO12 工作为 GPIO 模式 AT+SYSGPIODIR=12,1 // 设置 GPIO12 为输出 AT+SYSGPIOWRITE=12,1 // 设置 GPIO12 输出高电平 AT+SYSGPIOREAD 读取 GPIO 的电平状态 设置 AT+SYSGPIOREAD=<pin> 如果成功, 返回 +SYSGPIOREAD:<pin>,<dir>,<level> 如果 IO 管脚不不处于输出模式, 则提示 NOT GPIO MODE! ERROR <pin>:gpio 号 <dir>: 0: 设置 GPIO 为输 入 1: 设置 GPIO 为输出 <level>: 0: 低电平 1: 高电平 AT+SYSGPIO 系列列的使 用, 请参考 ESP8266 管脚清单 AT+SYSIOSETCFG=12,3,1 // 设置 GPIO12 工作为 GPIO 模式 AT+SYSGPIODIR=12,0 // 设置 GPIO12 为输入 AT+SYSGPIOREAD=12 Espressif! 16/!

24 3. 基础 AT AT+SYSMSG_CUR 设置当前系统消息, 不不保存到 flash 设置 AT+SYSMSG_CUR=<n> <n>: bit0: 控制退出透传的消息 若 bit0 为 0, 退出透传时, 无提示消息 ; 默认为 0 若 bit0 为 1, 退出透传时, 提示消息 +QUITT // Quit transparent transmission bit1: 控制建 立 网络连接的消息 若 bit1 为 0, 网络连接建 立时, 提示消息 <Link_ID>,CONNECT; 默认为 0 若 bit1 为 1, 网络连接建 立时, 提示消息 +LINK_CONN:<status_type>,<link_id>,"UDP/ TCP/SSL",<c/s>,<remote_ip>,<remote_port>,<local_port>; - <status_type> 为 0 表示连接成功, 为 1 表示连接失败 ; - <c/s> 为 0 表示 ESP 作为 client, 为 1 表示 ESP 作为 server 本设置不不保存到 flash 中, 重新上电后失效 AT+SYSMSG_CUR= AT+SYSMSG_DEF 设置默认系统消息, 保存到 flash 设置 AT+SYSMSG_DEF=<n> <n>: bit0: 控制退出透传的消息 若 bit0 为 0, 退出透传时, 无提示消息 ; 默认为 0 若 bit0 为 1, 退出透传时, 提示消息 +QUITT // Quit transparent transmission bit1: 控制建 立 网络连接的消息 若 bit1 为 0, 网络连接建 立时, 提示消息 <Link_ID>, CONNECT; 默认为 0 若 bit1 为 1, 网络连接建 立时, 提示消息 +LINK_CONN:<status_type>,<link_id>,"UDP/ TCP/SSL",<c/s>,<remote_ip>,<remote_port>,<local_port>; - <status_type> 为 0 表示连接成功, 为 1 表示连接失败 ; - <c/s> 为 0 表示 ESP 作为 client, 为 1 表示 ESP 作为 server 本设置保存到 flash 用户参数区, 重新上电后仍然有效 AT+SYSMSG_DEF=3 Espressif! 17/!

25 4. Wi-Fi 功能 AT 4. 基础 AT 4.1. 基础 Wi-Fi 功能 AT 一览表 AT+CWMODE_CUR AT+CWMODE_DEF AT+CWJAP_CUR AT+CWJAP_DEF AT+CWLAPOPT AT+CWLAP AT+CWQAP AT+CWSAP_CUR AT+CWSAP_DEF AT+CWLIF AT+CWDHCP_CUR AT+CWDHCP_DEF AT+CWDHCPS_CUR AT+CWDHCPS_DEF AT+CWAUTOCONN AT+CIPSTAMAC_CUR AT+CIPSTAMAC_DEF AT+CIPAPMAC_CUR AT+CIPAPMAC_DEF AT+CIPSTA_CUR AT+CIPSTA_DEF AT+CIPAP_CUR 说明设置 Wi-Fi 模式 (STA/AP/STA+AP), 不不保存到 Flash 设置 Wi-Fi 模式 (STA/AP/STA+AP), 保存到 Flash 连接 AP, 不不保存到 Flash 连接 AP, 保存到 Flash 设置 AT+CWLAP 扫描结果的属性扫描附近的 AP 信息与 AP 断开连接设置 ESP8266 SoftAP 配置, 不不保存到 Flash 设置 ESP8266 SoftAP 配置, 保存到 Flash 获取连接到 ESP8266 SoftAP 的 station 的信息设置 DHCP, 不不保存到 Flash 设置 DHCP, 保存到 Flash 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 不不保存到 Flash 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 保存到 Flash 设置上电时是否 自动连接 AP 设置 ESP8266 Station 的 MAC 地址, 不不保存到 Flash 设置 ESP8266 Station 的 MAC 地址, 保存到 Flash 设置 ESP8266 SoftAP 的 MAC 地址, 不不保存到 Flash 设置 ESP8266 SoftAP 的 MAC 地址, 保存到 Flash 设置 ESP8266 Station 的 IP 地址, 不不保存到 Flash 设置 ESP8266 Station 的 IP 地址, 保存到 Flash 设置 ESP8266 SoftAP 的 IP 地址, 不不保存到 Flash Espressif! 18/!

26 4. Wi-Fi 功能 AT AT+CIPAP_DEF AT+CWSTARTSMART AT+CWSTOPSMART AT+CWSTARTDISCOVER AT+CWSTOPDISCOVER AT+WPS AT+MDNS AT+CWHOSTNAME AT+CWCOUNTRY_CUR AT+CWCOUNTRY_DEF 设置 ESP8266 SoftAP 的 IP 地址, 保存到 Flash 开始 SmartConfig 停 止 SmartConfig 开启可被局域 网内的微信探测的模式关闭可被局域 网内的微信探测的模式设置 WPS 功能设置 MDNS 功能设置 ESP8266 Station 的主机名称设置 ESP8266 当前 WiFi 国家码设置 ESP8266 默认 WiFi 国家码 Espressif! 19/!

27 4. Wi-Fi 功能 AT 4.2. 基础 Wi-Fi 功能 AT 描述 AT+CWMODE_CUR 设置当前 Wi-Fi 模式, 不不保存到 Flash 查询 : 设置 : 测试 : AT+CWMODE_CUR=? AT+CWMODE_CUR? 功能 : 查询 ESP8266 当前 Wi-Fi 模式 AT+CWMODE_CUR=<mode> 功能 : 设置 ESP8266 当前 Wi-Fi 模式 +CWMODE_CUR:<mode> 取值列表 +CWMODE_CUR:<mode> <mode>: 1:Station 模式 2:SoftAP 模式 3:SoftAP+Station 模式 本设置不不保存到 Flash AT+CWMODE_CUR= AT+CWMODE_DEF 设置当前 Wi-Fi 模式并保存到 Flash 查询 : 设置 : 测试 : AT+CWMODE_DEF=? AT+CWMODE_DEF? 功能 : 查询 ESP8266 当前 Wi-Fi 模式 AT+CWMODE_DEF=<mode> 功能 : 设置 ESP8266 当前 Wi-Fi 模式 +CWMODE_DEF:<mode> 取值列表 +CWMODE_DEF:<mode> <mode>: 1:Station 模式 2:SoftAP 模式 3:SoftAP+Station 模式 本设置保存到 Flash system parameter 区域 AT+CWMODE_DEF=3 Espressif! 20/!

28 4. Wi-Fi 功能 AT AT+CWJAP_CUR 临时连接 AP 查询 : AT+CWJAP_CUR? 功能 : 查询 ESP8266 Station 已连接的 AP 信 息 +CWJAP_CUR:<ssid>,<bssid>,<channel>,<rssi > <ssid>: 字符串串参数,AP 的 SSID <bssid>:ap 的 MAC 地址 <channel>: 信道号 <rssi>: 信号强度 设置 : AT+CWJAP_CUR=<ssid>,<pwd>,[<bssid>][,<pci_en>] 功能 : 设置 ESP8266 Station 需连接的 AP 或者 +CWJAP_CUR:<error code> FAIL <ssid>: 目标 AP 的 SSID <pwd>: 密码最 长 64 字节 ASCII [<bssid>]: 选填参数, 目标 AP 的 MAC 地址, 一 般 用于有多个 SSID 相同的 AP 的情况 [<pci_en>]: 选填参数, 不不允许连接 WEP 和 open 的路路由器器, 可 用于 PCI 认证 <error code>:( 仅供参考, 并不不可靠 ) 1: 连接超时 2: 密码错误 3: 找不不到 目标 AP 4: 连接失败 参数设置需要开启 Station 模式, 若 SSID 或者 password 中含有特殊符号, 例例如, 或者 或者 \ 时, 需要进 行行转义, 其它字符转义 无效 本设置不不保存到 Flash AT+CWJAP_CUR="abc"," " 例例如, 目标 AP 的 SSID 为 "ab\,c",password 为 " "\", 则如下 : AT+CWJAP_CUR="ab\\\,c"," \"\\" 如果有多个 AP 的 SSID 均为 "abc", 可通过 BSSID 确定 目标 AP: AT+CWJAP_CUR="abc"," ","ca:d7:19:d8:a6:44" Espressif! 21/!

29 4. Wi-Fi 功能 AT AT+CWJAP_DEF 连接 AP, 保存到 Flash 查询 : AT+CWJAP_DEF? 功能 : 查询 ESP8266 Station 已连接的 AP 信 息 +CWJAP_DEF:<ssid>,<bssid>,<channel>,<rss i> <ssid>: 字符串串参数,AP 的 SSID <bssid>:ap 的 MAC 地址 <channel>: 信道号 <rssi>: 信号强度 本设置保存到 Flash 系统参数区 AT+CWJAP_DEF="abc"," " 设置 : AT+CWJAP_DEF=<ssid>,<pwd>[,<bssid>][,<pci_en>] 功能 : 设置 ESP8266 Station 需连接的 AP 或者 +CWJAP_DEF:<error code> FAIL <ssid>: 目标 AP 的 SSID <pwd>: 密码最 长 64 字节 ASCII [<bssid>]: 目标 AP 的 MAC 地址, 一般 用于有多 个 SSID 相同的 AP 的情况 [<pci_en>]: 选填参数, 不不允许连接 WEP 和 open 的路路由器器, 可 用于 PCI 认证 <error code>:( 仅供参考, 并不不可靠 ) 1: 连接超时 2: 密码错误 3: 找不不到 目标 AP 4: 连接失败 参数设置需要开启 Station 模式, 若 SSID 或者 password 中含有特殊符号, 例例如, 或者 或者 \ 时, 需要进 行行转义, 其它字符转义 无效 例例如, 目标 AP 的 SSID 为 "ab\,c",password 为 " "\", 则如下 : AT+CWJAP_DEF="ab\\\,c"," \"\\" 如果有多个 AP 的 SSID 均为 "abc", 可通过 BSSID 确定 目标 AP: AT+CWJAP_DEF="abc"," ","ca:d7:19:d8:a6:44" Espressif! 22/!

30 4. Wi-Fi 功能 AT! AT+CWLAPOPT 设置 CWLAP 的属性 设置 AT+CWLAPOPT=<sort_enable>,<mask> <sort_enable>: AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序 : 0: 不不排序 1: 为根据 RSSI 排序 <mask>: 对应 bit 若为 1, 则 AT+CWLAP 的扫描结果显示相关属性, 对应 bit 若为 0, 则不不显 示 具体如下 : bit 0: 设置 AT+CWLAP 的扫描结果是否显示 <ecn> bit 1: 设置 AT+CWLAP 的扫描结果是否显示 <ssid> bit 2: 设置 AT+CWLAP 的扫描结果是否显示 <rssi> bit 3: 设置 AT+CWLAP 的扫描结果是否显示 <mac> bit 4: 设置 AT+CWLAP 的扫描结果是否显示 <channel> bit 5: 设置 AT+CWLAP 的扫描结果是否显示 <freq offset> bit 6: 设置 AT+CWLAP 的扫描结果是否显示 <freq calibration> bit 7: 设置 AT+CWLAP 的扫描结果是否显示 <pairwise_cipher> bit 8: 设置 AT+CWLAP 的扫描结果是否显示 <group_cipher> bit 9: 设置 AT+CWLAP 的扫描结果是否显示 <bgn> bit 10: 设置 AT+CWLAP 的扫描结果是否显示 <wps> AT+CWLAPOPT=1,2047 第 一个参数为 1, 表示后续如果使 用 AT+CWLAP, 扫描结果将按照信号强度 RSSI 值排序 ; 第 二个参数为 2047, 即 0x7FF, 表示 <mask> 的相关 bit 全部置为 1, 后续如果使 用 AT+CWLAP 指 令, 扫描结果将显示所有参数 Espressif! 23/!

31 4. Wi-Fi 功能 AT! AT+CWLAP 扫描当前可 用的 AP 设置 : AT+CWLAP=<ssid>[,<mac>,<channel>,<scan_ type>,<scan_time_min>,<scan_time_max>] 功能 : 列列出符合特定条件的 AP +CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<chann el>,<freq offset>,<freq cali>,<pairwise_cipher>, <group_cipher>,<bgn>,<wps> 执 行行 : AT+CWLAP 功能 : 列列出当前可 用的 AP +CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<channel>,<fre q offset>, <freq cali>,<pairwise_cipher>, <group_cipher>,<bgn>,<wps> [<scan_type>] : 选填参数 0: active scan 1: passive scan [<scan_time_min>] : 选填参数, 单位 ms, 范围 [0,1500] 对于 active scan, 此参数为每个信道的最 小扫描时间 ; 默认值为 0; 对于 passive scan, 此参数 无效 [<scan_time_max>] : 选填参数, 单位 ms, 范围 [0,1500] 对于 active scan, 此参数为每个信道的最 大扫描时间 ; 当设置为 0 时, 采 用默认值 120ms; 对于 passive scan, 此参数为每个信道扫描的时间 ; 默认值为 360ms <ecn>: 加密 方式 0:OPEN 1:WEP 2:WPA_PSK 3:WPA2_PSK 4:WPA_WPA2_PSK 5:WPA2_Enterprise( 目前 AT 不不 支持连接这种加密 AP) <ssid>: 字符串串参数,AP 的 SSID <rssi>: 信号强度 <mac>: 字符串串参数,AP 的 MAC 地址 <channel>: 信道号 <freq offset>:ap 频偏, 单位 :khz 此数值除以 2.4, 可得到 ppm 值 <freq cali>: 频偏校准值 <pairwise_cipher>: 0:CIPHER_NONE 1:CIPHER_WEP40 2:CIPHER_WEP104 3:CIPHER_TKIP 4:CIPHER_CCMP 5:CIPHER_TKIP_CCMP 6:CIPHER_UNKNOWN <group_cipher>: 定义与 <pairwise_cipher> 相同 <bgn>: bit0 代表 b 模式 ; bit1 代表 g 模式 ; bit2 代表 n 模式 若对应 bit 为 1, 表示该模式使能 ; 若对应 bit 为 0, 则该模式未使能 <wps>:0,wps 未使能 ;1,WPS 使能 Espressif! 24/!

32 4. Wi-Fi 功能 AT scan_time_min 不不能 大于 scan_time_max, 即要求 scan_time_max >= scan_time_min 若 scan_time_min 和 scan_time_max 设置均为 0, 则采 用默认值, 默认值具体如下 : 对于 active scan, 每个信道的最 小扫描时间是 0, 最 大扫描时间是 120ms 对于 passive scan, 每个信道扫描的时间是 360ms AT+CWLAP="WiFi","ca:d7:19:d8:a6:44",6,0,50,120, 或者查找指定 SSID 的 AP: AT+CWLAP="WiFi" 或者使能 passive scan 模式 : AT+CWLAP=,,,1,, AT+CWQAP 断开与 AP 的连接 执 行行 AT+CWQAP - Espressif! 25/!

33 4. Wi-Fi 功能 AT! AT+CWSAP_CUR 配置 ESP8266 SoftAP 当前参数 查询 : AT+CWSAP_CUR? 功能 : 查询 ESP8266 SoftAP 的配置参数 +CWSAP_CUR:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid hidden> <ssid>: 字符串串参数, 接 入点名称 <pwd>: 字符串串参数, 密码 长度范围 :8 ~ 64 字节 ASCII <chl>: 通道号 <ecn>: 加密 方式, 不不 支持 WEP 0:OPEN 2:WPA_PSK 3:WPA2_PSK 4:WPA_WPA2_PSK [<max conn>]( 选填参数 ): 允许连 入 ESP8266 SoftAP 的最多 Station 数 目, 取值范围 [1, 8] [<ssid hidden>]( 选填参数 ): 默认为 0, 开启 广播 ESP8266 SoftAP SSID 0: 广播 SSID 1: 不不 广播 SSID 设置 : AT+CWSAP_CUR=<ssid>,<pwd>,<chl>,<ecn>[, <max conn>][,<ssid hidden>] 功能 : 设置 ESP8266 SoftAP 的配置参数 或 ERROR 同左 : 只有在 SoftAP 模式开启后有效 本设置不不保存到 Flash AT+CWSAP_CUR="ESP8266"," ",5, AT+CWSAP_DEF 配置 ESP8266 SoftAP 当前参数, 保存到 Flash 查询 : AT+CWSAP_DEF? 功能 : 查询 ESP8266 SoftAP 的配置参数 +CWSAP_DEF:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid hidden> 设置 : AT+CWSAP_DEF=<ssid>,<pwd>,<chl>,<ecn>[, <max conn>][,<ssid hidden>] 功能 : 设置 ESP8266 SoftAP 的配置参数 或 ERROR Espressif! 26/!

34 4. Wi-Fi 功能 AT! <ssid>: 字符串串参数, 接 入点名称 <pwd>: 字符串串参数, 密码 长度范围 :8 ~ 64 字节 ASCII <chl>: 通道号 <ecn>: 加密 方式, 不不 支持 WEP 0:OPEN 2:WPA_PSK 3:WPA2_PSK 4:WPA_WPA2_PSK [<max conn>]( 选填参数 ): 允许连 入 ESP8266 SoftAP 的最多 Station 数 目, 取值范围 [1, 8] [<ssid hidden>]( 选填参数 ): 默认为 0, 开启 广播 ESP8266 SoftAP SSID 0: 广播 SSID 1: 不不 广播 SSID 同左 : 只有在 SoftAP 模式开启后有效 本设置保存到 Flash system parameter 区域 AT+CWSAP_DEF="ESP8266"," ",5,3 Espressif! 27/!

35 4. Wi-Fi 功能 AT AT+CWLIF 查询连接到 ESP8266 SoftAP 的 Station 信息 执 行行 AT+CWLIF +CWLIF:<ip addr>,<mac> <ip addr>: 连接到 ESP8266 SoftAP 的 Station IP 地址 <mac>: 连接到 ESP8266 SoftAP 的 Station MAC 地址 本 无法查询静态 IP, 仅 支持在 ESP8266 SoftAP 和连 入的 Station DHCP 均使能的情况下有效 AT+CWDHCP_CUR 设置 DHCP, 不不保存到 Flash 查询 : AT+CWDHCP_CUR? 设置 : AT+CWDHCP_CUR=<mode>,<en> 功能 : 设置 DHCP DHCP 是否使能 Bit0: 0:SoftAP DHCP 关闭 1:SoftAP DHCP 开启 Bit1: 0:Station DHCP 关闭 1:Station DHCP 开启 本设置不不保存到 Flash <mode>: 0: 设置 ESP8266 SoftAP 1: 设置 ESP8266 Station 2: 设置 ESP8266 SoftAP 和 Station <en>: 0: 关闭 DHCP 1: 开启 DHCP 本设置与设置静态 IP 的 (AT+CIPSTA 系列列和 AT+CIPAP 系列列 ) 互相影响 : 设置使能 DHCP, 则静态 IP 无效 ; 设置静态 IP, 则 DHCP 关闭 ; 以最后的设置为准 AT+CWDHCP_CUR=0,1 Espressif! 28/

36 4. Wi-Fi 功能 AT AT+CWDHCP_DEF 设置 DHCP, 保存到 Flash 查询 : AT+CWDHCP_DEF? 设置 : AT+CWDHCP_DEF=<mode>,<en> 功能 : 设置 DHCP DHCP 是否使能 Bit0: 0:SoftAP DHCP 关闭 1:SoftAP DHCP 开启 Bit1: 0:Station DHCP 关闭 1:Station DHCP 开启 本设置保存到 Flash 用户参数区 <mode>: 0: 设置 ESP8266 SoftAP 1: 设置 ESP8266 Station 2: 设置 ESP8266 SoftAP 和 Station <en>: 0: 关闭 DHCP 1: 开启 DHCP 本设置与设置静态 IP 的 (AT+CIPSTA 系列列和 AT+CIPAP 系列列 ) 互相影响 : 设置使能 DHCP, 则静态 IP 无效 ; 设置静态 IP, 则 DHCP 关闭 ; 以最后的设置为准 AT+CWDHCP_DEF=0,1 Espressif! 29/

37 4. Wi-Fi 功能 AT AT+CWDHCPS_CUR 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 不不保存到 Flash 设置 : 查询 : AT+CWDHCPS_CUR? +CWDHCPS_CUR=<lease time>,<start IP>,<end IP> <enable>: AT+CWDHCPS_CUR=<enable>,<lease time>,<start IP>,<end IP> 功能 : 设置 ESP8266 SoftAP DHCP 服务器器分配 的 IP 范围 0: 清除设置 IP 范围, 恢复默认值, 后续参数 无需填写 1: 使能设置 IP 范围, 后续参数必须填写 <lease time>: 租约时间, 单位 : 分钟, 取值范围 [1, 2880] <start IP>:DHCP 服务器器 IP 池的起始 IP <end IP>:DHCP 服务器器 IP 池的结束 IP 本设置不不保存到 Flash 本必须在 ESP8266 SoftAP 模式使能, 且开启 DHCP 的情况下使 用, 设置的 IP 范 围必须与 ESP8266 SoftAP 在同 一 网段 AT+CWDHCPS_CUR=1,3," "," " 或者 AT+CWDHCPS_CUR=0 // 清除设置, 恢复默认值 AT+CWDHCPS_DEF 设置 ESP8266 SoftAP DHCP 分配的 IP 范围, 保存到 Flash 设置 : 查询 : AT+CWDHCPS_DEF? +CWDHCPS_DEF=<lease time>,<start IP>,<end IP> <enable>: AT+CWDHCPS_DEF=<enable>,<lease time>,<start IP>,<end IP> 功能 : 设置 ESP8266 SoftAP DHCP 服务器器分配 的 IP 范围 0: 清除设置 IP 范围, 恢复默认值, 后续参数 无需填写 1: 使能设置 IP 范围, 后续参数必须填写 <lease time>: 租约时间, 单位 : 分钟, 取值范围 [1, 2880] <start IP>:DHCP 服务器器 IP 池的起始 IP <end IP>:DHCP 服务器器 IP 池的结束 IP Espressif! 30/

38 4. Wi-Fi 功能 AT! 本设置保存到 Flash 用户参数区 本必须在 ESP8266 SoftAP 模式使能, 且开启 DHCP 的情况下使 用, 设置的 IP 范 围必须与 ESP8266 SoftAP 在同 一 网段 AT+CWDHCPS_DEF=1,3," "," " 或者 AT+CWDHCPS_DEF=0 // 清除设置, 恢复默认值 AT+CWAUTOCONN 上电是否 自动连接 AP 设置 AT+CWAUTOCONN=<enable> <enable>: 0: 上电不不 自动连接 AP 1: 上电 自动连接 AP ESP8266 Station 默认上电 自动连接 AP 本设置保存到 Flash 系统参数区 AT+CWAUTOCONN= AT+CIPSTAMAC_CUR 设置 ESP8266 Station 当前 MAC 地址, 不不保存到 Flash 查询 : AT+CIPSTAMAC_CUR? +CIPSTAMAC_CUR:<mac> 设置 : AT+CIPSTAMAC_CUR=<mac> 功能 : 设置 ESP8266 Station 的 MAC 地址 <mac>: 字符串串参数,ESP8266 Station 的 MAC 地址 本设置不不保存到 Flash ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 ESP8266 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "18: " 但不不能为 "15: " AT+CIPSTAMAC_CUR="18:fe:35:98:d3:7b" Espressif! 31/

39 4. Wi-Fi 功能 AT! AT+CIPSTAMAC_DEF 设置 ESP8266 Station 当前 MAC 地址, 保存到 Flash 查询 : AT+CIPSTAMAC_DEF? +CIPSTAMAC_DEF:<mac> 设置 : AT+CIPSTAMAC_DEF=<mac> 功能 : 设置 ESP8266 Station 的 MAC 地址 <mac>: 字符串串参数,ESP8266 Station 的 MAC 地址 本设置保存到 Flash 用户参数区 ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 ESP8266 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "18: " 但不不能为 "15: " AT+CIPSTAMAC_DEF="18:fe:35:98:d3:7b" AT+CIPAPMAC_CUR 设置 ESP8266 SoftAP 当前 MAC 地址, 不不保存到 Flash 查询 : AT+CIPAPMAC_CUR? 功能 : 查询 ESP8266 SoftAP 的 MAC 地址 +CIPAPMAC_CUR:<mac> 设置 : AT+CIPAPMAC_CUR=<mac> 功能 : 设置 ESP8266 SoftAP 的 MAC 地址 <mac>: 字符串串参数,ESP8266 SoftAP 的 MAC 地址 本设置不不保存到 Flash ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 ESP8266 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "18: " 但不不能为 "15: " AT+CIPAPMAC_CUR="1a:fe:36:97:d5:7b" AT+CIPAPMAC_DEF 设置 ESP8266 SoftAP 默认 MAC 地址, 保存到 Flash 查询 : AT+CIPAPMAC_DEF? 功能 : 查询 ESP8266 SoftAP 的 MAC 地址 +CIPAPMAC_DEF:<mac> 设置 : AT+CIPAPMAC_DEF=<mac> 功能 : 设置 ESP8266 SoftAP 的 MAC 地址 Espressif! 32/

40 4. Wi-Fi 功能 AT <mac>: 字符串串参数,ESP8266 SoftAP 的 MAC 地址 本设置保存到 Flash 用户参数区 ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 ESP8266 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "18: " 但不不能为 "15: " AT+CIPAPMAC_DEF="1a:fe:36:97:d5:7b" AT+CIPSTA_CUR 设置 ESP8266 Station 的 IP 地址, 不不保存到 Flash 查询 : AT+CIPSTA_CUR? 功能 : 查询 ESP8266 Station 的 IP 地址 +CIPSTA_CUR:<ip> +CIPSTA_CUR:<gateway> +CIPSTA_CUR:<netmask> : ESP8266 Station IP 需连上 AP 后, 才可以查询 本设置不不保存到 Flash 设置 : AT+CIPSTA_CUR=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP8266 Station 的 IP 地址 <ip>: 字符串串,ESP8266 Station 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPSTA_CUR=" "," "," " AT+CIPSTA_DEF 设置 ESP8266 Station 的 IP 地址, 保存到 Flash 查询 : AT+CIPSTA_DEF? 功能 : 查询 ESP8266 Station 的 IP 地址 +CIPSTA_DEF:<ip> +CIPSTA_DEF:<gateway> +CIPSTA_DEF:<netmask> 设置 : AT+CIPSTA_DEF=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP8266 Station 的 IP 地址 Espressif! 33/

41 4. Wi-Fi 功能 AT : ESP8266 Station IP 需连上 AP 后, 才可以查询 本设置保存到 Flash 用户参数区 <ip>: 字符串串,ESP8266 Station 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPSTA_DEF=" "," "," " AT+CIPAP_CUR 设置 ESP8266 SoftAP 的 IP 地址, 不不保存到 Flash 查询 : AT+CIPAP_CUR? 功能 : 查询 ESP8266 SoftAP 的 IP 地址 +CIPAP_CUR:<ip> +CIPAP_CUR:<gateway> +CIPAP_CUR:<netmask> 设置 : AT+CIPAP_CUR=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP8266 SoftAP 的 IP 地址 <ip>: 字符串串,ESP8266 SoftAP 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 本设置不不保存到 Flash 目前仅 支持 C 类 IP 地址 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPAP_CUR=" "," "," " AT+CIPAP_DEF 设置 ESP8266 SoftAP 的 IP 地址, 保存到 Flash 查询 : AT+CIPAP_DEF? 功能 : 查询 ESP8266 SoftAP 的 IP 地址 设置 : AT+CIPAP_DEF=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP8266 SoftAP 的 IP 地址 Espressif! 34/

42 4. Wi-Fi 功能 AT +CIPAP_DEF:<ip> +CIPAP_DEF:<gateway> +CIPAP_DEF:<netmask> <ip>: 字符串串,ESP8266 SoftAP 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 本设置保存到 Flash 用户参数区 目前仅 支持 C 类 IP 地址 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPAP_DEF=" "," "," " AT+CWSTARTSMART 开启 SmartConfig 执 行行 : AT+CWSTARTSMART 功能 : 开启 SmartConfig (SmartConfig 类型为 ESP- TOUCH+AirKiss) <type>: 1:ESP-TOUCH 2:AirKiss 3:ESP-TOUCH+AirKiss SmartConfig 连接过程中的提示信息如下 : 设置 : AT+CWSTARTSMART=<type> 功能 : 开启某指定类型的 SmartConfig 说明 smartconfig type: <type> // AIRKISS, ESPTOUCH or UNKNOWN smart get wifi info // got SSID and password ssid:<ap's SSID> password:<ap's password> // ESP8266 will try to connect to the AP WIFI CONNECTED WIFI GOT IP smartconfig connected wifi // if the connection failed, it will prompt "smartconfig connect fail" Espressif! 35/

43 4. Wi-Fi 功能 AT! 用户可以参考 ESP-TOUCH 用户指南来了了解 SmartConfig 的详细介绍 仅 支持在 ESP8266 单 Station 模式下调 用 消息 smart get wifi info 表示 SmartConfig 成功获取到 AP 信息, 之后 ESP8266 尝试连接 AP, 打印连接过程 消息 smartconfig connected wifi 表示成功连接到 AP, 此时可以调 用 AT+CWSTOPSMART 停 止 SmartConfig 再执 行行其他, 在 SmartConfig 过程中请勿执 行行其他 从 AT_v1.0 开始,SmartConfig 可以 自动获取协议类型,AirKiss 或者 ESP-TOUCH 用户如果 无需 SmartConfig 功能, 可以参考章节 1.1 自 行行重新编译 at, 在 user_config.h 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE, 从 而减 小 bin size, 节省内存 AT+CWMODE=1 AT+CWSTARTSMART AT+CWSTOPSMART 停 止 SmartConfig 执 行行 AT+CWSTOPSMART - 无论 SmartConfig 成功与否, 都请调 用 AT+CWSTOPSMART 释放快连占 用的内存 AT+CWSTOPSMART AT+CWSTARTDISCOVER 开启可被局域 网内微信探测模式 设置 AT+CWSTARTDISCOVER= <WeChat number>,<dev_type>,<time> <WeChat number>: 微信公众号, 必须从微信获取 <dev_type>: 设备类型, 必须从微信获取 <time>: 主动发包时间间隔, 取值范围 :0 ~ 24x3600, 单位 : 秒 0:ESP8266 不不主动向外发包, 需要 手机微信查询时才回复 其他值 :ESP8266 主动发包的时间间隔, 以便便于局域 网中的 手机微信发现本设备 可参考微信官 网内 网发现功能的介绍 本需在 ESP8266 Station 连 入局域 网, 获得 IP 地址后 生效 AT+CWSTARTDISCOVER="gh_9e2cff3dfa51","122475",10 Espressif! 36/

44 4. Wi-Fi 功能 AT AT+CWSTOPDISCOVER 关闭可被局域 网内微信探测模式 执 行行 AT+CWSTOPDISCOVER AT+CWSTOPDISCOVER AT+WPS 设置 WPS 功能 设置 AT+WPS=<enable> <enable>: 1: 开启 WPS 0: 关闭 WPS WPS 功能必须在 ESP8266 Station 使能的情况下调 用 WPS 不不 支持 WEP 加密 方式 AT+CWMODE=1 AT+WPS= AT+MDNS 设置 MDNS 功能 设置 AT+MDNS=<enable>,<hostname>,<server_name>,<server_port> 或 opmode mismatch when mdns ERROR <enable>: 1: 开启 MDNS 功能, 后续参数需要填写 0: 关闭 MDNS 功能, 后续参数 无需填写 <hostname>:mdns 主机名称 <server_name>:mdns 服务器器名称 <server_port>:mdns 服务器器端 口 <hostname> 和 <server_name> 不不能包含特殊字符 ( 例例如. 符号 ), 或者设置为协议名称 ( 例例如不不能定义为 http) ESP8266 SoftAP 模式暂时不不 支持 MDNS 功能 Espressif! 37/

45 4. Wi-Fi 功能 AT! AT+MDNS=1,"espressif","iot", AT+CWHOSTNAME 设置 ESP8266 Station 的主机名称 查询 : AT+CWHOSTNAME? 功能 : 查询 ESP8266 Station 的主机名称 +CWHOSTNAME:<host name> 如果未使能 ESP8266 Station 模式, 则返回 +CWHOSTNAME:<null> <hostname>: 主机名称, 最 长 32 字节 设置 : AT+CWHOSTNAME=<hostname> 功能 : 设置 ESP8266 Station 的主机名称 如果成功, 返回 如果未使能 ESP8266 station 模式, 则提示 ERROR 本设置不不保存到 Flash, 重启后将恢复默认值 ESP8266 Station 默认的主机名称为 ESP_MAC 地址低 3 个字节 例例如, +CWHOSTNAME:<ESP_A378DA> AT+CWMODE=3 AT+CWHOSTNAME="my_test" AT+CWCOUNTRY_CUR 设置 ESP8266 WiFi 国家码 查询 : AT+CWCOUNTRY_CUR? 功能 : 查询 ESP8266 WiFi 国家码 +CWCOUNTRY_CUR:<country_policy>,<cou ntry_code>,<start_channel>,<total_ch annel_number> : 查询返回值为实际的国家码信息 如果设置为跟随 AP 切换, 则查询值可能 与之前的设置值不不同 设置 : AT+CWCOUNTRY_CUR=<country_policy>,<country _code>,<start_channel>,<total_channel_numb er> 功能 : 设置 ESP8266 WiFi 国家码 Espressif! 38/

46 4. Wi-Fi 功能 AT <country_policy>: 0: 根据 AP 自动切换国家信息 ; 1: 使 用设置的国家信息 <country_code>: 国家码字符串串, 长度最多 支持三个字符 ; 第三个为特殊字符, 在查询时不不 显示 <start_channel> : 起始信道号 <total_channel_number> : 总信道个数 本设置不不保存到 Flash, 重启后将恢复默认值 AT+CWMODE=3 AT+CWCOUNTRY_CUR=1,"CN",1, AT+CWCOUNTRY_DEF 设置默认的 ESP8266 WiFi 国家码, 并保存到 flash 查询 : AT+CWCOUNTRY_DEF? 功能 : 查询 ESP8266 WiFi 国家码 +CWCOUNTRY_DEF:<country_policy>,<cou ntry_code>,<start_channel>,<total_ch annel_number> : 查询返回值为保存在 flash 的默认国家码 信息 即使设置为跟随 AP 切换, 查询值仍然与 之前的设置值 一致 设置 : AT+CWCOUNTRY_DEF=<country_policy>,<country _code>,<start_channel>,<total_channel_numb er> 功能 : 设置 ESP8266 WiFi 国家码 <country_policy>: 0: 根据 AP 自动切换国家信息 ; 1: 使 用设置的国家信息 <country_code>: 国家码字符串串, 长度最多 支持三个字符 ; 第三个为特殊字符, 在查询时不不显示 <start_channel> : 起始信道号 <total_channel_number> : 总信道个数 本设置将保存到 Flash 用户参数区 AT+CWMODE=3 AT+CWCOUNTRY_DEF=1,"CN",1,13 Espressif! 39/

47 5. TCP/IP 功能 AT 5. TCP/IP 功能 AT 5.1. TCP/IP 一览表 描述 AT+CIPSTATUS AT+CIPDOMAIN AT+CIPSTART AT+CIPSSLSIZE AT+CIPSSLCCONF AT+CIPSEND AT+CIPSENDEX AT+CIPSENDBUF 查询 网络连接信息域名解析功能建 立 TCP 连接,UDP 传输或者 SSL 连接设置 SSL buffer 大 小配置 ESP SSL client 发送数据发送数据, 达到设置 长度, 或者遇到字符 \0, 则发送数据数据写 入 TCP 发包缓存 AT+CIPBUFRESET 重置计数 (TCP 发包缓存 ) AT+CIPBUFSTATUS AT+CIPCHECKSEQ AT+CIPCLOSE AT+CIFSR AT+CIPMUX AT+CIPSERVER AT+CIPSERVERMAXCONN AT+CIPMODE AT+SAVETRANSLINK AT+CIPSTO AT+PING AT+CIUPDATE AT+CIPDINFO AT+CIPRECVMODE AT+CIPRECVDATA AT+CIPRECVLEN 查询 TCP 发包缓存的状态查询写 入 TCP 发包缓存的某包是否成功发送关闭 TCP/UDP/SSL 传输查询本地 IP 地址设置多连接模式设置 TCP 服务器器设置服务器器允许建 立的最 大连接数 设置透传模式保存透传连接到 Flash 设置 ESP8266 作为 TCP 服务器器时的超时时间 Ping 功能通过 Wi-Fi 升级软件接收 网络数据时,+IPD 是否提示对端 IP 和端 口设置 TCP 接收模式 TCP 被动接收模式下, 读取缓存的 TCP 数据 TCP 被动接收模式下, 查询缓存 TCP 数据的 长度 Espressif! 40/

48 5. TCP/IP 功能 AT AT+CIPSNTPCFG AT+CIPSNTPTIME AT+CIPDNS_CUR AT+CIPDNS_DEF 设置时域和 SNTP 服务器器查询 SNTP 时间 自定义 DNS 服务器器, 设置不不保存到 flash 自定义 DNS 服务器器, 设置保存到 flash 5.2. TCP/IP 描述 AT+CIPSTATUS 查询 网络连接信息 执 行行 AT+CIPSTATUS STATUS:<stat> +CIPSTATUS:<link ID>,<type>,<remote IP>,<remote port>,<local port>,<tetype> <stat>:esp8266 Station 接 口的状态 2:ESP8266 Station 已连接 AP, 获得 IP 地址 3:ESP8266 Station 已建 立 TCP 或 UDP 传输 4:ESP8266 Station 断开 网络连接 5:ESP8266 Station 未连接 AP <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数,"TCP" 或者 "UDP" <remote IP>: 字符串串, 远端 IP 地址 <remote port>: 远端端 口值 <local port>:esp8266 本地端 口值 <tetype>: 0:ESP8266 作为客户端 1:ESP8266 作为服务器器 AT+CIPDOMAIN 域名解析功能 执 行行 AT+CIPDOMAIN=<domain name> +CIPDOMAIN:<IP address> 或者 DNS Fail ERROR <domain name>: 待解析的域名, 可 支持 长度 小于 64 的域名 Espressif! 41/

49 5. TCP/IP 功能 AT AT+CWMODE=1 AT+CWJAP="SSID","password" AT+CIPDOMAIN="iot.espressif.cn" // set Station mode // access to the internet // DNS function AT+CIPSTART 建 立 TCP 连接,UDP 传输或 SSL 连接 建 立 TCP 连接 设置 TCP 单连接 (AT+CIPMUX=0) 时 : AT+CIPSTART=<type>,<remote IP>,<remote port>[,<tcp keep alive>] 或 ERROR 如果连接已经存在, 则返回 ALREADY CONNECTED TCP 多连接 (AT+CIPMUX=1) 时 : AT+CIPSTART=<link ID>,<type>,<remote IP>,<remote port>[,<tcp keep alive>] <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<TCP keep alive>]:tcp keep-alive 侦测时间, 默认关闭此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为 1s AT+CIPSTART="TCP","iot.espressif.cn",8000 AT+CIPSTART="TCP"," ",1000 详细请参考 ESP8266 AT 使 用 建 立 UDP 传输 设置 单连接模式 (AT+CIPMUX=0) 时 : AT+CIPSTART=<type>,<remote IP>,<remote port>[,(<udp local port>),(<udp mode>)] 或 ERROR 如果连接已经存在, 则返回 : ALREADY CONNECTED 多连接模式 (AT+CIPMUX=1) 时 : AT+CIPSTART=<link ID>,<type>,<remote IP>,<remote port>[,(<udp local port>), (<UDP mode>)] Espressif! 42/

50 5. TCP/IP 功能 AT <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<UDP local port>]:udp 传输时, 设置本地端 口 [<UDP mode>]:udp 传输的属性, 若透传, 则必须为 0 0: 收到数据后, 不不更更改远端 目标, 默认值为 0 1: 收到数据后, 改变 一次远端 目标 2: 收到数据后, 改变远端 目标 : 使 用 <UDP mode> 必须先填写 <UDP local port> AT+CIPSTART="UDP"," ",1000,1002,2 详细请参考 ESP8266 AT 使 用 建 立 SSL 连接 设置 AT+CIPSTART=[<link ID>,]<type>,<remote IP>,<remote port>[,<tcp keep alive>] 或 ERROR 如果连接已经存在, 则返回 : ALREADY CONNECTED <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<TCP keep alive>]:tcp keep-alive 侦测时间, 默认关闭此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为 1s ESP8266 最多仅 支持建 立 1 个 SSL 连接 SSL 连接不不 支持透传 SSL 需要占 用较多空间, 如果空间不不 足, 会导致系统重启 用户可以使 用 AT+CIPSSLSIZE=<size> 增 大 SSL 缓存 AT+CIPSSLSIZE=4096 AT+CIPSTART="SSL","iot.espressif.cn",8443 Espressif! 43/

51 5. TCP/IP 功能 AT! AT+CIPSSLSIZE 设置 SSL Buffer 容量量 设置 AT+CIPSSLSIZE=<size> <size>:ssl buffer 大 小, 取值范围 :[2048, 4096] AT+CIPSSLSIZE= AT+CIPSSLCCONF 配置 SSL Client 查询 : AT+CIPSSLCCONF? 功能 : 查询 ESP32 作为 SSL client 时的认证 方式 +CIPSSLCCONF:<SSL mode> <SSL mode>:ssl 认证 方式 设置 : AT+CIPSSLCCONF=<SSL mode> 功能 : 配置 ESP32 作为 SSL client 时的认证 方式 bit0: 是否加载 cert 和 private key, 以供 server 认证 bit1: 是否加载 CA, 认证 server 的 cert 和 private key 如需设置本, 请在建 立 SSL 连接之前调 用 本设置对所有 SSL 连接均 生效 如需证书认证, 请参考 文档 ESP8266 SSL 指南第 4 章 ESP8266 作为 SSL Client, 生成 SSL 所需证书 - esp_cert_private_key.bin 默认烧录到地址 0xFC000 - esp_ca_cert.bin 默认烧录到地址 0xFB000 - 用户可以 自 行行修改 user_main.c 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址, 重新编译指定位置 本设置将保存到 flash 用户参数区 如果 AT+SAVETRANSLINK 设置为 SSL 透传, 那么开机透传时,SSL 连接将根据本配置进 行行连接 AT+CWMODE=1 // 设置 sta 模式 AT+CWJAP="SSID","PASSWORD" // 连接路路由器器, 连接 网络 AT+CIPSNTPCFG=1,8 // 设置时区 AT+CIPSNTPTIME? // 查询当前时间 AT+CIPSSLCCONF=2 AT+CIPSTART="SSL"," ",8443 Espressif! 44/

52 5. TCP/IP 功能 AT! AT+CIPSEND 发送数据 设置 : 1. 单连接时 :(+CIPMUX=0) AT+CIPSEND=<length> 2. 多连接时 :(+CIPMUX=1) AT+CIPSEND=<link ID>,<length> 3. 如果是 UDP 传输, 可以设置远端 IP 和端 口 : AT+CIPSEND=[<link ID>,]<length> [,<remote IP>,<remote port>] 功能 : 在普通传输模式时, 设置发送数据的 长 度 执 行行 : AT+CIPSEND 功能 : 在透传模式时, 开始发送数据 发送指定 长度的数据 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 <length> 时发送数 据, 回到普通模式, 等待下 一条 AT 指 令 如果未建 立连接或连接被断开, 返回 : ERROR 如果数据发送成功, 返回 : SEND 如果数据发送失败, 返回 : SEND FAIL <link ID>: 网络连接 ID 号 (0 ~ 4), 用于多 连接的情况 <length>: 数字参数, 表明发送数据的 长度, 最 大 长度为 2048 [<remote IP>]:UDP 传输可以设置对端 IP [<remote port>]:udp 传输可以设置对端 端 口 详细请参考 ESP8266 AT 使 用 收到此命令后先换 行行返回 > 进 入透传模式发送数据, 每包最 大 2048 字节, 或者每包数据以 20 ms 间隔区分 当输 入单独 一包 +++ 时, 返回普通 AT 模式 发送 +++ 退出透传时, 请 至少间隔 1 秒再发下 一条 AT 本必须在开启透传模式以及单连接下使 用 若为 UDP 透传, AT+CIPSTART 参数 <UDP mode> 必须为 0 - Espressif! 45/

53 5. TCP/IP 功能 AT! AT+CIPSENDEX 发送数据 1. 单连接时 :(+CIPMUX=0) AT+CIPSENDEX=<length> 2. 多连接时 :(+CIPMUX=1) 设置 AT+CIPSENDEX=<link ID>,<length> 3. 如果是 UDP 传输, 可以设置远端 IP 和端 口 : AT+CIPSENDEX=[<link ID>,]<length>[,<remote IP>,<remote port>] 功能 : 在普通传输模式时, 设置发送数据的 长度 发送指定 长度的数据 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 length 或者遇到字符 \0 时, 发送数据 如果未建 立连接或连接被断开, 返回 : ERROR 如果数据发送成功, 返回 : SEND 如果数据发送失败, 返回 : SEND FAIL <link ID>: 网络连接 ID 号 (0 ~ 4), 用于多连接的情况 <length>: 数字参数, 表明发送数据的 长度, 最 大 长度为 2048 当接收数据 长度满 length 或者遇到字符 \0 时, 发送数据, 回到普通模式, 等待下 一 条 AT 用户如需发送 \0, 请转义为 \\ AT+CIPSENDBUF 数据写 入 TCP 发包缓存 1. 单连接时 :(+CIPMUX=0) 设置 AT+CIPSENDBUF=<length> 2. 多连接时 :(+CIPMUX=1) AT+CIPSENDBUF=<link ID>,<length> Espressif! 46/

54 5. TCP/IP 功能 AT < 本次 segment ID>,< 已成功发送的 segment ID> > 收到此命令后先返回 packet ID, 再换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 length 或者遇到字符 \0 时, 发送数据 ; 超过 length 的数据丢弃, 并提示 busy 如果未建 立连接或并 非 TCP 连接或 buffer 满等出错, 返回 : ERROR 如果某包数据发送成功 单连接时, 返回 : <segment ID>,SEND 多连接时, 返回 : <link ID>,<segment ID>,SEND 如果数据发送失败, 返回 : SEND FAIL <link ID>: 网络连接 ID 号 (0 ~ 4), 用于多连接的情况 ; <segment ID>:uint32, 给每包写 入数据分配的 ID, 从 1 开始计数, 每写 入 一包则 自加 一, 计数满则重新从 1 计数 ; <length>: 数据 长度, 超过 长度的数据则丢弃 说明 本将数据写 入 TCP 发包缓存, 无需等待 SEND, 可连续调 用 ; 发送成功后, 会返回数 据包 ID 及 SEND 在数据没有传 入完成时, 传 入 +++ 可退出发送, 之前传 入的数据将直接丢弃 SSL 连接不不 支持使 用本 AT+CIPBUFRESET 重新计数 1. 单连接时 :(+CIPMUX=0) 设置 AT+CIPBUFRESET 2. 多连接时 :(+CIPMUX=1) AT+CIPBUFRESET=<link ID> 如果有数据包未发送完毕, 或者连接不不存在, 则返回 : ERROR <link ID>: 网络连接 ID 号 (0 ~ 4), 用于多连接的情况 本基于 AT+CIPSENDBUF 实现功能 Espressif! 47/

55 5. TCP/IP 功能 AT! AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态 1. 单连接时 :(+CIPMUX=0) 设置 AT+CIPBUFSTATUS 2. 多连接时 :(+CIPMUX=1) AT+CIPBUFSTATUS=<link ID> < 下次的 segment ID>,< 已发送的 segment ID>,< 成功发送的 segment ID>,<remain buffer size>,<queue number> < 下次的 segment ID>: 下次调 用 AT+CIPSENDBUF 将分配的 ID; < 已发送的 segment ID>: 已发送的 TCP 数据包 ID; 仅当 < 下次的 segment ID> - < 已发送的 segment ID> = 1 的情况下, 可调 用 AT+CIPBUFRESET 重置计数 < 成功发送的 segment ID>: 成功发送的 TCP 数据包 ID; <remain buffer size>:tcp 发包缓存剩余的空间 ; <queue number>: 底层可 用的 queue 数 目, 并不不可靠, 仅供参考 本不不 支持对 SSL 连接使 用 例例如, 单连接时 AT+CIPBUFSTATUS 的返回值为 : 20,15,10,200,7 说明 : 20: 表示当前数据包序号已经分配到了了 19, 下次调 用 AT+CIPSENDBUF 将为数据包分配 序号 20; 15: 表示当前已发送了了序号为 15 的数据包, 但并不不 一定发送成功了了 ; 10: 表示成功发送到了了序号为 10 的数据包 ; 200: 表示 网络层 TCP 发包缓存剩余的空间为 200 bytes; 7: 表示当前 网络层还剩余 7 个 queue 供数据传输, 仅供参考, 并不不可靠 ; 当 queue 为 0 时, 不不允许数据发送 AT+CIPCHECKSEQ 查询写 入 TCP 发包缓存的某包是否发送成功 1. 单连接时 :(+CIPMUX=0) 设置 AT+CIPCHECKSEQ=<segment ID> 2. 多连接时 :(+CIPMUX=1) AT+CIPCHECKSEQ=<link ID>,<segment ID> [<link ID>,]<segment ID>,<status> Espressif! 48/

56 5. TCP/IP 功能 AT 最多记录最后的 32 个 segment ID 数据包的状态 [<link ID>]: 网络连接 ID (0~4), 用于多连接的情况 ; <segment ID>: 调 用 AT+CIPSENDBUF 写 入数据时分配的 ID; <status>: FALSE: 发送失败 ; TRUE: 发送成功 本基于 AT+CIPSENDBUF 实现功能 AT+CIPCLOSEMODE 设置 TCP 连接的断开 方式 1. 单连接时 :(+CIPMUX=0) AT+CIPCLOSEMODE=<enable_abort> 2. 多连接时 :(+CIPMUX=1) AT+CIPCLOSEMODE=<link ID>,<enable_abort> <link ID>: 连接 ID 号 <enable_abort>: 断开 方式 ;0, 正常断开 ;1,abort 强制断开 默认 TCP 连接为正常断开模式 一般不不建议使 用 abort 强制断开模式 如需设置为 abort 强制断开模式 : - 需在 TCP 连接建 立之后设置 ; - 设置仅对当次连接有效 ; 如果当前 TCP 连接断开, 重新建 立连接后, 需要重新设置 ; 设置仅对普通 TCP 连接有效, 对 SSL 连接 无效 AT+CIPSTART=0,"TCP"," ",3400 AT+CIPCLOSEMODE=0,1 AT+CIPCLOSE= AT+CIPCLOSE 关闭 TCP/UDP/SSL 传输 设置 ( 用于多连接的情况 ): AT+CIPCLOSE=<link ID> 功能 : 关闭 TCP/UDP 传输 <link ID>: 需要关闭的连接 ID 号 当 ID 为 5 时, 关闭所有连接 ( 开启 server 后 ID 为 5 无效 ) 执 行行 ( 用于单连接的情况 ): AT+CIPCLOSE - Espressif! 49/

57 5. TCP/IP 功能 AT! AT+CIFSR 查询本地 IP 地址 执 行行 AT+CIFSR +CIFSR:APIP,<SoftAP IP address> +CIFSR:APMAC,<SoftAP MAC address> +CIFSR:STAIP,<Station IP address> +CIFSR:STAMAC,<Station MAC address> <IP address>: ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 <MAC address>: ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址 ESP8266 Station IP 需连上 AP 后, 才可以查询 AT+CIPMUX 设置多连接 查询 : AT+CIPMUX? +CIPMUX:<mode> <mode>: 0: 单连接模式 1: 多连接模式 设置 : AT+CIPMUX=<mode> 功能 : 设置连接类型 默认为单连接 ; 只有 非透传模式 (AT+CIPMODE=0), 才能设置为多连接 ; 必须在没有连接建 立的情况下, 设置连接模式 ; 如果建 立了了 TCP 服务器器, 想切换为单连接, 必须关闭服务器器 (AT+CIPSERVER=0), 服务器器仅 支 持多连接 AT+CIPMUX= AT+CIPSERVER 建 立 TCP 服务器器 设置 AT+CIPSERVER=<mode>[,<port>] Espressif! 50/

58 5. TCP/IP 功能 AT <mode>: 0: 关闭服务器器 1: 建 立服务器器 <port>: 端 口号, 默认为 333 多连接情况下 (AT+CIPMUX=1), 才能开启 TCP 服务器器 创建 TCP 服务器器后, 自动建 立 TCP 服务器器监听 当有 TCP 客户端接 入, 会 自动占 用 一个连接 ID AT+CIPMUX=1 AT+CIPSERVER=1, AT+CIPSERVERMAXCONN 设置服务器器允许建 立的最 大连接数 * 查询 : AT+CIPSERVERMAXCONN? 功能 : 查询服务器器允许建 立的最 大连接数 +CIPSERVERMAXCONN:<num> 设置 : AT+CIPSERVERMAXCONN=<num> 功能 : 设置服务器器允许建 立的最 大连接数 <num>: 服务器器允许建 立的最 大连接数, 取值范围 :[1, 5] 如需设置最 大连接数, 请在创建服务器器之前设置 AT+CIPMUX=1 AT+CIPSERVERMAXCONN=2 AT+CIPSERVER=1, AT+CIPMODE 设置传输模式 查询 : AT+CIPMODE? 功能 : 查询传输模式 +CIPMODE:<mode> 设置 : AT+CIPMODE=<mode> 功能 : 设置传输模式 <mode>: 0: 普通传输模式 1: 透传模式, 仅 支持 TCP 单连接和 UDP 固定通信对端的情况 本设置不不保存到 Flash 透传模式传输时, 如果连接断开,ESP8266 会不不停尝试重连, 此时单独输 入 +++ 退出透传, 则停 止重连 ; 普通传输模式则不不会重连, 提示连接断开 AT+CIPMODE=1 Espressif! 51/

59 5. TCP/IP 功能 AT! AT+SAVETRANSLINK 保存透传到 Flash 保存透传 (TCP 单连接 ) 到 Flash 设置 AT+SAVETRANSLINK=<mode>,<remote IP or domain name>,<remote port>[,<type>,<tcp keep alive>] <mode>: 0: 取消开机透传 1: 保存开机进 入透传模式 <remote IP>: 远端 IP 或者域名 <remote port>: 远端端 口 [<type>]( 选填参数 ):TCP 或者 UDP, 缺省默认为 TCP [<TCP keep alive>]( 选填参数 ):TCP keep-alive 侦测, 缺省默认关闭此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为秒 本设置将透传模式及建 立的 TCP 连接均保存在 Flash system parameter 区域, 下次上电 自动 建 立 TCP 连接并进 入透传 只要远端 IP, 端 口的值符合规范, 本设置就会被保存到 Flash AT+SAVETRANSLINK=1," ",1002,"TCP" 保存透传 (UDP 传输 ) 到 Flash 设置 AT+SAVETRANSLINK=<mode>,<remote IP>,<remote port>,<type>[,<udp local port>] <mode>: 0: 取消开机透传 1: 保存开机进 入透传模式 <remote IP>: 远端 IP <remote port>: 远端端 口 <type>:udp, 缺省默认为 TCP [<UDP local port>]( 选填参数 ): 开机进 入 UDP 传输时, 使 用的本地端 口 本设置将透传模式及建 立的 UDP 传输均保存在 Flash 用户参数区, 下次上电 自动建 立 UDP 传输并进 入透传 只要远端 IP, 端 口的数值符合规范, 本设置就会被保存到 Flash AT+SAVETRANSLINK=1," ",1002,"UDP",1005 Espressif! 52/

60 5. TCP/IP 功能 AT AT+CIPSTO 设置 TCP 服务器器超时时间 查询 : AT+CIPSTO? 功能 : 查询 TCP 服务器器超时时间 +CIPSTO:<time> 设置 : AT+CIPSTO=<time> 功能 : 设置 TCP 服务器器超时时间 <time>:tcp 服务器器超时时间, 取值范围 0 ~ 7200s ESP8266 作为 TCP 服务器器, 会断开 一直不不通信直 至超时了了的 TCP 客户端连接 如果设置 AT+CIPSTO=0, 则永远不不会超时, 不不建议这样设置 AT+CIPMUX=1 AT+CIPSERVER=1,1001 AT+CIPSTO= AT+PING Ping 功能 设置 AT+PING=<IP> 功能 :ping 功能 +<time> 或 +timeout ERROR <IP>: 字符串串参数,IP 地址 <time>:ping 时间 AT+PING=" " AT+PING=" AT+CIUPDATE 通过 Wi-Fi 升级软件 执 行行 AT+ CIUPDATE 功能 : 软件升级 +CIPUPDATE:<n> Espressif! 53/

61 5. TCP/IP 功能 AT <n>: 1: 找到服务器器 2: 连接到服务器器 3: 获得软件版本 4: 开始升级 说明 升级过程由于 网络条件的好坏, 有快慢差异 ; 升级失败会提示 ERROR, 请耐 心等待 若直接使 用乐鑫提供的 AT BIN (/ESP8266_NONOS_SDK/bin/at), 本将从 Espressif Cloud 下载 AT 固件升级 若 用户 自 行行编译 AT 源代码, 则请 自 行行实现 AT+CIUPDATE 的升级功能, 乐鑫提供本地升级的 Demo 作为参考 (/ESP8266_NONOS_SDK/example/at) 建议升级 AT 固件后, 调 用 AT+RESTORE 恢复出 厂设置, 重新初始化 AT+CIPDINFO 接收 网络数据时是否提示对端 IP 和端 口 设置 AT+CIPDINFO=<mode> 功能 : 接收 网络数据时,+IPD 是否提示对端 IP 和端 口 <mode>: 字符串串参数,IP 地址 0: 不不显示对端 IP 和端 口 1: 显示对端 IP 和端 口 AT+CIPDINFO= IPD 接收 网络数据 单连接时 : (+CIPMUX=0)+IPD,<len>[,<remote IP>,<remote port>]:<data> 多连接时 : (+CIPMUX=1)+IPD,<link ID>,<len>[,<remote IP>,<remote port>]:<data> 此在普通模式下有效,ESP8266 接收到 网络数据时向串串 口发送 +IPD 和数据 [<remote IP>]: 网络通信对端 IP, 由 AT+CIPDINFO=1 使能显示 [<remote port>]: 网络通信对端端 口, 由 AT+CIPDINFO=1 使能 <link ID>: 收到 网络连接的 ID 号 <len>: 数据 长度 <data>: 收到的数据 Espressif! 54/

62 5. TCP/IP 功能 AT! AT+CIPRECVMODE 设置 TCP 连接的数据接收 方式 设置 : AT+CIPRECVMODE=<mode> +CIPRECVMODE:<mode> 查询 : AT+CIPRECVMODE? <mode>:tcp 连接的数据接收 方式, 默认为主动模式 0: 主动模式 ; 收到 TCP 数据时,ESP8266 通过 +IPD 主动将数据通过串串 口发给 MCU; 1: 被动模式 ;ESP8266 默认使 用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据, 被动等 待 MCU 读取 ; 接收 buffer 满后, 将阻塞对端 TCP 发送数据 本设置仅针对 TCP 连接的普通传输模式有效, 对 UDP SSL 连接和透传模式 无效 被动模式开启后, 收到 TCP 数据时 : - 多连接 (AT+CIPMUX=1) 将提示 :+IPD,<link ID>,<len> - 单连接 (AT+CIPMUX=0) 将提示 :+IPD,<len> - 其中 <len> 表示 buffer 中缓存的总数据 长度 AT+CIPRECVMODE= AT+CIPRECVDATA 被动接收模式时, 读取缓存的 TCP 数据 对于单连接模式 (AT+CIPMUX=0): 设置 AT+CIPRECVDATA=<len> 对于多连接模式 (AT+CIPMUX=1): AT+CIPRECVDATA=<link_id>,<len> +CIPRECVDATA,<actual_len>:<data> <link_id>: 多连接的连接 ID 号 <len>: 读取的数据 长度, 每次最多可读取 2048 字节 <actual_len>: 实际读到的数据 长度 <data>: 读到的 TCP 数据 如果在缓存了了 TCP 数据的情况下, 当前连接断开, 缓存的数据仍然保留留, 允许 MCU 读取, 直 至创建新的连接 ; 如果新的同 ID 连接创建, 则前 一次连接缓存的数据将被丢弃 AT+CIPRECVMODE=1 // 例例如, 收到提示 +IPD,0,100 第 0 号连接接收到 100 字节数据 AT+CIPRECVDATA=0,100 // 从 0 号连接读取 100 字节数据 Espressif! 55/

63 5. TCP/IP 功能 AT AT+CIPRECVLEN 被动接收模式时, 查询缓存 TCP 数据的 长度 查询 AT+CIPRECVLEN? +CIPRECVLEN:<data length of link0>,<data length of link1>,<data length of link2>,<data length of link3>,<data length of link4> <data length of link>: 被动接收模式时, 该连接缓存的 TCP 数据 长度 AT+CIPRECVLEN? +CIPRECVLEN:100,,,,, AT+CIPSNTPCFG 设置时域和 SNTP 服务器器 查询 : AT+CIPSNTPCFG? +CIPSNTPCFG:<enable>,<timezone>,<SN TP server0>[,<sntp server1>,<sntp server2>] <enable>: 0:SNTP 未使能 ; 1:SNTP 使能 设置 : AT+CIPSNTPCFG=<enable>[,<timezone>][,<SNTP server0>,<sntp server1>,<sntp server2>] <timezone>: 时域, 范围 :[-11,13]; 若 SNTP 使能, 此参数必填 ; 否则, 无需填写 ; <SNTP server0>: 第 一个 SNTP 服务器器, 可不不填 ; <SNTP server1>: 第 二个 SNTP 服务器器, 可不不填 ; <SNTP server2>: 第三个 SNTP 服务器器, 可不不填 说明 设置若未填写 SNTP server, 则默认使 用 "cn.ntp.org.cn","ntp.sjtu.edu.cn","us.pool.ntp.org" AT+CIPSNTPCFG=1,8,"cn.ntp.org.cn","ntp.sjtu.edu.cn","us.pool.ntp.org" AT+CIPSNTPTIME 查询 SNTP 时间 查询 AT+CIPSNTPTIME? +CIPSNTPTIME:<time> Espressif! 56/

64 5. TCP/IP 功能 AT! <time>: 通过 SNTP 查询到的时间 例例如, 查询返回时间格式如下 : +CIPSNTPTIME:Thu Aug 04 14:48: AT+CWMODE=1 // 设置为 station 模式 AT+CWJAP="DemoAP","password" // 连接到路由器, 连接网络 AT+CIPSNTPCFG=1,8 // 设置时区 AT+CIPSNTPTIME? // 查询时间 AT+CIPDNS_CUR 自定义 DNS 服务器器, 不不保存到 Flash 功能 : 查询当前使 用的 DNS 服务器器查询 : AT+CIPDNS_CUR? [+CIPDNS_CUR:<DNS server0>] [+CIPDNS_CUR:<DNS server1>] <enable>: 功能 : 设置 自定义 DNS 服务器器设置 : AT+CIPDNS_CUR=<enable>[,<DNS server0>,<dns server1>] 0: 不不使能 自定义 DNS 服务器器 ; 1: 使能 自定义 DNS 服务器器 <DNS server0>: 第 一个 DNS 服务器器, 可不不填 ; <DNS server1>: 第 二个 DNS 服务器器, 可不不填 说明 对于 AT+CIPDNS_CUR=1( 即设置使能 自定义 DNS 服务器器, 但未填写 <DNS server> 参 数 ), 则默认使 用 " " 作为 DNS 服务器器 对于 AT+CIPDNS_CUR=0 ( 即不不使能 自定义 DNS 服务器器 ), 则默认使 用 " " 作为 DNS 服务器器 并且, 在与路路由器器交互的过程中,DNS 服务器器可能随 着路路由器器的配置更更改 AT+CIPDNS_CUR=1," " AT+CIPDNS_DEF 自定义 DNS 服务器器, 保存到 Flash 功能 : 查询保存到 flash 的 DNS 服务器器查询 : AT+CIPDNS_DEF? 功能 : 设置 自定义 DNS 服务器器 设置 : AT+CIPDNS_DEF=<enable>[,<DNS server0>,<dns server1>] Espressif! 57/

65 5. TCP/IP 功能 AT! [+CIPDNS_DEF:<DNS server0>] [+CIPDNS_DEF:<DNS server1>] <enable>: 0: 不不使能 自定义 DNS 服务器器 ; 1: 使能 自定义 DNS 服务器器 <DNS server0>: 第 一个 DNS 服务器器, 可不不填 ; <DNS server1>: 第 二个 DNS 服务器器, 可不不填 本设置将保存到 Flash 用户参数区 说明 对于 AT+CIPDNS_DEF=1( 即设置使能 自定义 DNS 服务器器, 但未填写 <DNS server> 参 数 ), 则默认使 用 " " 作为 DNS 服务器器 对于 AT+CIPDNS_DEF=0 ( 即不不使能 自定义 DNS 服务器器 ), 则默认使 用 " " 作为 DNS 服务器器 并且, 在与路路由器器交互的过程中,DNS 服务器器可能随 着路路由器器的配置更更改 AT+CIPDNS_DEF=1," " Espressif! 58/

66 附录 A A. 附录 A 以下 ESP8266 AT 会保存设置到 Flash: 保存在 Flash 用户参数区 AT+UART_DEF AT+CWDHCP_DEF AT+CIPSTAMAC_DEF AT+CIPAPMAC_DEF AT+CIPSTA_DEF AT+CIPAP_DEF AT+CWDHCPS_DEF AT+SAVETRANSLINK AT+CIPDNS_DEF AT+SYSMSG_DEF AT+CWCOUNTRY_DEF AT+CIPSSLCCONF AT+UART_DEF=115200,8,1,0,3 AT+CWDHCP_DEF=1,1 AT+CIPSTAMAC_DEF="18:fe:35:98:d3:7b" AT+CIPAPMAC_DEF="1a:fe:36:97:d5:7b" AT+CIPSTA_DEF=" " AT+CIPAP_DEF=" " AT+CWDHCPS_DEF=1,3," "," " AT+SAVETRANSLINK_DEF=1," ",1001 AT+CIPDNS_DEF=1," " AT+SYSMSG_DEF=3 AT+CWCOUNTRY_DEF=1,"CN",1,5 AT+CIPSSLCCONF=2 保存在 Flash 系统参数区 AT+CWMODE_DEF AT+CWJAP_DEF AT+CWSAP_DEF AT+CWAUTOCONN AT+CWMODE_DEF=3 AT+CWJAP_DEF="abc"," " AT+CWSAP_DEF="ESP8266"," ",5,3 AT+CWAUTOCONN=1 : 以上设置时, 会先读取 Flash 中的原配置, 仅新配置与原配置不不同时, 才写 Flash 保存新配置 对于 512 KB KB Flash Map, 用户参数区为 0x7C000 ~ 0x80000,16 KB; 对于 1024 KB KB Flash Map: 用户参数区为 0xFC000 ~ 0x100000,16 KB; 系统参数区始终为 Flash 的最后 16 KB Espressif! 59/!

67 附录 B B. 附录 B ESP8266 AT 中的提示信息说明如下 : 提示信息 说明 ready ERROR WIFI CONNECTED WIFI GOT IP WIFI DISCONNECT busy s... busy p... <conn_id>,connect <conn_id>,closed +IPD +STA_CONNECTED:<sta_mac> +DIST_STA_IP:<sta_mac>,<sta_ip> +STA_DISCONNECTED:<sta_mac> AT 固件成功启动输 入错误, 或者执 行行出错 ESP8266 station 连接到 AP ESP8266 station 获取到 IP 地址 ESP8266 station 的 WiFi 连接断开 busy sending, 表示系统正在发送数据的过程中, 无法当前输 入 busy processing, 表示系统正在处理理前 一条, 无法当前输 入建 立了了 <conn_id> 号 网络连接 <conn_id> 号 网络连接断开接收到 网络数据有 station 连 入 ESP8266 softap ESP8266 softap 给连 入的 station 分配 IP 地址 station 从 ESP8266 softap 断开连接 Espressif! 60/!

68 附录 C C. Q&A 如遇到 AT 使 用异常, 请发邮件 至乐鑫技术 支持, 附上如下信息 : AT 软件的版本号, AT+GMR 可获取版本信息 ; 硬件模块的信息, 例例如 :ESP-WROOM-02; 详细的测试步骤说明, 例例如 : AT+CWMODE_CUR=1 AT+GMR AT version: (apr :11:01) SDK version:1.0.1 compile time:apr :19:31 AT+CIPSTAMAC_DEF="14:CF:11:22:33:05" 如能提供 log 打印信息, 请附上异常 log 信息, 例例如以下截屏 : ets Jan ,rst cause: 1, boot mode: (3,3) load 0x , len 26336, room 16 tail 0 chksum 0xde load 0x3ffe8000, len 5672, room 8 tail 0 chksum 0x69 load 0x3ffe9630, len 8348, room 8 tail 4 chksum 0xcb csum 0xcb SDK version: addr not ack when tx write cmd mode : sta(18: fe: 34: 97: d5: 7b) + softap(1a: fe: 34: 97: d5: 7b) Espressif! 61/!