.. _headlabel-refx-record-63:

63H (Wi-Fi Geofence Notification)
=================================

When the terminal enters/exits the signal coverage area of the specified Wi-Fi hotspot, the terminal will generate and send this message to the backend server.
For the Wi-Fi Geofence function, please refer to the :ref:`AT@WIFIGEO <headlabel-refx-cmd-wifigeo>` command.

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

.. code-block:: none

   For example (Total 37 bytes):
   2B 00 00 25 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 0E 66 8E 47 F7 00 00 63 01 80 9A 02 01 00 01 23 C0 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             | **63H**                                        | **63H**       |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `Event Code`                          | 1             | 01H, 02H                                       |               |
   +          +--------------------+------------------+---------------+------------------------------------------------+---------------+
   |          | `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`

  - **01H** - The terminal enters the Wi-Fi Geofence area.

  - **02H** - The terminal exits the Wi-Fi Geofence area.

- `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 154 <headlabel-refx-data-154>` - Wi-Fi Geofence Status.

.. configuration:

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

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

.. code-block:: none

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

.. tabularcolumns:: |p{2.2em}|p{16.2em}|p{5.8em}|p{11em}|p{3.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             | 63                                             | 63             |
   +       +-----------------------+---------------+------------------------------------------------+----------------+
   |       | 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 "63" 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 63H record. The characters '|' are used to connect each data ID.

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