.. _headlabel-refx-cmd-wifigeo:

WIFIGEO (Wi-Fi Geofence)
========================

This command is used to configure the parameters of the Wi-Fi geofence function. When the terminal enters/exits the signal coverage area of the specified Wi-Fi hotspot, the terminal will generate and send a :ref:`Record 63H <headlabel-refx-record-63>` message to the backend server.

.. code-block:: none

   Example:
   AT@WIFIGEO=gl601###,1,1,C8D3A34C6400,,,,,012F$
   +ACK:WIFIGEO,123456789012345,C031,10,0,1,012F,20210407101530,1234$
   AT@WIFIGEO?gl601###,,0C37$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,1,1,0,C8D3A34C6400,,,,,0C37,20210407101530,1234$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,2,2,0,,,,,,0C37,20210407101530,1235$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,3,3,0,,,,,,0C37,20210407101530,1236$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,4,4,0,,,,,,0C37,20210407101530,1237$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,5,5,0,,,,,,0C37,20210407101530,1238$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,6,6,0,,,,,,0C37,20210407101530,1239$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,7,7,0,,,,,,0C37,20210407101530,123A$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,8,8,0,,,,,,0C37,20210407101530,123B$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,9,9,0,,,,,,0C37,20210407101530,123C$
   +QRY:WIFIGEO,123456789012345,C031,10,0,10,10,10,0,,,,,,0C37,20210407101530,123D$

.. tabularcolumns:: |p{2.2em}|p{11em}|p{5.8em}|p{12em}|p{8em}|

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

   +-------+----------------------------------+---------------+-----------------------------------------+-----------------------------+
   | Parts |              Fields              | Length (Byte) |                  Range/Format           |    Default                  |
   +=======+==================================+===============+=========================================+=============================+
   | Head  | Header                           | 3             | AT@                                     | AT@                         |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Command Word                     | 7             | WIFIGEO                                 | WIFIGEO                     |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Leading Symbol                   | 1             | =                                       | =                           |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Password                         | 8-16          |                                         | gl601###                    |
   +-------+----------------------------------+---------------+-----------------------------------------+-----------------------------+
   | Body  | `GEO ID`                         | <=2           | 1 - 10                                  |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | `Mode`                           | 1             | 0, 1                                    | 0                           |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | `MAC`                            | 0 or 12       | '0'-'9', 'A'-'F', 'a'-'f'               |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Reserved                         | 0             |                                         |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Reserved                         | 0             |                                         |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Reserved                         | 0             |                                         |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Reserved                         | 0             |                                         |                             |
   +-------+----------------------------------+---------------+-----------------------------------------+-----------------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')            |                             |
   +       +----------------------------------+---------------+-----------------------------------------+-----------------------------+
   |       | Tail                             | 1             | $                                       | $                           |
   +-------+----------------------------------+---------------+-----------------------------------------+-----------------------------+

- `GEO ID`

  Which Wi-Fi Geofence to configure.

- `Mode`

  Specify the working mode of Wi-Fi Geofence.

  - **0** - Disable.
  - **1** - Enable.

- `MAC`

  The MAC of a Wi-Fi hotspot. The MAC address must only contain numbers and letters 'ABCDEFabcdef'.

  For example, "C8D3A34C6400" indicates that MAC address "C8-D3-A3-4C-64-00".