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=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>:

分配的信用额度