esp32_at_instruction_set_and_examples_cn

Transcription

1 ESP32 AT 集与使 用 版本 1.2 乐鑫信息科技 版权所有

2 关于本 手册 本 文描述 ESP32 AT 集功能以及使 用 方法, 并介绍 几种常 见的 AT 使 用 发布说明 日期版本发布说明 V1.0 首次发布 更更新章节 ,5.2.8,5.2.15,6.2.5, V1.1 新增章节 5.2.9,6.2.29,6.2.30, 更更新第 8 章 V1.2 更更新第 1 章和章节 文档变更更通知 用户可通过乐鑫官 网订阅 页 面 订阅技术 文 档变更更的电 子邮件通知 证书下载 用户可通过乐鑫官 网证书下载 页 面 下载产 品证书

3 目录 1. 前 言 自定义 AT 烧录 AT 固件 说明 基础 AT 基础 AT 一览表 基础 AT 描述 AT 测试 AT 启动 AT+RST 重启模块 AT+GMR 查询版本信息 AT+GSLP 进 入 Deep-sleep 模式 ATE 开关回显功能 AT+RESTORE 恢复出 厂设置 AT+UART_CUR 设置 UART 当前临时设置, 不不保存到 Flash AT+UART_DEF 设置 UART 配置, 保存到 Flash AT+SLEEP 设置 sleep 模式 AT+SYSRAM 查询当前剩余 RAM 大 小 AT+SYSFLASH 读写 Flash 用户分区 * AT+FS 文件系统操作 * AT+RFPOWER 设置 RF TX Power * Wi-Fi 功能 AT 基础 Wi-Fi 功能 AT 一览表 基础 Wi-Fi 功能 AT 描述 AT+CWMODE 设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP) AT+CWJAP 连接 AP... 14

4 AT+CWLAPOPT 设置 CWLAP 的属性 AT+CWLAP 扫描当前可 用的 AP AT+CWQAP 断开与 AP 的连接 AT+CWSAP 配置 ESP32 SoftAP 参数 AT+CWLIF 查询连接到 ESP32 SoftAP 的 Station 信息 AT+CWDHCP 设置 DHCP AT+CWDHCPS 设置 ESP32 SoftAP DHCP 分配的 IP 范围, 保存到 Flash AT+CWAUTOCONN 上电是否 自动连接 AP AT+CWSTARTSMART 开启 SmartConfig AT+CWSTOPSMART 停 止 SmartConfig AT+WPS 设置 WPS 功能 AT+CWHOSTNAME 设置 Station 的主机名称 * AT+MDNS 设置 MDNS 功能 * TCP/IP 相关 AT TCP/IP 一览表 TCP/IP 描述 AT+CIPSTATUS 查询 网络连接信息 AT+CIPDOMAIN 域名解析功能 AT+CIPDNS 自定义 DNS 服务器器 AT+CIPSTAMAC 设置 ESP32 Station 接 口的 MAC 地址 AT+CIPAPMAC 设置 ESP32 SoftAP 的 MAC 地址 AT+CIPSTA 设置 ESP32 Station 的 IP 地址 AT+CIPAP 设置 ESP32 SoftAP 的 IP 地址 AT+CIPSTART 建 立 TCP 连接,UDP 传输或 SSL 连接 AT+CIPSSLCCONF 配置 SSL Client * AT+CIPSEND 发送数据 AT+CIPSENDEX 发送数据 AT+CIPCLOSE 关闭 TCP/UDP/SSL 传输... 32

5 AT+CIFSR 查询本地 IP 地址 AT+CIPMUX 设置多连接 AT+CIPSERVER 建 立 / 关闭 TCP 或 SSL 服务器器 * AT+CIPSERVERMAXCONN 设置服务器器允许建 立的最 大连接数 * AT+CIPMODE 设置传输模式 AT+SAVETRANSLINK 保存透传到 Flash AT+CIPSTO 设置 TCP 服务器器超时时间 AT+CIPSNTPCFG 设置时域和 SNTP 服务器器 AT+CIPSNTPTIME 查询 SNTP 时间 AT+CIUPDATE 通过 Wi-Fi 升级软件 AT+CIPDINFO 接收 网络数据时是否提示对端 IP 和端 口 IPD 接收 网络数据 AT+PING Ping 功能 BLE 相关 AT BLE 一览表 BLE 描述 AT+BLEINIT BLE 初始化 AT+BLEADDR 设置 BLE 设备地址 AT+BLENAME 设置 BLE 设备名称 AT+BLESCANPARAM 设置 BLE 扫描参数 AT+BLESCAN 使能 BLE 扫描 AT+BLESCANRSPDATA 设置 BLE 扫描 AT+BLEADVPARAM 设置 广播参数 AT+BLEADVDATA 设置 BLE 广播数据 AT+BLEADVSTART 开始 BLE 广播 AT+BLEADVSTOP 结束 BLE 广播 AT+BLECONN 建 立 BLE 连接 AT+BLECONNPARAM 更更新 BLE 连接参数... 48

6 AT+BLEDISCONN 断开 BLE 连接 AT+BLEDATALEN 设置 BLE 数据包 长度 AT+BLECFGMTU 设置 GATT MTU 的 长度 AT+BLEGATTSSRVCRE GATTS 创建服务 AT+BLEGATTSSRVSTART GATTS 开启服务 AT+BLEGATTSSRVSTOP GATTS 停 止服务 AT+BLEGATTSSRV GATTS 发现服务 AT+BLEGATTSCHAR GATTS 发现服务特征 AT+BLEGATTSNTFY GATTS 通知服务特征值 AT+BLEGATTSIND GATTS 指示服务特征值 AT+BLEGATTSSETATTR GATTS 设置服务特征值 AT+BLEGATTCPRIMSRV GATTC 发现基本服务 AT+BLEGATTCINCLSRV GATTC 发现包含服务 AT+BLEGATTCCHAR GATTC 发现服务特征 AT+BLEGATTCRD GATTC 读取服务特征值 AT+BLEGATTCWR GATTC 写服务特征值 AT+BLESPPCFG 配置 BLE 透传模式 AT+BLESPP 开启 BLE 透传模式 AT+BLESECPARAM 设置加密参数 AT+BLEENC 发起加密请求 AT+BLEENCRSP 回复加密请求 AT+BLEKEYREPLY 回复加密密钥 AT+BLECONFREPLY 回复确认结果 AT+BLEENCDEV 查询已绑定的设备 AT+BLEENCCLEAR 解除绑定 设置保存在 NVS 区域 AT 列列表 提示消息列列表... 66

7 9. AT 使 用 单连接 TCP 客户端 UDP 传输 固定远端的 UDP 通信 远端可变的 UDP 通信 Wi-Fi 透传 TCP 客户端单连接透传 UDP 透传 多连接 TCP 服务器器 BLE AT 应 用 基于 BLE 广播的应 用 ibeacon 基于 BLE 连接的应 用 OTA 功能 问题反馈... 95

8 1. 前 言 1. 前 言 本 文描述 ESP32 AT 集功能以及使 用 方法 集主要分为 : 基础 AT Wi-Fi 功能 AT TCP/IP 工具箱 AT 等 目前, 标注 * 号的部分 AT 尚未经过严格测试, 为抢先试 用版本 说明 : ESP32 AT 集相关代码链接 : 自定义 AT 自定义 AT 命名时, 使 用英 文字符以及 _( 下划线 ) 等合法字符 AT 基于 ESP-IDF 编译,esp-at 中提供了了开发者 自定义 AT 的 乐鑫原本提供的 AT 以库 文件 libat_core.a 的形式提供, 将包含在编译 生成的 AT BIN 固件中 结构体 at_cmd_struct 用于定义 一条的四种类型, 用户可以参考 /esp32-at/main/ interface/uart/at_uart_task.c 中提供的, 实现 自定义 AT 1.2. 烧录 AT 固件 请使 用乐鑫官 方烧录 工具, 烧录时注意选择对应的 Flash 大 小 乐鑫官 方烧录 工具链接 : 烧录地址 见 ESP32_AT_BIN 文件夹中的 download.config 文件 AT 固件中的部分 bin 文件 用于特定的功能, 具体如下 : at_customize.bin 包含了了 用户分区的详细信息, 如烧录 ble_data.bin factory_param_xxx.bin 和 SSL 证书的分区信息 如有需要, 可通过 AT+FS AT+SYSFLASH 操作 用户分区 factory_param_xxx.bin 用于适配不不同的 ESP 官 方模组 ; 如果客户 自 己设计模组, 可以参考 文档 esp32-at/docs/esp32_at_factory_parameter_bin.md 配置, 编译时 将 自动 生成 ; 烧录时, 将 download.config 里里的 customized_partitions/ factory_param.bin 文件, 替换为对应的 customized_partitions/ factory_param_xxx.bin Espressif! 1/! 96

9 1. 前 言 模组 UART 管脚 (TX, RX, CTS, RTS) 对应 bin 文件 ESP32-WROOM-32 系列列模组 ( 默认值 ) ESP32-WROVER 系列列模组 ESP32-PICO 系列列模组 ESP32-SOLO 系列列模组 GPIO17, GPIO16, GPIO15, GPIO14 GPIO22, GPIO19, GPIO15, GPIO14 GPIO22, GPIO19, GPIO15, GPIO14 GPIO17, GPIO16, GPIO15, GPIO14 customized_partitions/ factory_param_wroom-32.bin customized_partitions/ factory_param_wrover-32.bin customized_partitions/ factory_param_pico-d4.bin customized_partitions/ factory_param_solo-1.bin 说明 : ble_data.bin 用于 ESP32 作为 BLE server 时提供 BLE services; server_cert.bin,server_key.bin,server_ca.bin 用于提供 SSL 认证证书 ; 如果上述某个功能 无需使 用, 则对应 bin 文件 无需烧录 如果以上功能均需要使 用, 即全部 bin 文件都需要烧录 那么, 在 ESP Flash Download Tool 上提供了了 CombineBin 按键, 可以将多个 bin 合成 1 个 bin 文件 用于烧录 请注意, 在 CombineBin 时, 各个 bin 文件对应的地址, 以及 flash 配置等信息要求配置正 确 如果 自 行行编译 AT 源代码, 可使 用命令 make print_flash_cmd 查询烧录地址, 具体步骤如 下 : UART CTS 和 RTS 是可选的连接管脚, 并 非必须的配置 说明 : 如果 ESP32 AT 启动失败, 并且提示 ota data partition invalid 打印信息, 请将 blank.bin 烧录到 esp32-at/partitions_at.csv 中 otadata 对应的地址, 进 行行初始化 用户可以 自 行行定义, 使 用其他 UART 进 行行 AT 通信, 例例如, 假设改为使 用 UART0 通信, 配置步骤如 下 : - make menuconfig -> component config -> AT -> AT UART settings 修改为 UART 0 - 调试信息默认会从 UART 0 打印, 用户可在 menuconfig 中关闭打印, 具体步骤如下 :make menuconfig --> Component config --> ESP32-specific --> UART for console output ESP32_AT_Bin/factory 中是针对 ESP 官 方模组 CombineBin 合成的 ESP AT 量量产固件 rm sdkconfig: 删除旧的配置 文件 make defconfig: 设置为最新的默认配置 文件 make print_flash_cmd: 查询烧录地址 Espressif! 2/! 96

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

11 3. 基础 AT 3. 基础 AT 3.1. 基础 AT 一览表 AT AT+RST AT+GMR AT+GSLP ATE AT+RESTORE AT+UART_CUR AT+UART_DEF AT+SLEEP AT+SYSRAM AT+SYSFLASH AT+FS AT+RFPOWER 描述测试 AT 启动重启模块查看版本信息进 入 Deep-sleep 模式开关回显功能恢复出 厂设置 UART 当前临时配置 UART 默认配置, 保存到 Flash 设置 sleep 模式查询当前剩余 RAM 大 小读写 flash 用户分区 文件系统操作设置 RF TX Power 3.2. 基础 AT 描述 AT 测试 AT 启动 执 行行 AT AT+RST 重启模块 执 行行 AT+RST - Espressif! 4/! 96

12 3. 基础 AT 注意 本全 大写 ( 即 AT+RST) 时, 可 用于强制重启 当系统处于 busy 状态时, 如果使 用 AT+RST, 系统将提示 will force to restart!!!, 并强制重启 AT+GMR 查询版本信息 执 行行 AT+GMR <AT version info> <SDK version info> <compile time> <AT version info>:at 版本信息 <SDK version info>:sdk 版本信息 <compile time>: 编译 生成时间 AT+GSLP 进 入 Deep-sleep 模式 设置 AT+GSLP=<time> <time> <time>: 设置 ESP32 的睡眠时 长, 单位 : 毫秒 ESP32 会在休眠设定时 长后 自动唤醒 ATE 开关回显功能 执 行行 ATE ATE0: 关闭回显 ATE1: 开启回显 AT+RESTORE 恢复出 厂设置 执 行行 AT+RESTORE Espressif! 5/! 96

13 3. 基础 AT! 恢复出 厂设置, 将擦除所有保存到 Flash 的参数, 恢复为默认参数 恢复出 厂设置会导致机器器重启 AT+UART_CUR 设置 UART 当前临时设置, 不不保存到 Flash 查询 : AT+UART_CUR? +UART_CUR:<baudrate>,<databits>,<stopbi ts>,<parity>,<flow control> 查询返回的是 UART 实际参数值, 由于时钟分频的原因,UART 实际参数值与设置值有 一定误差, 是正常现象 设置 : AT+UART_CUR=<baudrate>,<databits>,<stop bits>,<parity>,<flow control> <baudrate>:uart 波特率 <databits>: 数据位 5:5 bit 数据位 6:6 bit 数据位 7:7 bit 数据位 8:8 bit 数据位 <stopbits>: 停 止位 1:1 bit 停 止位 2:1.5 bit 停 止位 3:2 bit 停 止位 <parity>: 校验位 0:None 1:Odd 2:Even <flow control>: 流控 0: 不不使能流控 1: 使能 RTS 2: 使能 CTS 3: 同时使能 RTS 和 CTS 注意 本设置不不保存到 flash 使 用流控需要硬件 支持流控 : IO15 为 UART0 CTS IO14 为 UART0 RTS 波特率 支持范围 :80 ~ AT+UART_CUR=115200,8,1,0,3 Espressif! 6/! 96

14 3. 基础 AT AT+UART_DEF 设置 UART 配置, 保存到 Flash 查询 : AT+UART_DEF? +UART_DEF:<baudrate>,<databits>,<stopbi ts>,<parity>,<flow control> <baudrate>:uart 波特率 <databits>: 数据位 5:5 bit 数据位 6:6 bit 数据位 7:7 bit 数据位 8:8 bit 数据位 <stopbits>: 停 止位 1:1 bit 停 止位 2:1.5 bit 停 止位 3:2 bit 停 止位 <parity>: 校验位 0:None 1:Odd 2:Even <flow control>: 流控 0: 不不使能流控 1: 使能 RTS 2: 使能 CTS 3: 同时使能 RTS 和 CTS 设置 : AT+UART_DEF=<baudrate>,<databits>,<stop bits>,<parity>,<flow control> 本设置将保存在 NVS 区, 重新上电后仍 生效 注意 使 用流控需要硬件 支持流控 : IO15 为 UART0 CTS IO14 为 UART0 RTS 波特率 支持范围 :80 ~ AT+UART_DEF=115200,8,1,0,3 Espressif! 7/! 96

