.. _headlabel-refx-cmd-apn:

APN (Access Point Name)
=======================

The `AT@APN` command is used to configure the APN specified by the cellular network operator.

.. code-block:: none

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

.. tabularcolumns:: |p{2.2em}|p{7.2em}|p{5.8em}|p{19em}|p{4.8em}|

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

   +-------+------------------------+---------------+-----------------------------------------------+-----------------+
   | Parts | Fields                 | Length (Byte) | Range/Format                                  | Default         |
   +=======+========================+===============+===============================================+=================+
   | Head  | Header                 | 3             | AT@                                           | AT@             |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | Command Word           | 3             | APN                                           | APN             |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | Leading Symbol         | 1             | =                                             | =               |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | Password               | 8-16          |                                               | gl601###        |
   +-------+------------------------+---------------+-----------------------------------------------+-----------------+
   | Body  | Reserved               | 0             |                                               |                 |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | `APN`                  | <=39          | '0'-'9', 'a'-'z', 'A'-'Z', '.', '-'           |                 |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | `User Name`            | <=32          |                                               |                 |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | `Password`             | <=32          |                                               |                 |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | `Authentication`       | 1             | 0-3                                           | 0               |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | Reserved               | 0             |                                               |                 |
   +-------+------------------------+---------------+-----------------------------------------------+-----------------+
   | Tail  | Sequence Number        | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                  |                 |
   +       +------------------------+---------------+-----------------------------------------------+-----------------+
   |       | Tail                   | 1             | $                                             | $               |
   +-------+------------------------+---------------+-----------------------------------------------+-----------------+

- `APN`

  Access Point Name. It must only contain Latin letters, numbers, dot and hyphen (A-Z a-z 0-9 . -).

  **Note**: If the parameter field is empty, the current value of this parameter will be cleared.

- `User Name`

  The user name of APN. It must only contain visible ASCII characters, and the commas and dollar signs are not allowed.

  **Note**: If the parameter field is empty, the current value of this parameter will be cleared.

- `Password`

  The password of APN. It must only contain visible ASCII characters, and the commas and dollar signs are not allowed.

  **Note**: If the parameter field is empty, the current value of this parameter will be cleared.

- `Authentication`

  - **0** - None.

  - **1** - PAP authentication.

  - **2** - CHAP authentication.

  - **3** - PAP or CHAP authentication.