Reference
Last revision 2025/12/26
This comprehensive reference for AT commands on BLE devices covers everything from changing working modes and connection intervals to setting device names and managing binding configurations, providing developers with the tools to efficiently optimize Bluetooth connectivity and device interaction.
AT Command List
NOTE: <CR+LF> means Carriage-Return and Line-Feed, which is the same meaning with "Both NL & CR" in Arduino Serial monitor, do not include the string "<CR+LF>" itself.
1. "AT+FSM" change the working mode
| AT+FSM=FSM_TRANS_USB_COM_BLE<CR+LF> | USB-UART BLE transparent mode |
|---|---|
| AT+FSM=FSM_HID_USB_COM_BLE_AT<CR+LF> | USB-UART BLE HID mode |
| AT+FSM=?<CR+LF> | Request the working mode (default: FSM_TRANS_USB_COM_BLE) |
- "AT+KEY" to simulate pressing some buttons in HID mode, read FAQ 16 belowfor How to use HID mode.
| AT+KEY=keyValue0<CR+LF> | To simulate one button was pressed |
|---|---|
| AT+KEY=keyValue0+keyValue1<CR+LF> | To simulate two buttons was pressed |
| AT+KEY=keyValue0+keyValue1+keyValue2<CR+LF> | To simulate three buttons was pressed |
2. "AT+ROLE" change the CENTRAL-PERIPHERAL configuration
| AT+ROLE=ROLE_CENTRAL<CR+LF> | BLE CENTRAL mode |
|---|---|
| AT+ROLE=ROLE_PERIPHERAL<CR+LF> | BLE PERIPHERAL mode |
| AT+ROLE=?<CR+LF> | Request the CENTRAL-PERIPHERAL configuration (default: ROLE_PERIPHERAL) |
3. "AT+MIN_INTERVAL" change the minimum connection interval
| AT+MIN_INTERVAL=10<CR+LF> | Recommended minimum connection interval (10ms) for PC and Android |
|---|---|
| AT+MIN_INTERVAL=20<CR+LF> | Recommended minimum connection interval (20ms) for IOS |
| AT+MIN_INTERVAL=?<CR+LF> | Request the minimum connection interval (default: 10) |
4. "AT+MAX_INTERVAL" change the maximum connection interval
| AT+MAX_INTERVAL=10<CR+LF> | Recommended maximum connection interval (10ms) for PC and Android |
|---|---|
| AT+MAX_INTERVAL=40<CR+LF> | Recommended maximum connection interval (40ms) for IOS |
| AT+MAX_INTERVAL=?<CR+LF> | Request the maximum connection interval (default: 10) |
5. "AT+UART" change the baud rate of UART
| AT+UART=115200<CR+LF> | Set the baud rate to 115200 |
|---|---|
| AT+UART=?<CR+LF> | Request the baud rate of UART (default: 115200,8,N,1) |
6. "AT+BIND" bind another BLE chip. BLE can only connect to the BLE chip with this MAC address
| AT+BIND=0x0017ea9397e1<CR+LF> | Set the BLE binding (destination) MAC address to 0x0017ea9397e1 |
|---|---|
| AT+BIND=?<CR+LF> | Request the binding (destination) MAC address (default: 0x8A6D3B8A6D3B) |
7. "AT+CMODE" set whether the connection of BLE is binding or arbitrary
| AT+CMODE=UNIQUE<CR+LF> | BLE can only connect to the BLE chip with binding(destination) MAC address (see "AT+BIND" command) |
|---|---|
| AT+CMODE=ANYONE<CR+LF> | BLE can connect to any other BLE chips |
| AT+CMODE=?<CR+LF> | Request the binding connection mode(default:ANYONE) |
8. "AT+MAC" Request MAC address
| AT+MAC=?<CR+LF> | Request MAC address of the BLE |
|---|
9. "AT+NAME" Set the name
| AT+NAME=DFBLEduinoV1.0<CR+LF> | Set the name of BLE to "DFBLEduinoV1.0".The length is limited to 13 Bytes or below |
|---|---|
| AT+NAME=?<CR+LF> | Request the name of the BLE (default: DFBLEduinoV1.0) |
10. "AT+RESTART" restart the BLE
| AT+RESTART<CR+LF> | Restart the BLE chip |
|---|
11. "AT+SETTING" change the default setting (new in BLE firmware 1.6)
| AT+SETTING=DEFAULT<CR+LF> | Restore the default settings, same as PERIPHERAL mode |
|---|---|
| AT+SETTING=DEFPERIPHERAL<CR+LF> | Restore the default settings for PERIPHERAL mode |
| AT+SETTING=DEFCENTRAL<CR+LF> | Restore the default settings for CENTRAL mode |
| AT+SETTING=?<CR+LF> | Request the setting mode (default: DEFPERIPHERAL). If the settings are changed by AT command, "UNKNOWN" will be replied. |
12. "AT+BLUNODEBUG" When Bluetooth is connected and BLE chip(CC2540) received the UART message from MCU(ATMEGA328), send the UART message not only to the Bluetooth, but also to the USB port. So that when Bluetooth is connected, we can use the serial monitor to get the UART message. (new in BLE firmware 1.6)
| AT+BLUNODEBUG=ON<CR+LF> | Turn on the BLUNO DEBUG so that when Bluetooth is connected, we can use the serial monitor to get the UART message. |
|---|---|
| AT+BLUNODEBUG=OFF<CR+LF> | Turn off the BLUNO DEBUG so that wireless programming will be more stable. |
| AT+BLUNODEBUG=?<CR+LF> | Request the BLUNO DEBUG state (default: ON) |
13. "AT+USBDEBUG" When Bluetooth is connected and BLE chip(CC2540) received the Bluetooth message from IOS or Android device, send the data not only to the UART, but also to the USB port. So that when Bluetooth is connected, we can use the serial monitor to directly get the Bluetooth message. (new in BLE firmware 1.6)
| AT+USBDEBUG=ON<CR+LF> | Turn on the BLUNO DEBUG So that when Bluetooth is connected, we can use the serial monitor to directly get the Bluetooth message from IOS or Android device. |
|---|---|
| AT+USBDEBUG=OFF<CR+LF> | Turn off the USB DEBUG so that wireless programming will be more stable. |
| AT+USBDEBUG=?<CR+LF> | Request the USB DEBUG state (default: OFF) |
14. "AT+TXPOWER" Change the Transmitted Power which will change the signal range. (new in BLE firmware 1.6)
| AT+TXPOWER=0<CR+LF> | Change the Transmitted Power to fit the iBeacon calibration. (4, 0, -6 -23 is acceptable) |
|---|---|
| AT+TXPOWER=?<CR+LF> | Request the Transmitted Power (default: 0) |
15. "AT+IBEACONS" Enable the iBeacons feature(new in BLE firmware 1.6)
| AT+IBEACONS=ON<CR+LF> | Enable the iBeacons feature. |
|---|---|
| AT+IBEACONS=OFF<CR+LF> | Disable the iBeacons feature. |
| AT+IBEACONS=?<CR+LF> | Request whether the iBeacons feature is enabled. (default: ON) |
16. "AT+VERSION" the version of the firmware(new in BLE firmware 1.6)
| AT+VERSION=?<CR+LF> | Request the version of the firmware. |
|---|
17. "AT+RSSI" Request the RSSI of the BLE (new in BLE firmware 1.6)
| AT+RSSI=?<CR+LF> | Request the RSSI of the BLE(if there is no connection, "-000" will be returned) |
|---|
18. "AT+MAJOR" Set the major number of the iBeacons (new in BLE firmware 1.6)
| AT+MAJOR=0<CR+LF> | Set the major number of the iBeacons to "0". (0 to 65535 is acceptable) |
|---|---|
| AT+MAJOR=?<CR+LF> | Request the major number of the iBeacons.(default "0") |
19. "AT+MINOR" Set the minor number of the iBeacons (new in BLE firmware 1.6)
| AT+MINOR=0<CR+LF> | Set the minor number of the iBeacons to "0". (0 to 65535 is acceptable) |
|---|---|
| AT+MINOR=?<CR+LF> | Request the minor number of the iBeacons.(default "0") |
20. "AT+EXIT" Exit the AT Command Mode (new in BLE firmware 1.8 )，
| AT+EXIT<CR+LF> | Exit the AT Command Mode. |
|---|
firmware
Was this article helpful?