15 3. 基础 AT AT+SLEEP 设置 sleep 模式 设置 : AT+SLEEP=<sleep mode> <sleep mode>: 0: 禁 用休眠模式 1:Modem-sleep 模式 AT+SLEEP= AT+SYSRAM 查询当前剩余 RAM 大 小 查询 AT+SYSRAM? +SYSRAM:<remaining RAM size> <remaining RAM size>: 当前剩余 RAM 大 小, 单位 : 字节 AT+SYSRAM? +SYSRAM: AT+SYSFLASH 读写 Flash 用户分区 * 查询 : AT+SYSFLASH? 功能 : 查询 Flash 中的 用户分区 +SYSFLASH:<partition>,<type>,<subtype>,< addr>,<size> <partition>: 用户分区名称 <type>: 用户分区类型 <subtype>: 用户分区 子类型 <addr>: 地址 <size>: 分区 大 小 设置 : AT+SYSFLASH=<operation>,<partition>,<o ffset>,<length> 功能 : 设置 Flash 中的 用户分区 +SYSFLASH:<length>,<data> <operation>: 0: 擦除分区 1: 写分区 2: 读分区 <partition>: 用户分区名称 <offset>: 偏移地址 <length>: 长度 Espressif! 8/! 96

16 3. 基础 AT 使 用本需烧录 at_customize.bin 详细信息可参考 ESP32_Customize_Partitions 擦除分区的注意事项 : 注意 擦除分区时, 设置可省略略 <offset> 和 <length> 参数, 用于完整擦除该 目标分区 例例如, AT+SYSFLASH=0,"ble_data" 可擦除整个 ble_data 区域 如果擦除分区时, 不不省略略 <offset> 和 <length> 参数, 则这两个参数值要求是 4KB 的整数倍 分区的定义可以参考 ESP-IDF Partition Tables 的介绍 // read 100 bytes from the "ble_data" partition offset 0. AT+SYSFLASH=2,"ble_data",0,100 // write 10 bytes to the "ble_data" partition offset 100. AT+SYSFLASH=1,"ble_data",100,10 // erase 8192 bytes from the "ble_data" partition offset AT+SYSFLASH=0,"ble_data",4096, AT+FS 文件系统操作 * 设置 : AT+FS=<type>,<operation>,<filename>,<offset>,<length> <type>: 目前仅 支持 FATFS 0:FATFS <operation>: 0: 删除 文件 1: 写 文件 2: 读 文件 3: 查询 文件 大 小 4: 查询路路径下 文件, 目前仅 支持根 目录 <offset>: 偏移地址, 仅针对读写操作设置 <length>: 长度, 仅针对读写操作设置 注意 本功能默认关闭, 需要 用户 自 行行通过 make menuconfig 配置后, 重新编译使能 使 用本需烧录 at_customize.bin 详细信息可参考 ESP32_Customize_Partitions Espressif! 9/! 96

17 3. 基础 AT // delete a file. AT+FS=0,0,"filename" // write 10 bytes to offset 100 of a file. AT+FS=0,1,"filename",100,10 // read 100 bytes from offset 0 of a file. AT+FS=0,2,"filename",0,100 // list all files in the root directory. AT+FS=0,4,"." AT+RFPOWER 设置 RF TX Power * 设置 : AT+RFPOWER=<wifi_power>[,<ble_adv_power>,<ble_scan_power>,<ble_conn_power>] <wifi_power>: 取值范围 [0, 11] 0:level 0, 参考 phy_init_data.bin 的第 44 字节, 默认为 19.5 dbm 1:level 1, 参考 phy_init_data.bin 的第 45 字节, 默认为 19 dbm 2:level 2, 参考 phy_init_data.bin 的第 46 字节, 默认为 18.5 dbm 3:level 3, 参考 phy_init_data.bin 的第 47 字节, 默认为 17 dbm 4:level 4, 参考 phy_init_data.bin 的第 48 字节, 默认为 15 dbm 5:level 5, 参考 phy_init_data.bin 的第 49 字节, 默认为 13 dbm 6:level 5-2 dbm 例例如, 当 level 5 为 13 dbm 时, 设置为 6 表示 11 dbm 7:level dbm 8:level 5-6 dbm 9:level 5-8 dbm 10:level 5-11 dbm 11:level 5-14 dbm <ble_adv_power>:ble 广播的 RF TX Power, 取值范围 [0, 7] 0:7dBm 1:4dBm 2:1dBm 3:-2 dbm 4:-5 dbm 5:-8 dbm 6:-11 dbm 7:-14 dbm <ble_scan_power>:ble 扫描的 RF TX Power, 取值范围 [0, 7], 同 <ble_adv_power> <ble_conn_power>:ble 连接的 RF TX Power, 取值范围 [0, 7], 同 <ble_adv_power> 注意 本的设置并不不精确, 实际值可能与设置值存在差异 BLE RF TX Power 的三个参数, 可以同时缺省, 或者同时设置 Espressif! 10/! 96

18 3. 基础 AT AT+RFPOWER=0 或者 AT+RFPOWER=0,0,0,0 Espressif! 11/! 96

19 4. Wi-Fi 功能 AT 4. Wi-Fi 功能 AT 4.1. 基础 Wi-Fi 功能 AT 一览表 AT+CWMODE AT+CWJAP AT+CWLAPOPT AT+CWLAP AT+CWQAP AT+CWSAP AT+CWLIF AT+CWDHCP AT+CWDHCPS AT+CWAUTOCONN AT+CWSTARTSMART AT+CWSTOPSMART AT+WPS AT+CWHOSTNAME AT+MDNS 说明设置 Wi-Fi 模式 (STA/AP/STA+AP) 连接 AP 设置 AT+CWLAP 扫描结果的属性扫描附近的 AP 信息与 AP 断开连接设置 ESP32 SoftAP 配置获取连接到 ESP32 SoftAP 的 Station 的信息设置 DHCP 设置 ESP32 SoftAP DHCP 分配的 IP 范围, 保存到 Flash 设置上电时是否 自动连接 AP 开始 SmartConfig 停 止 SmartConfig 设置 WPS 功能设置 ESP32 station 主机名称 MDNS 功能 Espressif! 12/! 96

20 4. Wi-Fi 功能 AT 4.2. 基础 Wi-Fi 功能 AT 描述 AT+CWMODE 设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP) 查询 : 设置 : 测试 : AT+CWMODE=? AT+CWMODE? 功能 : 查询 ESP32 当前 Wi-Fi 模 AT+CWMODE=<mode> 功能 : 设置 ESP32 当前 Wi-Fi 模 式 式 +CWMODE:<mode> 取值列列表 +CWMODE:<mode> <mode>: 参数说 明 0: 无 Wi-Fi 模式, 并且关闭 Wi-Fi RF * 1:Station 模式 2:SoftAP 模式 3:SoftAP+Station 模式 注意本设置将保存在 NVS 区 AT+CWMODE=3 Espressif! 13/! 96

21 4. Wi-Fi 功能 AT AT+CWJAP 连接 AP 查询 : AT+CWJAP? 功能 : 查询 ESP32 Station 已连接的 AP 信息 +CWJAP:<ssid>,<bssid>,<channel>,<rssi > <ssid>: 字符串串参数,AP 的 SSID <bssid>:ap 的 MAC 地址 <channel>: 信道号 <rssi>: 信号强度 设置 : AT+CWJAP=<ssid>,<pwd>[,<bssid>] 功能 : 设置 ESP32 Station 需连接的 AP 或者 +CWJAP:<error code> ERROR <ssid>: 目标 AP 的 SSID <pwd>: 密码最 长 64 字节 ASCII [<bssid>]: 目标 AP 的 MAC 地址, 一般 用于有多个 SSID 相同的 AP 的情况 <error code>:( 仅供参考, 并不不可靠 ) 1: 连接超时 2: 密码错误 3: 找不不到 目标 AP 4: 连接失败 其他值 : 未知错误 参数设置需要开启 Station 模式, 若 SSID 或者 password 中含有特殊符号, 例例如, 或者 或者 \ 时, 需要进 行行转义, 其它字符转义 无效 // If ESP32 station connects to an AP, it will prompt messages: WIFI CONNECTED 提示信息 WIFI GOT IP // If the WiFi connection ends, it will prompt messages: WIFI DISCONNECT 注意 本设置将保存在 NVS 区 AT+CWJAP="abc"," " 例例如, 目标 AP 的 SSID 为 "ab\,c",password 为 " "\", 则如下 : AT+CWJAP="ab\\\,c"," \"\\" 如果有多个 AP 的 SSID 均为 "abc", 可通过 BSSID 确定 目标 AP: AT+CWJAP="abc"," ","ca:d7:19:d8:a6:44" Espressif! 14/! 96

22 4. Wi-Fi 功能 AT! AT+CWLAPOPT 设置 CWLAP 的属性 设置 AT+CWLAPOPT=<sort_enable>,<mask> <sort_enable>: AT+CWLAP 的扫描结果是否按照信号强度 RSSI 值排序 : 0: 不不排序 1: 为根据 RSSI 排序 <mask>: 对应 bit 若为 1, 则 AT+CWLAP 的扫描结果显示相关属性, 对应 bit 若为 0, 则不不显示 具体如下 : bit 0: 设置 AT+CWLAP 的扫描结果是否显示 <ecn> bit 1: 设置 AT+CWLAP 的扫描结果是否显示 <ssid> bit 2: 设置 AT+CWLAP 的扫描结果是否显示 <rssi> bit 3: 设置 AT+CWLAP 的扫描结果是否显示 <mac> bit 4: 设置 AT+CWLAP 的扫描结果是否显示 <channel> AT+CWLAPOPT=1,31 第 一个参数为 1, 表示后续如果使 用 AT+CWLAP, 扫描结果将按照信号强度 RSSI 值 排序 ; 第 二个参数为 31, 即 0x1F, 表示 <mask> 的相关 bit 全部置为 1, 后续如果使 用 AT+CWLAP, 扫描结果将显示所有参数 Espressif! 15/! 96

23 4. Wi-Fi 功能 AT AT+CWLAP 扫描当前可 用的 AP 设置 : AT+CWLAP=<ssid>[,<mac>,<channel>] 功能 : 列列出符合特定条件的 AP +CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<chann el> <ecn>: 加密 方式 执 行行 : AT+CWLAP 功能 : 列列出当前可 用的 AP +CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<chann el> 0:OPEN 1:WEP 2:WPA_PSK 3:WPA2_PSK 4:WPA_WPA2_PSK 5:WPA2_Enterprise( 目前 AT 不不 支持连接这种加密 AP) <ssid>: 字符串串参数,AP 的 SSID <rssi>: 信号强度 [<mac>]( 选填参数 ): 字符串串参数,AP 的 MAC 地址 [<channel>]( 选填参数 ): 信道号 AT+CWLAP="WiFi","ca:d7:19:d8:a6:44",6 或者查找指定 SSID 的 AP: AT+CWLAP="WiFi" AT+CWQAP 断开与 AP 的连接 执 行行 AT+CWQAP - Espressif! 16/! 96

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

25 4. Wi-Fi 功能 AT AT+CWLIF 查询连接到 ESP32 SoftAP 的 Station 信息 执 行行注意 AT+CWLIF +CWLIF:<ip addr>,<mac> <ip addr>: 连接到 ESP32 SoftAP 的 Station IP 地址 <mac>: 连接到 ESP32 SoftAP 的 Station MAC 地址 本 无法查询静态 IP, 仅 支持在 ESP32 SoftAP 和连 入的 Station DHCP 均使能的情况下有效 AT+CWDHCP 设置 DHCP 查询 : AT+CWDHCP? +CWDHCP:<enable> <enable>: DHCP 是否使能 Bit0: 0:Station DHCP 关闭 1:Station DHCP 开启 Bit1: 0:SoftAP DHCP 关闭 1:SoftAP DHCP 开启 本设置保存到 NVS 区域 设置 : AT+CWDHCP=<operate>,<mode> 功能 : 设置 DHCP <operate>: 0: 关闭 1: 开启 <mode>: Bit0:Station DHCP Bit1:SoftAP DHCP 注意 本设置与设置静态 IP 的 (AT+CIPSTA 系列列和 AT+CIPAP 系列列 ) 互相影响 : 设置使能 DHCP, 则静态 IP 无效 ; 设置静态 IP, 则 DHCP 关闭 ; 以最后的设置为准 AT+CWDHCP=1,1 使能 Station DHCP, 如果原 DHCP mode 为 2, 则现 DHCP mode 为 3 AT+CWDHCP=0,2 禁能 SoftAP DHCP, 如果原 DHCP mode 为 3, 则现 DHCP mode 为 1 Espressif! 18/! 96

26 4. Wi-Fi 功能 AT! AT+CWDHCPS 设置 ESP32 SoftAP DHCP 分配的 IP 范围, 保存到 Flash 设置 : 查询 : AT+CWDHCPS? +CWDHCPS:<lease>,<start IP>,<end IP> <enable>: AT+CWDHCPS=<enable>,<lease>,<start IP>,<end IP> 功能 : 设置 ESP32 SoftAP DHCP 服务器器分配的 IP 范 围 0: 清除设置 IP 范围, 恢复默认值, 后续参数 无需填写 1: 使能设置 IP 范围, 后续参数必须填写 <lease>: 租约时间, 单位 : 分钟, 取值范围 [1, 2880] <start IP>:DHCP 服务器器 IP 池的起始 IP <end IP>:DHCP 服务器器 IP 池的结束 IP 本设置保存到 NVS 区域 注意 本必须在 ESP32 SoftAP 模式使能, 且开启 DHCP 的情况下使 用, 设置的 IP 范围必 须与 ESP32 SoftAP 在同 一 网段 AT+CWDHCPS=1,3," "," " 或者 AT+CWDHCPS=0 // 清除设置, 恢复默认值 AT+CWAUTOCONN 上电是否 自动连接 AP 设置 AT+CWAUTOCONN=<enable> <enable>: 0: 上电不不 自动连接 AP 1: 上电 自动连接 AP ESP32 Station 默认上电 自动连接 AP 注意 本设置保存到 NVS 区域 AT+CWAUTOCONN=1 Espressif! 19/! 96

27 4. Wi-Fi 功能 AT AT+CWSTARTSMART 开启 SmartConfig 设置 : AT+CWSTARTSMART=<type> 功能 : 开启某指定类型的 SmartConfig 执 行行 : AT+CWSTARTSMART 功能 : 开启 ESP-TOUCH+AirKiss 兼容模式 <type>: 1:ESP-TOUCH 2:AirKiss 3:ESP-TOUCH+AirKiss SmartConfig 连接过程中的提示信息如下 : none 说明 smartconfig type: <type> // AIRKISS, ESPTOUCH or UNKNOWN Smart get wifi info // got SSID and password ssid:<ap's SSID> password:<ap's password> // ESP32 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" 用户可以参考 ESP-TOUCH 用户指南来了了解 SmartConfig 的详细介绍 仅 支持在 ESP32 单 Station 模式下调 用 注意 消息 Smart get wifi info 表示 SmartConfig 成功获取到 AP 信息, 之后 ESP32 尝试连接 AP, 打印连接过程 消息 smartconfig connected wifi 表示成功连接到 AP, 此时可以调 用 AT+CWSTOPSMART 停 止 SmartConfig 再执 行行其他 注意, 在 SmartConfig 过程中请勿执 行行其他 AT+CWMODE=1 AT+CWSTARTSMART= AT+CWSTOPSMART 停 止 SmartConfig 执 行行 AT+CWSTOPSMART - 注意 无论 SmartConfig 成功与否, 都请调 用 AT+CWSTOPSMART 释放快连占 用的内存 AT+CWSTOPSMART Espressif! 20/! 96

