.. _headlabel-refx-record-80: 80H (External Temperature and Humidity Alarm) ============================================= This message can be sent to the backend server when an external temperature/humidity alarm event is detected. For the temperature/humidity alarm event detection, please refer to :ref:`AT@ETH ` command. The frame format of a report that only carries **80H** record is as follows: .. code-block:: none For example (Total 43 bytes): 2B 00 00 2B 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 14 66 8E 47 F7 00 00 80 10 7A 09 01 00 02 8A 1E 5D D5 2E FA 01 23 74 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 | **80H** | **80H** | + +--------------------+------------------+---------------+------------------------------------------------+---------------+ | | `Event Code` | 1 | | | + +--------------------+------------------+---------------+------------------------------------------------+---------------+ | | `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 `. - `Event Code` Use a byte to indicate the event code. The byte is defined as follows: - **Appended Report (Bit7)** Always 0 for 80H report. - **Event (Bit6 to Bit4)** Indicates which event caused the message to be generated. - **0b000** - Reserved. - **0b001** - External temperature returns to normal. - **0b010** - External temperature is low. - **0b011** - External temperature is high. - **0b100** - External humidity returns to normal. - **0b101** - External humidity is low. - **0b110** - External humidity is high. - **0b111** - Reserved. - **Alarm ID (Bit3 to Bit0)** Indicates which alarm ID triggers the alarm. - **0b0000** - Alarm ID 0. - **0b0001** - Alarm ID 1. - **0b0010** - Alarm ID 2. - **0b0011** - Alarm ID 3. - **0b0100** - Alarm ID 4. - **0b0101** - Alarm ID 5. - **0b0110** - Alarm ID 6. - **0b0111** - Alarm ID 7. - **0b1000** - Alarm ID 8. - **0b1001** - Alarm ID 9. - **Others** - Reserved. - `Data of Record` It consists of one or more :ref:`Data ID units `. By default, this record contains only the data IDs listed below, which can be changed by the `AT@QRC` command described below. - :ref:`Data 122 ` - External Temperature and Humidity. .. configuration: Configuration ------------- The parameters related to the generation and transmission of **80H** record are controlled by the following :ref:`QRC ` command: .. code-block:: none Example: AT@QRC=gl601###,80,,,1,2|88,012F$ +ACK:QRC,123456789012345,C031,10,0,80,012F,20210407101530,1234$ AT@QRC?gl601###,80,0C37$ +QRY:QRC,123456789012345,C031,10,0,1,1,80,,,1,2|88,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 | 80 | 80 | + +-----------------------+---------------+------------------------------------------------+----------------+ | | 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 "80" 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 80H record. The characters '|' are used to connect each data ID. For example, "2|88" means Data 2 (Device Name) and Data 88 (SIM Card).