Upload
others
View
49
Download
0
Embed Size (px)
Citation preview
wwwespressifcom
ESP8266 AT 指令集
版本 301 乐鑫信息科技 版权所有 copy 2019
关于本手册 本文档提供 ESP8266_NONOS_SDK 的 AT 指令说明
发布说明
文档变更更通知
用户可通过乐鑫官网订阅页面 httpswwwespressifcomzh-hanssubscribe 订阅技术文档变更更的电子邮件通知
证书下载
用户可通过乐鑫官网证书下载页面 httpswwwespressifcomzh-hanscertificates 下载产品证书
日期 版本 发布说明
201604 V153 首次发布
201605 V154 更更新章节 5216 和 5219
201607 V200 增加章节 3211更更新章节 12
201705 V210 更更新章节 3241 和 52
201708 V211 增加附录 B
201802 V22增加章节 3222322342394240 和 5215
更更新章节 427428 和附录 B
201805 V221 更更新章节 42104211 和 4212
201805 V222增加章节 521152235224
更更新章节 3210
201808 V30
增加章节 525522552265227
更更新第 1 章章节 42342442114212附录 A
删除 AT+RFAUTOTRACE 指令
201902 V301 更更新章节 52552305231
目录 1 前言 1
11 客制化 AT 固件 1
111 编译 AT 工程 1
112 客制化功能 1
113 新增自定义 AT 指令 1
12 烧录 AT 固件 2
121 16 Mbit Flash Map 1024 KB + 1024 KB 3122 32 Mbit Flash Map 1024 KB + 1024 KB 3123 4 Mbit Flash 3124 8 Mbit Flash 4
125 16 Mbit Flash Map 512 KB + 512 KB 4126 32 Mbit Flash Map 512 KB + 512 KB 4
2 指令说明 6
3 基础 AT 指令 7
31 基础 AT 指令一览表 7
32 基础 AT 指令描述 8
321 ATmdash测试 AT 启动 8
322 AT+RSTmdash重启模块 8
323 AT+GMRmdash查询版本信息 8
324 AT+GSLPmdash进入 Deep-sleep 模式 8
325 ATEmdash开关回显功能 9
326 AT+RESTOREmdash恢复出厂设置 9
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash 10
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash 11
329 AT+SLEEPmdash设置 sleep 模式 12
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式 12
3211 AT+RFPOWERmdash设置 RF TX Power 上限 13
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power 13
3213 AT+SYSRAMmdash查询系统当前剩余内存 14
3214 AT+SYSADCmdash查询 ADC 值 14
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式 14
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式 14
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出 15
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平 15
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态 16
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash 17
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash 17
4 基础 AT 指令 18
41 基础 Wi-Fi 功能 AT 指令一览表 18
42 基础 Wi-Fi 功能 AT 指令描述 20
421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash 20
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash 20
423 AT+CWJAP_CURmdash临时连接 AP 21
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash 22
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性 23
426 AT+CWLAPmdash扫描当前可用的 AP 24
427 AT+CWQAPmdash断开与 AP 的连接 25
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数 26
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash 26
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息 28
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash 28
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash 29
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash 30
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash 30
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP 31
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash 31
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash 32
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash 32
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash 32
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash 33
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash 33
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash 34
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash 34
4224 AT+CWSTARTSMARTmdash开启 SmartConfig 35
4225 AT+CWSTOPSMARTmdash停止 SmartConfig 36
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式 36
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式 37
4228 AT+WPSmdash设置 WPS 功能 37
4229 AT+MDNSmdash设置 MDNS 功能 37
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称 38
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码 38
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash 39
5 TCPIP 功能 AT 指令 40
51 TCPIP 指令一览表 40
52 TCPIP 指令描述 41
521 AT+CIPSTATUSmdash查询网络连接信息 41
522 AT+CIPDOMAINmdash域名解析功能 41
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接 42
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量 44
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
关于本手册 本文档提供 ESP8266_NONOS_SDK 的 AT 指令说明
发布说明
文档变更更通知
用户可通过乐鑫官网订阅页面 httpswwwespressifcomzh-hanssubscribe 订阅技术文档变更更的电子邮件通知
证书下载
用户可通过乐鑫官网证书下载页面 httpswwwespressifcomzh-hanscertificates 下载产品证书
日期 版本 发布说明
201604 V153 首次发布
201605 V154 更更新章节 5216 和 5219
201607 V200 增加章节 3211更更新章节 12
201705 V210 更更新章节 3241 和 52
201708 V211 增加附录 B
201802 V22增加章节 3222322342394240 和 5215
更更新章节 427428 和附录 B
201805 V221 更更新章节 42104211 和 4212
201805 V222增加章节 521152235224
更更新章节 3210
201808 V30
增加章节 525522552265227
更更新第 1 章章节 42342442114212附录 A
删除 AT+RFAUTOTRACE 指令
201902 V301 更更新章节 52552305231
目录 1 前言 1
11 客制化 AT 固件 1
111 编译 AT 工程 1
112 客制化功能 1
113 新增自定义 AT 指令 1
12 烧录 AT 固件 2
121 16 Mbit Flash Map 1024 KB + 1024 KB 3122 32 Mbit Flash Map 1024 KB + 1024 KB 3123 4 Mbit Flash 3124 8 Mbit Flash 4
125 16 Mbit Flash Map 512 KB + 512 KB 4126 32 Mbit Flash Map 512 KB + 512 KB 4
2 指令说明 6
3 基础 AT 指令 7
31 基础 AT 指令一览表 7
32 基础 AT 指令描述 8
321 ATmdash测试 AT 启动 8
322 AT+RSTmdash重启模块 8
323 AT+GMRmdash查询版本信息 8
324 AT+GSLPmdash进入 Deep-sleep 模式 8
325 ATEmdash开关回显功能 9
326 AT+RESTOREmdash恢复出厂设置 9
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash 10
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash 11
329 AT+SLEEPmdash设置 sleep 模式 12
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式 12
3211 AT+RFPOWERmdash设置 RF TX Power 上限 13
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power 13
3213 AT+SYSRAMmdash查询系统当前剩余内存 14
3214 AT+SYSADCmdash查询 ADC 值 14
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式 14
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式 14
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出 15
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平 15
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态 16
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash 17
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash 17
4 基础 AT 指令 18
41 基础 Wi-Fi 功能 AT 指令一览表 18
42 基础 Wi-Fi 功能 AT 指令描述 20
421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash 20
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash 20
423 AT+CWJAP_CURmdash临时连接 AP 21
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash 22
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性 23
426 AT+CWLAPmdash扫描当前可用的 AP 24
427 AT+CWQAPmdash断开与 AP 的连接 25
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数 26
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash 26
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息 28
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash 28
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash 29
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash 30
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash 30
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP 31
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash 31
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash 32
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash 32
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash 32
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash 33
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash 33
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash 34
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash 34
4224 AT+CWSTARTSMARTmdash开启 SmartConfig 35
4225 AT+CWSTOPSMARTmdash停止 SmartConfig 36
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式 36
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式 37
4228 AT+WPSmdash设置 WPS 功能 37
4229 AT+MDNSmdash设置 MDNS 功能 37
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称 38
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码 38
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash 39
5 TCPIP 功能 AT 指令 40
51 TCPIP 指令一览表 40
52 TCPIP 指令描述 41
521 AT+CIPSTATUSmdash查询网络连接信息 41
522 AT+CIPDOMAINmdash域名解析功能 41
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接 42
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量 44
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
目录 1 前言 1
11 客制化 AT 固件 1
111 编译 AT 工程 1
112 客制化功能 1
113 新增自定义 AT 指令 1
12 烧录 AT 固件 2
121 16 Mbit Flash Map 1024 KB + 1024 KB 3122 32 Mbit Flash Map 1024 KB + 1024 KB 3123 4 Mbit Flash 3124 8 Mbit Flash 4
125 16 Mbit Flash Map 512 KB + 512 KB 4126 32 Mbit Flash Map 512 KB + 512 KB 4
2 指令说明 6
3 基础 AT 指令 7
31 基础 AT 指令一览表 7
32 基础 AT 指令描述 8
321 ATmdash测试 AT 启动 8
322 AT+RSTmdash重启模块 8
323 AT+GMRmdash查询版本信息 8
324 AT+GSLPmdash进入 Deep-sleep 模式 8
325 ATEmdash开关回显功能 9
326 AT+RESTOREmdash恢复出厂设置 9
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash 10
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash 11
329 AT+SLEEPmdash设置 sleep 模式 12
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式 12
3211 AT+RFPOWERmdash设置 RF TX Power 上限 13
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power 13
3213 AT+SYSRAMmdash查询系统当前剩余内存 14
3214 AT+SYSADCmdash查询 ADC 值 14
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式 14
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式 14
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出 15
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平 15
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态 16
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash 17
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash 17
4 基础 AT 指令 18
41 基础 Wi-Fi 功能 AT 指令一览表 18
42 基础 Wi-Fi 功能 AT 指令描述 20
421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash 20
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash 20
423 AT+CWJAP_CURmdash临时连接 AP 21
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash 22
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性 23
426 AT+CWLAPmdash扫描当前可用的 AP 24
427 AT+CWQAPmdash断开与 AP 的连接 25
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数 26
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash 26
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息 28
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash 28
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash 29
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash 30
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash 30
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP 31
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash 31
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash 32
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash 32
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash 32
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash 33
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash 33
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash 34
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash 34
4224 AT+CWSTARTSMARTmdash开启 SmartConfig 35
4225 AT+CWSTOPSMARTmdash停止 SmartConfig 36
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式 36
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式 37
4228 AT+WPSmdash设置 WPS 功能 37
4229 AT+MDNSmdash设置 MDNS 功能 37
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称 38
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码 38
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash 39
5 TCPIP 功能 AT 指令 40
51 TCPIP 指令一览表 40
52 TCPIP 指令描述 41
521 AT+CIPSTATUSmdash查询网络连接信息 41
522 AT+CIPDOMAINmdash域名解析功能 41
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接 42
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量 44
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式 12
3211 AT+RFPOWERmdash设置 RF TX Power 上限 13
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power 13
3213 AT+SYSRAMmdash查询系统当前剩余内存 14
3214 AT+SYSADCmdash查询 ADC 值 14
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式 14
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式 14
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出 15
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平 15
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态 16
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash 17
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash 17
4 基础 AT 指令 18
41 基础 Wi-Fi 功能 AT 指令一览表 18
42 基础 Wi-Fi 功能 AT 指令描述 20
421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash 20
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash 20
423 AT+CWJAP_CURmdash临时连接 AP 21
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash 22
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性 23
426 AT+CWLAPmdash扫描当前可用的 AP 24
427 AT+CWQAPmdash断开与 AP 的连接 25
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数 26
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash 26
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息 28
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash 28
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash 29
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash 30
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash 30
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP 31
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash 31
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash 32
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash 32
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash 32
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash 33
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash 33
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash 34
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash 34
4224 AT+CWSTARTSMARTmdash开启 SmartConfig 35
4225 AT+CWSTOPSMARTmdash停止 SmartConfig 36
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式 36
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式 37
4228 AT+WPSmdash设置 WPS 功能 37
4229 AT+MDNSmdash设置 MDNS 功能 37
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称 38
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码 38
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash 39
5 TCPIP 功能 AT 指令 40
51 TCPIP 指令一览表 40
52 TCPIP 指令描述 41
521 AT+CIPSTATUSmdash查询网络连接信息 41
522 AT+CIPDOMAINmdash域名解析功能 41
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接 42
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量 44
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash 30
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash 30
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP 31
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash 31
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash 32
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash 32
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash 32
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash 33
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash 33
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash 34
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash 34
4224 AT+CWSTARTSMARTmdash开启 SmartConfig 35
4225 AT+CWSTOPSMARTmdash停止 SmartConfig 36
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式 36
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式 37
4228 AT+WPSmdash设置 WPS 功能 37
4229 AT+MDNSmdash设置 MDNS 功能 37
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称 38
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码 38
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash 39
5 TCPIP 功能 AT 指令 40
51 TCPIP 指令一览表 40
52 TCPIP 指令描述 41
521 AT+CIPSTATUSmdash查询网络连接信息 41
522 AT+CIPDOMAINmdash域名解析功能 41
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接 42
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量 44
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
525 AT+CIPSSLCCONFmdash配置 SSL Client 44
526 AT+CIPSENDmdash发送数据 45
527 AT+CIPSENDEXmdash发送数据 46
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存 46
529 AT+CIPBUFRESETmdash重新计数 47
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态 48
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功 48
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式 49
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输 49
5214 AT+CIFSRmdash查询本地 IP 地址 50
5215 AT+CIPMUXmdash设置多连接 50
5216 AT+CIPSERVERmdash建立 TCP 服务器器 50
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数 51
5218 AT+CIPMODEmdash设置传输模式 51
5219 AT+SAVETRANSLINKmdash保存透传到 Flash 52
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间 53
5221 AT+PINGmdashPing 功能 53
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件 53
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口 54
5224 +IPDmdash接收网络数据 54
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式 55
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据 55
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度 56
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器 56
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间 56
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash 57
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash 57
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
A 附录 A 59
B 附录 B 60
C QampA 61
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
1 前言
1 前言 乐鑫官方发布 ESP8266 AT 固件供用户直接下载使用同时乐鑫也提供 AT 工程供用户在乐鑫 AT 的基础上自行行开发客制化 AT 固件
本文包含客制化 AT 固件的方法AT 固件的烧录以及乐鑫已有的 AT 指令集说明
11 客制化 AT 固件 111 编译 AT 工程
用户如需编译客制化 AT 源代码新增自定义的 AT 指令请将 example 中的文件夹 at 拷贝到对应版本的 ESP8266_NONOS_SDK 根目录下再进入 at 文件夹进行行开发及编译详细编译说明可参考 ESP8266 入门指南
112 客制化功能
bull OTA 功能
- 乐鑫发布的官方 AT 固件默认支持使用 AT+CIUPDATE 指令从乐鑫云下载升级到新版本的 AT 固件
- 如果用户自行行客制化 AT 固件则需要自行行实现 OTA 升级功能从用户自己的云端下载升级自定义的新版本固件乐鑫在 at_upgradec 中提供了了 OTA 示例例以供参考
bull SmartConfig 功能
- 乐鑫发布的官方 AT 固件默认支持 AT+CWSTARTSMART 和 AT+CWSTOPSMART 指令
- 如果用户无需 SmartConfig 功能可以自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
113 新增自定义 AT 指令
自定义 AT 指令命名时使用英文字符请勿使用其他特殊字符或数字
注意
bull 请确保正确的 BIN (ESP8266_NONOS_SDKbinat) 已经参考 ESP8266_NONOS_SDKbinat 中 readmetxt 烧录到 ESP8266 模块再执行行文档中的 AT 指令
bull AT 底层已占用 system_os_task 优先级 0 和 1如果用户基于 AT 开发仅支持建立一个优先级为 2 的任务
Espressif 1 62 201902
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
1 前言
AT 基于 ESP8266_NONOS_SDK 编译ESP8266_NONOS_SDKexampleat 中提供了了开发者自定义 AT 指令的示例例乐鑫原本提供的 AT 指令以库文件 libata 的形式提供将包含在编译生成的 AT BIN 固件中
ESP8266_NONOS_SDKexamplesatuseruser_mainc 中提供了了实现自定义 AT 指令的示例例可参考实现结构体 at_funcationType 用于定义一条指令的四种类型类型定义如下表所示
12 烧录 AT 固件 参考 ESP8266_NONOS_SDKbinatreadmetxt 进行行烧录请使用乐鑫官方烧录工具烧录时注意选择对应的 Flash 大小
乐鑫官方烧录工具链接httpespressifcomzh-hanssupportdownloadother-toolskeys=ampfield_type_tid5B5D=14
从 ESP8266_NONOS_SDK_V300AT_V17 起由于 AT bin size 增大AT 默认只支持 1024 KB + 1024 KB 的 flash map
类型定义 类型描述 说明
at_testCmd 测试指令
对应指令 AT+TEST=
AT 示例例中注册的实现回调 at_testCmdTest
建议指令功能 返回参数的取值范围
若此参数注册为 NULL则无测试指令
at_queryCmd 查询指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_queryCmdTest
建议指令功能 返回当前值
若此参数注册为 NULL则无查询指令
at_setupCmd 设置指令
对应指令格式 AT+TEST=parameter1parameter2hellip
AT 示例例中注册的实现回调 at_setupCmdTest
建议指令功能 设置参数值
若此参数注册为 NULL则无设置指令
at_exeCmd 执行行指令
对应指令 AT+TEST
AT 示例例中注册的实现回调 at_exeCmdTest
建议指令功能 执行行某项操作
若此参数注册为 NULL则无执行行指令
Espressif 2 62 201902
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
1 前言
121 16 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size 16 Mbit-C1
122 32 Mbit Flash Map 1024 KB + 1024 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit-C1
123 4 Mbit Flash
从 ESP8266_NONOS_SDK_V200AT_V13 起AT 固件可以使用 4 Mbit Flash但不不支持升级功能
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0xFE000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user12048new5bin 0x01000 主程序位于 binat1024+1024
BIN 烧录地址 说明
blankbin 0x78000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x7C000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7A000 初始化用户参数区详见附录
BIN
Espressif 3 62 201902
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
1 前言
124 8 Mbit Flash
固件升级功能(对应指令 AT+CIUPDATE)要求 Flash 容量量为 8 Mbit 或以上采用 boot mode 的烧录方式使用 Espressif 官方烧录工具烧录时选择 Flash size8 Mbit
125 16 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size16 Mbit
126 32 Mbit Flash Map 512 KB + 512 KB
使用 Espressif 官方烧录工具烧录时选择 Flash size32 Mbit
blankbin 0x7E000 初始化系统参数区详见附录
eagleflashbin 0x00000 主程序位于 binatnoboot
eagleirom0textbin 0x10000 主程序位于 binatnoboot
烧录地址 说明BIN
BIN 烧录地址 说明
blankbin 0xFB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0xFC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0xFE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
BIN 烧录地址 说明
blankbin 0x1FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x1FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x1FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 4 62 201902
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
1 前言
BIN 烧录地址 说明
blankbin 0x3FB000 初始化 RF_CAL 参数区
esp_init_data_defaultbin 0x3FC000初始化其他射频参数区至少烧录一次
当 RF_CAL 参数区初始化烧录时本区域也需烧录
blankbin 0x7E000 初始化用户参数区详见附录
blankbin 0x3FE000 初始化系统参数区详见附录
bootbin 0x00000 主程序位于 binat
user11024new2bin 0x01000 主程序位于 binat512+512
Espressif 5 62 201902
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
2 指令说明
2 指令说明 AT 指令可以细分为四种类型
类型 指令格式 描述
测试指令 AT+ltxgt= 该命令用于该命令用于查询设置指令的参数以及取值范围
查询指令 AT+ltxgt 该命令用于返回参数的当前值
设置指令 AT+ltxgt=lthellipgt 该命令用于设置用户自定义的参数值
执行行指令 AT+ltxgt 该命令用于执行行受模块内部程序控制的变参数不不可变的功能
注意
bull 不不是每条 AT 指令都具备上述 4 种类型的命令
bull [ ] 括号内为缺省值不不必填写或者可能不不显示
bull 使用双引号表示字符串串数据 rdquostringrdquo例例如AT+CWSAP=ESP7562902103082614
bull 默认波特率为 115200
bull AT 指令必须大写并且以回车换行行符结尾(CR LF)
Espressif 6 62 201902
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3 基础 AT 指令 31 基础 AT 指令一览表
指令 描述
AT 测试 AT 启动
AT+RST 重启模块
AT+GMR 查看版本信息
AT+GSLP 进入 Deep-sleep 模式
ATE 开关回显功能
AT+RESTORE 恢复出厂设置
AT+UART_CUR UART 当前临时配置
AT+UART_DEF UART 默认配置保存到 Flash
AT+SLEEP 设置 sleep 模式
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 设置当前系统消息
AT+SYSMSG_DEF 设置默认系统消息
Espressif 7 62 201902
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
32 基础 AT 指令描述 321 ATmdash测试 AT 启动
322 AT+RSTmdash重启模块
323 AT+GMRmdash查询版本信息
324 AT+GSLPmdash进入 Deep-sleep 模式
执行行指令 AT
响应 OK
参数说明 -
执行行指令 AT+RST
响应 OK
参数说明 -
执行行指令 AT+GMR
响应
ltATversioninfogt
ltSDKversioninfogt
ltcompiletimegt
OK
参数说明
bull ltATversioninfogtAT 版本信息
bull ltSDKversioninfogtSDK 版本信息
bull ltcompiletimegt编译生成时间
设置指令 AT+GSLP=lttimegt
响应lttimegt
OK
参数说明lttimegt设置 ESP8266 的睡眠时长单位毫秒ESP8266 会在休眠设定时长后自动唤醒
注意Deep-sleep 功能需要硬件支持将 XPD_DCDC 通过 0 欧姆电阻连接到 EXT_RSTB用作 Deep-sleep 唤醒
Espressif 8 62 201902
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
325 ATEmdash开关回显功能
326 AT+RESTOREmdash恢复出厂设置
执行行指令 ATE
响应 OK
参数说明bull ATE0关闭回显
bull ATE1开启回显
执行行指令 AT+RESTORE
响应 OK
说明恢复出厂设置将擦除所有保存到 Flash 的参数恢复为默认参数
恢复出厂设置会导致机器器重启
Espressif 9 62 201902
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
327 AT+UART_CURmdash设置 UART 当前临时设置不不保存到 Flash
指令查询指令
AT+UART_CUR
设置指令
AT+UART_CUR=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_CURltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
注意
查询返回的响应是 UART 实际参数值由于时钟分频的原因UART 实际参数值与设置值有一定误差是正
常情况
例例如设置 UART 波特率为 115200 时查询实际波特率值为 115273
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置不不保存在 Flash
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_CUR=1152008103
Espressif 10 62 201902
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
328 AT+UART_DEFmdash设置 UART 配置保存到 Flash
指令查询指令
AT+UART_DEF
设置指令
AT+UART_DEF=ltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
响应+UART_DEFltbaudrategtltdatabitsgtltstopbitsgtltparitygtltflowcontrolgt
OK
OK
参数说明
bull ltbaudrategtUART 波特率
bull ltdatabitsgt数据位
55 bit 数据位 66 bit 数据位 77 bit 数据位 88 bit 数据位
bull ltstopbitsgt停止位
11 bit 停止位 215 bit 停止位 32 bit 停止位
bull ltparitygt校验位
0None 1Odd 2Even
bull ltflowcontrolgt流控
0不不使能流控 1使能 RTS 2使能 CTS 3同时使能 RTS 和 CTS
注意
1 本设置将保存在 Flash user parameter 区重新上电后仍生效
2 使用流控需要硬件支持流控 MTCK 为 UART0 CTS MTDO 为 UART0 RTS
3 波特率支持范围110~11520040
示例例 AT+UART_DEF=1152008103
Espressif 11 62 201902
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
329 AT+SLEEPmdash设置 sleep 模式
3210 AT+WAKEUPGPIOmdash设置 GPIO 唤醒 Light-sleep 模式
指令查询指令
AT+SLEEP
设置指令
AT+SLEEP=ltsleepmodegt
响应当前sleep模式
OK
OK
或
ERROR
参数说明
ltsleepmodegt
0禁用休眠模式
1Light-sleep 模式
2Modem-sleep 模式
注意 Sleep 模式仅在单 Station 模式下生效默认为 Modem-sleep 模式
示例例 AT+SLEEP=0
设置指令 AT+WAKEUPGPIO=ltenablegtlttrigger_GPIOgtlttrigger_levelgt[ltawake_GPIOgtltawake_levelgt]
响应 OK
参数说明
bull ltenablegt
0禁用 GPIO 唤醒 Light-sleep 功能
1使能 GPIO 唤醒 Light-sleep 功能
bull lttrigger_GPIOgt
设置用于唤醒 Light-sleep 的 GPIO有效范围[0 15]
bull lttrigger_levelgt
0低电平唤醒
1高电平唤醒
bull [ltawake_GPIOgt]
选填参数设置 Light-sleep 唤醒后的标志 GPIO有效范围[0 15]
bull [ltawake_levelgt]
选填参数
0Light-sleep 唤醒后置为低电平
1Light-sleep 唤醒后置为高电平
Espressif 12 62 201902
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3211 AT+RFPOWERmdash设置 RF TX Power 上限
3212 AT+RFVDDmdash根据 VDD33 设置 RF TX Power
注意
bull Light sleep 唤醒过程约 5 ms请等待至少 5ms 后再发送 AT 指令
bull lttrigger_GPIOgt 与 ltawake_GPIOgt 不不能相同
bull 由 lttrigger_GPIOgt 触发 ESP8266 从 Light-sleep 唤醒之后如需再次进入休眠时ESP8266 将判断 lttrigger_GPIOgt 的状态
如果 lttrigger_GPIOgt 仍然处于唤醒状态则进入 Modem-sleep 休眠
如果 lttrigger_GPIOgt 不不处于唤醒状态则进入 Light-sleep 休眠
示例例
bull 设置 GPIO0 低电平唤醒 Light-sleep 模式
AT+WAKEUPGPIO=100
bull 设置 GPIO0 高电平唤醒 Light-sleep 模式唤醒后将 GPIO13 设置为高电平
AT+WAKEUPGPIO=101131
bull 取消 GPIO 唤醒 Light-sleep 模式的功能
AT+WAKEUPGPIO=0
设置指令 AT+RFPOWER=ltTXPowergt
响应 OK
参数说明 ltTXPowergtRF TX Power 值参数范围[0 82]单位025 dBm
注意RF TX Power 的设置并不不精准此时设置的是 RF TX Power 的最大值实际值可能小于设置值
示例例 AT+RFPOWER=50
指令
查询指令
AT+RFVDD
功能查询 ESP8266 VDD33 的值
设置指令
AT+RFVDD=ltVDD33gt
功能ESP8266 根据传入的 ltVDD33gt 调整 RF TX Power
执行行指令
AT+RFVDD
功能ESP8266 自动根据实际的 VDD33 调整 RF TX Power
响应+RFVDDltVDD33gt
OKOK OK
参数说明ltVDD33gtVDD33 电压值单位11024 V
ltVDD33gtVDD33 电压值取值范围[1900 3300]
-
注意本查询指令必须在 TOUT 管脚悬空的情况下使用
否则查询返回无效值
-本查询指令必须在 TOUT 管脚悬空的情况下使用
Espressif 13 62 201902
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3213 AT+SYSRAMmdash查询系统当前剩余内存
3214 AT+SYSADCmdash查询 ADC 值
3215 AT+SYSIOSETCFGmdash设置 IO 工作模式
3216 AT+SYSIOGETCFGmdash查询 IO 工作模式
示例例 AT+RFVDD=2800
查询指令 AT+SYSRAM
响应+SYSRAMltRAMgt
OK
参数说明 ltRAMgt系统当前剩余内存单位byte
查询指令 AT+SYSADC
响应+SYSADCltADCgt
OK
参数说明 ltADCgt查询到的 ADC 值单位11024V
设置指令 AT+SYSIOSETCFG=ltpingtltmodegtltpull-upgt
响应 OK
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例 AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
设置指令 AT+SYSIOGETCFG=ltpingt
响应+SYSIOGETCFGltpingtltmodegtltpull-upgt
OK
Espressif 14 62 201902
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3217 AT+SYSGPIODIRmdash设置 GPIO 工作为输入或输出
3218 AT+SYSGPIOWRITEmdash设置 GPIO 的输出电平
参数说明
bull ltpingtIO 管脚号
bull ltmodegtIO 工作模式
bull ltpull-upgt
0不不使能上拉
1使能上拉
注意 AT+SYSIO 系列列指令的使用请参考 ESP8266 管脚清单
设置指令 AT+SYSGPIODIR=ltpingtltdirgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于 GPIO 模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
设置指令 AT+SYSGPIOWRITE=ltpingtltlevelgt
响应
bull 如果成功提示
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTOUTPUT
ERROR
Espressif 15 62 201902
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3219 AT+SYSGPIOREADmdash读取 GPIO 的电平状态
参数说明
bull ltpingtGPIO 号
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=121设置GPIO12为输出
AT+SYSGPIOWRITE=121设置GPIO12输出高电平
设置指令 AT+SYSGPIOREAD=ltpingt
响应
bull 如果成功返回
+SYSGPIOREADltpingtltdirgtltlevelgt
OK
bull 如果 IO 管脚不不处于输出模式则提示
NOTGPIOMODE
ERROR
参数说明
bull ltpingtGPIO 号
bull ltdirgt
0设置 GPIO 为输入
1设置 GPIO 为输出
bull ltlevelgt
0低电平
1高电平
注意 AT+SYSGPIO 系列列指令的使用请参考 ESP8266 管脚清单
示例例
AT+SYSIOSETCFG=1231设置GPIO12工作为GPIO模式
AT+SYSGPIODIR=120设置GPIO12为输入
AT+SYSGPIOREAD=12
Espressif 16 62 201902
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
3 基础 AT 指令
3220 AT+SYSMSG_CURmdash设置当前系统消息不不保存到 flash
3221 AT+SYSMSG_DEFmdash设置默认系统消息保存到 flash
设置指令 AT+SYSMSG_CUR=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgtCONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置不不保存到 flash 中重新上电后失效
示例例 AT+SYSMSG_CUR=3
设置指令 AT+SYSMSG_DEF=ltngt
响应 OK
参数说明
ltngt
bull bit0控制退出透传的消息
若 bit0 为 0退出透传时无提示消息默认为 0
若 bit0 为 1退出透传时提示消息 +QUITT Quit transparent transmission
bull bit1控制建立网络连接的消息
若 bit1 为 0网络连接建立时提示消息 ltLink_IDgt CONNECT默认为 0
若 bit1 为 1网络连接建立时提示消息 +LINK_CONNltstatus_typegtltlink_idgtUDPTCPSSLltcsgtltremote_ipgtltremote_portgtltlocal_portgt
- ltstatus_typegt 为 0 表示连接成功为 1 表示连接失败
- ltcsgt 为 0 表示 ESP 作为 client为 1 表示 ESP 作为 server
注意 本设置保存到 flash 用户参数区重新上电后仍然有效
示例例 AT+SYSMSG_DEF=3
Espressif 17 62 201902
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4 基础 AT 指令 41 基础 Wi-Fi 功能 AT 指令一览表
指令 说明
AT+CWMODE_CUR 设置 Wi-Fi 模式 (STAAPSTA+AP)不不保存到 Flash
AT+CWMODE_DEF 设置 Wi-Fi 模式 (STAAPSTA+AP)保存到 Flash
AT+CWJAP_CUR 连接 AP不不保存到 Flash
AT+CWJAP_DEF 连接 AP保存到 Flash
AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
AT+CWLAP 扫描附近的 AP 信息
AT+CWQAP 与 AP 断开连接
AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置不不保存到 Flash
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置保存到 Flash
AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
AT+CWDHCP_CUR 设置 DHCP不不保存到 Flash
AT+CWDHCP_DEF 设置 DHCP保存到 Flash
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
Espressif 18 62 201902
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
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 国家码
Espressif 19 62 201902
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
42 基础 Wi-Fi 功能 AT 指令描述 421 AT+CWMODE_CURmdash设置当前 Wi-Fi 模式不不保存到 Flash
422 AT+CWMODE_DEFmdash设置当前 Wi-Fi 模式并保存到 Flash
指令测试指令
AT+CWMODE_CUR=
查询指令
AT+CWMODE_CUR
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_CUR=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_CURltmodegt取值列表
OK
+CWMODE_CURltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置不不保存到 Flash
示例例 AT+CWMODE_CUR=3
指令测试指令
AT+CWMODE_DEF=
查询指令
AT+CWMODE_DEF
功能查询 ESP8266 当前 Wi-Fi 模式
设置指令
AT+CWMODE_DEF=ltmodegt
功能设置 ESP8266 当前 Wi-Fi 模式
响应+CWMODE_DEFltmodegt取值列
表
OK
+CWMODE_DEFltmodegt
OKOK
参数说明
ltmodegt
1Station 模式 2SoftAP 模式 3SoftAP+Station 模式
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWMODE_DEF=3
Espressif 20 62 201902
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
423 AT+CWJAP_CURmdash临时连接 AP
指令
查询指令
AT+CWJAP_CUR
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_CUR=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应
+CWJAP_CURltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_CURlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]选填参数目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置不不保存到 Flash
示例例
AT+CWJAP_CUR=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_CUR=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_CUR=abc0123456789cad719d8a644
Espressif 21 62 201902
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
424 AT+CWJAP_DEFmdash连接 AP保存到 Flash
指令
查询指令
AT+CWJAP_DEF
功能查询 ESP8266 Station 已连接的 AP 信息
设置指令
AT+CWJAP_DEF=ltssidgtltpwdgt[ltbssidgt][ltpci_engt]
功能设置 ESP8266 Station 需连接的 AP
响应+CWJAP_DEFltssidgtltbssidgtltchannelgtltrssigt
OK
OK
或者
+CWJAP_DEFlterrorcodegt
FAIL
参数说明
bull ltssidgt字符串串参数AP 的 SSID
bull ltbssidgtAP 的 MAC 地址
bull ltchannelgt信道号
bull ltrssigt信号强度
bull ltssidgt目标 AP 的 SSID
bull ltpwdgt密码最长 64 字节 ASCII
bull [ltbssidgt]目标 AP 的 MAC 地址一般用于有多个 SSID 相同的 AP 的情况
bull [ltpci_engt]选填参数不不允许连接 WEP 和 open 的路路由器器可用于 PCI 认证
bull lterrorcodegt(仅供参考并不不可靠) 1连接超时 2密码错误 3找不不到目标 AP 4连接失败
参数设置需要开启 Station 模式若 SSID 或者 password 中含有特殊符号例例如 或者 ldquo 或者 时需要进行行转义其它字符转义无效
注意 本设置保存到 Flash 系统参数区
示例例
AT+CWJAP_DEF=abc0123456789
例例如目标 AP 的 SSID 为 abcpassword 为 0123456789则指令如下
AT+CWJAP_DEF=abc0123456789
如果有多个 AP 的 SSID 均为 abc可通过 BSSID 确定目标 AP
AT+CWJAP_DEF=abc0123456789cad719d8a644
Espressif 22 62 201902
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
425 AT+CWLAPOPTmdash设置 CWLAP 指令的属性
设置指令 AT+CWLAPOPT=ltsort_enablegtltmaskgt
响应 OK
参数说明
bull ltsort_enablegt指令 AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序
0不不排序 1为根据 RSSI 排序
bull ltmaskgt对应 bit 若为 1则指令 AT+CWLAP 的扫描结果显示相关属性对应 bit 若为 0则不不显示具体如下
bit0设置 AT+CWLAP 的扫描结果是否显示 ltecngt bit1设置 AT+CWLAP 的扫描结果是否显示 ltssidgt bit2设置 AT+CWLAP 的扫描结果是否显示 ltrssigt bit3设置 AT+CWLAP 的扫描结果是否显示 ltmacgt bit4设置 AT+CWLAP 的扫描结果是否显示 ltchannelgt bit5设置 AT+CWLAP 的扫描结果是否显示 ltfreqoffsetgt bit6设置 AT+CWLAP 的扫描结果是否显示 ltfreqcalibrationgt bit7设置 AT+CWLAP 的扫描结果是否显示 ltpairwise_ciphergt bit8设置 AT+CWLAP 的扫描结果是否显示 ltgroup_ciphergt bit9设置 AT+CWLAP 的扫描结果是否显示 ltbgngt bit10设置 AT+CWLAP 的扫描结果是否显示 ltwpsgt
示例例
AT+CWLAPOPT=12047
第一个参数为 1表示后续如果使用 AT+CWLAP 指令扫描结果将按照信号强度 RSSI 值排序
第二个参数为 2047即 0x7FF表示 ltmaskgt 的相关 bit 全部置为 1后续如果使用 AT+CWLAP 指令扫描结果将显示所有参数
Espressif 23 62 201902
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
426 AT+CWLAPmdash扫描当前可用的 AP
指令
设置指令
AT+CWLAP=ltssidgt[ltmacgtltchannelgtltscan_typegtltscan_time_mingtltscan_time_maxgt]
功能列列出符合特定条件的 AP
执行行指令
AT+CWLAP
功能列列出当前可用的 AP
响应
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
+CWLAPltecngtltssidgtltrssigtltmacgtltchannelgtltfreqoffsetgtltfreqcaligtltpairwise_ciphergtltgroup_ciphergtltbgngtltwpsgt
OK
参数说明
bull [ltscan_typegt] 选填参数 0 active scan 1 passive scan
bull [ltscan_time_mingt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最小扫描时间默认值为 0 对于 passive scan此参数无效
bull [ltscan_time_maxgt] 选填参数单位 ms范围 [01500] 对于 active scan此参数为每个信道的最大扫描时间当设置为 0 时采用默认值 120ms 对于 passive scan此参数为每个信道扫描的时间默认值为 360ms
bull ltecngt加密方式 0OPEN 1WEP 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK 5WPA2_Enterprise(目前 AT 不不支持连接这种加密 AP)
bull ltssidgt字符串串参数AP 的 SSID bull ltrssigt信号强度 bull ltmacgt字符串串参数AP 的 MAC 地址 bull ltchannelgt信道号 bull ltfreqoffsetgtAP 频偏单位kHz此数值除以 24可得到 ppm 值 bull ltfreqcaligt频偏校准值 bull ltpairwise_ciphergt 0CIPHER_NONE 1CIPHER_WEP40 2CIPHER_WEP104 3CIPHER_TKIP 4CIPHER_CCMP 5CIPHER_TKIP_CCMP 6CIPHER_UNKNOWN
bull ltgroup_ciphergt 定义与 ltpairwise_ciphergt 相同 bull ltbgngt
bit0 代表 b 模式 bit1 代表 g 模式 bit2 代表 n 模式 若对应 bit 为 1表示该模式使能若对应 bit 为 0则该模式未使能
bull ltwpsgt0WPS 未使能1WPS 使能
Espressif 24 62 201902
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
427 AT+CWQAPmdash断开与 AP 的连接
注意
bull scan_time_min 不不能大于 scan_time_max即要求 scan_time_max gt= scan_time_min
bull 若 scan_time_min 和 scan_time_max 设置均为 0则采用默认值默认值具体如下
对于 active scan每个信道的最小扫描时间是 0最大扫描时间是 120ms
对于 passive scan每个信道扫描的时间是 360ms
示例例
AT+CWLAP=WiFicad719d8a6446050120
或者查找指定 SSID 的 AP
AT+CWLAP=WiFi
或者使能 passive scan 模式
AT+CWLAP=1
执行行指令 AT+CWQAP
响应 OK
参数说明 -
Espressif 25 62 201902
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
428 AT+CWSAP_CURmdash配置 ESP8266 SoftAP 当前参数
429 AT+CWSAP_DEFmdash配置 ESP8266 SoftAP 当前参数保存到 Flash
指令
查询指令
AT+CWSAP_CUR
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_CUR=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_CURltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置不不保存到 Flash
示例例 AT+CWSAP_CUR=ESP8266123456789053
指令
查询指令
AT+CWSAP_DEF
功能查询 ESP8266 SoftAP 的配置参数
设置指令
AT+CWSAP_DEF=ltssidgtltpwdgtltchlgtltecngt[ltmaxconngt][ltssidhiddengt]
功能设置 ESP8266 SoftAP 的配置参数
响应 +CWSAP_DEFltssidgtltpwdgtltchlgtltecngtltmaxconngtltssidhiddengt
OK
或
ERROR
Espressif 26 62 201902
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
参数说明
bull ltssidgt字符串串参数接入点名称
bull ltpwdgt字符串串参数密码长度范围8 ~ 64 字节 ASCII
bull ltchlgt通道号
bull ltecngt加密方式不不支持 WEP
0OPEN 2WPA_PSK 3WPA2_PSK 4WPA_WPA2_PSK
bull [ltmaxconngt](选填参数)允许连入 ESP8266 SoftAP 的最多 Station 数目取值范围 [1 8]
bull [ltssidhiddengt](选填参数)默认为 0开启广播 ESP8266 SoftAP SSID
0广播 SSID 1不不广播 SSID
同左
注意
指令只有在 SoftAP 模式开启后有效
注意 本设置保存到 Flash system parameter 区域
示例例 AT+CWSAP_DEF=ESP8266123456789053
Espressif 27 62 201902
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4210 AT+CWLIFmdash查询连接到 ESP8266 SoftAP 的 Station 信息
4211 AT+CWDHCP_CURmdash设置 DHCP不不保存到 Flash
执行行指令 AT+CWLIF
响应+CWLIFltipaddrgtltmacgt
OK
参数说明bull ltipaddrgt连接到 ESP8266 SoftAP 的 Station IP 地址
bull ltmacgt连接到 ESP8266 SoftAP 的 Station MAC 地址
注意 本指令无法查询静态 IP仅支持在 ESP8266 SoftAP 和连入的 Station DHCP 均使能的情况下有效
指令查询指令
AT+CWDHCP_CUR
设置指令
AT+CWDHCP_CUR=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_CUR=01
Espressif 6228 201902
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4212 AT+CWDHCP_DEFmdash设置 DHCP保存到 Flash
指令查询指令
AT+CWDHCP_DEF
设置指令
AT+CWDHCP_DEF=ltmodegtltengt
功能设置 DHCP
响应 DHCP是否使能 OK
参数说明
bull Bit0
0SoftAP DHCP 关闭 1SoftAP DHCP 开启
bull Bit1
0Station DHCP 关闭 1Station DHCP 开启
bull ltmodegt
0设置 ESP8266 SoftAP 1设置 ESP8266 Station 2设置 ESP8266 SoftAP 和 Station
bull ltengt
0关闭 DHCP 1开启 DHCP
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置静态 IP 的指令(AT+CIPSTA 系列列和 AT+CIPAP 系列列)互相影响
设置使能 DHCP则静态 IP 无效 设置静态 IP则 DHCP 关闭 以最后的设置为准
示例例 AT+CWDHCP_DEF=01
Espressif 6229 201902
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4213 AT+CWDHCPS_CURmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围不不保存到 Flash
4214 AT+CWDHCPS_DEFmdash设置 ESP8266 SoftAP DHCP 分配的 IP 范围保存到 Flash
指令查询指令
AT+CWDHCPS_CUR
设置指令
AT+CWDHCPS_CUR=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_CUR=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
注意
bull 本设置不不保存到 Flash
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_CUR=13192168410192168415
或者
AT+CWDHCPS_CUR=0清除设置恢复默认值
指令查询指令
AT+CWDHCPS_DEF
设置指令
AT+CWDHCPS_DEF=ltenablegtltleasetimegtltstartIPgtltendIPgt
功能设置 ESP8266 SoftAP DHCP 服务器器分配的 IP 范围
响应 +CWDHCPS_DEF=ltleasetimegtltstartIPgtltendIPgt
OK
参数说明
bull ltenablegt
0清除设置 IP 范围恢复默认值后续参数无需填写 1使能设置 IP 范围后续参数必须填写
bull ltleasetimegt租约时间单位分钟取值范围 [1 2880]
bull ltstartIPgtDHCP 服务器器 IP 池的起始 IP
bull ltendIPgtDHCP 服务器器 IP 池的结束 IP
Espressif 6230 201902
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4215 AT+CWAUTOCONNmdash上电是否自动连接 AP
4216 AT+CIPSTAMAC_CURmdash设置 ESP8266 Station 当前 MAC 地址不不保存到 Flash
注意
bull 本设置保存到 Flash 用户参数区
bull 本指令必须在 ESP8266 SoftAP 模式使能且开启 DHCP 的情况下使用设置的 IP 范围必须与 ESP8266 SoftAP 在同一网段
示例例
AT+CWDHCPS_DEF=13192168410192168415
或者
AT+CWDHCPS_DEF=0清除设置恢复默认值
设置指令 AT+CWAUTOCONN=ltenablegt
响应 OK
参数说明
ltenablegt
0上电不不自动连接 AP 1 上电自动连接 AP
ESP8266 Station 默认上电自动连接 AP
注意 本设置保存到 Flash 系统参数区
示例例 AT+CWAUTOCONN=1
指令查询指令
AT+CIPSTAMAC_CUR
设置指令
AT+CIPSTAMAC_CUR=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_CUR=18fe3598d37b
Espressif 6231 201902
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4217 AT+CIPSTAMAC_DEFmdash设置 ESP8266 Station 当前 MAC 地址保存到 Flash
4218 AT+CIPAPMAC_CURmdash设置 ESP8266 SoftAP 当前 MAC 地址不不保存到 Flash
4219 AT+CIPAPMAC_DEFmdash设置 ESP8266 SoftAP 默认 MAC 地址保存到 Flash
指令查询指令
AT+CIPSTAMAC_DEF
设置指令
AT+CIPSTAMAC_DEF=ltmacgt
功能设置 ESP8266 Station 的 MAC 地址
响应+CIPSTAMAC_DEFltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 Station 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPSTAMAC_DEF=18fe3598d37b
指令
查询指令
AT+CIPAPMAC_CUR
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_CUR=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_CURltmacgt
OKOK
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置不不保存到 Flash
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_CUR=1afe3697d57b
指令
查询指令
AT+CIPAPMAC_DEF
功能查询 ESP8266 SoftAP 的 MAC 地址
设置指令
AT+CIPAPMAC_DEF=ltmacgt
功能设置 ESP8266 SoftAP 的 MAC 地址
响应+CIPAPMAC_DEFltmacgt
OKOK
Espressif 6232 201902
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4220 AT+CIPSTA_CURmdash设置 ESP8266 Station 的 IP 地址不不保存到 Flash
4221 AT+CIPSTA_DEFmdash设置 ESP8266 Station 的 IP 地址保存到 Flash
参数说明 ltmacgt字符串串参数ESP8266 SoftAP 的 MAC 地址
注意
bull 本设置保存到 Flash 用户参数区
bull ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同请勿将其设置为同一 MAC 地址
bull ESP8266 MAC 地址第一个字节的 bit 0 不不能为 1例例如MAC 地址可以为 18hellip 但不不能为 15hellip
示例例 AT+CIPAPMAC_DEF=1afe3697d57b
指令
查询指令
AT+CIPSTA_CUR
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_CURltipgt
+CIPSTA_CURltgatewaygt
+CIPSTA_CURltnetmaskgt
OK
OK
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_CUR=1921686100192168612552552550
指令
查询指令
AT+CIPSTA_DEF
功能查询 ESP8266 Station 的 IP 地址
设置指令
AT+CIPSTA_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 Station 的 IP 地址
响应
+CIPSTA_DEFltipgt
+CIPSTA_DEFltgatewaygt
+CIPSTA_DEFltnetmaskgt
OK
OK
Espressif 6233 201902
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4222 AT+CIPAP_CURmdash设置 ESP8266 SoftAP 的 IP 地址不不保存到 Flash
4223 AT+CIPAP_DEFmdash设置 ESP8266 SoftAP 的 IP 地址保存到 Flash
参数说明
注意
ESP8266 Station IP 需连上 AP 后才可以查询
bull ltipgt字符串串ESP8266 Station 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPSTA_DEF=1921686100192168612552552550
指令
查询指令
AT+CIPAP_CUR
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_CUR=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
响应
+CIPAP_CURltipgt
+CIPAP_CURltgatewaygt
+CIPAP_CURltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置不不保存到 Flash
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_CUR=19216851192168512552552550
指令
查询指令
AT+CIPAP_DEF
功能查询 ESP8266 SoftAP 的 IP 地址
设置指令
AT+CIPAP_DEF=ltipgt[ltgatewaygtltnetmaskgt]
功能设置 ESP8266 SoftAP 的 IP 地址
Espressif 6234 201902
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4224 AT+CWSTARTSMARTmdash开启 SmartConfig
响应
+CIPAP_DEFltipgt
+CIPAP_DEFltgatewaygt
+CIPAP_DEFltnetmaskgt
OK
OK
参数说明
bull ltipgt字符串串ESP8266 SoftAP 的 IP 地址
bull [ltgatewaygt]网关
bull [ltnetmaskgt]子网掩码
注意
bull 本设置保存到 Flash 用户参数区
bull 目前仅支持 C 类 IP 地址
bull 本设置指令与设置 DHCP 的指令(AT+CWDHCP 系列列)互相影响
设置静态 IP则 DHCP 关闭 设置使能 DHCP则静态 IP 无效 以最后的设置为准
示例例 AT+CIPAP_DEF=19216851192168512552552550
指令
执行行指令
AT+CWSTARTSMART
功能开启 SmartConfig(SmartConfig 类型为 ESP-TOUCH+AirKiss)
设置指令
AT+CWSTARTSMART=lttypegt
功能开启某指定类型的 SmartConfig
响应 OK
参数说明
lttypegt
1ESP-TOUCH 2AirKiss 3ESP-TOUCH+AirKiss
说明
SmartConfig 连接过程中的提示信息如下
smartconfig type lttypegt AIRKISS ESPTOUCH or UNKNOWN
smart get wifi info got SSID and password
ssidltAPs SSIDgt
passwordltAPs passwordgt
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 6235 201902
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4225 AT+CWSTOPSMARTmdash停止 SmartConfig
4226 AT+CWSTARTDISCOVERmdash开启可被局域网内微信探测模式
注意
bull 用户可以参考 ESP-TOUCH 用户指南 来了了解 SmartConfig 的详细介绍
bull 仅支持在 ESP8266 单 Station 模式下调用
bull 消息 smartgetwifiinfo 表示 SmartConfig 成功获取到 AP 信息之后 ESP8266 尝试连接 AP打印连接过程
bull 消息 smartconfigconnectedwifi 表示成功连接到 AP此时可以调用 AT+CWSTOPSMART 停止 SmartConfig 再执行行其他指令注意在 SmartConfig 过程中请勿执行行其他指令
bull 从 AT_v10 开始SmartConfig 可以自动获取协议类型AirKiss 或者 ESP-TOUCH
bull 用户如果无需 SmartConfig 功能可以参考章节 11 自行行重新编译 at在 user_configh 中关闭 CONFIG_AT_SMARTCONFIG_COMMAND_ENABLE从而减小 bin size节省内存
示例例AT+CWMODE=1
AT+CWSTARTSMART
执行行指令 AT+CWSTOPSMART
响应 OK
参数说明 -
注意 无论 SmartConfig 成功与否都请调用 AT+CWSTOPSMART 释放快连占用的内存
示例例 AT+CWSTOPSMART
设置指令AT+CWSTARTDISCOVER=
ltWeChatnumbergtltdev_typegtlttimegt
响应 OK
参数说明
bull ltWeChatnumbergt微信公众号必须从微信获取
bull ltdev_typegt设备类型必须从微信获取
bull lttimegt主动发包时间间隔取值范围0 ~ 24x3600单位秒
0ESP8266 不不主动向外发包需要手机微信查询时才回复
其他值ESP8266 主动发包的时间间隔以便便于局域网中的手机微信发现本设备
注意bull 可参考微信官网内网发现功能的介绍 httpiotweixinqqcom
bull 本指令需在 ESP8266 Station 连入局域网获得 IP 地址后生效
示例例 AT+CWSTARTDISCOVER=gh_9e2cff3dfa5112247510
Espressif 6236 201902
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4227 AT+CWSTOPDISCOVERmdash关闭可被局域网内微信探测模式
4228 AT+WPSmdash设置 WPS 功能
4229 AT+MDNSmdash设置 MDNS 功能
执行行指令 AT+CWSTOPDISCOVER
响应 OK
示例例 AT+CWSTOPDISCOVER
设置指令 AT+WPS=ltenablegt
响应 OK
参数说明
ltenablegt
1开启 WPS 0关闭 WPS
注意bull WPS 功能必须在 ESP8266 Station 使能的情况下调用
bull WPS 不不支持 WEP 加密方式
示例例AT+CWMODE=1
AT+WPS=1
设置指令 AT+MDNS=ltenablegtlthostnamegtltserver_namegtltserver_portgt
响应
OK
或
opmodemismatchwhenmdns
ERROR
参数说明
bull ltenablegt
1开启 MDNS 功能后续参数需要填写
0关闭 MDNS 功能后续参数无需填写
bull lthostnamegtMDNS 主机名称
bull ltserver_namegtMDNS 服务器器名称
bull ltserver_portgtMDNS 服务器器端口
注意
bull lthostnamegt 和 ltserver_namegt 不不能包含特殊字符(例例如 符号)或者设置为协议名称(例例如不不能定义为 http)
bull ESP8266 SoftAP 模式暂时不不支持 MDNS 功能
Espressif 6237 201902
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4230 AT+CWHOSTNAMEmdash设置 ESP8266 Station 的主机名称
4231 AT+CWCOUNTRY_CURmdash设置 ESP8266 WiFi 国家码
示例例 AT+MDNS=1espressifiot8080
指令
查询指令
AT+CWHOSTNAME
功能查询 ESP8266 Station 的主机名称
设置指令
AT+CWHOSTNAME=lthostnamegt
功能设置 ESP8266 Station 的主机名称
响应
+CWHOSTNAMElthostnamegt
OK
如果未使能 ESP8266 Station 模式则返回
+CWHOSTNAMEltnullgt
OK
如果成功返回
OK
如果未使能 ESP8266 station 模式则提示
ERROR
参数说明 lthostnamegt主机名称最长 32 字节
注意
bull 本设置不不保存到 Flash重启后将恢复默认值
bull ESP8266 Station 默认的主机名称为 ldquoESP_MAC 地址低 3 个字节rdquo例例如+CWHOSTNAMEltESP_A378DAgt
示例例AT+CWMODE=3
AT+CWHOSTNAME=my_test
指令
查询指令
AT+CWCOUNTRY_CUR
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_CUR=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_CURltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为实际的国家码信息
如果设置为跟随 AP 切换则查询值可能与之前的设置值不不同
OK
Espressif 6238 201902
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
4 Wi-Fi 功能 AT 指令
4232 AT+CWCOUNTRY_DEFmdash设置默认的 ESP8266 WiFi 国家码并保存到 flash
参数说明
ltcountry_policygt
bull 0根据 AP 自动切换国家信息
bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示
ltstart_channelgt 起始信道号
lttotal_channel_numbergt 总信道个数
注意 bull 本设置不不保存到 Flash重启后将恢复默认值
示例例AT+CWMODE=3
AT+CWCOUNTRY_CUR=1CN15
指令
查询指令
AT+CWCOUNTRY_DEF
功能查询 ESP8266 WiFi 国家码
设置指令
AT+CWCOUNTRY_DEF=ltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
功能设置 ESP8266 WiFi 国家码
响应
+CWCOUNTRY_DEFltcountry_policygtltcountry_codegtltstart_channelgtlttotal_channel_numbergt
OK
注意
查询返回值为保存在 flash 的默认国家码信息
即使设置为跟随 AP 切换查询值仍然与之前的设置值一致
OK
参数说明
ltcountry_policygt bull 0根据 AP 自动切换国家信息 bull 1使用设置的国家信息
ltcountry_codegt 国家码字符串串长度最多支持三个字符第三个为特殊字符在查询时不不显示 ltstart_channelgt 起始信道号 lttotal_channel_numbergt 总信道个数
注意 bull 本设置将保存到 Flash 用户参数区
示例例AT+CWMODE=3
AT+CWCOUNTRY_DEF=1CN113
Espressif 6239 201902
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5 TCPIP 功能 AT 指令 51 TCPIP 指令一览表
指令 描述
AT+CIPSTATUS 查询网络连接信息
AT+CIPDOMAIN 域名解析功能
AT+CIPSTART 建立 TCP 连接UDP 传输或者 SSL 连接
AT+CIPSSLSIZE 设置 SSL buffer 大小
AT+CIPSSLCCONF 配置 ESP SSL client
AT+CIPSEND 发送数据
AT+CIPSENDEX 发送数据达到设置长度或者遇到字符 0则发送数据
AT+CIPSENDBUF 数据写入 TCP 发包缓存
AT+CIPBUFRESET 重置计数(TCP 发包缓存)
AT+CIPBUFSTATUS 查询 TCP 发包缓存的状态
AT+CIPCHECKSEQ 查询写入 TCP 发包缓存的某包是否成功发送
AT+CIPCLOSE 关闭 TCPUDPSSL 传输
AT+CIFSR 查询本地 IP 地址
AT+CIPMUX 设置多连接模式
AT+CIPSERVER 设置 TCP 服务器器
AT+CIPSERVERMAXCONN 设置服务器器允许建立的最大连接数
AT+CIPMODE 设置透传模式
AT+SAVETRANSLINK 保存透传连接到 Flash
AT+CIPSTO 设置 ESP8266 作为 TCP 服务器器时的超时时间
AT+PING Ping 功能
AT+CIUPDATE 通过 Wi-Fi 升级软件
AT+CIPDINFO 接收网络数据时+IPD 是否提示对端 IP 和端口
AT+CIPRECVMODE 设置 TCP 接收模式
AT+CIPRECVDATA TCP 被动接收模式下读取缓存的 TCP 数据
AT+CIPRECVLEN TCP 被动接收模式下查询缓存 TCP 数据的长度
Espressif 6240 201902
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
52 TCPIP 指令描述 521 AT+CIPSTATUSmdash查询网络连接信息
522 AT+CIPDOMAINmdash域名解析功能
AT+CIPSNTPCFG 设置时域和 SNTP 服务器器
AT+CIPSNTPTIME 查询 SNTP 时间
AT+CIPDNS_CUR 自定义 DNS 服务器器设置不不保存到 flash
AT+CIPDNS_DEF 自定义 DNS 服务器器设置保存到 flash
执行行指令 AT+CIPSTATUS
响应STATUSltstatgt
+CIPSTATUSltlinkIDgtlttypegtltremoteIPgtltremoteportgtltlocalportgtlttetypegt
参数说明
bull ltstatgtESP8266 Station 接口的状态
2ESP8266 Station 已连接 AP获得 IP 地址 3ESP8266 Station 已建立 TCP 或 UDP 传输 4ESP8266 Station 断开网络连接 5ESP8266 Station 未连接 AP
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数TCP 或者 UDP
bull ltremoteIPgt字符串串远端 IP 地址
bull ltremoteportgt远端端口值
bull ltlocalportgtESP8266 本地端口值
bull lttetypegt
0ESP8266 作为客户端 1ESP8266 作为服务器器
执行行指令 AT+CIPDOMAIN=ltdomainnamegt
响应
+CIPDOMAINltIPaddressgt
OK
或者
DNSFail
ERROR
参数说明 ltdomainnamegt待解析的域名可支持长度小于 64 的域名
Espressif 6241 201902
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
523 AT+CIPSTARTmdash建立 TCP 连接UDP 传输或 SSL 连接
示例例
AT+CWMODE=1setStationmode
AT+CWJAP=SSIDpasswordaccesstotheinternet
AT+CIPDOMAIN=iotespressifcnDNSfunction
建立 TCP 连接
设置指令
TCP 单连接 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
TCP 多连接 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
示例例
AT+CIPSTART=TCPiotespressifcn8000
AT+CIPSTART=TCP1921681011101000
详细请参考 ESP8266 AT 指令使用示例例
建立 UDP 传输
设置指令
单连接模式 (AT+CIPMUX=0) 时
AT+CIPSTART=lttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
多连接模式 (AT+CIPMUX=1) 时
AT+CIPSTART=ltlinkIDgtlttypegtltremoteIPgtltremoteportgt[(ltUDPlocalportgt)(ltUDPmodegt)]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
Espressif 6242 201902
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltUDPlocalportgt]UDP 传输时设置本地端口
bull [ltUDPmodegt]UDP 传输的属性若透传则必须为 0
0收到数据后不不更更改远端目标默认值为 0 1收到数据后改变一次远端目标 2收到数据后改变远端目标
注意
使用 ltUDPmodegt 必须先填写 ltUDPlocalportgt
示例例AT+CIPSTART=UDP192168101110100010022
详细请参考 ESP8266 AT 指令使用示例例
建立 SSL 连接
设置指令 AT+CIPSTART=[ltlinkIDgt]lttypegtltremoteIPgtltremoteportgt[ltTCPkeepalivegt]
响应
OK
或
ERROR
如果连接已经存在则返回
ALREADYCONNECTED
参数说明
bull ltlinkIDgt网络连接 ID (0 ~ 4)用于多连接的情况
bull lttypegt字符串串参数连接类型TCPUDP或SSL
bull ltremoteIPgt字符串串参数远端 IP 地址
bull ltremoteportgt远端端口号
bull [ltTCPkeepalivegt]TCP keep-alive 侦测时间默认关闭此功能 0关闭 TCP keep-alive 功能 1~7200侦测时间单位为 1s
注意
bull ESP8266 最多仅支持建立 1 个 SSL 连接
bull SSL 连接不不支持透传
bull SSL 需要占用较多空间如果空间不不足会导致系统重启用户可以使用指令 AT+CIPSSLSIZE=ltsizegt 增大 SSL 缓存
示例例AT+CIPSSLSIZE=4096
AT+CIPSTART=SSLiotespressifcn8443
Espressif 6243 201902
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
524 AT+CIPSSLSIZEmdash设置 SSL Buffer 容量量
525 AT+CIPSSLCCONFmdash配置 SSL Client
设置指令 AT+CIPSSLSIZE=ltsizegt
响应 OK
参数说明 ltsizegtSSL buffer 大小取值范围[2048 4096]
示例例 AT+CIPSSLSIZE=4096
指令
查询指令
AT+CIPSSLCCONF
功能查询 ESP8266 作为 SSL client 时的认证方式
设置指令
AT+CIPSSLCCONF=ltSSLmodegt
功能配置 ESP8266 作为 SSL client 时的认证方式
响应+CIPSSLCCONFltSSLmodegt
OKOK
参数说明
bull ltSSLmodegtSSL 认证方式
bit0是否加载 cert 和 private key以供 server 认证 bit1是否加载 CA认证 server 的 cert 和 private key
注意
bull 如需设置本指令请在建立 SSL 连接之前调用本设置对所有 SSL 连接均生效
bull 如需证书认证请参考文档 ESP8266 SSL 指南 第 4 章 ESP8266 作为 SSL Client生成 SSL 所需证书
- esp_cert_private_keybin 默认烧录到地址 0xFC000
- esp_ca_certbin 默认烧录到地址 0xFB000
- 用户可以自行行修改 user_mainc 中的 SYSTEM_PARTITION_SSL_CLIENT_CERT_PRIVKEY_ADDR 和 SYSTEM_PARTITION_SSL_CLIENT_CA_ADDR 地址重新编译指定位置
bull 本设置将保存到 flash 用户参数区
示例例
AT+CWMODE=1 设置 sta 模式
AT+CWJAP=SSIDPASSWORD 连接路路由器器连接网络
AT+CIPSNTPCFG=18 设置时区
AT+CIPSNTPTIME 查询当前时间
AT+CIPSSLCCONF=2
AT+CIPSTART=SSL1921683388443
Espressif 6244 201902
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
526 AT+CIPSENDmdash发送数据
指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSEND=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSEND=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSEND=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
功能在普通传输模式时设置发送数据的长
度
执行行指令
AT+CIPSEND
功能在透传模式时开始发送数据
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 ltlengthgt 时发送数据回到普通指令模式等待下一条 AT 指令
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
收到此命令后先换行行返回 gt
进入透传模式发送数据每包最大 2048 字节或者每包数据以 20 ms 间隔区分
当输入单独一包 +++ 时返回普通 AT 指令模式发送 +++ 退出透传时请至少间隔 1 秒再发下一条 AT 指令
本指令必须在开启透传模式以及单连接下使
用
若为 UDP 透传指令 AT+CIPSTART 参数 ltUDPmodegt 必须为 0
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull [ltremoteIPgt]UDP 传输可以设置对端 IP bull [ltremoteportgt]UDP 传输可以设置对端端口
-
示例例 详细请参考 ESP8266 AT 指令使用示例例
Espressif 6245 201902
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
527 AT+CIPSENDEXmdash发送数据
528 AT+CIPSENDBUFmdash数据写入 TCP 发包缓存
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDEX=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDEX=ltlinkIDgtltlengthgt
3 如果是 UDP 传输可以设置远端 IP 和端口
AT+CIPSENDEX=[ltlinkIDgt]ltlengthgt[ltremoteIPgtltremoteportgt]
指令功能在普通传输模式时设置发送数据的长度
响应
发送指定长度的数据
收到此命令后先换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据
如果未建立连接或连接被断开返回
ERROR
如果数据发送成功返回
SENDOK
如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltlengthgt数字参数表明发送数据的长度最大长度为 2048
bull 当接收数据长度满 length 或者遇到字符 0 时发送数据回到普通指令模式等待下一条 AT 指令
bull 用户如需发送 0请转义为 0
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPSENDBUF=ltlengthgt
2 多连接时(+CIPMUX=1)
AT+CIPSENDBUF=ltlinkIDgtltlengthgt
Espressif 6246 201902
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
529 AT+CIPBUFRESETmdash重新计数
响应
lt本次segmentIDgtlt已成功发送的segmentIDgt
OK
gt
bull 收到此命令后先返回 packet ID再换行行返回 gt然后开始接收串串口数据当数据长度满 length 或者遇到字符 0时发送数据超过 length 的数据丢弃并提示 busy
bull 如果未建立连接或并非 TCP 连接或 buffer 满等出错返回
ERROR
bull 如果某包数据发送成功
单连接时返回
ltsegmentIDgtSENDOK
多连接时返回
ltlinkIDgtltsegmentIDgtSENDOK
bull 如果数据发送失败返回
SENDFAIL
参数说明
bull ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
bull ltsegmentIDgtuint32给每包写入数据分配的 ID从 1 开始计数每写入一包则自加一计数满则重新从 1 计数
bull ltlengthgt数据长度超过长度的数据则丢弃
说明
本指令将数据写入 TCP 发包缓存无需等待 SENDOK可连续调用发送成功后会返回数据包 ID 及 SENDOK
在数据没有传入完成时传入 +++ 可退出发送之前传入的数据将直接丢弃
SSL 连接不不支持使用本指令
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFRESET
2 多连接时(+CIPMUX=1)
AT+CIPBUFRESET=ltlinkIDgt
响应
OK
如果有数据包未发送完毕或者连接不不存在则返回
ERROR
参数说明 ltlinkIDgt网络连接 ID 号 (0 ~ 4)用于多连接的情况
注意 本指令基于AT+CIPSENDBUF 实现功能
Espressif 6247 201902
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5210 AT+CIPBUFSTATUSmdash查询 TCP 发包缓存的状态
5211 AT+CIPCHECKSEQmdash查询写入 TCP 发包缓存的某包是否发送成功
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPBUFSTATUS
2 多连接时(+CIPMUX=1)
AT+CIPBUFSTATUS=ltlinkIDgt
响应lt下次的segmentIDgtlt已发送的segmentIDgtlt成功发送的segmentIDgtltremainbuffer
sizegtltqueuenumbergt
OK
参数说明
bull lt下次的segmentIDgt 下次调用 AT+CIPSENDBUF 将分配的 ID
bull lt已发送的segmentIDgt已发送的 TCP 数据包 ID
bull 仅当 lt下次的segmentIDgt - lt已发送的segmentIDgt = 1 的情况下可调用 AT+CIPBUFRESET 重置计数
bull lt成功发送的segmentIDgt成功发送的 TCP 数据包 ID
bull ltremainbuffersizegtTCP 发包缓存剩余的空间
bull ltqueuenumbergt 底层可用的 queue 数目并不不可靠仅供参考
注意 本指令不不支持对 SSL 连接使用
示例例
例例如单连接时 AT+CIPBUFSTATUS 的返回值为
2015102007
说明
bull 20表示当前数据包序号已经分配到了了 19下次调用 AT+CIPSENDBUF 将为数据包分配序号 20
bull 15表示当前已发送了了序号为 15 的数据包但并不不一定发送成功了了
bull 10表示成功发送到了了序号为 10 的数据包
bull 200表示网络层 TCP 发包缓存剩余的空间为 200 bytes
bull 7表示当前网络层还剩余 7 个 queue 供数据传输仅供参考并不不可靠当 queue 为 0 时不不允许数据发送
设置指令
1 单连接时(+CIPMUX=0)
AT+CIPCHECKSEQ=ltsegmentIDgt
2 多连接时(+CIPMUX=1)
AT+CIPCHECKSEQ=ltlinkIDgtltsegmentIDgt
响应[ltlinkIDgt]ltsegmentIDgtltstatusgt
OK
Espressif 6248 201902
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5212 AT+CIPCLOSEMODEmdash设置 TCP 连接的断开方式
5213 AT+CIPCLOSEmdash关闭 TCPUDPSSL 传输
参数说明
bull 最多记录最后的 32 个 segment ID 数据包的状态
bull [ltlinkIDgt]网络连接 ID (0~4)用于多连接的情况
bull ltsegmentIDgt调用 AT+CIPSENDBUF 写入数据时分配的 ID
bull ltstatusgt
FALSE发送失败
TRUE发送成功
注意 本指令基于 AT+CIPSENDBUF 实现功能
指令
1 单连接时(+CIPMUX=0)
AT+CIPCLOSEMODE=ltenable_abortgt
2 多连接时(+CIPMUX=1)
AT+CIPCLOSEMODE=ltlinkIDgtltenable_abortgt
响应 OK
参数说明ltlinkIDgt连接 ID 号
ltenable_abortgt断开方式0正常断开1abort 强制断开
注意
bull 默认 TCP 连接为正常断开模式一般不不建议使用 abort 强制断开模式
bull 如需设置为 abort 强制断开模式
- 需在 TCP 连接建立之后设置
- 设置仅对当次连接有效如果当前 TCP 连接断开重新建立连接后需要重新设置
bull 设置仅对普通 TCP 连接有效对 SSL 连接无效
示例例
AT+CIPSTART=0TCP1921683603400
AT+CIPCLOSEMODE=01
AT+CIPCLOSE=0
指令
设置指令(用于多连接的情况) AT+CIPCLOSE=ltlinkIDgt
功能关闭 TCPUDP 传输
执行行指令(用于单连接的情况) AT+CIPCLOSE
响应 OK
参数说明ltlinkIDgt需要关闭的连接 ID 号当 ID 为 5 时关闭所有连接(开启 server 后 ID 为 5 无效)
-
Espressif 6249 201902
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5214 AT+CIFSRmdash查询本地 IP 地址
5215 AT+CIPMUXmdash设置多连接
5216 AT+CIPSERVERmdash建立 TCP 服务器器
执行行指令 AT+CIFSR
响应
+CIFSRAPIPltSoftAPIPaddressgt
+CIFSRAPMACltSoftAPMACaddressgt
+CIFSRSTAIPltStationIPaddressgt
+CIFSRSTAMACltStationMACaddressgt
OK
参数说明
ltIPaddressgt ESP8266 SoftAP 的 IP 地址 ESP8266 Station 的 IP 地址 ltMACaddressgt ESP8266 SoftAP 的 MAC 地址 ESP8266 Station 的 MAC 地址
注意 ESP8266 Station IP 需连上 AP 后才可以查询
指令 查询指令 AT+CIPMUX
设置指令 AT+CIPMUX=ltmodegt 功能设置连接类型
响应+CIPMUXltmodegt
OKOK
参数说明ltmodegt 0单连接模式 1多连接模式
注意
bull 默认为单连接 bull 只有非透传模式 (AT+CIPMODE=0)才能设置为多连接 bull 必须在没有连接建立的情况下设置连接模式 bull 如果建立了了 TCP 服务器器想切换为单连接必须关闭服务器器 (AT+CIPSERVER=0)服务器器仅支持多连接
示例例 AT+CIPMUX=1
设置指令 AT+CIPSERVER=ltmodegt[ltportgt]
响应 OK
Espressif 6250 201902
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5217 AT+CIPSERVERMAXCONNmdash设置服务器器允许建立的最大连接数
5218 AT+CIPMODEmdash设置传输模式
参数说明
bull ltmodegt
0关闭服务器器
1建立服务器器 bull ltportgt端口号默认为 333
注意
bull 多连接情况下 (AT+CIPMUX=1)才能开启 TCP 服务器器
bull 创建 TCP 服务器器后自动建立 TCP 服务器器监听
bull 当有 TCP 客户端接入会自动占用一个连接 ID
示例例AT+CIPMUX=1
AT+CIPSERVER=11001
指令
查询指令
AT+CIPSERVERMAXCONN
功能查询服务器器允许建立的最大连接数
设置指令
AT+CIPSERVERMAXCONN=ltnumgt
功能设置服务器器允许建立的最大连接数
响应+CIPSERVERMAXCONNltnumgt
OKOK
参数说明 ltnumgt服务器器允许建立的最大连接数取值范围[1 5]
注意 如需设置最大连接数请在创建服务器器之前设置
示例例
AT+CIPMUX=1
AT+CIPSERVERMAXCONN=2
AT+CIPSERVER=180
指令
查询指令
AT+CIPMODE
功能查询传输模式
设置指令
AT+CIPMODE=ltmodegt
功能设置传输模式
响应+CIPMODEltmodegt
OKOK
参数说明
ltmodegt
0普通传输模式 1透传模式仅支持 TCP 单连接和 UDP 固定通信对端的情况
注意
bull 本设置不不保存到 Flash
bull 透传模式传输时如果连接断开ESP8266 会不不停尝试重连此时单独输入 +++ 退出透传则停止重连普通传输模式则不不会重连提示连接断开
示例例 AT+CIPMODE=1
Espressif 6251 201902
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5219 AT+SAVETRANSLINKmdash保存透传到 Flash
保存透传(TCP 单连接)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPordomainnamegtltremoteportgt[lttypegtltTCPkeepalivegt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传 1保存开机进入透传模式
bull ltremoteIPgt远端 IP 或者域名
bull ltremoteportgt远端端口
bull [lttypegt](选填参数)TCP 或者 UDP缺省默认为 TCP
bull [ltTCPkeepalivegt](选填参数)TCP keep-alive 侦测缺省默认关闭此功能
0关闭 TCP keep-alive 功能 1~7200侦测时间单位为秒
注意
bull 本设置将透传模式及建立的 TCP 连接均保存在 Flash system parameter 区域下次上电自动建立 TCP 连接并进入透传
bull 只要远端 IP端口的值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002TCP
保存透传(UDP 传输)到 Flash
设置指令 AT+SAVETRANSLINK=ltmodegtltremoteIPgtltremoteportgtlttypegt[ltUDPlocalportgt]
响应 OK
参数说明
bull ltmodegt
0取消开机透传
1保存开机进入透传模式
bull ltremoteIPgt远端 IP
bull ltremoteportgt远端端口
bull lttypegtUDP缺省默认为 TCP
bull [ltUDPlocalportgt](选填参数)开机进入 UDP 传输时使用的本地端口
注意
bull 本设置将透传模式及建立的 UDP 传输均保存在 Flash 用户参数区下次上电自动建立 UDP 传输并进入透传
bull 只要远端 IP端口的数值符合规范本设置就会被保存到 Flash
示例例 AT+SAVETRANSLINK=119216861101002UDP1005
Espressif 6252 201902
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5220 AT+CIPSTOmdash设置 TCP 服务器器超时时间
5221 AT+PINGmdashPing 功能
5222 AT+CIUPDATEmdash通过 Wi-Fi 升级软件
指令
查询指令
AT+CIPSTO
功能查询 TCP 服务器器超时时间
设置指令
AT+CIPSTO=lttimegt
功能设置 TCP 服务器器超时时间
响应+CIPSTOlttimegt
OKOK
参数说明 lttimegtTCP 服务器器超时时间取值范围 0 ~ 7200s
注意bull ESP8266 作为 TCP 服务器器会断开一直不不通信直至超时了了的 TCP 客户端连接
bull 如果设置 AT+CIPSTO=0则永远不不会超时不不建议这样设置
示例例
AT+CIPMUX=1
AT+CIPSERVER=11001
AT+CIPSTO=10
设置指令AT+PING=ltIPgt
功能ping 功能
响应
+lttimegt
OK
或
+timeout
ERROR
参数说明bull ltIPgt字符串串参数IP 地址
bull lttimegtping 响应时间
示例例AT+PING=19216811
AT+PING=wwwbaiducom
执行行指令AT+CIUPDATE
功能软件升级
响应+CIPUPDATEltngt
OK
Espressif 6253 201902
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5223 AT+CIPDINFOmdash接收网络数据时是否提示对端 IP 和端口
5224 +IPDmdash接收网络数据
参数说明
ltngt
bull 1找到服务器器
bull 2连接到服务器器
bull 3获得软件版本
bull 4开始升级
说明bull 升级过程由于网络条件的好坏有快慢差异
bull 升级失败会提示 ERROR请耐心等待
注意
bull 若直接使用乐鑫提供的 AT BIN (ESP8266_NONOS_SDKbinat)本指令将从 Espressif Cloud 下载 AT 固件升级
bull 若用户自行行编译 AT 源代码则请自行行实现 AT+CIUPDATE 指令的升级功能乐鑫提供本地升级的 Demo 作为参考(ESP8266_NONOS_SDKexampleat)
bull 建议升级 AT 固件后调用 AT+RESTORE 恢复出厂设置重新初始化
设置指令AT+CIPDINFO=ltmodegt
功能接收网络数据时+IPD 是否提示对端 IP 和端口
响应 OK
参数说明
ltmodegt字符串串参数IP 地址
bull 0不不显示对端 IP 和端口
bull 1显示对端 IP 和端口
示例例 AT+CIPDINFO=1
指令单连接时
(+CIPMUX=0)+IPDltlengt[ltremoteIPgtltremoteportgt]ltdatagt
多连接时
(+CIPMUX=1)+IPDltlinkIDgtltlengt[ltremoteIPgtltremoteportgt]ltdatagt
参数说明
此指令在普通指令模式下有效ESP8266 接收到网络数据时向串串口发送 +IPD 和数据
bull [ltremoteIPgt]网络通信对端 IP由指令 AT+CIPDINFO=1 使能显示
bull [ltremoteportgt]网络通信对端端口由指令 AT+CIPDINFO=1 使能
bull ltlinkIDgt收到网络连接的 ID 号
bull ltlengt数据长度
bull ltdatagt收到的数据
Espressif 6254 201902
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5225 AT+CIPRECVMODEmdash设置 TCP 连接的数据接收方式
5226 AT+CIPRECVDATAmdash被动接收模式时读取缓存的 TCP 数据
指令设置指令
AT+CIPRECVMODE=ltmodegt
查询指令
AT+CIPRECVMODE
响应+CIPRECVMODEltmodegt
OKOK
参数说明
ltmodegtTCP 连接的数据接收方式默认为主动模式
bull 0主动模式收到 TCP 数据时ESP8266 通过 +IPD 主动将数据通过串串口发给 MCU
bull 1被动模式ESP8266 默认使用 2920 bytes 的 buffer 用于缓存接收到的 TCP 数据被动等待 MCU 读取接收 buffer 满后将阻塞对端 TCP 发送数据
注意
bull 本设置仅针对 TCP 连接的普通传输模式有效对 UDPSSL 连接和透传模式无效
bull 被动模式开启后收到 TCP 数据时
- 多连接(AT+CIPMUX=1)将提示+IPDltlink IDgtltlengt
- 单连接(AT+CIPMUX=0)将提示+IPDltlengt
- 其中 ltlengt 表示 buffer 中缓存的总数据长度
示例例 AT+CIPRECVMODE=1
设置指令
bull 对于单连接模式(AT+CIPMUX=0)
AT+CIPRECVDATA=ltlengt
bull 对于多连接模式(AT+CIPMUX=1)
AT+CIPRECVDATA=ltlink_idgtltlengt
响应+CIPRECVDATAltactual_lengtltdatagt
OK
参数说明
ltlink_idgt多连接的连接 ID 号
ltlengt读取的数据长度每次最多可读取 2048 字节
ltactual_lengt实际读到的数据长度
ltdatagt读到的 TCP 数据
注意 bull 如果在缓存了了 TCP 数据的情况下当前连接断开缓存的数据仍然保留留允许 MCU 读取直至创建新的连接如果新的同 ID 连接创建则前一次连接缓存的数据将被丢弃
示例例
AT+CIPRECVMODE=1
例例如收到提示 +IPD0100 第 0 号连接接收到 100 字节数据
AT+CIPRECVDATA=0100 从 0 号连接读取 100 字节数据
Espressif 6255 201902
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5227 AT+CIPRECVLENmdash被动接收模式时查询缓存 TCP 数据的长度
5228 AT+CIPSNTPCFGmdash设置时域和 SNTP 服务器器
5229 AT+CIPSNTPTIMEmdash查询 SNTP 时间
查询指令 AT+CIPRECVLEN
响应+CIPRECVLENltdatalengthoflink0gtltdatalengthoflink1gtltdatalengthoflink2gtltdatalengthoflink3gtltdatalengthoflink4gt
OK
参数说明 ltdatalengthoflinkgt被动接收模式时该连接缓存的 TCP 数据长度
示例例
AT+CIPRECVLEN
+CIPRECVLEN100
OK
指令查询指令
AT+CIPSNTPCFG
设置指令
AT+CIPSNTPCFG=ltenablegt[lttimezonegt][ltSNTPserver0gtltSNTPserver1gtltSNTPserver2gt]
响应
+CIPSNTPCFGltenablegtlttimezonegtltSNTPserver0gt[ltSNTPserver1gtltSNTPserver2gt]
OK
OK
参数说明
bull ltenablegt
0SNTP 未使能 1SNTP 使能
bull lttimezonegt时域范围[-1113]若 SNTP 使能此参数必填否则无需填写
bull ltSNTPserver0gt第一个 SNTP 服务器器可不不填
bull ltSNTPserver1gt第二个 SNTP 服务器器可不不填
bull ltSNTPserver2gt第三个 SNTP 服务器器可不不填
说明 设置指令若未填写 SNTPserver则默认使用 cnntporgcnntpsjtueducnuspoolntporg
示例例 AT+CIPSNTPCFG=18cnntporgcnntpsjtueducnuspoolntporg
查询指令 AT+CIPSNTPTIME
响应+CIPSNTPTIMElttimegt
OK
Espressif 6256 201902
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
5230 AT+CIPDNS_CURmdash自定义 DNS 服务器器不不保存到 Flash
5231 AT+CIPDNS_DEFmdash自定义 DNS 服务器器保存到 Flash
参数说明
lttimegt通过 SNTP 查询到的时间
例例如查询返回时间格式如下
+CIPSNTPTIMEThuAug041448052016
示例例
AT+CWMODE=1设置为 station 模式
AT+CWJAP=DemoAPpassword连接到路由器连接网络
AT+CIPSNTPCFG=18设置时区
AT+CIPSNTPTIME查询时间
指令
功能查询当前使用的 DNS 服务器器
查询指令
AT+CIPDNS_CUR
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_CUR=ltenablegt[ltDNSserver0gtltDNSserver1gt]
响应
[+CIPDNS_CURltDNSserver0gt]
[+CIPDNS_CURltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 对于指令 AT+CIPDNS_CUR=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_CUR=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_CUR=120867220220
指令
功能查询保存到 flash 的 DNS 服务器器
查询指令
AT+CIPDNS_DEF
功能设置自定义 DNS 服务器器
设置指令
AT+CIPDNS_DEF=ltenablegt[ltDNSserver0gtltDNSserver1gt]
Espressif 6257 201902
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
5 TCPIP 功能 AT 指令
响应
[+CIPDNS_DEFltDNSserver0gt]
[+CIPDNS_DEFltDNSserver1gt]
OK
OK
参数说明
bull ltenablegt
0不不使能自定义 DNS 服务器器 1使能自定义 DNS 服务器器
bull ltDNSserver0gt第一个 DNS 服务器器可不不填
bull ltDNSserver1gt第二个 DNS 服务器器可不不填
说明
bull 本设置将保存到 Flash 用户参数区
bull 对于指令 AT+CIPDNS_DEF=1(即设置使能自定义 DNS 服务器器但未填写 ltDNSservergt参数)则默认使用 20867222222 作为 DNS 服务器器
bull 对于指令 AT+CIPDNS_DEF=0 (即不不使能自定义 DNS 服务器器)则默认使用 20867222222 作为 DNS 服务器器并且在与路路由器器交互的过程中DNS 服务器器可能随着路路由器器的配置更更改
bull ltDNSserver0gt 和 ltDNSserver1gt 不不能设置为同一服务器器
示例例 AT+CIPDNS_DEF=120867220220
Espressif 6258 201902
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
附录 A
A 附录 A 以下 ESP8266 AT 指令会保存设置到 Flash
指令 示例例
保存在 Flash 用户参数区
AT+UART_DEF AT+UART_DEF=1152008103
AT+CWDHCP_DEF AT+CWDHCP_DEF=11
AT+CIPSTAMAC_DEF AT+CIPSTAMAC_DEF=18fe3598d37b
AT+CIPAPMAC_DEF AT+CIPAPMAC_DEF=1afe3697d57b
AT+CIPSTA_DEF AT+CIPSTA_DEF=1921686100
AT+CIPAP_DEF AT+CIPAP_DEF=19216851
AT+CWDHCPS_DEF AT+CWDHCPS_DEF=13192168410192168415
AT+SAVETRANSLINK AT+SAVETRANSLINK_DEF=11921686101001
AT+CIPDNS_DEF AT+CIPDNS_DEF=120867220220
AT+SYSMSG_DEF AT+SYSMSG_DEF=3
AT+CWCOUNTRY_DEF AT+CWCOUNTRY_DEF=1CN15
AT+CIPSSLCCONF AT+CIPSSLCCONF=2
保存在 Flash 系统参数区
AT+CWMODE_DEF AT+CWMODE_DEF=3
AT+CWJAP_DEF AT+CWJAP_DEF=abc0123456789
AT+CWSAP_DEF AT+CWSAP_DEF=ESP82661234567853
AT+CWAUTOCONN AT+CWAUTOCONN=1
注意
bull 以上指令设置时会先读取 Flash 中的原配置仅新配置与原配置不不同时才写 Flash 保存新配置 bull 对于 512 KB + 512 KB Flash Map用户参数区为 0x7C000 ~ 0x8000016 KB bull 对于1024 KB + 1024 KB Flash Map用户参数区为 0xFC000 ~ 0x10000016 KB bull 系统参数区始终为 Flash 的最后 16 KB
Espressif 59 62 201902
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
附录 B
B 附录 B ESP8266 AT 指令中的提示信息说明如下
提示信息 说明
ready AT 固件成功启动
ERROR 指令输入错误或者指令执行行出错
WIFICONNECTED ESP8266 station 连接到 AP
WIFIGOTIP ESP8266 station 获取到 IP 地址
WIFIDISCONNECT ESP8266 station 的 WiFi 连接断开
busys busy sending表示系统正在发送数据的过程中无法响应当前输入
busyp busy processing表示系统正在处理理前一条指令无法响应当前输入
ltconn_idgtCONNECT 建立了了 ltconn_idgt 号网络连接
ltconn_idgtCLOSED ltconn_idgt 号网络连接断开
+IPD 接收到网络数据
+STA_CONNECTEDltsta_macgt 有 station 连入 ESP8266 softAP
+DIST_STA_IPltsta_macgtltsta_ipgt ESP8266 softAP 给连入的 station 分配 IP 地址
+STA_DISCONNECTEDltsta_macgt station 从 ESP8266 softAP 断开连接
Espressif 60 62 201902
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
附录 C
C QampA 如遇到 AT 使用异常请发邮件至乐鑫技术支持附上如下信息
bull AT 软件的版本号指令 AT+GMR 可获取版本信息
bull 硬件模块的信息例例如ESP-WROOM-02
bull 详细的测试步骤说明例例如
AT+CWMODE_CUR=1
OK
AT+GMR
ATversion02300(Apr242015211101)
SDKversion101
compiletimeApr242015211931
OK
AT+CIPSTAMAC_DEF=14CF11223305
OK
bull 如能提供 log 打印信息请附上异常 log 信息例例如以下截屏
etsJan82013rstcause1bootmode(33)
load0x40100000len26336room16
tail0
chksum0xde
load0x3ffe8000len5672room8
tail0
chksum0x69
load0x3ffe9630len8348room8
tail4
chksum0xcb
csum0xcb
SDKversion091
addrnotackwhentxwritecmd
modesta(18fe3497d57b)+softAP(1afe3497d57b)
Espressif 61 62 201902
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom
免责申明和版权公告 本文中的信息包括供参考的 URL 地址如有变更更恕不不另行行通知 文档ldquo按现状rdquo提供不不负任何担保责任包括对适销性适用于特定用途或非侵权性的任何担保和任何提案规格或样品在他处提到的任何担保本文档不不负任何责任包括使用本文档内信息产生的侵犯任何专利利权行行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有蓝牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称商标和注册商标均属其各自所有者的财产特此声明 版权归copy 2019 乐鑫所有保留留所有权利利乐鑫 IOT 团队
wwwespressifcom