28 4. Wi-Fi 功能 AT! AT+WPS 设置 WPS 功能 设置 AT+WPS=<enable> <enable>: 注意 1: 开启 PBC 类型的 WPS 0: 关闭 PBC 类型的 WPS WPS 功能必须在 ESP32 Station 使能的情况下调 用 WPS 不不 支持 WEP 加密 方式 AT+CWMODE=1 AT+WPS= AT+CWHOSTNAME 设置 Station 的主机名称 * 查询 : AT+CWHOSTNAME? 功能 : 查询 ESP32 Station 的主机名称 +CWHOSTNAME:<host name> 如果未使能 ESP32 Station 模式, 则返回 +CWHOSTNAME:<null> <hostname>: 主机名称, 最 长 支持 32 字节 设置 : AT+CWHOSTNAME=<hostname> 功能 : 设置 ESP32 Station 的主机名称 如果成功, 返回 如果未使能 ESP32 station 模式, 则提示 ERROR 本设置不不保存到 Flash, 重启后将恢复默认值 注意 ESP32 Station 默认的主机名称为 ESP_MAC 地址低 3 个字节 例例如, +CWHOSTNAME:<ESP_A378DA> AT+CWMODE=3 AT+CWHOSTNAME="my_test" Espressif! 21/! 96

29 4. Wi-Fi 功能 AT AT+MDNS 设置 MDNS 功能 * 设置 AT+MDNS=<enable>[,<hostname>,<service_name>,<port>] <enable>: 1: 开启 MDNS 功能, 后续参数需要填写 0: 关闭 MDNS 功能, 后续参数 无需填写 <hostname>:mdns 主机名称 <service_name>:mdns 服务名称, 要求以下划线开始 <port>:mdns 服务端 口注意 <hostname> 和 <service_name> 不不能包含其他特殊字符 ( 例例如. 符号 ) AT+MDNS=1,"espressif","_iot",8080 或者 AT+MDNS=0 Espressif! 22/! 96

30 5. TCP/IP 相关 AT 5. TCP/IP 相关 AT 5.1. TCP/IP 一览表 AT+CIPSTATUS AT+CIPDOMAIN AT+CIPDNS AT+CIPSTAMAC AT+CIPAPMAC AT+CIPSTA AT+CIPAP AT+CIPSTART AT+CIPSSLCCONF AT+CIPSEND AT+CIPSENDEX AT+CIPCLOSE AT+CIFSR AT+CIPMUX AT+CIPSERVER AT+CIPSERVERMAXCONN AT+CIPMODE AT+SAVETRANSLINK AT+CIPSTO AT+CIUPDATE AT+CIPDINFO AT+CIPSNTPCFG AT+CIPSNTPTIME AT+PING 描述查询 网络连接信息域名解析功能 自定义 DNS 服务器器设置 ESP32 Station 的 MAC 地址设置 ESP32 SoftAP 的 MAC 地址设置 ESP32 Station 的 IP 地址设置 ESP32 SoftAP 的 IP 地址建 立 TCP 连接,UDP 传输或者 SSL 连接配置 SSL Client 发送数据发送数据, 达到设置 长度, 或者遇到字符 \0, 则发送数据关闭 TCP/UDP/SSL 传输查询本地 IP 地址设置多连接模式设置 TCP 服务器器设置 TCP 服务器器允许的最 大连接数设置透传模式保存透传连接到 Flash 设置 ESP32 作为 TCP 服务器器时的超时时间通过 Wi-Fi 升级软件接收 网络数据时,+IPD 是否提示对端 IP 和端 口设置时域和 SNTP 服务器器查询 SNTP 时间 Ping 功能 Espressif! 23/96

31 5. TCP/IP 相关 AT 5.2. TCP/IP 描述 AT+CIPSTATUS 查询 网络连接信息 执 行行 AT+CIPSTATUS STATUS:<stat> +CIPSTATUS:<link ID>,<type>,<remote IP>,<remote port>,<local port>,<tetype> <stat>:esp32 Station 接 口的状态 2:ESP32 Station 已连接 AP, 获得 IP 地址 3:ESP32 Station 已建 立 TCP 或 UDP 传输 4:ESP32 Station 断开 网络连接 5:ESP32 Station 未连接 AP <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数,"TCP" 或者 "UDP" <remote IP>: 字符串串, 远端 IP 地址 <remote port>: 远端端 口值 <local port>:esp32 本地端 口值 <tetype>: 0:ESP32 作为客户端 1:ESP32 作为服务器器 AT+CIPDOMAIN 域名解析功能 执 行行 AT+CIPDOMAIN=<domain name> +CIPDOMAIN:<IP address> 或者 ERROR <domain name>: 待解析的域名 AT+CWMODE=1 AT+CWJAP="SSID","password" AT+CIPDOMAIN="iot.espressif.cn" // set Station mode // access to the internet // DNS function Espressif! 24/96

32 5. TCP/IP 相关 AT! AT+CIPDNS 自定义 DNS 服务器器 功能 : 查询当前使 用的 DNS 服务器器查询 : AT+CIPDNS? +CIPDNS:<DNS server0> [+CIPDNS:<DNS server1>] <enable>: 0: 不不使能 自定义 DNS 服务器器 ; 1: 使能 自定义 DNS 服务器器 功能 : 设置 自定义 DNS 服务器器设置 : AT+CIPDNS=<enable>[,<DNS server0>,<dns server1>] <DNS server0>: 第 一个 DNS 服务器器, 可不不填 ; <DNS server1>: 第 二个 DNS 服务器器, 可不不填 本设置将保存到 flash 对于 AT+CIPDNS=1( 即设置使能 自定义 DNS 服务器器, 但未填写 <DNS server> 参数 ), 则默认使 用 " " 作为 DNS 服务器器 说明 对于 AT+CIPDNS=0 ( 即不不使能 自定义 DNS 服务器器 ), 则默认使 用 " " 作 为 DNS 服务器器 并且, 在与路路由器器交互的过程中,DNS 服务器器可能随着路路由器器的配置更更改 自定义配置 DNS 服务器器时, 若设置两个地址, 地址需配置为不不同的地址 AT+CIPDNS=1," " AT+CIPSTAMAC 设置 ESP32 Station 接 口的 MAC 地址 查询 : AT+CIPSTAMAC? 功能 : 查询 ESP32 Station 的 MAC 地址 +CIPSTAMAC:<mac> 设置 : AT+CIPSTAMAC=<mac> 功能 : 设置 ESP32 Station 的 MAC 地址 <mac>: 字符串串参数,ESP32 Station 的 MAC 地址 本设置保存到 NVS 区域 ESP32 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 注意 ESP32 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "1a: " 但不不能为 "15: " FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 为 非法 MAC, 无法进 行行设置 Espressif! 25/96

33 5. TCP/IP 相关 AT! AT+CIPSTAMAC="18:fe:35:98:d3:7b" AT+CIPAPMAC 设置 ESP32 SoftAP 的 MAC 地址 查询 : AT+CIPAPMAC? 功能 : 查询 ESP32 SoftAP 的 MAC 地址 +CIPAPMAC:<mac> 设置 : AT+CIPAPMAC=<mac> 功能 : 设置 ESP32 SoftAP 的 MAC 地址 <mac>: 字符串串参数,ESP32 SoftAP 的 MAC 地址 本设置保存到 NVS 区域 ESP32 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿将其设置为同 一 MAC 地址 注意 ESP32 MAC 地址第 一个字节的 bit 0 不不能为 1, 例例如,MAC 地址可以为 "18: " 但不不能为 "15: " FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 为 非法 MAC, 无法进 行行设置 AT+CIPAPMAC="1a:fe:36:97:d5:7b" AT+CIPSTA 设置 ESP32 Station 的 IP 地址 查询 : AT+CIPSTA? 功能 : 查询 ESP32 Station 的 IP 地址 +CIPSTA:<ip> 注意 : ESP32 Station IP 需连上 AP 后, 才可以查询 设置 : AT+CIPSTA=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP32 Station 的 IP 地址 <ip>: 字符串串,ESP32 Station 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 本设置保存到 NVS 区域 注意 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPSTA=" "," "," " Espressif! 26/96

34 5. TCP/IP 相关 AT! AT+CIPAP 设置 ESP32 SoftAP 的 IP 地址 查询 : AT+CIPAP? 功能 : 查询 ESP32 SoftAP 的 IP 地址 +CIPAP:<ip>,<gateway>,<netmask> <ip>: 字符串串,ESP32 SoftAP 的 IP 地址 [<gateway>]: 网关 [<netmask>]: 子 网掩码 设置 : AT+CIPAP=<ip>[,<gateway>,<netmask>] 功能 : 设置 ESP32 SoftAP 的 IP 地址 本设置保存到 NVS 区域 目前仅 支持 C 类 IP 地址 注意 本设置与设置 DHCP 的 (AT+CWDHCP 系列列 ) 互相影响 : 设置静态 IP, 则 DHCP 关闭 ; 设置使能 DHCP, 则静态 IP 无效 ; 以最后的设置为准 AT+CIPAP=" "," "," " AT+CIPSTART 建 立 TCP 连接,UDP 传输或 SSL 连接 建 立 TCP 连接 设置 TCP 单连接 (AT+CIPMUX=0) 时 : AT+CIPSTART=<type>,<remote IP>,<remote port>[,<tcp keep alive>] TCP 多连接 (AT+CIPMUX=1) 时 : AT+CIPSTART=<link ID>,<type>,<remote IP>,<remote port>[,<tcp keep alive>] <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<TCP keep alive>]: 选填参数,TCP keep-alive 侦测时间, 默认关闭此功能, 建议 自 行行 设置开启此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为 1s Espressif! 27/96

35 5. TCP/IP 相关 AT // TCP 传输建 立后返回以下信息 : 提示信息 [<link ID>,] CONNECT // TCP 传输结束后返回以下信息 : [<link ID>,] CLOSED 注意 建议创建 TCP 连接时, 开启 keep-alive 功能 AT+CIPSTART="TCP","iot.espressif.cn",8000 AT+CIPSTART="TCP"," ",1000 详细请参考下 文第 9 章 AT 使 用 建 立 UDP 传输 设置 单连接模式 (AT+CIPMUX=0) 时 : AT+CIPSTART=<type>,<remote IP>,<remote port>[,<udp local port>,<udp mode>] 多连接模式 (AT+CIPMUX=1) 时 : AT+CIPSTART=<link ID>,<type>,<remote IP>,<remote port>[,<udp local port>,<udp mode>] <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<UDP local port>]: 选填参数,UDP 本地端 口 [<UDP mode>]: 选填参数,UDP 传输的属性, 若透传, 则必须为 0 0: 收到数据后, 不不更更改远端 目标, 默认值为 0 1: 收到数据后, 改变 一次远端 目标 2: 收到数据后, 改变远端 目标 注意 : 要使 用 <UDP mode> 需要先设置 <UDP local port> // UDP 传输建 立后返回以下信息 : 提示信息 [<link ID>,] CONNECT // UDP 传输结束后返回以下信息 : [<link ID>,] CLOSED AT+CIPSTART="UDP"," ",1000,1002,2 详细请参考第 9 章 AT 使 用 Espressif! 28/96

36 5. TCP/IP 相关 AT! 建 立 SSL 连接 设置 AT+CIPSTART=[<link ID>,]<type>,<remote IP>,<remote port>[,<tcp keep alive>] <link ID>: 网络连接 ID (0 ~ 4), 用于多连接的情况 <type>: 字符串串参数, 连接类型,"TCP","UDP" 或 "SSL" <remote IP>: 字符串串参数, 远端 IP 地址 <remote port>: 远端端 口号 [<TCP keep alive>]: 选填参数,TCP keep-alive 侦测时间, 默认关闭此功能, 建议 自 行行 设置开启此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为 1s // SSL 传输建 立后返回以下信息 : 提示信息 [<link ID>,] CONNECT // SSL 传输结束后返回以下信息 : [<link ID>,] CLOSED 注意 SSL 需要占 用较多空间, 如果空间不不 足, 会导致系统重启 建议创建 SSL 连接时, 开启 keep-alive 功能 AT+CIPSTART="SSL","iot.espressif.cn", AT+CIPSSLCCONF 配置 SSL Client * 1. 单连接时 :(AT+CIPMUX=0) AT+CIPSSLCCONF=<type>,<cert_key_ID>,<CA_ID> 设置 2. 多连接时 :(AT+CIPMUX=1) AT+CIPSSLCCONF=<link ID>,<type>,<cert_key_ID>,<CA_ID> 功能 : 配置 ESP32 作为 SSL client 时的认证 方式 Espressif! 29/96

37 5. TCP/IP 相关 AT [<link ID>]: 网络连接 ID 号 (0 ~ 4), 用于多连接的情况 ; 如果多连接时, 省略略此参数, 则设置对所有的 网络连接均 生效 <type>: 认证 方式 0: 不不进 行行认证 1: 加载 cert 和 private key, 以供 server 认证 2: 加载 CA, 认证 server 的 cert 和 private key 3: 双向认证,SSL client 和 server 互相认证对 方的证书 <cert_key_id>: 证书 ID, 从 0 开始计数 ESP32 AT 支持多套证书, 可参考 esp32-at/ tools/readme.md 中的 PKI Bin 一节 生成 bin 文件 <CA_ID>:CA ID, 从 0 开始计数 ESP32 AT 支持多套证书, 可参考 esp32-at/tools/ readme.md 中的 PKI Bin 一节 生成 bin 文件 注意 如需设置本, 请在建 立 SSL 连接之前调 用 本设置将保存到 flash NVS 区域 如果 AT+SAVETRANSLINK 设置为 SSL 透传, 那么开机透传时,SSL 连接将根据本配置进 行行连接 AT+CIPMUX=1 // enable multiple connections AT+CIPSSLCCONF=1,3,0,0 // to set the NO.1 link, loading certificates (with ID 0) for authentication AT+CIPSEND 发送数据 设置 : 1. 单连接时 :(AT+CIPMUX=0) AT+CIPSEND=<length> 2. 多连接时 :(AT+CIPMUX=1) AT+CIPSEND=<link ID>,<length> 3. 如果是 UDP 传输, 可以设置远端 IP 和端 口 : AT+CIPSEND=[<link ID>,]<length>[,<remote IP>,<remote port>] 功能 : 在普通传输模式时, 设置发送数据的 长度 执 行行 : AT+CIPSEND 功能 : 在透传模式时, 开始发送数据 Espressif! 30/96

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

39 5. TCP/IP 相关 AT! AT+CIPSENDEX 发送数据 设置 : 1. 单连接时 :(+CIPMUX=0) AT+CIPSENDEX=<length> 2. 多连接时 :(+CIPMUX=1) AT+CIPSENDEX=<link ID>,<length> 3. 如果是 UDP 传输, 可以设置远端 IP 和端 口 : AT+CIPSENDEX=[<link ID>,]<length>[,<remote IP>,<remote port>] 功能 : 在普通传输模式时, 设置发送数据的 长度 发送指定 长度的数据 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 length 或者遇到字符 \0 时, 发送数据 如果未建 立连接或连接被断开, 返回 : ERROR 如果数据发送成功, 返回 : SEND 如果数据发送失败, 返回 : SEND FAIL <link ID>: 网络连接 ID 号 (0 ~ 4), 用于多连接的情况 <length>: 数字参数, 表明发送数据的 长度, 最 大 长度为 2048 当接收数据 长度满 length 或者遇到字符 \0 时, 发送数据, 回到普通模式, 等待下 一条 AT 用户如需发送 \0, 请转义为 \\ AT+CIPCLOSE 关闭 TCP/UDP/SSL 传输 设置 ( 用于多连接的情况 ): AT+CIPCLOSE=<link ID> 功能 : 关闭 TCP/UDP 传输 执 行行 ( 用于单连接的情 况 ): AT+CIPCLOSE 提示信息 <link ID>: 需要关闭的连接 ID 号 当 ID 为 5 时, 关闭所有连接 // When connection ends, it will prompt message as below [<link ID>,] CLOSED Espressif! 32/96

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

