.. _headlabel-refx-cmd-cfg:

CFG (Global Device Configuration)
=================================

The `AT@CFG` command is used to configure the key properties (such as Password) of the terminal.

.. code-block:: none

   Example:
   AT@CFG=gl601###,queclink123,MyDevice,,,,,,,012F$
   +ACK:CFG,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@CFG?queclink123,,0C37$
   +QRY:CFG,123456789012345,C031,10,0,1,1,,MyDevice,,,,0,,,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{14.2em}|p{5.8em}|p{12em}|p{4.8em}|

.. table::
   :width: 100%
   :widths: auto

   +-------+-----------------------------+---------------+---------------------------------------------+--------------------+
   | Parts | Fields                      | Length (Byte) | Range/Format                                | Default            |
   +=======+=============================+===============+=============================================+====================+
   | Head  | Header                      | 3             | AT@                                         | AT@                |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Command Word                | 3             | CFG                                         | CFG                |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Leading Symbol              | 1             | =                                           | =                  |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Password                    | 8-16          |                                             | gl601###           |
   +-------+-----------------------------+---------------+---------------------------------------------+--------------------+
   | Body  | `New Password`              | 8-16          | '0'-'9', 'a'-'z', 'A'-'Z', '-', '_', '#'    |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | `Device Name`               | 4-16          | '0'-'9', 'a'-'z', 'A'-'Z', '-'              | GL601              |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                             |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                             |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                             |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | `SMS Command Number Limit`  | 1             | 0, 1                                        | 0                  |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                             |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                             |                    |
   +-------+-----------------------------+---------------+---------------------------------------------+--------------------+
   | Tail  | Sequence Number             | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                |                    |
   +       +-----------------------------+---------------+---------------------------------------------+--------------------+
   |       | Tail                        | 1             | $                                           | $                  |
   +-------+-----------------------------+---------------+---------------------------------------------+--------------------+

- `New Password`

  Change the current password with a new one. If this field is empty, it means no need to change the password.

  **Note**: In particular, it always will be empty when reading this field.

- `Device Name`

  The name of the terminal device. If this field is empty, it means no need to change the device name.

- `SMS Command Number Limit`

  Specify whether the terminal needs to limit the SMS senders when receiving \@Track commands via SMS.

  - **0** - No limit. No matter from which number the short message is received, it will be processed.

  - **1** - Allowlist only. Only if the received short message comes from the mobile phone allowlist (please see :ref:`AT@PWL <headlabel-refx-cmd-pwl>` command), it will be processed.