.. _headlabel-refx-cmd-eth: ETH (External Temperature and Humidity) ======================================= The `AT@ETH` command is used to configure the external temperature and humidity alarm detection. The terminal obtains information through the temperature and humidity sensor. When the alarm event is detected, the terminal will generate and send the :ref:`Record 80H ` to the backend server. .. code-block:: none Example: AT@ETH=gl601###,0,0,,0,0,60,5,0,0,20,80,5,0,5,012F$ +ACK:ETH,123456789012345,C031,10,0,0,012F,20210407101530,1234$ AT@ETH?gl601###,,,0C37$ +QRY:ETH,123456789012345,C031,10,0,10,1,0,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1234$ +QRY:ETH,123456789012345,C031,10,0,10,2,1,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1235$ +QRY:ETH,123456789012345,C031,10,0,10,3,2,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1236$ +QRY:ETH,123456789012345,C031,10,0,10,4,3,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1237$ +QRY:ETH,123456789012345,C031,10,0,10,5,4,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1238$ +QRY:ETH,123456789012345,C031,10,0,10,6,5,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,1239$ +QRY:ETH,123456789012345,C031,10,0,10,7,6,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,123A$ +QRY:ETH,123456789012345,C031,10,0,10,8,7,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,123B$ +QRY:ETH,123456789012345,C031,10,0,10,9,8,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,123C$ +QRY:ETH,123456789012345,C031,10,0,10,10,9,0,,0,0,60,5,0,0,20,80,5,0,5,0C37,20210407101530,123D$ .. 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 | ETH | ETH | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | Leading Symbol | 1 | = | = | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | Password | 8-16 | | gl601### | +-------+----------------------------------+---------------+------------------------------------------------+----------------------+ | Body | `Alarm ID` | 1 | 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 | | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Type` | <=2 | Please see below. | 0 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Sensor ID` | | | | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Temperature Mode` | 1 | 0-1 | 0 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Low Temperature` | <=3 | -40 to 80 (°C) | 0 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `High Temperature` | <=3 | -40 to 80 (°C) | 60 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Temperature Validity` | <=5 | 0 - 30 (seconds) | 2 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Temperature Alarm Interval` | <=5 | 0 or 30-43200 (seconds) | 0 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Humidity Mode` | 1 | 0-1 | 0 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Low Humidity` | <=3 | 0-100 (\*1% RH) | 20 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `High Humidity` | <=3 | 0-100 (\*1% RH) | 80 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Humidity Validity` | <=5 | 0 - 30 (seconds) | 2 | + +----------------------------------+---------------+------------------------------------------------+----------------------+ | | `Humidity 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 | $ | $ | +-------+----------------------------------+---------------+------------------------------------------------+----------------------+ - `Alarm ID` Indicates the ID of the alarm. - `Type` This field indicates what type of the sensor will be used for the specified 'Alarm ID'. If set to **0**, it means that the specified 'Alarm ID' is disabled. - **0** - None. - **32** - WMS301. Temperature and humidity (Bluetooth). - **33** - WTH301. Temperature and humidity (Bluetooth). - **80** - Eddystone. Temperature (Bluetooth). - `Sensor ID` This field indicates which sensor will be detected. Its length and content are determined by 'Type'. For 'Type' that does not need to carry parameters, the length of this field is 0. For the following 'Type', the meaning of this field is as follows: - **Type 32 (WMS301)** Length: 12 bytes Format: It must only contain numbers and letters 'ABCDEFabcdef'. Description: The MAC address of the Bluetooth beacon. For example, "1234567890AB" indicates that the MAC address 12:34:56:78:90:AB. - **Type 33 (WTH301)** Length: 12 bytes Format: It must only contain numbers and letters 'ABCDEFabcdef'. Description: The MAC address of the Bluetooth beacon. For example, "1234567890AB" indicates that the MAC address 12:34:56:78:90:AB. - **Type 80 (Eddystone)** Length: 12 bytes Format: It must only contain numbers and letters 'ABCDEFabcdef'. Description: The MAC address of the Bluetooth beacon. For example, "1234567890AB" indicates that the MAC address 12:34:56:78:90:AB. - `Temperature Mode` The working mode of the temperature alarm detection. - **0** - Disable. - **1** - Enable. Detect high temperature alarm and low temperature alarm. - `Low Temperature` Specify the lower limit temperature. When the terminal detects that the temperature is below this value more than validity time, 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 more than validity time, a high temperature alarm event will be triggered. - `Temperature Validity` Specify the validity time, it is used to confirm the temperature alarm event. - `Temperature Alarm Interval` When the temperature alarm event is detected, the terminal will enter temperature alarm state. In the alarm state, the terminal will send :ref:`Record 80H ` to backend server at this interval. In particular, **0** means no need to send the reports periodically. - `Humidity Mode` The working mode of the humidity alarm detection. - **0** - Disable. - **1** - Enable. Detect high humidity alarm and low humidity alarm. - `Low Humidity` Specify the lower limit humidity. When the terminal detects that the humidity is below this value more than validity time, a low humidity alarm event will be triggered. Please note that the 'Low Humidity' value must be less than the 'High Humidity'. - `High Humidity` Specify the upper limit humidity. When the terminal detects that the humidity is upper this value more than validity time, a high humidity alarm event will be triggered. - `Humidity Validity` Specify the validity time, it is used to confirm the humidity alarm event. - `Humidity Alarm Interval` When the humidity alarm event is detected, the terminal will enter humidity alarm state. In the alarm state, the terminal will send :ref:`Record 80H ` 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. **Note**: When multiple 'Alarm IDs' are configured as Blutooth sensors, in order to minimize power consumption while ensuring proper functionality, the terminal will pick the minimum value from these 'Check Interval' values as the Bluetooth detection interval.