AT Command Set

The AT Command Set subsystem provides a UART-based command interface for controlling BLE advertising, scanning, connection management, GATT server operation, GATT client discovery and data exchange, and tag lifecycle operations. Commands follow a standard AT format and are suitable for use with any serial terminal.

To enable at_cmd support, add the following to your prj.conf:

For Bluetooth Peripheral:

CONFIG_AT_CMD_SET=y
CONFIG_AT_CMD_PERIPHERAL=y

For Bluetooth Central:

CONFIG_AT_CMD_SET=y
CONFIG_AT_CMD_CENTRAL=y

For GATT Server (Default and Dynamic):

CONFIG_AT_CMD_SET=y
CONFIG_AT_CMD_PERIPHERAL=y
CONFIG_AT_CMD_GATT_DFT_SERVER=y # Default GATT server (single service, two characteristics)
CONFIG_AT_CMD_GATT_DYN_SERVER=y # Dynamic GATT server

For Tag Control:

CONFIG_AT_CMD_SET=y
CONFIG_AT_CMD_TAG_SET=y

Warning

CONFIG_AT_CMD_TAG_SET depends on CONFIG_STF_TAG || CONFIG_FMNA_TAG || CONFIG_FHN_TAG || CONFIG_ATM_AT_CMDTEST.

Command Group Reference:

Command Group	Reference
AT Command Format	AT Command Format
System Commands	System Commands
Serial DFU Commands	Serial DFU Commands
BLE Peripheral Commands	BLE Peripheral Commands
BLE Central Commands	BLE Central Commands
BLE Common Commands	BLE Common Commands
BLE Events	BLE Events
GATT Server Commands (Default + Dynamic)	BLE GATT Server Commands
GATT Client Commands	BLE GATT Client Commands
Tag Commands	Tag Commands and Events
Error Code Reference	Error Code Reference

See AT Command Set — Subsystem Reference for the full command reference.

For a working end-to-end demonstration of the AT command interface over UART, see the Subsys: AT Command Set sample.

• AT Command Set — Subsystem Reference
  • Overview
    • Role-Based Command Bundles
    • Command Groups
  • Typical Two-Device Flow
  • Kconfig Summary
• AT Command Format
  • Parameter Types
• System Commands
  • AT+SYSFUNCPIN — GPIO Function Pin Control
  • AT+SYSPM — System Power Mode
  • AT+SYSUARTBR — UART Baud Rate
  • AT+SYSUARTFC — UART Flow Control
  • System Command Error Codes
  • AT+SYSBDADDR — Bluetooth Device Address
  • AT+SYSRESET — System Reset
  • AT+SYSLOCK — Channel Lock
  • AT+SYSUNLOCK — Channel Unlock
  • AT+SYSSTORAGE — NVS Key-Value Storage
  • AT+SYSUARTRAW — Bounded UART/BLE Raw Data Transfer
• Serial DFU Commands
  • RDP Packet Format
  • AT+SYSDFU — Initiate Serial Firmware Upgrade
  • AT+SYSSWITCHBANK — Apply Staged Firmware and Reboot
  • AT+SYSMKBANKGOOD — Confirm Running Image
• BLE Peripheral Commands
  • AT+BLEGAPDEVNAME — GAP Device Name
  • AT+BLEADVENABLE — Start / Stop Advertising
  • AT+BLEADVSETID — Assign BT Identity to Advertising Instance
  • AT+BLEADVLEGACYPARM — Legacy Advertising Parameters
  • AT+BLEEXTADVPARM — Extended Advertising Parameters
  • AT+BLEADVDATA — Set Advertisement Payload
  • AT+BLESCANRSPDATA — Set Scan-Response Payload
  • AT+BLEADVTXPWR — Advertising TX Power
• BLE Central Commands
  • AT+BLESCANENABLE — Start / Stop Scanning
  • AT+BLESCANFILMAC — Controller MAC Address Filter
  • AT+BLESCANFILRSSI — RSSI Threshold Filter
  • AT+BLEGAPCREATECONN — Initiate Connection
  • AT+BLEGAPCANCELCREATECONN — Cancel Pending Connection
• BLE Common Commands
  • AT+BLEGAPDISCONNECT — Disconnect
  • AT+BLEGAPGETCONNSTAT — Connection Status
  • AT+BLEGAPGETPEERINFO — Peer Identity
  • AT+BLEGAPGETRSSI — Connection RSSI
  • AT+BLECONNTXPWR — Connection TX Power
  • AT+BLEGATTMTUEXCHGREQ — GATT MTU Exchange Request
  • AT+BLEGATTMTUGET — GATT MTU Query
