BLE学习之EST32-AT 指令

BLE学习之EST32-AT 指令

BLE学习之EST32-AT 指令

AT命令
边学边记边理解边更新

基础AT指令

• AT：测试 AT 启动

AT
ok

• AT+RST：重启模块

AT+RST
ok

• AT+GMR：查看版本信息

AT+GMR

AT version:2.4.0.0(4c6eb5e - ESP32 - May 20 2022 03:11:58)
SDK version:qa-test-v4.3.3-20220423
compile time(5641e0a):May 20 2022 11:13:22
Bin version:2.4.0(SOLO-1)

OK

• AT+CMD：查询当前固件支持的所有命令及命令类型

AT+CMD?
+CMD:<index>,<AT command name>,<support test command>,<support query command>,
,→<support set command>,<support execute command>
OK
• <index>：AT 命令序号
• <AT command name>：AT 命令名称
• <support test command>：0 表示不支持，1 表示支持
• <support query command>：0 表示不支持，1 表示支持
• <support set command>：0 表示不支持，1 表示支持
• <support execute command>：0 表示不支持，1 表示支持

• AT+GSLP：进入 Deep-sleep 模式
• ATE：开启或关闭 AT 回显功能
• AT+RESTORE：恢复出厂设置

//该命令将擦除所有保存到 flash 的参数，并恢复为默认参数。
//运行该命令会重启设备。
AT+RESTORE
OK

• AT+UART_CUR：设置 UART 当前临时配置，不保存到 flash
• AT+UART_DEF：设置 UART 默认配置, 保存到 flash
• AT+SLEEP：设置 sleep 模式
• AT+SYSRAM：查询当前剩余堆空间和最小堆空间
• AT+SYSMSG：查询/设置系统提示信息

AT+SYSMSG?
+SYSMSG:0
OK

• AT+SYSFLASH：查询或读写 flash 用户分区
• AT+FS：文件系统操作
• AT+RFPOWER：查询/设置 RF TX Power
• AT+SYSROLLBACK：回滚到以前的固件
• AT+SYSTIMESTAMP：查询/设置本地时间戳
• AT+SYSLOG：启用或禁用 AT 错误代码提示

// 启 用 AT 错 误 代 码 提 示
AT+SYSLOG=1
OK
AT+FAKE
ERR CODE:0x01090000
ERROR

• AT+SLEEPWKCFG：设置 Light-sleep 唤醒源和唤醒 GPIO
• AT+SYSSTORE：设置参数存储模式
• AT+SYSREG：读写寄存器

Bluetooth® Low Energy AT 命令集

• AT+BLEINIT：Bluetooth LE 初始化

AT+BLEINIT?
+BLEINIT:0

OK
//• <init>:
//– 0: 注销 Bluetooth LE
//– 1: client 角色
//– 2: server 角色

• AT+BLEADDR：设置 Bluetooth LE 设备地址

AT+BLEINIT=1 //初始化为客户端

OK
AT+BLEADDR?//查询ＢＬＥ 设备地址
+BLEADDR:"24:6f:28:70:00:8a"
OK
/*
AT+BLEADDR=<addr_type>[,<random_addr>]
• <addr_type>:
– 0: 公共地址 (Public Address)
– 1: 随机地址 (Random Address)
*/
AT+BLEADDR=1,"f8:7f:24:87:1c:7b" // 设 置 随 机 设 备 地 址 的 静 态 地 址
AT+BLEADDR=1 // 设 置 随 机 设 备 地 址 的 私 有 地 址
AT+BLEADDR=0 // 设 置 公 共 设 备 地 址

• AT+BLENAME：查询/设置 Bluetooth LE 设备名称

//查询
AT+BLENAME?
+BLENAME:ESP-AT
//设置
OK
AT+BLENAME="LJX_ESP"

OK

———————————————————————————————————————————————————
• AT+BLESCANPARAM：查询/设置 Bluetooth LE 扫描参数

+BLESCANPARAM:0,0,0,320,48
OK
//• <scan_type>：扫描类型 • <own_addr_type>：地址类型 • <filter_policy>：扫描过滤方式
//• <scan_interval>： 扫 描 间 隔  • <scan_window>：扫描窗口
AT+BLEINIT=1 // 角 色 ： 客 户 端
AT+BLESCANPARAM=0,0,0,100,50

