.. _headlabel-refx-cmd-gsensor:

GSENSOR (G-Sensor Motion Detection)
===================================

The `AT@GSENSOR` command is used to configure the motion detection parameters of the G-sensor (Accelerometer).

When the terminal detects the motion state is changed, it will generate and send the report carrying :ref:`Record 21H <headlabel-refx-record-21>` to the backend server.

.. code-block:: none

   Example:
   AT@GSENSOR=gl601###,,2,3,30,,,012F$
   +ACK:GSENSOR,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@GSENSOR?gl601###,,0C37$
   +QRY:GSENSOR,123456789012345,C031,10,0,1,1,,2,3,30,,,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                     | 7             | GSENSOR                                    | GSENSOR            |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                          | =                  |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                            | gl601###           |
   +-------+----------------------------------+---------------+--------------------------------------------+--------------------+
   | Body  | Reserved                         | 0             |                                            |                    |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | `Motion Sensitivity`             | 1             | 1-5                                        | 2                  |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | `Motion Duration`                | <=3           | 1 - 999 (\*100 ms)                         | 3                  |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | `Motionless Duration`            | <=3           | 1 - 999 (seconds)                          | 30                 |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                            |                    |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                            |                    |
   +-------+----------------------------------+---------------+--------------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')               |                    |
   +       +----------------------------------+---------------+--------------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                          | $                  |
   +-------+----------------------------------+---------------+--------------------------------------------+--------------------+

- `Motion Sensitivity`

  The sensitivity level for the motion sensor to determine whether the terminal is in movement status. The smaller the value, the easier it is for the terminal to detect movement.

- `Motion Duration`

  A time parameter to determine whether the terminal enters movement status. If the motion sensor detects that the device has been moving for a period of time specified by 'Motion Duration', the device will be considered to be in movement status.

- `Motionless Duration`

  A time parameter to determine whether the terminal enters motionless status. If the motion sensor detects that the device has been motionless for a period of time specified by 'Motionless Duration', the device will be considered to be in motionless status.