41 5. TCP/IP 相关 AT AT+CIPSERVER 建 立 / 关闭 TCP 或 SSL 服务器器 * 查询 : AT+CIPSERVER? 功能 : 查询服务器器模式 +CIPSERVER:<mode>,<port>,<SSL>,<SSL CA enable> <mode>: 0: 关闭服务器器 1: 建 立服务器器 [<port>]: 选填参数 端 口号, 默认为 333 [<SSL>]: 字符串串 SSL, 用于建 立 SSL 服务器器 [<SSL CA enable>]: 0: 不不使 用 CA 认证 1: 使 用 CA 认证 设置 : AT+CIPSERVER=<mode>[,<port>] [,<SSL>,<SSL CA enable>] 功能 : 设置服务器器 多连接情况下 (AT+CIPMUX=1), 才能开启服务器器 注意 最多只允许创建 一个服务器器 创建服务器器后, 自动建 立服务器器监听 当有客户端接 入, 会 自动占 用 一个连接 ID // 建 立连接后返回以下信息 : 提示信 息 [<link ID>,] CONNECT // 连接结束后返回以下信息 : [<link ID>,] CLOSED 建 立 TCP 服务器器 : AT+CIPMUX=1 AT+CIPSERVER=1,80 建 立 SSL 服务器器 : AT+CIPMUX=1 AT+CIPSERVER=1,443,"SSL", AT+CIPSERVERMAXCONN 设置服务器器允许建 立的最 大连接数 * 查询 : AT+CIPSERVERMAXCONN? 功能 : 查询服务器器允许建 立的最 大连接数 设置 : AT+CIPSERVERMAXCONN=<num> 功能 : 设置服务器器允许建 立的最 大连接数 Espressif! 34/96

42 5. TCP/IP 相关 AT! +CIPSERVERMAXCONN:<num> 参数说 明 注意 <num>: 服务器器允许建 立的最 大连接数, 取值范围 :[1, 5] 如需设置最 大连接数, 请在创建服务器器之前设置 AT+CIPMUX=1 AT+CIPSERVERMAXCONN=2 AT+CIPSERVER=1, AT+CIPMODE 设置传输模式 查询 : AT+CIPMODE? 功能 : 查询传输模式 +CIPMODE:<mode> <mode>: 设置 : AT+CIPMODE=<mode> 功能 : 设置传输模式 0: 普通传输模式 1: 透传模式, 仅 支持 TCP/SSL 单连接和 UDP 固定通信对端的情况 本设置不不保存到 Flash 注意 透传模式传输时, 如果连接断开,ESP32 会不不停尝试重连, 此时单独输 入 +++ 退出透传, 则停 止重连 ; 普通传输模式则不不会重连, 提示连接断开 WiFi 透传与 BLE 功能 无法共存, 因此, 使能透传模式之前, 请关闭 BLE 功能 (AT+BLEINIT=0) AT+CIPMODE= AT+SAVETRANSLINK 保存透传到 Flash 保存透传 (TCP 单连接 ) 到 Flash 设置指 令 AT+SAVETRANSLINK=<mode>,<remote IP or domain name>,<remote port>[,<type>,<tcp keep alive>] Espressif! 35/96

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

44 5. TCP/IP 相关 AT! <mode>: 0: 取消开机透传 1: 保存开机进 入透传模式 参数说 明 <remote IP>: 远端 IP 或者域名 <remote port>: 远端端 口 [<type>]( 选填参数 ):SSL, 缺省默认为 TCP [<TCP keep alive>]( 选填参数 ):TCP keep-alive 侦测, 缺省默认关闭此功能 0: 关闭 TCP keep-alive 功能 1 ~ 7200: 侦测时间, 单位为秒 注意 本设置将透传模式及建 立的 SSL 连接均保存在 NVS 区, 下次上电 自动建 立 SSL 连接并进 入 透传 只要远端 IP, 端 口的值符合规范, 本设置就会被保存到 Flash AT+SAVETRANSLINK=1," ",443,"SSL" AT+CIPSTO 设置 TCP 服务器器超时时间 查询 : AT+CIPSTO? 功能 : 查询 TCP 服务器器超时时间 +CIPSTO:<time> 设置 : AT+CIPSTO=<time> 功能 : 设置 TCP 服务器器超时时间 <time>:tcp 服务器器超时时间, 取值范围 0 ~ 7200s 注意 ESP32 作为 TCP 服务器器, 会断开 一直不不通信直 至超时了了的 TCP 客户端连接 如果设置 AT+CIPSTO=0, 则永远不不会超时, 不不建议这样设置 AT+CIPMUX=1 AT+CIPSERVER=1,1001 AT+CIPSTO= AT+CIPSNTPCFG 设置时域和 SNTP 服务器器 查询 : AT+CIPSNTPCFG? +CIPSNTPCFG:<enable>,<timezone>,<SN TP server0>[,<sntp server1>,<sntp server2>] 设置 : AT+CIPSNTPCFG=<enable>[,<timezone>][,<SNTP server0>,<sntp server1>,<sntp server2>] Espressif! 37/96

45 5. TCP/IP 相关 AT <enable>: 0:SNTP 未使能 ; 1:SNTP 使能 <timezone>: 时域, 范围 :[-11,13]; 若 SNTP 使能, 此参数必填 ; 否则, 无需填写 ; <SNTP server0>: 第 一个 SNTP 服务器器, 可不不填 ; <SNTP server1>: 第 二个 SNTP 服务器器, 可不不填 ; <SNTP server2>: 第三个 SNTP 服务器器, 可不不填 说明 设置若未填写 SNTP server, 则默认使 用 "cn.ntp.org.cn","ntp.sjtu.edu.cn","us.pool.ntp.org" AT+CIPSNTPCFG=1,8,"cn.ntp.org.cn","ntp.sjtu.edu.cn","us.pool.ntp.org" AT+CIPSNTPTIME 查询 SNTP 时间 查询 AT+CIPSNTPTIME? +CIPSNTPTIME:SNTP 时间 - AT+CIPSNTPCFG=1,8,"cn.ntp.org.cn","ntp.sjtu.edu.cn" AT+CIPSNTPTIME? +CIPSNTPTIME:Mon Dec 12 02:33: AT+CIUPDATE 通过 Wi-Fi 升级软件 执 行行 : AT+CIUPDATE 功能 : 执 行行普通升级 +CIPUPDATE:<n> // 升级步骤提示说明如下 : 设置 : AT+CIUPDATE=<ota_mode>[,<version>] 功能 : 设置升级模式及升级版本 <n>: 1: 找到服务器器 2: 向服务器器查询版本信息 ; 如果指定版本升级, 则 无此步骤 3: 获得软件版本信息 ; 如果指定版本升级, 则 无此步骤 4: 开始升级 Espressif! 38/96

46 5. TCP/IP 相关 AT! none <ota_mode>: 0: 普通升级 1:SSL 升级 [<version>]: 选填参数, 可指定版本进 行行升级, 如未设置, 则升级默认版本 说明 升级过程由于 网络条件的好坏, 有快慢差异 升级失败会提示 ERROR, 请耐 心等待 若直接使 用乐鑫提供的 AT BIN (/esp-idf/bin/at), 本将从 Espressif Cloud 下载 AT 固件 升级 注意 若 用户 自 行行编译 AT 源代码, 则请 自 行行实现 AT+CIUPDATE 的升级功能, 乐鑫提供本地升级的 Demo 作为参考 (/esp-idf/example/at) 用户可以通过 menuconfig 配置采 用 SSL 升级, 详细请参考后 文章节 OTA 功能 建议升级 AT 固件后, 调 用 AT+RESTORE 恢复出 厂设置, 重新初始化 AT+CIPDINFO 接收 网络数据时是否提示对端 IP 和端 口 设置 AT+CIPDINFO=<mode> <mode>: 0: 不不显示对端 IP 和端 口 1: 显示对端 IP 和端 口 AT+CIPDINFO= IPD 接收 网络数据 单连接时 : (+CIPMUX=0)+IPD,<len>[,<remote IP>,<remote port>]:<data> 多连接时 : (+CIPMUX=1)+IPD,<link ID>,<len>[,<remote IP>,<remote port>]:<data> 此在普通模式下有效,ESP32 接收到 网络数据时向串串 口发送 +IPD 和数据 [<remote IP>]: 网络通信对端 IP, 由 AT+CIPDINFO=1 使能显示 [<remote port>]: 网络通信对端端 口, 由 AT+CIPDINFO=1 使能 <link ID>: 收到 网络连接的 ID 号 <len>: 数据 长度 <data>: 收到的数据 Espressif! 39/96

47 5. TCP/IP 相关 AT AT+PING Ping 功能 设置指 令 AT+PING=<IP> 功能 :ping 功能 +PING:<time> 或 +PING:TIMEOUT ERROR 参数说 明 <IP>: 字符串串参数,IP 地址 <time>:ping 时间 AT+PING=" " AT+PING=" Espressif! 40/96

48 6. BLE AT 6. BLE 相关 AT 6.1. BLE 一览表 AT+BLEINIT AT+BLEADDR AT+BLENAME AT+BLESCANPARAM AT+BLESCAN AT+BLESCANRSPDATA AT+BLEADVPARAM AT+BLEADVDATA AT+BLEADVSTART AT+BLEADVSTOP AT+BLECONN AT+BLECONNPARAM AT+BLEDISCONN AT+BLEDATALEN AT+BLECFGMTU AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSSRVSTOP AT+BLEGATTSSRV AT+BLEGATTSCHAR AT+BLEGATTSNTFY AT+BLEGATTSIND AT+BLEGATTSSETATTR AT+BLEGATTCPRIMSRV AT+BLEGATTCINCLSRV AT+BLEGATTCCHAR 描述 BLE 初始化设置 BLE 设备地址设置 BLE 设备名称设置 BLE 扫描参数使能 BLE 扫描设置 BLE 扫描设置 BLE 广播参数设置 BLE 广播数据开始 BLE 广播结束 BLE 广播建 立 BLE 连接更更新 BLE 连接参数断开 BLE 连接设置 BLE 数据包 长度设置 BLE MTU 的 长度 GATTS 创建服务 GATTS 开启服务 GATTS 关闭服务 GATTS 查询服务 GATTS 查询服务特征 GATTS 通知服务特征值 GATTS 指示服务特征值 GATTS 设置服务特征值 GATTC 发现基本服务 GATTC 发现包含服务 GATTC 查询服务特征 Espressif! 41/96

49 6. BLE AT! AT+BLEGATTCRD AT+BLEGATTCWR AT+BLESPPCFG AT+BLESPP AT+BLESECPARAM AT+BLEENC AT+BLEENCRSP AT+BLEKEYREPLY AT+BLECONFREPLY AT+BLEENCDEV AT+BLEENCCLEAR 描述 GATTC 读取服务特征值 GATTC 写服务特征值配置 BLE SPP 开启 BLE SPP 设置 BLE SMP 参数开始 BLE 配对设置 BLE 配对回复 BLE 配对密钥回复 BLE 配对结果列列举已配对的设备解除绑定 注意 : 下载 BLE SPEC( 当前 支持为 Core Version 4.2): adopted-specifications BLE 功能与 Wi-Fi 透传 无法共存, 因此, 开启 BLE 功能之前, 请确认 Wi-Fi 透传已关闭 (AT+CIPMODE=0) 6.2. BLE 描述 AT+BLEINIT BLE 初始化 查询 : AT+BLEINIT? 功能 : 查询 BLE 是否初始化 设置 : AT+BLEINIT=<init> 功能 : 设置 BLE 初始化 角 色 如果 BLE 未初始化, 则查询返回 : +BLEINIT:0 如果 BLE 已初始化, 则查询返回 : +BLEINIT:<role> Espressif! 42/96

50 6. BLE AT <init>: 0: 注销 BLE, 关闭 BLE RF * 1:client role 2:server role 使 用 BLE 相关 AT 前, 必须先调 用本条设置, 初始化 BLE 角 色 BLE 角 色初始化后, 不不能直接切换 如需切换 角 色, 需要调 用 AT+RST 重启, 或者 AT+BLEINIT=0 注销后, 重新初始化设置 注意 若使 用 ESP32 作为 server: 需烧录 at_customize.bin 和 service bin 详细信息可参考 ESP32_Customize_Partitions 如何 生成 service bin 文件, 请参考 esp32-at/tools/readme.md service bin 文件的烧录地址, 见 esp32-at/at_customize.csv 中 ble_data 对应的地址 AT+BLEINIT= AT+BLEADDR 设置 BLE 设备地址 查询 : AT+BLEADDR? 功能 : 查询 BLE 设备的 public address +BLEADDR:<BLE_public_addr> <addr_type>: 0:public address 1:random address 设置 : AT+BLEADDR=<addr_type>,<random_addr> 功能 : 设置 BLE 设备的地址 目前仅 支持设置 random address 注意 目前仅 支持查询 public address, 仅 支持设置 random address random address 要求最 高两个 bit 必须全 1, 详细可参考 BLE spec AT+BLEADDR=1,"f8:7f:24:87:1c:f7" AT+BLENAME 设置 BLE 设备名称 查询 : AT+BLENAME? 功能 : 查询 BLE 设备名称 +BLENAME:<device_name> <device_name>:ble 设备名称 设置 : AT+BLENAME=<device_name> 功能 : 设置 BLE 设备名称 Espressif! 43/96

51 6. BLE AT 默认设备名称为 BLE_AT 注意 本设置的设备名称, 需要在建 立 BLE 连接之后, 对端设备才能获取到, 它其实设置的是 GAP service 中 device name characteristic 的值, 详情请 见 BLE core v4.2 vol.3 part C 12.1 如果是需要在扫描 广播包时得到的设备名称, 则需要通过 AT+BLEADVDATA 设置 AT+BLENAME="esp_demo" AT+BLESCANPARAM 设置 BLE 扫描参数 查询 : AT+BLESCANPARAM? 功能 : 查询 BLE 设备的扫描参数 +BLESCANPARAM:<scan_type>,<own_addr_type >, <filter_policy>,<scan_interval>,<scan_wi ndow> <scan_type>: 扫描类型 0:passive scan 1:active scan <own_addr_type>: 地址类型 0:public address 1:random address 2:RPA public address 3:RPA random address <filter_policy>: 扫描过滤 方式 设置 : AT+BLESCANPARAM=<scan_type>,<own_addr_typ e>, <filter_policy>,<scan_interval>,<scan_win dow> 功能 : 设置 BLE 设备的扫描参数 0:BLE_SCAN_FILTER_ALLOW_ALL 1:BLE_SCAN_FILTER_ALLOW_ONLY_WLST 2:BLE_SCAN_FILTER_ALLOW_UND_RPA_DIR 3:BLE_SCAN_FILTER_ALLOW_WLIST_PRA_DIR <scan_interval>: 扫描间隔 <scan_window>: 扫描窗 口 注意 扫描窗 口的值不不能 大于扫描间隔 AT+BLEINIT=1 AT+BLESCANPARAM=0,0,0,100,50 Espressif! 44/96

