BT Commands
1. Function overview
In order to verify BT-related functions, a series of AT CMDs are designed. All BT AT CMDs start with
AT+, followed by specific command and parameters. If the CMD is executed successfully,CMDRSP:OKis returned. If the CMD execution fails,CMDRSP:ERRORis returned.
2. Code path
path:
\components\bk_bluetooth\api\bk_at_bt.c
3. AT command introduction
The supported CMDs are as follows:
- 1.AT+BTINQUIRY
- Function Description
Scan command, used to scan classic devices visible around
- CMD Format
AT+BTINQUIRY
- Parameter Description
no parameters
- Return Value Description
Scanned device address
- 2.AT+BTREADSCANENABLE
- Function Description
Get current device visibility
- CMD Format
AT+BTREADSCANENABLE
- Parameter Description
no parameters
- Return Value Description
Value
Parameter Description
0x00
No Scans enabled.
0x01
Inquiry Scan enabled. Page Scan disabled.
0x02
Inquiry Scan disabled. Page Scan enabled.
0x03
Inquiry Scan enabled. Page Scan enabled.
- 3.AT+BTWRITESCANENABLE
- Function Description
Set current device visibility
- CMD Format
AT+BTWRITESCANENABLE=param1
- Parameter Description
Param1
Parameter Description
0x00
No Scans enabled.
0x01
Inquiry Scan enabled. Page Scan disabled.
0x02
Inquiry Scan disabled. Page Scan enabled.
0x03
Inquiry Scan enabled. Page Scan enabled.
- 4.AT+BTCONNECT
- Function Description
Connect to specified device
- CMD Format
AT+BTCONNECT=param1,param2
- Parameter Description
Param
Parameter Description
param1
Bluetooth address
param2
- Allow_Role_Switch
- 5.AT+BTDISCONNECT
- Function Description
Disconnect the designated device
- CMD Format
AT+BTDISCONNECT=param1
- Parameter Description
Param
Parameter Description
param1
Bluetooth address
- 6.AT+BTSPPINIT
- Function Description
SPP initialization, register to SDP
- CMD Format
AT+BTSPPINIT
- Parameter Description
no parameters
- 7.AT+BTSPPCONNECT
- Function Description
SPP connect to specified device
- CMD Format
AT+BTSPPCONNECT=param1
- Parameter Description
Param
Parameter Description
param1
Bluetooth address
- 8.AT+BTSPPTX
- Function Description
SPP sends specified data
- CMD Format
AT+BTSPPTX=param1
- Parameter Description
Param
Parameter Description
param1
send data
- Test Case
AT+BT=SPP_TX,beken-spp-tx_test!!!!
- 9.AT+BTSPPTHROUGHTEST
- Function Description
SPP throughput test, the data is randomly generated
- CMD Format
AT+BTSPPTHROUGHTEST=param1
- Parameter Description
Param
Parameter Description
param1
send data length
- Return Value Description
After the data of the specified length is sent, the client and server will output the CRC value calculated by sending the data and the transmission rate from the log.
- Test Case
AT+BTSPPTHROUGHTEST=0xfffff
4. cli command introduction
- ble arg1 arg2
- Function Description
This command is used to perform operations related to Bluetooth.
- CMD Format
ble arg1 arg2
- Parameter Description
Param
Parameter Description
param1
dut: Used for entering the Bluetooth DUT test mode, which can only be used in the ATE mode! (Other commands have been replaced by AT commands which not recommended for use.)
param2
Optional parameter, referring to which serial port (0/1/2) to use for communication. If it is not filled in, it defaults to using the same serial port as the log.
- Return Value Description
none
- Notice
The command takes effect under the condition that the CONFIG_BLUETOOTH macro is enabled.
- Test Case
ble dut The following log indicates successful entry into the Bluetooth DUT test mode.
enter ble dut, log com 0, dut com 0 ,tx_pwr_idx:63