.. _headlabel-refx-cmd-net:

NET (Network Connection)
========================

The `AT@NET` command is used to configure the network connection method between the terminal and the backend server.

.. code-block:: none

   Example:
   AT@NET=gl601###,,0,0,,,,,012F$
   +ACK:NET,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@NET?gl601###,,0C37$
   +QRY:NET,123456789012345,C031,10,0,1,1,,0,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             | NET                                    | NET                |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Leading Symbol              | 1             | =                                      | =                  |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Password                    | 8-16          |                                        | gl601###           |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+
   | Body  | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | `RAT Selection`             | 1 or N        | One or more RATs                       | 0                  |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | `LTE RAT`                   | 1 or N        | One or more LTE RATs                   | 0                  |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Reserved                    | 0             |                                        |                    |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+
   | Tail  | Sequence Number             | 4             | 0000-FFFF ('0'-'9', 'A'-'F')           |                    |
   +       +-----------------------------+---------------+----------------------------------------+--------------------+
   |       | Tail                        | 1             | $                                      | $                  |
   +-------+-----------------------------+---------------+----------------------------------------+--------------------+

- `RAT Selection`

  This field is used to specify the RAT (Radio Access Technology) allowed to be searched.

  Use numbers to indicate the corresponding RATs.
  In particular, setting this field to **0** indicates that the terminal will automatically search for all supported RATs.

  The numbers correspond to the RATs as follows:

  +-----------+-----------+
  | ID Number | RAT       |
  +===========+===========+
  | 2         | GSM       |
  +-----------+-----------+
  | 3         | UMTS      |
  +-----------+-----------+
  | 4         | LTE       |
  +-----------+-----------+

  If multiple RATs are configured, the RATs are separated by vertical bars '|', and their order also determines the search order.

  For example, "4|2" means that the terminal will search LTE first, and then GSM.

  For example, "4|3" means that the terminal will search LTE first, and then UMTS.

  For example, "3|2" means that the terminal will search UMTS first, and then GSM.

  For example, "4|3|2" means that the terminal will search LTE first, and then UMTS, and then GSM.

  GL601 supports the following options:

  - **0** - Auto
  - **2** - GSM only
  - **3** - UMTS only
  - **4** - LTE only
  - **4|3** - LTE|UMTS
  - **4|2** - LTE|GSM
  - **3|4** - UMTS|LTE
  - **3|2** - UMTS|GSM
  - **2|4** - GSM|LTE
  - **2|3** - GSM|UMTS
  - **4|3|2** - LTE|UMTS|GSM
  - **4|2|3** - LTE|GSM|UMTS
  - **3|4|2** - UMTS|LTE|GSM
  - **3|2|4** - UMTS|GSM|LTE
  - **2|4|3** - GSM|LTE|UMTS
  - **2|3|4** - GSM|UMTS|LTE

  .. note::
            There are two device models for the GL601: GL601MG and GL601CEU. The GL601CEU supports all of the above options, while the GL601MG only supports options **0**, **2**, **4**, **4|2**, **2|4**.

- `LTE RAT`

  This field is used to specify which network category to be searched under LTE RAT. It is only valid when LTE is included in the RAT specified by 'RAT Selection'.

  Use numbers to indicate the corresponding LTE RATs.
  In particular, setting this field to 0 indicates that the terminal will automatically search for all supported network categories under LTE RAT.
  And the definition is as follows:

  +-----------+-------------+
  | ID Number | LTE RAT     |
  +===========+=============+
  | 1         | LTE Cat-M1  |
  +-----------+-------------+
  | 3         | LTE Cat-NB2 |
  +-----------+-------------+

  If multiple network categories for LTE RAT are configured, they are separated by vertical bars '|', and their order also determines the search order.

  For example, "1|3" means that the terminal will search LTE Cat-M1 first, then LTE Cat-NB2.

  For example, "3|1" means that the terminal will search LTE Cat-NB2 first, then LTE Cat-M1.

  GL601 supports the following options:

  - **0** - Auto
  - **1** - LTE Cat-M1
  - **3** - LTE Cat-NB2
  - **1|3** - LTE Cat-M1|Cat-NB2
  - **3|1** - LTE Cat-NB2|Cat-M1

  .. note::
            There are two device models for the GL601: GL601MG and GL601CEU. The parameter 'LTE RAT' is only valid for the GL601MG and is a **Reserved** field for the GL601CEU.