52 6. BLE AT AT+BLESCAN 使能 BLE 扫描 设置 : AT+BLESCAN=<enable>[,<interval>] 功能 : 执 行行扫描 +BLESCAN:<addr>,<rssi>,<adv_data>,<scan_rsp_data>,<addr_type> <enable>: 0: 停 止扫描 1: 开始扫描 [<interval>]: 选填参数, 持续扫描时间, 单位 : 秒 若设置停 止扫描,<interval> 无需填写 ; 若设置开始扫描, - 若 <interval> 为 0 或缺省, 如 AT+BLESCAN=1,0 或 AT+BLESCAN=1 表示持续扫描 ; - 若 <interval> 不不为 0, 例例如 AT+BLESCAN=1,3 表示扫描 3 秒后 自动结束, 返回扫描结果 <addr>:ble 地址 <rssi>:ble 信号强度 <adv_data>:ble 广播数据 <scan_rsp_data>:ble 扫描 <addr_type>:ble 地址类型 0: public address 1: random address 2: RPA (Resolvable Private Address) public 3: RPA (Resolvable Private Address) random AT+BLEINIT=1 // 初始化为 client AT+BLESCAN=1 // 开始扫描 AT+BLESCAN=0 // 结束扫描 AT+BLESCANRSPDATA 设置 BLE 扫描 设置 : AT+BLESCANRSPDATA=<scan_rsp_data> 功能 : 设置 BLE 扫描 <scan_rsp_data>: 扫描 参数实际为 HEX 字串串 例例如, 设置扫描为 0x11 0x22 0x33 0x44 0x55, 则设置为 :AT+BLESCANRSPDATA=" " Espressif! 45/96

53 6. BLE AT 注意 扫描 支持的最 大 长度为 31 字节 AT+BLEINIT=2 // 初始化为 server AT+BLESCANRSPDATA=" " AT+BLEADVPARAM 设置 广播参数 查询 : AT+BLEADVPARAM? 功能 : 查询 广播参数 +BLEADVPARAM:<adv_int_min>,<adv_int_max>,<adv_type>,<own_addr_type>,<channel_map >,<adv_filter_policy>,<peer_addr_type>,< peer_addr> 设置 : AT+BLEADVPARAM=<adv_int_min>,<adv_int_max >, <adv_type>,<own_addr_type>,<channel_map> [,<adv_filter_policy>,<peer_addr_type>,<p eer_addr>] 功能 : 设置 广播参数 <adv_int_min>: 最 小 广播间隔, 取值范围 :0x0020 ~ 0x4000 <adv_int_max>: 最 大 广播间隔, 取值范围 :0x0020 ~ 0x4000 <adv_type>: 广播类型 0:ADV_TYPE_IND 1: ADV_TYPE_DIRECT_IND_HIGH 2:ADV_TYPE_SCAN_IND 3:ADV_TYPE_NONCONN_IND <own_addr_type>:ble 地址类型 0:BLE_ADDR_TYPE_PUBLIC 1:BLE_ADDR_TYPE_RANDOM <channel_map>: 广播信道 1:ADV_CHNL_37 2:ADV_CHNL_38 4:ADV_CHNL_39 7:ADV_CHNL_ALL [<adv_filter_policy>]( 选填参数 ): 过滤器器规则 0:ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY 1:ADV_FILTER_ALLOW_SCAN_WLST_CON_ANY 2:ADV_FILTER_ALLOW_SCAN_ANY_CON_WLST 3:ADV_FILTER_ALLOW_SCAN_WLST_CON_WLST [<peer_addr_type>]( 选填参数 ): 对 方 BLE 地址类型 0:PUBLIC 1:RANDOM [<peer_addr>]( 选填参数 ): 对 方 BLE 地址 Espressif! 46/96

54 6. BLE AT 注意 <adv_filter_policy>,<peer_addr_type>,<peer_addr> 三个参数要求同时缺省, 或者同时设置 AT+BLEINIT=2 // 初始化为 server AT+BLEADVPARAM=50,50,0,0,4,0,0,"12:34:45:78:66:88" AT+BLEADVDATA 设置 BLE 广播数据 设置 : AT+BLEADVDATA=<adv_data> 功能 : 设置 BLE 广播数据 注意 <adv_data>: 广播数据包 参数实际为 HEX 字串串 例例如, 设置 广播数据为 0x11 0x22 0x33 0x44 0x55, 则设置为 :AT+BLEADVDATA=" " 广播包最 大 长度为 31 字节 AT+BLEINIT=2 // 初始化为 server AT+BLEADVDATA=" " AT+BLEADVSTART 开始 BLE 广播 执 行行 : AT+BLEADVSTART 功能 : 开始 BLE 广播 注意 无 若未设置 广播参数 (AT+BLEADVPARAM=<adv_parameter>), 则使 用默认 广播参数 ; 若未设置 广播数据 (AT+BLEADVDATA=<adv_data>), 则发送全 0 数据包 AT+BLEINIT=2 // 初始化为 server AT+BLEADVSTART AT+BLEADVSTOP 结束 BLE 广播 执 行行 : AT+BLEADVSTOP 功能 : 结束 BLE 广播 Espressif! 47/96

55 6. BLE AT 注意 无若开始 广播后, 成功建 立 BLE 连接, 则会 自动结束 BLE 广播, 无需调 用本 AT+BLEINIT=2 // 初始化为 server AT+BLEADVSTART AT+BLEADVSTOP AT+BLECONN 建 立 BLE 连接 查询 : AT+BLECONN? 功能 : 查询 BLE 连接 +BLECONN:<conn_index>,<remote_address> 若未建 立连接, 则不不显示 <conn_index> 和 <remote_address> 设置 : AT+BLECONN=<conn_index>,<remote_address >[,<addr_type>] 功能 : 建 立 BLE 连接 若连接成功建 立, 则提示 +BLECONN:<conn_index>,<remote_address> <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接, 后续将增加 支持多连接 <remote address>: 对 方 BLE 设备地址 <addr_type>: 选填参数,BLE 地址类型, 默认是 public address 类型 0: public address 1: random address 2: RPA (Resolvable Private Address) public 3: RPA (Resolvable Private Address) random AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:0a:c4:09:34:23" AT+BLECONNPARAM 更更新 BLE 连接参数 查询 : AT+BLECONNPARAM? 功能 : 查询 BLE 连接参数 +BLECONNPARAM:<conn_index>,<min_interval>,<max_interval>,<cur_interval>,<latency>, <timeout> 设置 : AT+BLECONNPARAM=<conn_index>,<min_interv al>,<max_interval>,<latency>,<timeout> 功能 : 更更新 BLE 连接参数 // 已接收, 将尝试更更新连接参数 如果更更新失败, 将提示 +BLECONNPARAM:<conn_index>,-1 Espressif! 48/96

56 6. BLE AT <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <min_interval>: 最 小连接间隔, 取值范围 :0x0006 ~ 0x0C80 <max_interval>: 最 大连接间隔, 取值范围 :0x0006 ~ 0x0C80 <cur_interval>: 当前连接间隔 <latency>: 时延, 取值范围 :0x0000 ~ 0x01F3 <timeout>: 超时, 取值范围 :0x000A ~ 0x0C80 注意 本要求先建 立连接, 并且仅 支持 BLE client 更更新连接参数 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:0a:c4:09:34:23" // 建 立 BLE 连接 AT+BLECONNPARAM=0,12,14,1,500 // 更更新 BLE 连接参数 AT+BLEDISCONN 断开 BLE 连接 设置 : AT+BLEDISCONN=<conn_index> 功能 : 断开 BLE 连接 +BLEDISCONN:<conn_index>,<remote_address> <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <remote_address>: 对 方 BLE 设备地址 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:0a:c4:09:34:23" // 建 立 BLE 连接 AT+BLEDISCONN=0 // 断开 BLE 连接 AT+BLEDATALEN 设置 BLE 数据包 长度 设置 : AT+BLEDATALEN=<conn_index>,<pkt_data_len> 功能 : 设置 BLE 数据包 长度 注意 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <pkt_data_len> : 数据包 长度, 取值范围 :0x001b ~ 0x00fb 需要先建 立 BLE 连接, 才能设置数据包 长度 Espressif! 49/96

57 6. BLE AT AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:0a:c4:09:34:23" AT+BLEDATALEN=0, AT+BLECFGMTU 设置 GATT MTU 的 长度 设置 : AT+BLECFGMTU? 功能 : 查询 GATT (Generic Attribute Profile) MTU 的 长度 +BLECFGMTU:<conn_index>,<mtu_size> 设置 : AT+BLECFGMTU=<conn_index>,<mtu_size> 功能 : 设置 GATT MTU 的 长度 // 已接收 注意 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <mtu_size> :BLE 最 大传输单元的 长度 仅 BLE client 支持设置 GATT MTU 长度, 并且需要先建 立 BLE 连接, 才能设置 MTU 长度 最终实际的 MTU 长度需经过协商, 设置返回 仅表示尝试协商 MTU, 因此, 设置 长度不不 一定 生效, 建议设置后, 使 用查询 AT+BLECFGMTU? 查询实际的 MTU 长度 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLECFGMTU=0, AT+BLEGATTSSRVCRE GATTS 创建服务 执 行行 : AT+BLEGATTSSRVCRE 功能 :GATTS 创建服务 无 使 用 ESP32 作为 server 创建服务, 要求烧录 service bin 文件到 Flash 中 注意 如何 生成 service bin 文件, 请参考 esp32-at/tools/readme.md service bin 文件的烧录地址, 见 esp32-at/at_customize.csv 中 ble_data 对应的地址 ESP32 作为 server 应该在初始化完成后, 及时创建服务 BLE 连接建 立后, 无法创建服务 AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE Espressif! 50/96

58 6. BLE AT AT+BLEGATTSSRVSTART GATTS 开启服务 执 行行 : AT+BLEGATTSSRVSTART 功能 :GATTS 开启全部服务 设置 : AT+BLEGATTSSRVSTART=<srv_index> 功能 :GATTS 开启某指定服务 无 <srv_index>: 服务序号, 从 1 起始递增 AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSSRVSTOP GATTS 停 止服务 执 行行 : AT+BLEGATTSSRVSTOP 功能 :GATTS 停 止全部服务 设置 : AT+BLEGATTSSRVSTOP=<srv_index> 功能 :GATTS 停 止某指定服务 无 <srv_index>: 服务序号, 从 1 起始递增 AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSSRVSTOP AT+BLEGATTSSRV GATTS 发现服务 查询 : AT+BLEGATTSSRV? 功能 :GATTS 发现服务 +BLEGATTSSRV:<srv_index>,<start>,<srv_uuid>,<srv_type> Espressif! 51/96

59 6. BLE AT <srv_index> : 服务序号, 从 1 起始递增 <start> : 0: 服务未开始 1: 服务已开始 <srv_uuid> : 服务的 UUID <srv_type> : 服务的类型 0: 次要服务 1: 首要服务 AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRV? AT+BLEGATTSCHAR GATTS 发现服务特征 查询 : AT+BLEGATTSCHAR? 功能 :GATTS 发现服务特征 // 对于服务特征信息, 显示如下 : +BLEGATTSCHAR:"char",<srv_index>,<char_index>,<char_uuid>,<char_prop> // 对于描述符信息, 显示如下 : +BLEGATTSCHAR:"desc",<srv_index>,<char_index>,<desc_index> <srv_index> : 服务序号, 从 1 起始递增 <char_index> : 服务特征的序号, 从 1 起始递增 <char_uuid> : 服务特征的 UUID <char_prop> : 服务特征的属性 <desc_index> : 特征描述符序号 <desc_uuid> : 特征描述符的 UUID AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSCHAR? Espressif! 52/96

60 6. BLE AT AT+BLEGATTSNTFY GATTS 通知服务特征值 设置 : AT+BLEGATTSNTFY=<conn_index>,<srv_index>,<char_index>,<length> 功能 :GATTS 通知服务特征值 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 <length> 时, 执 行行通知操 作 若通知操作成功, 则提示 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务序号, 由 AT+BLEGATTSCHAR? 查询可得 <char_index> : 服务特征的序号, 由 AT+BLEGATTSCHAR? 查询可得 <length> : 数据 长度以下为 notify 的简单, 详细步骤可参看后 文章节 9.5 BLE AT AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEADVSTART // 开始 广播, 等待 client 连接, 并配置接收 notify AT+BLEGATTSCHAR? // 查询允许 notify 的特征 // 例例如, 使 用 3 号服务的 6 号特征通知 长度为 4 的数据 AT+BLEGATTSNTFY=0,3,6,4 // 提示 > 符号后, 输 入 4 字节数据即可, 例例如 "1234" AT+BLEGATTSIND GATTS 指示服务特征值 设置 : AT+BLEGATTSIND=<conn_index>,<srv_index>,<char_index>,<length> 功能 :GATTS 指示服务特征值 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 <length> 时, 执 行行指示操 作 若指示操作成功, 则提示 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务序号, 由 AT+BLEGATTSCHAR? 查询可得 <char_index> : 服务特征的序号, 由 AT+BLEGATTSCHAR? 查询可得 <length> : 数据 长度 Espressif! 53/96

61 6. BLE AT 以下为 indicate 的简单, 详细步骤可参看后 文章节 9.5 BLE AT AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEADVSTART // 开始 广播, 等待 client 连接, client 端连接后, 应该设置为接收 indication AT+BLEGATTSCHAR? // 查询允许 indicate 的特征 // 例例如, 使 用 3 号服务的 7 号特征指示 长度为 4 的数据 AT+BLEGATTSIND=0,3,7,4 // 提示 > 符号后, 输 入 4 字节数据即可, 例例如 "1234" AT+BLEGATTSSETATTR GATTS 设置服务特征值 设置 : AT+BLEGATTSSETATTR=<srv_index>,<char_index>[,<desc_index>],<length> 功能 :GATTS 设置服务特征 ( 描述符 ) 值 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 <length> 时, 执 行行设置操 作 若设置操作成功, 则提示 <srv_index> : 服务发现结果序号, 由 AT+BLEGATTSCHAR? 查询结果中获得 <char_index> : 服务特征的序号, 由 AT+BLEGATTSCHAR? 查询结果中获得 [<desc_index>]( 选填参数 ): 特征描述符序号 若填写, 则设置描述符的值 ; 若未填写, 则设 置特征值 <length> : 数据 长度 注意 <length> 不不能超过该特征 ( 描述符 ) 支持的最 大 长度 例例如, 该服务特征值为 0x30 0x31, 最 大 长度为 2, 如果设置 <lengh> 为 3 超过最 大 长度, 则会报错 AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSCHAR? // 例例如, 向 1 号服务的 1 号特征写 入 长度为 4 的数据 AT+BLEGATTSSETATTR=1,1,,4 // 提示 > 符号后, 输 入 4 字节数据即可, 例例如 "1234" Espressif! 54/96

62 6. BLE AT AT+BLEGATTCPRIMSRV GATTC 发现基本服务 设置 : AT+BLEGATTCPRIMSRV=<conn_index> 功能 :GATTC 发现基本服务 +BLEGATTCPRIMSRV:<conn_index>,<srv_index>,<srv_uuid>,<srv_type> <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务发现结果序号, 从 1 起始递增 <srv_uuid> : 服务的 UUID <srv_type> : 服务的类型 0: 次要服务 1: 首要服务 注意 使 用本, 需要先建 立 BLE 连接 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLEGATTCPRIMSRV= AT+BLEGATTCINCLSRV GATTC 发现包含服务 设置 : AT+BLEGATTCINCLSRV=<conn_index>,<srv_index> 功能 :GATTC 发现包含服务 +BLEGATTCINCLSRV:<conn_index>,<srv_index>,<srv_uuid>,<srv_type>,<included_srv_uuid>,<included_srv_type> Espressif! 55/96