• AT+BLESCAN：使能 Bluetooth LE 扫描

AT+BLESCAN=<enable>[,<interval>][,<filter_type>,<filter_param>]
/*参数意义
• <enable>：
– 1: 开始持续扫描
– 0: 停止持续扫描
• [<interval>]：扫描持续时间，单位：秒。
– 若设置停止扫描，无需设置本参数；
– 若设置开始扫描，需设置本参数：
– 本参数设为 0 时，则表示开始持续扫描；
– 本参数设为非 0 值时，例如 AT+BLESCAN=1,3，则表示扫描 3 秒后自动结束扫描，然后返回
扫描结果。
• [<filter_type>]：过滤选项
– 1: “MAC”
– 2: “NAME”
• <filter_param>：过滤参数，表示对方设备 MAC 地址或名称*/
+BLESCAN:<addr>,<rssi>,<adv_data>,<scan_rsp_data>,<addr_type>
OK
/*
• <addr>：Bluetooth LE 地址
• <rssi>：信号强度
• <adv_data>：广播数据
• <scan_rsp_data>：扫描响应数据
• <addr_type>：广播设备地址类型
*/

示例

AT+BLEINIT=1 // 角 色 ： 客 户 端
AT+BLESCAN=1 // 开 始 扫 描
AT+BLESCAN=0 // 停 止 扫 描
AT+BLESCAN=1,3,1,"24:0A:C4:96:E6:88" // 开 始 扫 描 ， 过 滤 类 型 为 MAC 地 址
AT+BLESCAN=1,3,2,"ESP-AT" // 开 始 扫 描 ， 过 滤 类 型 为 设 备 名 称

• AT+BLECONN：建立 Bluetooth LE 连接

AT+BLECONN?
+BLECONN:

OK

AT+BLEINIT=1 // 角 色 ： 客 户 端
AT+BLECONN=0,"24:0a:c4:09:34:23",0,10 
//• <conn_index>：Bluetooth LE 连接号，范围：[0,2]。
//• <remote_address>：对方 Bluetooth LE 设备地址。
//• [<addr_type>]：广播设备地址类型：
//– 0: 公共地址 (Public Address)
//– 1: 随机地址 (Random Address)
//• [<timeout>]：连接超时时间，单位：秒。范围：[3,30]。

• AT+BLECONNPARAM：查询/更新 Bluetooth LE 连接参数

AT+BLEINIT=1 //初始化为Client
ok
AT+BLESCAN=1,3,1,"6e:d3:5f:19:60:be" //扫描过滤设备

OK
+BLESCAN:"6e:d3:5f:19:60:be",-26,02011a020a070bff4c001006321afd29050a,,1
AT+BLECONN? //查询连接
+BLECONN:

OK
AT+BLECONN=0,"6e:d3:5f:19:60:be",0,30 //连接Server
+BLECONN:0,"6e:d3:5f:19:60:be"

OK
AT+BLECONN?//查询连接
+BLECONN:0,"6e:d3:5f:19:60:be"

OK
AT+BLECONNPARAM? //查询ＢＬＥ连接参数
+BLECONNPARAM:0,10,12,11,0,600
• <conn_index>：Bluetooth LE 连接号 • <min_interval>：最小连接间隔 • <max_interval>：最大连接间隔
• <cur_interval>：当前连接间隔 • <latency>：延迟 • <timeout>：超时
OK
//设置命令
AT+BLECONNPARAM=<conn_index>,<min_interval>,<max_interval>,<latency>,<timeout>

• AT+BLEDATALEN：设置 Bluetooth LE 数据包长度
• AT+BLECFGMTU：设置 Bluetooth LE MTU 长度

AT+BLEINIT=1 // 角 色 ： 客 户 端
AT+BLECONN=0,"24:0a:c4:09:34:23"
AT+BLEDATALEN=0,30
• <conn_index>：Bluetooth LE 连接号 • <pkt_data_len>：数据包长度
AT+BLECFGMTU=0,300
• <conn_index>：Bluetooth LE 连接号 • <mtu_size>：MTU 长度

• AT+BLEDISCONN：断开 Bluetooth LE 连接

AT+BLEDISCONN=<conn_index>
• <conn_index>：Bluetooth LE 连接号

**• AT+BLEGATTCPRIMSRV：GATTC 发现基本服务

