BLE Common Commands

See AT Command Format for command syntax.

These commands are available to both peripheral and central roles.

AT+BLEGAPDISCONNECT — Disconnect

Kconfig:: CONFIG_AT_CMD_BLEGAPDISCONNECT
Execute:: AT+BLEGAPDISCONNECT=<conn_idx>
Query:: not supported

Initiates graceful disconnection. Result arrives as +EVTBLEGAPDISCONN:.

AT+BLEGAPDISCONNECT=0
OK
+EVTBLEGAPDISCONN:0,22

AT+BLEGAPGETCONNSTAT — Connection Status

Kconfig:: CONFIG_AT_CMD_BLEGAPGETCONNSTAT
Execute:: AT+BLEGAPGETCONNSTAT=<conn_idx>
Query:: not supported
Response:: +BLEGAPGETCONNSTAT:<role>,<addr_type>,<addr>,<interval>,<latency>,<timeout>

role: 0 = central, 1 = peripheral. interval in units of 1.25 ms.

AT+BLEGAPGETCONNSTAT=0
+BLEGAPGETCONNSTAT:0,1,C00102030405,24,0,42
OK

AT+BLEGAPGETPEERINFO — Peer Identity

Kconfig:: CONFIG_AT_CMD_BLEGAPGETPEERINFO
Execute:: AT+BLEGAPGETPEERINFO=<conn_idx>
Query:: not supported
Response:: +BLEGAPGETPEERINFO:<id_addr_type>,<id_addr>,<sec_level>,<enc_key_size>

AT+BLEGAPGETPEERINFO=0
+BLEGAPGETPEERINFO:1,C00102030405,1,0
OK

AT+BLEGAPGETRSSI — Connection RSSI

Kconfig:: CONFIG_AT_CMD_BLEGAPGETRSSI
Execute:: AT+BLEGAPGETRSSI=<conn_idx>
Query:: not supported
Response:: +BLEGAPGETRSSI:<rssi_dBm>

AT+BLEGAPGETRSSI=0
+BLEGAPGETRSSI:-55
OK

AT+BLECONNTXPWR — Connection TX Power

Kconfig:: CONFIG_AT_CMD_BLECONNTXPWR
Execute:: AT+BLECONNTXPWR=<conn_idx>,<dBm> — range −20 to 10
Query:: AT+BLECONNTXPWR?
Response:: +BLECONNTXPWR:<conn_idx>,<current_dBm>,<max_dBm> (one line per active connection)

Requires CONFIG_VND_API_SET_CON_TX_POWER for the set path.

AT+BLECONNTXPWR?
+BLECONNTXPWR:0,0,20
OK
AT+BLECONNTXPWR=0,0
OK

AT+BLEGATTMTUEXCHGREQ — GATT MTU Exchange Request

Kconfig:: CONFIG_AT_CMD_BLEGATTMTUEXCHGREQ
Execute:: AT+BLEGATTMTUEXCHGREQ=<conn_idx>
Query:: not supported

Initiates a GATT ATT MTU exchange with the peer on the specified connection slot. The negotiated MTU is reported asynchronously via +EVTBLEGATTMTUEXCHANGE when CONFIG_AT_EVT_BLEGATTMTUEXCHANGE is enabled. Returns AT_ERR_BLE_EALREADY if an MTU exchange has already been performed on this connection.

The negotiated MTU is bounded by min(local_rx_mtu, local_tx_mtu, peer_rx_mtu, peer_tx_mtu). To negotiate an MTU larger than the default 23 bytes, both CONFIG_BT_L2CAP_TX_MTU and CONFIG_BT_BUF_ACL_RX_SIZE must be increased on both sides of the connection:

# Allow negotiating up to 247-byte ATT MTU (ATT header = 3 bytes, so L2CAP PDU = 250)
CONFIG_BT_L2CAP_TX_MTU=247
# RX buffer must cover the L2CAP PDU plus the 4-byte HCI ACL header (247 + 4 = 251)
CONFIG_BT_BUF_ACL_RX_SIZE=251

AT+BLEGATTMTUEXCHGREQ=0
OK
+EVTBLEGATTMTUEXCHANGE:0,247

AT+BLEGATTMTUGET — GATT MTU Query

Kconfig:: CONFIG_AT_CMD_BLEGATTMTUGET
Execute:: AT+BLEGATTMTUGET=<conn_idx>
Query:: not supported
Response:: +BLEGATTMTUGET:<mtu>

Returns the current unenhanced ATT (UATT) MTU for the specified active connection slot. The value reflects the MTU negotiated during the ATT MTU exchange procedure (default 23 bytes until an exchange is performed).

AT+BLEGATTMTUGET=0
+BLEGATTMTUGET:247
OK