.. _at_cmd:

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:**

.. code-block:: cfg

   CONFIG_AT_CMD_SET=y
   CONFIG_AT_CMD_PERIPHERAL=y

**For Bluetooth Central:**

.. code-block:: cfg

   CONFIG_AT_CMD_SET=y
   CONFIG_AT_CMD_CENTRAL=y

**For GATT Server (Default and Dynamic):**

.. code-block:: cfg

   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:**

.. code-block:: cfg

   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:**

.. list-table::
   :header-rows: 1
   :widths: 35 65

   * - Command Group
     - Reference
   * - AT Command Format
     - :ref:`at_cmd_format`
   * - System Commands
     - :ref:`at_cmd_sys`
   * - Serial DFU Commands
     - :ref:`at_cmd_sys_dfu`
   * - BLE Peripheral Commands
     - :ref:`at_cmd_ble_peripheral`
   * - BLE Central Commands
     - :ref:`at_cmd_ble_central`
   * - BLE Common Commands
     - :ref:`at_cmd_ble_common`
   * - BLE Events
     - :ref:`at_cmd_ble_events`
   * - GATT Server Commands (Default + Dynamic)
     - :ref:`at_cmd_gatt`
   * - GATT Client Commands
     - :ref:`at_cmd_gatt_client`
   * - Tag Commands
     - :ref:`at_cmd_tag`
   * - Error Code Reference
     - :ref:`at_cmd_errors`

See :ref:`at_cmd_set` for the full command reference.

For a working end-to-end demonstration of the AT command interface over UART,
see the :ref:`at_cmd_set-sample` sample.

.. toctree::
   :maxdepth: 3

   ../openair/subsys/at_cmd_set/README.rst
   ../openair/subsys/at_cmd_set/README_format.rst
   ../openair/subsys/at_cmd_set/README_sys.rst
   ../openair/subsys/at_cmd_set/README_sys_dfu.rst
   ../openair/subsys/at_cmd_set/README_ble_peripheral.rst
   ../openair/subsys/at_cmd_set/README_ble_central.rst
   ../openair/subsys/at_cmd_set/README_ble_common.rst
   ../openair/subsys/at_cmd_set/README_ble_events.rst
   ../openair/subsys/at_cmd_set/README_gatt.rst
   ../openair/subsys/at_cmd_set/README_gatt_client.rst
   ../openair/subsys/at_cmd_set/README_tag.rst
   ../openair/subsys/at_cmd_set/README_errors.rst