AT+BLEGATTCPRIMSRV=0
+BLEGATTCPRIMSRV:0,1,0x1800,1
+BLEGATTCPRIMSRV:0,2,0x1801,1
+BLEGATTCPRIMSRV:0,3,0xD0611E78BBB44591A5F8487910AE4366,1
+BLEGATTCPRIMSRV:0,4,0x9FA480E0496745429390D343DC5D04AE,1
+BLEGATTCPRIMSRV:0,5,0x180F,1
+BLEGATTCPRIMSRV:0,6,0x1805,1
+BLEGATTCPRIMSRV:0,7,0x180A,1
+BLEGATTCPRIMSRV:0,8,0x7905F431B5CE4E99A40F4B1E122D00D0,1
+BLEGATTCPRIMSRV:0,9,0x89D3502B0F36433A8EF4C502AD55F8DC,1

OK

• AT+BLEGATTCINCLSRV：GATTC 发现包含的服务
• AT+BLEGATTCCHAR：GATTC 发现服务特征
•AT+BLEGATTCWR：GATTC 写服务特征值**

AT+BLEGATTCPRIMSRV=0
AT+BLEGATTCCHAR=0,3 // 根 据 前 一 条 命 令 的 查 询 结 果 ， 指 定 index 查 询
// 例 如 ， 向 第 3 号 服 务 的 第 4 号 特 征 ， 写 入 长 度 为 6 字 节 的 数 据 ， 命 令 如 下 ：
AT+BLEGATTCWR=0,3,4,,6
// 提 示 ">" 符 号 后 ， 输 入 6 字 节 的 数 据 即 可 ， 如 "123456"， 然 后 开 始 写 入

———————————————————————————————————————————————————
• AT+BLESCANRSPDATA：设置 Bluetooth LE 扫描响应
扫描响应数据，为 HEX 字符串。例如，若想设置扫描响应数据为“0x11 0x22
0x33 0x44 0x55”，则命令为 AT+BLESCANRSPDATA=“1122334455”。

AT+BLEINIT=2 // 角 色 ： 服 务 器
AT+BLESCANRSPDATA="1122334455"

• AT+BLEADVPARAM：查询/设置 Bluetooth LE 广播参数

AT+BLEADVPARAM?
+BLEADVPARAM:32,64,0,0,7,0,0,"00:00:00:00:00:00"
OK
• <adv_int_min>：最小广播间隔 • <adv_int_max>：最大广播间隔  
• <adv_type> • <own_addr_type>：Bluetooth LE 地址类型 
• <channel_map>：广播信道 • [<adv_filter_policy>]：广播过滤器规则 
• [<peer_addr_type>]：对方 Bluetooth LE 地址类型 
• [<peer_addr>]：对方 Bluetooth LE 地址  • [<primary_phy>]：广播 primary PHY  
• [<secondary_phy>]：广播 secondary PHY

• AT+BLEADVDATA：设置 Bluetooth LE 广播数据

AT+BLEINIT=2 // 角 色 ： 服 务 器
AT+BLEADVDATA="1122334455"

• AT+BLEADVDATAEX：自动设置 Bluetooth LE 广播数据

AT+BLEADVDATAEX?
+BLEADVDATAEX:"LJX_ESP","A002","0102030405",1
OK

• AT+BLEADVSTART：开始 Bluetooth LE 广播
• AT+BLEADVSTOP：停止 Bluetooth LE 广播

AT+BLEINIT=2
AT+BLEADVSTART
AT+BLEADVSTOP

• AT+BLEGATTSSRVCRE：GATTS 创建服务
• AT+BLEGATTSSRVSTART：GATTS 开启服务
• AT+BLEGATTSSRVSTOP：GATTS 停止服务
建议在 Bluetooth LE 连接建立之前使用创建和开启操作

AT+BLEGATTSSRVCRE
AT+BLEGATTSSRVSTART
AT+BLEGATTSSRVSTOP

• AT+BLEGATTSSRV：GATTS 发现服务

AT+BLEGATTSSRV?
+BLEGATTSSRV:1,1,0xA002,1
+BLEGATTSSRV:2,1,0xA003,1
• <srv_index>：服务序号 • <start> • <srv_uuid>：服务的 UUID • <srv_type>：服务的类型
OK