63 6. BLE AT <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务发现结果序号, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得 <srv_uuid> : 服务的 UUID <srv_type> : 服务的类型 0: 次要服务 1: 首要服务 <included_srv_uuid> : 包含服务的 UUID <included_srv_type> : 包含服务的类型 0: 次要服务 1: 首要服务 注意 使 用本, 需要先建 立 BLE 连接 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLEGATTCPRIMSRV=0 AT+BLEGATTCINCLSRV=0,1 // 根据前 一条的查询结果, 指定 index 查询 AT+BLEGATTCCHAR GATTC 发现服务特征 设置 : AT+BLEGATTCCHAR=<conn_index>,<srv_index> 功能 :GATTC 发现服务特征 // 对于服务特征信息, 显示如下 : +BLEGATTCCHAR:"char",<conn_index>,<srv_index>,<char_index>,<char_uuid>,<char_prop> // 对于描述符信息, 显示如下 : +BLEGATTCCHAR:"desc",<conn_index>, <srv_index>,<char_index>,<desc_index>,<desc_uuid> <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务发现结果序号, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得 <char_index> : 服务特征的序号, 从 1 起始递增 <char_uuid> : 服务特征的 UUID <char_prop> : 服务特征的属性 <desc_index> : 特征描述符序号 <desc_uuid> : 特征描述符的 UUID Espressif! 56/96

64 6. BLE AT 注意 使 用本, 需要先建 立 BLE 连接 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLEGATTCPRIMSRV=0 AT+BLEGATTCCHAR=0,1 // 根据前 一条的查询结果, 指定 index 查询 AT+BLEGATTCRD GATTC 读取服务特征值 设置 : AT+BLEGATTCRD=<conn_index>,<srv_index>,<char_index>[,<desc_index>] 功能 :GATTC 读取服务特征 ( 描述符 ) 值 +BLEGATTCRD:<conn_index>,<len>,<value> <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务发现结果序号, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得 <char_index> : 服务特征的序号, 由 AT+BLEGATTCCHAR=<conn_index>,<srv_index> 查询结果中获得 [<desc_index>]( 选填参数 ): 特征描述符序号 若不不设置, 读取特征值 ; 若设置, 读取描述符的值 <len> : 数据 长度 <value> :HEX 字串串 若由 AT+BLEGATTCRD=<conn_index>,<srv_index>,<char_index> 读取服务特征的值, 例例如读取返回 "+BLEGATTCRD:0,1,30" 表示特征值 长度为 1 个字节, 内容为 HEX 字串串 "0x30" 若由 AT+BLEGATTCRD=<conn_index>,<srv_index>,<char_index>,<desc_index> 读取服务特征描述符的值, 例例如读取返回 +BLEGATTCRD:0,4, 表示特征描述符的值 长度为 4 个字节, 内容为 HEX 字串串 0x30 0x31 0x32 0x33 注意 使 用本, 需要先建 立 BLE 连接 如果该服务特征属性不不 支持读操作, 则会报错 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLEGATTCPRIMSRV=0 AT+BLEGATTCCHAR=0,3 // 根据前 一条的查询结果, 指定 index 查询 AT+BLEGATTCRD=0,3,2,1 // 例例如, 读取第 3 号服务的第 2 号特征的第 1 号描述符信息 Espressif! 57/96

65 6. BLE AT AT+BLEGATTCWR GATTC 写服务特征值 设置 : AT+BLEGATTCWR=<conn_index>,<srv_index>,<char_index>[,<desc_index>],<length> 功能 :GATTC 写服务特征 ( 描述符 ) 值 收到此命令后先换 行行返回 >, 然后开始接收串串 口数据, 当数据 长度满 <length> 时, 执 行行写操 作 若写操作成功, 则提示 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <srv_index> : 服务发现结果序号, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得 <char_index> : 服务特征的序号, 由 AT+BLEGATTCCHAR=<conn_index>,<srv_index> 查询结果 中获得 [<desc_index>]( 选填参数 ): 特征描述符序号 若不不设置, 则写特征值 ; 若设置, 写描述符的 值 <length> : 数据 长度 注意 使 用本, 需要先建 立 BLE 连接 如果该服务特征 ( 描述符 ) 属性不不 支持写操作, 则会报错 AT+BLEINIT=1 // 初始化为 client AT+BLECONN=0,"24:12:5f:9d:91:98" // 建 立 BLE 连接 AT+BLEGATTCPRIMSRV=0 AT+BLEGATTCCHAR=0,3 // 根据前 一条的查询结果, 指定 index 查询 // 例例如, 向第 3 号服务的第 4 号特征, 写 入 长度为 6 的数据 AT+BLEGATTCWR=0,3,4,,6 // 提示 > 后, 通过串串 口输 入数据 "123456" 即可 AT+BLESPPCFG 配置 BLE 透传模式 设置 AT+BLESPPCFG=<cfg_enable>,<tx_srv_index>,<tx_char_index>,<rx_srv_index>,<rx_srv_ind ex> 功能 : 配置 BLE 透传模式 分别选择两个 characteristic, 一个 用于发送数据, 一个 用于接收数 据, 作为数据通信的收发通道 Espressif! 58/96

66 6. BLE AT <cfg_enable>: 0: 清除 BLE SPP 设置参数 ; 之后的四个参数 无需填写 1: 设置 BLE SPP 参数 ; 之后的四个参数必须填写 <tx_srv_index>: 服务序号, 指定 用于发送数据的 characteristic 所在的 service 的序号 如果 ESP 作为 BLE server, 由 AT+BLEGATTSSRVCRE 查询结果中获得, 是本地的 service ID; 如果 ESP 作为 BLE client, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得, 是远端的 service ID <tx_char_index>: 服务 characteristic 的序号, 指定 用于发送数据的 characteristic 的序号 如果 ESP 作为 BLE server, 由 AT+BLEGATTSCHAR 查询结果中获得, 是本地的 characteristic ID; 要求此 characteristic 支持 notify 或者 indicate; 如果 ESP 作为 BLE client, 由 AT+BLEGATTCCHAR=<conn_index>,<srv_index> 查询结果中获得, 是远端的 characteristic ID; 要求此 characteristic 支持 write <rx_srv_index>: 服务序号, 指定 用于接收数据的 characteristic 所在的 service 的序号 如果 ESP 作为 BLE server, 由 AT+BLEGATTSSRVCRE 查询结果中获得, 是本地的 service ID; 如果 ESP 作为 BLE client, 由 AT+BLEGATTCPRIMSRV=<conn_index> 查询结果中获得, 是远端的 service ID <rx_char_index>: 服务特征的序号, 指定 用于接收数据的 characteristic 的序号 ; 如果 ESP 作为 BLE server, 由 AT+BLEGATTSCHAR 查询结果中获得, 是本地的 characteristic ID; 要求此 characteristic 支持 write; 如果 ESP 作为 BLE client, 由 A AT+BLEGATTCCHAR=<conn_index>,<srv_index> 查询结果中获得, 是远端的 characteristic ID; 要求此 characteristic 支持 notify 或者 indicate 本在初始化 BLE 之后即可配置 注意 本可以重复调 用, 以最后 一次的配置为准 如果 characteristic 不不 支持读操作, 则会返回 ERROR" 本设置不不保存到 flash, 在系统重启 或关闭 BLE 功能之后将被清空 Espressif! 59/96

67 6. BLE AT AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSCHAR? AT+BLEADVSTART // 开始 广播 // client 连 入,BLE 连接建 立, 将提示 +BLECONN:0,<client MAC> // 例例如, 设置第 1 号服务的第 7 号 characteristic 为写通道, 设置第 1 号服务的第 5 号 characteristic 为读通道 AT+BLESPPCFG=1,1,7,1,5 // client 端需要设置为侦听写通道 ( 例例如, 上述第 7 号 characteristic), 允许 notify 或者 indicate AT+BLESPP 开启 BLE 透传模式 执 行行 AT+BLESPP 功能 : 开启 BLE 透传模式 > // 等待输 入数据 执 行行后换 行行返回 > 符号,ESP32 进 入 UART-BLE 透传模式 当输 入单独 一包 +++ 时,ESP3 2 返回普通 AT 模式 发送 +++ 退出透传时, 请 至少间隔 1 秒再发下 一条 AT 开启透传时, 会检查 AT+BLESPPCFG 的配置 ; 如果未配置 配置清空或者配置 无效 ( 例例如, characteristic 的属性不不符合要求 ), 则返回 ERROR 注意 如果 Wi-Fi 透传已开启, 则返回 ERROR 如果 BLE 处于未连接或者多连接的状态, 则返回 ERROR 如果 BLE 正在 广播 ( 除了了不不可连接的 广播 ADV_TYPE_NONCONN_IND), 则返回 ERROR 如果在透传模式下,BLE 连接断开,ESP 将 一直尝试重建原连接 Espressif! 60/96

68 6. BLE AT AT+BLEINIT=2 // 初始化为 server AT+BLEGATTSSRVCRE AT+BLEGATTSSRVSTART AT+BLEGATTSCHAR? AT+BLEADVSTART // 开始 广播 // client 连 入,BLE 连接建 立, 将提示 +BLECONN:0,<client MAC> // 例例如, 设置第 1 号服务的第 7 号 characteristic 为写通道, 设置第 1 号服务的第 5 号 characteristic 为读通道 AT+BLESPPCFG=1,1,7,1,5 // client 端需要设置为侦听写通道 ( 例例如, 上述第 7 号 characteristic), 允许 notify 或者 indicate AT+BLESPP // 开启透传 AT+BLESECPARAM 设置加密参数 查询 : AT+BLESECPARAM? 功能 : 查询 BLE SMP 加密参数 +BLESECPARAM:<auth_req>,<iocap>,<key_siz e>,<init_key>,<rsp_key> 设置 : AT+BLESECPARAM=<auth_req>,<iocap>,<key_s ize>,<init_key>,<rsp_key> 功能 : 设置 BLE SMP 加密参数 Espressif! 61/96

69 6. BLE AT <auth_req>: 认证要求 0: ESP_LE_AUTH_NO_BOND 1: ESP_LE_AUTH_BOND 2: ESP_LE_AUTH_REQ_MITM 4: ESP_LE_AUTH_REQ_SC_ONLY 5: ESP_LE_AUTH_REQ_SC_BOND 6: ESP_LE_AUTH_REQ_SC_MITM 7: ESP_LE_AUTH_REQ_SC_MITM_BOND <iocap>: 输 入输出能 力力 0: ESP_IO_CAP_OUT /*!< DisplayOnly */ 1: ESP_IO_CAP_IO /*!< DisplayYesNo */ 2: ESP_IO_CAP_IN /*!< KeyboardOnly */ 3: ESP_IO_CAP_NONE /*!< NoInputNoOutput */ 4: ESP_IO_CAP_KBDISP /*!< Keyboard display */ <key_size>: 密钥 长度, 取值范围 : [7, 16] <init_key>: 初始密钥 若 bit0 为 1, 表示 ESP_BLE_ENC_KEY_MASK // to exchange the encryption key 若 bit1 为 1, 表示 ESP_BLE_ID_KEY_MASK // to exchange the IRK key 若 bit2 为 1, 表示 ESP_BLE_CSR_KEY_MASK // to exchange the CSRK key 若 bit3 为 1, 表示 ESP_BLE_LINK_KEY_MASK // to exchange the link key(this key just used in the BLE & BR/EDR coexist mode) <rsp_key> : 密钥 若 bit0 为 1, 表示 ESP_BLE_ENC_KEY_MASK // to exchange the encryption key 若 bit1 为 1, 表示 ESP_BLE_ID_KEY_MASK // to exchange the IRK key 若 bit2 为 1, 表示 ESP_BLE_CSR_KEY_MASK // to exchange the CSRK key 若 bit3 为 1, 表示 ESP_BLE_LINK_KEY_MASK // to exchange the link key(this key just used in the BLE & BR/EDR coexist mode) 注意 本要求在 BLE 连接建 立之前调 用 AT+BLESECPARAM=1,4,16,3, AT+BLEENC 发起加密请求 设置 : AT+BLEENC=<conn_index>,<sec_act> 功能 : 发起 BLE SMP 加密请求 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <sec_act>: 0: ESP_BLE_SEC_NONE 1: ESP_BLE_SEC_ENCRYPT 2: ESP_BLE_SEC_ENCRYPT_NO_MITM 3: ESP_BLE_SEC_ENCRYPT_MITM Espressif! 62/96

70 6. BLE AT AT+BLESECPARAM=1,4,16,3,3 AT+BLEENC=0, AT+BLEENCRSP 回复加密请求 设置 : AT+BLEENCRSP=<conn_index>,<accept> 功能 : 回复 BLE SMP 加密请求 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <accept>: 0: reject 1: accept AT+BLEENCRSP=0, AT+BLEKEYREPLY 回复加密密钥 设置 : AT+BLEKEYREPLY=<conn_index>,<key> 功能 : 回复 BLE SMP 配对密钥 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <key>: 配对密钥 // 假设对 方要求输 入密钥 进 行行配对 AT+BLESETKEYREPLY=0, AT+BLECONFREPLY 回复确认结果 设置 : AT+BLECONFREPLY=<conn_index>,<confirm> 功能 : 回复配对确认结果 用于不不 支持回复加密密钥的情况 <conn_index>:ble 连接号, 当前只 支持 index 为 0 的单连接 <confirm>: 0: No 1: Yes Espressif! 63/96

71 6. BLE AT // 回复对 方确认配对 AT+BLECONFREPLY=0, AT+BLEENCDEV 查询已绑定的设备 查询 : AT+BLEENCDEV? +BLEENCDEV:<enc_dev_index>,<mac_address> <enc_dev_index>:ble 已绑定设备的连接号, 当前只 支持 index 为 0 的单连接 <mac_address>: 已绑定设备的 MAC 地址 AT+BLEENCDEV? AT+BLEENCCLEAR 解除绑定 设置 : AT+BLEENCCLEAR=<enc_dev_index> 功能 : 解除某特定连接的绑定关系 执 行行 : AT+BLEENCCLEAR 功能 : 解除所有绑定关系 <enc_dev_index>:ble 已绑定设备的连接号, 当前只 支持 index 为 0 的单连接 AT+BLEENCCLEAR Espressif! 64/96

72 7. 设置保存在 NVS 区域 AT 列列表 7. 设置保存在 NVS 区域 AT 列列表 AT+UART AT+UART_DEF AT+CWDHCP AT+CIPSTAMAC AT+CIPAPMAC AT+CIPSTA AT+CIPAP AT+CWDHCPS AT+SAVETRANSLINK AT+CWMODE AT+CWJAP AT+CWSAP AT+CWAUTOCONN AT+CIPSSLCCONF 描述 AT+UART=115200,8,1,0,3 AT+UART_DEF=115200,8,1,0,3 AT+CWDHCP=1,1 AT+CIPSTAMAC="18:fe:35:98:d3:7b" AT+CIPAPMAC="1a:fe:36:97:d5:7b" AT+CIPSTA=" " AT+CIPAP=" " AT+CWDHCPS=1,3," "," " AT+SAVETRANSLINK=1," ",1001 AT+CWMODE=3 AT+CWJAP="abc"," " AT+CWSAP="ESP32"," ",5,3 AT+CWAUTOCONN=1 AT+CIPSSLCCONF=1,3,0,0 注意 : NVS 参数区为 0xFA000 ~ 0x110000,88 KB Espressif! 65/96

