.. _headlabel-refx-record-95:

95H (Beacon Event)
==================

When the terminal detects the Beacon event, it will generate and send the message to the backend server. For the Beacon detection, please refer to the :ref:`AT@BTBCN <headlabel-refx-cmd-btbcn>` command.

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

.. code-block:: none

   For example (Total 122 bytes):
   2B 00 00 7A 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 63 66 8E 47 F7 00 00 95 00 80 B2 09 01 0C 12 34 56 78 90 AB BB 80 B3 1D 01 0C 12 34 56 78 90 AB BB 0C 80 01 18 00 11 22 33 44 55 66 77 88 99 00 AA BB CC DD EE 80 B4 1D 01 0C 12 34 56 78 90 AB BB 11 22 33 44 AA BB 11 22 CC DD 00 11 22 33 44 55 00 01 00 01 80 B2 0B 01 0C 12 34 56 78 90 AB BB 0C 80 01 23 CC 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             | **95H**                                        | **95H**       |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `Event Code`                          | 1             | 00H, 01H                                       |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `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`

  - **00H** - Detected Beacon(s).

  - **01H** - The voltage of the Beacon is low.

- `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 178 <headlabel-refx-data-178>` - Scanned Base Beacon Data.

  - :ref:`Data 179 <headlabel-refx-data-179>` - Scanned Eddystone Beacon Data.

  - :ref:`Data 180 <headlabel-refx-data-180>` - Scanned iBeacon Beacon Data.

  - :ref:`Data 181 <headlabel-refx-data-181>` - Scanned WID3xx Beacon Data.

.. configuration:

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

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

.. code-block:: none

   Example:
   AT@QRC=gl601###,95,,,1,178|179|180|181,012F$
   +ACK:QRC,123456789012345,C031,10,0,95,012F,20210407101530,1234$
   AT@QRC?gl601###,95,0C37$
   +QRY:QRC,123456789012345,C031,10,0,1,1,95,,,1,178|179|180|181,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             | 95                                             | 95             |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | 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 "95" 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 95H record. The characters '|' are used to connect each data ID.

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