.. _headlabel-refx-record-04:

04H (Connection Ends)
=====================

This message is used to inform the backend server that the terminal is ready to disconnect from the backend server.

Report carrying this record is a high-priority report, please see :ref:`here <refx-frames-report-priority>` for more information.

.. note:: If the terminal is disconnected to backend server because it is preparing for device shutdown, the terminal will send a :ref:`Device Shutdown <headlabel-refx-record-05>` report instead of this 'Connection Ends' report.

The frame format of a report that only carries **04H** record is as follows:

.. code-block:: none

   For example (Total 62 bytes):
   2B 00 00 3E 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 27 66 8E 47 F7 00 00 04 00 02 0B 4D 79 49 6F 54 64 65 76 69 63 65 51 0F 09 07 3C 46 FF 01 DB 88 57 5F 17 9D A0 01 7D 01 23 41 24

.. tabularcolumns:: |p{3.8em}|p{3.2em}|p{5.5em}|p{5.8em}|p{15em}|p{4.8em}|

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

   +----------+--------------------+------------------+---------------+------------------------------------------------+---------------+
   | Parts    | Fields                                | Length (Byte) | Range/Format                                   | Default       |
   +==========+====================+==================+===============+================================================+===============+
   | Head     |                                       | 18 or 20      |                                                |               |
   +----------+--------------------+------------------+---------------+------------------------------------------------+---------------+
   | Reserved |                                       | 1 or 1+N      |                                                |               |
   +----------+--------------------+------------------+---------------+------------------------------------------------+---------------+
   | Records  | Record Length                         | 1 or 2        | 00H-7FH or 8080H-FFFFH                         |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | Generated Time                        | 4             |                                                |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | Record Count Number                   | 2             | 0000H-FFFFH                                    |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `Record ID`                           | 1             | **04H**                                        | **04H**       |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `Event Code`                          | 1             | 00H                                            | 00H           |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `Data of Record`   | Data ID          | 1 or 2        | 00H-7FH or 8080H-FFFFH                         |               |
   +          +                    +------------------+---------------+------------------------------------------------+---------------+
   |          |                    | Data Length      | 1 or 2        | 00H-7FH or 8080H-FFFFH                         |               |
   +          +                    +------------------+---------------+------------------------------------------------+---------------+
   |          |                    | Data Content     | N             |                                                |               |
   +          +                    +------------------+---------------+------------------------------------------------+---------------+
   |          |                    | ...              |               |                                                |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | ...                                   |               |                                                |               |
   +----------+--------------------+------------------+---------------+------------------------------------------------+---------------+
   | Tail     |                                       | 4             |                                                |               |
   +----------+--------------------+------------------+---------------+------------------------------------------------+---------------+

The definitions of parts 'Head', 'Reserved', and 'Tail' are :ref:`here <refx-frames-report-format>`.

- `Event Code`

  The default is **00H**.

- `Data of Record`

  It consists of one or more :ref:`Data ID units <refx-frames-report-records>`.

  By default, this record contains only the data IDs listed below, which can be changed by the `AT@QRC` command described below.

  - :ref:`Data 2 <headlabel-refx-data-2>` - Device Name.

  - :ref:`Data 81 <headlabel-refx-data-81>` - Mini Location.

.. configuration:

Configuration
-------------

The parameters related to the generation and transmission of **04H** record are controlled by the following :ref:`QRC <refx-frames-report-configuration>` command:

.. code-block:: none

   Example:
   AT@QRC=gl601###,04,,1,1,2|88,012F$
   +ACK:QRC,123456789012345,C031,10,0,04,012F,20210407101530,1234$
   AT@QRC?gl601###,04,0C37$
   +QRY:QRC,123456789012345,C031,10,0,1,1,04,,1,1,2|88,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             | QRC                                            | QRC            |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Leading Symbol        | 1             | =                                              | =              |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Password              | 8-16          |                                                | gl601###       |
   +-------+-----------------------+---------------+------------------------------------------------+----------------+
   | Body  | `Record ID`           | 2             | 04                                             | 04             |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Reserved              | 0             |                                                |                |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | `Mode`                | <=2           | 0, 1                                           | 0              |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | `Action`              | 1             | 0-2                                            |                |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | `Data IDs`            | N             | ID1|ID2|ID3…                                   |                |
   +-------+-----------------------+---------------+------------------------------------------------+----------------+
   | Tail  | Sequence Number       | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                   |                |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Tail                  | 1             | $                                              | $              |
   +-------+-----------------------+---------------+------------------------------------------------+----------------+

- `Record ID`

  Which record to configure. Always "04" here.

- `Mode`

  - **0** - Disable. The terminal no longer generates and sends the 04H record.

  - **1** - Enable Report. The terminal generates and sends the 04H record. If the location information needs to be included, the terminal directly uses the currently existing location information (even if the location information has expired).

- `Action`

  - **Empty** - No change the data IDs in the terminal. If this field is empty, the 'Data IDs' field will be ignored.

  - **0** - Append the data IDs carried in the 'Data IDs' field to the terminal.

  - **1** - Replace the data IDs in the terminal with the data IDs carried by the 'Data IDs' field.

  - **2** - Clear the data IDs carried in the 'Data IDs' field from the terminal.

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

- `Data IDs`

  The data IDs contained in the 04H record. The characters '|' are used to connect each data ID.

  For example, "2|88" means Data 2 (Device Name) and Data 88 (SIM Card).