73 8. 提示消息列列表 8. 提示消息列列表 ESP32 AT 中的提示信息说明如下 : 提示信息 ready ERROR WIFI CONNECTED WIFI GOT IP WIFI DISCONNECT busy p... <conn_id>,connect <conn_id>,closed +IPD +STA_CONNECTED:<sta_mac> +DIST_STA_IP:<sta_mac>,<sta_ip> +STA_DISCONNECTED:<sta_mac> +BLECONN +BLEDISCONN +READ +WRITE +NOTIFY +INDICATE +BLESECNTFYKEY +BLEAUTHCMPL 说明 AT 固件成功启动输 入错误, 或者执 行行出错 ESP station 连接到 AP ESP station 获取到 IP 地址 ESP station 的 WiFi 连接断开 busy processing, 表示系统正在处理理前 一条, 无法当前输 入建 立了了 <conn_id> 号 网络连接 <conn_id> 号 网络连接断开接收到 网络数据有 station 连 入 ESP softap ESP softap 给连 入的 station 分配 IP 地址 station 从 ESP softap 断开连接 BLE 建 立连接 BLE 断开连接 BLE 接收到读操作 BLE 接收到写操作 BLE 接收到通知操作 BLE 接收到指示操作 BLE SMP 密钥 BLE SMP 配对完成 Espressif! 66/96

74 9. AT 使 用! 9. AT 使 用 本章介绍 几种常 见的 AT 使 用 9.1. 单连接 TCP 客户端 1. 设置 Wi-Fi 模式 : AT+CWMODE=3 // SoftAP+Station mode : 2. 连接路路由 : AT+CWJAP="SSID","password" // SSID and password of router : 3. 查询设备 IP 地址 : AT+CIFSR : // device got an IP from router 4. PC 与 ESP32 连接同 一个路路由, 在 PC 上使 用 网络调试 工具, 创建 一个 TCP 服务器器 - 例例如, 假设 TCP 服务器器的 IP 为 , 端 口为 ESP32 作为客户端连接到 TCP 服务器器 : AT+CIPSTART="TCP"," ",8080 // protocol server IP & port 6. 发送数据 : AT+CIPSEND=4 >TEST // set date, such as 4 bytes // enter the data, no CR : SEND 注意 : 若输 入的字节数 目超过了了设定的 长度 (n), 则会 busy, 并发送数据的前 n 个字节, 发送完成后 SEND Espressif! 67/96

75 9. AT 使 用 7. 接收数据 : +IPD,n:xxxxxxxxxx // received n bytes, data=xxxxxxxxxxx 9.2. UDP 传输 UDP 传输不不区分服务器器或者客户端, 由 AT+CIPSTART 建 立传输关系 1. 设置 Wi-Fi 模式 : AT+CWMODE=3 // SoftAP+Station mode : 2. 连接路路由 : AT+CWJAP="SSID","password" // SSID and password of router : 3. 查询设备 IP 地址 : AT+CIFSR : +CIFSR:STAIP," " // IP address of ESP32 Station 4. PC 与 ESP32 连接同 一个路路由, 在 PC 上使 用 网络调试 工具, 创建 UDP 传输 - 例例如, 假设 UDP 的 IP 地址为 , 端 口为 8080 下 面介绍两种 UDP 通信的 : 固定远端的 UDP 通信 UDP 通信的远端固定, 由 AT+CIPSTART 的最后参数 0 决定, 分配 一个连接号给这个固定连接, 在通信过程中远端信息不不会被改变 1. 使能多连接 : AT+CIPMUX=1 : 2. 创建 UDP 传输, 例例如, 分配连接 ID 为 4 AT+CIPSTART=4,"UDP"," ",8080,1112,0 Espressif! 68/96

76 9. AT 使 用! : 4,CONNECT 说明 : " ",8080 为 UDP 传输的远端 IP 和远端端 口, 也就是 PC 建 立的 UDP 配置 1112 为 ESP32 的 UDP 本地端 口, 用户可 自 行行设置, 如不不设置则为随机值 0 表示当前 UDP 传输建 立后,UDP 远端不不会被其他设备更更改 ; 即使有其他设备通过 UDP 协议发数据到 ESP32 UDP 端 口 1112,ESP32 4 号 UDP 传输的远端也不不会被替换, 使 用 AT+CIPSEND=4,X 发送数据, 仍然是当前确定的 PC 端收到 3. 发送数据 : AT+CIPSEND=4,7 >UDPtest // send 7 bytes to transmission NO.4 // enter the data, no CR : SEND 注意 : 若输 入的字节数 目超过了了设定的 长度 (n), 则会 busy, 并发送数据的前 n 个字节, 发送完成后 SEND 4. 接收数据 : +IPD,4,n:xxxxxxxxxx // received n bytes, data=xxxxxxxxxxx 5. 断开 UDP 传输 : AT+CIPCLOSE=4 : 4,CLOSED 远端可变的 UDP 通信 1. 创建 UDP 传输, 最后参数为 2: AT+CIPSTART="UDP"," ",8080,1112,2 : CONNECT Espressif! 69/96

77 9. AT 使 用! 说明 : " ",8080 为 UDP 传输的远端 IP 和远端端 口, 就是前述 PC 建 立的 UDP 配置 1112 为 ESP32 的 UDP 本地端 口, 用户可 自 行行设置, 如不不设置则为随机值 2 表示当前 UDP 传输建 立后,UDP 传输远端信息仍然会更更改 ;UDP 传输的远端信息会 自动更更改为最近 一次与 ESP32 UDP 通信的远端 IP 和端 口 2. 发送数据 : AT+CIPSEND=7 >UDPtest // send 7 bytes // enter the data, no CR : SEND 注意 : 若输 入的字节数 目超过了了设定的 长度 (n), 则会 busy, 并发送数据的前 n 个字节, 发送完成后 SEND 3. 若需要发 UDP 包给其他 UDP 远端, 只需指定对 方 IP 和端 口即可 AT+CIPSEND=6," ",1000 >abcdef // send six bytes // enter the data, no CR : SEND 4. 接收数据 : +IPD,n:xxxxxxxxxx // received n bytes, data=xxxxxxxxxxx 5. 断开 UDP 传输 : AT+CIPCLOSE : CLOSED 9.3. Wi-Fi 透传 AT Demo 仅在 ESP32 作为 TCP 客户端单连接或 UDP 传输时, 支持透传 TCP 客户端单连接透传 以下为 ESP32 作为 Station 实现 TCP 客户端单连接透传的举例例 1. 设置 Wi-Fi 模式 : Espressif! 70/96

78 9. AT 使 用 AT+CWMODE=3 // SoftAP+Station mode : 2. 连接路路由 : AT+CWJAP="SSID","password" // SSID and password of router : 3. 查询设备 IP 地址 : AT+CIFSR : // device's IP that got from router 4. PC 与 ESP32 连接同 一个路路由, 在 PC 上使 用 网络调试 工具, 创建 一个 TCP 服务器器 - 例例如, 假设 TCP 服务器器的 IP 为 , 端 口为 设备作为 TCP 客户端连接 TCP 服务器器 : AT+CIPSTART="TCP"," ",8080 // protocol, server IP & port : 6. 使能透传模式 : AT+CIPMODE=1 : 7. 发送数据 : AT+CIPSEND : > // From now on, data received from UART will be transparent transmitted to server 8. 退出发送数据 : 在透传发送数据过程中, 若识别到单独的 一包数据 +++, 则退出透传发送 请 至少间隔 1 秒, 再发下 一条 AT 请注意, 如果直接 用键盘打字输 入 +++, 有可能时间太慢, 不不被认为是连续的三个 + Espressif! 71/96

79 ! 9. AT 使 用 注意 : +++ 退出透传发送数据, 回到正常 AT 模式,TCP 连接仍然是保持的, 也可以再发 AT+CIPSEND 指 令, 开始透传 9. 退出透传模式 : AT+CIPMODE=0 : UDP 透传 10. 断开 TCP 连接 : AT+CIPCLOSE : CLOSED 以下为 ESP32 作为 SoftAP 实现 UDP 透传的举例例 1. 设置 Wi-Fi 模式 : AT+CWMODE=3 // SoftAP+Station mode : 2. PC 连 入 ESP32 SoftAP: 3. 在 PC 上使 用 网络调试助 手, 创建 一个 UDP - 例例如, 假设 UDP 的 IP 为 , 端 口为 ESP32 与 PC 对应端 口建 立固定对端的 UDP 传输 AT+CIPSTART="UDP"," ",1001,2233,0 Espressif! 72/96

80 9. AT 使 用 : 5. 使能透传模式 : AT+CIPMODE=1 : 6. 发送数据 : AT+CIPSEND : > // from now on, data received from UART will be transparent transmitted to server 7. 退出发送数据 : 在透传发送数据过程中, 若识别到单独的 一包数据 +++, 则退出透传发送 请 至少间隔 1 秒, 再发下 一条 AT 请注意, 如果直接 用键盘打字输 入 +++, 有可能时间太慢, 不不被认为是连续的三个 + 注意 : 9. 退出透传模式 : AT+CIPMODE=0 : 10. 删除 UDP 传输 : AT+CIPCLOSE : CLOSED 9.4. 多连接 TCP 服务器器 +++ 退出透传发送数据, 回到正常 AT 模式,TCP 连接仍然是保持的, 也可以再发 AT+CIPSEND 指 令, 开始透传 目前 AT Demo ESP32 仅 支持建 立 一个 TCP 服务器器, 且必须使能多连接, 即可连接多个 TCP 客户端 Espressif! 73/96

81 9. AT 使 用! 以下为 ESP32 作为 SoftAP, 建 立 TCP 服务器器的举例例 ; 如果是 ESP32 作为 Station, 可 在连接路路由后, 同理理建 立服务器器 1. 设置 Wi-Fi 模式 : AT+CWMODE=3 // SoftAP+Station mode : 2. 使能多连接 : AT+CIPMUX=1 : 3. 建 立 TCP 服务器器 : AT+CIPSERVER=1 // default port = 333 : 4. PC 连 入 ESP32 SoftAP: 5. 在 PC 使 用 网络调试 工具, 作为 TCP 客户端连接设备 注意 : ESP32 作为 TCP 服务器器有超时机制, 如果连接建 立后, 一段时间内 无数据来往,ESP32 TCP 服务器器会 将 TCP 客户端踢掉 请在 PC 网络 工具连上 ESP32 后建 立 一个 2s 的循环数据发送, 用于保持连接 6. 发送数据 : AT+CIPSEND=0,4 >iopd // ID number of connection is defaulted to be 0 // send 4 bytes to connection NO.0 // enter the data, no CR : Espressif! 74/96

82 9. AT 使 用 SEND 注意 : 若输 入的字节数 目超过了了设定的 长度 (n), 则会 busy, 并发送数据的前 n 个字节, 发送完成后 SEND 7. 接收数据 : +IPD,0,n:xxxxxxxxxx // received n bytes, data = xxxxxxxxxx 8. 断开 TCP 连接 : AT+CIPCLOSE=0 // delete NO.0 connection : 0,CLOSED 9.5. BLE AT 应 用 基于 BLE 广播的应 用 ibeacon 以下介绍两种关于 ibeacon 的应 用 方式 : ESP32 广播 ibeacon 包, 通过微信摇 一摇周边来发现 ESP32 扫描发现其他设备 广播的 ibeacon 包 表 9-1. ibeacon 格式 类型 长度 ( 字节 ) 描述 ibeacon prefix A FF 4C Proximity UUID 16 可 用于区分不不同设备 厂商 Major 2 可 用于区分不不同商店 Minor 2 可 用于区分同 一家商店的不不同位置 ESP32 广播 ibeacon 包 1. 初始化 ESP32 模块的 角 色为 BLE server: AT+BLEINIT=2 // server role : 2. 进 行行 广播 Espressif! 75/96

83 ! 9. AT 使 用 配置 广播包内容如下 : 表 9-2. ibeacon 广播包 类型 内容 ibeacon prefix A FF 4C Proximity UUID Major FDA50693-A4E2-4FB1-AFCF-C6EB B7 Minor F2 06 TX power C5 配置 广播参数如下 : AT+BLEADVDATA=" aff4c000215fda50693a4e24fb1afcfc6eb b7f206c5" : 开始 广播 : AT+BLEADVSTART : 打开微信摇 一摇, 即可发现正在 广播的 ESP32 设备, 如图 9-1 所示 图 9-1. 微信摇 一摇周边 Espressif! 76/96

84 9. AT 使 用 ESP32 扫描 ibeacon 包 ESP32 模块除了了可以发 ibeacon 广播, 也可以设置为 BLE client 进 行行扫描, 获取到 ibeacon 广播包数据, 再由 Host MCU 进 行行数据解析 说明 : 如果该 ESP32 之前已经初始化为 BLE server, 则需要先调 用 AT+BLEINIT=0 注销, 再重新初始化为 BLE client 1. 初始化 ESP32 角 色为 BLE client: AT+BLEINIT=1 // client role : 2. 使能模块开始扫描, 持续 3 秒 : AT+BLESCAN=1,3 : 可以得到类似以下结果 : 基于 BLE 连接的应 用 基本通信 +BLESCAN: 24:0a:c4:02:10:0e,-33, aff4c000215fda50693a4e24fb1afcfc6eb b7f206c5, +BLESCAN:24:0a:c4:01:4d:fe,-74, a4f68664b43020aeb , +BLESCAN: 24:0a:c4:02:10:0e,-33, aff4c000215fda50693a4e24fb1afcfc6eb b7f206c5, 从扫描的结果中可以看到之前配置的 广播包 ( 比如章节 中配置的 广播包 ), Host MCU 可以解析这串串数据, 其格式如前 文表 9-1 所示 以下同时使 用两块 ESP32, 其中 一块作为 Server( 后 文称为 "ESP32 Server"), 另 一块作为 Client( 后 文称为 "ESP32 Client"), 举例例如何建 立 BLE 连接, 完成数据通信 注意 : ESP32 Server 需烧录 service bin 文件到 Flash 中, 用以提供服务 如何 生成 service bin 文件, 请参考 esp32-at/tools/readme.md service bin 文件的烧录地址, 见 esp32-at/at_customize.csv 中 ble_data 对应的地址 1. 初始化 BLE 功能 : Espressif! 77/96

85 9. AT 使 用 ESP32 Server: - 初始化为 BLE server: AT+BLEINIT=2 // server role : - 创建服务 : AT+BLEGATTSSRVCRE // create services : - 开启服务 : AT+BLEGATTSSRVSTART // start services : ESP32 Client: AT+BLEINIT=1 // client role : 2. 建 立 BLE 连接 : ESP32 Server: - 查询 自身的 BLE 地址 假设 ESP32 Server 地址为 24:0a:c4:03:f4:d6, 后 文以此地址为例例 AT+BLEADDR? // get server's BLE address : +BLEADDR:24:0a:c4:03:f4:d6 配置 广播参数 ( 可选操作, 一般 无需配置 ) 如果没有配置 广播参数, 则使 用默认 广播参数 AT+BLEADVPARAM=32,64,0,0,7 : Espressif! 78/96

