Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://docs.espressif.com/projects/esp-at/en/latest/AT_Command_Set/BT_AT_Commands.html below:

Website Navigation

• ESP-AT User Guide

ESP32 Classic Bluetooth® AT Commands - ESP32

[中文]

• Introduction

• AT+BTINIT: Classic Bluetooth initialization.

• AT+BTNAME: Query/Set Classic Bluetooth device name.

• AT+BTSCANMODE: Set Classic Bluetooth scan mode.

• AT+BTSTARTDISC: Start Classic Bluetooth discovery.

• AT+BTSPPINIT: Classic Bluetooth SPP profile initialization.

• AT+BTSPPCONN: Query/Establish SPP connection.

• AT+BTSPPDISCONN: End SPP connection.

• AT+BTSPPSTART: Start Classic Bluetooth SPP profile.

• AT+BTSPPSEND: Send data to remote Classic Bluetooth SPP device.

• AT+BTA2DPINIT: Classic Bluetooth A2DP profile initialization.

• AT+BTA2DPCONN: Establish A2DP connection.

• AT+BTA2DPDISCONN: End A2DP connection.

• AT+BTA2DPSRC: Query/Set the audio file URL.

• AT+BTA2DPCTRL: Control the audio play.

• AT+BTSECPARAM: Query/Set the Classic Bluetooth security parameters.

• AT+BTKEYREPLY: Input the Simple Pair Key.

• AT+BTPINREPLY: Input the Legacy Pair PIN Code.

• AT+BTSECCFM: Reply the confirm value to the peer device in the legacy connection stage.

• AT+BTENCDEV: Query Classic Bluetooth encryption device list.

• AT+BTENCCLEAR: Clear Classic Bluetooth encryption device list.

• AT+BTCOD: Set class of devices.

• AT+BTPOWER: Query/Set power of Classic Bluetooth.

ESP32 AT firmware supports Bluetooth® Core Specification Version 4.2.

Important

The default AT firmware does not support the AT commands listed on this page. If you need ESP32 to support Classic Bluetooth commands, you can compile the ESP-AT project by following the steps in Compile ESP-AT Project Locally documentation. In the project configuration during the fifth step, make the following selections (Each item below is independent. Choose it according to your needs):

• Enable Generic Bluetooth commands: Component config -> AT -> AT bt command support

• Enable SPP commands: Component config -> AT -> AT bt command support -> AT bt spp command support

• Enable A2DP commands:Component config -> AT -> AT bt command support -> AT bt a2dp command support

Function:

Query the initialization status of Classic Bluetooth.

Command:

Response:

If Classic Bluetooth is initialized, AT will return:

If Classic Bluetooth is not initialized, AT will return:

Function:

Initialize or deinitialize Classic Bluetooth.

Command:

Response:

• <init>:

  • 0: deinitialize Classic Bluetooth.

  • 1: initialize Classic Bluetooth.

• To achieve better performance, it is recommended to disable SoftAP by sending the AT+CWMODE=0/1 command before using Classic Bluetooth function. For more details, please refer to the RF Coexistence documentation.

• If Classic Bluetooth is initialized, AT+CIPMODE cannot be set to 1.

Function:

Query the Classic Bluetooth device name.

Command:

Response:

Function:

Set the Classic Bluetooth device name.

Command:

Response:

• <device_name>: the Classic Bluetooth device name. The maximum length is 32. Default: “ESP32_AT”.

• The configuration changes will be saved in the NVS partition if AT+SYSSTORE=1.

• The default Classic Bluetooth device name is “ESP32_AT”.

Function:

Set the scan mode of Classic Bluetooth.

Command:

AT+BTSCANMODE=<scan_mode>

Response:

• <scan_mode>:

  • 0: Neither discoverable nor connectable.

  • 1: Connectable but not discoverable.

  • 2: Both discoverable and connectable.

  • 3: Discoverable but not connectable.

AT+BTSCANMODE=2   // both discoverable and connectable

Function:

Start Classic Bluetooth discovery.

Command:

AT+BTSTARTDISC=<inq_mode>,<inq_len>,<inq_num_rsps>

Response:

+BTSTARTDISC:<bt_addr>,<dev_name>,<major_dev_class>,<minor_dev_class>,<major_srv_class>,<rssi>

OK

• <inq_mode>:

  • 0: general inquiry mode.

  • 1: limited inquiry mode.

• <inq_len>: inquiry duration. Range: 0x01 ~ 0x30.

• <inq_num_rsps>: number of inquiry responses that can be received. If you set it to 0, AT will receive an unlimited number of responses.

• <bt_addr>: Classic Bluetooth address.

• <dev_name>: device name.

• <major_dev_class>:

  • 0x0: miscellaneous.

  • 0x1: computer.

  • 0x2: phone (cellular, cordless, pay phone, modem).

  • 0x3: LAN, Network Access Point.

  • 0x4: audio/video (headset, speaker, stereo, video display, VCR).

  • 0x5: peripheral (mouse, joystick, keyboard).

  • 0x6: imaging (printer, scanner, camera, display).

  • 0x7: wearable.

  • 0x8: toy.

  • 0x9: health.

  • 0x1F: uncategorized device.

