.. _headlabel-refx-record-12:

12H (Real-time Location)
========================

When the terminal receives a valid :ref:`AT@RTO <headlabel-refx-cmd-rto>` command with a subcommand of 1, it will respond to this message to the backend server.

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

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

.. code-block:: none

   For example (Total 72 bytes):
   2B 00 00 48 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 31 66 8E 47 F7 00 00 12 00 52 16 09 F9 20 A8 E1 FF 2D C0 96 5F 17 9D A0 01 7D 0A 00 25 00 01 B3 0C 55 0E 06 04 BC 8A 00 10 00 02 10 00 10 0C 13 03 01 23 B5 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             | **12H**                                        | **12H**       |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `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 82 <headlabel-refx-data-82>` - Full Location.

  - :ref:`Data 85 <headlabel-refx-data-85>` - Registered Cell.

.. configuration:

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

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

.. code-block:: none

   Example:
   AT@QRC=gl601###,12,,,1,2|88,012F$
   +ACK:QRC,123456789012345,C031,10,0,12,012F,20210407101530,1234$
   AT@QRC?gl601###,12,0C37$
   +QRY:QRC,123456789012345,C031,10,0,1,1,12,,,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             | 12                                             | 12             |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Reserved              | 0             |                                                |                |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | Reserved              | 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 "12" here.

- `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 12H record. The characters '|' are used to connect each data ID.

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