Demo

AT+BTDEMO=peripheral

Functional Description

Initialize or deinitialize peripheral application.

Command Format

AT+BTDEMO=peripheral,<op>

Response Format

If <op> is 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

If <op> is 0:

peripheral example disable OK!

Parameters

<op>:

initialize or deinitialize peripheral application.

  • 0: deinitialize Peripheral application

  • 1: initialize Peripheral application

AT+BTDEMO=central

Functional Description

Initialize or deinitialize Central application

Command Format

AT+BTDEMO=central,<op>

Response Format

If <op> is 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!

If <op> is 0:

central example disable OK!

Parameters

<op>:

Initialize or deinitialize Central application

  • 0: deinitialize Central application

  • 1: initialize Central application

AT+BTDEMO=scatternet

Functional Description

initialize or deinitialize Scatternet application。

Command Format

AT+BTDEMO=scatternet,<op>

Response Format

If <op> is 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

If <op> is 0:

scatternet example disable OK!

Parameters

<op>:

Initialize or deinitialize Scatternet application

  • 0: deinitialize Scatternet application

  • 1: initialize Scatternet application

AT+BTDEMO=provisioner

Functional Description

initialize or deinitialize Mesh Provisioner application。

Command Format

AT+BTDEMO=provisioner,<op>

Response Format

If <op> is 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!

If <op> is 0:

mesh provisioner example disable OK!

Parameters

<op>:

Initialize or deinitialize Mesh Provisioner application

  • 0: deinitialize Mesh Provisioner application

  • 1: initialize Mesh Provisioner application

AT+BTDEMO=device

Functional Description

Initialize or deinitialize Mesh Device application。

Command Format

AT+BTDEMO=device,<op>

Response Format

If <op> is 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

If <op> is 0:

mesh device example disable OK!

Parameters

<op>:

Initialize or deinitialize Mesh Device application

  • 0: deinitialize Mesh Device application

  • 1: initialize Mesh Device application

AT+BTDEMO=generic_le_audio_demo,initiator

Functional Description

Initialize or deinitialize LE Audio Initiator application。

Command Format

AT+BTDEMO=generic_le_audio_demo,initiator,<op>

Response Format

If <op> is 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!

If <op> is 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!

Parameters

<op>:

Initialize or deinitialize LE Audio Initiator application

  • 0: deinitialize LE Audio Initiator application

  • 1: initialize LE Audio Initiator application

AT+BTDEMO=generic_le_audio_demo,acceptor

Functional Description

Initialize or deinitialize LE Audio Acceptor application。

Command Format

AT+BTDEMO=generic_le_audio_demo,acceptor,<op>,<sound_channel>

Response Format

If <op> is 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!

If <op> is 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!

Parameters

<op>:

Initialize or deinitialize LE Audio Acceptor application

  • 0: deinitialize LE Audio Acceptor application

  • 1: initialize LE Audio Acceptor application

<sound_channel>:

sound channel

  • left: left sound channel

  • right: right sound channel

  • stereo: stereo sound channel

AT+BTDEMO=a2dp

Functional Description

Initialize or deinitialize A2DP application。

Command Format

AT+BTDEMO=a2dp,<role>,<op>

Response Format

If <op> is 1, take A2DP Sink as example:

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!

If <op> is 0, take A2DP Sink as example:

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!

Parameters

<role>:

A2DP role

  • snk: Sink role

  • src: Source role

<op>:

Initialize or deinitialize A2DP application

  • 0: deinitialize A2DP application

  • 1: initialize A2DP application

AT+BTDEMO=spp

Functional Description

Initialize or deinitialize SPP application。

Command Format

AT+BTDEMO=spp,<role>,<op>

Response Format

If <op> is 1, take SPP Client role as example:

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!

If <op> is 0, take SPP Client role as example:

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!

Parameters

<role>:

SPP role - client: Client role - server: Server role

<op>:

Initialize or deinitialize SPP application

  • 0: deinitialize SPP application

  • 1: initialize SPP application

AT+BTDEMO=hfp

Functional Description

Initialize or deinitialize HFP application。

Command Format

AT+BTDEMO=hfp,<role>,<op>

Response Format

If <op> is 1, take HFP Audio Gate role as example:

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!

If <op> is 0, take HFP Audio Gate role as example:

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!

Parameters

<role>:

HFP role

  • ag: Audio Gate role

  • hf: Hand Free role

<op>:

Initialize or deinitialize HFP application

  • 0: deinitialize HFP application

  • 1: initialize HFP application

AT+BTDEMO=ble_wifimate_configurator

Functional Description

Initialize or deinitialize WiFiMate Configurator application。

Command Format

AT+BTDEMO=ble_wifimate_configurator,<op>

Response Format

If <op> is 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

If <op> is 0:

ble wifimate configurator example disable OK!

Parameters

<op>:

Initialize or deinitialize WiFiMate Configurator application

  • 0: deinitialize WiFiMate Configurator application

  • 1: initialize WiFiMate Configurator application

AT+BTDEMO=ble_wifimate_device

Functional Description

Initialize or deinitialize WiFiMate Device application。

Command Format

AT+BTDEMO=ble_wifimate_device,<op>

Response Format

If <op> is 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

If <op> is 0:

Ble wifimate device example disable OK!

Parameters

<op>:

Initialize or deinitialize WiFiMate Device application

  • 0: deinitialize WiFiMate Device application

  • 1: initialize WiFiMate Device application

BLE GAP

AT+BLEGAP=version

Functional Description

This command is used to get device’s version.

Command Format

AT+BLEGAP=version

Response Format

GAP get version, hci_revision: 0x55c, lmp_subversion: 0x1a52, btgap_revision: 0x0, btgap_buildnum: 0x39c

Parameters

NULL

AT+BLEGAP=addr

Functional Description

This command is used to get device’s bd_addr.

Command Format

AT+BLEGAP=addr

Response Format

GAP get bd_addr: <addr>[<addr_type>]

Parameters

<addr>:

Bluetooth Address

<addr_type>:

Bluetooth Address Type

  • public: Public Device Address

  • random: Random Device Address

AT+BLEGAP=channel

Functional Description

This command is used to set host channel classification.

Command Format

AT+BLEGAP=channel,<channel_map>

Response Format

GAP set channel map success

Parameters

<channel_map>:

hexnum with 0x (5 octets), contains 37 1-bit fields, the most significant bits are reserved and shall be set to 0 for future use

AT+BLEGAP=dev_state

Functional Description

This command is used to get device’s state information.

Command Format

AT+BLEGAP=dev_state

Response Format

GAP dev state, init_state: 1, adv_state: 0, scan_state: 0, conn_state: 0

Parameters

NULL

AT+BLEGAP=name

Functional Description

This command is used to set device name.

Command Format

AT+BLEGAP=name,<device_name>

Response Format

GAP set device name success

Parameters

<device_name>:

ASCII string

AT+BLEGAP=appear

Functional Description

This command is used to set device appearance.

Command Format

AT+BLEGAP=appear,<appearance_code>

Response Format

GAP set device appearance success

Parameters

<appearance_code>:

integer num

AT+BLEGAP=set_mtu

Functional Description

This command is used to set default MTU size.

Command Format

AT+BLEGAP=set_mtu,<mtu_size>

Response Format

GAP set device appearance success

Parameters

<mtu_size>:

MTU size

  • [0, 0xFFFF]

AT+BLEGAP=pre_conn_param

Functional Description

This command is used to set device preferred connection parameters.

Command Format

AT+BLEGAP=pre_conn_param,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<timeout>

Response Format

conn_interval_min=0x10,conn_interval_max=0x100,slave_latency=0x2,supervision_timeout=0x1f4
GAP set preferred conn param success

Parameters

<conn_interval_min>:

minimum connection interval

  • [0x0006, 0x0C80]

  • minimum connection interval = <conn_interval_min> * 1.25ms, range from 7.5ms to 4s

<conn_interval_max>:

maximum connection interval

  • [0x0006, 0x0C80]

  • maximum connection interval = <conn_interval_max> * 1.25ms, range from 7.5ms to 4s

<conn_latency>:

slave connection latency

  • [0x0000, 0x01F3]

<timeout>:

connection supervision timeout

  • [0x000A, 0x0C80]

  • connection supervision timeout = <supv_timeout> * 10ms, range from 100ms to 32s

AT+BLEGAP=rand_addr

Functional Description

This command is used to set random address in controller.

Command Format

AT+BLEGAP=rand_addr,<addr>[,<type>]

Response Format

GAP set random address success, auto_generate: 0, random_addr: 11:22:33:44:55:66

Parameters

<addr>:

The Random Device Address to set.

<type>:

Bluetooth Address Type

  • If host auto generate a random address to set to controller, param <type> will be used, and param <addr> can be input as any value

AT+BLEGAP=adv_data

Functional Description

This command is used to set adv data.

Command Format

AT+BLEGAP=adv_data[,<data>]

Response Format

GAP set default adv data success

Parameters

<data>:

hexdata No 0x, if param in [] is none, default adv data in atcmd will be used

示例

AT+BLEGAP=adv_data,02010508095265616c74656b
OK

//02: length of flag
//01: type is flag
//05: LE limited discoverable and BR/EDR not supported
//08: length of local name
//09: type is complete local name
//5265616c74656b: The ASCII value of the string "Realtek", which is the local name in the advertising data.

AT+BLEGAP=scan_rsp

Functional Description

This command is used to set scan response data.

Command Format

AT+BLEGAP=scan_rsp[,<data>]

Response Format

GAP set def scan resp data success

Parameters

<data>:

hexdata No 0x, if param in [] is none, default scan rsp data in atcmd will be used

AT+BLEGAP=adv

Functional Description

This command is used to start adv with adv param or stop adv.

Command Format

AT+BLEGAP=adv,<op>[,<type>,<own_addr_type>,<filter_policy>[,<peer_addr_type>,<peer_addr>[,<interval_min>,<interval_max>,<channel_map>]]]

Response Format

[APP] ADV started: adv_type 0

or

[APP] ADV stopped: reason 0x0

Parameters

<op>:

adv operation

  • 1: start adv

  • 0: stop adv

<type>:

adv type

  • 0: Connectable and scannable undirected advertising

  • 1: Connectable high duty cycle directed advertising

  • 2: Scannable undirected advertising

  • 3: Non connectable undirected advertising

  • 4: Connectable low duty cycle directed advertising

<own_addr_type>:

local address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<filter_policy>:
  • 0: Allow both scan and connection requests from anyone

  • 1: Allow both scan request from White List devices only and connection request from anyone

  • 2: Allow both scan request from anyone and connection request from White List devices only

  • 3: Allow scan and connection requests from White List devices only

<peer_addr_type>:

Address type of the peer device

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<peer_addr>:

Address of the peer device

<interval_min>:

minimum adv interval

  • [0x20, 0x4000]

  • minimum adv interval = <interval_min> * 0.625ms, range from 20ms to 10.24s

<interval_max>:

maximum adv interval

  • [0x20, 0x4000]

  • maximum adv interval = <interval_max> * 0.625ms, range from 20ms to 10.24s

<channel_map>:
  • 0x01: Channel 37 shall be used

  • 0x02: Channel 38 shall be used

  • 0x04: Channel 39 shall be used

  • 0x07: all channels enabled

AT+BLEGAP=scan_param

Functional Description

This command is used to set scan parameters.

Command Format

AT+BLEGAP=scan_param[,<type>,<own_addr_type>,<filter_policy>,<duplicate_opt>[,<interval>,<window>]]

Response Format

GAP set scan param success

Parameters

<type>:

scan tyep

  • 0: passive scan

  • 1: active scan

<own_addr_type>:

local address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<filter_policy>:
  • 0: Allow both scan and connection requests from anyone

  • 1: Allow both scan request from White List devices only and connection request from anyone

  • 2: Allow both scan request from anyone and connection request from White List devices only

  • 3: Allow scan and connection requests from White List devices only

<duplicate_opt>:
  • 0: disable duplicate filter

  • 1: enable duplicate filter

<interval>:

scan interval

  • [0x4, 0x4000]

  • scan interval = <interval> * 0.625ms, range from 2.5ms to 10.24s

<window>:

scan window

  • [0x4, 0x4000]

  • scan window = <window> * 0.625ms, range from 2.5ms to 10.24s

Note

The scan interval cannot be smaller than the scan window.

AT+BLEGAP=scan_info_filter

Functional Description

This command is used to enable or disable scan information filter.

Command Format

AT+BLEGAP=scan_info_filter,<op>[,<offset>,<filter_data>]

Response Format

GAP scan info filter set success

Parameters

<op>:

enable or disable scan info filter

  • 0: enable scan info filter

  • 1: disable scan, param in [] is useless

<offset>:

the byte offset of the filter data in scanned information

<filter_data>:

the string that need to filter from scan information

AT+BLEGAP=scan

Functional Description

This command is used to start or stop scanning.

Command Format

AT+BLEGAP=scan,<op>

Response Format

[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

or

[APP] Scan stopped, reason: 0x0

Parameters

<op>:

enable or disable scan

  • 0: enable scan

  • 1: disable scan

AT+BLEGAP=conn

Functional Description

This command is used to initiate a connection to remote device.

Command Format

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>]]

Response Format