• <minor_dev_class>: please refer to Minor Device Class field.

• <major_srv_class>:

  • 0x0: an invalid value.

  • 0x1: Limited Discoverable Mode.

  • 0x8: positioning (location identification).

  • 0x10: networking, such as LAN, Ad hoc.

  • 0x20: rendering, such as printing, speakers.

  • 0x40: capturing, such as scanner, microphone.

  • 0x80: object transfer, such as v-Inbox, v-Folder.

  • 0x100: audio, such as speaker, microphone, headerset service.

  • 0x200: telephony, such as cordless telephony, modem, headset service.

  • 0x400: information, such as WEB-server, WAP-server.

• <rssi>: signal strength.

AT+BTINIT=1
AT+BTSCANMODE=2
AT+BTSTARTDISC=0,10,10

Function:

Query the initialization status of Classic Bluetooth SPP profile.

Command:

Response:

If Classic Bluetooth SPP profile is initialized, it will return:

If Classic Bluetooth SPP profile is not initialized, it will return:

Function:

Initialize or deinitialize Classic Bluetooth SPP profile.

Command:

Response:

• <init>:

  • 0: deinitialize Classic Bluetooth SPP profile.

  • 1: initialize Classic Bluetooth SPP profile, the role is master.

  • 2: initialize Classic Bluetooth SPP profile, the role is slave.

AT+BTSPPINIT=1    // master
AT+BTSPPINIT=2    // slave

Function:

Query Classic Bluetooth SPP connection.

Command:

Response:

+BTSPPCONN:<conn_index>,<remote_address>
OK

If the connection has not been established, AT will return:

Function:

Establish the Classic Bluetooth SPP connection.

Command:

AT+BTSPPCONN=<conn_index>,<sec_mode>,<remote_address>

Response:

If the connection is established successfully, AT will return:

+BTSPPCONN:<conn_index>,<remote_address>

Otherwise, AT will return:

+BTSPPCONN:<conn_index>,-1

• <conn_index>: index of Classic Bluetooth SPP connection. Only 0 is supported for the single connection right now.

• <sec_mode>:

  • 0x0000: no security.

  • 0x0001: authorization required (only needed for out going connection).

  • 0x0036: encryption required.

  • 0x3000: Man-In-The-Middle protection.

  • 0x4000: Min 16 digit for pin code.

• <remote_address>: remote Classic Bluetooth SPP device address.

AT+BTSPPCONN=0,0,"24:0a:c4:09:34:23"

Function:

End the Classic Bluetooth SPP connection.

Command:

AT+BTSPPDISCONN=<conn_index>

Response:

If the command is successful, it will prompt:

+BTSPPDISCONN:<conn_index>,<remote_address>

If the command is fail, it will prompt:

• <conn_index>: index of Classic Bluetooth SPP connection. Only 0 is supported for the single connection right now.

• <remote_address>: remote Classic Bluetooth A2DP device address.

Function:

Enter Classic Bluetooth SPP mode.

Command:

Response:

Function:

Send data to the remote Classic Bluetooth SPP device.

Command:

AT+BTSPPSEND=<conn_index>,<data_len>

Response:

• <conn_index>: index of Classic Bluetooth SPP connection. Only 0 is supported for the single connection right now.

• <data_len>: the length of the data which is ready to be sent.

• The wrap return is > after this command is executed. Then, the ESP32 enters UART Bluetooth passthrough mode. When the packet which only contains +++ is received, the device returns to normal command mode. Please wait for at least one second before sending the next AT command.

AT+BTSPPSEND=0,100
AT+BTSPPSEND

Function:

Start Classic Bluetooth SPP profile.

Command:

Response:

• During the SPP transmission, AT will not prompt any connection status changes unless bit2 of AT+SYSMSG is 1.

Function:

Query the initialization status of Classic Bluetooth A2DP profile.

Command:

Response:

If Classic Bluetooth A2DP profile is initialized, AT will return:

Otherwise, AT will return:

Function:

Initialize or deinitialize Classic Bluetooth A2DP profile.

Command:

Response:

• <role>: role

  • 0: deinitialize Classic Bluetooth A2DP profile.

  • 1: source.

  • 2: sink.

Function:

Query Classic Bluetooth A2DP connection.

Command:

Response:

+BTA2DPCONN:<conn_index>,<remote_address>
OK

If the connection has not been established, AT will NOT return the parameter <conn_index> and <remote_address>.

Function:

Establish the Classic Bluetooth A2DP connection.

Command:

AT+BTA2DPCONN=<conn_index>,<remote_address>

Response:

If the connection is established successfully, it will prompt the message below:

+BTA2DPCONN:<conn_index>,<remote_address>

Otherwise, it will return:

+BTA2DPCONN:<conn_index>,-1