• AT+BLEGATTSCHAR：GATTS 发现服务特征

AT+BLEGATTSCHAR?
+BLEGATTSCHAR:"char",1,1,0xC300,0x02
+BLEGATTSCHAR:"desc",1,1,1,0x2901
+BLEGATTSCHAR:"char",1,2,0xC301,0x02
+BLEGATTSCHAR:"desc",1,2,1,0x2901
+BLEGATTSCHAR:"char",1,3,0xC302,0x08
+BLEGATTSCHAR:"desc",1,3,1,0x2901
+BLEGATTSCHAR:"char",1,4,0xC303,0x04
+BLEGATTSCHAR:"desc",1,4,1,0x2901
+BLEGATTSCHAR:"char",1,5,0xC304,0x08
+BLEGATTSCHAR:"char",1,6,0xC305,0x10
+BLEGATTSCHAR:"desc",1,6,1,0x2902
+BLEGATTSCHAR:"char",1,7,0xC306,0x20
+BLEGATTSCHAR:"desc",1,7,1,0x2902
+BLEGATTSCHAR:"char",1,8,0xC307,0x02
+BLEGATTSCHAR:"desc",1,8,1,0x2901
+BLEGATTSCHAR:"char",2,1,0xC400,0x02
+BLEGATTSCHAR:"desc",2,1,1,0x2901
+BLEGATTSCHAR:"char",2,2,0xC401,0x02
+BLEGATTSCHAR:"desc",2,2,1,0x2901
• <srv_index>：服务序号 • <char_index>：服务特征的序号 • <char_uuid>：服务特征的 UUID • <char_prop>：服务特征的属性
• <desc_index>：特征描述符序号 • <desc_uuid>：特征描述符的 UUID
OK

• AT+BLEGATTSNTFY：服务器 notify 服务特征值给客户端

AT+BLEGATTSNTFY=<conn_index>,<srv_index>,<char_index>,<length>
                BLE 连接号   服务序号    服务特征的序号 数据长度

• AT+BLEGATTSIND：服务器 indicate 服务特征值给客户端

AT+BLEGATTSIND=<conn_index>,<srv_index>,<char_index>,<length>

• AT+BLEGATTSSETATTR：GATTS 设置服务特征值

AT+BLEGATTSSETATTR=<srv_index>,<char_index>,[<desc_index>],<length>
• [<desc_index>]：特征描述符序号：
– 若填写，则设置描述符的值；
– 若未填写，则设置特征值。
AT+BLEGATTSSETATTR=1,1,,1
>8

OK

———————————————————————————————————————————————————
•AT+BLESPPCFG：查询/设置 Bluetooth LE SPP 参数

AT+BLESPPCFG?
+BLESPPCFG:0,0,0,0,1
• <tx_service_index>：tx 服 务 序 号 • <tx_char_index>：tx 服 务 特 征 序 号 
• <rx_service_index>：rx 服 务 序 号 • <rx_char_index>：rx 服 务 特 征 序 号
• <auto_conn>: 自动重连标志位，默认情况下，自动重连功能被使能
OK

• AT+BLESECPARAM：查询/设置 Bluetooth LE 加密参数
• AT+BLEENC：发起 Bluetooth LE 加密请求

AT+RESTORE
AT+BLEINIT=2
AT+BLEGATTSSRVCRE
AT+BLEGATTSSRVSTART
AT+BLEADDR?
AT+BLESECPARAM=1,0,16,3,3
AT+BLESETKEY=123456
AT+BLEADVSTART
// 使 用 Bluetooth LE 调 试 app 作 为 client 与 ESP32 设 备 建 立 Bluetooth LE 连 接
AT+BLEENC=0,3

• AT+BLEENCDEV：查询绑定的 Bluetooth LE 加密设备列表

AT+BLEENCDEV?

•AT+BLEENCCLEAR：清除 Bluetooth LE 加密设备列表

AT+BLEENCCLEAR=<enc_dev_index> //从安全数据库列表中删除某一连接号的设备
AT+BLEENCCLEAR //删除安全数据库所有设备

慎用，删除后在对端设备也需要删除
• AT+BLESETKEY：设置 Bluetooth LE 静态配对密钥

AT+BLESETKEY?
AT+BLESETKEY=123456

—————————————————————————————————————————
突然觉得自己写得跟翔一样~~