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 Record 80H to the backend server.

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$

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 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 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.