86 9. AT 使 用 - 配置 广播数据 ( 可选操作 ) 如果没有配置 广播数据, 那么 广播包 payload 为空 AT+BLEADVDATA=" B A0" /* The adv data is * //<length>,<type>,<data> * 0A //<length>,<type>,<data> * A0 //<length>,<type>,<data> */ : 除了了配置 广播数据之外, 还可以配置 ScanRspData( 扫描数据 ): AT+BLESCANRSPDATA=" B A0" : 如果 client 是 Active Scan, 那么就能扫描到 ScanRspData - 开始 广播 : AT+BLEADVSTART : ESP32 Client: - 配置扫描参数 ( 可选操作, 一般 无需配置 ) 在开始扫描之前, 可以配置扫描参数, 假设配置的是 active scan 模式, 如下 : AT+BLESCANPARAM=1,0,0,100,50 : - 进 行行扫描 : AT+BLESCAN=1,3 : +BLESCAN:<BLE address>,<rssi>,<adv data>,<scan rsp data> - 成功扫描到 ESP32 Server 后, 进 行行连接 : AT+BLECONN=0,"24:0a:c4:03:f4:d6" Espressif! 79/96

87 9. AT 使 用 : 说明 : +BLECONN:0,"24:0a:c4:03:f4:d6" 如果 BLE 连接成功建 立, 则提示 +BLECONN:<conn_index>,<remote_BLE_address> 如果 BLE 连接断开, 则提示 +BLEDISCONN:<conn_index>,<remote_BLE_address> - 更更新连接参数 在建 立连接之后, 可以更更新连接参数 : AT+BLECONNPARAM=0,30,30,0,600 : 也可以查询结果 : AT+BLECONNPARAM? : +BLECONNPARAM:0,30,30,30,0,600 - 配置最 大传输单元 (MTU) 在连接建 立之后,client 可以发起 Exchange MTU Request: AT+BLECFGMTU=0,200 : 也可以查询结果 : AT+BLECFGMTU? : +BLECFGMTU:0, 读写服务特征 : ESP32 Server: - 查询本地服务 : Espressif! 80/96

88 9. AT 使 用 AT+BLEGATTSSRV? : +BLEGATTSSRV:1,1,0xA002,1 - 查询本地服务特征 : AT+BLEGATTSCHAR? : +BLEGATTSCHAR:"char",1,1,0xC300 +BLEGATTSCHAR:"desc",1,1,1 +BLEGATTSCHAR:"char",1,2,0xC301 +BLEGATTSCHAR:"desc",1,2,1 +BLEGATTSCHAR:"char",1,3,0xC302 +BLEGATTSCHAR:"desc",1,3,1 ESP32 Client: - 查询服务 : AT+BLEGATTCPRIMSRV=0 : +BLEGATTCPRIMSRV:0,1,0x1801,1 +BLEGATTCPRIMSRV:0,2,0x1800,1 +BLEGATTCPRIMSRV:0,3,0xA002,1 注意 : Client 查询服务的结果, 比 Server 查询服务的结果多两个默认服务 (UUID: 0x1800 和 0x1801), 这是正常现象 正因如此, 对于同 一服务,Client 查询的 <srv_index> 值 = Server 查询的 <srv_index> 值 + 2 例例如, 上述中的服务 0xA002, 当前在 ESP32 Client 侧查询到的 <srv_index> 为 3, 如果在 ESP32 Server 侧查询 (AT+BLEGATTSSRV?), 则对应 <srv_index> 为 1 - 查询服务特征值 : AT+BLEGATTCCHAR=0,3 : +BLEGATTCCHAR:"char",0,3,1,0xC300,2 +BLEGATTCCHAR:"desc",0,3,1,1,0x2901 Espressif! 81/96

89 9. AT 使 用 +BLEGATTCCHAR:"char",0,3,2,0xC301,2 +BLEGATTCCHAR:"desc",0,3,2,1,0x2901 +BLEGATTCCHAR:"char",0,3,3,0xC302,8 +BLEGATTCCHAR:"desc",0,3,3,1,0x2901 +BLEGATTCCHAR:"char",0,3,4,0xC303,4 +BLEGATTCCHAR:"desc",0,3,4,1,0x2901 +BLEGATTCCHAR:"char",0,3,5,0xC304,8 +BLEGATTCCHAR:"char",0,3,6,0xC305,16 +BLEGATTCCHAR:"desc",0,3,6,1,0x2902 +BLEGATTCCHAR:"char",0,3,7,0xC306,32 +BLEGATTCCHAR:"desc",0,3,7,1,0x 读取服务特征 ( 要求该特征属性 支持读取操作 ): AT+BLEGATTCRD=0,3,1 : 说明 : +BLEGATTCRD:0,1,30 ESP32 Client 读取特征成功,ESP32 Server 提示 +READ:<conn_index>,<remote BLE address> - 写服务特征 ( 要求该特征属性 支持写操作 ): AT+BLEGATTCWR=0,3,3,,2 : 说明 : > // waiting for serial data ESP32 Client 写特征成功,ESP32 Server 提示 +WRITE:<conn_index>,<srv_index>,<char_index>, [<desc_index>], <len>,<value> 4. 通知服务特征 : ESP32 Client: - 设置服务特征描述符 ( 要求该特征属性 支持通知操作 ): AT+BLEGATTCWR=0,3,6,1,2 : > // waiting for serial data, should input HEX string "01" here Espressif! 82/96

90 9. AT 使 用 说明 : ESP32 Client 写特征描述符成功,ESP32 Server 提示 +WRITE:<conn_index>,<srv_index>,<char_index>,<desc_index>, <len>,<value> ESP32 Server: - 服务特征通知 ( 要求该特征属性 支持通知操作 ): AT+BLEGATTSNTFY=0,1,6,3 : 说明 : > // waiting for serial data ESP32 Client 收到通知, 将提示 +NOTIFY:<conn_index>,<srv_index>,<char_index>,<len>,<value> 对于同 一服务,Client 侧的 <srv_index> 值 = Server 侧的 <srv_index> 值 + 2, 这是正常现象 5. 指示服务特征 : ESP32 Client: - 设置服务特征描述符 ( 要求该特征属性 支持指示操作 ): AT+BLEGATTCWR=0,3,7,1,2 : 说明 : > // waiting for serial data, should input HEX string "02" here ESP32 Client 写特征描述符成功,ESP32 Server 提示 +WRITE:<conn_index>,<srv_index>,<char_index>,<desc_index>, <len>,<value> ESP32 Server: - 服务特征指示 ( 要求该特征属性 支持指示操作 ): AT+BLEGATTSIND=0,1,7,3 : > // waiting for serial data Espressif! 83/96

91 9. AT 使 用 说明 : BLE 透传 ESP32 Client 收到指示, 将提示 +INDICATE:<conn_index>,<srv_index>,<char_index>,<len>,<value> 对于同 一服务,Client 侧的 <srv_index> 值 = Server 侧的 <srv_index> 值 + 2, 这是正常现象 以下同时使 用两块 ESP32, 其中 一块作为 Server( 后 文称为 ESP32 Server ), 另 一 块作为 Client( 后 文称为 ESP32 Client ), 举例例如何建 立 BLE 连接, 建 立透传通信 注意 : ESP32 Server 需烧录 service bin 文件到 flash 中, 用以提供服务 如何 生成 service bin 文件, 请参考 esp32-at/tools/readme.md service bin 文件的烧录地址, 见 esp32-at/at_customize.csv 中 ble_data 对应的地址 1. 初始化 BLE 功能 : ESP32 Server: - 初始化为 BLE server: AT+BLEINIT=2 // server role : - 创建服务 : AT+BLEGATTSSRVCRE // create services : - 开启服务 : AT+BLEGATTSSRVSTART // start services : ESP32 Client: AT+BLEINIT=1 // client role : 2. 建 立 BLE 连接 : Espressif! 84/96

92 9. AT 使 用 ESP32 Server: - 查询 自身的 BLE 地址 假设 ESP32 Server 地址为 24:0a:c4:03:f4:d6, 后 文以此地 址为例例 AT+BLEADDR? // get server's BLE address : +BLEADDR:24:0a:c4:03:f4:d6 - 配置 广播数据 ( 可选操作 ) 如果没有配置 广播数据, 那么 广播包 payload 为空 AT+BLEADVDATA=" B A0" /* The adv data is * //<length>,<type>,<data> * 0A //<length>,<type>,<data> * A0 //<length>,<type>,<data> */ : - 开始 广播 : AT+BLEADVSTART : ESP32 Client: - 进 行行扫描 : AT+BLESCAN=1,3 : +BLESCAN:<BLE address>,<rssi>,<adv data>,<scan rsp data> - 成功扫描到 ESP32 Server 后, 进 行行连接 : AT+BLECONN=0,"24:0a:c4:03:f4:d6" : +BLECONN:0,"24:0a:c4:03:f4:d6" Espressif! 85/96

93 9. AT 使 用 说明 : 如果 BLE 连接成功建 立, 则提示 +BLECONN:<conn_index>,<remote_BLE_address> 如果 BLE 连接断开, 则提示 +BLEDISCONN:<conn_index>,<remote_BLE_address> 3. 查询服务 : ESP32 Server: - 查询本地服务 : AT+BLEGATTSSRV? : +BLEGATTSSRV:1,1,0xA002,1 - 查询本地服务特征 : AT+BLEGATTSCHAR? : +BLEGATTSCHAR:"char",1,1,0xC300 +BLEGATTSCHAR:"desc",1,1,1 +BLEGATTSCHAR:"char",1,2,0xC301 +BLEGATTSCHAR:"desc",1,2,1 +BLEGATTSCHAR:"char",1,3,0xC302 +BLEGATTSCHAR:"desc",1,3,1 ESP32 Client: - 查询服务 : AT+BLEGATTCPRIMSRV=0 : +BLEGATTCPRIMSRV:0,1,0x1801,1 +BLEGATTCPRIMSRV:0,2,0x1800,1 +BLEGATTCPRIMSRV:0,3,0xA002,1 Espressif! 86/96

94 9. AT 使 用 注意 : Client 查询服务的结果, 比 Server 查询服务的结果多两个默认服务 (UUID: 0x1800 和 0x1801), 这是正常现象 正因如此, 对于同 一服务,Client 查询的 <srv_index> 值 = Server 查询的 <srv_index> 值 + 2 例例如, 上述中的服务 0xA002, 当前在 ESP32 Client 侧查询到的 <srv_index> 为 3, 如果在 ESP32 Server 侧查询 (AT+BLEGATTSSRV?), 则对应 <srv_index> 为 1 - 查询服务特征值 : AT+BLEGATTCCHAR=0,3 : +BLEGATTCCHAR:"char",0,3,1,0xC300,0x02 +BLEGATTCCHAR:"desc",0,3,1,1,0x2901 +BLEGATTCCHAR:"char",0,3,2,0xC301,0x02 +BLEGATTCCHAR:"desc",0,3,2,1,0x2901 +BLEGATTCCHAR:"char",0,3,3,0xC302,0x08 +BLEGATTCCHAR:"desc",0,3,3,1,0x2901 +BLEGATTCCHAR:"char",0,3,4,0xC303,0x04 +BLEGATTCCHAR:"desc",0,3,4,1,0x2901 +BLEGATTCCHAR:"char",0,3,5,0xC304,0x08 +BLEGATTCCHAR:"char",0,3,6,0xC305,0x10 +BLEGATTCCHAR:"desc",0,3,6,1,0x2902 +BLEGATTCCHAR:"char",0,3,7,0xC306,0x20 +BLEGATTCCHAR:"desc",0,3,7,1,0x 配置透传 : ESP32 Client: - 选择 支持写操作的 characteristic 作为写通道发送数据, 选择 支持 notify 或者 indicate 的 characteristic 作为读通道接收数据, 例例如 : AT+BLESPPCFG=1,3,5,3,7 : - 开启透传模式 : AT+BLESPP : > // waiting for serial data Espressif! 87/96

95 9. AT 使 用 说明 : ESP32 Server: - 选择 支持 notify 或者 indicate 的 characteristic 作为写通道发送数据, 选择 支持写操 作的 characteristic 作为读通道接收数据, 例例如 : AT+BLESPPCFG=1,1,7,1,5 : - 开启透传模式 : AT+BLESPP : 基于 BLE 连接的应 用场景 > // waiting for serial data 1. 蓝 牙配 网 用户可以通过 BLE 通信传递 Wi-Fi SSID 和 Password 信息, 以实现蓝 牙配置 无线 网络的 功能 ESP32 Client 开启透传模式后, 串串 口收到的数据会通过 BLE 传输到 Server 端 说明 : ESP32 Server 开启透传模式后, 串串 口收到的数据会通过 BLE 传输到 Client 端 如果 ESP32 Client 端没有先开启透传, 或者使 用其他设备作为 Client, 则 Client 端需要先开启侦听 如果是 BLE client 向 BLE server 传递 SSID 和 Password 信息, 可以使 用 AT+BLEGATTCWR; 如果是 BLE server 向 BLE client 传递 SSID 和 Password 信息, 可以使 用 AT+BLEGATTSNTFY; 详细步骤可参考前 文 章节 2. 数据透传 Notify 或者 Indicate 例例如,ESP32 Client 如果未开启透传, 则应先调 用 AT+BLEGATTCWR=0,3,7,1,1 开启侦听,ESP32 Server 才能成功实现透传 对于同 一服务,Client 侧的 <srv_index> 值 = Server 侧的 <srv_index> 值 + 2, 这是正常现象 当前 ESP32 AT 尚未实现 BLE 透传功能, 但是 用户可以使 用基本的数据传输 方式来模拟这 一过程, 由 Host MCU 过滤出数据信息即可 Espressif! 88/96

96 9. AT 使 用 BLE client 向 BLE server 传输数据, 可由不不断的调 用 AT+BLEGATTCWR 实现 ; BLE server 向 BLE client 传输数据, 可由不不断调 用 AT+BLEGATTSNTFY 实现 ; 详细步骤可参考前 文 章节 3. 固件升级 BLE 数据通信, 也可以 用于传输固件, 实现升级功能 Espressif! 89/96

97 10. OTA 功能! OTA 功能 10. 本章节主要描述如何在 iot.espressif.cn 上创建 自 己的设备 并 自定义基于 iot.espressif.cn 的 OTA 功能 1. 打开浏览器器输 入 iot.espressif.cn 如果使 用 SSL 升级 则 网址为 iot.espressif.cn! 2. 点击右上 角的 Join 输 入 用户名 邮箱和密码 注册账号! 3. 然后点击 设备开发 里里 面的 创建 创建 一个 自 己的设备 Espressif! /! 96 90

98 !!! 10. OTA 功能 4. 创建成功后, 会有 一个密钥 5. 使 用密钥, 编译 自 己的 OTA BIN 修改 AT OTA token 密钥的配置流程如下 : Espressif! 91/! 96

99 !!! 10. OTA 功能 Espressif! 92/! 96

100 !! 10. OTA 功能 注意 : 如果使 用 SSL OTA 功能, 需在 menuconfig 中选择 "OTA based upon ssl", 输 入空格进 行行选择 6. 进 入产品管理理界 面, 点击刚才创建的设备, 在 ROM 发布下 面, 输 入 version 和 corename, 将上 面编译的 BIN 文件重命名为 ota.bin, 然后选取并点击保存 7. 点击设置为当前版本 Espressif! 93/! 96

101 ! 10. OTA 功能 8. 发送 AT+CIUPDATE, 如果 网络正常, 则即可完成 OTA 升级 Espressif! 94/! 96