[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

Note

If the BLE connection is successfully established, the peer device will display the following prompt:

[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

Parameters

<peer_addr_type>:

Peer Address Type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<own_addr_type>:

Local Address Type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<filter_policy>:
  • 0: whitelist is not used

  • 1: whitelist is used

<scan_interval>:

scan interval

  • [0x4, 0x4000]

  • scan interval = <scan_interval> * 0.625ms, range from 2.5ms to 10.24s

<scan_window>:

scan window

  • [0x4, 0x4000]

  • scan window = <scan_window> * 0.625ms, range 2.5ms to 10.24s

<conn_interval_min>:

minimum connection interval

  • [0x6, 0x0C80]

  • minimum connection interval = <conn_interval_min> * 1.25ms, range from 7.5ms to 4s

<conn_interval_max>:

maximum connection interval

  • [0x6, 0x0C80]

  • maximum connection interval = <conn_interval_max> * 1.25ms, range from 7.5ms to 4s

<conn_latency>:

slave connection latency

  • [0, 0x01F3]

<supv_timeout>:

LE link supervision timeout

  • [0xa, 0x0C80]

  • supervision timeout = <supv_timeout> * 10ms, range from 100ms to 32s

Note

The scan interval cannot be smaller than the scan window.

AT+BLEGAP=conn_cancel

Functional Description

This command is used to cancel the initiating connection.

Command Format

AT+BLEGAP=conn_cancel,<peer_addr_type>,<peer_addr>

Response Format

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

Parameters

<peer_addr_type>:

Peer Address Type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<peer_addr>:

Peer address, hexdata No 0x, e.g. 00e04c0a30c3

AT+BLEGAP=get_active_conn

Functional Description

This command is used to get active connection number and their conn_handle.

Command Format

AT+BLEGAP=get_active_conn

Response Format

GAP get active conn, num: 1, conn_handle: 16

Parameters

NULL

AT+BLEGAP=get_conn_handle

Functional Description

This command is used to get conn_handle by peer address.

Command Format

AT+BLEGAP=get_conn_handle,<peer_addr_type>,<peer_addr>

Response Format

GAP get conn handle by addr: 16

Parameters

<peer_addr_type>:

Peer Address Type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<peer_addr>:

Peer address, hexdata No 0x, e.g. 00e04c0a30c3

AT+BLEGAP=mtu_size

Functional Description

This command is used to get connection MTU size.

Command Format

AT+BLEGAP=mtu_size,<conn_handle>

Response Format

GAP get mtu size, conn_handle: 16, mtu_size: 180

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=tx_pending_num

Functional Description

This command is used to get number of tx pending acl packet.

Command Format

AT+BLEGAP=tx_pending_num,<conn_handle>

Response Format

GAP get tx pending number, conn_handle: 16 tx_pending_num: 0

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=conn_rssi

Functional Description

This command is used to read connection RSSI.

Command Format

AT+BLEGAP=conn_rssi,<conn_handle>

Response Format

GAP read rssi, conn_hanlde: 16, value: -48

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=conn_info

Functional Description

This command is used to get connection information by conn_handle.

Command Format

AT+BLEGAP=conn_info,<conn_handle>

Response Format

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

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=conn_update

Functional Description

This command is used to update connection parameters.

Command Format

AT+BLEGAP=conn_update,<conn_handle>,<conn_interval_min>,<conn_interval_max>,<conn_latency>,<timeout>

Response Format

GAP updating connection parameters ...
[APP] Conn param is updated, conn_handle: 16, conn_interval: 0xfc, conn_latency: 0x2, supervision_timeout: 0x1f4

Parameters

<conn_handle>:

connection handle

<conn_interval_min>:

minimum connection interval

  • [0x6, 0x0C80]

  • minimum connection interval = <conn_interval_min> * 1.25ms, range from 7.5ms to 4s

<conn_interval_max>:

maxmum connection interval

  • [0x6, 0x0C80]

  • maxmum connection interval = <conn_interval_max> * 1.25ms, range from 7.5ms to 4s

<conn_latency>:

slave connection lantency

  • [0, 0x01F3]

<supv_timeout>:

LE link supervision timeout

  • [0xa, 0x0C80]

  • supervision timeout = <supv_timeout> * 10ms, range from 100ms to 32s

AT+BLEGAP=conn_phy

Functional Description

This command is used to set connection PHY preferences.

Command Format

AT+BLEGAP=conn_phy,<conn_handle>,<all_phy>,<tx_phy>,<rx_phy>,<phy_options>

Response Format

GAP setting connection PHY ...
[APP] PHY is updated, conn_handle: 16, tx_phy: 3, rx_phy: 3

Parameters

<conn_handle>:

connection handle

<all_phy>:

All PHYs

  • [0, 3]

  • bit0 has no preference among tx PHYs

  • bit1 has no preference among rx PHYs

<tx_phy>:

TX PHY

  • [0, 7]

  • bit0 has prefers to LE 1M tx PHY

  • bit1 has prefers to LE 2M tx PHY

  • bit2 has prefers to LE coded tx PHY

<rx_phy>:

RX PHY

  • [0, 7]

  • bit0 has prefers to LE 1M tx PHY

  • bit1 has prefers to LE 2M tx PHY

  • bit2 has prefers to LE coded tx PHY

<phy_options>:

LE Coded PHY 选项

  • [0, 2]

  • 0: has no prefer on coding when use LE Coded PHY

  • 1: prefers S=2 coding when use LE Coded PHY

  • 2: prefers S=8 coding when use LE Coded PHY

AT+BLEGAP=conn_datalen

Functional Description

This command is used to set connection data length.

Command Format

AT+BLEGAP=conn_datalen,<conn_handle>,<max_tx_octets>,<max_tx_time>

Response Format

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

Parameters

<conn_handle>:

connection handle

<max_tx_octets>:

maximum transmission octets

  • [0x1B, 0xFB]

<max_tx_time>:

maximum transmission time

  • [0x148, 0x4290]

AT+BLEGAP=disconn

Functional Description

This command is used to terminate an existing connection.

Command Format

AT+BLEGAP=disconn,<conn_handle>

Response Format

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

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=disconn_reason

Functional Description

This command is used to disconnect the existing connection with a reason.

Command Format

AT+BLEGAP=disconn_reason,<conn_handle>,<reason>

Response Format

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

Parameters

<conn_handle>:

connection handle

<reason>:

disconnection reason

AT+BLEGAP=wl_add

Functional Description

This command is used to add device to whitelist.

Command Format

AT+BLEGAP=wl_add,<addr_type>,<addr>

Response Format

GAP whitelist add success

Parameters

<addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<addr>:

Address to be added to the whitelist

AT+BLEGAP=wl_remove

Functional Description

This command is used to remove a device from whitelist.

Command Format

AT+BLEGAP=wl_remove,<addr_type>,<addr>

Response Format

GAP whitelist remove success

Parameters

<addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<addr>:

Address to be removed from the whitelist

AT+BLEGAP=wl_clear

Functional Description

This command is used to clear all devices in whitelist.

Command Format

AT+BLEGAP=wl_clear

Response Format

GAP get whitelist clear success

Parameters

NULL

AT+BLEGAP=pair_mode

Functional Description

This command is used to set pair mode.

Command Format

AT+BLEGAP=pair_mode,<mode>

Response Format

GAP set pairing mode success

Parameters

<mode>:

Paring mode

  • 0: No pairing

  • 1: Pairable

AT+BLEGAP=sec_param

Functional Description

This command is used to set pairing request parameters.

Command Format

AT+BLEGAP=sec_param[,<io_cap>,<oob_data_flag>,<bond>,<mitm>,<sec_pair>,<use_fixed_key>,<fixed_key>,<sec_pair_only>,<auto_sec_req>]

Response Format

GAP set security paramters success

Parameters

<io_cap>:

input/output capability

  • 0: DisplayOnly

  • 1: DisplayYesNo

  • 2: KeyboardOnly

  • 3: NoInputNoOutput

  • 4: KeyboardDisplay

<oob_data_flag>:
  • default is 0

<bond>:

bond flag

<mitm>:

MITM protection flag

<sec_pair>:

security pairing flag

<use_fixed_key>:

use fixed key flag

  • 0: disable(default)

  • 1: enable

<fixed_key>:

MITM protection fixed key

  • [0, 999999]

  • default is 0

<sec_pair_only>:

security pairing only flag

<auto_sec_req>:

send security request automatically flag

  • 0: disable(default)

  • 1: enable

AT+BLEGAP=sec

Functional Description

This command is used to start pairing.

Command Format

AT+BLEGAP=sec,<conn_handle>

Response Format

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

Parameters

<conn_handle>:

connection handle

AT+BLEGAP=pair_cfm

Functional Description

This command is used to confirm to continue pairing if pairing method is just work.。

Command Format

AT+BLEGAP=pair_cfm,<conn_handle>,<op>

Response Format

GAP pair confirm OK!

Parameters

<conn_handle>:

connection handle

<op>:

confirm pairing

  • 1: accept

  • 2: reject

AT+BLEGAP=auth_key

Functional Description

This command is used to input passkey to continue pairing if pairing method is passkey entry.

Command Format

AT+BLEGAP=auth_key,<conn_handle>,<passkey>

Response Format

GAP input auth key OK!

Parameters

<conn_handle>:

connection handle

<passkey>:
  • [0, 999999]

AT+BLEGAP=auth_keycfm

Functional Description

This command is used to confirm passkey match correct if pairing method is numerical comparison.

Command Format

AT+BLEGAP=auth_keycfm,<conn_handle>,<op>

Response Format

GAP auth key confirm OK!

Parameters

<conn_handle>:

connection handle

<op>:

confirm pairing

  • 1: accept

  • 2: reject

AT+BLEGAP=auth_oob

Functional Description

This command is used to input oob TK in legacy pairing.

Command Format

AT+BLEGAP=auth_oob,<conn_handle>,<tk>

Response Format

GAP input auth OOB TK OK!

Parameters

<conn_handle>:

connection handle

<tk>:

OOB data

AT+BLEGAP=bond_num

Functional Description

This command is used to get device num in bond list.

Command Format

AT+BLEGAP=bond_num

Response Format

GAP get bond number: 1

Parameters

NULL

AT+BLEGAP=bond_info

Functional Description

This command is used to get bond device information in bond list.

Command Format

AT+BLEGAP=bond_info

Response Format

GAP get bond info:
[0] 00:E0:4C:80:04:06(public), resolved: 00:00:00:00:00:00(public)

Parameters

NULL

AT+BLEGAP=bond_del

Functional Description

This command is used to delete a device in bond list by address.

Command Format

AT+BLEGAP=bond_del,<addr_type>,<addr>

Response Format

[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 ...

Parameters

<addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<addr>:

Address to be deleted from the bond list, hexdata No 0x, e.g. 00e04c0a30c3

AT+BLEGAP=bond_clear

Functional Description

This command is used to clear all devices in bond list.

Command Format

AT+BLEGAP=bond_clear

Response Format

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)

Parameters

NULL

AT+BLEGAP=set_privacy_mode

Functional Description

This command is used to set remote device’s privacy mode.

Command Format

AT+BLEGAP=set_privacy_mode,<ident_addr_type>,<peer_ident_addr>,<privacy_mode>

Response Format

GAP set privacy mode success

Parameters

<ident_addr_type>:

Identity address type

  • 0: Public Identity Address

  • 1: Random (Static) Identity Address

<peer_ident_addr>:

Peer identity address

<privacy_mode>:

privacy mode

  • 0: network privacy mode

  • 1: device privacy mode

AT+BLEGAP=read_local_rpa

Functional Description

This command is used to read local rpa address.

Command Format

AT+BLEGAP=read_local_rpa[,<ident_addr_type>,<peer_ident_addr>]

Response Format

GAP read local rpa success, 72:7A:86:E2:24:B4

Parameters

<ident_addr_type>:

Identity address type

  • 0: Public Identity Address

  • 1: Random (Static) Identity Address

<peer_ident_addr>:

Peer identity address

AT+BLEGAP=read_peer_rpa

Functional Description

This command is used to read peer rpa address.

Command Format

AT+BLEGAP=read_peer_rpa[,<ident_addr_type>,<peer_ident_addr>]

Response Format

GAP read peer rpa success, 72:7A:86:E2:24:B4

Parameters

<ident_addr_type>:

Identity address type

  • 0: Public Identity Address

  • 1: Random (Static) Identity Address

<peer_ident_addr>:

Peer identity address

AT+BLEGAP=eadv_data

Functional Description

This command is used to set extended adv data.

Command Format

AT+BLEGAP=eadv_data,<adv_handle>,<data_len>

Response Format

GAP set ext adv(0) data success

Parameters

<adv_handle>:
  • [0, 0xEF]

<data_len>:

length of extended adv data

AT+BLEGAP=escan_rsp

Functional Description

This command is used to set extended scan response data.

Command Format

AT+BLEGAP=escan_rsp,<adv_handle>,<data_len>

Response Format

GAP set ext scan resp data(0) success

Parameters

<adv_handle>:
  • [0, 0xEF]

<data_len>:

lentgh of extended scan response data

AT+BLEGAP=eadv

Functional Description

This command is used to operate extended adv.

Command Format

AT+BLEGAP=eadv,<op=0 or 3>,<adv_handle>

or

AT+BLEGAP=eadv,<op=1>,<adv_handle>,<duration>

or

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>

Response Format

Create an extended adv:

GAP create ext adv success! adv handle: 0

Start extended adv:

GAP starting ext adv(0) ...
[APP] Ext ADV(0) started

Stop extended adv:

GAP stopping ext adv(1) ...
[APP] Ext ADV(1) stopped: reason 0x0

Remove an extended adv:

GAP remove ext adv(0) success!

Parameters

<op>:

extended adv operation

  • 0: Stop extended adv

  • 1: Start extended adv

  • 2: Create an extended adv

  • 3: Remove an extended adv

<adv_handle>:
  • [0, 0xEF]

<duration>:

duration of extended adv

  • [0, 0xFFFF]

  • unit is 10ms, 0 means no limit

<adv_sid>:

adv ID

  • [0, 0x0F]

<adv_prop>:

adv properties

  • bit0: connectable adv

  • bit1: scannable adv

  • bit2: directed adv

  • bit3: high duty cycle directed connectable adv

  • bit4: use legacy adv PDU

  • bit5: omit advertiser’s address from all PDUs

  • bit6: include TxPower in the extended header of at least one adv PDU

<pri/sec PHY>:

primary PHY/secondary PHY(hexnum with 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: Allow both scan and connection requests from anyone

  • 1: Allow both scan req from White List devices only and connection req from anyone

  • 2: Allow both scan req from anyone and connection req from White List devices only

  • 3: Allow scan and connection requests from White List devices only

<tx_power>:

transmit power - [-127 dBm, 20 dBm] - 0x7F means host no preference

<adv_interval_min>:

minimum advertising interval

  • [0x20, 0xFFFF]

  • advertising interval = <adv_interval_min> * 0.625ms, range from 20ms to 10.24s

<own_addr_type>:

Local address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<peer_addr_type>:

Peer address type

  • 0: Public Device AddressorPublic Identity Address

  • 1: Random Device AddressorRandom (Static) Identity Address

<peer_addr>:

Peer address, hexdata No 0x, e.g. 00e04c0a30d1

AT+BLEGAP=escan_param

Functional Description

This command is used to set extended scan parameters.

Command Format

AT+BLEGAP=escan_param,<own_addr_type>,<filter_policy>,<duplicate_opt>[,<duration>,<period>,<scan_phys>[,<scan_type>, <interval>,<window>][,<scan_type>, <interval>,<window>]]

Response Format

GAP set scan param success

Parameters

<own_addr_type>:

Local address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<filter_policy>:
  • 0: Accept all adv, except directed adv not addressed to this device

  • 1: Accept only adv from dev in whitelist, ignore directed adv not addressed to this device

  • 2: Accept all adv, except directed adv where indentity addr not addressed to this device

  • 3: Accept all adv, except from dev not in whitelist and dirctet adv where identity addr not addressed to this device

<duplicate_opt>:
  • 0: disable duplicate filter

  • 1: enable duplicate filter

  • 2: enable duplicate filter, reset for each scan period

<duration>:

duration of scanning

  • [0, 0xFFFF]

  • unit is 10ms, 0 means no limit

<period>:

scan period - [0, 0xFFFF] - unit is 10ms, 0 means no limit

<scan_phys>:

scan PHYs

  • bit0: scan on 1M PHY

  • bit2: scan on Coded PHY

<scan_type>:

scan type

  • 0: passive scan

  • 1: active scan

<interval>:

scan interval

  • [0x4, 0xFFFF]

  • scan interval = <interval> * 0.625ms, range from 2.5ms to 10.24s

<window>:

scan window

  • [0x4, 0xFFFF]

  • scan window = <window> * 0.625ms, range from 2.5ms to 10.24s

AT+BLEGAP=escan

Functional Description

This command is used to enable or disable extended scan.

Command Format

AT+BLEGAP=escan,<op>

Response Format

enable extended scan:

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

disable extended scan:

GAP stopping ext scan ...
[APP] Scan stopped, reason: 0x0

Parameters

<op>:

enable or disable extended scan

  • 0: disable extended scan

  • 1: enable extended scan

AT+BLEGAP=econn

Functional Description

This command is used to initiate a connection to remote device.

Command Format

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>]]

Response Format

[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

Parameters

<peer_addr_type>:

Peer address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<peer_addr>:

Peer address, hexdata No 0x, e.g. 00e04c0a30c3

<init_phys>:

the PHYs to use for the connection

  • bit0: if 1, adv primary channel is on 1M phy

  • bit1: if 1, adv primary channel is on 2M phy

  • bit2: if 1, adv primary channel is on coded phy

<own_addr_type>:

Local address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<filter_policy>:
  • 0: whitelist is not used

  • 1: whitelist is used

<scan_interval>:

scan interval

  • [0x4, 0x4000]

  • scan interval = <scan_interval> * 0.625ms, range from 2.5ms to 10.24s

<scan_window>:

scan window

  • [0x4, 0x4000]

  • scan window = <scan_window> * 0.625ms, range from 2.5ms to 10.24s

<conn_interval_min>:

minimum connection interval

  • [0x6, 0x0C80]

  • minimum connection interval = <conn_interval_min> * 1.25ms, range from 7.5ms to 4s

<conn_interval_max>:

maxmum connection interval

  • [0x6, 0x0C80]

  • maxmum connection interval = <conn_interval_max> * 1.25ms, range from 7.5ms to 4s

<conn_latency>:

slave connection lantency

  • [0, 0x01F3]

<supv_timeout>:

LE link supervision timeout

  • [0xa, 0x0C80]

  • supervision timeout = <supv_timeout> * 10ms, range from 100ms to 32s

AT+BLEGAP=pa_adv

Functional Description

This command is used to enable or disable periodic adv.

Command Format

AT+BLEGAP=pa_adv,<op>,<adv_handle>,<adv_interval_min>,<pa_prop>,<pa_data_len>

Response Format

enable periodic adv

GAP starting periodic adv(0) ...
[APP] Periodic ADV(0) started

disable periodic adv

GAP stopping periodic adv(0) ...
[APP] Periodic ADV(0) stopped

Parameters

<op>:

periodic adv operation

  • 0: disable padv, only param <adv_handle> is needed

  • 1: enable padv

<adv_handle>:
  • [0, 0xEF]

<adv_interval_min>:

minimum adv interval

  • [0x6, 0xFFFF]

  • adv interval = <adv_interval_min> * 1.25ms, range from 7.5ms to 81.91875s

<pa_prop>:

periodic adv properties

  • 0: none

  • 1: include txpower

<pa_data_len>:

length of periodic adv data

  • [0, 252]

AT+BLEGAP=pa_update

Functional Description

This command is used to update periodic adv data.

Command Format

AT+BLEGAP=pa_update,<adv_handle>,<data>,<data_len>

Response Format

GAP update periodic adv(0) success

Parameters

<adv_handle>:
  • [0, 0xEF]

<data>:

periodic adv data, hexdata No 0x, e.g. 0201060303AAFE1716AAFE00E02A000100

<data_len>:

length of periodic adv data

  • [0, 252]

AT+BLEGAP=pa_sync_list

Functional Description

This command is used to operate periodic advertiser list.

Command Format

AT+BLEGAP=pa_sync_list,<op>,<adv_sid>,<addr_type>,<addr>

Response Format

GAP modify PA sync adv list Success!

Parameters

<op>:

periodic adv list operation

  • 0: clear pa list, all other params are not needed

  • 1: add a device to pa list

  • 2: remove a device from pa list

<adv_sid>:

adv ID

  • [0, 0xF]

<addr_type>:

Address type

  • 0: Public Device AddressorPublic Identity Address

  • 1: Random Device AddressorRandom (Static) Identity Address

<addr>:

hexdata No 0x, e.g. 00e04c0a30d1

AT+BLEGAP=pa_sync

Functional Description

This command is used for periodic adv to create or terminate sync.

Command Format

create sync

AT+BLEGAP=pa_sync,<op=create><options>,<sync_cte_type>,<adv_sid>,<addr_type>,<addr>,<skip>,<sync_timeout>

terminate sync

AT+BLEGAP=AT+BLEGAP=pa_sync,<op=terminate>,<sync_sid>

Response Format

create sync

GAP PA sync create success, sync_id = 0!
[APP] PA sync state change: sync_id: 0, state = 3, cause: 0x0

terminate sync

GAP PA sync terminate success, sync_id = 0!
[APP] PA sync state change: sync_id: 0, state = 0, cause: 0x116

Parameters

<op>:

periodic adv sync operation

  • 0: terminate pa sync

  • 1: create pa sync

<options>:

sync options

  • bit0: if 0, use <addr_type>, <addr>. if 1, use pa list

  • bit1: if 0, Reporting initially enabled. if 1, Reporting initially disabled

  • bit2: if 0, duplicate filter disabled, if 1, duplicate filter enabled

<sync_cte_type>:

periodic adv CTE type

  • bit0: not sync AoA CTE

  • bit1: not sync AoD CTE with 1us

  • bit2: not sync AoD CTE with 2us

  • bit3: not sync type 3 CTE

  • bit4: not sync without CTE

<adv_sid>:

adv ID

  • [0, 0xF]

<addr_type>:

Address type

  • 0: Public Device AddressorPublic Identity Address

  • 1: Random Device AddressorRandom (Static) Identity Address

<addr>:

hexdata No 0x, e.g.00e04c0a30c3

<skip>:

the maximum number of periodic adv packets that can be skipped after a successful reception

  • [0, 0x01F3]

<sync_timeout>:
  • [0xA, 0x4000]

  • timeput = <sync_timeout> * 10ms, range from 100 ms to 163.84 s

<sync_sid>:

sync ID

AT+BLEGAP=past_send

Functional Description

This command is used for periodic adv sync transfer or set info transfer.

Command Format

AT+BLEGAP=past_send,<conn_handle>,<service_data>,<use_sync_id>,<idx>

Response Format

GAP PAST transfer success!

Parameters

<conn_handle>:

connection handle

<service_data>:
  • [0, 0xFFFF]

<use_sync_id>:

Indicates whether the subsequent <idx> Parameters is a Periodic Advertising Sync ID or a Periodic Advertising Handle.

  • 0: sync transfer, use adv_handle to identify the padv, then <idx> means <adv_handle>

  • 1: set info transfer, use sync id to identity the padv, then <idx> means <sync_id>

<idx>:

periodic adv handle or sync ID

<adv_handle>:

periodic adv handle

  • [0, 0xEF]

<sync_sid>:

sync ID

AT+BLEGAP=past_recv

Functional Description

This command is used to set periodic adv sync transfer parameters.

Command Format

AT+BLEGAP=past_recv,<conn_handle>,<mode>,<cte_type>,<skip>,<sync_timeout>

Response Format

GAP PAST recipient set params success! conn_handle: 16

Parameters

<conn_handle>:

connection handle

<mode>:

periodic adv sync receive mode

  • 0: not to sync and no sync_transfer_received events sent to host

  • 1: sync_transfer_received events sent to host, disable padv report

  • 2: sync_transfer_received events sent to host, enable padv report with dup_filter disabled

  • 3: sync_transfer_received events sent to host, enable padv report with dup_filter enabled

<cte_type>:

CTE type

  • bit0: not sync AoA CTE

  • bit1: not sync AoD CTE with 1us

  • bit2: not sync AoD CTE with 2us

  • bit3: not sync type 3 CTE

  • bit4: not sync without CTE

<skip>:

the maximum number of periodic adv packets that can be skipped after a successful reception

  • [0, 0x01F3]

<sync_timeout>:

periodic adv sync timeout

  • [0xA, 0x4000]

  • timeout = <sync_timeout> * 10ms, range from 100 ms to 163.84 s

AT+BLEGAP=def_past_recv

Functional Description

This command is used to set default periodic adv sync transfer parameters.

Command Format

AT+BLEGAP=def_past_recv,<conn_handle>,<mode>,<cte_type>,<skip>,<sync_timeout>

Response Format

GAP PAST recipient set default params success!

Parameters

<conn_handle>:

connection handle

<mode>:

periodic adv sync receive mode

  • 0: not to sync and no sync_transfer_received events sent to host

  • 1: sync_transfer_received events sent to host, disable padv report

  • 2: sync_transfer_received events sent to host, enable padv report with dup_filter disabled

  • 3: sync_transfer_received events sent to host, enable padv report with dup_filter enabled

<cte_type>:

CTE type

  • bit0: not sync AoA CTE

  • bit1: not sync AoD CTE with 1us

  • bit2: not sync AoD CTE with 2us

  • bit3: not sync type 3 CTE

  • bit4: not sync without CTE

<skip>:

the maximum number of periodic adv packets that can be skipped after a successful reception

  • [0, 0x01F3]

<sync_timeout>:

periodic adv sync timeout

  • [0xA, 0x4000]

  • timeout = <sync_timeout> * 10ms, range from 100 ms to 163.84 s

AT+BLEGAP=txpower_read

Functional Description

This command is used to read tx power of local and remote device.

Command Format

AT+BLEGAP=txpower_read,<op>,<conn_handle>,<phy>

Response Format

Read local tx power Success! curr: 7, max: 7

Parameters

<op>:

read tx power operation

  • 0: read local tx power

  • 1: read remote tx power

<conn_handle>:

connection handle

<phy>:

PHY type

  • 0: LE 1M PHY

  • 1: LE 2M PHY

  • 2: LE Coded PHY S8

  • 3: LE Coded PHY S2

AT+BLEGAP=txpower_report

Functional Description

This command is used to enable or disable the tx power changes report of local and remote device.

Command Format

AT+BLEGAP=txpower_report,<conn_handle>,<local_enable>,<remote_enable>

Response Format

Tx power reporting set Success!

Parameters

<conn_handle>:

connection handle

<local_enable>:
  • 0: disable

  • 1: enable

<remote_enable>:
  • 0: disable

  • 1: enable

AT+BLEGAP=cte_conn_rx

Functional Description

This command is used to start or stop connection CTE receive.

Command Format

AT+BLEGAP=cte_conn_rx,<op>,<conn_handle>[,<cte_req_interval>,<req_cte_len>,<req_cte_type>,<slot_durations>,<num_ant_ids >[,…]]

Response Format

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

Parameters

<op>:

start or stop connection CTE receive

  • 0: start connection cte receive, if params in [] is none, default CTE receive param in atcmd will be used

  • 1: stop connection cte receive, all params in [] is none

<conn_handle>:

connection handle

<cte_req_interval>:

CTE request interval

  • [0, 0xFFFF]

  • 0: initiate CTE request procedure once

  • [1, 0xFFFF]: initiating CTE Request procedure in number of connection events

<req_cte_len>:

CTE request length

  • [0x2, 0x14]

<req_cte_type>:

CTE request type

  • bit0: AoA

  • bit1: AoD 1us

  • bit2: AoD 2us

<slot_durations>:

CTE slot durations

  • 1: 1us

  • 2: 2us

<num_ant_ids>:

antenna ID count

  • 0: no parameters[,…]

  • [0x1, 0xC]: [,…] = <ant_id_0>[,<ant_id_1>,…]

AT+BLEGAP=cte_connless_rx

Functional Description

This command is used to start or stop connectionless CTE receive.

Command Format

AT+BLEGAP=cte_connless_rx,<op>,<sync_id>[,<slot_durations>,<max_sampled_ctes>,<num_ant_ids>[,…]]

Response Format

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

Parameters

<op>:

start or stop connectionless CTE receive

  • 0: start connectionless CTE receive

  • 1: stop connectionless CTE receive

<sync_id>:

sync ID

<slot_durations>:

CTE slot durations

  • 1: 1us

  • 2: 2us

<max_sampled_ctes>:

maximum number of sampled CTEs

  • [0, 10]

  • 0: sample and report all available Constant Tone Extensions

  • [1, 10]: maximum number of Constant Tone Extensions to sample and report

<num_ant_ids>:

number of antenna IDs

  • 0: no parameters[,…]

  • [0x1, 0xC]: [,…] = <ant_id_0>[,<ant_id_1>,…]

<ant_id_0>:

antenna ID

  • [0, 0xFF]

AT+BLEGAP=get_antenna

Functional Description

This command is used to get antenna information supported by the controller.

Command Format

AT+BLEGAP=get_antenna

Response Format

GAP get antenna information supported success, supported_switching_sampling_rates=7, num_antenna=4, max_switching_pattern_length=12, max_cte_length=20

Parameters

NULL

AT+BLEGAP=coc_reg_psm

Functional Description

This command is used to register/unregister LE PSM for LE credit based connection-oriented channel(COC).

Command Format

AT+BLEGAP=coc_reg_psm,<op>,<le_psm>

Response Format

GAP coc reg or unreg psm success

Parameters

<op>:

register/unregister LE PSM

  • 1: register LE PSM

  • 0: unregister LE PSM

<le_psm>:

hexnum with 0x(2 octs), e.g. 0x30 or 0x0030

AT+BLEGAP=coc_set_sec

Functional Description

This command is used to set/unset LE PSM security for LE COC.

Command Format

AT+BLEGAP=coc_set_sec,<op>,<le_psm>,<sec_mode>,<key_size>

Response Format

GAP coc set psm security success

Parameters

<op>:

set/unset LE PSM security

  • 1: set LE PSM security

  • 0: unset LE PSM security

<le_psm>:

hexnum with 0x(2 octs), e.g. 0x30 or 0x0030

<sec_mode>:

security mode

  • 0: none security

  • 1: unauthencated encryption

  • 2: authencated encryption

  • 3: unauthencated data signed

  • 4: authencated data signed

  • 5: author required

<key_size>:

key size

AT+BLEGAP=coc_set_param

Functional Description

This command is used to set parameters value for LE COC.

Command Format

AT+BLEGAP=coc_set_param,<param_type>,<value>

Response Format

GAP coc set param success

Parameters

<param_type>:

Parameters type

  • 1: local MTU

<value>:

Parameters value

AT+BLEGAP=coc_get_param

Functional Description

This command is used to get channel information for LE COC.

Command Format

AT+BLEGAP=coc_get_param,<param_type>,<channel_id>

Response Format

GAP coc get chan param success, value: 0x40

Parameters

<param_type>:

Parameters type

  • 0: current credits

  • 1: max credits

  • 2: channel MTU

<channel_id>:

hexnum with 0x(2 octs), e.g. 0x40 or 0x0040

AT+BLEGAP=coc_conn

Functional Description

This command is used to create L2CAP connection with specific LE PSM for LE COC.

Command Format

AT+BLEGAP=coc_conn,<conn_handle>,<le_psm>

Response Format

GAP coc conncting ...
[APP] LE COC connected, conn_handle: 16, cid: 0x0

Parameters

<conn_handle>:

connection handle

<le_psm>:

hexnum with 0x(2 octs), e.g. 0x30 or 0x0030

AT+BLEGAP=coc_disconn

Functional Description

This command is used to disconnect L2CAP channel by channel ID for LE COC.

Command Format

AT+BLEGAP=coc_disconn,<channel_id>

Response Format

GAP coc disconnecting ...
[APP] LE COC disconnected, conn_handle: 16, cid: 0x0

Parameters

<channel_id>:

hexnum with 0x(2 octs), e.g. 0x40 or 0x0040

AT+BLEGAP=coc_send

Functional Description

This command is used to send data in L2CAP channel by channel ID for LE COC.

Command Format

AT+BLEGAP=coc_send,<channel_id>,<length>,<data>

Response Format

GAP coc data sending ...
[APP] LE COC send data completed, conn_handle: 16, cid: 0x0, credit: 0, err: 0x0

Parameters

<channel_id>:

hexnum with 0x(2 octs), e.g. 0x40 or 0x0040

<length>:

length of send data

<data>:

send data, hexdata No 0x

AT+BLEGAP=get_adv_param

Functional Description

This command is used to get adv parameters.

Command Format

AT+BLEGAP=get_adv_param

Response Format

GAP get adv param success, param: <type>,<own_addr_type>,<filter_policy>,<peer_addr_type>,<peer_addr>,<interval_min>,<interval_max>,<channel_map>

Parameters

Reference Parameters

AT+BLEGAP=get_scan_param

Functional Description

This command is used to get scan parameters.

Command Format

AT+BLEGAP=get_scan_param

Response Format

GAP get scan param success, param: <type>,<own_addr_type>,<filter_policy>,<duplicate_opt>,<interval>,<window>

Parameters

Reference Parameters

AT+BLEGAP=get_sec_param

Functional Description

This command is used to get pairing request parameters.

Command Format

AT+BLEGAP=get_sec_param

Response Format

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>

Parameters

Reference Parameters

BR GAP

AT+BRGAP=inquiry_start

Functional Description

This command is used to scan surrounding devices.

Command Format

AT+BRGAP=inquiry_start,<limit_inquiry>,<timeout>

Response Format

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

Parameters

<limit_inquiry>:
  • 0: no limitd inquiry

  • 1: limited inquiry(not supported yet)

<timeout>:

decimal num, uint: second

AT+BRGAP=disc

Functional Description

This command is used to disconnect with peer device.

Command Format

AT+BRGAP=disc,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BRGAP=cfg_page

Functional Description

This command is used to configure page scan parameters.

Command Format

AT+BRGAP=cfg_page,<type>,<interval>,<window>

Response Format

cfg page type 0x00, interval 0x0800, window 0x0012

Parameters

<type>:

scan type

  • 0: stand

  • 1: interlaced

<interval>:

scan interval, only even values are valid

  • [0x12, 0x1000]

  • adv interval = <interval> * 0.625ms, range from 11.25 ms to 25.6 s

<window>:

scan window, only even values are valid

  • [0x11, 0x1000]

  • scan window = <window> * 0.625ms, range from 10.625 ms to 25.6 s

AT+BRGAP=cfg_inquiry

Functional Description

This command is used to configure inquiry scan parameters.

Command Format

AT+BRGAP=cfg_inquiry,<type>,<interval>,<window>

Response Format

cfg inquiry type 0x00, interval 0x0800, window 0x0012

Parameters

<type>:

scan type

  • 0: stand

  • 1: interlaced

<interval>:

scan interval, only even values are valid

  • [0x12, 0x1000]

  • adv interval = <interval> * 0.625ms, range from 11.25 ms to 25.6 s

<window>:

scan window, only even values are valid

  • [0x11, 0x1000]

  • scan window = <window> * 0.625ms, range from 10.625 ms to 25.6 s

AT+BRGAP=sec_param

Functional Description

This command is used to set pairing request parameters.

Command Format

AT+BRGAP=sec_param[,<io_cap>,<oob_data_flag>,<bond>,<br_bond>,<mitm>,<sec_pair>,<br_sec_pair>]

Response Format

GAP set security paramters success

Parameters

<io_cap>:

input/output capability

  • 0: DisplayOnly

  • 1: DisplayYesNo

  • 2: KeyboardOnly

  • 3: NoInputNoOutput

  • 4: KeyboardDisplay

<oob_data_flag>:

OOB data flag

<bond>:

bond flag

<br_bond>:

BR ond flag

<mitm>:

MITM protection flag

<sec_pair>:

security pair flag

<br_sec_pair>:

BR security pair flag

AT+BRGAP=bond_clear

Functional Description

This command is used to clear all bond information.

Command Format

AT+BRGAP=bond_clear

Response Format

BR GAP clearing bond info...

Parameters

NULL

AT+BRGAP=radio_mode

Functional Description

This command is used to set br edr radio mode.

Command Format

AT+BRGAP=radio_mode,<mode>

Response Format

BR GAP seting radio mode ...

Parameters

<io_cap>:

radio mode

  • 1: Enable both inquiry scan and page scan

  • 2: Only enable inquiry scan

  • 3: Only enable page scan

  • 4: Disable both inquiry scan and page scan

AT+BRGAP=sniff_mode

Functional Description

This command is used to set br edr radio mode.

Command Format

AT+BRGAP=sniff_mode,<enable>,<peer_addr>[,<min_interval>,<max_interval>,<sniff_attempt>,<sniff_timeout>]

Response Format

bt_stack_br_gap_set_sniff_mode: enable
BR GAP seting sniff mode ...

Parameters

<enable>:

Enable or disable sniff mode

  • 0: Disable sniff mode

  • 1: Enable sniff mode

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<min_interval>:

Min sniff interval, only even values between 0x0002 and 0xFFFE are valid

  • [0x0002, 0xFFFE]

<max_interval>:

Min sniff interval, only even values between 0x0002 and 0xFFFE are valid

  • [0x0002, 0xFFFE]

  • not less than <min_interval>

<sniff_attempt>:

Number of baseband receive slots for sniff attempt

<sniff_timeout>:

Number of baseband receive slots for sniff timeout

AT+BRGAP=bond_max_num

Functional Description

This command is used to get max bond number supported by bt stack.

Command Format

AT+BRGAP=bond_max_num

Response Format

Max bond num 8 ...

Parameters

NULL

AT+BRGAP=bond_num

Functional Description

This command is used to get already bonded number.

Command Format

AT+BRGAP=bond_num

Response Format

Bond num 0 ...

Parameters

NULL

AT+BRGAP=bond_key_get

Functional Description

This command is used to get bond key.

Command Format

AT+BRGAP=bond_key_get,<peer_addr>

Response Format

BR GAP Bond key: 92 85 b8 66 6c 6e 11 98 4f da f4 d8 ec 1c 20 6e

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BRGAP=bond_index_get

Functional Description

This command is used to get bond index.

Command Format

AT+BRGAP=bond_index_get,<peer_addr>

Response Format

BR GAP Bond index 0x0

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BRGAP=bond_addr_get

Functional Description

This command is used to get bond address.

Command Format

AT+BRGAP=bond_addr_get,<priority>

Response Format

BR GAP Bond addr 00:00:00:00:00:00

Parameters

<priority>:

priority

  • [0, <bond_num> - 1]

AT+BRGAP=bond_delete

Functional Description

This command is used to delete bond infomation.

Command Format

AT+BRGAP=bond_delete,<peer_addr>

Response Format

BR GAP Bond delete success

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

BLE GATTC

AT+BLEGATTC=disc

Functional Description

This command is used to discover services, characteristics or descriptors.

Command Format

AT+BLEGATTC=disc,<conn_handle>,<type>[,<start_handle>,<end_handle>,<uuid16/uuid128>]

Response Format

If <discover_type> is 0, respond as follows:

[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

If <discover_type> is 1, respond as follows:

[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

If <discover_type> is 2, respond as follows:

[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

If <discover_type> is 3, respond as follows:

[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

If <discover_type> is 4, respond as follows:

[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

If <discover_type> is 5, respond as follows:

[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

Parameters

<conn_handle>:

connection handle

<type>:

discovery type

  • 0: disc primary service

  • 1: disc primary by uuid

  • 2: disc included service

  • 3: disc characteristic all

  • 4: disc characteristic by uuid

  • 5: disc discriptor all

<start_handle>:

The starting attribute handle of the discovery range

<end_handle>:

The ending attribute handle of the discovery range

<uuid16/uuid128>:

The UUID of discovery target

<included_service_handle>:

The handle of the included service declaration

<characteristic_handle>:

characteristic handle

<properties>:

characteristic properties

<value_handle>:

characteristic properties value handle

<descriptor_handle>:

characteristic descriptor handle

AT+BLEGATTC=read

Functional Description

This command is used to read characteristic values from a server.

Command Format

AT+BLEGATTC=read,<conn_handle>,<type>[,…]

Response Format

If <type> is 0, respond as follows:

[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

If <type> is 1, respond as follows:

[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

Parameters

<conn_handle>:

connection handle

<type>:

read type

  • 0: read characteristic value by handle, […]=<handle>

  • 1: read characteristic value by uuid, […]=<start_handle>,<end_handle>,<uuid16/uuid128>

  • 2: read multiple characteristic values(not support)

  • 3: read multiple variable characteristic values, […]=<handle_count>,<handles_arr_1>[,…]

AT+BLEGATTC=write

Functional Description

This command is used to write characteristic value to a server.

Command Format

AT+BLEGATTC=write,<conn_handle>,<type>,<handle>,<length>,<data>

Response Format

[APP] GATTC write completed, profile_id: 0, conn_handle: 16, type: 1, handle: 0x48

Parameters

<conn_handle>:

connection handle

<type>:

write type

  • 0: write characteristic by handle

  • 1: write characteristic by handle use write_no_rsp

  • 2: write characteristic by handle use write_no_rsp with signed data

<handle>:

attribute handle of peer device

<length>:

lentgh of writed data

<data>:

writed data, hexdata No 0x

AT+BLEGATTC=en_cccd

Functional Description

This command is used to enable characteristic cccd of a server.

Command Format

AT+BLEGATTC=en_cccd,<conn_handle>,<charac_value_handle>,<cccd_handle>,<cccd_val>

Response Format

[APP] GATTC enable cccd succeed, profile_id: 0, conn_handle: 16, handle: 0x1a

Parameters

<conn_handle>:

connection handle

<charac_value_handle>:

characteristic value handle

<cccd_handle>:

CCCD handle

<cccd_val>:

CCCD value

  • 1: notify enable

  • 2: indicate enable

  • 3: both enable

  • 0: none is enabled

AT+BLEGATTC=dis_cccd

Functional Description

This command is used to disable characteristic cccd of a server.

Command Format

AT+BLEGATTC=dis_cccd,<conn_handle>,<charac_value_handle>,<cccd_handle>,<cccd_val>

Response Format

[APP] GATTC disable cccd succeed, profile_id: 0, conn_handle: 16, handle: 0x1a

Parameters

<conn_handle>:

connection handle

<charac_value_handle>:

characteristic value handle

<cccd_handle>:

CCCD handle

<cccd_val>:

CCCD value

  • 1: notify enable

  • 2: indicate enable

  • 3: both enable

  • 0: none is enabled

AT+BLEGATTC=<bas_cmd>

Functional Description

This command is used by bas client to execute services operations.

Command Format

AT+BLEGATTC=<bas_cmd>,<conn_handle>[,<en/disable>]

Parameters

<bas_cmd>:

BAS related commands

  • bas_disc: bas client discover all services, [] = none(when use ble_mgr lib, don’t need this cmd to discover)

  • bas_read_bat_lev: bas_read_bat_lev - bas client read battery level value, [] = none

  • bas_set_notify: bas_set_notify - bas client set battery level notify bit, param <en/disable> is needed

<conn_handle>:

connection handle

<en/disable>:

enable or disable battery level notify bit - 1: enable - 0: disable

Note

  • AT+BLEGATTC=bas_disc,… shall be executed first before other bas_cmds.

AT+BLEGATTC=<gaps_cmd>

Functional Description

This command is used by gap service client to execute service operations.

Command Format

AT+BLEGATTC=<gaps_cmd>,<conn_handle>[,<char_index>]

Parameters

<gaps_cmd>:

GAPS related commands

  • gaps_disc: gaps client discover service information, [] = none,(when use ble_mgr lib, don’t need this cmd to discover)

  • gaps_read_char: gaps_read_char- gaps client read characteristic value, param <char_index> is needed

<conn_handle>:

connection handle

<char_index>:

characteristic index

  • 0: device name characteristic

  • 0: device appearance characteristic

  • 2: peripheral preferred connection parameter characteristic

Note

  • AT+BLEGATTC= gaps_disc,… shall be executed first before other gaps_cmds.

AT+BLEGATTC=<simple_ble_cmd>

Functional Description

This command is used by simple ble service client to execute services operations.

Command Format

AT+BLEGATTC=<simple_ble_cmd>,<conn_handle>[,…]

Parameters

<simple_ble_cmd>:

simple BLE service related commands

  • simble_disc: simple ble client discover service information, […] = none, (when use ble_mgr lib, don’t need this cmd to discover)

  • simble_read: simple ble client read charac_v0 value, […] = none

  • simble_write: simple ble client write charac_v1 value, […] = <length>,<data>

  • simble_set_notify: simple ble client set charac_v2 cccd notify, […] = <en/disable>

  • simble_set_indicate: simple ble client set charac_v3 cccd indicate, […] = <en/disable>

<conn_handle>:

connection handle

<length>:

lentgh of writed data

<data>:

writed_data, hexdata No 0x

<en/disable>:

enable or disable CCCD

  • 1: enable CCCD

  • 0: disable CCCD

Note

  • AT+BLEGATTC= simble_disc,… shall be executed first before other simple_ble_cmd.

AT+BLEGATTC=<cte_cmd>

Functional Description

This command is used by CTE service client to execute services operations.

Command Format

AT+BLEGATTC=<cte_cmd>,<conn_handle>[,…]

Parameters

<cte_cmd>:

CTE service related commands

  • cte_disc: CTE client discover service information, […] = none, (when use ble_mgr lib, don’t need this cmd to discover)

  • cte_write: CTE client write char_index value, […] = <char_index>,<length>,<data>

<conn_handle>:

connection handle

<char_index>:

characteristic index

  • 0: CTE enable characteristic

  • 1: advertising CTE minimum length characteristic

  • 2: advertising CTE minimum transmit count characteristic

  • 3: advertising CTE transmit duration characteristic

  • 4: advertising CTE interval characteristic

  • 5: advertising CTE PHY characteristic

<length>:

length of writed data

<data>:

writed data

Note

  • AT+BLEGATTC=cte_disc,… shall be executed first before cte_write.

AT+BLEGATTC=disc(ble_mgr)

Functional Description

This command is used to discover services, characteristics and descriptors(based on ble_mgr lib)。

Command Format

AT+BLEGATTC=disc,<conn_handle>

Response Format

[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.

Parameters

<conn_handle>:

connection handle

AT+BLEGATTC=read(ble_mgr)

Functional Description

This command is used to read characteristic value from a server(based on ble_mgr lib).

Command Format

AT+BLEGATTC=read,<conn_handle>,<type>[,…]

Response Format

If <type> is 0, respond as follows:

GATTC Reading ...
[APP] GAPS client read device name: RTK_BT_SCATTERNET

If <type> is 1, respond as follows:

GATTC Reading ...
[APP] Simple ble client read charac v0: Demo

Parameters

<conn_handle>:

connection handle

<type>:

read type

  • 0: read characteristic value by handle, […] = <handle>

  • 1: read characteristic value by uuid,[…] = <start_handle>,<end_handle>,<uuid16>

<handle>:

characteristic value handle

<start_handle>:

start handle

<end_handle>:

end handle

<uuid16>:

target UUID

AT+BLEGATTC=write(ble_mgr)

Functional Description

This command is used to write characteristic value to a server(based on ble_mgr lib)。

Command Format

AT+BLEGATTC=write,<conn_handle>,<type>,<handle>,<length>,<data>

Response Format

GATTC Writing ...

Parameters

<conn_handle>:

connection handle

<type>:

read type

  • 0: write characteristic by handle

  • 1: write characteristic by handle use write_no_rsp

  • 2: signed write characteristic by handle

<handle>:

characteristic value handle

<length>:

length of writed data

<data>:

writed data, hexdata No 0x

AT+BLEGATTC=en_cccd(ble_mgr)

Functional Description

This command is used to enable server’s cccd(based on ble_mgr lib)。

Command Format

AT+BLEGATTC=en_cccd,<conn_handle>,<srv_uuid16>,<char_uuid16>,<cccd_val>

Response Format

GATTC enable cccd going ...
[APP] Simple ble client enable char v2 notify succeed

Parameters

<conn_handle>:

connection handle

<srv_uuid16>:

service UUID

<char_uuid16>:

characteristic UUID

<cccd_val>:

CCCD value

  • 1: notify enable

  • 2: indicate enable

  • 3: both enable

  • 0: none is enabled

AT+BLEGATTC=dis_cccd(ble_mgr)

Functional Description

This command is used to disable server’s cccd.

Command Format

AT+BLEGATTC=dis_cccd,<conn_handle>,<srv_uuid16>,<char_uuid16>,<cccd_val>

Response Format

GATTC disable cccd going ...
[APP] Simple ble client disable char v2 notify succeed

Parameters

<conn_handle>:

connection handle

<srv_uuid16>:

service UUID

<char_uuid16>:

characteristic UUID

<cccd_val>:

CCCD value

  • 1: notify enable

  • 2: indicate enable

  • 3: both enable

  • 0: none is enabled

BLE GATTS

AT+BLEGATTS=notify

Functional Description

This command is used to send notification data to remote client.

Command Format

AT+BLEGATTS=notify,<conn_handle>,<service_app_id>,<charac_index>,<length>,<data>

Response Format

[APP] Simple BLE notify succeed!

Parameters

<conn_handle>:

connection handle

<service_app_id>:

service app ID

<charac_index>:

characteristic index

<length>:

length of notify data

<data>:

notify_data, hexdata No 0x

AT+BLEGATTS=indicate

Functional Description

This command is used to send indication data to remote client.

Command Format

AT+BLEGATTS=indicate,<conn_handle>,<service_app_id>,<charac_index>,<length>,<data>

Response Format

[APP] Simple BLE indicate succeed!

Parameters

<conn_handle>:

connection handle

<service_app_id>:

service app ID

<charac_index>:

characteristic index

<length>:

length of indicate data

<data>:

indicate_data, hexdata No 0x

AT+BLEGATTS=cte_set_param

Functional Description

This command is used to set parameter of CTE service.

Command Format

AT+BLEGATTS=cte_set_param,<param_type>,<param_value>

Response Format

[APP] Simple BLE indicate succeed!

Parameters

<param_type>:

Parameters type

  • 0: enable or disable connectionless CTE transmit

  • 1: enable or disable connection CTE transmit

  • 2: advertising CTE minimum length

  • 3: advertising CTE minimum transmit count

  • 4: advertising CTE transmit duration

  • 5: advertising CTE interval

  • 6: advertising CTE PHY

  • 7: connectionless CTE type

  • 8: connection CTE type

  • 9: antenna ids for connection CTE transmit

  • 10: antenna ids for connectionless CTE transmit

<param_value>:

Parameters value

  • for param type 0 and type 2-8, integer num

  • for param type 1, param_value format is: <enable>,<conn_handle>,eg:1,16

  • for param type 9 and 10, param_value format is: <num_ant_ids>,<ant_id_0>,<ant_id_1>,…,<ant_id_n>,eg:3,0,1,2

AT+BLEGATTS=exch_mtu

Functional Description

This command is used to initiate ATT exchange MTU request to remote device.

Command Format

AT+BLEGATTC=exch_mtu,<conn_handle>

Parameters

<conn_handle>:

connection handle

BLE Mesh

AT+BLEMESHSTACK=reset

Functional Description

This command is used to reset node itself.

Command Format

AT+BLEMESHSTACK=reset

Response Format

[APP] Unprovisioned Device

Parameters

NULL

AT+BLEMESHSTACK=dev_info

Functional Description

This command is used to show mesh beacon in the air.

Command Format

AT+BLEMESHSTACK=dev_info,<op>

Response Format

[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

Parameters

<op>:
  • 1: 开始打 Mesh Beacon 包

  • 0: 停止打 Mesh Beacon 包

AT+BLEMESHSTACK=list

Functional Description

This command is used to show mesh list information.

Command Format

AT+BLEMESHSTACK=list

Response Format

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

Parameters

NULL

AT+BLEMESHSTACK=fn_init

Functional Description

This command is used to init friend node feature.

Command Format

AT+BLEMESHSTACK=fn_init,<lpn_num>,<queue_size>,<rx_window>

Response Format

NULL

Parameters

<lpn_num>:

low power node number

<queue_size>:

queue size

<rx_window>:

rx window

AT+BLEMESHSTACK=fn_deinit

Functional Description

Deinitialize friend node.

Command Format

AT+BLEMESHSTACK=fn_deinit

Response Format

NULL

Parameters

NULL

AT+BLEMESHSTACK=pbadvcon

Functional Description

This command is used to establish PB-ADV link with unprovisioned device.

Command Format

AT+BLEMESHSTACK=pbadvcon,<device_uuid>

Response Format

[APP] PB-ADV Link Opened!

Parameters

<device_uuid>:

device UUID, hexdata,16byte, without 0x, e.g. D803804CE000060708090A0B0C0D0E0F

AT+BLEMESHSTACK=pbadvdiscon

Functional Description

This command is used to close PB-ADV link.

Command Format

AT+BLEMESHSTACK=pbadvcon,<device_uuid>

Response Format

peer device response:

[APP] PB-ADV link closed

Parameters

NULL

AT+BLEMESHSTACK=gatt_con

Functional Description

This command is used to establish PB-GATT link with unprovisioned device.

Command Format

AT+BLEMESHSTACK=gatt_con,<addr_type>,<addr>

Response Format

[APP] Connected, handle: 16, role: master, remote device: 00:E0:4C:80:0E:41(public)

Parameters

<addr_type>:

address type

  • 0: Public Device Address

  • 1: Random Device Address

<addr>:

peer address, hexdata No 0x, e.g. 00e04c0a30c3

AT+BLEMESHSTACK=gatt_discon

Functional Description

This command is used to cancel PB-GATT link with device.

Command Format

AT+BLEMESHSTACK=gatt_discon,<conn_handle>

Response Format

[APP] Disconnected, reason: 0x116, handle: 16, role: master, remote device: 00:E0:4C:80:0E:41(public)

Parameters

<conn_handle>:

connection handle

AT+BLEMESHSTACK=prov

Functional Description

This command is used to start provisioning a unprovisioned device.

Command Format

AT+BLEMESHSTACK=prov[,<attention>]

Response Format

[APP] PB-ADV Link Closed!
[APP] Provisioning complete,unicast address:0x100

Parameters

<attention>:

the attention for provision(option)

AT+BLEMESHSTACK=prov_dis

Functional Description

This command is used to discovery provisioning service of unprovisioned device.

Command Format

AT+BLEMESHSTACK=prov_dis,<conn_handle>

Response Format

[APP] Prov service discovery done!

Parameters

<conn_handle>:

connection handle

AT+BLEMESHSTACK=prov_choose

Functional Description

This command is used to choose a method for provisioning.

Command Format

AT+BLEMESHSTACK=prov_choose,<algorithm>,<public_key>,<auth_method>,<oob_action>,<oob_size>

Response Format

NULL

Parameters

<algorithm>:

the algorithm for auth

<public_key>:

the method for exchange public key

<auth_method>:

the method for auth process

<oob_action>:

the oob action for auth process

<oob_size>:

the oob size for auth process

AT+BLEMESHSTACK=prov_notify

Functional Description

This command is used to enable/disable notification of provisioning service.

Command Format

AT+BLEMESHSTACK=prov_notify,<is_enable>

Response Format

NULL

Parameters

<is_enable>:
  • 1: Enable notification

  • 0: Disable notification

AT+BLEMESHSTACK=proxy_dis

Functional Description

This command is used to discovery proxy service of provisioned device.

Command Format

AT+BLEMESHSTACK=proxy_dis,<conn_handle>

Response Format

[APP] Proxy service discovery done!

Parameters

<conn_handle>:

connection handle

AT+BLEMESHSTACK=proxy_notify

Functional Description

This command is used to enable/disable notification of proxy service.

Command Format

AT+BLEMESHSTACK=proxy_notify,<is_enable>

Response Format

[APP] Proxy service discovery done!

Parameters

<is_enable>:
  • 1: enable notification

  • 0: disable notification

AT+BLEMESHSTACK=lpn_init

Functional Description

This command is used to init low power node feature.

Command Format

AT+BLEMESHSTACK=lpn_init,<fn_num>

Response Format

NULL

Parameters

<fn_num>:

Friend node number

AT+BLEMESHSTACK=lpn_req

Functional Description

This command is used to start establish friendship with a friend node.

Command Format

AT+BLEMESHSTACK=lpn_init,<fn_num>

Response Format

[APP] Established friendship with FN: 0x0100 success

Parameters

<fn_num>:

Friend node number

AT+BLEMESHSTACK=lpn_sub

Functional Description

This command is used to add/remove subscribe address to friend node.

Command Format

AT+BLEMESHSTACK=lpn_sub,<fn_index>,<addr>,<add_rm>

Response Format

[APP] Established friendship with FN: 0x0100 success

Parameters

<fn_index>:

Friend node index

<addr>:

group address, hexdata,2 bytes,eg.0xc001

<add_rm>:

add or remove

  • 1: add

  • 0: remove

AT+BLEMESHSTACK=lpn_clear

Functional Description

This command is used to clear friendship with a friend node.

Command Format

AT+BLEMESHSTACK=lpn_clear,<fn_index>

Response Format

[APP] Lost friendship with FN: 0x0100

Parameters

<fn_index>:

Friend node index

AT+BLEMESHSTACK=lpn_deinit

Functional Description

Deinitialize low power node.

Command Format

AT+BLEMESHSTACK=lpn_deinit

Response Format

NULL

Parameters

NULL

AT+BLEMESHSTACK=random

Functional Description

This command is used to set random value for provisioning process.

Command Format

AT+BLEMESHSTACK=random,<value>

Response Format

NULL

Parameters

<value>:

random value

AT+BLEMESHSTACK=hb_sub

Functional Description

This command is used to get local received hartbeat subscribe result.

Command Format

AT+BLEMESHSTACK=hb_sub

Response Format

[atcmd_ble_mesh_get_hb_subscribe_result] Src:0x0, dst:0x0, period:0, count:0, min_hops:0, max_hops:0

Parameters

NULL

AT+BLEMESHSTACK=model_sub

Functional Description

This command is used to subscribe address for local model.

Command Format

AT+BLEMESHSTACK=model_sub,<element_index>,<model_id>,<sub_addr>

Response Format

NULL

Parameters

<element_index>:

element index in local nodel

<model_id>:

model ID

<sub_addr>:

subscribe address

AT+BLEMESHSTACK=retran_set

Functional Description

This command is used to set mesh retrans parameter.

Command Format

AT+BLEMESHSTACK=retran_set,<ttl>,<relay_retrans_count>,<net_retrans_count>,<trans_retrans_count>

Response Format

Set node net trans count 3, relay retrans count 2, ttl 6, trans retrans count 1, Success!

Parameters

<ttl>:

The maximum number of hops for a message

  • 0 & [2, 127]

<relay_retrans_count>:

The number of times a message is retried

  • [0, 7]

<net_retrans_count>:

The number of retransmissions for a network message

  • [0, 7]

<trans_retrans_count>:

The number of automatic retransmission attempts at the transport layer when an ACK is not received

  • [0, 10]

AT+BLEMESHSTACK=set_txphy

Functional Description

This command is used to set mesh tx phy.

Command Format

AT+BLEMESHSTACK=set_txphy,<tx_phy>

Response Format

Set node net trans count 3, relay retrans count 2, ttl 6, trans retrans count 1, Success!

Parameters

<tx_phy>:

TX PHY

  • 0x01: legacy on 1M

  • 0x02: legacy on S2

  • 0x04: legacy on S8

  • 0x08: extended on 1M & 1M

  • 0x10: extended on 2M & 2M

AT+BLEMESHSTACK=prov_s

Functional Description

This command is used to set mesh prov parameter.

Command Format

AT+BLEMESHSTACK=prov_s,<unicast_addr>,<net_key>,<app_key>[,<dev_key>]

Response Format

NULL

Parameters

<unicast_addr>:

unicast address, hexdata,2 byte,eg.0x0100

<net_key>:

network key, hexdata,16byte, without 0x, e.g. 1234804CE000060708090A0B0C0D0E0F

<app_key>:

application key, hexdata,16byte, without 0x, e.g. 5678804CE000060708090A0B0C0D0E0F

<dev_key>:

device key, hexdata,16byte, without 0x, e.g. ABCD804CE000060708090A0B0C0D0E0F

AT+BLEMESHCONFIG=aka

Functional Description

This command is used to add app key.

Command Format

AT+BLEMESHCONFIG=aka,<unicast_addr>,<net_key_index>,<app_key_index>

Response Format

[APP] Config client model receive Config AppKey Status message with status SUCCESS

Parameters

<unicast_addr>:

unicast address, hexdata,2 byte,eg.0x0100

<net_key_index>:

network key index

<app_key_index>:

application key index

AT+BLEMESHCONFIG=mab

Functional Description

This command is used to bind app key to model.

Command Format

AT+BLEMESHCONFIG=mab,<dst>,<element_addr>,<model_id>,<app_key_index>

Response Format

[APP] Config client model receive Config Model App Status message with status SUCCESS

Parameters

<dst>:

node address, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<app_key_index>:

application key index

AT+BLEMESHCONFIG=msa

Functional Description

This command is used to subscribe group address to model.

Command Format

AT+BLEMESHCONFIG=msa,<dst>,<element_addr>,<model_id>,<group_addr>

Response Format

[APP] Config client model receive Config Model Subscription Status message with status SUCCESS

Parameters

<dst>:

node address, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<group_addr>:

group address

-[0xC000, 0xFEFF]

AT+BLEMESHCONFIG=ttl_get

Functional Description

This command is used to get device ttl information.

Command Format

AT+BLEMESHCONFIG=ttl_get,<dst>

Response Format

[rpl_cb]: Lower Seq, loop 0, src 0x0100, iv index 0x0, msg seq 0x000000, rpl seq 0x000000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=ttl_set

Functional Description

This command is used to set device ttl information.

Command Format

AT+BLEMESHCONFIG=ttl_set,<dst>,<ttl>

Response Format

[APP] Config client model receive message:default TTL:5

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<ttl>:

ttl to be set

  • [0x00, 0x7F]

  • 0xFF: Use Default TTL

AT+BLEMESHCONFIG=relay_get

Functional Description

This command is used to get device relay state.

Command Format

AT+BLEMESHCONFIG=relay_get,<dst>

Response Format

[APP] Config client model receive message,Relay State: 1, Count = 2 Step = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=relay_set

Functional Description

This command is used to set device relay state.

Command Format

AT+BLEMESHCONFIG=relay_set,<dst>,<state>,<count>,<steps>

Response Format

[APP] Config client model receive message,Relay State: 1, Count = 2 Step = 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<state>:
  • 1: enable device relay

  • 0: disable device relay

<count>:

retransmission count

  • [0, 7]

<steps>:

interval between retransmissions

  • [0b000000, 0b111111]

AT+BLEMESHCONFIG=net_trans_get

Functional Description

This command is used to get device node network transmit state.

Command Format

AT+BLEMESHCONFIG=net_trans_get,<dst>

Response Format

[APP] Config client model receive message,Net transmit state: Count = 6 Step = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=net_trans_set

Functional Description

This command is used to set device node network transmit state.

Command Format

AT+BLEMESHCONFIG=net_trans_set,<dst>,<count>,<steps>

Response Format

[APP] Config client model receive message,Net transmit state: Count = 2 Step = 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<count>:

retransmission count

  • [0, 7]

<steps>:

interval between retransmissions

  • [0b000000, 0b111111]

AT+BLEMESHCONFIG=reset

Functional Description

This command is used to reset a provisioned device.

Command Format

AT+BLEMESHCONFIG=reset,<dst>

Response Format

peer device response:

[APP] Unprovisioned Device

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=beacon_get

Functional Description

This command is used to get device node beacon state.

Command Format

AT+BLEMESHCONFIG=beacon_get,<dst>

Response Format

[APP] beacon state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=beacon_set

Functional Description

This command is used to set device node beacon state.

Command Format

AT+BLEMESHCONFIG=beacon_set,<dst>,<state>

Response Format

[APP] beacon state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<state>:
  • 0: No broadcast a secure network beacon

  • 1: Broadcast a secure network beacon

AT+BLEMESHCONFIG=compo_data_get

Functional Description

This command is used to get device node composition data.

Command Format

AT+BLEMESHCONFIG=compo_data_get,<dst>,<page>

Response Format

[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

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<page>:

always get page 0

AT+BLEMESHCONFIG=proxy_get

Functional Description

This command is used to get device node proxy state.

Command Format

AT+BLEMESHCONFIG=proxy_get,<dst>

Response Format

[APP] provisoner receive proxy state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=proxy_set

Functional Description

This command is used to set device node proxy state.

Command Format

AT+BLEMESHCONFIG=proxy_set,<dst>,<state>

Response Format

[APP] provisoner receive proxy state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<state>:

proxy state

  • 0: The Mesh Proxy Service is running, Proxy feature is disabled.

  • 1: The Mesh Proxy Service is running, Proxy feature is enabled.

  • 2: The Mesh Proxy Service is not supported, Proxy feature is not supported.

AT+BLEMESHCONFIG=pub_get

Functional Description

This command is used to get device node’s model publication address.

Command Format

AT+BLEMESHCONFIG=pub_get,<dst>,<element_addr>,<model_id>

Response Format

[APP] Pub stat: pub addr = 0x0000, ttl = 7, period steps:0, period resolution:0, retrans count:0, retrans steps:0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

AT+BLEMESHCONFIG=pub_set

Functional Description

This command is used to set device node’s model publication address and other parameters.

Command Format

AT+BLEMESHCONFIG=pub_set,<dst>,<element_addr>,<model_id>,<pub_addr>,<app_key_index>,<frnd_flag>,<ttl>,<steps>,<resolution>,<count>,<retran_steps>

Response Format

[APP] Generic on off client model receive message: src = 0x100, present = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<pub_addr>:

publish address, hexdata, 2 byte, e.g. 0xc001

  • [0x0000, 0x7FFF] & [0xC000, 0xFFFF]

<app_key_index>:

application key index

<frnd_flag>:
  • 0: Master security material is used for Publishing

  • 1: Friendship security material is used for Publishing

<ttl>:

The Publish TTL value

  • [0x00, 0x7F]

  • 0xFF: Use Default TTL

<steps>:

The number of steps

  • 0x00: Publish Period is disabled

  • [0x01, 0x3F]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<count>:

retransmission count

  • [0, 7]

<retran_steps>:

retransmission steps

  • [0b000000, 0b111111]

AT+BLEMESHCONFIG=msd

Functional Description

This command is used to delete model subscription group address.

Command Format

AT+BLEMESHCONFIG=msd,<dst>,<element_addr>,<model_id>,<group_addr>

Response Format

[APP] Config client model receive Config Model Subscription Status message with status SUCCESS

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<group_addr>:

group address, hexdata, 2 byte, e.g. 0xc001

  • [0xC000, 0xFEFF]

AT+BLEMESHCONFIG=msda

Functional Description

This command is used to delete model all subscription group address.

Command Format

AT+BLEMESHCONFIG=msd,<dst>,<element_addr>,<model_id>,<group_addr>

Response Format

[APP] Config client model receive Config Model Subscription Status message with status SUCCESS

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

AT+BLEMESHCONFIG=mso

Functional Description

This command is used to overwrite model subscription group address.

Command Format

AT+BLEMESHCONFIG=mso,<dst>,<element_addr>,<model_id>,<group_addr>

Response Format

[APP] Config client model receive Config Model Subscription Status message with status SUCCESS

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<group_addr>:

group address, hexdata, 2 byte, e.g. 0xc001

  • [0xC000, 0xFEFF]

AT+BLEMESHCONFIG=msg

Functional Description

This command is used to get model subscription group address.

Command Format

AT+BLEMESHCONFIG=msg,<dst>,<element_addr>,<model_id>

Response Format

[APP] Config client model receive message:MODEL SUB LIST SUCCESS
Model sub list: src 0x0102 element idx 0 model id 0x1000ffff
   c002

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

AT+BLEMESHCONFIG=nka

Functional Description

This command is used to add net key.

Command Format

AT+BLEMESHCONFIG=nka,<dst>,<net_key_index>

Response Format

[APP] Success!

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHCONFIG=nku

Functional Description

This command is used to update net key.

Command Format

AT+BLEMESHCONFIG=nku,<dst>,<net_key_index>,<net_key>

Response Format

[APP] Success!

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key>:

network key, hexdata,16 byte,No 0x,eg.12345678912345678912345678912345

AT+BLEMESHCONFIG=nkd

Functional Description

This command is used to delete net key.

Command Format

AT+BLEMESHCONFIG=nkd,<dst>,<net_key_index>

Response Format

[APP] Success!

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHCONFIG=nkg

Functional Description

This command is used to get net key.

Command Format

AT+BLEMESHCONFIG=nkg,<dst>

Response Format

[APP] Config client model receive message:NET_KEY_LIST SUCCESS
NetKey List: num = 1!
   0000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=aku

Functional Description

更新application key。

Command Format

AT+BLEMESHCONFIG=aku,<dst>,<net_key_index>,<app_key_index>,<app_key>

Response Format

ret:0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<app_key_index>:

application key index

<app_key>:

application key

AT+BLEMESHCONFIG=akd

Functional Description

删除application key。

Command Format

AT+BLEMESHCONFIG=akd,<dst>,<net_key_index>,<app_key_index>

Response Format

[APP] Config client model receive Config AppKey Status message with status SUCCESS

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<app_key_index>:

application key index

AT+BLEMESHCONFIG=akg

Functional Description

Get application key.

Command Format

AT+BLEMESHCONFIG=akd,<dst>,<net_key_index>

Response Format

[APP] Config client model receive message:APP_KEY_LIST SUCCESS
AppKey List: NetKeyIndex = 0x000 num = 0!

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHCONFIG=node_identity_get

Functional Description

This command is used to get node identity state.

Command Format

AT+BLEMESHCONFIG=node_identity_get,<dst>,<net_key_index>

Response Format

[APP] Node identity state: 0 on NetKeyIndex 0x000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHCONFIG=node_identity_set

Functional Description

This command is used to set node identity state.

Command Format

AT+BLEMESHCONFIG=node_identity_set,<dst>,<net_key_index>,<identity>

Response Format

[APP] Node identity state: 1 on NetKeyIndex 0x000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<identity>:
  • 0: Node Identity for a subnet is stopped

  • 1: Node Identity for a subnet is running

  • 2: Node Identity is not supported

AT+BLEMESHCONFIG=maub

Functional Description

This command is used to unbind model app key.

Command Format

AT+BLEMESHCONFIG=maub,<dst>,<element_addr>,<model_id>,<app_key_index>

Response Format

[APP] Config client model receive Config Model App Status message with status SUCCESS

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

<app_key_index>:

application key index

AT+BLEMESHCONFIG=mag

Functional Description

Get model application key。

Command Format

AT+BLEMESHCONFIG=mag,<dst>,<element_addr>,<model_id>

Response Format

[APP] Config client model receive message:MODEL_APP_LIST SUCCESS
Model AppKey List: Element Index = 0 model id = 0x1000ffff num = 0!

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<element_addr>:

element address, e.g. 0, 1, 2

<model_id>:

model ID

AT+BLEMESHCONFIG=frg

Functional Description

This command is used to get friend state.

Command Format

AT+BLEMESHCONFIG=frg,<dst>

Response Format

[APP] frnd state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=frs

Functional Description

This command is used to set friend state.

Command Format

AT+BLEMESHCONFIG=frs,<dst>,<state>

Response Format

[APP] frnd state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=lptg

Functional Description

This command is used to get lpn poll timeout state.

Command Format

AT+BLEMESHCONFIG=lptg,<dst>,<lpn_addr>

Response Format

[APP] frnd state: 1

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<lpn_addr>:

LPN address, hexdata,2 byte, e.g. 0x0101

AT+BLEMESHCONFIG=krpg

Functional Description

This command is used to get key refresh phase.

Command Format

AT+BLEMESHCONFIG=krpg,<dst>,<net_key_index>

Response Format

[APP] Node 0x0102: NetKeyIndex = 0x000 state = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHCONFIG=krps

Functional Description

This command is used to set key refresh phase.

Command Format

AT+BLEMESHCONFIG=krps,<dst>,<net_key_index>,<state>

Response Format

[APP] Node 0x0102: NetKeyIndex = 0x000 state = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<state>:

refresh state

  • 0: Normal operation; Key Refresh procedure is not active

  • 1: First phase of Key Refresh procedure

  • 2: Second phase of Key Refresh procedure

AT+BLEMESHCONFIG=hpg

Functional Description

This command is used to get heartbeat publication information.

Command Format

AT+BLEMESHCONFIG=hpg,<dst>

Response Format

[APP] Hb: pub dst = 0x0000 count_log:0, period_log:0, ttl = 0 NetKeyIndex = 0x000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=hps

Functional Description

This command is used to set heartbeat publication information.

Command Format

AT+BLEMESHCONFIG=hps,<dst>,<net_key_index>,<dst_pub>,<count_log>,<period_log>,<ttl>,<relay>,<proxy>,<frnd>,<lpn>

Response Format

[APP] Hb: pub dst = 0x0101 count_log:1, period_log:1, ttl = 3 NetKeyIndex = 0x000

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<dst_pub>:

heartbeat message destination address, hexdata,2 byte,eg.0x0101

<count_log>:

heartbeat messages count

  • 0: Heartbeat messages are not being sent periodically

  • [0x01, 0x11], Number of Heartbeat messages, 2^(n-1), that remain to be sent

  • 0xFF: Heartbeat messages are being sent indefinitely

<period_log>:

period of heartbeat messages

  • 0: Heartbeat messages are not being sent periodically

  • [0x01, 0x11], Period in 2^(n-1) seconds for sending periodical Heartbeat messages

<ttl>:

The Publish TTL value

  • [0x00, 0x7F]

<relay>:

Relay feature change triggers a Heartbeat message

  • 0: False

  • 1: True

<relay>:

Proxy feature change triggers a Heartbeat message

  • 0: False

  • 1: True

<frnd>:

Friend feature change triggers a Heartbeat message

  • 0: False

  • 1: True

<lpn>:

Low Power feature change triggers a Heartbeat message

  • 0: False

  • 1: True

AT+BLEMESHCONFIG=hsg

Functional Description

This command is used to get heartbeat subscription information.

Command Format

AT+BLEMESHCONFIG=hsg,<dst>

Response Format

[APP] Hb: sub src = 0x0000 dst = 0x0000 period_log = 0 count_log = 0

Parameters

<dst>:

node addr, hexdata,2 byte, e.g. 0x0100

AT+BLEMESHCONFIG=hss

Functional Description

This command is used to set heartbeat subscription information.

Command Format

AT+BLEMESHCONFIG=hss,<dst>,<src>,<dst_set>,<period_log>

Response Format

[APP] Hb: sub src = 0x0000 dst = 0x0000 period_log = 0 count_log = 0 hops range = [0, 0]

Parameters

<dst>:

destination node address, hexdata,2 byte, e.g. 0x0100

<src>:

source node address, hexdata,2 byte,eg.0x0101

<dst_set>:

publish address, hexdata,2 byte,eg.0x0102

<period_log>:
  • 0x00: Heartbeat messages are not being processed

  • [0x01, 0x11]: Remaining period in 2^(n-1) seconds for processing periodical Heartbeat messages

AT+BLEMESHDATA=write

Functional Description

This command is used to write data to node by datatrans model.

Command Format

AT+BLEMESHDATA=write,<dst>,<data>,<app_key_index>,<ack>

Response Format

[APP] Datatrans model receive message: Src 256 ,written 3 bytes, status:0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<data>:

writed date, hexdata,0-16 byte, without 0x ,eg.1234ef

<app_key_index>:

application key index

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

AT+BLEMESHDATA=read

Functional Description

This command is used to read data from node by datatrans model.

Command Format

AT+BLEMESHDATA=read,<dst>,<read_len>,<app_key_index>

Response Format

[APP] Datatrans model receive message,read 2 bytes date from remote src 256 :
0x0f0d

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<read_len>:

length of data to read

<app_key_index>:

application key index

AT+BLEMESHGOO=get

Functional Description

This command is used to get generic on off state from a device.

Command Format

AT+BLEMESHGOO=get,<dst>,<app_key_index>

Response Format

[APP] Generic on off client model receive message: src = 0x100, present = 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGOO=set

Functional Description

This command is used to set generic on off state to a device.

Command Format

AT+BLEMESHGOO=set,<dst>,<on_off>,<ack>,<app_key_index>[,<trans_num_steps>,<trans_step_reso>,<delay>]

Response Format

[APP] Generic on off client model receive message: src = 0x100, present = 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<on_off>:
  • 0: Turn light off

  • 1: Turn light on

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<trans_num_steps>:

transition steps

<trans_step_reso>:

transition step resolution

<delay>:

delay before state change

AT+BLEMESHLL=llg

Functional Description

This command is used to get light lightness state.

Command Format

AT+BLEMESHLL=llg,<dst>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, present 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lls

Functional Description

This command is used to set light lightness state.

Command Format

AT+BLEMESHLL=lls,<dst>,<lightness>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}

Response Format

[APP] light lightness client model receive: src 256, present 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xffff]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lllg

Functional Description

This command is used to get light linear lightness state.

Command Format

AT+BLEMESHLL=lllg,<dst>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, present 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=llls

Functional Description

This command is used to set light linear lightness state.

Command Format

AT+BLEMESHLL=llls,<dst>,<lightness>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}

Response Format

[APP] light lightness client model receive: src 256, present 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xffff]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lllag

Functional Description

This command is used to get last light lightness state.

Command Format

AT+BLEMESHLL=lllag,<dst>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, lightness 1144

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lldg

Functional Description

This command is used to get default light lightness state.

Command Format

AT+BLEMESHLL=lldg,<dst>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, lightness 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=llds

Functional Description

This command is used to set default light lightness state.

Command Format

AT+BLEMESHLL=llds,<dst>,<lightness>,<ack>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, lightness 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xffff]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=llrg

Functional Description

This command is used to get light lightness range state.

Command Format

AT+BLEMESHLL=llrg,<dst>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, status 0, min 0, max 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=llrs

Functional Description

This command is used to set light lightness range state.

Command Format

AT+BLEMESHLL=llrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>

Response Format

[APP] light lightness client model receive: src 256, status 0, min 1, max 100

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<range_min>:

minimum value of the range

  • [0x0001, 0xFFFF]

<range_max>:

maximum value of the range

  • [0x0001, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lcg

Functional Description

This command is used to get light ctl lightness state.

Command Format

AT+BLEMESHLCTL=lcg,<dst>,<app_key_index>

Response Format

[APP] light ctl client model receive: src 256, present lightness 0, present temperature 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lcs

Functional Description

This command is used to set light ctl lightness state.

Command Format

AT+BLEMESHLCTL=lcs,<dst>,<lightness>,<temperature>,<delta_uv>,<ack>,<app_key_index>,{<num_steps>,<resolution>,<delay>}

Response Format

[APP] light ctl client model receive: src 256, present lightness 10, present temperature 900

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xFFFF]

<temperature>:

light temperature

  • [0x0320, 0x4E20]

<delta_uv>:
  • [0x8000, 0x7FFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lctg

Functional Description

This command is used to get light ctl lightness temperature state.

Command Format

AT+BLEMESHLCTL=lctg,<dst>,<app_key_index>

Response Format

[APP] light ctl client model receive: src 256, present temperature 0, present delta_uv 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lcts

Functional Description

This command is used to set light ctl lightness temperature state.

Command Format

AT+BLEMESHLCTL=lcts,<dst>,<temperature>,<delta_uv>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light ctl client model receive: src 256, present temperature 900, present delta_uv 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:

lightness

  • [0x0000, 0xFFFF]

<temperature>:

lightness temperature

  • [0x0320, 0x4E20]

<delta_uv>:
  • [0x8000, 0x7FFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lctrg

Functional Description

This command is used to get light ctl lightness temperature range state.

Command Format

AT+BLEMESHLCTL=lctrg,<dst>,<app_key_index>

Response Format

[APP] light ctl client model receive: src 256, status 0, min 0, max 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lctrs

Functional Description

This command is used to set light ctl lightness temperature range state.

Command Format

AT+BLEMESHLCTL=lctrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>

Response Format

[APP] light ctl client model receive: src 256, status 0, min 900, max 1200

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<range_min>:

minimum value of the range

  • [0x0320, 0x4E20]

<range_max>:

maximum value of the range

  • [0x0320, 0x4E20]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lcdg

Functional Description

This command is used to get default light ctl lightness state.

Command Format

AT+BLEMESHLCTL=lcdg,<dst>,<app_key_index>

Response Format

[APP] light ctl client model receive: src  256, lightness 0, temperature 0, delta_uv 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lcds

Functional Description

This command is used to set default light ctl lightness state.

Command Format

AT+BLEMESHLCTL=lcds,<dst>,<lightness>,<temperature>,<delta_uv>,<ack>,<app_key_index>

Response Format

[APP] light ctl client model receive: src 256, lightness 10, temperature 1000, delta_uv 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:

lightness

  • [0x0000, 0xFFFF]

<temperature>:

lightness temperature

  • [0x0320, 0x4E20]

<delta_uv>:
  • [0x8000, 0x7FFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lhg

Functional Description

This command is used to get light hsl lightness state.

Command Format

AT+BLEMESHLHSL=lhg,<dst>,<app_key_index>

Response Format

[APP] light hsl client model receive: src 256, present lightness 0, present hue 0, presnet saturation 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhs

Functional Description

This command is used to set light hsl lightness state.

Command Format

AT+BLEMESHLHSL=lhs,<dst>,<lightness>,<hue>,<saturation>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light hsl client model receive: src 256, present lightness 0, present hue 0, presnet saturation 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:

lightness

  • [0x0000, 0xFFFF]

<hue>:
  • [0x0000, 0xFFFF]

<saturation>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lhtg

Functional Description

This command is used to get target light hsl lightness state.。

Command Format

AT+BLEMESHLHSL=lhtg,<dst>,<app_key_index>

Response Format

[APP] light hsl client model receive: src 256, target lightness 10, target hue 10, target saturation 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhhg

Functional Description

This command is used to get light hsl lightness hue state.

Command Format

AT+BLEMESHLHSL=lhhg,<dst>,<app_key_index>

Response Format

[APP] light hsl client model receive: src 256, present hue 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhhs

Functional Description

This command is used to set light hsl lightness hue state.

Command Format

AT+BLEMESHLHSL=lhhs,<dst>,<hue>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light hsl client model receive: src 256, present hue 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<hue>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lhsg

Functional Description

This command is used to get light hsl lightness saturation state.

Command Format

AT+BLEMESHLHSL=lhsg,<dst>,<app_key_index>

Response Format

[APP] light hsl client model receive: src 256, present saturation 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhss

Functional Description

This command is used to set light hsl lightness saturation state.

Command Format

AT+BLEMESHLHSL=lhss,<dst>,<saturation>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light hsl client model receive: src 256, present saturation 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<saturation>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lhdg

Functional Description

This command is used to get default light hsl lightness state.

Command Format

AT+BLEMESHLHSL=lhdg,<dst>,<app_key_index>

Response Format

[APP] light hsl client receive: src 256, lightness 0, hue 0, saturation 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhds

Functional Description

This command is used to set default light hsl lightness state.

Command Format

AT+BLEMESHLHSL=lhds,<dst>,<lightness>,<hue>,<saturation>,<ack>,<app_key_index>

Response Format

[APP] light hsl client receive: src 256, lightness 20, hue 10, saturation 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:

lightness

  • [0x0000, 0xFFFF]

<hue>:
  • [0x0000, 0xFFFF]

<saturation>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lhrg

Functional Description

This command is used to get light hsl lightness range state.

Command Format

AT+BLEMESHLHSL=lhrg,<dst>,<app_key_index>

Response Format

[APP] light hsl client receive: src 256, status 0, hue min 0, hue max 0, saturation min 0, saturation max 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lhrs

Functional Description

This command is used to set light hsl lightness range state.

Command Format

AT+BLEMESHLHSL=lhrs,<dst>,<hue_range_min>,<hue_range_max>,<saturation_range_min>,<saturation_range_max>,<ack>,<app_key_index>

Response Format

[APP] light hsl client receive: src 256, status 0, hue min 1, hue max 100, saturation min 1, saturation max 100

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<hue_range_min>:

minimum hue value of the range

  • [0x0000, 0xFFFF]

<hue_range_max>:

maximum hue value of the range

  • [0x0000, 0xFFFF]

<saturation_range_min>:

minimum saturation value of the range

  • [0x0000, 0xFFFF]

<saturation_range_max>:

maximum saturation value of the range

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lxg

Functional Description

This command is used to get light xyl lightness state.

Command Format

AT+BLEMESHLHSL=lxg,<dst>,<app_key_index>

Response Format

[APP] light xyl client receive: src 256, present lightness 0, present xyl_x 0, presnet xyl_y 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lxs

Functional Description

This command is used to set light xyl lightness state.

Command Format

AT+BLEMESHLXYL=lxs,<dst>,<lightness>,<xyl_x>,<xyl_y>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light hsl client receive: src 256, status 0, hue min 1, hue max 100, saturation min 1, saturation max 100

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xFFFF]

<xyl_x>:
  • [0x0000, 0xFFFF]

<xyl_y>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLL=lxtg

Functional Description

This command is used to get target light xyl lightness state.

Command Format

AT+BLEMESHLHSL=lxtg,<dst>,<app_key_index>

Response Format

[APP] light xyl client receive: src 256, target lightness 10, target xyl_x 10, target xyl_y 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lxdg

Functional Description

This command is used to get default light xyl lightness state.

Command Format

AT+BLEMESHLHSL=lxdg,<dst>,<app_key_index>

Response Format

[APP] light xyl client receive: src 256, lightness 0, xyl_x 0, xyl_y 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lxds

Functional Description

This command is used to set default light xyl lightness state.

Command Format

AT+BLEMESHLXYL=lxds,<dst>,<lightness>,<xyl_x>,<xyl_y>,<ack>,<app_key_index>

Response Format

[APP] light xyl client receive: src 256, lightness 10, xyl_x 10, xyl_y 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xFFFF]

<xyl_x>:
  • [0x0000, 0xFFFF]

<xyl_y>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLL=lxrg

Functional Description

This command is used to get light xyl lightness range state.

Command Format

AT+BLEMESHLHSL=lxrg,<dst>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLL=lxrs

Functional Description

This command is used to set light xyl lightness range state.

Command Format

AT+BLEMESHLXYL=lxrs,<dst>,<xyl_x_range_min>,<xyl_x_range_max>,<xyl_y_range_min>,<xyl_y_range_max>,<ack>,<app_key_index>

Response Format

[APP] light xyl client receive: src 256, lightness 10, xyl_x 10, xyl_y 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<lightness>:
  • [0x0000, 0xFFFF]

<xyl_x_range_min>:
  • [0x0000, 0xFFFF]

<xyl_x_range_max>:
  • [0x0000, 0xFFFF]

<xyl_y_range_min>:
  • [0x0000, 0xFFFF]

<xyl_y_range_max>:
  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLLC=llcmg

Functional Description

This command is used to get light lc mode state.

Command Format

AT+BLEMESHLLC=llcmg,<dst>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, mode 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLLC=llcms

Functional Description

This command is used to set light lc mode state.

Command Format

AT+BLEMESHLLC=llcms,<dst>,<mode>,<ack>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, mode 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<mode>:
  • 0: The controller is turned off. The binding with the Light Lightness state is disabled.

  • 1: The controller is turned on. The binding with the Light Lightness state is enabled.

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLLC=llcomg

Functional Description

This command is used to get light lc occupancy mode state.

Command Format

AT+BLEMESHLLC=llcomg,<dst>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, occupancy mode 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLLC=llcoms

Functional Description

This command is used to set light lc occupancy mode state.

Command Format

AT+BLEMESHLLC=llcoms,<dst>,<mode>,<ack>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, occupancy mode 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<mode>:

占用模式

  • 0: The controller does not transition from a standby state when occupancy is reported.

  • 1: The controller may transition from a standby state when occupancy is reported.

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

AT+BLEMESHLLC=llcloog

Functional Description

This command is used to get light lc light on off state.

Command Format

AT+BLEMESHLLC=llcloog,<dst>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, present on off 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHLLC=llcloos

Functional Description

This command is used to set light lc light on off state.

Command Format

AT+BLEMESHLLC=llcloos,<dst>,<on_off>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] light lc client receive: src 256, present on off 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<on_off>:

on off state

  • 0: Turn light off

  • 1: Turn light on

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHLLC=llcpg

Functional Description

This command is used to get light lc property.

Command Format

AT+BLEMESHLLC=llcpg,<dst>,<property_id>,<app_key_index>

Response Format

[APP] light lc client receive: src 256, property id 0x1, property value 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

<app_key_index>:

application key index

AT+BLEMESHLLC=llcps

Functional Description

This command is used to set light lc property.

Command Format

AT+BLEMESHLLC=llcps,<dst>,<ack>,<app_key_index>,<property_id>,[<property_value>]

Response Format

[APP] light lc client receive: src 256, property id 0x1, property value 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<property_id>:

property ID

<property_value>:

property value, 0-16 byte, hexdata, e.g.1234

AT+BLEMESHGLE=glg

Functional Description

This command is used to get generic level.

Command Format

AT+BLEMESHGLE=glg,<dst>,<app_key_index>

Response Format

[APP] generic level client receive: src 256, present level 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGLE=gls

Functional Description

This command is used to set generic level.

Command Format

AT+BLEMESHGLE=gls,<dst>,<level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] generic level client receive: src 256, present level 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<level>:

generic level

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHGLE=glds

Functional Description

This command is used to set generic delta level.

Command Format

AT+BLEMESHGLE=glds,<dst>,<delta_level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] generic level client receive: src 256, present level 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<delta_level>:

generic delta level

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHGLE=glms

Functional Description

This command is used to set generic level move.

Command Format

AT+BLEMESHGLE=glms,<dst>,<move>,<ack>,<app_key_index>,<num_steps>,<resolution>,<delay>

Response Format

[APP] generic level client receive: src 256, present level 20, target level 30, remaining time 5

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<move>:

generic level move

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHGLE=gdttg

Functional Description

This command is used to get generic default transition time.

Command Format

AT+BLEMESHGDTT=gdttg,<dst>,<app_key_index>

Response Format

[APP] generic default transition time client receive: src 256, resolution 0, num steps 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGLE=gdtts

Functional Description

This command is used to set generic default transition time.

Command Format

AT+BLEMESHGDTT=gdtts,<dst>,<num_steps>,<resolution>,<app_key_index>

Response Format

[APP] generic default transition time client receive: src 256, resolution 1, num steps 5

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<app_key_index>:

application key index

AT+BLEMESHGPOO=gpg

Functional Description

This command is used to get generic on power up.

Command Format

AT+BLEMESHGPOO=gpg,<dst>,<app_key_index>

Response Format

[APP] generic power on off client receive: src 256, on power up 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGPOO=gps

Functional Description

This command is used to set generic on power up.

Command Format

AT+BLEMESHGPOO=gps,<dst>,<on_power_up>,<ack>,<app_key_index>

Response Format

[APP] generic power on off client receive: src 256, on power up 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<on_power_up>:
  • 0: Off

  • 1: Default

  • 2: Restore

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHGPL=gplg

Functional Description

This command is used to get generic power level.

Command Format

AT+BLEMESHGPL=gplg,<dst>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, present power 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGPOO=gpls

Functional Description

This command is used to set generic power level.

Command Format

AT+BLEMESHGPL=gpls,<dst>,<power_level>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] generic power level client receive: src 256, present power 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<power_level>:

power level

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHGPL=gpllg

Functional Description

This command is used to get last generic power level.

Command Format

AT+BLEMESHGPL=gpllg,<dst>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, power 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGPL=gpldg

Functional Description

This command is used to get default generic power level.

Command Format

AT+BLEMESHGPL=gpldg,<dst>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, power 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGPL=gplds

Functional Description

This command is used to set default generic power level.

Command Format

AT+BLEMESHGPL=gplds,<dst>,<power>,<ack>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, power 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<power>:

power level

  • [0x0000, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHGPL=gplrg

Functional Description

This command is used to get generic power level range.

Command Format

AT+BLEMESHGPL=gplrg,<dst>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, status 0, range min 0, range max 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGPL=gplrs

Functional Description

This command is used to set generic power level range.

Command Format

AT+BLEMESHGPL=gplrs,<dst>,<range_min>,<range_max>,<ack>,<app_key_index>

Response Format

[APP] generic power level client receive: src 256, status 0, range min 1, range max 100

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<range_min>:

minimum power level value

  • [0x0000, 0xFFFF]

<range_max>:

maximum power level value

  • [0x0000, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHGB=gbg

Functional Description

This command is used to get generic battery.

Command Format

AT+BLEMESHGB=gbg,<dst>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGLO=glgg

Functional Description

This command is used to get generic global location.

Command Format

AT+BLEMESHGLO=glgg,<dst>,<app_key_index>

Response Format

[APP] Generic location client receive: src = 256, latitude = 0, longitude = 0, altitude = 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGLO=glgs

Functional Description

This command is used to set generic global location.

Command Format

AT+BLEMESHGLO=glgs,<dst>,<latitude>,<longitude>,<altitude>,<ack>,<app_key_index>

Response Format

[APP] Generic location client receive: src = 256, latitude = 20, longitude = -20, altitude = 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<latitude>:
  • 0x80000000 not configured

<longitude>:
  • 0x80000000 not configured

<altitude>:
  • [0x8000, 0x7FFFD]

  • 0x7FFF not configured

  • 0x7FFE greater than or equal to 32766

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHGLO=gllg

Functional Description

This command is used to get generic local location.

Command Format

AT+BLEMESHGLO=gllg,<dst>,<app_key_index>

Response Format

[APP] Generic location client receive: src = 256, north = 0, east = 0, altitude = 0, floor = 0, stationary = 0, updata time = 0, precision = 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGLO=glls

Functional Description

This command is used to set generic local location.

Command Format

AT+BLEMESHGLO=glls,<dst>,<north>,<east>,<altitude>,<floor_num>,<stationary>,<update_time>,<precision>,<ack>,<app_key_index>

Response Format

[APP] Generic location client receive: src = 256, north = -1, east = -2, altitude = -3, floor = 1, stationary = 1, updata time = 1, precision = 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<north>:
  • [-32767, 32767]

<east>:
  • [-32767, 32767]

<altitude>:
  • [0x8000, 0x7FFFD]

  • 0x7FFF not configured

  • 0x7FFE greater than or equal to 32766

<floor_num>:

floor number

  • 0x00: floor -20 or any floor below -20

  • [0x01, 0xFB], floor number N,encoded as X=N+20

  • 0xFC: floor 232 or ant floor above 232

  • 0xFD: ground floor. floor 0

  • 0xFE: ground floor. floor 1

  • 0xFF not configured

<update_time>:
  • [0, 15]

<precision>:
  • [0, 15]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHGP=gupsg

Functional Description

This command is used to get generic user properties.

Command Format

AT+BLEMESHGP=gupsg,<dst>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256 num_ids = 2 user property ids: 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGP=gupg

Functional Description

This command is used to get generic user property.

Command Format

AT+BLEMESHGP=gupg,<dst>,<property_id>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256 num_ids = 2 user property ids: 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHGP=gups

Functional Description

This command is used to set generic user property.

Command Format

AT+BLEMESHGP=gups,<dst>,<property_id>,<ack>,<app_key_index>,<data>

Response Format

[APP] Generic property client receive: src = 256,  property id = 0x1, property access = 3 user property values: 12 34 56

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<data>:

property data, hexdata, no 0x.

<app_key_index>:

application key index

AT+BLEMESHGP=gapsg

Functional Description

This command is used to get generic admin properties.

Command Format

AT+BLEMESHGP=gapsg,<dst>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256 num_ids = 2 admin property ids: 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGP=gapg

Functional Description

This command is used to get generic admin property.

Command Format

AT+BLEMESHGP=gapg,<dst>,<property_id>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256,  property id = 0x1, property access = 3 admin property values: 01 01 02

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHGP=gaps

Functional Description

This command is used to set generic admin property.

Command Format

AT+BLEMESHGP=gaps,<dst>,<property_id>,<property_access>,<ack>,<app_key_index>,<data>

Response Format

[APP] Generic property client receive: src = 256,  property id = 0x1, property access = 3 admin property values: 12 34 56

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<property_access>:

property access

  • 0x00: not a user property

  • 0x01: can be read

  • 0x02: can be written

  • 0x03: can be read and written

  • [0x04, 0xFF]: prohibited

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

<data>:

property data, hexdata, no 0x.

AT+BLEMESHGP=gmpsg

Functional Description

This command is used to get generic manufacturer properties.

Command Format

AT+BLEMESHGP=gmpsg,<dst>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256 num_ids = 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHGP=gmpg

Functional Description

This command is used to get generic manufacturer property.

Command Format

AT+BLEMESHGP=gmpg,<dst>,<property_id>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256,  property id = 0x1, property access = 3 manufacturer property values: 01 01 02

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHGP=gmps

Functional Description

This command is used to set generic manufacturer property.

Command Format

AT+BLEMESHGP=gmps,<dst>,<property_id>,<property_access>,<ack>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256,  property id = 0x1, property access = 3 manufacturer property values: 01 01 02

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<property_access>:

property access

  • 0x00: not a user property

  • 0x01: can be read

  • 0x02: can be written

  • 0x03: can be read and written

  • [0x04, 0xFF]: prohibited

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHGP=gcpsg

Functional Description

This command is used to get generic client properties

Command Format

AT+BLEMESHGP=gcpsg,<dst>,<app_key_index>

Response Format

[APP] Generic property client receive: src = 256 num_ids = 3 client property ids: 0003 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHSENSOR=sdg

Functional Description

This command is used to get sensor descriptor.

Command Format

AT+BLEMESHSENSOR=sdg,<dst>,<app_key_index>,[<property_id>]

Response Format

[APP] Sensor client receive: src 256, property_id: 1, positive_tolerance: 10, negative_tolerance: 10, sampling_function: 1,measurement_period: 1, update_interval: 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHSENSOR=scg

Functional Description

This command is used to get sensor cadence.

Command Format

AT+BLEMESHSENSOR=scg,<dst>,<property_id>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHSENSOR=scs

Functional Description

This command is used to set sensor cadence.

Command Format

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>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<fast_cadence_period_divisior>:
  • [0, 15]

<status_trigger_type>:
  • 0: defined by the Format Type of the characteristic that the Sensor Property ID state references

  • 1: unit is «unitless», the format type is 0x06 (uint16), and the value is represented as a percentage change with a resolution of 0.01 percent

<trigger_down>:

hexdata, no 0x.

<trigger_up>:

hexdata, no 0x.

<status_min_interval>:

minimum interval between status

  • [0, 26]

<cadence_low>:

hexdata, no 0x.

<cadence_high>:

hexdata, no 0x.

AT+BLEMESHSENSOR=sssg

Functional Description

This command is used to get sensor settings.

Command Format

AT+BLEMESHSENSOR=sssg,<dst>,<property_id>,<app_key_index>

Response Format

[APP] Sensor client receive: src 256, property id 1, ids: 1 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHSENSOR=ssg

Functional Description

This command is used to get sensor setting.

Command Format

AT+BLEMESHSENSOR=ssg,<dst>,<property_id>,<setting_property_id>,<app_key_index>

Response Format

[APP] Sensor client receive: src 256, property id 1, ids: 1 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<setting_property_id>:
  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

AT+BLEMESHSENSOR=sss

Functional Description

This command is used to set sensor setting.

Command Format

AT+BLEMESHSENSOR=sss,<dst>,<property_id>,<setting_property_id>,<app_key_index>,<ack>,<setting_raw>

Response Format

[APP] Sensor client receive: src 256, property id 1, setting property id: 1 setting access:3, setting raw: 0x1234

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<setting_property_id>:
  • [0x0001, 0xFFFF]

<app_key_index>:

application key index

<ack>:
  • 0: Dst node don’t send ack msg after receiving msg

  • 1: Dst node send ack msg after receiving msg

<setting_raw>:

hexdata,no 0x

AT+BLEMESHSENSOR=sg

Functional Description

This command is used to get sensor data.

Command Format

AT+BLEMESHSENSOR=sg,<dst>,<app_key_index>,[<property_id>]

Response Format

[APP] Sensor client receive: src 256, marshalled_sensor_data_len 7, data: 0x28000400010203

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<property_id>:

property ID

  • [0x0001, 0xFFFF]

AT+BLEMESHSENSOR=scog

Functional Description

This command is used to get sensor column.

Command Format

AT+BLEMESHSENSOR=scog,<dst>,<property_id>,<app_key_index>,<raw_value_x>

Response Format

[APP] Sensor client receive: src 256, property_id 1, column_raw_value_len: 5, column value: 0x0400010203

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<raw_value_x>:

raw value, hexdata,no 0x.

AT+BLEMESHSENSOR=sseg

Functional Description

This command is used to get sensor series.

Command Format

AT+BLEMESHSENSOR=scog,<dst>,<property_id>,<app_key_index>,<raw_value_x>

Response Format

[APP] Sensor client receive: src 256, property_id 1, column_raw_value_len: 5, column value: 0x0400010203

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<property_id>:

property ID

  • [0x0001, 0xFFFF]

<raw_value_x>:

hexdata,no 0x.

<raw_value_x>:

hexdata,no 0x.

AT+BLEMESHTIME=tg

Functional Description

This command is used to get time.

Command Format

AT+BLEMESHTIME=tg,<dst>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHTIME=tzg

Functional Description

This command is used to get time zone.

Command Format

AT+BLEMESHTIME=tzg,<dst>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHTIME=ttudg

Functional Description

This command is used to get time tai utc delta.

Command Format

AT+BLEMESHTIME=ttudg,<dst>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHTIME=trg

Functional Description

This command is used to get time role.

Command Format

AT+BLEMESHTIME=trg,<dst>,<app_key_index>

Response Format

[APP] time client receive: role 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHTIME=ts

Functional Description

This command is used to set time.

Command Format

AT+BLEMESHTIME=ts,<dst>,<app_key_index>,<tai_seconds>,<subsecond>,<uncertainty>,<time_authority>,<tai_utc_delta>,<time_zone_offset>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<tai_seconds>:

hexdata, length:5, no 0x.

<subsecond>:
  • [0, 255], in units of 1/256th second

<uncertainty>:
  • [0, 255], the estimated uncertainty in 10 millisecond steps

<time_authority>:
  • 0: No Time Authority

  • 1: Time Authority

<tai_utc_delta>:
  • [0x0000, 0x7FFF] represents [-255, 32512]

<time_zone_offset>:
  • [0x00, 0xff] represents [-64, 191]

AT+BLEMESHTIME=tzs

Functional Description

This command is used to set time zone.

Command Format

AT+BLEMESHTIME=tzs,<dst>,<app_key_index>,<time_zone_offset_new>,<tai_of_zone_change>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<time_zone_offset_new>:
  • [0x00, 0xFF]

<tai_of_zone_change>:

hexdata,no 0x.

  • [0, 0xFFFFFFFF]

AT+BLEMESHTIME=ttuds

Functional Description

This command is used to set time tai utc delta.

Command Format

AT+BLEMESHTIME=ttuds,<dst>,<app_key_index>,<tai_utc_delta_new>,<tai_of_delta_change>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<tai_utc_delta_new>:
  • [0x0000, 0x7FFF] represents [-255, 32512]

<tai_of_delta_change>:

hexdata,no 0x.

  • [0, 0xFFFFFFFF]

AT+BLEMESHTIME=trs

Functional Description

This command is used to set time role.

Command Format

AT+BLEMESHTIME=trs,<dst>,<role>,<app_key_index>

Response Format

[APP] time client receive: role 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<role>:

time role

  • 0: none

  • 1: Mesh time authority

  • 2: Mesh time relay

  • 3: Mesh time relay

<app_key_index>:

application key index

AT+BLEMESHSCENE=sg

Functional Description

This command is used to get scene.

Command Format

AT+BLEMESHSCENE=sg,<dst>,<app_key_index>

Response Format

[APP] scene client receive: src 256, status 0x0, current scene 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHSCENE=ss

Functional Description

This command is used to store scene.

Command Format

AT+BLEMESHSCENE=ss,<dst>,<scene_number>,<ack>,<app_key_index>

Response Format

[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 2, scene array: 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<scene_number>:

2 byte,0 is prohibited

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

AT+BLEMESHSCENE=sr

Functional Description

This command is used to recall scene.

Command Format

AT+BLEMESHSCENE=sr,<dst>,<scene_number>,<ack>,<app_key_index>,[<num_steps>,<resolution>,<delay>]

Response Format

[APP] scene client receive: src 256, status 0x0, current scene 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<scene_number>:

2 byte,0 is prohibited

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<delay>:

delay before state change

AT+BLEMESHSCENE=srg

Functional Description

This command is used to get registered scene.

Command Format

AT+BLEMESHSCENE=srg,<dst>,<app_key_index>

Response Format

[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 2, scene array: 0001 0002

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHSCENE=sd

Functional Description

This command is used to delete scene.

Command Format

AT+BLEMESHSCENE=sd,<dst>,<scene_number>,<ack>,<app_key_index>

Response Format

[APP] scene client receive: src 256, status 0x0, current scene 1, scene array len 1, scene array: 0001

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<scene_number>:

2 byte,0 is prohibited

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node return status after receiving msg

<app_key_index>:

application key index

AT+BLEMESHSCHEDULER=scheg

Functional Description

This command is used to get scheduler.

Command Format

AT+BLEMESHSCHEDULER=scheg,<dst>,<app_key_index>

Response Format

[APP] scheduler client receive: src 256, schedulers 0x 3ff

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHSCHEDULER=scheag

Functional Description

This command is used to get scheduler action.

Command Format

AT+BLEMESHSCHEDULER=scheag,<dst>,<index>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<index>:
  • [0x00, 0xFF]

<app_key_index>:

application key index

AT+BLEMESHSCHEDULER=scheas

Functional Description

This command is used to set scheduler action.

Command Format

AT+BLEMESHSCHEDULER=scheas,<dst>,<index>,<year>,<month>,<day>,<hour>,<minute>,<second>,<day_of_week>,<action>,<num_steps>,<resolution>,<scene_number>,<ack>,<app_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<index>:
  • [0x00, 0xFF]

<year>:
  • [0x00, 0x63]: 2 least significant digits of the year

  • 0x64: any year

<month>:
  • [0x00, 0x0b]

<day>:
  • 0x00: any day

  • [0x01, 0x1f]: day of the month

<hour>:
  • [0x00, 0x17]: hour of the day

  • 0x18: any hour of the day

  • 0x19: once a day(at a random hour)

<minute>:

minute of the hour

  • [0x00, 0x3b]: minute of the hour

  • 0x3c: any minute of the hour

  • 0x3d: every 15 seconds

  • 0x3e: every 20 seconds

  • 0x3f: once an minute(at a random second)

<second>:
  • [0x00, 0x3b]: second of the minute

  • 0x3c: any second of the minute

  • 0x3d: every 15 seconds

  • 0x3e: every 20 seconds

  • 0x3f: once an minute(at a random second)

<day_of_week>:
  • bit0-bit6 Monday to Sunday

<action>:
  • 0x0: turn off

  • 0x1: turn on

  • 0x2: scene recall

  • 0xf: no action

<num_steps>:

steps of transition

-[0x00, 0x3E]

<resolution>:
  • 0: 100 millisecond step resolution

  • 1: 1 second step resolution

  • 2: 10 seconds step resolution

  • 3: 10 minutes step resolution

<scene_number>:
  • [0x0001, 0xFFFF]: scene number

  • 0x0000: no scene

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hfg

Functional Description

This command is used to get health fault.

Command Format

AT+BLEMESHHEALTH=hfg,<dst>,<company_id>,<app_key_index>

Response Format

[APP] Health client receive: src = 256, test id = 0, company id = 0x005d, fault_array:

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<company_id>:

company ID, hexdata,2 byte,eg.0x005d

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hfc

Functional Description

This command is used to clear health fault.

Command Format

AT+BLEMESHHEALTH=hfc,<dst>,<company_id>,<ack>,<app_key_index>

Response Format

[APP] Health client receive: src = 256, test id = 0, company id = 0x005d, fault_array:

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<company_id>:

company ID, hexdata,2 byte,eg.0x005d

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hft

Functional Description

This command is used to test health fault.

Command Format

AT+BLEMESHHEALTH=hft,<dst>,<test_id>,<company_id>,<ack>,<app_key_index>

Response Format

NULL

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<company_id>:

company ID, hexdata,2 byte,eg.0x005d

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hpg

Functional Description

This command is used to get health period.

Command Format

AT+BLEMESHHEALTH=hpg,<dst>,<app_key_index>

Response Format

[APP] Health client receive: fast period divisor = 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hps

Functional Description

This command is used to set health period.

Command Format

AT+BLEMESHHEALTH=hps,<dst>,<fast_period_divisor>,<ack>,<app_key_index>

Response Format

[APP] Health client receive: fast period divisor = 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<fast_period_divisor>:
  • [0, 15]

<ack>:
  • 0: Dst node don’t return status after receiving msg

  • 1: Dst node send ack msg after receiving msg

<app_key_index>:

application key index

AT+BLEMESHHEALTH=hag

Functional Description

This command is used to get current attention timer.

Command Format

AT+BLEMESHHEALTH=hag,<dst>,<app_key_index>

Response Format

[APP] Health client receive: attention = 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHHEALTH=has

Functional Description

This command is used to set health attention timer.

Command Format

AT+BLEMESHHEALTH=has,<dst>,<attention_timer>,<ack>,<app_key_index>

Response Format

[APP] Health client receive: attention = 10

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<attention_timer>:
  • 0x00: off

  • [0x01, 0xFF]: on, remaining time in seconds

<app_key_index>:

application key index

AT+BLEMESHRMT=scan_start

Functional Description

This command is used to set remote prov server start scan UDB.

Command Format

AT+BLEMESHRMT=scan_start,<dst>,<net_key_index>,<scanned_items_limit>,<scan_timeout>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<scanned_items_limit>:

scan limit

<scan_timeout>:

scan timeout

AT+BLEMESHRMT=scan_capa_get

Functional Description

This command is used to get scan capability of remote prov server.

Command Format

AT+BLEMESHRMT=scan_capa_get,<dst>,<net_key_index>

Response Format

[APP] Remote prov scan capability status: src 0x100, max scan items 10, support active scan 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHRMT=dev_key_refresh

Functional Description

This command is used to start device key refresh procedure.

Command Format

AT+BLEMESHRMT=dev_key_refresh{,<attn_dur>}

Response Format

[APP] Refresh device key!

Parameters

<attn_dur>:

attention duration

AT+BLEMESHRMT=addr_refresh

Functional Description

This command is used to start node addr refresh procedure.

Command Format

AT+BLEMESHRMT=addr_refresh,node_addr{,<attn_dur>}

Response Format

[APP] Refresh node address to 0x105!

Parameters

<attn_dur>:

attention duration

AT+BLEMESHRMT=compo_refresh

Functional Description

This command is used to start compo refresh procedure.

Command Format

AT+BLEMESHRMT=compo_refresh{,<attn_dur>}

Response Format

[APP] Refresh node composition data!

Parameters

<attn_dur>:

attention duration

AT+BLEMESHDF=dfpdis

Functional Description

This command is used to init path discovery procedure to establish df path.

Command Format

AT+BLEMESHDF=dfpdis,<master_key_index>,<target_addr>,<dependent_addr>,<dependent_element_num>

Response Format

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

Parameters

<master_key_index>:

master key index

<target_addr>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<dependent_addr>:

dependent node address, hexdata,2 bytes,eg.0x100

<dependent_element_num>:

element number in dependent node

AT+BLEMESHDF=dfpsol

Functional Description

This command is used to init path solicitation procedure to solicit the discovery of paths toward related addresses.

Command Format

AT+BLEMESHDF=dfpsol,<master_key_index>,<addr_num>,[<addr1>,…]

Response Format

NULL

Parameters

<master_key_index>:

master key index

<addr_num>:

address number

<addr1>:

hexdata,2 bytes,eg.0x100,0xc001

AT+BLEMESHDF=dfpdupt

Functional Description

This command is used to init path dependents update procedure to update related dependent addr.

Command Format

AT+BLEMESHDF=dfpdupt,<type>,<end_point_addr>,<dependent_addr>,<dependent_element_num>

Response Format

NULL

Parameters

<type>:
  • 0: remove

  • 1: add

<end_point_addr>:

end point node address, hexdata,2 byte, e.g. 0x0100

<dependent_addr>:

dependent node address, hexdata,2 bytes,eg.0x101

<dependent_element_num>:

element number in dependent node

AT+BLEMESHDF=mdu

Functional Description

This command is used to set related model whether use df to send msg or not.

Command Format

AT+BLEMESHDF=mdu,<element_index>,<model_id>,<policy_state>

Response Format

NULL

Parameters

<element_index>:

element index

<model_id>:

model ID, e.g. 0x1000ffff

<policy_state>:
  • 0: use default policy to send msg

  • 1: use df to send msg

AT+BLEMESHDF=dcss

Functional Description

This command is used to set its own directed control state parameter.

Command Format

AT+BLEMESHDF=dcss,<master_key_index>,<directed_forwarding>,<directed_relay>,<directed_proxy>,<directed_proxy_use_directed_default>,<directed_friend>

Response Format

NULL

Parameters

<master_key_index>:

master key index

<directed_forwarding>:
  • 0: disable

  • 1: enable

<directed_relay>:
  • 0: disable

  • 1: enable

<directed_proxy>:
  • 0: disable

  • 1: enable

<directed_proxy_use_directed_default>:
  • 0: disable

  • 1: enable

  • 0xFF: do not process

<directed_friend>:
  • 0: disable

  • 1: enable

  • 0xFF: do not process

AT+BLEMESHDF=dcg

Functional Description

This command is used to get directed control state.

Command Format

AT+BLEMESHDF=dcg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive directed control status: status 0, net_key_index 0x0000, ctl 1-1-1-1-1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=dcs

Functional Description

This command is used to set directed control state.

Command Format

AT+BLEMESHDF=dcs,<dst>,<net_key_index>,<net_key_index_df>,<directed_forwarding>,<directed_relay>,<directed_proxy>,<directed_proxy_use_directed_default>,<directed_friend>

Response Format

[APP] receive directed control status: status 0, net_key_index 0x0000, ctl 1-1-1-1-1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<directed_forwarding>:
  • 0: disable

  • 1: enable

<directed_relay>:
  • 0: disable

  • 1: enable

<directed_proxy>:
  • 0: disable

  • 1: enable

<directed_proxy_use_directed_default>:
  • 0: disable

  • 1: enable

  • 0xFF: do not process

<directed_friend>:
  • 0: disable

  • 1: enable

  • 0xFF: do not process

AT+BLEMESHDF=pmg

Functional Description

This command is used to get path metric state.

Command Format

AT+BLEMESHDF=pmg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive path metric status: status 0, net_key_index 0x0000, metric 0-2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=pms

Functional Description

This command is used to set path metric state.

Command Format

AT+BLEMESHDF=pms,<dst>,<net_key_index>,<net_key_index_df>,<metric_type>,<lifetime>

Response Format

[APP] receive path metric status: status 0, net_key_index 0x0000, metric 0-0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<metric_type>:
  • 0: node count

  • [1, 7]: RFU

<lifetime>:
  • 0: 12 minutes

  • 1: 2 hours

  • 2: 24 hours

  • 3: 10 days

AT+BLEMESHDF=dtcg

Functional Description

This command is used to get discovery table capabilities state.

Command Format

AT+BLEMESHDF=dtcg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive discovery table capabilities status: status 0, net_key_index 0x0000, capabilities 2-3

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=dtcs

Functional Description

This command is used to set discovery table capabilities state.

Command Format

AT+BLEMESHDF=dtcs,<dst>,<net_key_index>,<net_key_index_df>,<max_concurrent_init>

Response Format

[APP] receive discovery table capabilities status: status 0, net_key_index 0x0000, capabilities 3-3

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<max_concurrent_init>:

cannot be 0

AT+BLEMESHDF=fta

Functional Description

This command is used to add forwarding table entry.

Command Format

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>

Response Format

[APP] receive forwarding table status: status 0, net_key_index 0x0000, path_origin 0x0110, dst 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<unicast_dst_flag>:
  • 0: dst in forwarding table is not unicast address

  • 1: dst in forwarding table is unicast address

<backward_path_valid>:
  • 0: backward path is not validated (if unicast_dst_flag is 0,this is also 0)

  • 1: backward path is validated

<origin_addr>:

origin device address, hexdata,2 bytes,eg.0x100

<origin_element_num>:

origin element number

<target_addr>:

target device address, hexdata, 2 bytes, e.g.0x100

<target_element_num>:

target element number

<bearer_toward_origin>:

data bearer type or interface number towards the source address

<bearer_toward_target>:

Data bearer type or interface number towards the target address

AT+BLEMESHDF=ftd

Functional Description

This command is used to delete forwarding table entry.

Command Format

AT+BLEMESHDF=ftd,<dst>,<net_key_index>,<net_key_index_df>,<path_origin>,<path_target>

Response Format

[APP] receive forwarding table status: status 0, net_key_index 0x0000, path_origin 0x0110, dst 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<path_origin>:

hexdata,2 bytes,eg.0x100

<path_target>:

hexdata,2 bytes,eg.0x100

AT+BLEMESHDF=ftda

Functional Description

This command is used to add forwarding table dependent node.

Command Format

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>,…]

Response Format

[APP] receive forwarding table dependents status: status 18, net_key_index 0x0000, path_origin 0x0110, dst 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<path_origin>:

hexdata,2 bytes,eg.0x100

<path_target>:

hexdata,2 bytes,eg.0x100

<dependent_origin_list_size>:

dependent origin list size

<dependent_target_list_size>:

dependent target list size

<do_addr1>:

hexdata,2 bytes,eg.0x100

<do_addr1_element_num>:

related element number

<dt_addr1>:

hexdata,2 bytes,eg.0x100

<dt_addr1_element_num>:

related element number

AT+BLEMESHDF=ftdd

Functional Description

This command is used to delete forwarding table dependent node.

Command Format

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> ,…]

Response Format

[APP] receive forwarding table dependents status: status 18, net_key_index 0x0000, path_origin 0x0110, dst 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<path_origin>:

hexdata,2 bytes,eg.0x100

<path_target>:

hexdata,2 bytes,eg.0x100

<dependent_origin_list_size>:

dependent origin list size

<dependent_target_list_size>:

dependent target list size

<do_addr1>:

hexdata,2 bytes, e.g. 0x100

<dt_addr1>:

hexdata,2 bytes, e.g. 0x100

AT+BLEMESHDF=ftdg

Functional Description

This command is used to get forwarding table dependent node.

Command Format

AT+BLEMESHDF=ftdg,<dst>,<net_key_index>,<net_key_index_df>,<list_mask>,<fixed_path_flag>,<start_index>,<path_origin>,<path_target>,[<update_id>]

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<list_mask>:
  • Bit0: Return list of unicast address ranges of dependent nodes of the Path Origin

  • Bit1: Return list of unicast address ranges of dependent nodes of the Path Target

  • 0: Indicated by the Dependents_List_Mask bit list of unicast address ranges not being returned

  • 1: Indicated by the Dependents_List_Mask bit list of unicast address ranges being returned

<fixed_path_flag>:
  • 0: Return the unicast address ranges of dependent nodes in a non-fixed path entry

  • 1: Return the unicast address ranges of dependent nodes in a fixed path entry

<start_index>:

Paging start index, indicating from which dependent node to begin returning results

<path_origin>:

Specify the source address of the forwarding table entry to query

<path_target>:

Specify the target address of the forwarding table entry to query

<update_id>:

update ID

AT+BLEMESHDF=ftecg

Functional Description

This command is used to get forwarding table entries count.

Command Format

AT+BLEMESHDF=ftecg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=fteg

Functional Description

This command is used to get forwarding table entries.

Command Format

AT+BLEMESHDF=fteg,<dst>,<net_key_index>,<net_key_index_df>,<filter_mask>,<start_index>,[<path_origin>,<path_target>,<update_id>]

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<filter_mask>:
  • Bit0: fixed path

  • Bit1: non-fixed path

  • Bit2: path origin match

  • Bit3: path target match

<path_origin>:

hexdata,2 bytes,eg.0x100

<path_target>:

hexdata,2 bytes,eg.0x100

<update_id>:

update ID

AT+BLEMESHDF=wlg

Functional Description

This command is used to get wanted lanes.

Command Format

AT+BLEMESHDF=wlg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=wls

Functional Description

This command is used to set wanted lanes.

Command Format

AT+BLEMESHDF=wls,<dst>,<net_key_index>,<net_key_index_df>,<wanted_lanes>

Response Format

[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 2

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<wanted_lanes>:

0 is prohibited

AT+BLEMESHDF=twpg

Functional Description

This command is used to get two way path state.

Command Format

AT+BLEMESHDF=twpg,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive two way path status: status 0, net_key_index 0x0000, two way path 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=twps

Functional Description

This command is used to set two way path state.

Command Format

AT+BLEMESHDF=twps,<dst>,<net_key_index>,<net_key_index_df>,<two_way_path>

Response Format

[APP] receive two way path status: status 0, net_key_index 0x0000, two way path 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<two_way_path>:
  • 0: one-way

  • 1: two-way

AT+BLEMESHDF=peig

Functional Description

This command is used to get path echo interval.

Command Format

AT+BLEMESHDF=peig,<dst>,<net_key_index>,<net_key_index_df>

Response Format

[APP] receive path echo interval status: status 4, net_key_index 0x0001, unicast echo interval 0, multicast echo interval 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

AT+BLEMESHDF=peis

Functional Description

This command is used to set path echo interval.

Command Format

[APP] receive path echo interval status: status 0, net_key_index 0x0000, unicast echo interval 20, multicast echo interval 20

Response Format

[APP] receive wanted lanes status: status 0, net_key_index 0x0000, wanted lanes 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index_df>:

this net key index mean which subnet the state belongs to

<unicast_echo_interval>:

integer num, 0 means not executed

  • [0, 100]

<multicast_echo_interval>:

integer num, 0 means not executed

  • [0, 100]

AT+BLEMESHDF=dntg

Functional Description

This command is used to get directed forwarding network transmit parameter.

Command Format

AT+BLEMESHDF=dntg,<dst>,<net_key_index>

Response Format

[APP] receive directed network transmit status: count 6, steps 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=dnts

Functional Description

This command is used to set directed forwarding network transmit parameter.

Command Format

AT+BLEMESHDF=dnts,<dst>,<net_key_index>,<count>,<steps>

Response Format

[APP] receive directed network transmit status: count 1, steps 9

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<count>:
  • [0, 7]

<steps>:
  • [0, 31]

AT+BLEMESHDF=drrg

Functional Description

This command is used to get directed forwarding relay retransmit parameter.

Command Format

AT+BLEMESHDF=drrg,<dst>,<net_key_index>

Response Format

[APP] receive directed relay retransmit status: count 2, steps 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=drrs

Functional Description

This command is used to set directed forwarding relay retransmit parameter.

Command Format

AT+BLEMESHDF=drrs,<dst>,<net_key_index>,<count>,<steps>

Response Format

[APP] receive directed relay retransmit status: count 1, steps 9

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<count>:
  • [0, 7]

<steps>:
  • [0, 31]

AT+BLEMESHDF=rssitg

Functional Description

This command is used to get rssi threshold state.

Command Format

AT+BLEMESHDF=rssitg,<dst>,<net_key_index>

Response Format

[APP] receive rssi threshold status: default_rssi_threshold -80, rssi_margin 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=rssits

Functional Description

This command is used to set rssi threshold state.

Command Format

AT+BLEMESHDF=rssits,<dst>,<net_key_index>,<rssi_margin>

Response Format

[APP] receive rssi threshold status: default_rssi_threshold -80, rssi_margin 30

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<rssi_margin>:

RSSI

  • [0, 50]

AT+BLEMESHDF=dpg

Functional Description

This command is used to get directed path state.

Command Format

AT+BLEMESHDF=dpg,<dst>,<net_key_index>

Response Format

[APP] receive directed paths status: directed_node_paths 20, directed_relay_paths 20, directed_proxy_paths 20, directed_friend_paths 20

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=dppg

Functional Description

This command is used to get directed publish policy state.

Command Format

AT+BLEMESHDF=dppg,<dst>,<net_key_index>,<element_addr>,<model_id>

Response Format

[APP] receive directed publish policy status: status 0, policy 0, elem_addr 0x0100, model id 0x1000ffff

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<element_addr>:

element address

<model_id>:

model ID

AT+BLEMESHDF=dpps

Functional Description

This command is used to set directed publish policy state.

Command Format

AT+BLEMESHDF=dpps,<dst>,<net_key_index>,<policy>,<element_addr>,<model_id>

Response Format

[APP] receive directed publish policy status: status 0, policy 1, elem_addr 0x0100, model id 0x1000ffff

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<policy>:
  • 0: managed flooding

  • 1: directed forwarding

<element_addr>:

element address, hexdata,2 byte, e.g. 0x0100

<model_id>:

model ID

AT+BLEMESHDF=pdtcg

Functional Description

This command is used to get discovery timing control state.

Command Format

AT+BLEMESHDF=pdtcg,<dst>,<net_key_index>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=pdtcs

Functional Description

This command is used to set discovery timing control state.

Command Format

AT+BLEMESHDF= pdtcs,<dst>,<net_key_index>,<monitor_interval>,<discovery_retry_interval>,<discovery_interval>,<lane_discovery_guard_interval>

Response Format

[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

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<monitor_interval>:

monitor interval

<discovery_retry_interval>:

discovery retry interval

<discovery_interval>:

discovery interval

  • 0: 5s

  • 1: 30s

<lane_discovery_guard_interval>:
  • 0: 2s

  • 1: 10s

AT+BLEMESHDF=dcntg

Functional Description

This command is used to get directed control network transmit parameter.

Command Format

AT+BLEMESHDF=dcntg,<dst>,<net_key_index>

Response Format

[APP] receive directed control network transmit status: count 6, steps 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=dcnts

Functional Description

This command is used to set directed control network transmit parameter.

Command Format

AT+BLEMESHDF=dcnts,<dst>,<net_key_index>,<count>,<steps>

Response Format

[APP] receive directed control network transmit status: count 1, steps 9

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<count>:
  • [0, 7]

<steps>:
  • [0, 31]

AT+BLEMESHDF=dcrrg

Functional Description

This command is used to get directed control relay retransmit parameter.

Command Format

AT+BLEMESHDF=dcrrg,<dst>,<net_key_index>

Response Format

[APP] receive directed control relay retransmit status: count 2, steps 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHDF=dcrrs

Functional Description

This command is used to set directed control relay retransmit parameter.

Command Format

AT+BLEMESHDF=dcrrs,<dst>,<net_key_index>,<count>,<steps>

Response Format

[APP] receive directed control relay retransmit status: count 1, steps 9

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<count>:
  • [0, 7]

<steps>:
  • [0, 31]

AT+BLEMESHSBR=sbg

Functional Description

This command is used to get subnet bridge state.

Command Format

AT+BLEMESHSBR=sbg,<dst>,<net_key_index>

Response Format

[APP] Subnet bridge status: state 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHSBR=sbs

Functional Description

This command is used to set subnet bridge state.

Command Format

AT+BLEMESHSBR=sbs,<dst>,<net_key_index>,<state>

Response Format

[APP] Subnet bridge status: state 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<state>:
  • 0: disable

  • 1: enable

AT+BLEMESHSBR=bta

Functional Description

This command is used to add bridging table.

Command Format

AT+BLEMESHSBR=bta,<dst>,<net_key_index>,<direction>,<net_key_index1>,<net_key_index2>,<addr1>,<addr2>

Response Format

[APP] Bridging table status: status 4, directions 1, net_key_index1 0x0001, net_key_index2 0x0002, addr1 0x0110, addr2 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<direction>:
  • 0: prohibited

  • 1: briding is allowed for messages from addr1 to addr2

  • 2: briding is allowed for two-way

<net_key_index1>:

source subnet network key index

<net_key_index2>:

destination subnet network key index

<addr1>:

the bridging source address

<addr2>:

the bridging destination address

AT+BLEMESHSBR=btr

Functional Description

This command is used to remove bridging table.

Command Format

AT+BLEMESHSBR=btr,<dst>,<net_key_index>,<net_key_index1>,<net_key_index2>,<addr1>,<addr2>

Response Format

[APP] Bridging table status: status 4, directions 0, net_key_index1 0x0001, net_key_index2 0x0002, addr1 0x0110, addr2 0x0120

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index1>:

source subnet network key index

<net_key_index2>:

destination subnet network key index

<addr1>:

the bridging source address

<addr2>:

the bridging destination address

AT+BLEMESHSBR=bsg

Functional Description

This command is used to get bridged subnets.

Command Format

AT+BLEMESHSBR=bsg,<dst>,<net_key_index>,<filter>,<filter_net_key_index>,<start_index>

Response Format

[APP] Bridged subnets list: filter 1, net_key_index 0x0001, start_index 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<filter>:
  • 0: report all pairs of Netket indexes

  • 1: report the first subnet matches

  • 2: report the second subnet matches

  • 3: report one of the subnets matches

<filter_net_key_index>:

this net key index mean the subnet used for filter

<start_index>:

start index of the result

AT+BLEMESHSBR=btbg

Functional Description

This command is used to get bridging table.

Command Format

AT+BLEMESHSBR=btbg,<dst>,<net_key_index>,<net_key_index1>,<net_key_index2>,<start_index>

Response Format

[APP] Bridging_table_list: status 4, net_key_index1 0x0001, net_key_index2 0x0002, start_index 0, bridged_addrs_list

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<net_key_index1>:

source subnet network key index

<net_key_index2>:

destination subnet network key index

<start_index>:

start index of the result

AT+BLEMESHSBR=btsg

Functional Description

This command is used to get bridging table size.

Command Format

AT+BLEMESHSBR=btsg,<dst>,<net_key_index>

Response Format

[APP] Bridging table size status: table size 5

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHPRB=prbg

Functional Description

This command is used to get private beacon state.

Command Format

AT+BLEMESHPRB=prbg,<dst>,<net_key_index>

Response Format

Private beacon client receive: private beacon 0, random update interval steps 60

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHPRB=prbs

Functional Description

This command is used to set private beacon state.

Command Format

AT+BLEMESHPRB=prbs,<dst>,<net_key_index>,<private_beacon>[,<random_update_interval_steps>]

Response Format

Private beacon client receive: private beacon 1, random update interval steps 60

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<private_beacon>:
  • 0: disable

  • 1: enable

<random_update_interval_steps>:
  • 0: Random field is updated for every Mesh Private beacon

  • [1, 255]: Random field is updated at an interval (in seconds) of (10 * Random Update Interval Steps)

AT+BLEMESHPRB=pgpg

Functional Description

This command is used to get private gatt proxy state.

Command Format

AT+BLEMESHPRB=pgpg,<dst>,<net_key_index>

Response Format

Private beacon client receive: private gatt proxy 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

AT+BLEMESHPRB=pgps

Functional Description

This command is used to set private gatt proxy state.

Command Format

AT+BLEMESHPRB=pgps,<dst>,<net_key_index>,<private_gatt_proxy>

Response Format

Private beacon client receive: private gatt proxy 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<private_gatt_proxy>:
  • 0: disable

  • 1: enable

AT+BLEMESHPRB=pnig

Functional Description

This command is used to get private node identity state.

Command Format

AT+BLEMESHPRB=pnig,<dst>,<net_key_index>,<sub_net_key_index>

Response Format

Private beacon client receive: status 4, net_key_index 0x0001, private identity 0

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<sub_net_key_index>:

subnet network key index

AT+BLEMESHPRB=pnis

Functional Description

This command is used to set private node identity state.

Command Format

AT+BLEMESHPRB=pnis,<dst>,<net_key_index>,<sub_net_key_index>,<private_identity>

Response Format

Private beacon client receive: status 0, net_key_index 0x0000, private identity 1

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<net_key_index>:

network key index

<sub_net_key_index>:

subnet network key index

<private_identity>:
  • 0: disable

  • 1: enable

AT+BLEMESHDFU=init_upstart

Functional Description

This command is used to start dfu initiator upload.

Command Format

AT+BLEMESHDFU=init_upstart,<dst>,<app_key_index>,<update_timeout_base>,<image_size>,[<version>/<data_len>[,<data>]]

Response Format

[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.

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<update_timeout_base>:

update timeout base

<image_size>:

the image size of update image

<version>:

FW version or metadata length

<data_len>:

length of data

<data>:

Hexdata, the metadata

AT+BLEMESHDFU=init_recadd

Functional Description

This command is used to add dfu initiator receivers.

Command Format

AT+BLEMESHDFU=init_recadd,<dst>,<app_key_index>,<recv_num>,<addr>,…

Response Format

[APP] Receive Firmware Distribution Receivers Status message, status:0, list count:1.

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<recv_num>:

the number of address to be add

<addr>:

Hexdata,the address to be add

AT+BLEMESHDFU=init_recdela

Functional Description

This command is used to delete all dfu initiator receivers.

Command Format

AT+BLEMESHDFU=init_recdela,<dst>,<app_key_index>

Response Format

[APP] Receive Firmware Distribution Receivers Status message, status:0, list count:0.

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

AT+BLEMESHDFU=init_disstart

Functional Description

This command is used to start dfu initiator distribute.

Command Format

AT+BLEMESHDFU=init_disstart,<dst>,<app_key_index>,<dist_app_key_index>,<dist_ttl>,<dist_timeout_base>,<dist_multicast_addr>

Response Format

[APP] Receive Firmware Distribution Status message, status:0.

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<dist_app_key_index>:

the app key index for TX FW data message

<dist_ttl>:

the TTL for TX FW data message

<dist_timeout_base>:

the timeout base for FW data message

<dist_multicast_addr>:

the destination address for FW data message

AT+BLEMESHDFU=stand_param

Functional Description

This command is used to standalone updater set parameter.

Command Format

AT+BLEMESHDFU=stand_param,<image_size>

Response Format

NULL

Parameters

<image_size>:

FW image size

AT+BLEMESHDFU=stand_add

Functional Description

This command is used to standalone updater add receiver.

Command Format

AT+BLEMESHDFU=stand_add,<addr>

Response Format

NULL

Parameters

<addr>:

hexdata,2 byte,eg.0x0100,the destination address for FW data message

AT+BLEMESHDFU=stand_start

Functional Description

This command is used to start standalone updater.

Command Format

AT+BLEMESHDFU=stand_start,<dst>,<app_key_index>,<update_timeout_base>

Response Format

[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.

Parameters

<dst>:

destination node addr, hexdata,2 byte, e.g. 0x0100

<app_key_index>:

application key index

<update_timeout_base>:

update timeout base

LE Audio

AT+BLEBAP=escan

Functional Description

Start or stop extended scan.

Command Format

AT+BLEBAP=escan,<enable/disable>

Response Format

Start extended scan:

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)

Stop extended scan:

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

Parameters

<enable/disable>:

Start or stop extended scan

  • 0: Stop extended scan

  • 1: Start extended scan

AT+BLEBAP=client_start

Functional Description

The BAP unicast client initiates a unicast audio stream.

Command Format

AT+BLEBAP=client_start,<group_idx>,<sink_context>,<source_context>

Response Format

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

Parameters

<group_idx>:

Unicast stream group id, default 0

<sink_context>:

Default is RTK_BT_LE_AUDIO_CONTEXT_MEDIA

<source_context>:

Default is RTK_BT_LE_AUDIO_CONTEXT_MEDIA

AT+BLEBAP=client_stop

Functional Description

This command is used for BAP unicast client to stop unicast audio stream.

Command Format

AT+BLEBAP=client_stop,<group_idx>,<time_out>

Response Format

BAP client stop successfully

Parameters

<group_idx>:

Unicast stream group id, default 0

<time_out>:

CIS timeout (milliseconds)

AT+BLEBAP=client_release

Functional Description

This command is used to release session.

Command Format

AT+BLEBAP=client_release,<group_idx>

Response Format

BAP client release successfully

Parameters

<group_idx>:

Unicast stream group id

AT+BLEBAP=broadcast_start

Functional Description

This command is used for BLE Audio BAP Broadcast Source to start the broadcast audio stream.

Command Format

AT+BLEBAP=broadcast_start

Response Format

[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

Parameters

NULL

AT+BLEBAP=broadcast_stop

Functional Description

This command is used for BLE Audio BAP Broadcast Source to stop the broadcast audio stream.

Command Format

AT+BLEBAP=broadcast_stop

Response Format

[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

Parameters

NULL

AT+BLEBAP=pa_sync_create

Functional Description

This command is used for BLE Audio BAP Broadcast Sink to create pa sync with broadcast source.

Command Format

AT+BLEBAP=pa_sync_create,<bd_addr_type>,<bd_addr>,<adv_sid>,<broadcast_id>

Response Format

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

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

<adv_sid>:

ID used to identify the broadcast set

<broadcast_id>:

Data that can be used by scanning device to help find broadcast audio stream. Three consecutive 8-bit bytes without 0x, e.g. 8c,1e,23

AT+BLEBAP=pa_sync_remove

Functional Description

This command is used for BLE Audio BAP Broadcast Sink to terminate sync with broadcast audio stream.

Command Format

AT+BLEBAP=pa_sync_remove,<bd_addr type>,<bd_addr>

Response Format

[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

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

AT+BLEBAP=big_sync_create

Functional Description

This command is used for BLE Audio BAP Broadcast Sink to create big sync with broadcast source.

Command Format

AT+BLEBAP=big_sync_create,<bd_addr type>,<bd_addr>

Response Format

[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

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

AT+BLEBAP=big_sync_remove

Functional Description

This command is used for BLE Audio BAP Broadcast Sink to terminate big sync with broadcast audio stream.

Command Format

AT+BLEBAP=big_sync_remove,<bd_addr type>,<bd_addr>

Response Format

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)

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

AT+BLEBAP=remote_scan

Functional Description

This command is used to start remote scan.

Command Format

AT+BLEBAP=remote_scan,<op>,<group_idx>

Response Format

Start remote scan:

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)

Stop remote scan:

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

Parameters

<op>:

Start or stop remote scan

  • 0: Stop remote scan

  • 1: Start remote scan

<group_idx>:

Group idx of BAP Scan delegator group

AT+BLEBAP=reception_start

Functional Description

This command is used for BLE Audio BAP Broadcast Assistant start reception broadcast stream syn info to BAP Scan delegator.

Command Format

AT+BLEBAP=reception_start,<bd_addr_type>,<bd_addr>,<group_idx>

Response Format

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

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

<group_idx>:

Group idx of BAP Scan delegator group, default 0.

AT+BLEBAP=reception_stop

Functional Description

This command is used for BLE Audio BAP Broadcast Assistant stop reception broadcast stream syn info to BAP Scan delegator.

Command Format

AT+BLEBAP=reception_stop,<bd_addr_type>,<bd_addr>,<group_idx>

Response Format

bt_stack_le_audio_broadcast_assistant_reception_stop: bass modify source for sync_handle 605c0c00 ok
Broadcast assistant reception stop successfully

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

<group_idx>:

Group idx of BAP Scan delegator group, default 0.

AT+BLEBAP=reception_remove

Functional Description

This command is used for BLE Audio BAP Broadcast Assistant remove broadcast stream syn info in BAP Scan delegator.

Command Format

AT+BLEBAP=reception_stop,<bd_addr_type>,<bd_addr>,<group_idx>

Response Format

bt_stack_le_audio_broadcast_assistant_reception_remove: bass remove source for sync_handle 605c0c00 ok
Broadcast assistant reception remove successfully

Parameters

<bd_addr_type>:

Address type

  • 0: Public Device Address

  • 1: Random Device Address

  • 2: Public Identity Address

  • 3: Random (Static) Identity Address

<bd_addr>:

Hexadecimal format data without 0x, e.g. 00e04c0a30d1

<group_idx>:

Group idx of BAP Scan delegator group, default 0.

AT+BLECAP=commander,vcp,gmute

Functional Description

This command is used for VCS client to change volume mute state in VCS server by group

Command Format

AT+BLECAP=commander,vcp,gmute,<group_id>,<mute_state>

Response Format

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

Parameters

<mute_state>:

Mute state for VCS server:

  • 0: not mute

  • 1: mute

<group_id>:

Group idx of VCS server, default 0.

AT+BLECAP=commander,vcp,gvolume

Functional Description

This command is used for VCS client to set change volume in VCS server by group.

Command Format

AT+BLECAP=commander,vcp,gvolume,<group_id>,<volume_setting>

Response Format

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

Parameters

<group_id>:

Group idx of VCS server, default 0.

<volume_setting>:

volume_setting is 0~255

  • [0, 255]

AT+BLECAP=commander,vcp,get

Functional Description

This command is used for VCS client to get current volume state of VCS server.

Command Format

AT+BLECAP=commander,vcp,get,<conn_handle>

Response Format

vcp client get successfully
volume setting 64, mute 0, change_counter 3

Parameters

<conn_handle>:

Peer device connection handle

AT+BLECAP=acceptor,vcp,get

Functional Description

This command is used for VCS server to get current volume state

Command Format

AT+BLECAP=acceptor,vcp,get

Response Format

vcp server get successfully

Parameters

NULL

AT+BLECAP=commander,vcp,write

Functional Description

This command is used for VCS client to change relative volume state of VCS server.

Command Format

AT+BLECAP=commander,vcp,write,<conn_handle>,<opcode>[,<volume_setting>]

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<opcode>:
  • 0: Change relative volume down

  • 1: Change relative volume up

  • 2: Unmute/Relative volume down

  • 3: Unmute/Relative volume Up

  • 4: Set absolute volume

  • 5: Set unmute

  • 6: Set unmute

<volume_setting>:

Optional parameter is only included when opcode is 4

  • [0, 255]

AT+BLECAP=commander,micp,gmute

Functional Description

This command is used for MICS client to change MICS server mute state by group.

Command Format

AT+BLECAP=commander,micp,gmute,<group_idx>,<mic_mute>

Response Format

micp client gmute successfully

Parameters

<group_idx>:

integer num, default is 0.

<mic_mute>:

Mute state for MICS server:

  • 0: not mute

  • 1: mute

AT+BLECAP=commander,micp,set_mute

Functional Description

This command is used for MICS client to change MICS server mute state by connection.

Command Format

AT+BLECAP=commander,micp,set_mute,<conn_handle>,<mic_mute>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle.

<mic_mute>:

Mute state for MICS server:

  • 0: not mute

  • 1: mute

AT+BLECAP=commander,micp,get_mute

Functional Description

This command is used for MICS client to get MICS server mute state by connection.

Command Format

AT+BLECAP=commander,micp,get_mute,<conn_handle>

Response Format

bt_stack_le_audio_mics_get_mute_value conn_handle=16 mic_mute=1
micp client get mute successfully

Parameters

<conn_handle>:

Peer device connection handle.

AT+BLECAP=acceptor,micp,get

Functional Description

This command is used for MICS server to get current mute state.

Command Format

AT+BLECAP=commander,micp,get

Response Format

micp server get successfully

Parameters

NULL

AT+BLECAP=commander,vocs,get_char

Functional Description

This command is used for VOCS client to get VOCS server characteristic value by connection.

Command Format

AT+BLECAP=commander,vocs,get_char,<conn_handle>,<srv_instance_id>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<srv_instance_id>:

Service instance id on VOCS server

AT+BLECAP=commander,vocs,get_srv

Functional Description

This command is used for VOCS client to get VOCS server service data by connection.

Command Format

AT+BLECAP=commander,vocs,get_srv,<conn_handle>,<srv_instance_id>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<srv_instance_id>:

Service instance id on VOCS server

AT+BLECAP=commander,vocs,write

Functional Description

This command is used for VOCS client write opcode to set volume offset on VOCS server.

Command Format

AT+BLECAP=commander,vocs,write,<conn_handle>,<srv_instance_id>,<cp_op>,<volume_offset>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<srv_instance_id>:

Service instance id on VOCS server

<cp_op>:

Opcode

  • 1: set volume offset

<volume_offset>:

Volume offset

  • [-255, 255]

AT+BLECAP=commander,vocs,gwrite

Functional Description

This command is used for VOCS client write opcode to set volume offset on VOCS server by group.

Command Format

AT+BLECAP=commander,vocs,gwrite,<group_index>,<srv_instance_id>,<cp_op>,<volume_offset>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<srv_instance_id>:

Service instance id on VOCS server

<cp_op>:

Opcode

  • 1: set volume offset

<volume_offset>:

Volume offset

  • [-255, 255]

AT+BLECAP=commander,vocs,wdes

Functional Description

This command is used for VOCS client to write output description on VOCS server.

Command Format

AT+BLECAP=commander,vocs,wdes,<conn_handle>,<srv_instance_id>,<des_str>

Response Format

vocs client wdes successfully
[APP] RTK_BT_LE_AUDIO_EVT_VOCS_CLIENT_NOTIFY_IND: conn_handle 0x10, srv_instance_id 0, type=2

Parameters

<conn_handle>:

Peer device connection handle.

<srv_instance_id>:

Service instance id on VOCS server.

<des_str>:

Output description string.

AT+BLECAP=commander,aics,get_char

Functional Description

This command is used for AICS client to get AICS server characteristic value by connection.

Command Format

AT+BLECAP=commander,aics,get_char,<conn_handle>,<srv instance id>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle.

<srv_instance_id>:

Service instance id on AICS server.

AT+BLECAP=commander,aics,get_srv

Functional Description

This command is used for AICS client to get AICS server service data by connection.

Command Format

AT+BLECAP=commander,aics,get_srv,<conn_handle>,<srv instance id>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<srv_instance_id>:

Service instance id on AICS server

AT+BLECAP=commander,aics,write

Functional Description

This command is used for AICS client to write opcode to change audio input state on AICS server.

Command Format

AT+BLECAP=commander,aics,write,<conn_handle>,<srv_instance_id>,<cp_op>,[<gaining_setting>]

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle.

<srv_instance_id>:

Service instance id on AICS server.

<cp_op>:

Opcode

  • 1: set gain setting

  • 2: set unmute

  • 3: set mute

  • 4: set manual gain mode

  • 5: set automatic gain mode

<gaining_setting>:

Only used when cp_op is 1.

  • [-255, 255]

AT+BLECAP=acceptor,aics,get

Functional Description

This command is used for AICS server to get current audio input state.

Command Format

AT+BLECAP=acceptor,aics,get,<srv_instance_id>,<param_type>

Response Format

aics param: srv_instance_id 0, gain_setting 20, mute 0, gain_mode 2,change_counter 1
aics server get successfully

Parameters

<srv_instance_id>:

Service instance id on AICS server

<param_type>:

Parameters type

  • 1: input state

  • 2: gain setting prop

  • 3: input type

  • 4: input state

  • 5: input des

AT+BLECAP=commander,aics,gwrite

Functional Description

This command is used for AICS client to write opcode to change audio input state on AICS server by group.

Command Format

AT+BLECAP=commander,aics,gwrite,<group_idx>,<srv_instance_id>,<cp_op>,[<gaining_setting>]

Response Format

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

Parameters

<group_idx>:

Peer device group index, default 0.

<srv_instance_id>:

Service instance id on AICS server.

<cp_op>:

Opcode

  • 1: set gain setting

  • 2: set unmute

  • 3: set mute

  • 4: set manual gain mode

  • 5: set automatic gain mode

<gaining_setting>:

Only used when cp_op is 1.

  • [-255, 255]

AT+BLECAP=initiator,mcp,send

Functional Description

This command is used for MICS server to send state to MICS client.

Command Format

AT+BLECAP=initiator,mcp,send,<uuid>,[<value>]

Response Format

mcp media send successfully

Parameters

<uuid>:
  • 0x2B93: send media player name

  • 0x2B97: send track title

  • 0x2B98: send track duration

  • 0x2B99: send track position

  • 0x2B96: send track changed

<value>:

Optional parameter, only used when uuid is 0x2B98 and 0x2B99

AT+BLECAP=acceptor,mcp,dis

Functional Description

This command is used for MICS client to start GATTC discovery with MICS server.

Command Format

AT+BLECAP=acceptor,mcp,dis,<conn_handle>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

AT+BLECAP=acceptor,mcp,read

Functional Description

This command is used for MICS client to read characteristic from MICS server.

Command Format

AT+BLECAP=acceptor,mcp,read,<conn_handle>,<char_uuid>

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<char_uuid>:

Characteristic uuid.

  • 0x2B93: media player name

  • 0x2B97: track title

  • 0x2B98: track duration

  • 0x2B99: track position

  • 0x2BA3: media state

  • 0x2BBA: content control id

AT+BLECAP=acceptor,mcp,write

Functional Description

This command is used for MICS client to write opcode to MICS server.

Command Format

AT+BLECAP=acceptor,mcp,write,<conn_handle>,<opcode>[,<op_param>]

Response Format

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

Parameters

<conn_handle>:

Peer device connection handle

<opcode>:
  • 0x1: PLAY

  • 0x2: PAUSE

  • 0x3: FAST_REWIND

  • 0x4: FAST_FORWARD

  • 0x5: STOP

  • 0x10: MOVE_RELATIVE

  • 0x24: GOTO_SEGMENT

  • 0x30: PREVIOUS_TRACK

  • 0x31: NEXT_TRACK

  • 0x32: FIRST_TRACK

  • 0x33: LAST_TRACK

  • 0x34: GOTO_TRACK

  • 0x44: GOTO_GROUP

  • 0xff: enable or disable CCCD

<op_param>:

Optional parameters, and only used when opcode is 0x10, 0x24, 0x34, 0x44, and 0xff.

  • <opcode> is 0x10, op_param value is integar number and means <offset>

  • <opcode> is 0x24, op_param is integar number and means <segment number>

  • <opcode> is 0x34, op_param is integar number and means <track number>

  • <opcode> is 0x44, op_param is integar number and means <group number>

  • <opcode> is 0xff, op_param is integar 0~1, and means enbale or disable CCCD

BT A2DP

AT+BTA2DP=conn

Functional Description

This command is used to initiate an A2DP connection to remote device.

Command Format

AT+BTA2DP=conn,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTA2DP=disconn

Functional Description

This command is used to terminate an existing A2DP connection.

Command Format

AT+BTA2DP=disconn,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTA2DP=start

Functional Description

This command is used to start A2DP stream sending.

Command Format

AT+BTA2DP=start,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTA2DP=suspend

Functional Description

This command is used to suspend A2DP stream sending.

Command Format

AT+BTA2DP=suspend,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

BT AVRCP

AT+BTAVRCP=disconn

Functional Description

This command is used to terminate an existing AVRCP connection.

Command Format

AT+BTAVRCP=disconn,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTAVRCP=<snk_cmd>

Functional Description

This command is used by snk client to execute services operations.

Command Format

AT+BTAVRCP=<snk_cmd>,<peer_addr>{,<volume>}

Response Format

<snk_cmd> is 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> is 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> is rewind_start, peer device response:

[AVRCP]: Play req
app_avrcp_bt_cback: BT_EVENT_AVRCP_REWIND_START

<snk_cmd> is rewind_stop, peer device response:

app_avrcp_bt_cback: BT_EVENT_AVRCP_REWIND_STOP
[AVRCP]: Rewind stop req

<snk_cmd> is fast_forward_start, peer device response:

app_avrcp_bt_cback: BT_EVENT_AVRCP_FAST_FORWARD_START
[AVRCP]: Fast forward start req

<snk_cmd> is fast_forward_stop, peer device response:

app_avrcp_bt_cback: BT_EVENT_AVRCP_FAST_FORWARD_STOP
[AVRCP]: Fast forward stop req

<snk_cmd> is forward, peer device response:

app_avrcp_bt_cback: BT_EVENT_AVRCP_FORWARD
[AVRCP]: Forward req

<snk_cmd> is backward, peer device response:

app_avrcp_bt_cback: BT_EVENT_AVRCP_BACKWARD
[AVRCP]: Backward req

Parameters

<snk_cmd>:

SNK client commands

  • pause: stop audio

  • play: start audio

  • volume_change_req: change the volume of audio, the param <volume> is needed

  • rewind_start: rewind the audio

  • rewind_stop: stop rewinding the audio

  • fast_forward_start: fast forward audio

  • fast_forward_stop: stop fast-forward audio

  • forward: switch to the next audio

  • backward: return to previous audio

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<volume>:

volume size

  • [0, 100]

BT HFP

AT+BTHFP=conn

Functional Description

This command is used to create hfp connection.

Command Format

AT+BTHFP=conn,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTHFP=disconn

Functional Description

This command is used to terminate an existing HFP connection.

Command Format

AT+BTHFP=disconn,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTHFP=call_income

Functional Description

This command is used to notify the incoming call.

Command Format

AT+BTHFP=call_income,<peer_addr>,<call_num>,<call_num_type>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<call_num>:

call number, max length is 20

<call_num_type>:

call number type

AT+BTHFP=call_answer

Functional Description

This command is used to answer the incoming or outgoing alerting call.

Command Format

AT+BTHFP=call_answer,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTHFP=call_terminate

Functional Description

This command is used to reject the incoming call, terminate the outgoing call, or ongoing call.

Command Format

AT+BTHFP=call_terminate,<peer_addr>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTHFP=batt_level_report

Functional Description

This command is used to send a command to report current battery level.

Command Format

AT+BTHFP=batt_level_report,<peer_addr>,<power_level>

Response Format

HFP batt level report to device 00:E0:4C:80:06:2B ...

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<power_level>:

power level

  • [0, 100]

AT+BTHFP=speaker_gain_report

Functional Description

This command is used to send a command to synchronize speaker gain level.

Command Format

AT+BTHFP=speaker_gain_report,<peer_addr>,<gain>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<gain>:

gain level

  • [0, 15]

AT+BTHFP=microphone_gain_report

Functional Description

This command is used to send a command to synchronize microphone gain level.

Command Format

AT+BTHFP=microphone_gain_report,<peer_addr>,<gain>

Response Format

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

Parameters

<peer_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<gain>:

gain level

  • [0, 15]

BT SPP

AT+BTSPP=conn

Functional Description

This command is used for SPP server to establish connection with SPP client.

Command Format

AT+BTSPP=conn,<bd_addr>

Response Format

[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

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTSPP=disconn

Functional Description

This command is used for SPP server to disconnect the specified SPP channel.

Command Format

AT+BTSPP=disconn,<bd_addr>,<channel_idx>

Response Format

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

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<channel_idx>:

channel index, e.g. 0x03

AT+BTSPP=disconn_all

Functional Description

This command is used for SPP server to disconnect with all SPP channel.

Command Format

AT+BTSPP=disconn_all,<bd_addr>

Response Format

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

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTSPP=send_data

Functional Description

This command is used for SPP server to send data to SPP client in specified SPP channel.

Command Format

AT+BTSPP=send_data,<bd_addr>,<channel_idx>,<data>

Response Format

bt_stack_spp_send_data: link credit is 5
SPP send data to device 00:E0:4C:80:06:2B ,server channel 0x3 success!

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<channel_idx>:

channel index, e.g. 0x03

<data>:

hexadecimal format data without 0x, e.g. aabbcc010203

AT+BTSPP=give_credits

Functional Description

This command is used for SPP server to give link credits to SPP client.

Command Format

AT+BTSPP=give_credits,<bd_addr>,<channel_idx>,<credits_value>

Response Format

SPP give 20 credits to device 00:E0:4C:80:06:2B ,server channel 0x3 success!

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<channel_idx>:

channel index, e.g. 0x03

<credits_value>:

credits value

BT RFCOMM

AT+BTRFC=conn

Functional Description

This command is used for RFCOMM client to establish connection with RFCOMM server.

Command Format

AT+BTRFC=conn,<bd_addr>

Response Format

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

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTRFC=disconn

Functional Description

This command is used for RFCOMM client to disconnect the the RFCOMM link.

Command Format

AT+BTRFC=disconn,<bd_addr>

Response Format

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

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

AT+BTRFC=send_data

Functional Description

This command is used for RFCOMM client to send data to RFCOMM server in specified RFCOMM channel.

Command Format

AT+BTRFC=send_data,<bd_addr>,<channel_idx>,<data>

Response Format

RFC send data to device 00:E0:4C:80:06:2B ,server channel 0x3 success!

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<channel_idx>:

channel index, e.g. 0x03

<data>:

Hexadecimal format data without 0x, e.g. aabbcc010203

AT+BTRFC=give_credits

Functional Description

This command is used for RFCOMM client to give link credits to peer RFCOMM device.

Command Format

AT+BTRFC=give_credits,<bd_addr>,<channel_idx>,<credits_value>

Response Format

RFC give 20 credits to device 00:E0:4C:80:06:2B ,server channel 0x3 success!

Parameters

<bd_addr>:

peer device, hexdata No 0x, e.g. 00e04c0a30c3

<channel_idx>:

channel index, e.g. 0x03

<credits_value>:

credits value