• <conn_index>: index of Classic Bluetooth A2DP connection. Only 0 is supported for the single connection right now.

• <remote_address>: remote Classic Bluetooth A2DP device address.

AT+BTA2DPCONN=0,0,0,"24:0a:c4:09:34:23"

Function:

End the Classic Bluetooth A2DP connection.

Command:

AT+BTA2DPDISCONN=<conn_index>

Response:

+BTA2DPDISCONN:<conn_index>,<remote_address>
OK

• <conn_index>: index of Classic Bluetooth A2DP connection. Only 0 is supported for the single connection right now.

• <remote_address>: remote Classic Bluetooth A2DP device address.

Function:

Query the audio file URL.

Command:

Response:

+BTA2DPSRC:<url>,<type>
OK

Function:

Set the audio file URL.

Command:

AT+BTA2DPSRC=<conn_index>,<url>

Response:

• <conn_index>: index of Classic Bluetooth A2DP connection. Only 0 is supported for the single connection right now.

• <url>: the path of the source file. HTTP, HTTPS and FLASH are currently supported.

• <type>: the type of audio file, such as “mp3”.

• Only mp3 format is currently supported.

AT+BTA2DPSRC=0,"https://dl.espressif.com/dl/audio/ff-16b-2c-44100hz.mp3"
AT+BTA2DPSRC=0,"flash://spiffs/zhifubao.mp3"

Function:

Control the audio play.

Command:

AT+BTA2DPCTRL=<conn_index>,<ctrl>

Response:

• <conn_index>: index of Classic Bluetooth A2DP connection. Only 0 is supported for the single connection right now.

• <ctrl>: types of control.

  • 0: A2DP Sink, stop play.

  • 1: A2DP Sink, start play.

  • 2: A2DP Sink, forward.

  • 3: A2DP Sink, backward.

  • 4: A2DP Sink, fastward start.

  • 5: A2DP Sink, fastward stop.

  • 0: A2DP Source, stop play.

  • 1: A2DP Source, start play.

  • 2: A2DP Source, suspend.

AT+BTA2DPCTRL=0,1  // start play audio

Function:

Query Classic Bluetooth security parameters.

Command:

Response:

+BTSECPARAM:<io_cap>,<pin_type>,<pin_code>
OK

Function:

Set the Classic Bluetooth security parameters.

Command:

AT+BTSECPARAM=<io_cap>,<pin_type>,<pin_code>

Response:

• <io_cap>: input and output capability.

  • 0: DisplayOnly.

  • 1: DisplayYesNo.

  • 2: KeyboardOnly.

  • 3: NoInputNoOutput.

• <pin_type>: use variable or fixed PIN.

  • 0: variable.

  • 1: fixed.

• <pin_code>: Legacy Pair PIN Code. Maximum: 16 bytes.

• If you set the parameter <pin_type> to 0, <pin_code> will be ignored.

Function:

Input the Simple Pair Key.

Command:

AT+BTKEYREPLY=<conn_index>,<Key>

Response:

• <conn_index>: index of Classic Bluetooth connection. Currently, only 0 is supported for the single connection.

• <Key>: the Simple Pair Key.

Function:

Input the Legacy Pair PIN Code.

Command:

AT+BTPINREPLY=<conn_index>,<Pin>

Response:

• <conn_index>: index of Classic Bluetooth connection. Currently, only 0 is supported for the single connection.

• <Pin>: the Legacy Pair PIN Code.

Function:

Reply the confirm value to the peer device in the legacy connection stage.

Command:

AT+BTSECCFM=<conn_index>,<accept>

Response:

• <conn_index>: index of Classic Bluetooth connection. Currently, only 0 is supported for the single connection.

• <accept>: reject or accept.

  • 0: reject.

  • 1: accept.

Function:

Query the bound devices.

Command:

Response:

+BTENCDEV:<enc_dev_index>,<mac_address>
OK

• <enc_dev_index>: index of the bound devices.

• <mac_address>: MAC address.

Function:

Remove a device from the security database list with a specific index.

Command:

AT+BTENCCLEAR=<enc_dev_index>

Response:

Function:

Remove all devices from the security database.

Command:

Response:

• <enc_dev_index>: index of the bound devices.

Function:

Set the Classic Bluetooth class of devices.

Command:

AT+BTCOD=<major>,<minor>,<service>

Response:

• <major>: major class.

• <minor>: minor class.

• <service>: service class.

AT+BTCOD=6,32,32   // the printer

Function:

Query Classic Bluetooth tx power level.

Command:

Response:

+BTPOWER:<min_tx_power>,<max_tx_power>
OK

Function:

Set the Classic Bluetooth tx power.

Command:

AT+BTPOWER=<min_tx_power>,<max_tx_power>

Response:

• <min_tx_power>: The minimum power level. Range: [0,7].

• <max_tx_power>: The maximum power level. Range: [0,7].

AT+BTPOWER=5,6   // set Classic Bluetooth tx power.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4