.. _headlabel-refx-cmd-itmp:

ITMP (Internal Temperature Detection)
=====================================

The `AT@ITMP` command is used to configure the internal temperature alarm detection.

When the internal temperature alarm event is detected, the terminal will generate and send the report carrying :ref:`Record 79H <headlabel-refx-record-79>` to the backend server.

.. code-block:: none

   Example:
   AT@ITMP=gl601###,,1,-10,65,10,0,5,012F$
   +ACK:ITMP,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@ITMP?gl601###,,0C37$
   +QRY:ITMP,123456789012345,C031,10,0,1,1,,1,-10,65,10,0,5,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{7.2em}|p{5.8em}|p{19em}|p{4.8em}|

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

   +-------+----------------------------+---------------+-----------------------------------------+--------------------+
   | Parts |              Fields        | Length (Byte) |                  Range/Format           |    Default         |
   +=======+============================+===============+=========================================+====================+
   | Head  | Header                     | 3             | AT@                                     | AT@                |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | Command Word               | 4             | ITMP                                    | ITMP               |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | Leading Symbol             | 1             | =                                       | =                  |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | Password                   | 8-16          |                                         | gl601###           |
   +-------+----------------------------+---------------+-----------------------------------------+--------------------+
   | Body  | Reserved                   | 0             |                                         |                    |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `Mode`                     | 1             | 0-1                                     | 0                  |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `Low Temperature`          | <=3           | -40 to 79 (°C)                          | 0                  |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `High Temperature`         | <=3           | -39 to 80 (°C)                          | 60                 |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `Alarm Validity`           | <=5           | 0-86400 (seconds)                       | 5                  |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `Alarm Interval`           | <=5           | 0 or 30-43200 (seconds)                 | 0                  |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | `Check Interval`           | <=5           | 1-86400 (seconds)                       | 5                  |
   +-------+----------------------------+---------------+-----------------------------------------+--------------------+
   | Tail  | Sequence Number            | 4             | 0000-FFFF ('0'-'9', 'A'-'F')            |                    |
   +       +----------------------------+---------------+-----------------------------------------+--------------------+
   |       | Tail                       | 1             | $                                       | $                  |
   +-------+----------------------------+---------------+-----------------------------------------+--------------------+

- `Mode`

  - **0** - Disable. The terminal will not detect the internal temperature alarm events.

  - **1** - Enable. The terminal will detect the internal temperature alarm events.

- `Low Temperature`

  Specify the lower limit temperature. When the terminal detects that the temperature is below this value for the time more than the 'Alarm Validity', a low temperature alarm event will be triggered.

  Please note that the 'Low Temperature' value must be less than the 'High Temperature'.

- `High Temperature`

  Specify the upper limit temperature. When the terminal detects that the temperature is upper this value for the time more than the 'Alarm Validity', a high temperature alarm event will be triggered.

- `Alarm Validity`

  Specify the validity time, it is used to confirm the temperature alarm event.

- `Alarm Interval`

  When the temperature alarm event is detected, the terminal will enter temperature alarm state. In the alarm state, the terminal will send the report carrying :ref:`Record 79H <headlabel-refx-record-79>` to backend server at this interval.

  In particular, **0** means no need to send the reports periodically.

- `Check Interval`

  Set the interval for the terminal to read the sensor data from the sensor.