Thr sensor

 

 

Declaration of conformity


Download the declaration of conformity

Presentation


The THr sensor is LoRaWAN class A sensor, it manages two different power supplies, a disposable ½ AA 3.6V battery and a rechargeable battery as power supply. It  also includes an internal antenna.

It is possible to measure the temperature, the relative humidity and the illuminance of the remote sensor. It is also possible to get the voltage of the power supply.

thr

Family code

The family code of THr devices is: 50-70-007-xxx

The family code of THr Plus devices is: 50-70-047-xxx

The difference between THr and THr Plus is that the sensor used in THr Plus (SHT25) to measure the temperature and humidity is more precise than the one used in THr (SHT21).

Accuracy toleranceTHr (SHT21)THr Plus (SHT25)
Temperature (°C)+/- 0.3+/- 0.2
Humidity (%) +/- 2+/- 1.8

Installation and use


Installation

The housing is intended to be installed inside or outside a building but to the shelter of a vertical splash water and direct sunlight.

Instructions on fixing screws

Propagation radio

In order for the sensor to function correctly, it is better to limit the number of obstacles in order to avoid excessive attenuation of the radio wave, it is also important to put the sensor as high as possible.

propagation-thr

Autonomy


The information in the table below represents how long the battery can last. It is  based on the default configuration at ambient temperature (+25°C) within the optimal use of the sensor throught LoRaWAN network (one uplink frame), and when  the spreading factor used is SF12.

The capacity of the disposable battery is 3.6Ah, 85% of it is used.

Transmission periodicityBattery life
2 frames/ 8 hours9 years

Human Machine Interface


This device can be switched ON and OFF through a small switch accessible on the top of the electronic card. Set the switch ON. This switch can be seen on the illustration here below:

thr_carte

There are two leds on the THr device:

Asso:      blinking until the association to a network is done.

association

Conf:     blinking in the configuration mode.

 

thr_ihm

 

  • A reset button is available to reboot the sensor.
  • A user button is available to enter in configuration mode, « void » frames are then sent every minute for 10 minutes.

Standard reports are not functioning during this mode.

Configuration mode
Way to trigger itOne press on the USER button or specific ZCL command
Way to stop it Another press on the USER button or specific ZCL command
Effects on the sensorThe CONF led (red) blinks (3 sec. OFF, 3 sec. ON) and the sensor sends an uplink frame every minute. The blinking is illustrated below this table.
Time durationThe configuration mode lasts 10 minutes when it is triggered by pressing the USER button

4

  • It is possible to ask a ReAssociation procedure if no down frame is received by the sensor during a given periodicity (4 days by default) or if a given number (100 by default) or failure (no acquittement is received) are reached by sending an applicative frame to the sensor or by the IHM of the sensor.

The sensor keeps the AppEUi and DevAddr configured, Confirmed/Unconfirmed    configuration and all applicative configurations. On the other hand, LoRaWAN configuration (channel, datarate …) are lost.

ReAssociation Mode
Way to trigger itThree short press on the USER button or ZCL command from LoRaWAN cluster.
Effects on the sensorThe ASSO led (green) blinks as the “no commissioned sensor” led lightning.
  • A factory reset is available on nke Watteco’s sensors. It deletes all the applicative settings saved in the flash memory (i.e.: the configured batches and reports will be deleted).

The sensor keeps the AppEUi and DevAddr configured. On the other hand, LoRaWAN configurations (channel, datarate …) and applicative configurations are lost.

Factory reset
Way to trigger ittwo short presses and one long press for approximately 7 seconds on the USER button.
Effects on the sensorThe CONF led (red) and ASSO led (green) blink at the same time briefly. All the applicative settings (about batches and reports) are deleted. The blinking is illustrated below this table.

5

Applicative layer


Codec are available to decode frame: Downloads

The THr device integrates the following clusters:

ClusterCluster nameManaged attributes
0x0000BasicAll
0x0050ConfigurationAll
0x8004LoRaWANAll
0x0402Temperature MeasurementAll
0x0405Relative Humidity MeasurementsAll
0x000cAnalog InputAll
  • The Illuminance is indicated in the Analog Input Cluster in % of a maximal luminosity reached. The value is given by step of 10%.
  • A physical measurement is done every 30 seconds for Temperature and Relative Humidity, 16 seconds for Illuminance, and 10 minutes for level of battery.

Default configuration


A default configuration is set:

  • The device reports each 8 hours the temperature (EndPoint 0 / Cluster Temperature Measurement /Attribut Measuredvalue) and the relative humidity (EndPoint 0 / Cluster Relative Humidity Measurement /Attribut Measuredvalue).

Every change on the default configuration must respect the legal duty cycle. (For example the most restrictive in EU is 0.1%, so in SF12 it is around 1 frame each hour)

Frame examples


All frames have to be sent on the port 125

Standard report

Report

 

Report of the estimate illuminance

→ Applicative payload is: 11 0a 00 0c 00 55 39 41 a0 00 00

