BT Cli

[中文]

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:OK is returned. If the CMD execution fails, CMDRSP:ERROR is returned.

2. Code path

path: \components\bk_bluetooth\api\bk_at_bt.c

3. Cli 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
    0x00 not accept role switch
    0x01 accept 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