Demo
AT+BTDEMO=peripheral
功能说明
初始化或者反初始化 Peripheral 应用。
命令格式
AT+BTDEMO=peripheral,<op>
响应格式
- 如果
<op>
为 1: Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:04:06] HCI Revision is 0x000e, LMP Subversion is 0x8720. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250421202736 FW Length: 77317 Start upper stack [APP] BD_ADDR: 00:E0:4C:80:04:06(public) [APP] simple ble service register succeed! [APP] DIS register service succeed! [APP] HRS register service succeed! [APP] BAS register service succeed! [APP] IAS register service succeed! [APP] GLS register service succeed! [APP] Long uuid service register succeed! peripheral example enable OK! [MEM] After do cmd, available heap 513056 # [APP] ADV started: adv_type 0
如果 <op>
为 0:
peripheral example disable OK!
参数
- <op>:
初始化或反初始化 Peripheral 应用
0: 反初始化 Peripheral 应用
1: 初始化 Peripheral 应用
AT+BTDEMO=central
功能说明
初始化或者反初始化 Central 应用。
命令格式
AT+BTDEMO=central,<op>
响应格式
- 如果
<op>
为 1: bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55(public) central example enable OK!
如果 <op>
为 0:
central example disable OK!
参数
- <op>:
初始化或反初始化 Central 应用
0: 反初始化 Central 应用
1: 初始化 Central 应用
AT+BTDEMO=scatternet
功能说明
初始化或者反初始化 Scatternet 应用。
命令格式
AT+BTDEMO=scatternet,<op>
响应格式
如果 <op>
为 1:
Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0d:c3] hci_phy_efuse[PEFUSE(0x741)] = 0x88 HCI Revision is 0x000d, LMP Subversion is 0x8721. Set baudrate to 3000000 success! Signature check success: Merge patch v2 FW Version: 20250424112906 FW Length: 29680 Start upper stack [APP] BD_ADDR: 00:E0:4C:80:0D:C3(public) [APP] simple ble service register succeed! [APP] DIS register service succeed! [APP] HRS register service succeed! [APP] BAS register service succeed! [APP] IAS register service succeed! [APP] GLS register service succeed! [APP] Long uuid service register succeed! scatternet example enable OK! [MEM] After do cmd, available heap 258496 # [APP] ADV started: adv_type 0
如果 <op>
为 0:
scatternet example disable OK!
参数
- <op>:
初始化或反初始化 Scatternet 应用
0: 反初始化 Scatternet 应用
1: 初始化 Scatternet 应用
AT+BTDEMO=provisioner
功能说明
初始化或者反初始化 Mesh Provisioner 应用。
命令格式
AT+BTDEMO=provisioner,<op>
响应格式
如果 <op>
为 1:
Before Enable BT bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55(public) mesh provisioner example enable OK!
如果 <op>
为 0:
mesh provisioner example disable OK!
参数
- <op>:
初始化或反初始化 Mesh Provisioner 应用
0: 反初始化 Mesh Provisioner 应用
1: 初始化 Mesh Provisioner 应用
AT+BTDEMO=device
功能说明
初始化或者反初始化 Mesh Device 应用。
命令格式
AT+BTDEMO=device,<op>
响应格式
如果 <op>
为 1:
[WLAN-A] IPS out Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0c:e9] hci_phy_efuse[PEFUSE(0x741)] = 0x88 HCI Revision is 0x000d, LMP Subversion is 0x8721. Set baudrate to 3000000 success! Signature check success: Merge patch v2 FW Version: 20250424112906 FW Length: 29680 Start upper stack [APP] Unprovisioned Device [APP] BD_ADDR: 00:E0:4C:80:0C:E9(public) mesh device example enable OK! [MEM] After do cmd, available heap 239968
如果 <op>
为 0:
mesh device example disable OK!
参数
- <op>:
初始化或反初始化 Mesh Device 应用
0: 反初始化 Mesh Device 应用
1: 初始化 Mesh Device 应用
AT+BTDEMO=generic_le_audio_demo,initiator
功能说明
初始化或者反初始化 LE Audio Initiator 应用。
命令格式
AT+BTDEMO=generic_le_audio_demo,initiator,<op>
响应格式
如果 <op>
为 1:
Set cap initiator bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack [BAP] bt_stack_bap_init [CAP] bt_stack_cap_init [CAP] bt_stack_csis_cap_init, role Set Coordinator [CAP] bt_stack_mcs_server_cap_init [CAP] bt_stack_mcs_server_init bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55(public) [LEA STACK] bt_stack_le_audio_gen_basic_data: group index: 0, group bis number :1 [LE Audio] Create initiator ext scan timer cap example enable OK!
如果 <op>
为 0:
Set cap initiator [BAP]bt_stack_bap_deinit [CAP]bt_stack_cap_deinit [BT AUDIO] bt audio stream handle task exit [BT_AUDIO] deinit complete ! cap example disable OK!
参数
- <op>:
初始化或反初始化 LE Audio Initiator 应用
0: 反初始化 LE Audio Initiator 应用
1: 初始化 LE Audio Initiator 应用
AT+BTDEMO=generic_le_audio_demo,acceptor
功能说明
初始化或者反初始化 LE Audio Acceptor 应用。
命令格式
AT+BTDEMO=generic_le_audio_demo,acceptor,<op>,<sound_channel>
响应格式
如果 <op>
为 1:
Set cap acceptor Set channel stereo bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack [BAP] bt_stack_bap_init [BAP]SINK PAC ID 0x00, SOURCE PAC ID 0x01 [CAP] bt_stack_cap_init [CAP] bt_stack_vc_mic_init [CAP] bt_stack_csis_cap_init, role Set Member [CAP] bt_stack_mcp_client_cap_init bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] sink_pac_id = 0,source_pac_id = 1 [APP] BD_ADDR: 00:E0:4C:80:0E:55(public) [APP] device_name_len 26 *adv_data_len 7 [APP] Ext ADV(0) started cap example enable OK!
如果 <op>
为 0:
Set cap acceptor Set channel stereo [APP] Ext ADV(0) stopped: reason 0x0 [BAP]bt_stack_bap_deinit [CAP]bt_stack_cap_deinit [BT AUDIO] bt audio stream handle task exit [BT_AUDIO] deinit complete ! cap example disable OK!
参数
- <op>:
初始化或反初始化 LE Audio Acceptor 应用
0: 反初始化 LE Audio Acceptor 应用
1: 初始化 LE Audio Acceptor 应用
- <sound_channel>:
音频通道类型
left: 左声道
right: 右声道
stereo: 立体声
AT+BTDEMO=a2dp
功能说明
初始化或者反初始化 A2DP 应用。
命令格式
AT+BTDEMO=a2dp,<role>,<op>
响应格式
如果 <op>
为 1, 以 A2DP Sink 角色为例:
Set a2dp role (snk) bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack [AVRCP]app_avrcp_init [A2DP]app_a2dp_init [SDP]app_sdp_init bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55 [A2DP Demo] Create auto reaconnect timer [A2DP Demo] Load a2dp demo reconnect data success [A2DP Demo] Load a2dp demo bond info table success [A2DP Demo] Bond Info List >> 1. mac addr 00:e0:4c:80:0e:41 name RTK_BT_AUDIO_DEVICE(0E41) [A2DP Demo] Create bond info flush thread a2dp example enable OK!
如果 <op>
为 0, 以 A2DP Sink 角色为例:
Set a2dp role (snk) [AVRCP]app_avrcp_deinit [A2DP]app_a2dp_init [SDP]app_sdp_deinit bt_stack_sdp_deinit(): rtk_sdp_record_list is empty ! [BT_AUDIO] No need to do deinit a2dp example disable OK!
参数
- <role>:
A2DP 角色
snk: Sink 角色
src: Source 角色
- <op>:
初始化或反初始化 A2DP 应用
0: 反初始化 A2DP 应用
1: 初始化 A2DP 应用
AT+BTDEMO=spp
功能说明
初始化或者反初始化 SPP 应用。
命令格式
AT+BTDEMO=spp,<role>,<op>
响应格式
如果 <op>
为 1, 以 SPP Client 角色为例:
Set spp role (client) [APP] spp demo role : SPP Client bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack bt_stack_spp_init [SDP]app_sdp_init bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55 spp example enable OK!
如果 <op>
为 0, 以 SPP Client 角色为例:
Set spp role (client) spp_demo_deinit [SDP]app_sdp_deinit bt_stack_sdp_deinit(): rtk_sdp_record_list is empty ! spp example disable OK!
参数
- <role>:
SPP 角色 - client: Client 角色 - server: Server 角色
- <op>:
初始化或反初始化 SPP 应用
0: 反初始化 SPP 应用
1: 初始化 SPP 应用
AT+BTDEMO=hfp
功能说明
初始化或者反初始化 HFP 应用。
命令格式
AT+BTDEMO=hfp,<role>,<op>
响应格式
如果 <op>
为 1, 以 HFP Audio Gate 角色为例:
Set hfp role (audio gate) bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack [SDP]app_sdp_init [HFP]app_hfp_init bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55 hfp example enable OK!
如果 <op>
为 0, 以 HFP Audio Gate 角色为例:
Set hfp role (audio gate) [HFP]app_hfp_init [SDP]app_sdp_deinit bt_stack_sdp_deinit(): rtk_sdp_record_list is empty ! [BT_AUDIO] No need to do deinit hfp example disable OK!
参数
- <role>:
HFP 角色
ag: Audio Gate 角色
hf: Hand Free 角色
- <op>:
初始化或反初始化 HFP 应用
0: 反初始化 HFP 应用
1: 初始化 HFP 应用
AT+BTDEMO=ble_wifimate_configurator
功能说明
初始化或者反初始化 WiFiMate Configurator 应用。
命令格式
AT+BTDEMO=ble_wifimate_configurator,<op>
响应格式
如果 <op>
为 1:
bt ant 0 Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:55] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:55 [APP] BD_ADDR: 00:E0:4C:80:0E:55(public) ble wifimate configurator example enable OK! [MEM] After do cmd, available heap 2334656
如果 <op>
为 0:
ble wifimate configurator example disable OK!
参数
- <op>:
初始化或反初始化 WiFiMate Configurator 应用
0: 反初始化 WiFiMate Configurator 应用
1: 初始化 WiFiMate Configurator 应用
AT+BTDEMO=ble_wifimate_device
功能说明
初始化或者反初始化 WiFiMate Device 应用。
命令格式
AT+BTDEMO=ble_wifimate_device,<op>
响应格式
如果 <op>
为 1:
bt ant 1 [WLAN-A] IPS out Bluetooth init BT_ADDR in cfgbuf [00:e0:4c:80:0e:41] HCI Revision is 0x000e, LMP Subversion is 0x8730. Set baudrate to 3000000 success! Signature check success: Merge patch v3 FW Version: 20250513111223 FW Length: 82449 Start upper stack bt_stack_mgr_cback: bt_ready, bd_addr 00:e0:4c:80:0e:41 [APP] BD_ADDR: 00:E0:4C:80:0E:41(public) [APP] BLE WiFiMate service register succeed! Ble wifimate device example enable OK! [MEM] After do cmd, available heap 2333760 # [APP] ADV started: adv_type 0
如果 <op>
为 0:
Ble wifimate device example disable OK!
参数
- <op>:
初始化或反初始化 WiFiMate Device 应用
0: 反初始化 WiFiMate Device 应用
1: 初始化 WiFiMate Device 应用
BLE GAP
AT+BLEGAP=version
功能说明
获取设备的版本信息。
命令格式
AT+BLEGAP=version
响应格式
GAP get version, hci_revision: 0x55c, lmp_subversion: 0x1a52, btgap_revision: 0x0, btgap_buildnum: 0x39c
参数
NULL
AT+BLEGAP=addr
功能说明
获取设备的蓝牙地址。
命令格式
AT+BLEGAP=addr
响应格式
GAP get bd_addr: <addr>[<addr_type>]
参数
- <addr>:
蓝牙地址
- <addr_type>:
蓝牙地址类型
public: 公共地址
random: 随机地址
AT+BLEGAP=channel
功能说明
设置 Host Channel Classification (HCC) 的值。
命令格式
AT+BLEGAP=channel,<channel_map>
响应格式
GAP set channel map success
参数
- <channel_map>:
一个带 0x 前缀的 16 进制数(长度为 5 字节,总共 40 位), 其中包含 37 个各占 1 位的位域。最高的几位(即剩下的 3 位)为保留位, 现阶段应设置为 0, 以供将来扩展使用(例如 0x1FFFFFFFFF)。
AT+BLEGAP=dev_state
功能说明
获取设备状态信息。
命令格式
AT+BLEGAP=dev_state
响应格式
GAP dev state, init_state: 1, adv_state: 0, scan_state: 0, conn_state: 0
参数
NULL
AT+BLEGAP=name
功能说明
设置设备名称。
命令格式
AT+BLEGAP=name,<device_name>
响应格式
GAP set device name success
参数
- <device_name>:
设备名称, ASCII 字符串
AT+BLEGAP=appear
功能说明
设置设备外观。
命令格式
AT+BLEGAP=appear,<appearance_code>
响应格式
GAP set device appearance success
参数
- <appearance_code>:
整数型数字
AT+BLEGAP=set_mtu
功能说明
设置设备 MTU 大小。
命令格式
AT+BLEGAP=set_mtu,<mtu_size>
响应格式
GAP set device appearance success
参数
- <mtu_size>:
MTU 大小
[0, 0xFFFF]
AT+BLEGAP=pre_conn_param
功能说明
设置设备偏好的连线参数。
命令格式
AT+BLEGAP=pre_conn_param,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<timeout>
响应格式
conn_interval_min=0x10,conn_interval_max=0x100,slave_latency=0x2,supervision_timeout=0x1f4
GAP set preferred conn param success
参数
- <conn_interval_min>:
最小连接间隔
[0x0006, 0x0C80]
最小连接间隔 = <conn_interval_min> * 1.25ms, 范围 7.5ms 到 4s
- <conn_interval_max>:
最大连接间隔
[0x0006, 0x0C80]
最大连接间隔 = <conn_interval_max> * 1.25ms, 范围 7.5ms 到 4s
- <conn_latency>:
从设备延迟
[0x0000, 0x01F3]
- <timeout>:
连接超时
[0x000A, 0x0C80]
连接超时 = <supv_timeout> * 10ms, 范围 100ms 到 32s
AT+BLEGAP=rand_addr
功能说明
设置 Controller 中的蓝牙随机地址。
命令格式
AT+BLEGAP=rand_addr,<addr>[,<type>]
响应格式
GAP set random address success, auto_generate: 0, random_addr: 11:22:33:44:55:66
参数
- <addr>:
设置的蓝牙随机地址
- <type>:
蓝牙地址类型
当使用 Host 生成随机地址时, type 设置为 0, 此时<addr>可以是任意值
AT+BLEGAP=adv_data
功能说明
设置广播数据。
命令格式
AT+BLEGAP=adv_data[,<data>]
响应格式
GAP set default adv data success
参数
- <data>:
不包含 0x 前缀的 16 进制字符串, 如果不设置, 则使用默认的广播数据。
示例
AT+BLEGAP=adv_data,02010508095265616c74656b
OK
//02: 标志部分的长度
//01: 类型是标志
//05: LE 限制可发现模式和 BR/EDR 不支持
//08: 本地名称部分的长度
//09: 类型是完整本地名称
//5265616c74656b: 字符串 ``Realtek`` 的 ASCII 值,这是广播数据中的本地名称
AT+BLEGAP=scan_rsp
功能说明
设置扫描响应数据。
命令格式
AT+BLEGAP=scan_rsp[,<data>]
响应格式
GAP set def scan resp data success
参数
- <data>:
不包含 0x 前缀的 16 进制字符串, 如果不设置, 则使用默认的扫描响应数据。
AT+BLEGAP=adv
功能说明
设置扫描响应数据。
命令格式
AT+BLEGAP=adv,<op>[,<type>,<own_addr_type>,<filter_policy>[,<peer_addr_type>,<peer_addr>[,<interval_min>,<interval_max>,<channel_map>]]]
响应格式
[APP] ADV started: adv_type 0
或者
[APP] ADV stopped: reason 0x0
参数
- <op>:
广播选项
1: 开始广播
0: 停止广播
- <type>:
广播类型
0: 可连接非定向广播
1: 可连接高占空比定向广播
2: 可扫描非定向广播
3: 不可连接非定向广播
4: 可连接低占空比定向广播
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <filter_policy>:
广播过滤策略
0: 处理所有设备的扫描和连接请求
1: 处理所有设备的连接请求,仅处理白名单中设备的扫描请求
2: 处理所有设备的扫描请求,仅处理白名单中设备的连接请求
3: 仅处理白名单中设备的扫描和连接请求
- <peer_addr_type>:
对端地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <peer_addr>:
对端地址
- <interval_min>:
最小广播间隔
[0x20, 0x4000]
最小广播间隔 = <interval_min> * 0.625ms, 范围 20ms 到 10.24s
- <interval_max>:
最大广播间隔
[0x20, 0x4000]
最大广播间隔 = <interval_max> * 0.625ms, 范围 20ms 到 10.24s
- <channel_map>:
广播通道映射
0x01: 广播通道 37
0x02: 广播通道 38
0x04: 广播通道 39
0x07: 所有广播通道启用
AT+BLEGAP=scan_param
功能说明
设置扫描参数。
命令格式
AT+BLEGAP=scan_param[,<type>,<own_addr_type>,<filter_policy>,<duplicate_opt>[,<interval>,<window>]]
响应格式
GAP set scan param success
参数
- <type>:
扫描类型
0: 被动扫描
1: 主动扫描
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <filter_policy>:
扫描过滤策略
0: 接受所有广播数据包,除了是不针对此设备的定向广播数据包(默认)
1: 仅接受白名单中广播者地址的广播数据包。不针对此设备的定向广播数据包将被忽略
2: 接受所有广播数据包,除了发起者的身份地址不针对此设备的定向广播数据包
3: 接受所有广播数据包,除了广播者的身份地址不在白名单中且发起者的身份地址不针对此设备的定向广播数据包
- <duplicate_opt>:
扫描重复过滤选项
0: 禁用重复过滤
1: 启用重复过滤
2: 启用重复过滤,每个扫描周期重置
- <interval>:
扫描间隔
[0x4, 0x4000]
扫描间隔 = <interval> * 0.625ms, 范围 2.5ms 到 10.24s
- <window>:
扫描窗口
[0x4, 0x4000]
扫描窗口 = <window> * 0.625ms, 范围 2.5ms 到 10.24s
备注
扫描间隔不能小于扫描窗口
AT+BLEGAP=scan_info_filter
功能说明
打开或者关闭扫描信息过滤
命令格式
AT+BLEGAP=scan_info_filter,<op>[,<offset>,<filter_data>]
响应格式
GAP scan info filter set success
参数
- <op>:
打开或者关闭扫描信息过滤
0: 打开扫描信息过滤
1: 关闭扫描信息过滤
- <offset>:
过滤数据在扫描信息中的字节偏移量
- <filter_data>:
需要从扫描信息中过滤的字符串
AT+BLEGAP=scan
功能说明
开始或者停止扫描
命令格式
AT+BLEGAP=scan,<op>
响应格式
[APP] Scan started, scan_type: 1
[APP] Scan info, [Device]: 50:53:67:EC:9B:D3(random), AD evt type: 3, RSSI: -84, len: 31
或者
[APP] Scan stopped, reason: 0x0
参数
- <op>:
开始或者停止扫描
0: 开始扫描
1: 停止扫描
AT+BLEGAP=conn
功能说明
创建连接
命令格式
AT+BLEGAP=conn,<peer_addr_type>,<peer_addr>[,<own_addr_type>, <filter_policy>[,<scan_interval>,<scan_window>,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<supv_timeout>]]
响应格式
[APP] Connected, handle: 16, role: master, remote device: 00:E0:4C:80:04:06(public)
[APP] GATTC mtu exchange success, mtu_size: 180, conn_handle: 16
备注
如果 BLE 连线成功建立,对端设备会有如下提示:
[APP] ADV stopped: reason 0x1
[APP] Connected, handle: 24, role: slave, remote device: 00:E0:4C:80:0E:55(public)
[APP] GATTS mtu exchange successfully, mtu_size: 180, conn_handle: 24
参数
- <peer_addr_type>:
对等地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <filter_policy>:
连接过滤策略
0: 不使用白名单过滤
1: 使用白名单过滤
- <scan_interval>:
扫描间隔
[0x4, 0x4000]
扫描间隔 = <scan_interval> * 0.625ms, 范围 2.5ms 到 10.24s
- <scan_window>:
扫描窗口
[0x4, 0x4000]
扫描窗口 = <scan_window> * 0.625ms, 范围 2.5ms 到 10.24s
- <conn_interval_min>:
最小连接间隔
[0x6, 0x0C80]
最小连接间隔 = <conn_interval_min> * 1.25ms, 范围 7.5ms 到 4s
- <conn_interval_max>:
最大连接间隔
[0x6, 0x0C80]
最大连接间隔 = <conn_interval_max> * 1.25ms, 范围 7.5ms 到 4s
- <conn_latency>:
从机连接延迟(连接事件数)
[0, 0x01F3]
- <supv_timeout>:
LE 链路的监督超时
[0xa, 0x0C80]
监督超时 = <supv_timeout> * 10ms, 范围 100ms 到 32s
备注
扫描间隔不能小于扫描窗口
AT+BLEGAP=conn_cancel
功能说明
取消创建连接
命令格式
AT+BLEGAP=conn_cancel,<peer_addr_type>,<peer_addr>
响应格式
GAP create connection cancel success
[APP] Disconnected, reason: 0x116, handle: 16, role: master, remote device: 00:E0:4C:80:04:06(public)
[APP] GATTC Profiles detach connection success, conn_handle: 16
参数
- <peer_addr_type>:
对端地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BLEGAP=get_active_conn
功能说明
获取当前活跃的连接数量以及其连接句柄。
命令格式
AT+BLEGAP=get_active_conn
响应格式
GAP get active conn, num: 1, conn_handle: 16
参数
NULL
AT+BLEGAP=get_conn_handle
功能说明
通过对端地址获取连接句柄。
命令格式
AT+BLEGAP=get_conn_handle,<peer_addr_type>,<peer_addr>
响应格式
GAP get conn handle by addr: 16
参数
- <peer_addr_type>:
对端地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BLEGAP=mtu_size
功能说明
获取连线的 MTU 大小。
命令格式
AT+BLEGAP=mtu_size,<conn_handle>
响应格式
GAP get mtu size, conn_handle: 16, mtu_size: 180
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=tx_pending_num
功能说明
获取待发送 ACL 数据包的数量。
命令格式
AT+BLEGAP=tx_pending_num,<conn_handle>
响应格式
GAP get tx pending number, conn_handle: 16 tx_pending_num: 0
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=conn_rssi
功能说明
读取连线的 RSSI。
命令格式
AT+BLEGAP=conn_rssi,<conn_handle>
响应格式
GAP read rssi, conn_hanlde: 16, value: -48
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=conn_info
功能说明
获取连线信息。
命令格式
AT+BLEGAP=conn_info,<conn_handle>
响应格式
GAP get connection info:
conn_handle: 16, local role: master, peer bd_addr: (00:E0:4C:80:04:06(public)),
interval: 0x60, latency: 0x0, supv_timeout: 0x100, tx_phy: 0x1, rx_phy: 0x1
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=conn_update
功能说明
更新连线参数。
命令格式
AT+BLEGAP=conn_update,<conn_handle>,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<timeout>
响应格式
GAP updating connection parameters ...
[APP] Conn param is updated, conn_handle: 16, conn_interval: 0xfc, conn_latency: 0x2, supervision_timeout: 0x1f4
参数
- <conn_handle>:
连接句柄
- <conn_interval_min>:
最小连接间隔
[0x6, 0x0C80]
最小连接间隔 = <conn_interval_min> * 1.25ms, 范围 7.5ms 到 4s
- <conn_interval_max>:
最大连接间隔
[0x6, 0x0C80]
最大连接间隔 = <conn_interval_max> * 1.25ms, 范围 7.5ms 到 4s
- <conn_latency>:
从机连接延迟(连接事件数)
[0, 0x01F3]
- <supv_timeout>:
LE 链路的监督超时
[0xa, 0x0C80]
监督超时 = <supv_timeout> * 10ms, 范围 100ms 到 32s
AT+BLEGAP=conn_phy
功能说明
更新连线信道。
命令格式
AT+BLEGAP=conn_phy,<conn_handle>,<all_phy>,<tx_phy>,<rx_phy>,<phy_options>
响应格式
GAP setting connection PHY ...
[APP] PHY is updated, conn_handle: 16, tx_phy: 3, rx_phy: 3
参数
- <conn_handle>:
连接句柄
- <all_phy>:
所有 PHYs
[0, 3]
bit0 表示对 TX PHYs 没有偏好
bit1 表示对 RX PHYs 没有偏好
- <tx_phy>:
TX PHY
[0, 7]
bit0 表示 LE 1M PHY
bit1 表示 LE 2M PHY
bit2 表示 LE Coded PHY
- <rx_phy>:
RX PHY
[0, 7]
bit0 表示 LE 1M PHY
bit1 表示 LE 2M PHY
bit2 表示 LE Coded PHY
- <phy_options>:
LE Coded PHY 选项
[0, 2]
0: 使用 LE Coded PHY 时无偏好
1: 使用 LE Coded PHY 时偏好 S=2
2: 使用 LE Coded PHY 时偏好 S=8
AT+BLEGAP=conn_datalen
功能说明
设置连线数据长度。
命令格式
AT+BLEGAP=conn_datalen,<conn_handle>,<max_tx_octets>,<max_tx_time>
响应格式
GAP setting connection data len ...
[APP] Data len is updated, conn_handle: 16, max_tx_octets: 0x30, max_tx_time: 0x300, max_rx_octets: 0x40, max_rx_time: 0x270
参数
- <conn_handle>:
连接句柄
- <max_tx_octets>:
最大传输字节数
[0x1B, 0xFB]
- <max_tx_time>:
最大传输时间
[0x148, 0x4290]
AT+BLEGAP=disconn
功能说明
断开连线。
命令格式
AT+BLEGAP=disconn,<conn_handle>
响应格式
GAP disconnecting ...
[APP] Disconnected, reason: 0x116, handle: 16, role: master, remote device: 00:E0:4C:80:04:06(public)
[APP] GATTC Profiles detach connection success, conn_handle: 16
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=disconn_reason
功能说明
以某个原因断开连线。
命令格式
AT+BLEGAP=disconn_reason,<conn_handle>,<reason>
响应格式
GAP disconnecting with reason ...
[APP] Disconnected, reason: 0x116, handle: 16, role: master, remote device: 00:E0:4C:80:04:06(public)
[APP] GATTC Profiles detach connection success, conn_handle: 16
参数
- <conn_handle>:
连接句柄
- <reason>:
断线原因
AT+BLEGAP=wl_add
功能说明
添加设备到白名单。
命令格式
AT+BLEGAP=wl_add,<addr_type>,<addr>
响应格式
GAP whitelist add success
参数
- <addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <addr>:
要添加到白名单的地址
AT+BLEGAP=wl_remove
功能说明
从白名单中移除地址。
命令格式
AT+BLEGAP=wl_remove,<addr_type>,<addr>
响应格式
GAP whitelist remove success
参数
- <addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <addr>:
要从白名单中移除的地址
AT+BLEGAP=wl_clear
功能说明
清空白名单。
命令格式
AT+BLEGAP=wl_clear
响应格式
GAP get whitelist clear success
参数
NULL
AT+BLEGAP=pair_mode
功能说明
清空白名单。
命令格式
AT+BLEGAP=pair_mode,<mode>
响应格式
GAP set pairing mode success
参数
- <mode>:
配对模式
0: 无需配对
1: 需要配对
AT+BLEGAP=sec_param
功能说明
设置配对参数。
命令格式
AT+BLEGAP=sec_param[,<io_cap>,<oob_data_flag>,<bond>,<mitm>,<sec_pair>,<use_fixed_key>,<fixed_key>,<sec_pair_only>,<auto_sec_req>]
响应格式
GAP set security paramters success
参数
- <io_cap>:
输入/输出能力
0: 只有显示,无键盘或是/否键
1: 有显示和是/否键
2: 只有键盘,无显示
3: 无输入输出能力
4: 有键盘和显示
- <oob_data_flag>:
OOB 数据标志
默认全 0
- <bond>:
绑定标志
- <mitm>:
MITM 保护标志
- <sec_pair>:
安全配对标志
- <use_fixed_key>:
配对时使用固定密钥
0: 禁用(默认)
1: 启用
- <fixed_key>:
MITM 保护的固定密钥
[0, 999999]
默认为 0
- <sec_pair_only>:
仅安全配对标志
- <auto_sec_req>:
连接时自动发送 SMP 安全请求
0: 禁用(默认)
1: 启用
AT+BLEGAP=sec
功能说明
发起配对。
命令格式
AT+BLEGAP=sec,<conn_handle>
响应格式
GAP starting security flow ...
[APP] Bond info modified, op: 1, addr: 00:E0:4C:80:04:06(public), ident_addr: 00:00:00:00:00:00(public)
[APP] Pairing success, conn_handle: 16
[APP] long term key is 0x3d97ac347b2f586873504f51e6a09ea2
参数
- <conn_handle>:
连接句柄
AT+BLEGAP=pair_cfm
功能说明
确认仅工作配对指示。
命令格式
AT+BLEGAP=pair_cfm,<conn_handle>,<op>
响应格式
GAP pair confirm OK!
参数
- <conn_handle>:
连接句柄
- <op>:
确认配对指示
1: 接受
2: 拒绝
AT+BLEGAP=auth_key
功能说明
输入认证密钥。
命令格式
AT+BLEGAP=auth_key,<conn_handle>,<passkey>
响应格式
GAP input auth key OK!
参数
- <conn_handle>:
连接句柄
- <passkey>:
认证密钥
[0, 999999]
AT+BLEGAP=auth_keycfm
功能说明
确认认证密钥。
命令格式
AT+BLEGAP=auth_keycfm,<conn_handle>,<op>
响应格式
GAP auth key confirm OK!
参数
- <conn_handle>:
连接句柄
- <op>:
确认认证密钥
1: 接受
2: 拒绝
AT+BLEGAP=auth_oob
功能说明
输入 OOB 数据。
命令格式
AT+BLEGAP=auth_oob,<conn_handle>,<tk>
响应格式
GAP input auth OOB TK OK!
参数
- <conn_handle>:
连接句柄
- <tk>:
OOB 数据
AT+BLEGAP=bond_num
功能说明
获取绑定列表中的设备数量。
命令格式
AT+BLEGAP=bond_num
响应格式
GAP get bond number: 1
参数
NULL
AT+BLEGAP=bond_info
功能说明
获取绑定列表中的设备信息。
命令格式
AT+BLEGAP=bond_info
响应格式
GAP get bond info:
[0] 00:E0:4C:80:04:06(public), resolved: 00:00:00:00:00:00(public)
参数
NULL
AT+BLEGAP=bond_del
功能说明
删除绑定信息。
命令格式
AT+BLEGAP=bond_del,<addr_type>,<addr>
响应格式
[APP] Bond info modified, op: 0, addr: 00:E0:4C:80:04:06(public), ident_addr: 00:00:00:00:00:00(public)
GAP removing bond device ...
参数
- <addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <addr>:
要删除的地址
AT+BLEGAP=bond_clear
功能说明
清空绑定列表。
命令格式
AT+BLEGAP=bond_clear
响应格式
GAP clearing bond info ...
[APP] Bond info modified, op: 2, addr: 00:00:00:00:00:00(public), ident_addr: 00:00:00:00:00:00(public)
参数
NULL
AT+BLEGAP=set_privacy_mode
功能说明
清空绑定列表。
命令格式
AT+BLEGAP=set_privacy_mode,<ident_addr_type>,<peer_ident_addr>,<privacy_mode>
响应格式
GAP set privacy mode success
参数
- <ident_addr_type>:
身份地址类型
0: 公共身份地址类型
1: 随机身份地址类型
- <peer_ident_addr>:
对端身份地址
- <privacy_mode>:
隐私模式
0: 网络隐私模式
1: 设备隐私模式
AT+BLEGAP=read_local_rpa
功能说明
读取本地 RPA 地址。
命令格式
AT+BLEGAP=read_local_rpa[,<ident_addr_type>,<peer_ident_addr>]
响应格式
GAP read local rpa success, 72:7A:86:E2:24:B4
参数
- <ident_addr_type>:
身份地址类型
0: 公共身份地址类型
1: 随机身份地址类型
- <peer_ident_addr>:
对端身份地址
AT+BLEGAP=read_peer_rpa
功能说明
读取对端 RPA 地址。
命令格式
AT+BLEGAP=read_peer_rpa[,<ident_addr_type>,<peer_ident_addr>]
响应格式
GAP read peer rpa success, 72:7A:86:E2:24:B4
参数
- <ident_addr_type>:
身份地址类型
0: 公共身份地址类型
1: 随机身份地址类型
- <peer_ident_addr>:
对端身份地址
AT+BLEGAP=eadv_data
功能说明
设置扩展广播数据。
命令格式
AT+BLEGAP=eadv_data,<adv_handle>,<data_len>
响应格式
GAP set ext adv(0) data success
参数
- <adv_handle>:
广播句柄
[0, 0xEF]
- <data_len>:
广播数据的长度
AT+BLEGAP=escan_rsp
功能说明
设置扩展扫描响应数据。
命令格式
AT+BLEGAP=escan_rsp,<adv_handle>,<data_len>
响应格式
GAP set ext scan resp data(0) success
参数
- <adv_handle>:
广播句柄
[0, 0xEF]
- <data_len>:
扩展扫描响应数据的长度
AT+BLEGAP=eadv
功能说明
扩展广播相关操作。
命令格式
AT+BLEGAP=eadv,<op=0 or 3>,<adv_handle>
或者
AT+BLEGAP=eadv,<op=1>,<adv_handle>,<duration>
或者
AT+BLEGAP=eadv,<op=2>,<adv_sid>,<adv_prop>,<pri/sec PHY>,<filter_policy>,<tx_power>,<adv_interval_min>,<own_addr_type>,<own_rand_addr>,<peer_addr_type>,<peer_addr>
响应格式
创建一个扩展广播
GAP create ext adv success! adv handle: 0
开始扩展广播
GAP starting ext adv(0) ...
[APP] Ext ADV(0) started
停止扩展广播
GAP stopping ext adv(1) ...
[APP] Ext ADV(1) stopped: reason 0x0
移除一个扩展广播
GAP remove ext adv(0) success!
参数
- <op>:
扩展广播操作选项
0: 停止扩展广播
1: 开始扩展广播
2: 创建一个扩展广播
3: 移除一个扩展广播
- <adv_handle>:
广播句柄
[0, 0xEF]
- <duration>:
扩展广播持续时间
[0, 0xFFFF]
单位为 10ms, 0 表示无限制
- <adv_sid>:
广播 ID
[0, 0x0F]
- <adv_prop>:
广播属性
bit0: 可连接广播
bit1: 可扫描广播
bit2: 定向广播
bit3: 高占空比定向可连接广播
bit4: 使用传统广播 PDU
bit5: 所有 PDU 中不包含广播者的地址
bit6: 至少在一个广播 PDU 的扩展 Header 里包含 TxPower 字段
- <pri/sec PHY>:
主 PHY/从 PHY(不包含 0x 的十六进制数)
0x11: primary LE 1M PHY, secondary LE 1M PHY
0x13: primary LE 1M PHY, secondary LE Coded PHY
0x31: primary LE Coded PHY, secondary LE 1M PHY
0x33: primary LE Coded PHY, secondary LE Coded PHY
- <filter_policy>:
广播过滤策略
0: 处理所有设备的扫描和连接请求
1: 处理所有设备的连接请求,仅处理白名单中设备的扫描请求
2: 处理所有设备的扫描请求,仅处理白名单中设备的连接请求
3: 仅处理白名单中设备的扫描和连接请求
- <tx_power>:
发送功率 - [-127 dBm, 20 dBm] - 0x7F 表示 Host 对此设备的发送功率没有要求
- <adv_interval_min>:
最小广播间隔
[0x20, 0xFFFF]
广播间隔 = <adv_interval_min> * 0.625ms, 范围 20ms 到 10.24s
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <peer_addr_type>:
对端地址类型
0: 公共地址或者公共身份地址类型
1: 随机地址或者随机身份地址类型
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BLEGAP=escan_param
功能说明
设置扩展扫描参数。
命令格式
AT+BLEGAP=escan_param,<own_addr_type>,<filter_policy>,<duplicate_opt>[,<duration>,<period>,<scan_phys>[,<scan_type>, <interval>,<window>][,<scan_type>, <interval>,<window>]]
响应格式
GAP set scan param success
参数
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <filter_policy>:
扫描过滤策略
0: 接受所有广播数据包,除了是不针对此设备的定向广播数据包
1: 仅接受白名单中广播者地址的广播数据包。不针对此设备的定向广播数据包将被忽略
2: 接受所有广播数据包,除了发起者的身份地址不针对此设备的定向广播数据包
3: 接受所有广播数据包,除了广播者的身份地址不在白名单中且发起者的身份地址不针对此设备的定向广播数据包
- <duplicate_opt>:
扫描重复过滤选项
0: 禁用重复过滤
1: 启用重复过滤
2: 启用重复过滤,每个扫描周期重置
- <duration>:
扫描持续时间
[0, 0xFFFF]
单位为 10ms, 0 表示无限制
- <period>:
扫描周期 - [0, 0xFFFF] - 单位为 10ms, 0 表示无限制
- <scan_phys>:
扫描 PHYs
bit0: 在 1M PHY 上扫描
bit2: 在 Coded PHY 上扫描
- <scan_type>:
扫描类型
0: 被动扫描
1: 主动扫描
- <interval>:
扫描间隔
[0x4, 0xFFFF]
扫描间隔 = <interval> * 0.625ms, 范围 2.5ms 到 10.24s
- <window>:
扫描窗口
[0x4, 0xFFFF]
扫描窗口 = <window> * 0.625ms, 范围 2.5ms 到 10.24s
AT+BLEGAP=escan
功能说明
开始或停止扩展扫描。
命令格式
AT+BLEGAP=escan,<op>
响应格式
开始扩展扫描
GAP starting ext scan ...
[APP] Scan started, scan_type: 1
[APP] Ext Scan info, [Device]: 33:3F:D1:97:AF:47(random), AD evt type: 0x10, RSSI: -76, PHY: 0x10, TxPower: 127, Len: 31
[APP] Ext Scan info, [Device]: 62:6E:16:0C:B4:CE(random), AD evt type: 0x10, RSSI: -82, PHY: 0x10, TxPower: 127, Len: 31
停止扩展扫描
GAP stopping ext scan ...
[APP] Scan stopped, reason: 0x0
参数
- <op>:
开始或停止扩展扫描
0: 停止扩展扫描
1: 开始扩展扫描
AT+BLEGAP=econn
功能说明
发起扩展连接。
命令格式
AT+BLEGAP=econn,<peer_addr_type>,<peer_addr>,<init_phys>[,<own_addr_type>, <filter_policy>[,<scan_interval>,<scan_window>,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<supv_timeout>]]
响应格式
[APP] Connected, handle: 16, role: master, remote device: 00:E0:4C:80:04:06(public)
[APP] GATTC mtu exchange success, mtu_size: 180, conn_handle: 16
参数
- <peer_addr_type>:
对端地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <init_phys>:
发起连接时使用的 PHYs
bit0: 置 1 表示广播的主 PHYs 为 LE 1M PHY
bit1: 置 1 表示广播的主 PHYs 为 LE 2M PHY
bit2: 置 1 表示广播的主 PHYs 为 LE Coded PHY
- <own_addr_type>:
本地地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址类型
3: 随机身份地址类型
- <filter_policy>:
连接过滤策略
0: 不使用白名单过滤
1: 使用白名单过滤
- <scan_interval>:
扫描间隔
[0x4, 0x4000]
扫描间隔 = <scan_interval> * 0.625ms, 范围 2.5ms 到 10.24s
- <scan_window>:
扫描窗口
[0x4, 0x4000]
扫描窗口 = <scan_window> * 0.625ms, 范围 2.5ms 到 10.24s
- <conn_interval_min>:
最小连接间隔
[0x6, 0x0C80]
最小连接间隔 = <conn_interval_min> * 1.25ms, 范围 7.5ms 到 4s
- <conn_interval_max>:
最大连接间隔
[0x6, 0x0C80]
最大连接间隔 = <conn_interval_max> * 1.25ms, 范围 7.5ms 到 4s
- <conn_latency>:
从机连接延迟(连接事件数)
[0, 0x01F3]
- <supv_timeout>:
LE 链路的监督超时
[0xa, 0x0C80]
监督超时 = <supv_timeout> * 10ms, 范围 100ms 到 32s
AT+BLEGAP=pa_adv
功能说明
打开或者停止周期广播。
命令格式
AT+BLEGAP=pa_adv,<op>,<adv_handle>,<adv_interval_min>,<pa_prop>,<pa_data_len>
响应格式
打开周期广播
GAP starting periodic adv(0) ...
[APP] Periodic ADV(0) started
停止周期广播
GAP stopping periodic adv(0) ...
[APP] Periodic ADV(0) stopped
参数
- <op>:
周期广播操作选项
0: 停止周期广播, 只需要指定<adv_handle>
1: 开始周期广播
- <adv_handle>:
广播句柄
[0, 0xEF]
- <adv_interval_min>:
最小广播间隔
[0x6, 0xFFFF]
广播间隔 = <adv_interval_min> * 1.25ms, 范围 7.5ms 到 81.91875s
- <pa_prop>:
周期广播属性
0: 无
1: 包含 tx_power 字段
- <pa_data_len>:
周期广播数据长度
[0, 252]
AT+BLEGAP=pa_update
功能说明
更新周期广播数据。
命令格式
AT+BLEGAP=pa_update,<adv_handle>,<data>,<data_len>
响应格式
GAP update periodic adv(0) success
参数
- <adv_handle>:
广播句柄
[0, 0xEF]
- <data>:
周期广播数据, ASCII 编码的字符串
- <data_len>:
周期广播数据长度
[0, 252]
AT+BLEGAP=pa_sync_list
功能说明
操作周期广播列表。
命令格式
AT+BLEGAP=pa_sync_list,<op>,<adv_sid>,<addr_type>,<addr>
响应格式
GAP modify PA sync adv list Success!
参数
- <op>:
周期广播列表操作选项
0: 清空周期广播到列表, 不需要其它参数
1: 添加周期广播到列表
2: 从列表移除周期广播
- <adv_sid>:
广播 ID
[0, 0xF]
- <addr_type>:
地址类型
0: 公共地址或者公共身份地址类型
1: 随机地址或者随机身份地址类型
- <addr>:
要操作的地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BLEGAP=pa_sync
功能说明
创建或者停止周期广播同步。
命令格式
创建同步
AT+BLEGAP=pa_sync,<op=create><options>,<sync_cte_type>,<adv_sid>,<addr_type>,<addr>,<skip>,<sync_timeout>
停止同步
AT+BLEGAP=AT+BLEGAP=pa_sync,<op=terminate>,<sync_sid>
响应格式
创建同步
GAP PA sync create success, sync_id = 0!
[APP] PA sync state change: sync_id: 0, state = 3, cause: 0x0
停止同步
GAP PA sync terminate success, sync_id = 0!
[APP] PA sync state change: sync_id: 0, state = 0, cause: 0x116
参数
- <op>:
周期广播同步操作选项
0: 停止周期广播同步
1: 创建周期广播同步
- <options>:
同步选项
bit0: 0 表示使用<addr_type>和<addr>参数, 1 表示使用周期广播列表
bit1: 0 表示打开周期性报告, 1 表示关闭周期性报告
bit2: 0 表示关闭重复过滤, 1 表示打开重复过滤
- <sync_cte_type>:
周期性广播同步 CTE 类型的同步状态
bit0: 不与 AoA CTE 同步
bit1: 不与配置为 1us 时隙的 AoD CTE 数据包同步
bit2: 不与配置为 2us 时隙的 AoD CTE 数据包同步
bit3: 不与类型为 3 的 CTE 同步
bit4: 没有 CTE 时不同步
- <adv_sid>:
广播 ID
[0, 0xF]
- <addr_type>:
地址类型
0: 公共地址或者公共身份地址类型
1: 随机地址或者随机身份地址类型
- <addr>:
要操作的地址, 不包含 0x 的十六进制数, 例如 010203040506
- <skip>:
每次成功接收后可连续跳过的最多周期性广播包数量
[0, 0x01F3]
- <sync_timeout>:
周期性广播同步超时
[0xA, 0x4000]
超时 = <sync_timeout> * 10ms, 范围 100 ms to 163.84 s
- <sync_sid>:
周期性广播同步 ID
AT+BLEGAP=past_send
功能说明
周期性广播同步传输或设置信息传输。
命令格式
AT+BLEGAP=past_send,<conn_handle>,<service_data>,<use_sync_id>,<idx>
响应格式
GAP PAST transfer success!
参数
- <conn_handle>:
连接句柄
- <service_data>:
Host 用于标识周期性广播序列并传递给对端的标识值
[0, 0xFFFF]
- <use_sync_id>:
表示后续的<idx>参数是周期性广播同步 ID 还是周期性广播句柄
0: 同步传输,使用<adv_handle>标识周期广播,此时<idx>表示<adv_handle>
1: 设置信息传输,使用<sync_sid>标识周期广播,此时<idx>表示<sync_sid>
- <idx>:
周期性广播同步 ID 或周期性广播句柄
- <adv_handle>:
周期性广播句柄
[0, 0xEF]
- <sync_sid>:
周期性广播同步 ID
AT+BLEGAP=past_recv
功能说明
设置周期性广播同步传输参数。
命令格式
AT+BLEGAP=past_recv,<conn_handle>,<mode>,<cte_type>,<skip>,<sync_timeout>
响应格式
GAP PAST recipient set params success! conn_handle: 16
参数
- <conn_handle>:
连接句柄
- <mode>:
周期性广播同步接收模式
0: 不进行同步, 且不会向 Host 发送 sync_transfer_received 事件
1: 向 Host 发送 sync_transfer_received 事件, 禁用周期性广播报告
2: 向 Host 发送 sync_transfer_received 事件, 启用周期性广播报告, 并关闭重复过滤
3: 向 Host 发送 sync_transfer_received 事件, 启用周期性广播报告, 并打开重复过滤
- <cte_type>:
CTE 类型
bit0: 不与 AoA CTE 同步
bit1: 不与配置为 1us 时隙的 AoD CTE 数据包同步
bit2: 不与配置为 2us 时隙的 AoD CTE 数据包同步
bit3: 不与类型为 3 的 CTE 同步
bit4: 没有 CTE 时不同步
- <skip>:
每次成功接收后可连续跳过的最多周期性广播包数量 - [0, 0x01F3]
- <sync_timeout>:
周期性广播同步超时 - [0xA, 0x4000] - 超时 = <sync_timeout> * 10ms, 范围 100 ms 到 163.84 s
AT+BLEGAP=def_past_recv
功能说明
设置默认周期性广播同步传输参数。
命令格式
AT+BLEGAP=def_past_recv,<conn_handle>,<mode>,<cte_type>,<skip>,<sync_timeout>
响应格式
GAP PAST recipient set default params success!
参数
- <conn_handle>:
连接句柄
- <mode>:
周期性广播同步接收模式
0: 不进行同步, 且不会向 Host 发送 sync_transfer_received 事件
1: 向 Host 发送 sync_transfer_received 事件, 禁用周期性广播报告
2: 向 Host 发送 sync_transfer_received 事件, 启用周期性广播报告, 并关闭重复过滤
3: 向 Host 发送 sync_transfer_received 事件, 启用周期性广播报告, 并打开重复过滤
- <cte_type>:
CTE 类型
bit0: 不与 AoA CTE 同步
bit1: 不与配置为 1us 时隙的 AoD CTE 数据包同步
bit2: 不与配置为 2us 时隙的 AoD CTE 数据包同步
bit3: 不与类型为 3 的 CTE 同步
bit4: 没有 CTE 时不同步
- <skip>:
每次成功接收后可连续跳过的最多周期性广播包数量 - [0, 0x01F3]
- <sync_timeout>:
周期性广播同步超时 - [0xA, 0x4000] - 超时 = <sync_timeout> * 10ms, 范围 100 ms 到 163.84 s
AT+BLEGAP=txpower_read
功能说明
读取本地和对端设备的传输功率。
命令格式
AT+BLEGAP=txpower_read,<op>,<conn_handle>,<phy>
响应格式
Read local tx power Success! curr: 7, max: 7
参数
- <op>:
读取传输功率选项
0: 读取本地设备的传输功率
1: 读取对端设备的传输功率
- <conn_handle>:
连接句柄
- <phy>:
PHY 类型
0: LE 1M PHY
1: LE 2M PHY
2: LE Coded PHY S8
3: LE Coded PHY S2
AT+BLEGAP=txpower_report
功能说明
打开或者关闭本地和对端设备的传输功率变动报告。
命令格式
AT+BLEGAP=txpower_report,<conn_handle>,<local_enable>,<remote_enable>
响应格式
Tx power reporting set Success!
参数
- <conn_handle>:
连接句柄
- <local_enable>:
本地设备传输功率变动报告开关
0: 关闭
1: 打开
- <remote_enable>:
对端设备传输功率变动报告开关
0: 关闭
1: 打开
AT+BLEGAP=cte_conn_rx
功能说明
开始或者停止连线 CTE 接收。
命令格式
AT+BLEGAP=cte_conn_rx,<op>,<conn_handle>[,<cte_req_interval>,<req_cte_len>,<req_cte_type>,<slot_durations>,<num_ant_ids >[,…]]
响应格式
GAP connection cte rx start success
[APP] Connection IQ report: conn_handle 16, rx_phy 2, data_chan_index 31, rssi -480, rssi_antenna_id 0, cte_type 1, slot_durations 2, packet_status 0, connection_event_counter 142, sample_count 45
[APP] Connection IQ sample: 09 0a f8 f5 07 0c f9 f5 06 0c fb f4 04 0d fe f3
01 f3 05 f3 09 f5 0b f8 0d fc 0e 00 0e 04 0b 08
0a 09 07 0c 01 0e ff 0e fa 0c f7 0b f5 08 f3 04
f3 ff f3 fc f5 f8 f8 f5 fc f4 00 f3 03 f3 08 f5
0a f7 0c fa 0e fe 0e 01 0c 06 0a 09 08 0b 03 0d
00 0d fb 0d f8 0b f6 09 f3 04
参数
- <op>:
开始或者停止连线 CTE 接收
0: 开始连线 CTE 接收
1: 停止连线 CTE 接收
- <conn_handle>:
连接句柄
- <cte_req_interval>:
CTE 请求间隔
[0, 0xFFFF]
0: 只发起一次 CTE 请求
[1, 0xFFFF]: 每隔<cte_req_interval>个连接事件发起一次 CTE 请求
- <req_cte_len>:
CTE 请求长度
[0x2, 0x14]
- <req_cte_type>:
CTE 请求类型
bit0: AoA
bit1: AoD 1us
bit2: AoD 2us
- <slot_durations>:
CTE 时隙持续时间
1: 1us
2: 2us
- <num_ant_ids>:
天线 ID 数量
0: 不需要参数[,…]
[0x1, 0xC]: [,…] = <ant_id_0>[,<ant_id_1>,...]
AT+BLEGAP=cte_connless_rx
功能说明
开始或者停止无连线 CTE 接收。
命令格式
AT+BLEGAP=cte_connless_rx,<op>,<sync_id>[,<slot_durations>,<max_sampled_ctes>,<num_ant_ids>[,…]]
响应格式
GAP connectionless cte rx start success
[APP] Connectionless IQ report: sync_id 0, sync_handle 0x28, channel_index 26, rssi -520, rssi_antenna_id 0, cte_type 0, slot_durations 2, packet_status 0, periodic_event_counter 174, sample_count 9
[APP] Connectionless IQ sample: 0f f9 f1 06 10 fc f0 03 11 ff ef 00 11 02 f0 fd f2 f7
参数
- <op>:
开始或者停止无连线 CTE 接收
0: 开始无连线 CTE 接收
1: 停止无连线 CTE 接收
- <sync_id>:
周期性广播同步 ID
- <slot_durations>:
CTE 时隙持续时间
1: 1us
2: 2us
- <max_sampled_ctes>:
最大采样 CTE 数量
[0, 10]
0: 采样并报告所有 CTE
[1, 10]: 采样并报告最多<max_sampled_ctes>个 CTE
- <num_ant_ids>:
天线 ID 数量
0: 不需要参数[,…]
[0x1, 0xC]: [,…] = <ant_id_0>[,<ant_id_1>,...]
- <ant_id_0>:
天线 ID
[0, 0xFF]
AT+BLEGAP=get_antenna
功能说明
获取天线信息。
命令格式
AT+BLEGAP=get_antenna
响应格式
GAP get antenna information supported success, supported_switching_sampling_rates=7, num_antenna=4, max_switching_pattern_length=12, max_cte_length=20
参数
NULL
AT+BLEGAP=coc_reg_psm
功能说明
注册或注销用于 COC 的 LE PSM。
命令格式
AT+BLEGAP=coc_reg_psm,<op>,<le_psm>
响应格式
GAP coc reg or unreg psm success
参数
- <op>:
注册或者注销 LE PSM
1: 注册 LE PSM
0: 注销 LE PSM
- <le_psm>:
0x 开头的十六进制数, 例如 0x30
AT+BLEGAP=coc_set_sec
功能说明
设置或者取消用于 COC 的 LE PSM 加密。
命令格式
AT+BLEGAP=coc_set_sec,<op>,<le_psm>,<sec_mode>,<key_size>
响应格式
GAP coc set psm security success
参数
- <op>:
设置或者取消 LE PSM 加密
1: 设置 LE PSM 加密
0: 取消 LE PSM 加密
- <le_psm>:
0x 开头的十六进制数, 例如 0x30
- <sec_mode>:
加密模式
0: 不加密
1: 未认证加密
2: 认证加密
3: 未认证数据签名
4: 认证数据签名
5: 需要授权
- <key_size>:
key 的大小
AT+BLEGAP=coc_set_param
功能说明
设置 LE COC 的参数。
命令格式
AT+BLEGAP=coc_set_param,<param_type>,<value>
响应格式
GAP coc set param success
参数
- <param_type>:
参数类型
1: 本地 MTU
- <value>:
参数的值
AT+BLEGAP=coc_get_param
功能说明
获取 LE COC 信道信息。
命令格式
AT+BLEGAP=coc_get_param,<param_type>,<channel_id>
响应格式
GAP coc get chan param success, value: 0x40
参数
- <param_type>:
参数类型
0: 当前额度
1: 最大额度
2: 信道 MTU
- <channel_id>:
信道 ID, 0x 开头的十六进制数, 例如 0x40
AT+BLEGAP=coc_conn
功能说明
为 LE COC 使用指定的 LE PSM 创建 L2CAP 连接。
命令格式
AT+BLEGAP=coc_conn,<conn_handle>,<le_psm>
响应格式
GAP coc conncting ...
[APP] LE COC connected, conn_handle: 16, cid: 0x0
参数
- <conn_handle>:
连接句柄
- <le_psm>:
0x 开头的十六进制数, 例如 0x30
AT+BLEGAP=coc_disconn
功能说明
为 LE COC 通过信道 ID 断开 L2CAP 连接。
命令格式
AT+BLEGAP=coc_disconn,<channel_id>
响应格式
GAP coc disconnecting ...
[APP] LE COC disconnected, conn_handle: 16, cid: 0x0
参数
- <channel_id>:
信道 ID, 0x 开头的十六进制数, 例如 0x40
AT+BLEGAP=coc_send
功能说明
为 LE COC 通过信道 ID 在 L2CAP 信道中发送数据。
命令格式
AT+BLEGAP=coc_send,<channel_id>,<length>,<data>
响应格式
GAP coc data sending ...
[APP] LE COC send data completed, conn_handle: 16, cid: 0x0, credit: 0, err: 0x0
参数
- <channel_id>:
信道 ID, 0x 开头的十六进制数, 例如 0x40
- <length>:
数据长度
- <data>:
数据内容, 不包含 0x 的十六进制数, 例如 01020304
AT+BLEGAP=get_adv_param
功能说明
获取广播相关参数。
命令格式
AT+BLEGAP=get_adv_param
响应格式
GAP get adv param success, param: <type>,<own_addr_type>,<filter_policy>,<peer_addr_type>,<peer_addr>,<interval_min>,<interval_max>,<channel_map>
参数
参考 参数
AT+BLEGAP=get_scan_param
功能说明
获取扫描相关参数。
命令格式
AT+BLEGAP=get_scan_param
响应格式
GAP get scan param success, param: <type>,<own_addr_type>,<filter_policy>,<duplicate_opt>,<interval>,<window>
参数
参考 参数
AT+BLEGAP=get_sec_param
功能说明
获取加密相关参数。
命令格式
AT+BLEGAP=get_sec_param
响应格式
GAP get security paramters success, param: <io_cap>,<oob_data_flag>,<bond>,<mitm>,<sec_pair>,<use_fixed_key>,<fixed_key>,<sec_pair_only>,<auto_sec_req>
参数
参考 参数
BR GAP
AT+BRGAP=inquiry_start
功能说明
扫描周边设备。
命令格式
AT+BRGAP=inquiry_start,<limit_inquiry>,<timeout>
响应格式
BR GAP starting inquiry...
[BR GAP] Scan 99:88:77:44:55:66 Name Datatran_LEGACY
[BR GAP] Scan d0:39:57:df:0f:1a Name A311090515
[BR GAP] Scan f4:dd:06:5b:37:d5 Name Tizen_DevicePM1
参数
- <limit_inquiry>:
限制扫描
0: 无限制扫描
1: 限制扫描(暂未支持)
- <timeout>:
超时时间, 十进制数字,单位是秒
AT+BRGAP=disc
功能说明
断开 BR/EDR 连接。
命令格式
AT+BRGAP=disc,<peer_addr>
响应格式
BR GAP disconnecting to device 00:E0:4C:80:0E:41 ...
app_a2dp_bt_cback: BT_EVENT_A2DP_STREAM_CLOSE
[A2DP] Stream close from 00:e0:4c:80:0e:41
app_a2dp_bt_cback: A2DP Disconnected
[BT_AUDIO] sbc codec deinit
app_avr[cGpe_nTbrta_cckb-aIc]k : BT_EVtiEmNeT(_A1V3R1C0P3_9D9I37SC8O)N Nt_rCaMckP(L0 )
[GenTrack-I] time(1310399956) track(0)
[BT AUDIO] bt audio stream handle task exit
[BT_AUDIO] deinit complete !
[A2DP] A2DP disconnection completion with 00:e0:4c:80:0e:41
[AVRCP] Disconnection Completion
[AVRCP] AVRCP disconnection completion with 00:e0:4c:80:0e:41
[BR GAP] ACL disconnection 00:e0:4c:80:0e:41
[BR GAP] ACL disc cause 0x116
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BRGAP=cfg_page
功能说明
配置 Page Scan 参数。
命令格式
AT+BRGAP=cfg_page,<type>,<interval>,<window>
响应格式
cfg page type 0x00, interval 0x0800, window 0x0012
参数
- <type>:
扫描类型
0: 标准扫描
1: 交错扫描
- <interval>:
扫描间隔, 只有偶数值有效
[0x12, 0x1000]
广播间隔 = <interval> * 0.625ms, 范围 11.25 ms 到 25.6 s
- <window>:
扫描窗口, 只有偶数值有效
[0x11, 0x1000]
扫描窗口 = <window> * 0.625ms, 范围 10.625 ms 到 25.6 s
AT+BRGAP=cfg_inquiry
功能说明
配置 Inquiry Scan 参数。
命令格式
AT+BRGAP=cfg_inquiry,<type>,<interval>,<window>
响应格式
cfg inquiry type 0x00, interval 0x0800, window 0x0012
参数
- <type>:
扫描类型
0: 标准扫描
1: 交错扫描
- <interval>:
扫描间隔, 只有偶数值有效
[0x12, 0x1000]
广播间隔 = <interval> * 0.625ms, 范围 11.25 ms 到 25.6 s
- <window>:
扫描窗口, 只有偶数值有效
[0x11, 0x1000]
扫描窗口 = <window> * 0.625ms, 范围 10.625 ms 到 25.6 s
AT+BRGAP=sec_param
功能说明
配置加密参数。
命令格式
AT+BRGAP=sec_param[,<io_cap>,<oob_data_flag>,<bond>,<br_bond>,<mitm>,<sec_pair>,<br_sec_pair>]
响应格式
GAP set security paramters success
参数
- <io_cap>:
输入/输出能力
0: 只有显示,无键盘或是/否键
1: 有显示和是/否键
2: 只有键盘,无显示
3: 无输入输出能力
4: 有键盘和显示
- <oob_data_flag>:
OOB 数据标志
- <bond>:
绑定标志
- <br_bond>:
BR 绑定标志
- <mitm>:
MITM 保护标志
- <sec_pair>:
安全配对标志
- <br_sec_pair>:
BR 安全配对标志
AT+BRGAP=bond_clear
功能说明
配置加密参数。
命令格式
AT+BRGAP=bond_clear
响应格式
BR GAP clearing bond info...
参数
NULL
AT+BRGAP=radio_mode
功能说明
设置 BR/EDR 射频模式。
命令格式
AT+BRGAP=radio_mode,<mode>
响应格式
BR GAP seting radio mode ...
参数
- <io_cap>:
射频模式
1: 打开 Inquiry Scan 和 Page Scan
2: 只打开 Inquiry Scan
3: 只打开 Page Scan
4: 关闭 Inquiry Scan 和 Page Scan
AT+BRGAP=sniff_mode
功能说明
设置嗅探模式。
命令格式
AT+BRGAP=sniff_mode,<enable>,<peer_addr>[,<min_interval>,<max_interval>,<sniff_attempt>,<sniff_timeout>]
响应格式
bt_stack_br_gap_set_sniff_mode: enable
BR GAP seting sniff mode ...
参数
- <enable>:
打开或者关闭嗅探模式
0: 关闭嗅探模式
1: 打开嗅探模式
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <min_interval>:
嗅探间隔, 只有偶数值有效
[0x0002, 0xFFFE]
- <max_interval>:
嗅探间隔, 只有偶数值有效
[0x0002, 0xFFFE]
大于<min_interval>
- <sniff_attempt>:
单次嗅探尝试的基带接收时隙数
- <sniff_timeout>:
单次嗅探超时的基带接收时隙数
AT+BRGAP=bond_max_num
功能说明
获取协议栈支持的最大绑定数量。
命令格式
AT+BRGAP=bond_max_num
响应格式
Max bond num 8 ...
参数
NULL
AT+BRGAP=bond_num
功能说明
获取已经绑定的数量。
命令格式
AT+BRGAP=bond_num
响应格式
Bond num 0 ...
参数
NULL
AT+BRGAP=bond_key_get
功能说明
获取绑定密钥。
命令格式
AT+BRGAP=bond_key_get,<peer_addr>
响应格式
BR GAP Bond key: 92 85 b8 66 6c 6e 11 98 4f da f4 d8 ec 1c 20 6e
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BRGAP=bond_index_get
功能说明
获取绑定索引。
命令格式
AT+BRGAP=bond_index_get,<peer_addr>
响应格式
BR GAP Bond index 0x0
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BRGAP=bond_addr_get
功能说明
获取绑定地址。
命令格式
AT+BRGAP=bond_addr_get,<priority>
响应格式
BR GAP Bond addr 00:00:00:00:00:00
参数
- <priority>:
优先级,数字越小优先级越高
[0, <bond_num> - 1]
AT+BRGAP=bond_delete
功能说明
删除绑定信息。
命令格式
AT+BRGAP=bond_delete,<peer_addr>
响应格式
BR GAP Bond delete success
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
BLE GATTC
AT+BLEGATTC=disc
功能说明
发现服务,特征和描述符。
命令格式
AT+BLEGATTC=disc,<conn_handle>,<type>[,<start_handle>,<end_handle>,<uuid16/uuid128>]
响应格式
如果<discover_type>为 0, 响应如下:
[APP] GATTC discover primary result: start_handle: 0x0001, end_handle: 0x0006, UUID: 1801
[APP] GATTC discover primary result: start_handle: 0x0007, end_handle: 0x000f, UUID: 1800
[APP] GATTC discover primary result: start_handle: 0x0010, end_handle: 0x001b, UUID: a00a
[APP] GATTC discover primary result: start_handle: 0x001c, end_handle: 0x0039, UUID: 180a
[APP] GATTC discover primary result: start_handle: 0x003a, end_handle: 0x0041, UUID: 180d
[APP] GATTC discover primary result: start_handle: 0x0042, end_handle: 0x0045, UUID: 180f
[APP] GATTC discover primary result: start_handle: 0x0046, end_handle: 0x0048, UUID: 1802
[APP] GATTC discover primary result: start_handle: 0x0049, end_handle: 0x0054, UUID: 1808
[APP] GATTC discover primary result: start_handle: 0x0055, end_handle: 0xffff, UUID: fdffeedd-ccbb-aa99-8877-665544332211
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 0
如果<discover_type>为 1, 响应如下:
[APP] GATTC discover primary by uuid result: start_handle: 0x0001, end_handle: 0x0006
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 1
如果<discover_type>为 2, 响应如下:
[APP] GATTC discover include result: handle: 0x001d, start_handle: 0x0042, end_handle: 0x0045, UUID: 180f
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 2
如果<discover_type>为 3, 响应如下:
[APP] GATTC discover characteritic of a service result: handle: 0x0002, properties: 0x20, value_handle: 0x0003, UUID: 2a05
[APP] GATTC discover characteritic of a service result: handle: 0x0005, properties: 0x02, value_handle: 0x0006, UUID: 2b3a
[APP] GATTC discover characteritic of a service result: handle: 0x0008, properties: 0x0a, value_handle: 0x0009, UUID: 2a00
[APP] GATTC discover characteritic of a service result: handle: 0x000a, properties: 0x0a, value_handle: 0x000b, UUID: 2a01
......
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 3
如果<discover_type>为 4, 响应如下:
[APP] GATTC discover characteritic of a service result: handle: 0x001e, properties: 0x02, value_handle: 0x001f, UUID: 2a29
[APP] GATTC discover characteritic of a service result: handle: 0x0030, properties: 0x02, value_handle: 0x0031, UUID: 2a29
[APP] GATTC discover characteritic of a service result: handle: 0x0036, properties: 0x02, value_handle: 0x0037, UUID: 2a29
[APP] GATTC discover characteritic of a service result: handle: 0x0038, properties: 0x02, value_handle: 0x0039, UUID: 2a29
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 4
如果<discover_type>为 5, 响应如下:
[APP] GATTC discover discriptor all result: handle: 0x0001, UUID: 2800
[APP] GATTC discover discriptor all result: handle: 0x0002, UUID: 2803
[APP] GATTC discover discriptor all result: handle: 0x0003, UUID: 2a05
[APP] GATTC discover discriptor all result: handle: 0x0004, UUID: 2902
......
[APP] GATTC discover completed. profile_id: 0, conn_handle: 16, type: 5
参数
- <conn_handle>:
连接句柄
- <type>:
发现类型
0: 发现所有主服务
1: 根据服务 UUID 发现主服务
2: 查找包含的服务
3: 发现服务的所有特征
4: 根据 UUID 发现特征
5: 发现所有特征描述符
- <start_handle>:
发现范围的起始属性句柄
- <end_handle>:
发现范围的结束属性句柄
- <uuid16/uuid128>:
UUID 发现目标
- <included_service_handle>:
包含服务声明的句柄
- <characteristic_handle>:
特征声明句柄
- <properties>:
特征属性
- <value_handle>:
特征值属性句柄
- <descriptor_handle>:
特征描述符句柄
AT+BLEGATTC=read
功能说明
从服务端读取特征值。
命令格式
AT+BLEGATTC=read,<conn_handle>,<type>[,…]
响应格式
如果<type>为 0, 响应如下:
[APP] GATT client read result, profile_id: 0, conn_handle: 16, type: 0, status: 1, handle: 0x000b
[APP] GATTC read result:
52 54 4b 5f 42 54 5f 53 43 41 54 54 45 52 4e 45
54 00
[APP] GATTC read completed, profile_id: 0, conn_handle: 16, type: 0
如果<type>为 1, 响应如下:
[APP] GATT client read result, profile_id: 0, conn_handle: 16, type: 1, status: 1, handle: 0x0027
[APP] GATTC read result:
76 32 2e 31
[APP] GATTC read completed, profile_id: 0, conn_handle: 16, type: 1
参数
- <conn_handle>:
连接句柄
- <type>:
读取类型
0: 通过句柄读取特征值,[…]=<handle>
1: 通过特征 UUID 读取,[…]=<start_handle>,<end_handle>,<uuid16/uuid128>
2: 读取多个特征值(不支持)
3: 读取多个可变特征值,[…]=<handle_count>,<handles_arr_1>[,…]
AT+BLEGATTC=write
功能说明
向服务端写入特征值。
命令格式
AT+BLEGATTC=write,<conn_handle>,<type>,<handle>,<length>,<data>
响应格式
[APP] GATTC write completed, profile_id: 0, conn_handle: 16, type: 1, handle: 0x48
参数
- <conn_handle>:
连接句柄
- <type>:
写入类型
0: 写入特征值请求
1: 无响应写入特征值
2: 无响应且带签名数据写入特征值
- <handle>:
对端设备的属性句柄
- <length>:
写入数据的长度
- <data>:
写入的数据,不包含 0x 的十六进制数,如 0a0b
AT+BLEGATTC=en_cccd
功能说明
打开服务端特征的 CCCD。
命令格式
AT+BLEGATTC=en_cccd,<conn_handle>,<charac_value_handle>,<cccd_handle>,<cccd_val>
响应格式
[APP] GATTC enable cccd succeed, profile_id: 0, conn_handle: 16, handle: 0x1a
参数
- <conn_handle>:
连接句柄
- <charac_value_handle>:
特征值句柄
- <cccd_handle>:
CCCD 句柄
- <cccd_val>:
CCCD 值
1: 打开通知
2: 打开指示
3: 打开通知和指示
0: 关闭通知和指示
AT+BLEGATTC=dis_cccd
功能说明
关闭服务端特征的 CCCD。
命令格式
AT+BLEGATTC=dis_cccd,<conn_handle>,<charac_value_handle>,<cccd_handle>,<cccd_val>
响应格式
[APP] GATTC disable cccd succeed, profile_id: 0, conn_handle: 16, handle: 0x1a
参数
- <conn_handle>:
连接句柄
- <charac_value_handle>:
特征值句柄
- <cccd_handle>:
CCCD 句柄
- <cccd_val>:
CCCD 值
1: 打开通知
2: 打开指示
3: 打开通知和指示
0: 关闭通知和指示
AT+BLEGATTC=<bas_cmd>
功能说明
BAS 客户端用来执行服务操作。
命令格式
AT+BLEGATTC=<bas_cmd>,<conn_handle>[,<en/disable>]
参数
- <bas_cmd>:
BAS 相关命令
bas_disc: BAS 客户端发现所有服务, 无需[<en/disable>](当使用 ble_mgr lib 时, 不需要这个命令去发现)
bas_read_bat_lev: BAS 客户端读取电池等级的值, 无需[<en/disable>]
bas_set_notify: BAS 设置电池等级通知, 需要[<en/disable>]
- <conn_handle>:
连接句柄
- <en/disable>:
打开或者关闭电池等级通知
1: 打开电池等级通知
0: 关闭电池等级通知
备注
使用其它 bas_cmds 之前, 应该先使用 AT+BLEGATTC=bas_disc,…
AT+BLEGATTC=<gaps_cmd>
功能说明
GAPS 服务客户端用来执行服务操作。
命令格式
AT+BLEGATTC=<gaps_cmd>,<conn_handle>[,<char_index>]
参数
- <gaps_cmd>:
GAPS 相关命令
gaps_disc: GAPS 客户端发现服务信息, 无需[<char_index>](当使用 ble_mgr lib 时, 不需要这个命令去发现)
gaps_read_char: GAPS 客户端读取特征的值, 需要[<char_index>]
- <conn_handle>:
连接句柄
- <char_index>:
特征索引
0: 设备姓名特征
0: 设备外貌特征
2: 外围设备偏好的连接参数特征
备注
使用其它 gaps_cmds 之前, 应该先使用 AT+BLEGATTC=gaps_disc,…
AT+BLEGATTC=<simple_ble_cmd>
功能说明
简单 BLE 服务客户端用来执行服务操作。
命令格式
AT+BLEGATTC=<simple_ble_cmd>,<conn_handle>[,…]
参数
- <simple_ble_cmd>:
简单 BLE 服务相关命令
simble_disc: 简单 BLE 客户端发现服务信息, 无需[,…](当使用 ble_mgr lib 时, 不需要这个命令去发现)
simble_read: 简单 BLE 客户端读取特征 V0 的值, 无需[,…]
simble_write: 简单 BLE 客户端写特征 V1 的值, [,…] = <length>,<data>
simble_set_notify: 简单 BLE 客户端设置特征 V2 通知 CCCD, [,…] = <enable/disable>
simble_set_indicate: 简单 BLE 客户端设置特征 V3 指示 CCCD, [,…] = <enable/disable>
- <conn_handle>:
连接句柄
- <length>:
写入数据的长度
- <data>:
写入数据, 不包含 0x 的十六进制数
- <en/disable>:
打开或者关闭 CCCD
1: 打开 CCCD
0: 关闭 CCCD
备注
使用其它 simple_ble_cmd 之前, 应该先使用 AT+BLEGATTC=simble_disc,…
AT+BLEGATTC=<cte_cmd>
功能说明
CTE 服务客户端用来执行服务操作。
命令格式
AT+BLEGATTC=<cte_cmd>,<conn_handle>[,…]
参数
- <cte_cmd>:
CTE 服务相关命令
cte_disc: CTE 客户端发现服务信息, 无需[,…](当使用 ble_mgr lib 时, 不需要这个命令去发现)
cte_write: CTE 客户端写特征索引的值, [,…] = <char_index><length>,<data>
- <conn_handle>:
连接句柄
- <char_index>:
特征索引
0: 打开 CTE 特征
1: CTE 广播最小长度特征
2: CTE 广播最小传输数量特征
3: CTE 广播传输周期特征
4: CTE 广播间隔特征
5: CTE 广播信道特征
- <length>:
写入数据的长度
- <data>:
写入数据, 不包含 0x 的十六进制数
备注
使用其它 cte_write 之前, 应该先使用 AT+BLEGATTC=cte_disc,…
AT+BLEGATTC=disc(ble_mgr)
功能说明
发现服务,特征和描述符(基于 ble_mgr lib)。
命令格式
AT+BLEGATTC=disc,<conn_handle>
响应格式
[APP] BAS client discover all success
[APP] Battery Level handle is 0x0046.
[APP] Battery Level CCCD handle is 0x0047.
[APP] GAPS client discover all success
[APP] device name handle is 0x000b.
[APP] apperance handle is 0x000d.
[APP] PPCP handle is 0x000f.
[APP] central addr resolution handle is 0x0011.
[APP] Simple ble client discover all success
[APP] Read V0 handle is 0x0014.
[APP] Write V1 handle is 0x0017.
[APP] Notify V2 handle is 0x0019.
[APP] Indicate V3 handle is 0x001c.
[APP] Notify V2 CCCD handle is 0x001a.
[APP] Indicate V3 CCCD handle is 0x001d.
[APP] GATTC discover all finished: conn_handle: 16, is_success: 1, load_from_storage: 0
[APP] GATTC discover GATT service info: conn_handle: 16, is_found: 1, load_from_storage: 0
[APP] Server supported features: 0x01, support EATT.
参数
- <conn_handle>:
连接句柄
AT+BLEGATTC=read(ble_mgr)
功能说明
从服务端读取特征值(基于 ble_mgr lib)。
命令格式
AT+BLEGATTC=read,<conn_handle>,<type>[,…]
响应格式
如果<type>为 0, 响应如下:
GATTC Reading ...
[APP] GAPS client read device name: RTK_BT_SCATTERNET
如果<type>为 1, 响应如下:
GATTC Reading ...
[APP] Simple ble client read charac v0: Demo
参数
- <conn_handle>:
连接句柄
- <type>:
读取类型
0: 通过特征值句柄读取,[,…] = <handle>
1: 通过特征值句柄读取,[,…] = <start_handle>,<end_handle>,<uuid16>
- <handle>:
特征值句柄
- <start_handle>:
起始句柄
- <end_handle>:
停止句柄
- <uuid16>:
目标 UUID
AT+BLEGATTC=write(ble_mgr)
功能说明
向服务端写入特征值(基于 ble_mgr lib)。
命令格式
AT+BLEGATTC=write,<conn_handle>,<type>,<handle>,<length>,<data>
响应格式
GATTC Writing ...
参数
- <conn_handle>:
连接句柄
- <type>:
读取类型
0: 通过特征值句柄写入
1: 通过特征值句柄写入且无需响应
2: 通过特征值句柄签名写入
- <handle>:
特征值句柄
- <length>:
写入数据的长度
- <data>:
写入数据, 不包含 0x 的十六进制数
AT+BLEGATTC=en_cccd(ble_mgr)
功能说明
打开服务端特征的 CCCD(基于 ble_mgr lib)。
命令格式
AT+BLEGATTC=en_cccd,<conn_handle>,<srv_uuid16>,<char_uuid16>,<cccd_val>
响应格式
GATTC enable cccd going ...
[APP] Simple ble client enable char v2 notify succeed
参数
- <conn_handle>:
连接句柄
- <srv_uuid16>:
服务 UUID
- <char_uuid16>:
特征 UUID
- <cccd_val>:
CCCD 值
1: 打开通知
2: 打开指示
3: 打开通知和指示
0: 关闭通知和指示
AT+BLEGATTC=dis_cccd(ble_mgr)
功能说明
关闭服务端特征的 CCCD(基于 ble_mgr lib)。
命令格式
AT+BLEGATTC=dis_cccd,<conn_handle>,<srv_uuid16>,<char_uuid16>,<cccd_val>
响应格式
GATTC disable cccd going ...
[APP] Simple ble client disable char v2 notify succeed
参数
- <conn_handle>:
连接句柄
- <srv_uuid16>:
服务 UUID
- <char_uuid16>:
特征 UUID
- <cccd_val>:
CCCD 值
1: 打开通知
2: 打开指示
3: 打开通知和指示
0: 关闭通知和指示
BLE GATTS
AT+BLEGATTS=notify
功能说明
向远程客户端发送通知数据。
命令格式
AT+BLEGATTS=notify,<conn_handle>,<service_app_id>,<charac_index>,<length>,<data>
响应格式
[APP] Simple BLE notify succeed!
参数
- <conn_handle>:
连接句柄
- <service_app_id>:
服务应用 ID
- <charac_index>:
特征索引
- <length>:
通知数据的长度
- <data>:
通知数据,不包含 0x 的十六进制数, 例如: 0a0b
AT+BLEGATTS=indicate
功能说明
向远程客户端发送指示数据。
命令格式
AT+BLEGATTS=indicate,<conn_handle>,<service_app_id>,<charac_index>,<length>,<data>
响应格式
[APP] Simple BLE indicate succeed!
参数
- <conn_handle>:
连接句柄
- <service_app_id>:
服务应用 ID
- <charac_index>:
特征索引
- <length>:
指示数据的长度
- <data>:
指示数据,不包含 0x 的十六进制数, 例如: 0a0b
AT+BLEGATTS=cte_set_param
功能说明
设置 CTE 服务的参数。
命令格式
AT+BLEGATTS=cte_set_param,<param_type>,<param_value>
响应格式
[APP] Simple BLE indicate succeed!
参数
- <param_type>:
参数类型
0: 打开或者关闭无连线 CTE 传输
1: 打开或者关闭连线 CTE 传输
2: CTE 广播最小长度
3: CTE 广播最小传输数量
4: CTE 广播传输周期
5: CTE 广播间隔
6: CTE 广播信道
7: 无连线 CTE 类型
8: 连线 CTE 类型
9: 连线 CTE 传输的天线 ID
10: 无连线 CTE 传输的天线 ID
- <param_value>:
参数值
当<param_type>是 0 或者处于 2-8 时, <param_value>的值是数字
当<param_type>是 1 时, <param_value>的格式是<enable>,<conn_handle>,例如:1,16
当<param_type>是 9 或 10 时, <param_value>的格式是<num_ant_ids>,<ant_id_0>,<ant_id_1>,…,<ant_id_n>, 例如:3,0,1,2
AT+BLEGATTS=exch_mtu
功能说明
向对端设备发起交换 MTU 请求。
命令格式
AT+BLEGATTC=exch_mtu,<conn_handle>
参数
- <conn_handle>:
连接句柄
BLE Mesh
AT+BLEMESHSTACK=reset
功能说明
重置节点。
命令格式
AT+BLEMESHSTACK=reset
响应格式
[APP] Unprovisioned Device
参数
NULL
AT+BLEMESHSTACK=dev_info
功能说明
开始或停止打 Mesh Beacon 包。
命令格式
AT+BLEMESHSTACK=dev_info,<op>
响应格式
[APP] bt addr=0x00e04c8007bc type=0 rssi=-46 udb=0xbc07804ce000060708090a0b0c0d0e0f
[APP] bt addr=0x00e04c8007bc type=0 rssi=-46 prov=0xbc07804ce000060708090a0b0c0d0e0f
[APP] bt addr=0x00e04c8007bc type=0 rssi=-46 udb=0xbc07804ce000060708090a0b0c0d0e0f
[APP] bt addr=0x00e04c8007bc type=0 rssi=-46 prov=0xbc07804ce000060708090a0b0c0d0e0f
参数
- <op>:
1: 开始打 Mesh Beacon 包
0: 停止打 Mesh Beacon 包
AT+BLEMESHSTACK=list
功能说明
显示 Mesh 列表信息。
命令格式
AT+BLEMESHSTACK=list
响应格式
Mesh State: 0
#
Device UUID: 0xbc07804ce000060708090a0b0c0d0e0f
BTAddr: 0x00e04c8007bc
IVindex: 0-0x0
Seq: 0x000000
NodeAddr: 0x0000-1-42
Element: 0-42
Model: 0-0-0x0000ffff
Model: 1-1-0x000affff
Model: 2-2-0x0004ffff
Model: 3-3-0x0008ffff
Model: 4-4-0x0006ffff
Model: 5-5-0x0002ffff
Model: 6-6-0x1000ffff
Model: 7-7-0x1002ffff
Model: 8-8-0x1004ffff
Model: 9-9-0x1006ffff
Model: 10-10-0x1007ffff
Model: 11-11-0x1009ffff
参数
NULL
AT+BLEMESHSTACK=fn_init
功能说明
初始化 Friend 节点。
命令格式
AT+BLEMESHSTACK=fn_init,<lpn_num>,<queue_size>,<rx_window>
响应格式
NULL
参数
- <lpn_num>:
低功耗节点数量
- <queue_size>:
队列大小
- <rx_window>:
接收的窗口大小
AT+BLEMESHSTACK=fn_deinit
功能说明
反初始化 Friend 节点。
命令格式
AT+BLEMESHSTACK=fn_deinit
响应格式
NULL
参数
NULL
AT+BLEMESHSTACK=pbadvcon
功能说明
和未配网的设备建立 PB-ADV 连接。
命令格式
AT+BLEMESHSTACK=pbadvcon,<device_uuid>
响应格式
[APP] PB-ADV Link Opened!
参数
- <device_uuid>:
设备 UUID, 不包含 0x 的十六个字节的十六进制数, 例如 D803804CE000060708090A0B0C0D0E0F
AT+BLEMESHSTACK=pbadvdiscon
功能说明
关闭 PB-ADV 连接。
命令格式
AT+BLEMESHSTACK=pbadvcon,<device_uuid>
响应格式
对端设备响应:
[APP] PB-ADV link closed
参数
NULL
AT+BLEMESHSTACK=gatt_con
功能说明
和未配网的设备建立 PB-GATT 连接。
命令格式
AT+BLEMESHSTACK=gatt_con,<addr_type>,<addr>
响应格式
[APP] Connected, handle: 16, role: master, remote device: 00:E0:4C:80:0E:41(public)
参数
- <addr_type>:
地址类型
0: 公共地址
1: 随机地址
- <addr>:
对端的地址, 不包含 0x 的十六进制数
AT+BLEMESHSTACK=gatt_discon
功能说明
断开 PB-GATT 连接。
命令格式
AT+BLEMESHSTACK=gatt_discon,<conn_handle>
响应格式
[APP] Disconnected, reason: 0x116, handle: 16, role: master, remote device: 00:E0:4C:80:0E:41(public)
参数
- <conn_handle>:
连接句柄
AT+BLEMESHSTACK=prov
功能说明
给一个未配网设备发起配网。
命令格式
AT+BLEMESHSTACK=prov[,<attention>]
响应格式
[APP] PB-ADV Link Closed!
[APP] Provisioning complete,unicast address:0x100
参数
- <attention>:
配网的 attention 信号
AT+BLEMESHSTACK=prov_dis
功能说明
发现未配网设备的配网服务。
命令格式
AT+BLEMESHSTACK=prov_dis,<conn_handle>
响应格式
[APP] Prov service discovery done!
参数
- <conn_handle>:
连接句柄
AT+BLEMESHSTACK=prov_choose
功能说明
选择一个方法来配网。
命令格式
AT+BLEMESHSTACK=prov_choose,<algorithm>,<public_key>,<auth_method>,<oob_action>,<oob_size>
响应格式
NULL
参数
- <algorithm>:
认证算法
- <public_key>:
交换公钥
- <auth_method>:
认证方法
- <oob_action>:
认证过程的 OOB 动作
- <oob_size>:
认证过程的 OOB 大小
AT+BLEMESHSTACK=prov_notify
功能说明
打开或者关闭配网服务的通知。
命令格式
AT+BLEMESHSTACK=prov_notify,<is_enable>
响应格式
NULL
参数
- <is_enable>:
1: 打开通知
0: 关闭通知
AT+BLEMESHSTACK=proxy_dis
功能说明
发现已配网设备的代理服务。
命令格式
AT+BLEMESHSTACK=proxy_dis,<conn_handle>
响应格式
[APP] Proxy service discovery done!
参数
- <conn_handle>:
连接句柄
AT+BLEMESHSTACK=proxy_notify
功能说明
打开或者关闭代理服务的通知
命令格式
AT+BLEMESHSTACK=proxy_notify,<is_enable>
响应格式
[APP] Proxy service discovery done!
参数
- <is_enable>:
1: 打开通知
0: 关闭通知
AT+BLEMESHSTACK=lpn_init
功能说明
初始化低功耗节点
命令格式
AT+BLEMESHSTACK=lpn_init,<fn_num>
响应格式
NULL
参数
- <fn_num>:
Friend 节点的数量
AT+BLEMESHSTACK=lpn_req
功能说明
启动与 Friend 节点建立 Friendship 过程
命令格式
AT+BLEMESHSTACK=lpn_init,<fn_num>
响应格式
[APP] Established friendship with FN: 0x0100 success
参数
- <fn_num>:
Friend 节点的数量
AT+BLEMESHSTACK=lpn_sub
功能说明
向 Friend 节点增加/移除订阅地址
命令格式
AT+BLEMESHSTACK=lpn_sub,<fn_index>,<addr>,<add_rm>
响应格式
[APP] Established friendship with FN: 0x0100 success
参数
- <fn_index>:
Friend 节点索引
- <addr>:
组地址, 包含 0x 的 2 个字节的十六进制数, 例如 0xc001
- <add_rm>:
添加或移除
1: 添加
0: 移除
AT+BLEMESHSTACK=lpn_clear
功能说明
清除与 Friend 节点的 Friendship
命令格式
AT+BLEMESHSTACK=lpn_clear,<fn_index>
响应格式
[APP] Lost friendship with FN: 0x0100
参数
- <fn_index>:
Friend 节点索引
AT+BLEMESHSTACK=lpn_deinit
功能说明
反初始化低功耗节点
命令格式
AT+BLEMESHSTACK=lpn_deinit
响应格式
NULL
参数
NULL
AT+BLEMESHSTACK=random
功能说明
设置配网过程的随机值
命令格式
AT+BLEMESHSTACK=random,<value>
响应格式
NULL
参数
- <value>:
随机值
AT+BLEMESHSTACK=hb_sub
功能说明
获取本地已收心跳消息订阅统计。
命令格式
AT+BLEMESHSTACK=hb_sub
响应格式
[atcmd_ble_mesh_get_hb_subscribe_result] Src:0x0, dst:0x0, period:0, count:0, min_hops:0, max_hops:0
参数
NULL
AT+BLEMESHSTACK=model_sub
功能说明
为本地模型订阅地址。
命令格式
AT+BLEMESHSTACK=model_sub,<element_index>,<model_id>,<sub_addr>
响应格式
NULL
参数
- <element_index>:
本地模型的元素索引
- <model_id>:
本地模型 ID
- <sub_addr>:
订阅地址
AT+BLEMESHSTACK=retran_set
功能说明
设置 Mesh 重传参数。
命令格式
AT+BLEMESHSTACK=retran_set,<ttl>,<relay_retrans_count>,<net_retrans_count>,<trans_retrans_count>
响应格式
Set node net trans count 3, relay retrans count 2, ttl 6, trans retrans count 1, Success!
参数
- <ttl>:
消息最多可以跳多少次
0 & [2, 127]
- <relay_retrans_count>:
再重发消息的次数
[0, 7]
- <net_retrans_count>:
发出网络消息时重发的次数
[0, 7]
- <trans_retrans_count>:
传输层未收到对方 ACK 确认时自动重传的次数
[0, 10]
AT+BLEMESHSTACK=set_txphy
功能说明
设置 Mesh 传输信道。
命令格式
AT+BLEMESHSTACK=set_txphy,<tx_phy>
响应格式
Set node net trans count 3, relay retrans count 2, ttl 6, trans retrans count 1, Success!
参数
- <tx_phy>:
传输信道
0x01: 传统 1M 信道
0x02: 传统 Coded 信道 S2
0x04: 传统 Coded 信道 S8
0x08: 扩展 1M & 1M 信道
0x10: 扩展 2M & 2M 信道
AT+BLEMESHSTACK=prov_s
功能说明
设置 Mesh 配网参数。
命令格式
AT+BLEMESHSTACK=prov_s,<unicast_addr>,<net_key>,<app_key>[,<dev_key>]
响应格式
NULL
参数
- <unicast_addr>:
单播地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key>:
网络密钥, 不包含 0x 的 16 字节十六进制数, 例如 1234804CE000060708090A0B0C0D0E0F
- <app_key>:
应用密钥, 不包含 0x 的 16 字节十六进制数, 例如 5678804CE000060708090A0B0C0D0E0F
- <dev_key>:
设备密钥, 不包含 0x 的 16 字节十六进制数, 例如 ABCD804CE000060708090A0B0C0D0E0F
AT+BLEMESHCONFIG=aka
功能说明
添加应用密钥。
命令格式
AT+BLEMESHCONFIG=aka,<unicast_addr>,<net_key_index>,<app_key_index>
响应格式
[APP] Config client model receive Config AppKey Status message with status SUCCESS
参数
- <unicast_addr>:
单播地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <app_key_index>:
应用密钥索引
AT+BLEMESHCONFIG=mab
功能说明
给模型绑定密钥。
命令格式
AT+BLEMESHCONFIG=mab,<dst>,<element_addr>,<model_id>,<app_key_index>
响应格式
[APP] Config client model receive Config Model App Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <app_key_index>:
应用密钥索引
AT+BLEMESHCONFIG=msa
功能说明
给模型订阅组地址。
命令格式
AT+BLEMESHCONFIG=msa,<dst>,<element_addr>,<model_id>,<group_addr>
响应格式
[APP] Config client model receive Config Model Subscription Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <group_addr>:
组地址
-[0xC000, 0xFEFF]
AT+BLEMESHCONFIG=ttl_get
功能说明
获取模型 TTL 信息。
命令格式
AT+BLEMESHCONFIG=ttl_get,<dst>
响应格式
[rpl_cb]: Lower Seq, loop 0, src 0x0100, iv index 0x0, msg seq 0x000000, rpl seq 0x000000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=ttl_set
功能说明
设置模型 TTL 信息。
命令格式
AT+BLEMESHCONFIG=ttl_set,<dst>,<ttl>
响应格式
[APP] Config client model receive message:default TTL:5
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <ttl>:
设置的 ttl
[0x00, 0x7F]
0xFF 表示使用默认值
AT+BLEMESHCONFIG=relay_get
功能说明
获取设备中转状态。
命令格式
AT+BLEMESHCONFIG=relay_get,<dst>
响应格式
[APP] Config client model receive message,Relay State: 1, Count = 2 Step = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=relay_set
功能说明
设置设备中转状态。
命令格式
AT+BLEMESHCONFIG=relay_set,<dst>,<state>,<count>,<steps>
响应格式
[APP] Config client model receive message,Relay State: 1, Count = 2 Step = 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <state>:
1: 打开设备中转
0: 关闭设备中转
- <count>:
重传次数
[0, 7]
- <steps>:
重传之间的间隔时间
[0b000000, 0b111111]
AT+BLEMESHCONFIG=net_trans_get
功能说明
获取节点网络重传状态。
命令格式
AT+BLEMESHCONFIG=net_trans_get,<dst>
响应格式
[APP] Config client model receive message,Net transmit state: Count = 6 Step = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=net_trans_set
功能说明
获取节点网络重传状态。
命令格式
AT+BLEMESHCONFIG=net_trans_set,<dst>,<count>,<steps>
响应格式
[APP] Config client model receive message,Net transmit state: Count = 2 Step = 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <count>:
重传次数
[0, 7]
- <steps>:
重传之间的间隔时间
[0b000000, 0b111111]
AT+BLEMESHCONFIG=reset
功能说明
重置一个已配网设备。
命令格式
AT+BLEMESHCONFIG=reset,<dst>
响应格式
对端设备响应:
[APP] Unprovisioned Device
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=beacon_get
功能说明
获取设备节点信标状态。
命令格式
AT+BLEMESHCONFIG=beacon_get,<dst>
响应格式
[APP] beacon state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=beacon_set
功能说明
设置设备节点信标状态。
命令格式
AT+BLEMESHCONFIG=beacon_set,<dst>,<state>
响应格式
[APP] beacon state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <state>:
0: 不广播安全网络信标
1: 广播安全网络信标
AT+BLEMESHCONFIG=compo_data_get
功能说明
获取设备节点组成数据。
命令格式
AT+BLEMESHCONFIG=compo_data_get,<dst>,<page>
响应格式
[APP] Config client model receive message:COMPO DATA STAT SUCCESS
cdp0 parsed: src=0x0101 cid=0x005d pid=0x0000 vid=0x0000 rpl=20 features=0x000f
element 0: loc=0 sig=41 vendor=1
s: 0x0000ffff 0x000affff 0x0004ffff 0x0008ffff 0x0006ffff 0x0002ffff 0x1000ffff 0x1002ffff 0x1004ffff 0x1006ffff 0x1007ffff 0x1009ffff 0x100affff 0x100cffff 0x100effff 0x100fffff 0x1011ffff 0x1012ffff 0x1013ffff 0x1014ffff 0x1100ffff 0x1101ffff 0x1200ffff 0x1201ffff 0x1203ffff 0x1204ffff 0x1206ffff 0x1207ffff 0x1300ffff 0x1301ffff 0x1303ffff 0x1304ffff 0x1306ffff 0x1307ffff 0x1308ffff 0x130affff 0x130bffff 0x130cffff 0x130dffff 0x130fffff 0x1310ffff
v: 0x0004005d
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <page>:
始终为 0
AT+BLEMESHCONFIG=proxy_get
功能说明
获取设备节点代理状态。
命令格式
AT+BLEMESHCONFIG=proxy_get,<dst>
响应格式
[APP] provisoner receive proxy state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=proxy_set
功能说明
设置设备节点代理状态。
命令格式
AT+BLEMESHCONFIG=proxy_set,<dst>,<state>
响应格式
[APP] provisoner receive proxy state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <state>:
代理状态
0: Mesh 代理服务正在运行, 代理功能关闭
1: Mesh 代理服务正在运行, 代理功能打开
2: 不支持 Mesh 代理服务和代理功能
AT+BLEMESHCONFIG=pub_get
功能说明
获取设备节点模型的发布地址。
命令格式
AT+BLEMESHCONFIG=pub_get,<dst>,<element_addr>,<model_id>
响应格式
[APP] Pub stat: pub addr = 0x0000, ttl = 7, period steps:0, period resolution:0, retrans count:0, retrans steps:0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
AT+BLEMESHCONFIG=pub_set
功能说明
设置设备节点模型的发布地址和其它参数。
命令格式
AT+BLEMESHCONFIG=pub_set,<dst>,<element_addr>,<model_id>,<pub_addr>,<app_key_index>,<frnd_flag>,<ttl>,<steps>,<resolution>,<count>,<retran_steps>
响应格式
[APP] Generic on off client model receive message: src = 0x100, present = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <pub_addr>:
发布地址, 包含 0x 的 2 个字节的十六进制数, 例如 0xc001
[0x0000, 0x7FFF] & [0xC000, 0xFFFF]
- <app_key_index>:
应用密钥索引
- <frnd_flag>:
密钥材料选择标志
0: 使用 Master 安全材料发布
1: 使用 Friendship 安全材料发布
- <ttl>:
消息发布的 TTL
[0x00, 0x7F]
0xFF 表示使用默认 TTL
- <steps>:
周期步数
0x00: 禁用周期发布
[0x01, 0x3F]
- <resolution>:
周期步数的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <count>:
重传次数
[0, 7]
- <retran_steps>:
重传间隔
[0b000000, 0b111111]
AT+BLEMESHCONFIG=msd
功能说明
删除模型描述组地址。
命令格式
AT+BLEMESHCONFIG=msd,<dst>,<element_addr>,<model_id>,<group_addr>
响应格式
[APP] Config client model receive Config Model Subscription Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <group_addr>:
组地址, 包含 0x 的 2 字节十六进制数, 例如 0xc001
[0xC000, 0xFEFF]
AT+BLEMESHCONFIG=msda
功能说明
删除模型所有描述组地址。
命令格式
AT+BLEMESHCONFIG=msd,<dst>,<element_addr>,<model_id>,<group_addr>
响应格式
[APP] Config client model receive Config Model Subscription Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
AT+BLEMESHCONFIG=mso
功能说明
覆写模型描述组地址。
命令格式
AT+BLEMESHCONFIG=mso,<dst>,<element_addr>,<model_id>,<group_addr>
响应格式
[APP] Config client model receive Config Model Subscription Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <group_addr>:
组地址, 包含 0x 的 2 字节十六进制数, 例如 0xc001
[0xC000, 0xFEFF]
AT+BLEMESHCONFIG=msg
功能说明
获取模型描述组地址。
命令格式
AT+BLEMESHCONFIG=msg,<dst>,<element_addr>,<model_id>
响应格式
[APP] Config client model receive message:MODEL SUB LIST SUCCESS
Model sub list: src 0x0102 element idx 0 model id 0x1000ffff
c002
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
AT+BLEMESHCONFIG=nka
功能说明
添加网络密钥。
命令格式
AT+BLEMESHCONFIG=nka,<dst>,<net_key_index>
响应格式
[APP] Success!
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHCONFIG=nku
功能说明
更新网络密钥。
命令格式
AT+BLEMESHCONFIG=nku,<dst>,<net_key_index>,<net_key>
响应格式
[APP] Success!
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key>:
网络密钥, 不包含 0x 的 16 字节十六进制数, 例如 12345678912345678912345678912345
AT+BLEMESHCONFIG=nkd
功能说明
删除网络密钥。
命令格式
AT+BLEMESHCONFIG=nkd,<dst>,<net_key_index>
响应格式
[APP] Success!
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHCONFIG=nkg
功能说明
获取网络密钥。
命令格式
AT+BLEMESHCONFIG=nkg,<dst>
响应格式
[APP] Config client model receive message:NET_KEY_LIST SUCCESS
NetKey List: num = 1!
0000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=aku
功能说明
更新应用密钥。
命令格式
AT+BLEMESHCONFIG=aku,<dst>,<net_key_index>,<app_key_index>,<app_key>
响应格式
ret:0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <app_key_index>:
应用密钥索引
- <app_key>:
应用密钥
AT+BLEMESHCONFIG=akd
功能说明
删除应用密钥。
命令格式
AT+BLEMESHCONFIG=akd,<dst>,<net_key_index>,<app_key_index>
响应格式
[APP] Config client model receive Config AppKey Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <app_key_index>:
应用密钥索引
AT+BLEMESHCONFIG=akg
功能说明
获取应用密钥。
命令格式
AT+BLEMESHCONFIG=akd,<dst>,<net_key_index>
响应格式
[APP] Config client model receive message:APP_KEY_LIST SUCCESS
AppKey List: NetKeyIndex = 0x000 num = 0!
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHCONFIG=node_identity_get
功能说明
获取节点身份状态。
命令格式
AT+BLEMESHCONFIG=node_identity_get,<dst>,<net_key_index>
响应格式
[APP] Node identity state: 0 on NetKeyIndex 0x000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHCONFIG=node_identity_set
功能说明
设置节点身份状态。
命令格式
AT+BLEMESHCONFIG=node_identity_set,<dst>,<net_key_index>,<identity>
响应格式
[APP] Node identity state: 1 on NetKeyIndex 0x000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <identity>:
身份标识
0: 子网的节点身份标识已停止
1: 子网的节点身份标识正在运行
2: 不支持子网的节点身份标识
AT+BLEMESHCONFIG=maub
功能说明
解绑模型应用密钥。
命令格式
AT+BLEMESHCONFIG=maub,<dst>,<element_addr>,<model_id>,<app_key_index>
响应格式
[APP] Config client model receive Config Model App Status message with status SUCCESS
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
- <app_key_index>:
应用密钥索引
AT+BLEMESHCONFIG=mag
功能说明
获取模型应用密钥。
命令格式
AT+BLEMESHCONFIG=mag,<dst>,<element_addr>,<model_id>
响应格式
[APP] Config client model receive message:MODEL_APP_LIST SUCCESS
Model AppKey List: Element Index = 0 model id = 0x1000ffff num = 0!
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <element_addr>:
元素地址, 例如 0, 1, 2
- <model_id>:
模型 ID
AT+BLEMESHCONFIG=frg
功能说明
获取 Friend 状态。
命令格式
AT+BLEMESHCONFIG=frg,<dst>
响应格式
[APP] frnd state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=frs
功能说明
设置 Friend 状态。
命令格式
AT+BLEMESHCONFIG=frs,<dst>,<state>
响应格式
[APP] frnd state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=lptg
功能说明
获取 LPN 轮询超时状态。
命令格式
AT+BLEMESHCONFIG=lptg,<dst>,<lpn_addr>
响应格式
[APP] frnd state: 1
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lpn_addr>:
LPN 地址, 包含 0x 的 2 字节十六进制数, 例如 0x0101
AT+BLEMESHCONFIG=krpg
功能说明
获取密钥刷新阶段。
命令格式
AT+BLEMESHCONFIG=krpg,<dst>,<net_key_index>
响应格式
[APP] Node 0x0102: NetKeyIndex = 0x000 state = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHCONFIG=krps
功能说明
设置密钥刷新阶段。
命令格式
AT+BLEMESHCONFIG=krps,<dst>,<net_key_index>,<state>
响应格式
[APP] Node 0x0102: NetKeyIndex = 0x000 state = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <state>:
刷新状态
0: 未激活刷新密钥过程
1: 刷新密钥过程第一阶段
2: 刷新密钥过程第二阶段
AT+BLEMESHCONFIG=hpg
功能说明
获取发布的心跳消息。
命令格式
AT+BLEMESHCONFIG=hpg,<dst>
响应格式
[APP] Hb: pub dst = 0x0000 count_log:0, period_log:0, ttl = 0 NetKeyIndex = 0x000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=hps
功能说明
设置发布心跳消息。
命令格式
AT+BLEMESHCONFIG=hps,<dst>,<net_key_index>,<dst_pub>,<count_log>,<period_log>,<ttl>,<relay>,<proxy>,<frnd>,<lpn>
响应格式
[APP] Hb: pub dst = 0x0101 count_log:1, period_log:1, ttl = 3 NetKeyIndex = 0x000
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <dst_pub>:
心跳消息发布目标地址 包含 0x 的 2 字节十六进制数, 例如 0x0101
- <count_log>:
心跳消息发送次数
0: 心跳消息没有被周期发送
[0x01, 0x11], 剩余未被发送的心跳消息数量=2^(n-1)
0xFF: 心跳消息被立即发送
- <period_log>:
周期发送间隔
0: 心跳消息没有被周期发送
[0x01, 0x11], 发送周期=2^(n-1)
- <ttl>:
消息发布的 TTL
[0x00, 0x7F]
- <relay>:
中转状态变化时是否生成心跳消息
0: 否
1: 是
- <relay>:
代理状态变化时是否生成心跳消息
0: 否
1: 是
- <frnd>:
Friendship 状态变化时是否生成心跳消息
0: 否
1: 是
- <lpn>:
LPN 状态变化时是否生成心跳消息
0: 否
1: 是
AT+BLEMESHCONFIG=hsg
功能说明
获取心跳订阅消息。
命令格式
AT+BLEMESHCONFIG=hsg,<dst>
响应格式
[APP] Hb: sub src = 0x0000 dst = 0x0000 period_log = 0 count_log = 0
参数
- <dst>:
节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHCONFIG=hss
功能说明
设置心跳订阅消息。
命令格式
AT+BLEMESHCONFIG=hss,<dst>,<src>,<dst_set>,<period_log>
响应格式
[APP] Hb: sub src = 0x0000 dst = 0x0000 period_log = 0 count_log = 0 hops range = [0, 0]
参数
- <dst>:
配置目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <src>:
来源节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0101
- <dst_set>:
订阅地址, 包含 0x 的 2 字节十六进制数, 例如 0x0102
- <period_log>:
订阅持续周期
0x00: 不订阅心跳消息;关闭心跳消息统计处理
[0x01, 0x11]: 以 2^(n-1)秒为单位反映订阅处理窗口的“剩余周期”
AT+BLEMESHDATA=write
功能说明
通过透传模型写入数据。
命令格式
AT+BLEMESHDATA=write,<dst>,<data>,<app_key_index>,<ack>
响应格式
[APP] Datatrans model receive message: Src 256 ,written 3 bytes, status:0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <data>:
写入数据, 不包含 0x 且不超过 16 字节的十六进制数, 例如 1234ef
- <app_key_index>:
应用密钥索引
- <ack>:
目标节点是否需要回复确认
0: 否
1: 是
AT+BLEMESHDATA=read
功能说明
通过透传模型读取数据。
命令格式
AT+BLEMESHDATA=read,<dst>,<read_len>,<app_key_index>
响应格式
[APP] Datatrans model receive message,read 2 bytes date from remote src 256 :
0x0f0d
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <read_len>:
读取数据大小
- <app_key_index>:
应用密钥索引
AT+BLEMESHGOO=get
功能说明
获取目标节点的通用开关状态。
命令格式
AT+BLEMESHGOO=get,<dst>,<app_key_index>
响应格式
[APP] Generic on off client model receive message: src = 0x100, present = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGOO=set
功能说明
设置目标节点的通用开关状态。
命令格式
AT+BLEMESHGOO=set,<dst>,<on_off>,<ack>,<app_key_index>[,<trans_num_steps>,<trans_step_reso>,<delay>]
响应格式
[APP] Generic on off client model receive message: src = 0x100, present = 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <on_off>:
开关灯操作
0: 关灯
1: 开灯
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <trans_num_steps>:
转变的所需的步数
- <trans_step_reso>:
转变每步的时间
- <delay>:
状态改变延迟
AT+BLEMESHLL=llg
功能说明
获取灯亮度状态。
命令格式
AT+BLEMESHLL=llg,<dst>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, present 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lls
功能说明
设置灯亮度状态。
命令格式
AT+BLEMESHLL=lls,<dst>,<lightness>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}
响应格式
[APP] light lightness client model receive: src 256, present 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯的亮度
[0x0000, 0xffff]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lllg
功能说明
获取灯光线性亮度状态。
命令格式
AT+BLEMESHLL=lllg,<dst>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, present 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=llls
功能说明
设置灯光线性亮度状态。
命令格式
AT+BLEMESHLL=llls,<dst>,<lightness>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}
响应格式
[APP] light lightness client model receive: src 256, present 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯的亮度
[0x0000, 0xffff]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lllag
功能说明
获取最新灯光亮度状态。
命令格式
AT+BLEMESHLL=lllag,<dst>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, lightness 1144
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lldg
功能说明
获取默认灯光亮度状态。
命令格式
AT+BLEMESHLL=lldg,<dst>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, lightness 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=llds
功能说明
设置默认灯光亮度状态。
命令格式
AT+BLEMESHLL=llds,<dst>,<lightness>,<ack>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, lightness 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯的亮度
[0x0000, 0xffff]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=llrg
功能说明
获取灯光亮度范围状态。
命令格式
AT+BLEMESHLL=llrg,<dst>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, status 0, min 0, max 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=llrs
功能说明
设置灯光亮度范围状态。
命令格式
AT+BLEMESHLL=llrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>
响应格式
[APP] light lightness client model receive: src 256, status 0, min 1, max 100
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <range_min>:
范围最小值
[0x0001, 0xFFFF]
- <range_max>:
范围最大值
[0x0001, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lcg
功能说明
获取灯光控制亮度状态。
命令格式
AT+BLEMESHLCTL=lcg,<dst>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, present lightness 0, present temperature 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lcs
功能说明
设置灯光控制亮度状态。
命令格式
AT+BLEMESHLCTL=lcs,<dst>,<lightness>,<temperature>,<delta_uv>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}
响应格式
[APP] light ctl client model receive: src 256, present lightness 10, present temperature 900
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯光亮度
[0x0000, 0xFFFF]
- <temperature>:
灯光色温
[0x0320, 0x4E20]
- <delta_uv>:
色度偏移
[0x8000, 0x7FFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lctg
功能说明
获取灯光控制色温状态。
命令格式
AT+BLEMESHLCTL=lctg,<dst>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, present temperature 0, present delta_uv 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lcts
功能说明
获取灯光控制色温状态。
命令格式
AT+BLEMESHLCTL=lcts,<dst>,<temperature>,<delta_uv>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light ctl client model receive: src 256, present temperature 900, present delta_uv 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯光亮度
[0x0000, 0xFFFF]
- <temperature>:
灯光色温
[0x0320, 0x4E20]
- <delta_uv>:
色度偏移
[0x8000, 0x7FFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lctrg
功能说明
获取灯光控制色温范围状态。
命令格式
AT+BLEMESHLCTL=lctrg,<dst>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, status 0, min 0, max 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lctrs
功能说明
设置灯光控制色温范围状态。
命令格式
AT+BLEMESHLCTL=lctrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, status 0, min 900, max 1200
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <range_min>:
范围最小值
[0x0320, 0x4E20]
- <range_max>:
范围最大值
[0x0320, 0x4E20]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lcdg
功能说明
获取灯默认控制亮度状态。
命令格式
AT+BLEMESHLCTL=lcdg,<dst>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, lightness 0, temperature 0, delta_uv 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lcds
功能说明
获取灯光控制色温状态。
命令格式
AT+BLEMESHLCTL=lcds,<dst>,<lightness>,<temperature>,<delta_uv>,<ack>,<app_key_index>
响应格式
[APP] light ctl client model receive: src 256, lightness 10, temperature 1000, delta_uv 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯光亮度
[0x0000, 0xFFFF]
- <temperature>:
灯光色温
[0x0320, 0x4E20]
- <delta_uv>:
色度偏移
[0x8000, 0x7FFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhg
功能说明
获取灯光 HSL 亮度状态。
命令格式
AT+BLEMESHLHSL=lhg,<dst>,<app_key_index>
响应格式
[APP] light hsl client model receive: src 256, present lightness 0, present hue 0, presnet saturation 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhs
功能说明
设置灯光 HSL 亮度状态。
命令格式
AT+BLEMESHLHSL=lhs,<dst>,<lightness>,<hue>,<saturation>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light hsl client model receive: src 256, present lightness 0, present hue 0, presnet saturation 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯光亮度
[0x0000, 0xFFFF]
- <hue>:
色相
[0x0000, 0xFFFF]
- <saturation>:
饱和度
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lhtg
功能说明
获取目标灯光 HSL 亮度状态。
命令格式
AT+BLEMESHLHSL=lhtg,<dst>,<app_key_index>
响应格式
[APP] light hsl client model receive: src 256, target lightness 10, target hue 10, target saturation 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhhg
功能说明
获取灯光 HSL 色相状态。
命令格式
AT+BLEMESHLHSL=lhhg,<dst>,<app_key_index>
响应格式
[APP] light hsl client model receive: src 256, present hue 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhhs
功能说明
设置灯光 HSL 色相状态。
命令格式
AT+BLEMESHLHSL=lhhs,<dst>,<hue>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light hsl client model receive: src 256, present hue 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <hue>:
色相
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lhsg
功能说明
获取灯光 HSL 饱和度状态。
命令格式
AT+BLEMESHLHSL=lhsg,<dst>,<app_key_index>
响应格式
[APP] light hsl client model receive: src 256, present saturation 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhss
功能说明
设置灯光 HSL 饱和度状态。
命令格式
AT+BLEMESHLHSL=lhss,<dst>,<saturation>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light hsl client model receive: src 256, present saturation 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <saturation>:
饱和度
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lhdg
功能说明
获取灯光默认 HSL 亮度状态。
命令格式
AT+BLEMESHLHSL=lhdg,<dst>,<app_key_index>
响应格式
[APP] light hsl client receive: src 256, lightness 0, hue 0, saturation 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhds
功能说明
设置灯光默认 HSL 亮度状态。
命令格式
AT+BLEMESHLHSL=lhds,<dst>,<lightness>,<hue>,<saturation>,<ack>,<app_key_index>
响应格式
[APP] light hsl client receive: src 256, lightness 20, hue 10, saturation 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
灯光亮度
[0x0000, 0xFFFF]
- <hue>:
色相
[0x0000, 0xFFFF]
- <saturation>:
饱和度
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhrg
功能说明
获取 HSL 亮度范围状态。
命令格式
AT+BLEMESHLHSL=lhrg,<dst>,<app_key_index>
响应格式
[APP] light hsl client receive: src 256, status 0, hue min 0, hue max 0, saturation min 0, saturation max 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lhrs
功能说明
设置 HSL 范围状态。
命令格式
AT+BLEMESHLHSL=lhrs,<dst>,<hue_range_min>,<hue_range_max>,<saturation_range_min>,<saturation_range_max>,<ack>,<app_key_index>
响应格式
[APP] light hsl client receive: src 256, status 0, hue min 1, hue max 100, saturation min 1, saturation max 100
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <hue_range_min>:
色相最小值
[0x0000, 0xFFFF]
- <hue_range_max>:
色相最大值
[0x0000, 0xFFFF]
- <saturation_range_min>:
饱和度最小值
[0x0000, 0xFFFF]
- <saturation_range_max>:
饱和度最大值
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxg
功能说明
获取灯光 XYL 亮度状态。
命令格式
AT+BLEMESHLHSL=lxg,<dst>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, present lightness 0, present xyl_x 0, presnet xyl_y 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxs
功能说明
设置 HSL 范围状态。
命令格式
AT+BLEMESHLXYL=lxs,<dst>,<lightness>,<xyl_x>,<xyl_y>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light hsl client receive: src 256, status 0, hue min 1, hue max 100, saturation min 1, saturation max 100
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
亮度
[0x0000, 0xFFFF]
- <xyl_x>:
色彩空间 X 通道
[0x0000, 0xFFFF]
- <xyl_y>:
色彩空间 Y 通道
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLL=lxtg
功能说明
获取目标灯光 XYL 亮度状态。
命令格式
AT+BLEMESHLHSL=lxtg,<dst>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, target lightness 10, target xyl_x 10, target xyl_y 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxdg
功能说明
获取默认灯光 XYL 亮度状态。
命令格式
AT+BLEMESHLHSL=lxdg,<dst>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, lightness 0, xyl_x 0, xyl_y 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxds
功能说明
获取默认灯光 XYL 亮度状态。
命令格式
AT+BLEMESHLXYL=lxds,<dst>,<lightness>,<xyl_x>,<xyl_y>,<ack>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, lightness 10, xyl_x 10, xyl_y 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
亮度
[0x0000, 0xFFFF]
- <xyl_x>:
色彩空间 X 通道
[0x0000, 0xFFFF]
- <xyl_y>:
色彩空间 Y 通道
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxrg
功能说明
获取灯光 XYL 亮度范围状态。
命令格式
AT+BLEMESHLHSL=lxrg,<dst>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, status 0, xyl_x min 0, xyl_x max 0, xyl_y min 0, xyl_y max 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLL=lxrs
功能说明
获取灯光 XYL 亮度范围状态。
命令格式
AT+BLEMESHLXYL=lxrs,<dst>,<xyl_x_range_min>,<xyl_x_range_max>,<xyl_y_range_min>,<xyl_y_range_max>,<ack>,<app_key_index>
响应格式
[APP] light xyl client receive: src 256, lightness 10, xyl_x 10, xyl_y 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <lightness>:
亮度
[0x0000, 0xFFFF]
- <xyl_x_range_min>:
色彩空间 X 通道最小值
[0x0000, 0xFFFF]
- <xyl_x_range_max>:
色彩空间 X 通道最大值
[0x0000, 0xFFFF]
- <xyl_y_range_min>:
色彩空间 Y 通道最小值
[0x0000, 0xFFFF]
- <xyl_y_range_max>:
色彩空间 Y 通道最大值
[0x0000, 0xFFFF]
- <ack>:
目标节点收到消息后是否回复 ACK
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcmg
功能说明
获取灯照明控制器模式状态。
命令格式
AT+BLEMESHLLC=llcmg,<dst>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, mode 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcms
功能说明
设置灯照明控制器模式状态。
命令格式
AT+BLEMESHLLC=llcms,<dst>,<mode>,<ack>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, mode 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <mode>:
照明控制器模式
0: 控制器关闭,断开与灯光亮度的绑定
1: 控制器开启,启用与灯光亮度的绑定
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcomg
功能说明
获取灯照明控制器占用模式状态。
命令格式
AT+BLEMESHLLC=llcomg,<dst>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, occupancy mode 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcoms
功能说明
设置灯照明控制器占用模式状态。
命令格式
AT+BLEMESHLLC=llcoms,<dst>,<mode>,<ack>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, occupancy mode 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <mode>:
占用模式
0: 当有占用上报时控制器不会离开待机状态
1: 当有占用上报时控制器可离开待机状态
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcloog
功能说明
获取灯照明控制器灯开关状态。
命令格式
AT+BLEMESHLLC=llcloog,<dst>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, present on off 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcloos
功能说明
设置灯照明控制器灯开关状态。
命令格式
AT+BLEMESHLLC=llcloos,<dst>,<on_off>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] light lc client receive: src 256, present on off 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <on_off>:
开关状态
0: 灯关闭
1: 灯开启
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHLLC=llcpg
功能说明
获取灯照明控制器属性。
命令格式
AT+BLEMESHLLC=llcpg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] light lc client receive: src 256, property id 0x1, property value 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
- <app_key_index>:
应用密钥索引
AT+BLEMESHLLC=llcps
功能说明
获取灯照明控制器属性。
命令格式
AT+BLEMESHLLC=llcps,<dst>,<ack>,<app_key_index>,<property_id>,[<property_value>]
响应格式
[APP] light lc client receive: src 256, property id 0x1, property value 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <property_id>:
属性 ID
- <property_value>:
属性值, 不超过 16 字节的且不包含 0x 的十六进制数, 例如 1234
AT+BLEMESHGLE=glg
功能说明
获取通用级别。
命令格式
AT+BLEMESHGLE=glg,<dst>,<app_key_index>
响应格式
[APP] generic level client receive: src 256, present level 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLE=gls
功能说明
设置通用级别。
命令格式
AT+BLEMESHGLE=gls,<dst>,<level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] generic level client receive: src 256, present level 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <level>:
通用级别
[0x0000, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHGLE=glds
功能说明
设置通用级别增量。
命令格式
AT+BLEMESHGLE=glds,<dst>,<delta_level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] generic level client receive: src 256, present level 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <delta_level>:
通用级别增量
[0x0000, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHGLE=glms
功能说明
设置通用级别变化。
命令格式
AT+BLEMESHGLE=glms,<dst>,<move>,<ack>,<app_key_index>,<num_steps>,<resolution>,<delay>
响应格式
[APP] generic level client receive: src 256, present level 20, target level 30, remaining time 5
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <move>:
通用级别变化
[0x0000, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHGLE=gdttg
功能说明
获取通用默认转变时间。
命令格式
AT+BLEMESHGDTT=gdttg,<dst>,<app_key_index>
响应格式
[APP] generic default transition time client receive: src 256, resolution 0, num steps 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLE=gdtts
功能说明
设置通用默认转变时间。
命令格式
AT+BLEMESHGDTT=gdtts,<dst>,<num_steps>,<resolution>,<app_key_index>
响应格式
[APP] generic default transition time client receive: src 256, resolution 1, num steps 5
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPOO=gpg
功能说明
获取通用上电状态。
命令格式
AT+BLEMESHGPOO=gpg,<dst>,<app_key_index>
响应格式
[APP] generic power on off client receive: src 256, on power up 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPOO=gps
功能说明
设置通用上电状态。
命令格式
AT+BLEMESHGPOO=gps,<dst>,<on_power_up>,<ack>,<app_key_index>
响应格式
[APP] generic power on off client receive: src 256, on power up 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <on_power_up>:
上电状态
0: 关闭
1: 默认
2: 恢复
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPL=gplg
功能说明
获取通用功率级别。
命令格式
AT+BLEMESHGPL=gplg,<dst>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, present power 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPOO=gpls
功能说明
设置通用功率级别。
命令格式
AT+BLEMESHGPL=gpls,<dst>,<power_level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] generic power level client receive: src 256, present power 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <power_level>:
功率级别
[0x0000, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHGPL=gpllg
功能说明
获取最新通用功率级别。
命令格式
AT+BLEMESHGPL=gpllg,<dst>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, power 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPL=gpldg
功能说明
获取默认通用功率级别。
命令格式
AT+BLEMESHGPL=gpldg,<dst>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, power 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPL=gplds
功能说明
设置默认通用功率级别。
命令格式
AT+BLEMESHGPL=gplds,<dst>,<power>,<ack>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, power 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <power>:
功率级别
[0x0000, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPL=gplrg
功能说明
获取通用功率级别范围。
命令格式
AT+BLEMESHGPL=gplrg,<dst>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, status 0, range min 0, range max 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGPL=gplrs
功能说明
设置通用功率级别范围。
命令格式
AT+BLEMESHGPL=gplrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>
响应格式
[APP] generic power level client receive: src 256, status 0, range min 1, range max 100
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <range_min>:
功率级别最小值
[0x0000, 0xFFFF]
- <range_max>:
功率级别最大值
[0x0000, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHGB=gbg
功能说明
获取通用电池状态。
命令格式
AT+BLEMESHGB=gbg,<dst>,<app_key_index>
响应格式
[APP] generic battery client receive: src = 256, battery level = 1, time to discharge = 65536, time to charge = 65536, presence = 1, indicator = 1, charging = 1, serviceability = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLO=glgg
功能说明
获取通用全球位置信息。
命令格式
AT+BLEMESHGLO=glgg,<dst>,<app_key_index>
响应格式
[APP] Generic location client receive: src = 256, latitude = 0, longitude = 0, altitude = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLO=glgs
功能说明
设置通用全球位置信息。
命令格式
AT+BLEMESHGLO=glgs,<dst>,<latitude>,<longitude>,<altitude>,<ack>,<app_key_index>
响应格式
[APP] Generic location client receive: src = 256, latitude = 20, longitude = -20, altitude = 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <latitude>:
纬度
0x80000000 表示未配置
- <longitude>:
经度
0x80000000 表示未配置
- <altitude>:
海拔
[0x8000, 0x7FFFD]
0x7FFF 表示未配置
0x7FFE 表示大于等于 32766
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLO=gllg
功能说明
获取通用本地位置信息。
命令格式
AT+BLEMESHGLO=gllg,<dst>,<app_key_index>
响应格式
[APP] Generic location client receive: src = 256, north = 0, east = 0, altitude = 0, floor = 0, stationary = 0, updata time = 0, precision = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGLO=glls
功能说明
设置通用本地位置信息。
命令格式
AT+BLEMESHGLO=glls,<dst>,<north>,<east>,<altitude>,<floor_num>,<stationary>,<update_time>,<precision>,<ack>,<app_key_index>
响应格式
[APP] Generic location client receive: src = 256, north = -1, east = -2, altitude = -3, floor = 1, stationary = 1, updata time = 1, precision = 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <north>:
[-32767, 32767]
- <east>:
[-32767, 32767]
- <altitude>:
海拔
[0x8000, 0x7FFFD]
0x7FFF 表示未配置
0x7FFE 表示大于等于 32766
- <floor_num>:
楼层
0x00: -20 层以下
[0x01, 0xFB], 楼层 N, 编码方式是 X=N+20
0xFC: 232 层以上
0xFD: 地面楼层(0 层)
0xFE: 地面楼层(1 层)
0xFF 表示未配置
- <update_time>:
更新时间间隔
[0, 15]
- <precision>:
坐标精度等级
[0, 15]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gupsg
功能说明
获取通用用户多个属性。
命令格式
AT+BLEMESHGP=gupsg,<dst>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256 num_ids = 2 user property ids: 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gupg
功能说明
获取通用用户属性。
命令格式
AT+BLEMESHGP=gupg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256 num_ids = 2 user property ids: 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gups
功能说明
设置通用用户属性。
命令格式
AT+BLEMESHGP=gups,<dst>,<property_id>,<ack>,<app_key_index>,<data>
响应格式
[APP] Generic property client receive: src = 256, property id = 0x1, property access = 3 user property values: 12 34 56
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <data>:
属性数据, 不包含 0x 的十六进制数
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gapsg
功能说明
获取通用管理员多个属性。
命令格式
AT+BLEMESHGP=gapsg,<dst>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256 num_ids = 2 admin property ids: 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gapg
功能说明
获取通用管理员属性。
命令格式
AT+BLEMESHGP=gapg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256, property id = 0x1, property access = 3 admin property values: 01 01 02
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gaps
功能说明
设置通用管理员属性。
命令格式
AT+BLEMESHGP=gaps,<dst>,<property_id>,<property_access>,<ack>,<app_key_index>,<data>
响应格式
[APP] Generic property client receive: src = 256, property id = 0x1, property access = 3 admin property values: 12 34 56
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <property_access>:
属性访问权限
0x00: 不是用户属性
0x01: 可读
0x02: 可写
0x03: 可读写
[0x04, 0xFF]: 禁止访问
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <data>:
属性数据, 不包含 0x 的十六进制数
AT+BLEMESHGP=gmpsg
功能说明
获取通用厂家多个属性。
命令格式
AT+BLEMESHGP=gmpsg,<dst>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256 num_ids = 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gmpg
功能说明
获取通用厂家属性。
命令格式
AT+BLEMESHGP=gmpg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256, property id = 0x1, property access = 3 manufacturer property values: 01 01 02
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gmps
功能说明
设置通用厂家属性。
命令格式
AT+BLEMESHGP=gmps,<dst>,<property_id>,<property_access>,<ack>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256, property id = 0x1, property access = 3 manufacturer property values: 01 01 02
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <property_access>:
属性访问权限
0x00: 不是用户属性
0x01: 可读
0x02: 可写
0x03: 可读写
[0x04, 0xFF]: 禁止访问
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHGP=gcpsg
功能说明
获取通用客户属性。
命令格式
AT+BLEMESHGP=gcpsg,<dst>,<app_key_index>
响应格式
[APP] Generic property client receive: src = 256 num_ids = 3 client property ids: 0003 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHSENSOR=sdg
功能说明
获取传感器描述符。
命令格式
AT+BLEMESHSENSOR=sdg,<dst>,<app_key_index>,[<property_id>]
响应格式
[APP] Sensor client receive: src 256, property_id: 1, positive_tolerance: 10, negative_tolerance: 10, sampling_function: 1,measurement_period: 1, update_interval: 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHSENSOR=scg
功能说明
获取传感器节律。
命令格式
AT+BLEMESHSENSOR=scg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] Sensor client receive: src 256, property id 1
fast_cadence_period_divisor: 1, status_trigger_type :0
status_trigger_delta_down:
0x0302010203
status_trigger_delta_up:
0x0102030201
status_min_interval: 1
fast_cadence_low:
0x0403020304
fast_cadence_high:
0x0203040302
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHSENSOR=scs
功能说明
设置传感器节律。
命令格式
AT+BLEMESHSENSOR=scs,<dst>,<property_id>,<app_key_index>,<ack>,<fast_cadence_period_divisior>,<status_trigger_type>,<raw_value_len>,<trigger_down>,<trigger_up>,<status_min_interval>,<cadence_low>,<cadence_high>
响应格式
[APP] Sensor client receive: src 256, property id 1
fast_cadence_period_divisor: 0, status_trigger_type :0
status_trigger_delta_down:
0x12345678
status_trigger_delta_up:
0x78563412
status_min_interval: 1
fast_cadence_low:
0x11111111
fast_cadence_high:
0x22222222
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <fast_cadence_period_divisior>:
快速节律周期分频因子
[0, 15]
- <status_trigger_type>:
状态触发类型
0: 由传感器属性 ID 所引用特性的格式类型定义
1: 单位为“无单位”,格式类型为 0x06(uint16), 值以分辨率为 0.01%的百分比变化表示
- <trigger_down>:
触发阈值下界,16 进制数据,不带 0x
- <trigger_up>:
触发阈值上界,16 进制数据,不带 0x
- <status_min_interval>:
最小状态间隔
[0, 26]
- <cadence_low>:
快速节律区间下限, 16 进制数据, 不带 0x
- <cadence_high>:
快速节律区间上限, 16 进制数据, 不带 0x
AT+BLEMESHSENSOR=sssg
功能说明
获取传感器所有设定。
命令格式
AT+BLEMESHSENSOR=sssg,<dst>,<property_id>,<app_key_index>
响应格式
[APP] Sensor client receive: src 256, property id 1, ids: 1 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHSENSOR=ssg
功能说明
获取传感器设定。
命令格式
AT+BLEMESHSENSOR=ssg,<dst>,<property_id>,<setting_property_id>,<app_key_index>
响应格式
[APP] Sensor client receive: src 256, property id 1, ids: 1 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <setting_property_id>:
设置属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHSENSOR=sss
功能说明
设置传感器设定。
命令格式
AT+BLEMESHSENSOR=sss,<dst>,<property_id>,<setting_property_id>,<app_key_index>,<ack>,<setting_raw>
响应格式
[APP] Sensor client receive: src 256, property id 1, setting property id: 1 setting access:3, setting raw: 0x1234
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <setting_property_id>:
设置属性 ID
[0x0001, 0xFFFF]
- <app_key_index>:
应用密钥索引
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <setting_raw>:
设置数据, 不包含 0x 的 2 字节十六进制数
AT+BLEMESHSENSOR=sg
功能说明
获取传感器数据。
命令格式
AT+BLEMESHSENSOR=sg,<dst>,<app_key_index>,[<property_id>]
响应格式
[APP] Sensor client receive: src 256, marshalled_sensor_data_len 7, data: 0x28000400010203
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
AT+BLEMESHSENSOR=scog
功能说明
获取传感器列数据。
命令格式
AT+BLEMESHSENSOR=scog,<dst>,<property_id>,<app_key_index>,<raw_value_x>
响应格式
[APP] Sensor client receive: src 256, property_id 1, column_raw_value_len: 5, column value: 0x0400010203
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <raw_value_x>:
列值, 不包含 0x 的十六进制数
AT+BLEMESHSENSOR=sseg
功能说明
获取传感器系列数据。
命令格式
AT+BLEMESHSENSOR=scog,<dst>,<property_id>,<app_key_index>,<raw_value_x>
响应格式
[APP] Sensor client receive: src 256, property_id 1, column_raw_value_len: 5, column value: 0x0400010203
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <property_id>:
属性 ID
[0x0001, 0xFFFF]
- <raw_value_x>:
区间下限, 不包含 0x 的十六进制数
- <raw_value_x>:
区间上限, 不包含 0x 的十六进制数
AT+BLEMESHTIME=tg
功能说明
获取时间。
命令格式
AT+BLEMESHTIME=tg,<dst>,<app_key_index>
响应格式
[APP] time client receive: src 0, subsecond 0, uncertainty 0, time_authority 0, tai_utc_delta 0, time_zone_offset 0 tai_seconds[4]0 tai_seconds[3]0 tai_seconds[2]0 tai_seconds[1]0 tai_seconds[0]0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHTIME=tzg
功能说明
获取时区。
命令格式
AT+BLEMESHTIME=tzg,<dst>,<app_key_index>
响应格式
[APP] time client receive: src 256 time_zone_offset_current 0 time_zone_offset_new 0 tai_of_zone_change[4]0 tai_of_zone_change[3]0 tai_of_zone_change[2]0 tai_of_zone_change[1]0 tai_of_zone_change[0]0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHTIME=ttudg
功能说明
获取 TAI 与 UTC 的时差。
命令格式
AT+BLEMESHTIME=ttudg,<dst>,<app_key_index>
响应格式
[APP] time client receive: src 256, tai utc delta current 0, tai utc delta new 0 tai_of_delta_change[4]0 tai_of_delta_change[3]0 tai_of_delta_change[2]0 tai_of_delta_change[1]0 tai_of_delta_change[0]0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHTIME=trg
功能说明
获取时间节点角色。
命令格式
AT+BLEMESHTIME=trg,<dst>,<app_key_index>
响应格式
[APP] time client receive: role 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHTIME=ts
功能说明
设置时间。
命令格式
AT+BLEMESHTIME=ts,<dst>,<app_key_index>,<tai_seconds>,<subsecond>,<uncertainty>,<time_authority>,<tai_utc_delta>,<time_zone_offset>
响应格式
[APP] time client receive: src 256, subsecond 10, uncertainty 10, time_authority 1, tai_utc_delta 16, time_zone_offset 18 tai_seconds[4]154 tai_seconds[3]120 tai_seconds[2]86 tai_seconds[1]52 tai_seconds[0]18
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <tai_seconds>:
长度 5 字节的十六进制(不带 0x 前缀)
- <subsecond>:
[0, 255], 单位 1/256 秒
- <uncertainty>:
误差
[0, 255], 单位 10 毫秒秒
- <time_authority>:
是否有时间授权
0: 否
1: 是
- <tai_utc_delta>:
TAI 与 UTC 的时差
[0x0000, 0x7FFF]表示[-255, 32512]
- <time_zone_offset>:
时区偏移
[0x00, 0xff]表示[-64, 191]
AT+BLEMESHTIME=tzs
功能说明
设置时区。
命令格式
AT+BLEMESHTIME=tzs,<dst>,<app_key_index>,<time_zone_offset_new>,<tai_of_zone_change>
响应格式
[APP] time client receive: src 256 time_zone_offset_current 16 time_zone_offset_new 16 tai_of_zone_change[4]154 tai_of_zone_change[3]120 tai_of_zone_change[2]86 tai_of_zone_change[1]52 tai_of_zone_change[0]18
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <time_zone_offset_new>:
时区偏移
[0x00, 0xFF]
- <tai_of_zone_change>:
不包含 0x 的十六进制数
[0, 0xFFFFFFFF]
AT+BLEMESHTIME=ttuds
功能说明
设置 TAI 与 UTC 的时差。
命令格式
AT+BLEMESHTIME=ttuds,<dst>,<app_key_index>,<tai_utc_delta_new>,<tai_of_delta_change>
响应格式
[APP] time client receive: src 256, tai utc delta current 4095, tai utc delta new 4095 tai_of_delta_change[4]18 tai_of_delta_change[3]52 tai_of_delta_change[2]86 tai_of_delta_change[1]120 tai_of_delta_change[0]154
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <tai_utc_delta_new>:
TAI 与 UTC 的时差
[0x0000, 0x7FFF]表示[-255, 32512]
- <tai_of_delta_change>:
不包含 0x 的十六进制数
[0, 0xFFFFFFFF]
AT+BLEMESHTIME=trs
功能说明
设置时间节点角色。
命令格式
AT+BLEMESHTIME=trs,<dst>,<role>,<app_key_index>
响应格式
[APP] time client receive: role 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <role>:
时间节点角色
0: 无
1: Mesh 时间认证
2: Mesh 时间中继
3: Mesh 时间客户端
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCENE=sg
功能说明
获取场景。
命令格式
AT+BLEMESHSCENE=sg,<dst>,<app_key_index>
响应格式
[APP] scene client receive: src 256, status 0x0, current scene 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCENE=ss
功能说明
恢复场景。
命令格式
AT+BLEMESHSCENE=ss,<dst>,<scene_number>,<ack>,<app_key_index>
响应格式
[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 2, scene array: 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <scene_number>:
场景编号, 2 个字节不包括 0
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCENE=sr
功能说明
调用场景。
命令格式
AT+BLEMESHSCENE=sr,<dst>,<scene_number>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]
响应格式
[APP] scene client receive: src 256, status 0x0, current scene 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <scene_number>:
场景编号, 2 个字节不包括 0
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <delay>:
状态改变延迟
AT+BLEMESHSCENE=srg
功能说明
获取已注册场景。
命令格式
AT+BLEMESHSCENE=srg,<dst>,<app_key_index>
响应格式
[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 2, scene array: 0001 0002
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCENE=sd
功能说明
删除场景。
命令格式
AT+BLEMESHSCENE=sd,<dst>,<scene_number>,<ack>,<app_key_index>
响应格式
[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 1, scene array: 0001
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <scene_number>:
场景编号, 2 个字节不包括 0
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCHEDULER=scheg
功能说明
获取调度器。
命令格式
AT+BLEMESHSCHEDULER=scheg,<dst>,<app_key_index>
响应格式
[APP] scheduler client receive: src 256, schedulers 0x 3ff
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCHEDULER=scheag
功能说明
获取调度器动作。
命令格式
AT+BLEMESHSCHEDULER=scheag,<dst>,<index>,<app_key_index>
响应格式
[APP] scheduler client receive: index = 1, year = 0, month = 0, day = 0, hour = 0, minute = 0, second = 0, day_of_week = 0, action = 0, num_steps = 0, step_resolution = 0, scene_number = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <index>:
索引
[0x00, 0xFF]
- <app_key_index>:
应用密钥索引
AT+BLEMESHSCHEDULER=scheas
功能说明
获取调度器动作。
命令格式
AT+BLEMESHSCHEDULER=scheas,<dst>,<index>,<year>,<month>,<day>,<hour>,<minute>,<second>,<day_of_week>,<action>,<num_steps>,<resolution>,<scene_number>,<ack>,<app_key_index>
响应格式
[APP] scheduler client receive: index = 0, year = 1, month = 7, day = 24, hour = 16, minute = 44, second = 30, day_of_week = 1, action = 15, num_steps = 0, step_resolution = 0, scene_number = 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <index>:
索引
[0x00, 0xFF]
- <year>:
年份
[0x00, 0x63]: 当前世纪的后两位年份
0x64: 任意年份
- <month>:
月份
[0x00, 0x0b]: 1 至 12 月
- <day>:
日期
0x00: 任意一天
[0x01, 0x1f]: 指定月内具体某天
- <hour>:
小时
[0x00, 0x17]: 具体小时(0-23 点)
0x18: 任意小时
0x19: 随机小时每日一次
- <minute>:
分钟
[0x00, 0x3b]: 具体分钟(0-59 点)
0x3c: 任意分钟
0x3d: 每 15 分钟
0x3e: 每 20 分钟
0x3f: 每小时一次(随机分钟)
- <second>:
秒钟
[0x00, 0x3b]: 具体秒钟(0-59 秒)
0x3c: 任意秒钟
0x3d: 每 15 秒钟
0x3e: 每 20 秒钟
0x3f: 每分钟一次(随机秒钟)
- <day_of_week>:
星期几
bit0-bit6 表示周一到周日
- <action>:
动作类型
0x0: 关闭
0x1: 打开
0x2: 调用场景
0xf: 不执行操作
- <num_steps>:
转变的所需的步数
-[0x00, 0x3E]
- <resolution>:
转变每步的时间
0: 100 毫秒
1: 1 秒
2: 10 秒
3: 10 分钟
- <scene_number>:
场景编号
[0x0001, 0xFFFF]: scene number
0x0000: no scene
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hfg
功能说明
获取健康故障。
命令格式
AT+BLEMESHHEALTH=hfg,<dst>,<company_id>,<app_key_index>
响应格式
[APP] Health client receive: src = 256, test id = 0, company id = 0x005d, fault_array:
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <company_id>:
公司 ID, 包含 0x 的 2 字节十六进制数, 例如 0x005d
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hfc
功能说明
清除健康故障。
命令格式
AT+BLEMESHHEALTH=hfc,<dst>,<company_id>,<ack>,<app_key_index>
响应格式
[APP] Health client receive: src = 256, test id = 0, company id = 0x005d, fault_array:
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <company_id>:
公司 ID, 包含 0x 的 2 字节十六进制数, 例如 0x005d
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hft
功能说明
测试健康故障。
命令格式
AT+BLEMESHHEALTH=hft,<dst>,<test_id>,<company_id>,<ack>,<app_key_index>
响应格式
NULL
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <company_id>:
公司 ID, 包含 0x 的 2 字节十六进制数, 例如 0x005d
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hpg
功能说明
获取健康周期。
命令格式
AT+BLEMESHHEALTH=hpg,<dst>,<app_key_index>
响应格式
[APP] Health client receive: fast period divisor = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hps
功能说明
设置健康周期。
命令格式
AT+BLEMESHHEALTH=hps,<dst>,<fast_period_divisor>,<ack>,<app_key_index>
响应格式
[APP] Health client receive: fast period divisor = 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <fast_period_divisor>:
[0, 15]
- <ack>:
目标节点接收消息后是否返回状态
0: 否
1: 是
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=hag
功能说明
获取健康关注定时器。
命令格式
AT+BLEMESHHEALTH=hag,<dst>,<app_key_index>
响应格式
[APP] Health client receive: attention = 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHHEALTH=has
功能说明
设置健康关注定时器。
命令格式
AT+BLEMESHHEALTH=has,<dst>,<attention_timer>,<ack>,<app_key_index>
响应格式
[APP] Health client receive: attention = 10
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <attention_timer>:
关注定时器
0x00: 关闭
[0x01, 0xFF]: 开启,剩余时间(单位: 秒)
- <app_key_index>:
应用密钥索引
AT+BLEMESHRMT=scan_start
功能说明
设置远程配网服务器开始扫描未配网节点的广播。
命令格式
AT+BLEMESHRMT=scan_start,<dst>,<net_key_index>,<scanned_items_limit>,<scan_timeout>
响应格式
[APP] Remote prov scan status: src 0x100, status 0, scan state 1, scanned items limit 10, timeout 10
[APP] Remote prov scan report: src 0x100, rssi -22, oob 0, uuid 0x2b06804ce000060708090a0b0c0d0e0f
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <scanned_items_limit>:
扫描限制
- <scan_timeout>:
扫描超时
AT+BLEMESHRMT=scan_capa_get
功能说明
获取远程配网服务器的扫描能力。
命令格式
AT+BLEMESHRMT=scan_capa_get,<dst>,<net_key_index>
响应格式
[APP] Remote prov scan capability status: src 0x100, max scan items 10, support active scan 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHRMT=link_open
功能说明
让远程配网服务器与未配网设备建立 PB-Link。
命令格式
AT+BLEMESHRMT=link_open,<dst>,<net_key_index>,<uuid>,<link_open_timeout>
响应格式
[APP] Remote prov link status: src 0x100, status 0, link state 1
[APP] PB-ADV Link Opened!
[APP] Remote prov link report: src 0x100, status 0, link state 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <uuid>:
未配网设备 UUID, 不包含 0x 的 16 字节十六进制数, 例如 2b06804ce000060708090a0b0c0d0e0f
- <link_open_timeout>:
PB-Link 打开超时
AT+BLEMESHRMT=link_open_dkri
功能说明
建立连线以开始 dkri 过程。
命令格式
AT+BLEMESHRMT=link_open,<dst>,<net_key_index>,<dkri_procedure>
响应格式
[APP] PB-ADV Link Opened!
[APP] Remote prov link report: src 0x100, status 0, link state 2
[APP] Remote prov link status: src 0x100, status 0, link state 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <dkri_procedure>:
0: 刷新设备密钥
1: 刷新节点地址
2: 刷新组合数据
AT+BLEMESHRMT=dev_key_refresh
功能说明
开始刷新设备密钥过程。
命令格式
AT+BLEMESHRMT=dev_key_refresh{,<attn_dur>}
响应格式
[APP] Refresh device key!
参数
- <attn_dur>:
注意时长
AT+BLEMESHRMT=addr_refresh
功能说明
开始刷新节点地址过程。
命令格式
AT+BLEMESHRMT=addr_refresh,node_addr{,<attn_dur>}
响应格式
[APP] Refresh node address to 0x105!
参数
- <attn_dur>:
注意时长
AT+BLEMESHRMT=compo_refresh
功能说明
开始刷新组合数据过程。
命令格式
AT+BLEMESHRMT=compo_refresh{,<attn_dur>}
响应格式
[APP] Refresh node composition data!
参数
- <attn_dur>:
注意时长
AT+BLEMESHDF=dfpdis
功能说明
启动路径发现过程以建立方向性路径。
命令格式
AT+BLEMESHDF=dfpdis,<master_key_index>,<target_addr>,<dependent_addr>,<dependent_element_num>
响应格式
Discovering, master key index 0
src 0x0023(0) [0x0000(0)] --> dst 0x0100(0) [0x0000(0)]
forwarding num 0
Established, master key index 0
src 0x0023(0) [0x0000(0)] --> dst 0x0100(0) [0x0000(0)]
forwarding num 0
参数
- <master_key_index>:
主密钥索引
- <target_addr>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <dependent_addr>:
依赖节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0101
- <dependent_element_num>:
依赖节点中的元素数量
AT+BLEMESHDF=dfpsol
功能说明
启动路径请求流程,以发起对相关地址路径的发现。
命令格式
AT+BLEMESHDF=dfpsol,<master_key_index>,<addr_num>,[<addr1>,…]
响应格式
NULL
参数
- <master_key_index>:
主密钥索引
- <addr_num>:
地址数量
- <addr1>:
地址, 包含 0x 的 2 字节十六进制数, 例如 0x0101
AT+BLEMESHDF=dfpdupt
功能说明
启动路径依赖项更新流程,以更新相关依赖节点地址。
命令格式
AT+BLEMESHDF=dfpdupt,<type>,<end_point_addr>,<dependent_addr>,<dependent_element_num>
响应格式
NULL
参数
- <type>:
0: 移除
1: 添加
- <end_point_addr>:
支持节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <dependent_addr>:
依赖节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0101
- <dependent_element_num>:
依赖节点中的元素数量
AT+BLEMESHDF=mdu
功能说明
设置相关模型是否使用 df 发送消息。
命令格式
AT+BLEMESHDF=mdu,<element_index>,<model_id>,<policy_state>
响应格式
NULL
参数
- <element_index>:
元素索引
- <model_id>:
模型 ID, 例如 0x1000ffff
- <policy_state>:
策略状态
0: 使用默认策略发送消息
1: 使用 df 发送消息
AT+BLEMESHDF=dcss
功能说明
设置自身定向控制状态参数。
命令格式
AT+BLEMESHDF=dcss,<master_key_index>,<directed_forwarding>,<directed_relay>,<directed_proxy>,<directed_proxy_use_directed_default>,<directed_friend>
响应格式
NULL
参数
- <master_key_index>:
主密钥索引
- <directed_forwarding>:
定向转发
0: 禁用
1: 启用
- <directed_relay>:
定向中继
0: 禁用
1: 启用
- <directed_proxy>:
定向代理
0: 禁用
1: 启用
- <directed_proxy_use_directed_default>:
定向代理使用默认转发设置
0: 禁用
1: 启用
0xFF: 不处理该参数
- <directed_friend>:
定向好友
0: 禁用
1: 启用
0xFF: 不处理该参数
AT+BLEMESHDF=dcg
功能说明
获取定向控制状态。
命令格式
AT+BLEMESHDF=dcg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive directed control status: status 0, net_key_index 0x0000, ctl 1-1-1-1-1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=dcs
功能说明
设置定向控制状态。
命令格式
AT+BLEMESHDF=dcs,<dst>,<net_key_index>,<net_key_index_df>,<directed_forwarding>,<directed_relay>,<directed_proxy>,<directed_proxy_use_directed_default>,<directed_friend>
响应格式
[APP] receive directed control status: status 0, net_key_index 0x0000, ctl 1-1-1-1-1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <directed_forwarding>:
定向转发
0: 禁用
1: 启用
- <directed_relay>:
定向中继
0: 禁用
1: 启用
- <directed_proxy>:
定向代理
0: 禁用
1: 启用
- <directed_proxy_use_directed_default>:
定向代理使用默认转发设置
0: 禁用
1: 启用
0xFF: 不处理该参数
- <directed_friend>:
定向好友
0: 禁用
1: 启用
0xFF: 不处理该参数
AT+BLEMESHDF=pmg
功能说明
获取路径指标状态。
命令格式
AT+BLEMESHDF=pmg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive path metric status: status 0, net_key_index 0x0000, metric 0-2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=pms
功能说明
设置路径指标状态。
命令格式
AT+BLEMESHDF=pms,<dst>,<net_key_index>,<net_key_index_df>,<metric_type>,<lifetime>
响应格式
[APP] receive path metric status: status 0, net_key_index 0x0000, metric 0-0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <metric_type>:
指标类型
0: 节点数量
[1, 7]: RFU
- <lifetime>:
生命周期
0: 12 分钟
1: 2 小时
2: 24 小时
3: 10 天
AT+BLEMESHDF=dtcg
功能说明
获取发现表能力状态。
命令格式
AT+BLEMESHDF=dtcg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive discovery table capabilities status: status 0, net_key_index 0x0000, capabilities 2-3
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=dtcs
功能说明
设置发现表能力状态。
命令格式
AT+BLEMESHDF=dtcs,<dst>,<net_key_index>,<net_key_index_df>,<max_concurrent_init>
响应格式
[APP] receive discovery table capabilities status: status 0, net_key_index 0x0000, capabilities 3-3
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <max_concurrent_init>:
最大并发初始化数, 不能为 0
AT+BLEMESHDF=fta
功能说明
添加转发表项。
命令格式
AT+BLEMESHDF=fta,<dst>,<net_key_index>,<net_key_index_df>,<unicast_dst_flag>,<backward_path_valid>,<origin_addr>,<origin_element_num>,<target_addr>,<target_element_num>,<bearer_toward_origin>,<bearer_toward_target>
响应格式
[APP] receive forwarding table status: status 0, net_key_index 0x0000, path_origin 0x0110, dst 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <max_concurrent_init>:
最大并发初始化数, 不能为 0
- <unicast_dst_flag>:
转发表项的目的地址类型
0: 转发表项不是单播地址
1: 转发表项是单播地址
- <backward_path_valid>:
后向路径有效性标志
0: 后向路径无效(若 unicast_dst_flag 为 0,必须为 0)
1: 后向路径有效
- <origin_addr>:
源设备的地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <origin_element_num>:
源端元素编号
- <target_addr>:
目标设备的地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <target_element_num>:
目标端元素编号
- <bearer_toward_origin>:
向源地址方向的数据承载方式或接口编号
- <bearer_toward_target>:
向目标地址方向的数据承载方式或接口编号
AT+BLEMESHDF=ftd
功能说明
设置发现表能力状态。
命令格式
AT+BLEMESHDF=ftd,<dst>,<net_key_index>,<net_key_index_df>,<path_origin>,<path_target>
响应格式
[APP] receive forwarding table status: status 0, net_key_index 0x0000, path_origin 0x0110, dst 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <path_origin>:
指定要删除的转发表项的源地址
- <path_target>:
指定要删除的转发表项的目标地址
AT+BLEMESHDF=ftda
功能说明
添加转发表依赖节点。
命令格式
AT+BLEMESHDF=ftda,<dst>,<net_key_index>,<net_key_index_df>,<path_origin>,<path_target>,<dependent_origin_list_size>,<dependent_target_list_size>,[<do_addr1>,<do_addr1_element_num>,…<dt_addr1>,<dt_addr1_element_num>,…]
响应格式
[APP] receive forwarding table dependents status: status 18, net_key_index 0x0000, path_origin 0x0110, dst 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <path_origin>:
指定要删除的转发表项的源地址
- <path_target>:
指定要删除的转发表项的目标地址
- <dependent_origin_list_size>:
依赖的“源”节点数
- <dependent_target_list_size>:
依赖的“目标”节点数
- <do_addr1>:
第 1 个依赖源节点的地址
- <do_addr1_element_num>:
对应元素编号
- <dt_addr1>:
第 1 个依赖目标节点的地址
- <dt_addr1_element_num>:
对应元素编号
AT+BLEMESHDF=ftdd
功能说明
删除转发表依赖节点。
命令格式
AT+BLEMESHDF=ftdd,<dst>,<net_key_index>,<net_key_index_df>,<path_origin>,<path_target>,<dependent_origin_list_size>,<dependent_target_list_size>,[<do_addr1> ,…< dt_addr1> ,…]
响应格式
[APP] receive forwarding table dependents status: status 18, net_key_index 0x0000, path_origin 0x0110, dst 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <path_origin>:
指定要删除的转发表项的源地址
- <path_target>:
指定要删除的转发表项的目标地址
- <dependent_origin_list_size>:
依赖的“源”节点数
- <dependent_target_list_size>:
依赖的“目标”节点数
- <do_addr1>:
第 1 个依赖源节点的地址
- <dt_addr1>:
第 1 个依赖目标节点的地址
AT+BLEMESHDF=ftdg
功能说明
获取转发表项的依赖节点信息。
命令格式
AT+BLEMESHDF=ftdg,<dst>,<net_key_index>,<net_key_index_df>,<list_mask>,<fixed_path_flag>,<start_index>,<path_origin>,<path_target>,[<update_id>]
响应格式
[APP] receive forwarding table dependents get status: status 0, net_key_index 0x0000, dependents_list_mask 0x03, fixed_path_flag 1, start_index 0, path_origin 0x0110, dst 0x0120, forwarding_table_update_counter 2, dependents_origin_list_size 0, dependents_target_list_size 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <list_mask>:
依赖节点类型
Bit0: 是否返回 Path Origin 的依赖节点单播地址
Bit1: 是否返回 Path Target 的依赖节点单播地址
1 表示返回,0 表示不返回
- <fixed_path_flag>:
路径类型
0: 查询非固定路径的依赖节点
1: 查询固定路径的依赖节点
- <start_index>:
分页起始索引,从第几个依赖节点开始返回结果
- <path_origin>:
指定要查询的转发表项的源地址
- <path_target>:
指定要查询的转发表项的目标地址
- <update_id>:
调用时的版本控制编号
AT+BLEMESHDF=ftecg
功能说明
获取节点当前已配置的转发表项数量。
命令格式
AT+BLEMESHDF=ftecg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive forwarding table entries count status: status 0, net_key_index 0x0000, update id 2, fixed entries count 0, none fixed entries count 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=fteg
功能说明
获取节点当前已配置的转发表项。
命令格式
AT+BLEMESHDF=fteg,<dst>,<net_key_index>,<net_key_index_df>,<filter_mask>,<start_index>,[<path_origin>,<path_target>,<update_id>]
响应格式
[APP] receive forwarding table entries status: status 0, net_key_index 0x0000, filter_mask 1, start_index 0, path_origin 0x0000, dst 0x0000, counter 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <filter_mask>:
Bit0: 查询固定路径条目
Bit1: 查询非固定路径条目
Bit2: 路径起点匹配
Bit3: 路径终点匹配
- <path_origin>:
指定要查询的转发表项的源地址
- <path_target>:
指定要查询的转发表项的目标地址
- <update_id>:
调用时的版本控制编号
AT+BLEMESHDF=wlg
功能说明
获取所需路径。
命令格式
AT+BLEMESHDF=wlg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=wls
功能说明
设置所需路径。
命令格式
AT+BLEMESHDF=wls,<dst>,<net_key_index>,<net_key_index_df>,<wanted_lanes>
响应格式
[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 2
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <wanted_lanes>:
路径, 不能是 0
AT+BLEMESHDF=twpg
功能说明
获取双向路径路径。
命令格式
AT+BLEMESHDF=twpg,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive two way path status: status 0, net_key_index 0x0000, two way path 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=twps
功能说明
设置双向路径路径。
命令格式
AT+BLEMESHDF=twps,<dst>,<net_key_index>,<net_key_index_df>,<two_way_path>
响应格式
[APP] receive two way path status: status 0, net_key_index 0x0000, two way path 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <two_way_path>:
路径状态
0: 单向
1: 双向
AT+BLEMESHDF=peig
功能说明
获取回显探测的发送周期。
命令格式
AT+BLEMESHDF=peig,<dst>,<net_key_index>,<net_key_index_df>
响应格式
[APP] receive path echo interval status: status 4, net_key_index 0x0001, unicast echo interval 0, multicast echo interval 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
AT+BLEMESHDF=peis
功能说明
设置回显探测的发送周期。
命令格式
[APP] receive path echo interval status: status 0, net_key_index 0x0000, unicast echo interval 20, multicast echo interval 20
响应格式
[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index_df>:
状态归属密钥索引
- <unicast_echo_interval>:
单播路径回显间隔, 0 表示不更改
- <multicast_echo_interval>:
多播路径回显间隔, 0 表示不更改
AT+BLEMESHDF=dntg
功能说明
获取定向转发网络发送参数。
命令格式
AT+BLEMESHDF=dntg,<dst>,<net_key_index>
响应格式
[APP] receive directed network transmit status: count 6, steps 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=dnts
功能说明
设置定向转发网络发送参数。
命令格式
AT+BLEMESHDF=dnts,<dst>,<net_key_index>,<count>,<steps>
响应格式
[APP] receive directed network transmit status: count 1, steps 9
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <count>:
数量
[0, 7]
- <steps>:
步骤
[0, 31]
AT+BLEMESHDF=drrg
功能说明
获取定向转发中继重传参数。
命令格式
AT+BLEMESHDF=drrg,<dst>,<net_key_index>
响应格式
[APP] receive directed relay retransmit status: count 2, steps 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=drrs
功能说明
设置定向转发中继重传参数。
命令格式
AT+BLEMESHDF=drrs,<dst>,<net_key_index>,<count>,<steps>
响应格式
[APP] receive directed relay retransmit status: count 1, steps 9
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <count>:
数量
[0, 7]
- <steps>:
步骤
[0, 31]
AT+BLEMESHDF=rssitg
功能说明
获取 RSSI 门限设置状态。
命令格式
AT+BLEMESHDF=rssitg,<dst>,<net_key_index>
响应格式
[APP] receive rssi threshold status: default_rssi_threshold -80, rssi_margin 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=rssits
功能说明
设置 RSSI 门限设置状态。
命令格式
AT+BLEMESHDF=rssits,<dst>,<net_key_index>,<rssi_margin>
响应格式
[APP] receive rssi threshold status: default_rssi_threshold -80, rssi_margin 30
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <rssi_margin>:
RSSI
[0, 50]
AT+BLEMESHDF=dpg
功能说明
获取定向路径状态状态。
命令格式
AT+BLEMESHDF=dpg,<dst>,<net_key_index>
响应格式
[APP] receive directed paths status: directed_node_paths 20, directed_relay_paths 20, directed_proxy_paths 20, directed_friend_paths 20
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=dppg
功能说明
获取定向发布策略状态。
命令格式
AT+BLEMESHDF=dppg,<dst>,<net_key_index>,<element_addr>,<model_id>
响应格式
[APP] receive directed publish policy status: status 0, policy 0, elem_addr 0x0100, model id 0x1000ffff
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <element_addr>:
元素地址
- <model_id>:
模型 ID
AT+BLEMESHDF=dpps
功能说明
设置定向发布策略状态。
命令格式
AT+BLEMESHDF=dpps,<dst>,<net_key_index>,<policy>,<element_addr>,<model_id>
响应格式
[APP] receive directed publish policy status: status 0, policy 1, elem_addr 0x0100, model id 0x1000ffff
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <policy>:
策略状态
0: 泛洪发布
1: 定向发布
- <element_addr>:
元素地址
- <model_id>:
模型 ID
AT+BLEMESHDF=pdtcg
功能说明
获取发现时序控制状态。
命令格式
AT+BLEMESHDF=pdtcg,<dst>,<net_key_index>
响应格式
[APP] receive path discovery timing control status: path_monitoring_interval 120, path_discovery_retry_interval 300, path_discovery_interval 1, lane_discovery_guard_interval 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=pdtcs
功能说明
设置发现时序控制状态。
命令格式
AT+BLEMESHDF= pdtcs,<dst>,<net_key_index>,<monitor_interval>,<discovery_retry_interval>,<discovery_interval>,<lane_discovery_guard_interval>
响应格式
[APP] receive path discovery timing control status: path_monitoring_interval 100, path_discovery_retry_interval 200, path_discovery_interval 1, lane_discovery_guard_interval 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <monitor_interval>:
监控周期
- <discovery_retry_interval>:
发现重试间隔
- <discovery_interval>:
发现间隔
0: 5s
1: 30s
- <lane_discovery_guard_interval>:
路径发现保护间隔
0: 2s
1: 10s
AT+BLEMESHDF=dcntg
功能说明
获取定向控制网络传输参数。
命令格式
AT+BLEMESHDF=dcntg,<dst>,<net_key_index>
响应格式
[APP] receive directed control network transmit status: count 6, steps 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=dcnts
功能说明
设置定向控制网络传输参数。
命令格式
AT+BLEMESHDF=dcnts,<dst>,<net_key_index>,<count>,<steps>
响应格式
[APP] receive directed control network transmit status: count 1, steps 9
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <count>:
数量
[0, 7]
- <steps>:
步骤
[0, 31]
AT+BLEMESHDF=dcrrg
功能说明
获取定向控制中继传输参数。
命令格式
AT+BLEMESHDF=dcrrg,<dst>,<net_key_index>
响应格式
[APP] receive directed control relay retransmit status: count 2, steps 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHDF=dcrrs
功能说明
设置定向控制中继传输参数。
命令格式
AT+BLEMESHDF=dcrrs,<dst>,<net_key_index>,<count>,<steps>
响应格式
[APP] receive directed control relay retransmit status: count 1, steps 9
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <count>:
数量
[0, 7]
- <steps>:
步骤
[0, 31]
AT+BLEMESHSBR=sbg
功能说明
获取子网桥接状态。
命令格式
AT+BLEMESHSBR=sbg,<dst>,<net_key_index>
响应格式
[APP] Subnet bridge status: state 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHSBR=sbs
功能说明
设置子网桥接状态。
命令格式
AT+BLEMESHSBR=sbs,<dst>,<net_key_index>,<state>
响应格式
[APP] Subnet bridge status: state 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <state>:
子网桥接状态
0: 禁用
1: 启用
AT+BLEMESHSBR=bta
功能说明
添加到桥接列表。
命令格式
AT+BLEMESHSBR=bta,<dst>,<net_key_index>,<direction>,<net_key_index1>,<net_key_index2>,<addr1>,<addr2>
响应格式
[APP] Bridging table status: status 4, directions 1, net_key_index1 0x0001, net_key_index2 0x0002, addr1 0x0110, addr2 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <direction>:
路由方向
0: 禁用桥接
1: 只允许 addr1 到 addr2 的单向桥接
2: 允许双向桥接
- <net_key_index1>:
源子网网络密钥索引
- <net_key_index2>:
目标子网网络密钥索引
- <addr1>:
桥接起始地址
- <addr2>:
桥接目标地址
AT+BLEMESHSBR=btr
功能说明
从桥接列表移除。
命令格式
AT+BLEMESHSBR=btr,<dst>,<net_key_index>,<net_key_index1>,<net_key_index2>,<addr1>,<addr2>
响应格式
[APP] Bridging table status: status 4, directions 0, net_key_index1 0x0001, net_key_index2 0x0002, addr1 0x0110, addr2 0x0120
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index1>:
源子网网络密钥索引
- <net_key_index2>:
目标子网网络密钥索引
- <addr1>:
桥接起始地址
- <addr2>:
桥接目标地址
AT+BLEMESHSBR=bsg
功能说明
获取桥接子网。
命令格式
AT+BLEMESHSBR=bsg,<dst>,<net_key_index>,<filter>,<filter_net_key_index>,<start_index>
响应格式
[APP] Bridged subnets list: filter 1, net_key_index 0x0001, start_index 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <filter>:
过滤模式
0: 报告所有成对的子网密钥索引信息
1: 只报告第一个匹配的子网信息
2: 只报告第二个匹配的子网信息
3: 只报告匹配其中一个子网的信息
- <filter_net_key_index>:
用于过滤的子网密钥索引
- <start_index>:
结果的起始索引
AT+BLEMESHSBR=btbg
功能说明
获取桥接列表。
命令格式
AT+BLEMESHSBR=btbg,<dst>,<net_key_index>,<net_key_index1>,<net_key_index2>,<start_index>
响应格式
[APP] Bridging_table_list: status 4, net_key_index1 0x0001, net_key_index2 0x0002, start_index 0, bridged_addrs_list
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <net_key_index1>:
源子网网络密钥索引
- <net_key_index2>:
目标子网网络密钥索引
- <start_index>:
结果的起始索引
AT+BLEMESHSBR=btsg
功能说明
获取桥接列表大小。
命令格式
AT+BLEMESHSBR=btsg,<dst>,<net_key_index>
响应格式
[APP] Bridging table size status: table size 5
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHPRB=prbg
功能说明
获取专用信标状态。
命令格式
AT+BLEMESHPRB=prbg,<dst>,<net_key_index>
响应格式
Private beacon client receive: private beacon 0, random update interval steps 60
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHPRB=prbs
功能说明
设置专用信标状态。
命令格式
AT+BLEMESHPRB=prbs,<dst>,<net_key_index>,<private_beacon>[,<random_update_interval_steps>]
响应格式
Private beacon client receive: private beacon 1, random update interval steps 60
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <private_beacon>:
专用信标
0: 禁用
1: 启用
- <random_update_interval_steps>:
随机更新间隔步骤,
0: 每次专用信标均更新随机字段
[1, 255]: 每(10 * <random_update_interval_steps>)秒更新随机字段
AT+BLEMESHPRB=pgpg
功能说明
获取专用 GATT 代理状态。
命令格式
AT+BLEMESHPRB=pgpg,<dst>,<net_key_index>
响应格式
Private beacon client receive: private gatt proxy 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
AT+BLEMESHPRB=pgps
功能说明
设置专用 GATT 代理状态。
命令格式
AT+BLEMESHPRB=pgps,<dst>,<net_key_index>,<private_gatt_proxy>
响应格式
Private beacon client receive: private gatt proxy 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <private_gatt_proxy>:
专用 GATT 代理状态
0: 禁用
1: 启用
AT+BLEMESHPRB=pnig
功能说明
获取专用节点身份状态。
命令格式
AT+BLEMESHPRB=pnig,<dst>,<net_key_index>,<sub_net_key_index>
响应格式
Private beacon client receive: status 4, net_key_index 0x0001, private identity 0
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <sub_net_key_index>:
子网网络密钥索引
AT+BLEMESHPRB=pnis
功能说明
设置专用节点身份状态。
命令格式
AT+BLEMESHPRB=pnis,<dst>,<net_key_index>,<sub_net_key_index>,<private_identity>
响应格式
Private beacon client receive: status 0, net_key_index 0x0000, private identity 1
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <net_key_index>:
网络密钥索引
- <sub_net_key_index>:
子网网络密钥索引
- <private_identity>:
专用节点身份状态
0: 禁用
1: 启用
AT+BLEMESHDFU=init_upstart
功能说明
启动 DFU 发起者上传。
命令格式
AT+BLEMESHDFU=init_upstart,<dst>,<app_key_index>,<update_timeout_base>,<image_size>,[<version>/<data_len>[,<data>]]
响应格式
[APP] Receive Firmware Distribution Upload Status message, status:0.
[APP] BLOB param, blob size:1441664, block size:4096, total blocks:352, chunk size:256.
[APP] Transfer upload:progress, ---------- 0% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 0% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 0% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 1% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 1% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 1% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 1% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 2% ---------, client phase 2.
[APP] Transfer upload:progress, ---------- 2% ---------, client phase 2.
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <update_timeout_base>:
更新超时基数
- <image_size>:
固件大小
- <version>:
固件版本
- <data_len>:
固件数据长度
- <data>:
固件数据
AT+BLEMESHDFU=init_recadd
功能说明
添加需要升级的目标节点。
命令格式
AT+BLEMESHDFU=init_recadd,<dst>,<app_key_index>,<recv_num>,<addr>,…
响应格式
[APP] Receive Firmware Distribution Receivers Status message, status:0, list count:1.
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <recv_num>:
接收节点数量
- <addr>:
接收节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHDFU=init_recdela
功能说明
删除所有需要升级的目标节点。
命令格式
AT+BLEMESHDFU=init_recdela,<dst>,<app_key_index>
响应格式
[APP] Receive Firmware Distribution Receivers Status message, status:0, list count:0.
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
AT+BLEMESHDFU=init_disstart
功能说明
启动 DFU 发起者分发。
命令格式
AT+BLEMESHDFU=init_disstart,<dst>,<app_key_index>,<dist_app_key_index>,<dist_ttl>,<dist_timeout_base>,<dist_multicast_addr>
响应格式
[APP] Receive Firmware Distribution Status message, status:0.
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <dist_app_key_index>:
分发应用密钥索引
- <dist_ttl>:
分发 TTL
- <dist_timeout_base>:
分发超时基数
- <dist_multicast_addr>:
分发多播地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHDFU=stand_param
功能说明
设置独立升级器参数。
命令格式
AT+BLEMESHDFU=stand_param,<image_size>
响应格式
NULL
参数
- <image_size>:
FW 固件大小
AT+BLEMESHDFU=stand_add
功能说明
添加独立升级器接收节点。
命令格式
AT+BLEMESHDFU=stand_add,<addr>
响应格式
NULL
参数
- <addr>:
FW 固件接收节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
AT+BLEMESHDFU=stand_start
功能说明
开始独立升级。
命令格式
AT+BLEMESHDFU=stand_start,<dst>,<app_key_index>,<update_timeout_base>
响应格式
[APP] BLOB param, blob size:1292128, block size:4096, total blocks:316, chunk size:256
[APP] Type:transfer progress, --------------------- 0% ----------------, client phase:2.
[APP] Type:transfer progress, --------------------- 0% ----------------, client phase:2.
[APP] Type:transfer progress, --------------------- 0% ----------------, client phase:2.
[APP] Type:transfer progress, --------------------- 1% ----------------, client phase:2.
...
[APP] Type:transfer progress, --------------------- 99% ----------------, client phase:2.
[APP] Type:transfer progress, --------------------- 99% ----------------, client phase:2.
[APP] Type:transfer progress, --------------------- 100% ----------------, client phase:2.
[APP] Type:transfer success, num of node:1, 0x100, client phase:2.
[APP] Type:verify, num of node:1, 0x100, client phase:3.
[APP] Type:node fail for addr:0x100, client phase:4.
[APP] Type:complete, num of node:0, client phase:5.
参数
- <dst>:
目标节点地址, 包含 0x 的 2 字节十六进制数, 例如 0x0100
- <app_key_index>:
应用密钥索引
- <update_timeout_base>:
更新超时基数
LE Audio
AT+BLEBAP=escan
功能说明
开始或停止扩展扫描。
命令格式
AT+BLEBAP=escan,<enable/disable>
响应格式
开始扩展扫描:
BAP ext scan start successfully
[APP] Scan started, scan_type: 1
[APP] app_bt_le_audio_scan_dev_list_add add device(0 e0 4c 80 7 bc) in scan_dev list ok
[APP] app_bt_le_audio_bass_scan_report_handle broadcast scan add new device in list (addr: 00:E0:4C:80:07:BC, adv_sid 0, broadcast_id: 85 48 40)
停止扩展扫描:
BAP ext scan stop successfully
[APP] Scan stopped, reason: 0x0
[APP] app_bt_le_audio_scan_report_show show scan type 0x1 device list:
[APP] RemoteBd[0] = [00:e0:4c:80:07:bc], type 0
[APP] scan device list total num: 1
[APP] app_bt_le_audio_scan_report_show show scan type 0x2 device list:
[APP] scan device list total num: 0
参数
- <enable/disable>:
开始或停止扩展扫描
0: 停止扩展扫描
1: 开始扩展扫描
AT+BLEBAP=client_start
功能说明
BAP 单播客户端发起单播音频流。
命令格式
AT+BLEBAP=client_start,<group_idx>,<sink_context>,<source_context>
响应格式
bt_stack_le_audio_ready_to_start: device number 1
bt_stack_le_audio_select_media_prefer_codec: bap pacs get table msk from contex 0x4 sup_snk_mask 0xffff
bt_stack_le_audio_select_media_prefer_codec: codec_preferred_cfg_get: audio_cfg_type: 4, codec_cfg_item: 11, frame_duration: 0x01, sample_frequency: 0x08, codec_frame_blocks_per_sdu: 1, octets_per_codec_frame: 100, audio_channel_allocation: 0x00000000
BAP client start successfully
bt_stack_le_audio_group_cb: ase qos: phy 0x2, max_sdu: 200, retransmission_number: 5
[LEA STACK] bt_stack_le_audio_add_iso_chann iso_conn_handle 0x1b, direction 1
[LEA STACK] bt_stack_le_audio_handle_data_path_setup: iso handle 0x1b, frame_num 2, dir 1, sample_frequency 0x8, audio_channel_allocation 0x03, presentation_delay: [APP] RTK_BT_LE_AUDIO_EVT_BAP_SETUP_DATA_PATH_IND(group handle 605c17c0, session handle 605c1b40, dev_handle 605c1840, ase_id 1,path_direction=1,cis_conn_handle=0x1b,dev_num 1
[LEA STACK] app_bt_le_audio_lc3_codec_entity_add audio_channel_allocation=0x3, sample_frequency=0x8
[BT AUDIO] BT codec try to add one codec
[BT AUDIO] add codec type 8 !
[BT_AUDIO] lc3 codec init
[APP] app_bt_le_audio_cap_encode_data_control 1
[APP] app_bt_le_audio_send_timer_update: time_interval_us=10000
参数
- <group_idx>:
单播音频流组 ID, 默认是 0
- <sink_context>:
默认是 RTK_BT_LE_AUDIO_CONTEXT_MEDIA
- <source_context>:
默认是 RTK_BT_LE_AUDIO_CONTEXT_MEDIA
AT+BLEBAP=client_stop
功能说明
BAP 单播客户端停止单播音频流。
命令格式
AT+BLEBAP=client_stop,<group_idx>,<time_out>
响应格式
BAP client stop successfully
参数
- <group_idx>:
单播音频流组 ID
- <time_out>:
CIS 超时(毫秒)
AT+BLEBAP=client_release
功能说明
结束会话。
命令格式
AT+BLEBAP=client_release,<group_idx>
响应格式
BAP client release successfully
参数
- <group_idx>:
单播音频流组 ID
AT+BLEBAP=broadcast_start
功能说明
开始广播音频流。
命令格式
AT+BLEBAP=broadcast_start
响应格式
[LEA STACK] Update broadcast state: IDLE prefer state:STREAMING
[LEA STACK] Update broadcast state: CONFIGURED_STARTING prefer state:STREAMING
BAP start successfully
[LEA STACK] Update broadcast state: CONFIGURED prefer state:STREAMING
[LEA STACK] bt_stack_le_audio_broadcast_establish: num_bis:1, sdu_interval:10000, rtn: 4, max_sdu: 200, max_transport_latency: 20, phy:0x2, packing:0x0, framing:0x0, encryption: 0x0
[LEA STACK] Update broadcast state: STREAMING_STARTING prefer state:STREAMING
[LEA STACK] bt_stack_le_audio_broadcast_establish (source handle 0x605bdd40) Success
[LEA STACK] Update broadcast state: STREAMING prefer state:STREAMING
[BAP] broadcast source streaming
[LEA STACK] bt_stack_le_audio_add_iso_chann iso_conn_handle 0x1f, direction 1
[LEA STACK] bt_stack_le_audio_handle_data_path_setup: iso handle 0x1f, frame_num 2, dir 1, sample_frequency 0x8, audio_channel_allocation 0x03, presentation_delay: [APP] broadcast setup path indication: bis_idx: 0x1, bis_conn_handle 0x1f, cause: 0x0
[APP] broadcast setup path indication: iso_conn_handle: 0x1f, path_direction 0x1, cause: 0x0
[LEA STACK] app_bt_le_audio_lc3_codec_entity_add audio_channel_allocation=0x3, sample_frequency=0x8
[BT AUDIO] BT codec try to add one codec
[BT AUDIO] add codec type 8 !
[BT_AUDIO] lc3 codec init
[APP] app_bt_le_audio_cap_encode_data_control 1
[APP] app_bt_le_audio_send_timer_update: time_interval_us=10000
参数
NULL
AT+BLEBAP=broadcast_stop
功能说明
停止广播音频流。
命令格式
AT+BLEBAP=broadcast_stop
响应格式
[LEA STACK] Update broadcast state: STREAMING prefer state:IDLE
[LEA STACK] Update broadcast state: STREAMING_STOPPING prefer state:IDLE
[APP] broadcast remove path indication: bis_conn_handle 0x1f, cause: 0x0
BAP stop successfully
[APP] app_bt_le_audio_cap_encode_data_control 0
[BT_AUDIO] lc3 codec deinit
参数
NULL
AT+BLEBAP=pa_sync_create
功能说明
LE Audio BAP 广播接收端与广播源建立 PA 同步。
命令格式
AT+BLEBAP=pa_sync_create,<bd_addr_type>,<bd_addr>,<adv_sid>,<broadcast_id>
响应格式
bt_stack_le_audio_ext_scan_act: has already started
[APP] rtk_stack_le_audio_bap_msg_cback bt_stack_le_audio_sync_dev_find fail
LE_AUDIO_MSG_BASS_BRS_MODIFY: sync handle 605c0d80, source_id 1
[BAP] rtk_stack_le_audio_bap_msg_cback bt_stack_le_audio_sync_dev_find fail
[LEA STACK] bt_stack_le_audio_sync_dev_add sync_handle(605c0d80) in sync_handle list ok
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x0, pa_sync_state 3, big_sync_state 0
[APP] broadcast sink pa sync state change: sync_handle: 605c0d80, sync_state 0x3, action 0x1, cause: 0x0
BAP broadcast pa sync create successfully
bt_stack_le_audio_pa_sync_state_change GAP_PA_SYNC_STATE_SYNCHRONIZED
[LEA STACK] bt_stack_le_audio_sync_list_show sync device list:
[LEA STACK] bt_stack_le_audio_sync_list_show sync dev[0] : [00:e0:4c:80:07:bc], type 0, source_id 0, pa_sync_state 4, big_sync_state 0
[LEA STACK] bt_stack_le_audio_sync_list_show sync device list total num: 1
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x0, pa_sync_state 4, big_sync_state 0
[APP] broadcast sink pa sync state change: sync_handle: 605c0d80, sync_state 0x4, action 0x1, cause: 0x0
LE_AUDIO_MSG_BASS_BRS_MODIFY: sync handle 605c0d80, source_id 1
[APP] broadcast sink pa sync synchronized
[LEA STACK] support_bis_array 0x1
LE_AUDIO_MSG_BASS_BRS_MODIFY: sync handle 605c0d80, source_id 1
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x2, pa_sync_state 4, big_sync_state 0
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
Source 端的地址, 不包含 0x 的十六进制数
- <adv_sid>:
用于标识广播集的 ID
- <broadcast_id>:
可被扫描设备用于查找广播音频流的数据, 连续的三个 8 位字节, 不带 0x 前缀, 例如 8c,1e,23
AT+BLEBAP=pa_sync_remove
功能说明
停止广播音频流。
命令格式
AT+BLEBAP=pa_sync_remove,<bd_addr type>,<bd_addr>
响应格式
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x2, pa_sync_state 5, big_sync_state 0
[APP] broadcast sink pa sync state change: sync_handle: 605c0dc0, sync_state 0x5, action 0x2, cause: 0x0
BAP broadcast pa sync terminate successfully
bt_stack_le_audio_pa_sync_state_change GAP_PA_SYNC_STATE_TERMINATED
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x0, pa_sync_state 0, big_sync_state 0
[APP] broadcast sink pa sync state change: sync_handle: 605c0dc0, sync_state 0x0, action 0x2, cause: 0x16
LE_AUDIO_MSG_BASS_BRS_MODIFY: sync handle 605c0dc0, source_id 1
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
Source 端的地址, 不包含 0x 的十六进制数
AT+BLEBAP=big_sync_create
功能说明
与 Source 端建立 BIG 同步。
命令格式
AT+BLEBAP=big_sync_create,<bd_addr type>,<bd_addr>
响应格式
[LEA STACK] support_bis_array 0x1
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x3, pa_sync_state 4, big_sync_state 0
bt_stack_le_audio_check_sync: encryption = 0,big_sync_timeout = 100, num_bis = 1, bis[0]= 1
MSG_BLE_AUDIO_BIG_SYNC_STATE: sync_state 1, action 0, cause 0x0
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x3, pa_sync_state 4, big_sync_state 1
BAP broadcast big sync create successfully
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
Source 端的地址, 不包含 0x 的十六进制数
AT+BLEBAP=big_sync_remove
功能说明
与 Source 端停止 BIG 同步。
命令格式
AT+BLEBAP=big_sync_remove,<bd_addr type>,<bd_addr>
响应格式
MSG_BLE_AUDIO_BIG_SYNC_STATE: sync_state 3, action 0, cause 0x0
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x0, pa_sync_state 0, big_sync_state 3
BAP broadcast big sync terminate successfully
MSG_BLE_AUDIO_BIG_SYNC_STATE: sync_state 0, action 2, cause 0x0
[BT AUDIO] tarck num 1 record num 0
[LEA STACK] bt_stack_le_audio_check_sync: big_proc_flags 0x0, pa_sync_state 0, big_sync_state 0
LE_AUDIO_MSG_BASS_BRS_MODIFY: sync handle 605c0d80, source_id 1
[BT AUDIO] tarck num 1 record num 0
[BT AUDIO] tarck num 1 record num 0
[BT AUDIO] tarck num 1 record num 0
[BT_AUDIO] lc3 codec deinit
[GenTrack-I] time(52041250) track(0)
[GenTrack-I] time(52041372) track(0)
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
Source 端的地址, 不包含 0x 的十六进制数
AT+BLEBAP=remote_scan
功能说明
开始或停止远端扫描。
命令格式
AT+BLEBAP=remote_scan,<op>,<group_idx>
响应格式
开始远端扫描:
Broadcast assistant remote ext scan start successfully
[APP] Scan started, scan_type: 1
[APP] app_bt_le_audio_scan_dev_list_add add device(0 e0 4c 80 7 bc) in scan_dev list ok
[APP] app_bt_le_audio_bass_scan_report_handle broadcast scan add new device in list (addr: 00:E0:4C:80:07:BC, adv_sid 0, broadcast_id: 7c dc f6)
停止远端扫描:
Broadcast assistant remote ext scan stop successfully
[APP] Scan stopped, reason: 0x0
[APP] app_bt_le_audio_scan_report_show show scan type 0x1 device list:
[APP] scan device list total num: 0
[APP] app_bt_le_audio_scan_report_show show scan type 0x2 device list:
[APP] RemoteBd[0] = [00:e0:4c:80:07:bc], type 0, broadcast_id [7c:dc:f6]
[APP] scan device list total num: 1
参数
- <op>:
开始或停止远端扫描
0: 停止远端扫描
1: 开始远端扫描
- <group_idx>:
BAP 扫描代理组的组索引
AT+BLEBAP=reception_start
功能说明
BAP 广播助手启动对广播流同步信息的接收, 并将该信息传递至 BAP 扫描委托者。
命令格式
AT+BLEBAP=reception_start,<bd_addr_type>,<bd_addr>,<group_idx>
响应格式
bt_stack_le_audio_broadcast_assistant_reception_start: bass add source for sync_handle 605c0c00 ok
Broadcast assistant reception start successfully
[LEA STACK] bt_stack_le_audio_link_update_brs_char: instance id: 0
LE_AUDIO_MSG_BASS_CLIENT_SYNC_INFO_REQ: conn_handle 0x10, char_instance_id 0
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
BAP 扫描委托者地址, 不包含 0x 的十六进制数
- <group_idx>:
BAP 扫描委托者组索引
AT+BLEBAP=reception_stop
功能说明
BAP 广播助手停止对广播流同步信息的接收, 并将该信息传递至 BAP 扫描委托者。
命令格式
AT+BLEBAP=reception_stop,<bd_addr_type>,<bd_addr>,<group_idx>
响应格式
bt_stack_le_audio_broadcast_assistant_reception_stop: bass modify source for sync_handle 605c0c00 ok
Broadcast assistant reception stop successfully
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
BAP 扫描委托者地址, 不包含 0x 的十六进制数
- <group_idx>:
BAP 扫描委托者组索引
AT+BLEBAP=reception_remove
功能说明
BAP 广播助手移除 BAP 扫描委托者的广播流同步信息。
命令格式
AT+BLEBAP=reception_stop,<bd_addr_type>,<bd_addr>,<group_idx>
响应格式
bt_stack_le_audio_broadcast_assistant_reception_remove: bass remove source for sync_handle 605c0c00 ok
Broadcast assistant reception remove successfully
参数
- <bd_addr_type>:
地址类型
0: 公共地址
1: 随机地址
2: 公共身份地址
3: 随机身份地址
- <bd_addr>:
BAP 扫描委托者地址, 不包含 0x 的十六进制数
- <group_idx>:
BAP 扫描委托者组索引
AT+BLECAP=commander,vcp,gmute
功能说明
VCS 客户端按组更改 VCS 服务端的音量静音状态。
命令格式
AT+BLECAP=commander,vcp,gmute,<group_id>,<mute_state>
响应格式
vcp client gmute successfully
[APP] RTK_BT_LE_AUDIO_EVT_VCS_CLIENT_VOLUME_STATE_IND: conn_handle 16, is_notify 0x1, volume_setting 0x99, mute 0x1, change_counter 0x1
参数
- <mute_state>:
VCS 服务端的静音状态
0: 不静音
1: 静音
- <group_id>:
VCS 服务端的组 ID, 默认是 0
AT+BLECAP=commander,vcp,gvolume
功能说明
VCS 客户端按组改变音量。
命令格式
AT+BLECAP=commander,vcp,gvolume,<group_id>,<volume_setting>
响应格式
cp client gvolume successfully
[APP] RTK_BT_LE_AUDIO_EVT_VCS_CLIENT_VOLUME_STATE_IND: conn_handle 16, is_notify 0x1, volume_setting 0x64, mute 0x0, change_counter 0x3
[APP] RTK_BT_LE_AUDIO_EVT_VCS_CLIENT_VOLUME_FLAG_IND: conn_handle 16, is_notify 0x1,volume_flags 0x1
参数
- <group_id>:
VCS 服务端的组 ID, 默认是 0
- <volume_setting>:
设置的音量值
[0, 255]
AT+BLECAP=commander,vcp,get
功能说明
VCS 客户端获取音量状态。
命令格式
AT+BLECAP=commander,vcp,get,<conn_handle>
响应格式
vcp client get successfully
volume setting 64, mute 0, change_counter 3
参数
- <conn_handle>:
连接句柄
AT+BLECAP=acceptor,vcp,get
功能说明
VCS 服务端获取当前音量状态。
命令格式
AT+BLECAP=acceptor,vcp,get
响应格式
vcp server get successfully
参数
NULL
AT+BLECAP=commander,vcp,write
功能说明
VCS 客户端改变服务端的相对音量状态。
命令格式
AT+BLECAP=commander,vcp,write,<conn_handle>,<opcode>[,<volume_setting>]
响应格式
vcp client write successfully
[APP] RTK_BT_LE_AUDIO_EVT_VCS_CLIENT_VOLUME_STATE_IND: conn_handle 16, is_notify 0x1, volume_setting 0x53, mute 0x0, change_counter 0x4
参数
- <conn_handle>:
连接句柄
- <opcode>:
音量操作
0: 调低相对音量
1: 调高相对音量
2: 取消静音/调低相对音量
3: 取消静音/调高相对音量
4: 设置绝对音量
5: 取消静音
6: 静音
- <volume_setting>:
设置的音量,当<opcode>为 4 时需要此参数
[0, 255]
AT+BLECAP=commander,micp,gmute
功能说明
MICS 客户端按组设置 MICS 服务端静音状态。
命令格式
AT+BLECAP=commander,micp,gmute,<group_idx>,<mic_mute>
响应格式
micp client gmute successfully
参数
- <group_idx>:
组索引
- <mic_mute>:
MICS 服务端静音状态
0: 不静音
1: 静音
AT+BLECAP=commander,micp,set_mute
功能说明
MICS 客户端通过连线设置 MICS 服务端静音状态。
命令格式
AT+BLECAP=commander,micp,set_mute,<conn_handle>,<mic_mute>
响应格式
bt_stack_le_audio_mics_set_mute_value conn_handle=16 mic_mute=0
micp client set mute successfully
[APP] RTK_BT_LE_AUDIO_EVT_MICS_CLIENT_NOTIFY_IND: conn_handle 16,mic_mute 0
参数
- <conn_handle>:
连接句柄
- <mic_mute>:
MICS 服务端静音状态
0: 不静音
1: 静音
AT+BLECAP=commander,micp,get_mute
功能说明
MICS 客户端通过连线获取 MICS 服务端静音状态。
命令格式
AT+BLECAP=commander,micp,get_mute,<conn_handle>
响应格式
bt_stack_le_audio_mics_get_mute_value conn_handle=16 mic_mute=1
micp client get mute successfully
参数
- <conn_handle>:
连接句柄
AT+BLECAP=acceptor,micp,get
功能说明
MICS 服务端获取当前状态。
命令格式
AT+BLECAP=commander,micp,get
响应格式
micp server get successfully
参数
NULL
AT+BLECAP=commander,vocs,get_char
功能说明
VOCS 客户端通过连接获取 VOCS 服务端的特征值。
命令格式
AT+BLECAP=commander,vocs,get_char,<conn_handle>,<srv_instance_id>
响应格式
vocs client get char successfully
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 0, cause 0x0
[APP] vocs char input state: srv_instance_id 0, volume_offset 0, change_counter 0
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 1, cause 0x0
[APP] vocs char gain setting prop: srv_instance_id 0, audio_location 3
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 2, cause 0x0
[APP] vocs char output des: srv_instance_id 0, output_des_len 14, p_output_des Ameba Speaker
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
VOCS 服务端的服务实例 ID
AT+BLECAP=commander,vocs,get_srv
功能说明
VOCS 客户端通过连接获取 VOCS 服务端服务数据。
命令格式
AT+BLECAP=commander,vocs,get_srv,<conn_handle>,<srv_instance_id>
响应格式
vocs client get srv successfully
srv_instance_id 0x0, type_exist 0x3, volume_offset 0x0, change_counter 0x0, audio_location 0x3, output_des_len 0x0, p_output_des
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
VOCS 服务端的服务实例 ID
AT+BLECAP=commander,vocs,write
功能说明
VOCS 客户端设置 VOCS 服务端音量偏移量。
命令格式
AT+BLECAP=commander,vocs,write,<conn_handle>,<srv_instance_id>,<cp_op>,<volume_offset>
响应格式
vocs client write successfully
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_CP_RESULT_IND: conn_handle 0x10, cause 0x0, srv_instance_id 0, cp_op=1
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_NOTIFY_IND: conn_handle 0x10, srv_instance_id 0, type=0
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
VOCS 服务端的服务实例 ID
- <cp_op>:
操作代号
1: 设置音量偏移量
- <volume_offset>:
音量偏移量
[-255, 255]
AT+BLECAP=commander,vocs,gwrite
功能说明
VOCS 客户端按组设置 VOCS 服务端音量偏移量。
命令格式
AT+BLECAP=commander,vocs,gwrite,<group_index>,<srv_instance_id>,<cp_op>,<volume_offset>
响应格式
vocs client gwrite successfully
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_CP_RESULT_IND: conn_handle 0x10, cause 0x0, srv_instance_id 0, cp_op=1
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_NOTIFY_IND: conn_handle 0x10, srv_instance_id 0, type=0
参数
- <group_index>:
VOCS 服务端组索引, 默认是 0
- <srv_instance_id>:
VOCS 服务端的服务实例 ID
- <cp_op>:
操作码
1: 设置音量偏移量
- <volume_offset>:
音量偏移量
[-255, 255]
AT+BLECAP=commander,vocs,wdes
功能说明
VOCS 客户端向 VOCS 服务端写入输出描述信息。
命令格式
AT+BLECAP=commander,vocs,wdes,<conn_handle>,<srv_instance_id>,<des_str>
响应格式
vocs client wdes successfully
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_NOTIFY_IND: conn_handle 0x10, srv_instance_id 0, type=2
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
VOCS 服务端的服务实例 ID
- <des_str>:
输出描述信息字符串
AT+BLECAP=commander,aics,get_char
功能说明
AICS 客户端向 AICS 服务端写入输出描述信息。
命令格式
AT+BLECAP=commander,aics,get_char,<conn_handle>,<srv instance id>
响应格式
aics client get char successfully
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 0, cause 0x0
[APP] aics char input state: srv_instance_id 0, gain_setting 20, mute 0, gain_mode 2,change_counter 1
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 1, cause 0x0
[APP] aics char gain setting prop: srv_instance_id 0, gain_setting_units 50, gain_setting_min -100, gain_setting_max 100
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 2, cause 0x0
[APP] aics char input type: srv_instance_id 0, input type 1
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 3, cause 0x0
[APP] aics char input status: srv_instance_id 0, input status 1
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_READ_RESULT_IND: conn_handle 16,srv_instance_id 0, type 4, cause 0x0
[APP] aics char input des: srv_instance_id 0, input_des_len 16, p_input_des Ameba Bluetooth
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
AICS 服务端的服务实例 ID
AT+BLECAP=commander,aics,get_srv
功能说明
AICS 客户端通过连线从 AICS 服务端获取服务数据。
命令格式
AT+BLECAP=commander,aics,get_srv,<conn_handle>,<srv instance id>
响应格式
aics srv data: srv_instance_id 0, type_exist 0x1b,gain_setting 20, mute 0, gain_mode 2,change_counter 1, gain_setting_units 0x32,gain_setting_min -100,gain_setting_max 100,input_type 1,input_status 1,input_des_len 0, input_des
aics client get srv successfully
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
AICS 服务端的服务实例 ID
AT+BLECAP=commander,aics,write
功能说明
AICS 客户端写入操作码以更改 AICS 服务端上的音频输入状态。
命令格式
AT+BLECAP=commander,aics,write,<conn_handle>,<srv_instance_id>,<cp_op>,[<gaining_setting>]
响应格式
aics client write successfully
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_NOTIFY_IND: conn_handle 16,srv_instance_id 0, type 0
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_CP_RESULT_IND: conn_handle 16,srv_instance_id 0, cp_op 1, cause 0x0
参数
- <conn_handle>:
连接句柄
- <srv_instance_id>:
AICS 服务端的服务实例 ID
- <cp_op>:
操作码
1: 设置增益设定
2: 设置取消静音
3: 设置静音
4: 设置手动增益模式
5: 设置自动增益模式
- <gaining_setting>:
增益设定,只有<cp_op>为 1 时需要
[-255, 255]
AT+BLECAP=acceptor,aics,get
功能说明
AICS 服务端获取当前音频输入状态。
命令格式
AT+BLECAP=acceptor,aics,get,<srv_instance_id>,<param_type>
响应格式
aics param: srv_instance_id 0, gain_setting 20, mute 0, gain_mode 2,change_counter 1
aics server get successfully
参数
- <srv_instance_id>:
AICS 服务端的服务实例 ID
- <param_type>:
参数类型
1: 输入状态
2: 增益设定属性
3: 输入类型
4: 输入状态
5: 输入描述特征值
AT+BLECAP=commander,aics,gwrite
功能说明
AICS 客户端写入操作码以按组更改 AICS 服务端上的音频输入状态。
命令格式
AT+BLECAP=commander,aics,gwrite,<group_idx>,<srv_instance_id>,<cp_op>,[<gaining_setting>]
响应格式
aics client gwrite successfully
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_NOTIFY_IND: conn_handle 16,srv_instance_id 0, type 0
[APP] RTK_BT_LE_AUDIO_EVT_AICS_CLIENT_CP_RESULT_IND: conn_handle 16,srv_instance_id 0, cp_op 1, cause 0x0
参数
- <group_idx>:
对端设备组索引, 默认是 0
- <srv_instance_id>:
AICS 服务端的服务实例 ID
- <cp_op>:
操作码
1: 设置增益设定
2: 设置取消静音
3: 设置静音
4: 设置手动增益模式
5: 设置自动增益模式
- <gaining_setting>:
增益设定,只有<cp_op>为 1 时需要
[-255, 255]
AT+BLECAP=initiator,mcp,send
功能说明
MICS 服务端向 MICS 客户端发送状态。
命令格式
AT+BLECAP=initiator,mcp,send,<uuid>,[<value>]
响应格式
mcp media send successfully
参数
- <uuid>:
0x2B93: 发送媒体播放器名字
0x2B97: 发送曲目名称
0x2B98: 发送曲目时长
0x2B99: 发送曲目进度
0x2B96: 发送曲目改变
- <value>:
只有<uuid>是 0x2B98 和 0x2B99 时才需要
AT+BLECAP=acceptor,mcp,dis
功能说明
MICS 客户端在 MICS 服务端开始 GATTC 发现。
命令格式
AT+BLECAP=acceptor,mcp,dis,<conn_handle>
响应格式
mcp media discover successfully
[APP] RTK_BT_LE_AUDIO_EVT_MCP_CLIENT_DISCOVERY_DONE_IND(conn_handle 24,is_found 1, load_from_ftl 0, general_mcs 1, srv_num 1
[APP] Discovery done for conn_handle 24
[APP] RTK_BT_LE_AUDIO_EVT_MCP_CLIENT_DISCOVERY_DONE_IND(conn_handle 24,is_found 0, load_from_ftl 0, general_mcs 0, srv_num 0
参数
- <conn_handle>:
连接句柄
AT+BLECAP=acceptor,mcp,read
功能说明
MICS 客户端从 MICS 服务端读取特征。
命令格式
AT+BLECAP=acceptor,mcp,read,<conn_handle>,<char_uuid>
响应格式
mcp media read successfully
[APP] RTK_BT_LE_AUDIO_EVT_MCP_CLIENT_READ_RESULT_IND(cause 0x0, conn_handle 24, general_mcs 1, srv_instance_id 0, char_uuid 0x2b97
[APP] track_title_len 22, p_track_title RTK media trace title
参数
- <conn_handle>:
连接句柄
- <char_uuid>:
特征 UUID
0x2B93: 媒体播放器名字
0x2B97: 曲目名称
0x2B98: 曲目时长
0x2B99: 曲目进度
0x2BA3: 媒体状态
0x2BBA: 内容控制 ID
AT+BLECAP=acceptor,mcp,write
功能说明
MICS 客户端向 MICS 服务端写入操作码。
命令格式
AT+BLECAP=acceptor,mcp,write,<conn_handle>,<opcode>[,<op_param>]
响应格式
mcp media write successfully
[APP] RTK_BT_LE_AUDIO_EVT_MCP_CLIENT_NOTIFY_IND: conn_handle 24, general_mcs 1, srv_instance_id 0, char_uuid 0x2ba3,
media_state 1
[APP] RTK_BT_LE_AUDIO_EVT_MCP_CLIENT_MEDIA_CP_NOTIFY_IND conn_handle=0x18, general_mcs=1, srv_instance_id=0, requested_opcode=0x1, result_code=0x1
参数
- <conn_handle>:
连接句柄
- <opcode>:
操作码
0x1: 播放
0x2: 暂停
0x3: 回退
0x4: 快进
0x5: 停止
0x10: 相对移动
0x24: 跳转到段落
0x30: 上一曲目
0x31: 下一曲目
0x32: 第一曲目
0x33: 最后曲目
0x34: 跳转指定曲目
0x44: 跳转到分组
0xff: 打开或者关闭 CCCD
- <op_param>:
可选参数,只有当<opcode>是 0x10, 0x24, 0x34, 0x44 和 0xff 时需要
<opcode>是 0x10 时, <op_param>表示<offset>, 移动偏移量
<opcode>是 0x24 时, <op_param>表示<segment_number>, 段落编号
<opcode>是 0x34 时, <op_param>表示<track_number>, 曲目编号
<opcode>是 0x44 时, <op_param>表示<group_number>, 组编号
<opcode>是 0xff 时, <op_param> 0 表示关闭 CCCD, 1 表示打开 CCCD
BT A2DP
AT+BTA2DP=conn
功能说明
向对端设备发起 A2DP 连线。
命令格式
AT+BTA2DP=conn,<peer_addr>
响应格式
A2DP connecting to device 00:E0:4C:80:07:0F ...
[MEM] After do cmd, available heap 1982272
bt_stack_mgr_cback: link alloc success, hadnle 0x1
[BR GAP] ACL connection success 00:e0:4c:80:07:0f
[A2DP] SDP Scan 00:e0:4c:80:07:0f
bt_stack_mgr_cback: BT_EVENT_LINK_KEY_REQ
[BR GAP] Link Key Request received and found is 0x1
[A2DP Demo] Get Bond Number 1
[A2DP Demo] Get Bond addr 00:e0:4c:80:07:0f
app_a2dp_bt_cback: A2DP Connected
[A2DP] A2DP connection completion with 00:e0:4c:80:07:0f
app_avrcp_bt_cback: BT_EVENT_AVRCP_CONN_CMPL
[AVRCP] Connection Completion
[AVRCP] AVRCP connection completion with 00:e0:4c:80:07:0f
app_avrcp_bt_cback: BT_EVENT_AVRCP_PLAY_STATUS_CHANGED_REG_REQ
app_avrcp_bt_cback: send reister rsp to 00:e0:4c:80:07:0f, status is 0x00
app_a2dp_bt_cback: A2DP config: SBC
[BT AUDIO] BT codec try to add one codec
[BT AUDIO] add codec type 1 !
[BT_AUDIO] sbc codec init
[A2DP] Configure Complete CODEC 1
app_avrcp_bt_cback: BT_EVENT_AVRCP_VOLUME_CHANGED
[AVRCP] Volume changed 100
app_a2dp_bt_cback: A2DP STREAM is opened
[A2DP] A2DP STREAM is opened
[A2DP] A2DP stream open with 00:e0:4c:80:07:0f
[A2DP] A2DP stream open max packet length is 661
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTA2DP=disconn
功能说明
断开一条 A2DP 连线。
命令格式
AT+BTA2DP=disconn,<peer_addr>
响应格式
A2DP disconnecting to device 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1819584
#
app_a2dp_bt_cback: BT_EVENT_A2DP_STREAM_CLOSE
[A2DP] Stream close from 00:e0:4c:80:07:bb
app_a2dp_bt_cback: A2DP Disconnected
[BT_AUDIO] sbc codec deinit
[BT AUDIO] bt audio stream handle task exit
[BT_AUDIO] deinit complete !
[A2DP] A2DP disconnection completion with 00:e0:4c:80:07:bb
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTA2DP=start
功能说明
开始发送 A2DP 流。
命令格式
AT+BTA2DP=start,<peer_addr>
响应格式
A2DP starting to device 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1819776
#
[A2DP] RTK_BT_A2DP_EVT_STREAM_START_RSP from 00:e0:4c:80:07:bb
[A2DP Demo] Create Test Demo
app_avrcp_bt_cback: BT_EVENT_AVRCP_PLAY_STATUS_CHANGED_REG_REQ
app_avrcp_bt_cback: send reister rsp to 00:e0:4c:80:07:bb, status is 0x01
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTA2DP=suspend
功能说明
暂停发送 A2DP 流。
命令格式
AT+BTA2DP=suspend,<peer_addr>
响应格式
A2DP suspending to device 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1816768
#
app_a2dp_bt_cback: BT_EVENT_A2DP_STREAM_STOP
[A2DP] Stream stop from 00:e0:4c:80:07:bb
app_avrcp_bt_cback: BT_EVENT_AVRCP_PLAY_STATUS_CHANGED_REG_REQ
app_avrcp_bt_cback: send reister rsp to 00:e0:4c:80:07:bb, status is 0x00
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
BT AVRCP
AT+BTAVRCP=disconn
功能说明
断开一条 AVRCP 连线。
命令格式
AT+BTAVRCP=disconn,<peer_addr>
响应格式
AVRCP disconnecting to device 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1816512
#
app_avrcp_bt_cback: BT_EVENT_AVRCP_DISCONN_CMPL
[AVRCP] Disconnection Completion
[AVRCP] AVRCP disconnection completion with 00:e0:4c:80:07:bb
bt_stack_mgr_cback: BT_EVENT_ACL_CONN_ACTIVE
[BR GAP] ACL active 00:e0:4c:80:07:bb
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTAVRCP=<snk_cmd>
功能说明
SNK 客户端用来执行服务操作。
命令格式
AT+BTAVRCP=<snk_cmd>,<peer_addr>{,<volume>}
响应格式
<snk_cmd>是 pause 时:
AVRCP pause 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1816512
#
app_avrcp_bt_cback: BT_EVENT_AVRCP_PLAY_STATUS_CHANGED
[AVRCP]: status, 0x02
[AVRCP]: Paused
<snk_cmd>是 play 时:
AVRCP play 00:E0:4C:80:07:BB ...
[MEM] After do cmd, available heap 1816640
#
app_avrcp_bt_cback: BT_EVENT_AVRCP_PLAY_STATUS_CHANGED
[AVRCP]: status, 0x01
[AVRCP]: Playing
<snk_cmd>是 rewind_start 时, 对端响应:
[AVRCP]: Play req
app_avrcp_bt_cback: BT_EVENT_AVRCP_REWIND_START
<snk_cmd>是 rewind_stop 时, 对端响应:
app_avrcp_bt_cback: BT_EVENT_AVRCP_REWIND_STOP
[AVRCP]: Rewind stop req
<snk_cmd>是 fast_forward_start 时, 对端响应:
app_avrcp_bt_cback: BT_EVENT_AVRCP_FAST_FORWARD_START
[AVRCP]: Fast forward start req
<snk_cmd>是 fast_forward_stop 时, 对端响应:
app_avrcp_bt_cback: BT_EVENT_AVRCP_FAST_FORWARD_STOP
[AVRCP]: Fast forward stop req
<snk_cmd>是 forward 时, 对端响应:
app_avrcp_bt_cback: BT_EVENT_AVRCP_FORWARD
[AVRCP]: Forward req
<snk_cmd>是 backward 时, 对端响应:
app_avrcp_bt_cback: BT_EVENT_AVRCP_BACKWARD
[AVRCP]: Backward req
参数
- <snk_cmd>:
SNK 客户端命令
pause: 暂停音频
play: 播放音频
volume_change_req: 改变音频音量, 需要参数<volume>
rewind_start: 开始快退音频
rewind_stop: 停止快退音频
fast_forward_start: 开始快进音频
fast_forward_stop: 停止快进音频
forward: 跳转到下一首音频
backward: 跳转到上一首音频
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <volume>:
音量大小
[0, 100]
BT HFP
AT+BTHFP=conn
功能说明
建立 HFP 连线。
命令格式
AT+BTHFP=conn,<peer_addr>
响应格式
HFP connecting to device 00:E0:4C:80:06:14 ...
[MEM] After do cmd, available heap 8639328
#
bt_stack_mgr_cback: link alloc success, hadnle 0x2
[BR GAP] ACL connection success 00:e0:4c:80:06:14
BT_EVENT_ACL_ROLE_MASTER
[HFP] SDP Scan 00:e0:4c:80:06:14
bt_stack_mgr_cback: BT_EVENT_LINK_KEY_REQ
br_gap_app_callback, Unknown GAP RTK_BLE_EVT: 9
app_sdp_bt_cback: BT_EVENT_SDP_DISCOV_CMPL
[SDP] discovery complete cause 0x0
bt_stack_mgr_cback: BT_EVENT_LINK_KEY_INFO
br_gap_app_callback, Unknown GAP RTK_BLE_EVT: 10
app_hfp_bt_cback: BT_EVENT_HFP_AG_INDICATORS_STATUS_REQ
[HFP] Receive AG indicators req from 00:e0:4c:80:06:14
app_hfp_bt_cback: BT_EVENT_HFP_AG_CONN_CMPL
[HFP] Receive AG connection completion from 00:e0:4c:80:06:14
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTHFP=disconn
功能说明
断开 HFP 连线。
命令格式
AT+BTHFP=disconn,<peer_addr>
响应格式
HFP disconnecting to device 00:E0:4C:80:06:14 ...
[MEM] After do cmd, available heap 8637888
#
bt_stack_mgr_cback: BT_EVENT_ACL_CONN_ACTIVE
[BR GAP] ACL active 00:e0:4c:80:06:14
app_hfp_bt_cback: BT_EVENT_HFP_AG_DISCONN_CMPL
[HFP] Receive AG disconnection completion from 00:e0:4c:80:06:14
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTHFP=call_income
功能说明
通知来电。
命令格式
AT+BTHFP=call_income,<peer_addr>,<call_num>,<call_num_type>
响应格式
app_hfp_bt_cback: BT_EVENT_HFP_AG_CALL_STATUS_CHANGED
[HFP] Receive AG call status change from 0 to 1 from 00:e0:4c:80:0e:41
HFP call income to device 00:E0:4C:80:0E:41 ... number is 10086 length is 5 type is 0
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <call_num>:
来电号码, 最大长度 20
- <call_num_type>:
来电号码类型
AT+BTHFP=call_answer
功能说明
接听正在呼叫中的来电或去电。
命令格式
AT+BTHFP=call_answer,<peer_addr>
响应格式
HFP call answer req to device 00:E0:4C:80:0E:55 ...
[MEM] After do cmd, available heap 1871680
#
app_hfp_bt_cback: BT_EVENT_HFP_CALL_STATUS
[HFP] Receive HFP call status change from 1 to 3 from 00:e0:4c:80:0e:55
[HFP] ring alert outband inactive
[GenTrack-I] time(608735964) track(0)
[GenTrack-I] time(608736206) track(0)
app_hfp_bt_cback: BT_EVENT_SCO_CONN_IND
[HFP] Receive HFP SCO connection from 00:e0:4c:80:0e:55
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTHFP=call_terminate
功能说明
挂断正在呼叫中的来电或去电。
命令格式
AT+BTHFP=call_terminate,<peer_addr>
响应格式
HFP call terminate req to device 00:E0:4C:80:0E:55 ...
[MEM] After do cmd, available heap 1907072
#
app_hfp_bt_cback: BT_EVENT_HFP_CALL_STATUS
[HFP] Receive HFP call status change from 3 to 0 from 00:e0:4c:80:0e:55
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTHFP=batt_level_report
功能说明
发命令报告当前电量等级。
命令格式
AT+BTHFP=batt_level_report,<peer_addr>,<power_level>
响应格式
HFP batt level report to device 00:E0:4C:80:06:2B ...
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <power_level>:
电量等级
[0, 100]
AT+BTHFP=speaker_gain_report
功能说明
发命令同步扬声器增益等级。
命令格式
AT+BTHFP=speaker_gain_report,<peer_addr>,<gain>
响应格式
HFP speaker gain report to device 00:E0:4C:80:06:2B ...
[MEM] After do cmd, available heap 8636928
#
bt_stack_mgr_cback: BT_EVENT_ACL_CONN_ACTIVE
[BR GAP] ACL active 00:e0:4c:80:06:2b
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <gain>:
增益等级
[0, 15]
AT+BTHFP=microphone_gain_report
功能说明
发命令同步麦克风增益等级。
命令格式
AT+BTHFP=microphone_gain_report,<peer_addr>,<gain>
响应格式
HFP microphone gain report to device 00:E0:4C:80:06:2B ...
[MEM] After do cmd, available heap 8636928
#
bt_stack_mgr_cback: BT_EVENT_ACL_CONN_ACTIVE
[BR GAP] ACL active 00:e0:4c:80:06:2b
参数
- <peer_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <gain>:
增益等级
[0, 15]
BT SPP
AT+BTSPP=conn
功能说明
与 SPP 客户端建立连线。
命令格式
AT+BTSPP=conn,<bd_addr>
响应格式
[bt_stack_spp_connect] SPP server stop inquiry failed!
[bt_stack_spp_connect] SPP server start sdp discov success!
SPP connecting to device 00:E0:4C:80:0E:55 ...
[MEM] After do cmd, available heap 2380672
#
bt_stack_mgr_cback: link alloc success, hadnle 0x2
[BR GAP] ACL connection success 00:e0:4c:80:0e:55
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_ATTR_INFO The uuid is registered and the local server channel is bonded
bt_stack_spp_evt_ind_cback: local server channel is 0x3, remote server channel is 0x3
[SPP] SPP sdp attr info from 00:e0:4c:80:0e:55
[SPP] UUID type is uuid16
[SPP] uuid16 is : 0x1101
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_ATTR_INFO The uuid is registered and the local server channel is bonded
bt_stack_spp_evt_ind_cback: local server channel is 0x4, remote server channel is 0x4
[SPP] SPP sdp attr info from 00:e0:4c:80:0e:55
[SPP] UUID type is uuid128
[SPP] uuid128 is : 6a 24 ee ab 4b 65 46 93 98 6b 3c 26 c3 52 26 4f
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_DISCOV_CMPL SDP Discovery Completely
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_DISCOV_CMPL send spp connection request success
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_DISCOV_CMPL SDP Discovery Completely
[SPP] SPP sdp discov cmpl from 00:e0:4c:80:0e:55
bt_stack_spp_evt_ind_cback: BT_EVENT_SDP_DISCOV_CMPL send spp connection request success
[SPP] SPP sdp discov cmpl from 00:e0:4c:80:0e:55
bt_stack_mgr_cback: BT_EVENT_LINK_KEY_REQ
br_gap_app_callback, Unknown RTK_BT_BR_GAP_EVT: 8
[SPP] SPP connection completion with 00:e0:4c:80:0e:55, server channel: 0x3, frame size: 244, link credit: 7
[SPP] SPP TX test to 00:e0:4c:80:0e:55, server channel: 0x3
bt_stack_spp_send_data: link credit is 6
[SPP] Send SPP tx test data success
[SPP] SPP connection completion with 00:e0:4c:80:0e:55, server channel: 0x4, frame size: 244, link credit: 7
[SPP] SPP TX test to 00:e0:4c:80:0e:55, server channel: 0x4
bt_stack_spp_send_data: link credit is 6
[SPP] Send SPP tx test data success
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTSPP=disconn
功能说明
断开特定的 SPP 信道。
命令格式
AT+BTSPP=disconn,<bd_addr>,<channel_idx>
响应格式
SPP send disconnect request to device 00:E0:4C:80:06:2B ,server channel 0x3
[MEM] After do cmd, available heap 8637792
#
[SPP] SPP disconnection completion with 00:e0:4c:80:06:2b, server channel: 0x3
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <channel_idx>:
信道索引, 例如 0x03
AT+BTSPP=disconn_all
功能说明
断开所有的 SPP 信道。
命令格式
AT+BTSPP=disconn_all,<bd_addr>
响应格式
SPP disconnecting to device 00:E0:4C:80:06:2B ...
[MEM] After do cmd, available heap 8638016
#
[SPP] SPP disconnection completion with 00:e0:4c:80:06:2b, server channel: 0x4
bt_stack_mgr_cback: BT_EVENT_ACL_CONN_ACTIVE
[BR GAP] ACL active 00:e0:4c:80:06:2b
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTSPP=send_data
功能说明
通过特定信道向 SPP 客户端发送数据。
命令格式
AT+BTSPP=send_data,<bd_addr>,<channel_idx>,<data>
响应格式
bt_stack_spp_send_data: link credit is 5
SPP send data to device 00:E0:4C:80:06:2B ,server channel 0x3 success!
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <channel_idx>:
信道索引, 例如 0x03
- <data>:
发送的数据, 不包含 0x 的十六进制字符串, 例如 0102030405060708
AT+BTSPP=give_credits
功能说明
SPP 服务器向 SPP 客户端分配链路信用额度。
命令格式
AT+BTSPP=give_credits,<bd_addr>,<channel_idx>,<credits_value>
响应格式
SPP give 20 credits to device 00:E0:4C:80:06:2B ,server channel 0x3 success!
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <channel_idx>:
信道索引, 例如 0x03
- <credits_value>:
分配的信用额度
BT RFCOMM
AT+BTRFC=conn
功能说明
与 RFCOMM 服务端建立连线。
命令格式
AT+BTRFC=conn,<bd_addr>
响应格式
RFC connecting to device 00:E0:4C:80:06:2B ...
[MEM] After do cmd, available heap 8640064
#
bt_stack_mgr_cback: link alloc success, hadnle 0x1
[BR GAP] ACL connection success 00:e0:4c:80:06:2b
BT_EVENT_ACL_ROLE_MASTER
bt_stack_rfc_evt_ind_cback: BT_EVENT_SDP_ATTR_INFO
[RFC] SDP Scan 00:e0:4c:80:06:2b
[RFC] UUID type is UUID128
[RFC] uuid128 is : 6a 24 ee ab 4b 65 46 93 98 6b 3c 26 c3 52 26 4f
bt_stack_mgr_cback: BT_EVENT_LINK_KEY_REQ
br_gap_app_callback, Unknown RTK_BT_BR_GAP_EVT: 9
app_sdp_bt_cback: BT_EVENT_SDP_DISCOV_CMPL
[SDP] discovery complete cause 0x0
app_rfc_cback: BT_RFC_MSG_CONN_CMPL
[RFC] connection completion from 00:e0:4c:80:06:2b
[RFC] Local server chann is 0x03, frame size is 0x1012, rapp_rfc_cback: BT_RFC_MSG_CREDIT_INFO
emain_credits is 0x7
[RFC] server channel:0x3, remain credits:100
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTRFC=disconn
功能说明
与 RFCOMM 服务端断开连线。
命令格式
AT+BTRFC=disconn,<bd_addr>
响应格式
RFC send disconnect request to device 00:E0:4C:80:06:2B
[MEM] After do cmd, available heap 8638944
#
app_rfc_cback: BT_RFC_MSG_DISCONN_CMPL
[RFC] disconnection completion with 00:e0:4c:80:06:2b
[RFC] Local server chann is 0x03, cause is 0x0000
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
AT+BTRFC=send_data
功能说明
通过特定信道向 RFC 服务端发送数据。
命令格式
AT+BTRFC=send_data,<bd_addr>,<channel_idx>,<data>
响应格式
RFC send data to device 00:E0:4C:80:06:2B ,server channel 0x3 success!
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <channel_idx>:
信道索引, 例如 0x03
- <data>:
发送的数据, 不包含 0x 的十六进制字符串, 例如 0102030405060708
AT+BTRFC=give_credits
功能说明
RFCOMM 客户端向对端 RFCOMM 设备分配链路信用额度。
命令格式
AT+BTRFC=give_credits,<bd_addr>,<channel_idx>,<credits_value>
响应格式
RFC give 20 credits to device 00:E0:4C:80:06:2B ,server channel 0x3 success!
参数
- <bd_addr>:
对端地址, 不包含 0x 的十六进制数, 例如 010203040506
- <channel_idx>:
信道索引, 例如 0x03
- <credits_value>:
分配的信用额度