• BLE Events
  • Central Events
    • +EVTBLEGAPADVRPT — Advertisement Report
  • Common Events (Peripheral and Central)
    • +EVTBLEGAPCONN — Connection Established
    • +EVTBLEGAPDISCONN — Disconnection
    • +EVTBLEGAPLINKINFO — Remote LE Features
    • +EVTBLEGAPPAR — Connection Parameter Update
    • +EVTBLEGATTMTUEXCHANGE — GATT MTU Exchange
    • +EVTBLEGATTMTUEXCHGREQ — GATT MTU Exchange Request Result
  • BLE GATT Events
    • +EVTBLEGATTFROMBLE — Client Read / Write Event
• BLE GATT Server Commands
  • BLE GATT Default Server Commands
  • sec_prop Reference
  • Default Attribute Layout
    • AT+BLEGATTDFTSERVER — Enable / Disable Default GATT Server
    • AT+BLEGATTDFTSERVICE — Default Service Configuration
    • AT+BLEGATTDFTCHAR1 — Characteristic 1 (TRX) Configuration
    • AT+BLEGATTDFTCHAR2 — Characteristic 2 (TRX2) Configuration
    • AT+BLEGATTDFTCHAR1VAL — Characteristic 1 Pre-set Read Value
    • AT+BLEGATTDFTCHAR2VAL — Characteristic 2 Pre-set Read Value
    • AT+BLEGATTTOBLE — Send Notification / Indication
  • BLE GATT Dynamic Server Commands
  • Basic Workflow
    • AT+BLEGATTADDSERVICE — Stage a Primary Service
    • AT+BLEGATTADDCHAR — Add a Characteristic to Staged Service
    • AT+BLEGATTADDDESC — Add a Standard Descriptor (16-bit UUID)
    • AT+BLEGATTADDDESCUSERDFD — Add a User-Defined Descriptor
    • AT+BLEGATTSVCACTIVE — Activate Staged Services
  • Typical Dynamic GATT Workflow
  • Events
  • Troubleshooting
• BLE GATT Client Commands
  • Discovery Commands
    • AT+BLEGATTDISCSVCS — Discover All Primary Services
    • AT+BLEGATTDISCSVC — Discover Service by UUID
    • AT+BLEGATTDISCCHARS — Discover All Characteristics
    • AT+BLEGATTDISCCHAR — Discover Characteristic by UUID
    • AT+BLEGATTDISCDESCS — Discover Descriptors
  • Read / Write Commands
    • AT+BLEGATTRD — Read Characteristic Value
    • AT+BLEGATTWR — Write With Response
    • AT+BLEGATTWRWO — Write Without Response
  • Subscribe / Unsubscribe
    • AT+BLEGATTWRCCCD — Write CCCD
  • Events
    • +BLEGATTNOTI — Notification Received
    • +BLEGATTINDI — Indication Received
• Tag Commands and Events
  • Command Dependencies
    • AT+TAGINFO — Tag Information
    • AT+TAGMODE — Tag Mode Select / Query
    • AT+TAGBATTERY — Battery Level
    • AT+TAGSTART — Start Tag BLE Stack
    • AT+TAGRESET — Reboot / Factory Reset
    • AT+TAGSTFIND — STF Button Simulation
    • AT+TAGFMNASN — FMNA Serial Number Lookup
    • AT+TAGFMNAMFI — FMNA MFI Token Log
    • AT+TAGCSUNPAIR — Channel Sounding Unpair
    • AT+TAGGFPIND — GFP Button Simulation
    • AT+TAGMOTIONRPT — Host Motion Acceleration Report
    • +EVTTAGSTATE — Tag State
    • +EVTTAGERROR — Tag Error
    • +EVTTAGGFPREVERSERING — GFP Reverse Ringing Status
    • +EVTTAGBUZZER — Tag Buzzer Action
    • +EVTTAGMOTIONCTL — Motion Sensor Control Event
    • AT+TAGADDR — Query Advertising BT Address
  • Tag AT Command Error Codes
  • Implementation Notes
• Error Code Reference
  • Error Response Format
  • Framework Error Codes (at_cmd_err_t)
  • Application Error Codes (at_cmd_app_err_t)
    • Value ranges
    • Code table
  • BLE / Zephyr Errno Mapping
  • Tag Error Codes (at_cmd_tag_err_t)