41 a0 00 00: present value (single precision =>20)

 

Report of the temperature of the remote sensor

→ Applicative payload is: 11 0a 04 02 00 00 29 00 64

 00 64: Measured value 1°C (Temperature (°C) = Measured value/100)

 

Report of the relative humidity of the remote sensor

→ Applicative payload is: 11 0a 04 05 00 00 21 03 20

03 20: Measured value 8% (Relative humidity (%) = Measured value/100)

 

Configuration

 

Configure a standard report on the temperature

Report immediately the temperature all the 11°C of variation. This measure has to be reported at least each hour.

→The temperature is on the End Point 0, Cluster “Temperature Measurement” is 0x0402, Attribut “MeasuredValue” is 0x0000.

The maximum field has to be 0x0e10 to have a report all one hour and the minimum field has to be 0x0000 to have a report immediately after the right variation.

The delta has to be configured to 1100=0x044c for a report all the 11 °C of variation.

Applicative payload is: 11 06 04 02 00 00 00 29 00 00 0e 10 04 4c

00 00:minimum reporting interval (0 seconds)

0e 10: maximum reporting interval (1 hour)

04 4c: reportable change (11°C)

→Response: 11 07 04 02 00 00 00 00

To disable the previous configuration, change the value of the minimum and maximum sending interval and the delta to 0: 11 06 04 02 00 00 00 29 00 00 00 00 00 00

 

Configure a standard report on the relative humidity

Report immediately the temperature all the 20 % of variation. This measure has to be reported at least 3 hours.

→The relative humidity is on the End Point 0, Cluster “Relative Humidity Measurement” is 0x0405, Attribut “MeasuredValue” is 0x0000.

The maximum field has to be 0x2a30 to have a report every 3 hours and the minimum field has to be 0x0000 to have a report immediately after the right variation.

The delta has to be configured to 2000=0x07d0 for a report all the 20% of variation.

Applicative payload is: 11 06 04 05 00 00 00 21 00 00 2a 30 07 d0

00 00: minimum reporting interval (0 seconds)

2a 30: maximum reporting interval (3 hours)

07 d0: reportable change (20%)

→Response: 11 07 04 05 00 00 00 00

To disable the previous configuration, change the value of the minimum and maximum sending interval and the delta to 0: 11 06 04 05 00 00 00 21 00 00 00 00 00 00

 

Configure a standard report on the illuminance

Report immediately the indication of illuminance all the 10% of variation. This measure has to be reported at least each 15 minutes.

→The indication of illuminance is the End Point 0, Cluster “Analog Input” is 0x000C, Attribut “PresentValue” is 0x0055.

The maximum field has to be 0x800f to have a report all 15 minutes and the minimum field has to be 0x0000 to have a report immediately after the right variation.

The delta has to be configured to 10.0=0x41200000 (type is single precision for a report all the 10% of variation).

Applicative payload is: 11 06 00 0c 00 00 55 39 00 00 80 0f 41 20 00 00

00 00: minimum reporting interval (0 seconds)

80 0f: maximum reporting interval (15 minutes)

41 20 00 00: reportable change (10% of variation)

→Response: 11 07 00 0c 00 00 00 55

To disable the previous configuration, change the value of the minimum and maximum sending interval and the delta to 0: 11 06 00 0c 00 00 55 39 00 00 00 00 00 00 00 00

 

Batch report

Configuration

 

• Configure a batch report on Temperature, Humidity, Illuminance and Battery voltage:

Timestamp and record the temperature with a resolution of 1°C, a value has to be saved at least every 6 hours or on a variation of 1°C.

Timestamp and record the relative Humidity with a resolution of 5%, a value has to be saved at least every 4 hours or on variation of 5%.

Timestamp and record the Illuminance with a resolution of 1%, a value has to be saved at least every 2 hours or on variation of 1%.

Timestamp and record all voltage power sources with a resolution of 0.6V, a value has to be saved at least all the 24 hours. All datas have to be concatenated and sent at maximum all the 24 hours.

→The solution to concatenate several different physical values in the same frame is to use the batch reporting. For the batch it is necessary to know the number of physical measure that will be sent to choose a label for each of them and the size of these labels. There are 2 kinds of power sources in the sensor (Rechargeable battery and Disposable battery). So, with the temperature, the humidity, the illuminance and these 2 power sources, it is necessary to manage 5 different labels.

Number of labelTag labelTag size
1 or 20/11
3 or 400/01/11/102
5 or 6 or 7 or 8000/001/010/011/100/101/110/1113
.........

The Tag Size to use for 5 labels is 3. Label 000 can be used for Temperature, Label 001 for Relative Humidity,  Label 010 for Illuminance,  Label 011 for level of Rechargeable Battery, and Label 100 for level of Disposable Battery. To configure the batch, it is necessary to send a command of “Configure reporting” at each cluster.

