.. _headlabel-refx-cmd-sms:

SMS (Short Message Server Settings)
===================================

The `AT@SMS` command is used to configure the SMS server function of the terminal.

.. code-block:: none

   Example:
   AT@SMS=gv500cna,,,0,,,,,012F$
   +ACK:SMS,123456789012345,8203,3,0,,012F,20210407101530,1234$
   AT@SMS?gv500cna,,0C37$
   +QRY:SMS,123456789012345,8203,3,0,1,1,,,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             | SMS                                    | SMS                |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Leading Symbol              | 1             | =                                      | =                  |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Password                    | 8-16          |                                        | gv500cna           |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+
   | Body  | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | `SMS Mode`                  | 1             | 0, 5                                   | 0                  |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | `SMS Gateway Number`        | <=20          |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+
   | Tail  | Sequence Number             | 4             | 0000-FFFF ('0'-'9', 'A'-'F')           |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Tail                        | 1             | $                                      | $                  |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+

- `SMS Mode`

  The working mode of SMS server function.

  - **0** - Disable. SMS will not be used for data transmission.

  - **5** - Force on SMS mode. Only SMS is used for data transmission. In this mode, the network backend server function (configured by the :ref:`AT@BSS <headlabel-refx-cmd-bss>` command) will be invalid, that is, the terminal does not connect to the network backend server.

- `SMS Gateway Number`

  The gateway number of SMS. If it is an international number, remember to add "+" and the area code. Note that this field will be ignored when the 'SMS Mode' is 0.