For temperature the delta has to be set to 100=0x0064 (1°C), minimum to 30=0x001e (30 seconds), the maximum to 6*60=360=0x8168 (6 hours), and the resolution to 100=0x0064 (1°C). The cluster to report is 0x0402 and the attribut 0x0000 (MeasuredValue).

For relative humidity the delta has to be set to 500=0x01f4 (5%), minimum to 30=0x001e (30 seconds) ,the maximum to 4*60=240=0x80f0 (4 hours), and the resolution to 500=0x01f4 (5%). The cluster to report is 0x0405 and the attribut 0x0000 (MeasuredValue).

For Illuminance the delta has to be set to 1=0x3f800000(1% in single precision), minimum to 0=0x0000 (0 seconds) ,the maximum to 2*60=120=0x8078 (2 hours), the resolution to 1=0x3f800000(1%).

For Rechargeable Battery power sources the delta has to be set to 600=0x0258 (0.6V), minimum to 10=0x800a (10 minutes), the maximum to 24*60=1440=0x85A0 (24 hours), the resolution to 600=0x0258 (0.6V), the field to 3=0x03. The same for Disposable Battery except the field to 4=0x04 (see Node power Descriptor Batch Report Table). The cluster to report is 0x0050 and the attribut 0x0006 (Node power descriptor).

Applicative payload of the temperature

11 06 04 02 15 00 00 00 00 1e 81 68 00 64 00 64 03 

15:  0b00010101 => 0001010: size of configuration string after attribute ID (10 bytes)

00 1e: minimum reporting interval (30 seconds)

81 68: maximum reporting interval (6 hours)

00 64: required delta value (size: 2 bytes for attribute MeasuredValue => attribute type = 29, 1°C)

00 64: required resolution (1°C)

03: tag value (ob00000011 => 00000: tag label, 011: tag size)

→Response: 11 07 04 02 00 01 00 00

 

Applicative payload of the humidity

11 06 04 05 15 00 00 00 00 1e 80 f0 01 f4 01 f4 0b 

15:  0b00010101 => 0001010: size of configuration string after attribute ID (10 bytes)

00 1e: minimum reporting interval (30 seconds)

80 f0: maximum reporting interval (4 hours)

01 f4: required delta value (size: 2 bytes for attribute MeasuredValue => attribute type = 29, 5%)

01 f4: required resolution (5%)

0b: tag value (ob00001011 => 00001: tag label, 011: tag size)

→Response: 11 07 04 05 00 01 00 00

 

Applicative payload of the illuminance

11 06 00 0c 1D 00 55 00 00 00 80 78 00 00 00 64 00 00 00 64 13

1d:  0b00011101 => 0001110: size of configuration string after attribute ID (14 bytes)

00 00: minimum reporting interval (0 seconds)

80 78: maximum reporting interval (2 hours)

3f 80 00 00: required delta value (size: 4 bytes for attribute PresentValue => attribute type = 39)

3f 80 00 00: required resolution 

13: tag value (ob00010011 => 00010: tag label, 011: tag size)

→Response: 11 07 00 0c 00 01 00 55

 

Applicative payload of battery voltage

11 06 00 50 29 00 06 03 80 0a 85 a0 02 58 02 58 1b 04 80 0a 85 a0 02 58 02 58 23 

29: 0b00101001 => 0010100: size of configuration string after attribute ID (20 bytes)

03: index of required field (Rechargeable battery)

80 0a: minimum reporting interval (10 minutes)

85 a0: maximum reporting interval (24 hours)

02 58: required delta value (size: 2 bytes for attribute NodePowerDescriptor => attribute type = 41, 0.6V)

02 58: required resolution (0.6V)

1btag value (ob00011011 => 00011: tag label, 011: tag size)

04: index of required field (Disposable battery)

23: tag value (ob00100011 => 00100: tag label, 011: tag size)

→Response: 11 07 00 50 00 01 00 06

 

To decode the batch reception, use the br_uncompress. Type for Temperature is I16 (7), Type for Illuminance is Float (12) and for others the type is U16 (6), so it is necessary to use this command:

echo « 52000080819504b0c83e8232b40f02050008de1770631300401040ba06d1122b8af9280cd91100802212 » | br_uncompress -a 3 0,100,7 1,500,6 2,1,12 3,600,6  4,600,6 

Result

811 0 2400  # TimeStamp: 811 s     Label 0: Temperature value 24°C
841 0 2600  # TimeStamp: 841 s     Label 0: Temperature value 26°C
811 1 4500  # TimeStamp: 811 s     Label 1: Humidity value    45 %
841 1 9000  # TimeStamp: 841 s     Label 1: Humidity value    90 %
811 2 20    # TimeStamp: 811 s     Label 2: Illuminance value 20 %
841 2 50    # TimeStamp: 841 s     Label 2: Illuminance value 50 %
844 3 0     # TimeStamp: 844 s     Label 3: Rechargeable battery value 0v
840 4 3000  # TimeStamp: 840 s     Label 4: Disposable battery value:  3v

 

 

Print Friendly