Adeunis RF EU868 LoRaWAN Product manual

Page 1 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
COMFORT - CO2
Technical Reference Manual
EU868 LoRaWAN / Sigfox RC1
Applicable aux versions >= 2.3.x

Page 2 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
NEW DOCUMENTATION /NOUVELLE DOCUMENTATION
ENGLISH
FRANCAIS
USER GUIDE
•Dedicated to a product
•Cautions & electrical warnings
•Declaration of conformity
•Product functionalities and modes
•Casing dimensions
•Characteristics (casing and electrical)
•LED explanations
•Specific wiring on terminal blocks
•Dédié à un produit
•Recommandations et avertissements
électriques
•Déclaration de conformité
•Fonctionnalités et modes du produit
•Dimensions du boitier
•Caractéristiques (boitier et électrique)
•Explication des LED
•Câblage sur bornier spécifique au
produit
TECHNICAL
REFERENCE
MANUAL
•Dedicated to a product
•Registers content
•Frame explanations (uplink and
downlink)
•Dédié à un produit
•Contenu des registres
•Explication des trames (uplink et
downlink)
INSTALLATION
GUIDE
•For all adeunis® products
•Configuration of the products
•Installation and fixing
•Start-up of the products
•Opening and closing the case
•Replace battery
•Pour tous les produits adeunis®
•Configuration des produits
•Installation et fixation
•Démarrage des produits
•Ouvrir et fermer les boîtiers
•Remplacer la batterie

Page 3 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
TABLE OF CONTENTS
NEW DOCUMENTATION / NOUVELLE DOCUMENTATION ........................................................................................................... 2
TABLE OF CONTENTS .................................................................................................................................................................. 3
1REGISTERS .......................................................................................................................................................................... 4
1.1 GENERIC REGISTERS .................................................................................................................................................................. 4
1.2 APPLICATIVE REGISTERS............................................................................................................................................................. 4
1.2.1 Black-out period .......................................................................................................................................................... 5
1.3 ALARM REGISTERS.................................................................................................................................................................... 5
1.3.1 Temperature ............................................................................................................................................................... 5
1.3.2 Humidity...................................................................................................................................................................... 6
1.3.3 CO2 alarm and QAI indicator ...................................................................................................................................... 6
1.4 DIGITAL INPUTS ....................................................................................................................................................................... 7
1.5 RADIO REGISTERS ..................................................................................................................................................................... 8
1.5.1 LoRaWAN Network Registers...................................................................................................................................... 8
1.5.2 Sigfox Network Registers .......................................................................................................................................... 10
1.6 CO2 CALIBRATION REGISTERS................................................................................................................................................... 10
1.7 COHERENCY CHECK................................................................................................................................................................. 10
2RADIO PROTOCOL............................................................................................................................................................. 11
2.1 STATUS BYTE ......................................................................................................................................................................... 11
2.2 UPLINK FRAME FORMAT.......................................................................................................................................................... 11
2.2.1 Product configuration (0x10) .................................................................................................................................... 11
2.2.2 Digital input configuration (0x1F) ............................................................................................................................. 12
2.2.3 Network configuration (0x20) ................................................................................................................................... 12
2.2.4 Software version (0x37) ............................................................................................................................................ 13
2.2.5 Daily frame (0x30)..................................................................................................................................................... 14
2.2.6 Periodic data frame (0x6A) ....................................................................................................................................... 15
2.2.7 Alarms (0x6B) ............................................................................................................................................................ 16
2.2.8 Button alarm (0x51) .................................................................................................................................................. 17
2.2.9 Digital input (0x52).................................................................................................................................................... 17
2.2.10 ACK (0x2F) ................................................................................................................................................................. 18
2.2.11 Response to Get register request (0x31) ................................................................................................................... 18
2.2.12 Response to Set register request (0x33).................................................................................................................... 19
2.2.13 Transmit conditions................................................................................................................................................... 19
2.3 DOWNLINK FRAME FORMAT..................................................................................................................................................... 20
2.3.1 Get applicative configuration (0x01)......................................................................................................................... 20
2.3.2 Get network configuration (0x02) ............................................................................................................................. 20
2.3.3 Get value (0x05) ........................................................................................................................................................ 20
2.3.4 Start Calibration (0x1A)............................................................................................................................................. 20
2.3.5 Get registers (0x40) ................................................................................................................................................... 21
2.3.6 Set registers (0x41).................................................................................................................................................... 21
2.3.7 Reboot (0x48)............................................................................................................................................................ 22
2.3.8 Set time (0x49) .......................................................................................................................................................... 22

Page 4 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
1 REGISTERS
1.1 Generic registers
Register
Size
(bytes)
Base
Description
Default Value
Range
(Min-Max)
Comments
304
2
10
PIN code
0
(deactivated)
0 - 9999
PIN code used with ATPIN command.
Value 0 disables the PIN code.
306
1
10
Product
mode
0
0: PARK
1: RUN
In PARK mode, product is not using Radio.
In RUN mode, product will send/receive RF
uplinks/downlinks.
1.2 Applicative registers
Register
Size
(bytes)
Base
Description
Default value
Min-Max
Value
Comments
300
2
10
Daily Frame
1
0: Disable
1: Daily
transmission
1: Daily frame sent every 24H
301
2
10
Transmit
period of
data
2 ➔Sigfox
6 ➔LoRa
0 ... 65535
Number of backups (history logs) to be
done before sending a frame (thus defining
the sending period).
The value 0 is equivalent to disabling the
periodic mode.
308
4
16
LED activity
0x3E6006F
0 …
0xFFFFFFFF
Default: 0x3E6006F
Other values: reserved
315
1
10
Time zone
offset
0
-12 … 14
Defines the Time Zone offset from UTC (in
hours).
Must be defined for Daylight Saving Time
management.
316
1
10
Daylight
Saving Time
management
0
0 … 1
Only applicable for European countries.
0: disabled
1: enabled
318
1
10
Time
stamping
0
0 … 1
LoRaWAN only
If enabled, adds a time stamp in data
frames.
0: disabled
1: enabled
319
1
10
RTC
calibration
value
0
-100 … 100
Allows correcting a possible drift of the
clock.
In tenths of a second per day.
320
2
10
History
period
1
1 ... 65535
Number of readings to be performed before
saving in the history logs.
The value 1 is equivalent to 1 backup per
reading
321
2
10
Sampling
period
300 (10 min)
15 ... 65535
0: no sampling
x2 seconds
With S320 = 1 and S301 = 2 ➔72 TX / Day
With S320 = 1 and S301 = 6 ➔24 TX / Day
322
2
10
Alarm
repetition
period
0
0 ... 65535
If an alarm is active, this register allows the
product to send periodically a reminder.
0: no repetition
X sampling period (S321)

Page 5 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
Register
Size
(bytes)
Base
Description
Default value
Min-Max
Value
Comments
323
1
10
Number of
additional
(redundant)
samples
per frame
0
0 ... 15
Number of samples to be repeated in the
next frame
324
1
10
Black out
duration
0
0 –12 (h)
0 ➔blackout feature disable
≠ 0 ➔blackout active, duration of daily
black out.
Unit Hour
325
1
10
Black out
start time
22
0 –23 (h)
Black out start time.
Unit Hour
1.2.1 Black-out period
The device can daily suspend the sensor acquisition and associated processes, using the blackout parameters.
When the blackout interval is entered:
•If a periodic acquisition is in progress (at least one sample has already been acquired), the beginning of the
blackout period is postponed till the periodic acquisition is completed and the associated frame has been sent
(0x6A).
When the blackout period is in progress:
•All features related to sensors are hold (not managed):
oSensor measurements (T/H/CO2) are disabled,
oAlarm and LED indicator not evaluated/transmitted,
oPeriodic frame not transmitted,
oDaily statistic does not register any data during the blackout.
•The following feature are still active / usable during the blackout interval:
oDaily transmission is still active but does not consider the blackout period in the calculation.
oAlarms linked to the connected button or the digital input.
oManual calibration via button or downlink with timestamp
Note: when the blackout is activated, the automatic calibration is not working.
1.3 Alarm registers
1.3.1 Temperature
Register
Size
(bytes)
Base
Description
Default
value
Min-Max value
Comments
330
1
10
Alarm type
0
(inactive)
0: Inactive
1: Low threshold
2: High threshold
3: Both thresholds
331
2
10
High threshold
value
0
-200 … 600
(-20°C to +60°C)
tenth of °C
332
1
10
High threshold
hysteresis
0
0…255
tenth of °C
333
2
10
Low threshold
value
0
-200 … 600
(-20°C to +60°C)
tenth of °C
334
1
10
Low threshold
hysteresis
0
0… 255
tenth of °C

Page 6 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
1.3.2 Humidity
Register
Size
(bytes)
Base
Description
Default
value
Min-Max value
Comments
340
1
10
Alarm type
0
(inactive)
0: Inactive
1: Low threshold
2: High threshold
3: Both thresholds
341
1
10
High threshold
value
0
0 … 100
342
1
10
High threshold
hysteresis
0
0 … 255
343
1
10
Low threshold
value
0
0 … 100
344
1
10
Low threshold
hysteresis
0
0 … 255
1.3.3 CO2 alarm and QAI indicator
Register
Size
(bytes)
Base
Description
Default
value
Min-Max value
Comments
350
1
10
Alarm / indicator
type
2
(LED
indicator)
0: all inactive
1: Alarm activation
2: QAI Led indicator
activation
3: Alarm + QAI Led
activations
351
2
10
CO2 indicator,
Orange LED,
Medium threshold
1000
0 … 10 000
Unit ppm
Below this threshold it is a
level of CO2 considered as
correct (Green LED)
352
2
10
CO2 indicator,
Red LED, high
threshold
1300
0 … 10 000
Unit ppm
Above this threshold it is a
level of CO2 considered as
bad (Red LED)
353
2
10
CO2 alarm
threshold value
1300
400 … 10 000
Unit ppm
354
1
10
CO2 High
threshold
hysteresis
10
0 ... 255
Unit ppm
Co2 alarm frame and CO2 “led” indicator are updated/evaluated each time a CO2 sensor measurement (sampling) is
performed (according to S321 value, sampling period).
Note: CO2 LED indicator is not associated to an alarm frame.
These registers allow to update QAI led repetition period (i.e.: speeding up the led indication or decrease rate to
optimize power consumption).
Register
Size
(bytes)
Base
Description
Default
value
Min-Max value
Comments
Since V02.03.01
377
1
10
QAI green led
repetition
10
1.. 60
Unit Minutes
378
1
10
QAI orange led
repetition
1
1.. 60
Unit Minutes
379
1
10
QAI red led
repetition
1
1.. 60
Unit Minutes

Page 7 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
1.4 Digital inputs
Register
Size
(bytes)
Base
Description
Default
value
Min-Max Value
Comments
380
1
10
Button
configuration
1
0 = Alarm OFF
1 = Alarm ON
Only short press (<500ms)
on the button is considered
as an event Alarm.
381
2
10
Button threshold
1
1 ... 65535
Number of detections before
the alarm is triggered
382
1
16
Configuration of
the digital input
0x00
(deactivated)
<7:4> Debounce
duration
0: no debounce
1: 10 ms
2: 20 ms
3: 50 ms
4: 100 ms
5: 200 ms
6: 500 ms
7: 1 s
8: 2 s
9: 5 s
A: 10 s
B: 20 s
C: 40 s
D: 60 s
E: 5 minutes
F: 10 minutes
<3:0> Type
0 = Deactivated
1 = Event ON
2 = Event OFF
3 = Event ON/OFF
383
2
10
Digital input
threshold
1
1 ... 65535
Number of detections before
the alarm is triggered
390
4
10
Global counter
for button
0
0 –4294967295
Read Only
In-RAM counter that counts
the number of events
detected on the channel
This register is not saved in
EEPROM. Its value is
therefore set to 0 if the
product is not powered
anymore
391
4
10
Global counter
for digital input
0
0 –4294967295

Page 8 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
1.5 Radio registers
1.5.1 LoRaWAN Network Registers
Register
Description
Encoding
Details
201
Spreading Factor (SF)
by default (Read Only)
Decimal
Default: 12
Min/max: 4 to 12
Unit: None
204
Reserved
Hexadecimal
Do not use
214
LORA APP-EUI (first
part –MSB)
Hexadecimal
Default: 0
Key encoded on 16 characters. Each register contains a part
of the key.
Used during the JOIN phase in OTAA mode
E.g.:
APP-EUI = 0018B244 41524632
• S214 = 0018B244
• S215 = 41524632
215
LORA APP-EUI (second
part –MSB)
Hexadecimal
216
LORA APP-KEY (first
part –MSB)
Hexadecimal
Default: 0
Key encoded on 32-byte characters. Each of the 4 registers
contains 8 characters.
Used during the JOIN phase in OTAA mode
E.g.:
APP-KEY = 0018B244 41524632 0018B200 00000912
• S216 = 0018B244
• S217= 41524632
• S218=0018B200
• S219= 00000912
217
LORA APP-KEY
(second part –MID
MSB)
Hexadecimal
218
LORA APP-KEY (third
part –MID LSB)
Hexadecimal
219
LORA APP-KEY (fourth
part –LSB)
Hexadecimal
220
LoRaWAN Options
Hexadecimal
Default: 5
Bit 0: Activation of the ADR ON(1)/OFF(0)
Bit 1: Reserved
Bit 2: DUTYCYCLE ON(1)/DUTYCYCLE OFF(0)
Bits 3 & 4: Reserved
Bits 5 to 7: Reserved
CAUTION:
Deactivation of the Duty Cycle may result in a violation of the
conditions of use of the frequency band, depending on the
use of the device, thus violating the regulations in force.
In the case of disabling the Duty Cycle, liability is transferred
to the user.
221
Mode of activation
Decimal
Default: 1
Choice: (see NOTE 1 after the table)
• 0: ABP
• 1: OTAA
222
LORA NWK_SKEY (first
part –MSB)
Hexadecimal
Default: 0
Parameter encoded on 16 bytes. Each of the 4 registers
contains 4 bytes.
223
LORA NWK_SKEY
(second part - MID MSB)
Hexadecimal
224
LORA NWK_SKEY
(third part - MID LSB)
Hexadecimal
225
LORA NWK_SKEY
(fourth part –LSB)
Hexadecimal
226
LORA APP_SKEY (first
part –MSB)
Hexadecimal
Default: 0
Parameter encoded on 16 bytes, each register with 4 bytes.
227
LORA APP_SKEY
(second part - MID MSB)
Hexadecimal

Page 9 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
228
LORA APP_SKEY (third
part - MID LSB)
Hexadecimal
229
LORA APP_SKEY
(fourth part –LSB)
Hexadecimal
280
NETWORK ID
Hexadecimal
Default: 0 Read only
281
DEVICE ADDRESS
Hexadecimal
Default: 0
NOTE 1: The “Over The Air Activation” (OTAA) mode uses a JOIN phase before being able to transmit on the
network. This mode uses the APP_ EUI (S214 and S215) and APP_KEY (S216 to S219) codes during this phase to
create the keys for network communication. Once this phase is completed, the codes APP_sKEY, NWK_sKEY and
DEVICE ADDRESS will be present in the corresponding registers. A new JOIN phase is started every time the device
exits Command mode, a reset is performed, or the device is turned on.
Codes:
• APP_EUI identifier for global use (provided by default by adeunis®)
• APP_KEY device application key (provided by default by adeunis®)
The “Activation by personalization” (ABP) mode has no JOIN phase; it transmits directly on the network using the
codes NWK_sKEY (S222 to S225), APP_sKEY (S226 to S229) and DEVICE ADDRESS (S281) to communicate.
Codes:
• NWK_sKEY network session key (provided by default by adeunis®)
• APP_KEY applicative session key (provided by default by adeunis®)
• DEVICE ADDRESS Address of the device in the network (provided by default by adeunis®)
Register
Size
(bytes)
Base
Description
Default
Value
Range
(Min-Max)
Minimum
required
Application
version
Comments
303
1
10
LoRaWAN
Confirmed mode
0
0-1
V1.2.0
0: deactivation
1: activation
312
4
10
Maximum delay
between 2
authentication
attempts
43200
(12h)
60-2592000
V2.1.0
X 1 second
Period: 1 minute to 30
days
313
2
10
Weighting factor
for initial
authentication
attempts
1
1-65535
V2.1.0
314
1
10
Number of tries
for each
authentication
attempt
10
1-255
V2.1.0

Page 10 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
1.5.2 Sigfox Network Registers
Register
Size
(bytes)
Base
Description
Default
Value
Range
(Min-
Max)
Minimum
required
Application
version
Comments
307
2
10
Sigfox
Downlink
period
1440
(24h)
0-65535
>= V2.0.0
X 1 minute
Period : 1 min to 45 days
317
1
10
Sigfox
DutyCycle
1
0-1
V1.2.0
0 : dutycycle activated
1 : dutycycle deactivated
Not displayed anymore in
LoRaWAN since 2.0.0
1.6 CO2 Calibration registers
Register
Size
(bytes)
Base
Description
Default
Value
Range
(Min-Max)
Minimum
required
Applicatio
n version
Comments
355
2
10
Calibration
Reference
Level
400
200-2000
>= V2.3.0
0 ➔Factory calibration
[200-2000] ➔use as target value
when a calibration is performed
S356
2
10
Automatic
calibration
activation /
deactivation
1
0-1
>= V2.3.0
0: Automatic calibration
deactivated
1: Automatic calibration activated
1.7 Coherency check
A configuration coherency check is made at the time of the backup.
Cases where backups are refused because considered as inconsistent:
Cases refused
Description
(S330 = 3) && (S333 > S331)
TEMPERATURE: Low threshold > High threshold
(S330 = 3) && ((S333 + S334) >
(S331 - S332))
TEMPERATURE: (Low threshold + Low hysteresis) > (High
threshold - High hysteresis)
(S340 = 3) && (S343 > S341)
HUMIDITY: Low threshold > High threshold
(S340 = 3) && ((S343 + S344) >
(S341 - S342))
HUMIDITY: (Low threshold + Low hysteresis) > (High threshold -
High hysteresis)
(S340 = 1) && ((S344 + S343) > 100)
HUMIDITY: (Low threshold + Low hysteresis) > 100
(S340 = 2) && (S342 > S341)
HUMIDITY: High hysteresis > High threshold
(S351<S352)
CO2: inconsistent QAI limit

Page 11 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2 RADIO PROTOCOL
Data with size greater than 1 byte will be transmitted MSB first.
In LoRaWAN, frames are sent on port 1.
2.1 Status byte
All frames sent by the product contain a status byte. Its format is identical for all IoT Adeunis products.
Alarm Status
Bit 7
Bit 6
Bit 5
Bit 4
Bit 3
Bit 2
Bit 1
Bit 0
Frame Counter
AppFlag2
AppFlag1
Timestamp
Low Bat
Config
No Error
0x00 to 0x07
0
0
0
0
0
Configuration
done
0
0
0
0
1
Low bat
0
0
0
1
0
Timestamp
0
0
1
0
0
AppFlag1
0
1
0
0
0
AppFlag2
1
0
0
0
0
The status byte provides two bits reserved for a specific use of each product (AppFlag1 and AppFlag2).
For this product:
-AppFlag1: configuration inconsistency
oSamples lost in periodic data frame because the payload is not sufficient.
oBlackout is activated and the automatic calibration is not deactivated.
2.2 Uplink Frame format
2.2.1 Product configuration (0x10)
This frame is sent following the reception of a frame with code 0x01, or at the start of the product.
Offset
(in byte)
Data
Description
0
0x10
Frame code
1
Status
Status byte
2-3
S300
Daily frame transmission
0: Deactivated
1: Activated
4-5
S301
Transmission period of the periodic frame
6-7
S320
History period
8-9
S321
Sampling period
10
S323
Number of additional (redundant) samples per
frame
11
S324
Black out duration (0: Disable), unit hour
12
S325
Blackout start time (0h-23h)
Decoding example:
Offset
(in byte)
Data
Description
0
0x10
Frame code
1
0x00
Frame counter: 0
Bit1@0: no LowBat
2-3
0x0001
Daily frame activated
4-5
0x0001
1
6-7
0x0001
1
8-9
0x0708
1800 => 1800 x 2s = 3600s = 1h

Page 12 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
10
0x00
No redundancy
2.2.2 Digital input configuration (0x1F)
This frame is sent following the start of the product (except when it is a reboot after a downlink).
Offset
(in byte)
Data
Description
0
0x1F
Frame code
1
Status
Status byte
2
S380
Configuration Button
3-4
S381
Alarm threshold Button
5
S382
Configuration Digital input
6-7
S383
Alarm threshold Digital input
Decoding example:
Offset
(in byte)
Data
Description
0
0x1F
Frame code
1
0xA0
Status byte
2
0x01
Button activated
3-4
0x0001
Alarm button sent after 1 detection
5
0x21
Digital input: 20 ms debounce, Event ON
6-7
0x0001
Alarm Digital input sent after 1 event
2.2.3 Network configuration (0x20)
This frame is sent following the reception of a frame with code 0x02, or at the start of the product.
2.2.3.1 LoRaWAN 868
Offset
(in byte)
Data
Description
0
0x20
Frame code
1
Status
Status byte
2
S220
LoRaWAN options
Bit 0: Activation of the ADR ON(1)/OFF(0)
Bit 1: Reserved
Bit 2: DUTYCYCLE ON(1)/DUTYCYCLE OFF(0)
Bits 3 & 4: Reserved
Bit 5: CLASS A (0)
Bits 6 to 7: Reserved
3
S221
Provisioning mode (0: ABP, 1:OTAA)
Decoding example:
Offset
(in byte)
Data
Description
0
0x20
Frame code
1
0x20
Frame counter: 1
Bit1@0: no LowBat
2
0x05
CLASS A
Dutycycle activated
ADR ON
3
0x01
OTAA

Page 13 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.3.2 Sigfox RC1
Offset
(in byte)
Data
Description
0
0x20
Frame code
1
Status
Status byte
2
S202
Retry count
3-4
S307
Downlink period
Decoding example:
Offset
(in byte)
Data
Description
0
0x20
Frame code
1
0x20
Frame counter: 1
Bit1@0: no LowBat
2
0x02
2 retries
3-4
0x05A0
1440 (24h)
2.2.4 Software version (0x37)
This frame is sent at the start of the product only if KARE+ is enabled.
Offset
(in byte)
Data
Description
0
0x37
Frame code
1
Status
Status byte
2-4
APP version
Byte 5 : MAJOR
Byte 6 : MINOR
Byte 7 : PATCH
5-7
RTU version
Byte 5 : MAJOR
Byte 6 : MINOR
Byte 7 : PATCH
Decoding example:
Offset
(in byte)
Data
Description
0
0x37
Frame code
1
0x20
Frame counter: 1
Bit1@0: no LowBat
2-4
0x020100
APP v2.2.0
5-7
0x020001
RTU v2.0.1

Page 14 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.5 Daily frame (0x30)
This frame is sent every 24 hours or following the reception of a frame with code 0x05
In this frame, all information based on sensor acquisition are evaluated on measurements (samples) done over the
past 24h. If a blackout is activated, the daily frame calculations are based on the active hours.
CAUTION: For SIGFOX all information cannot be transmitted; Only PART 1 is sent.
Offset
(in byte)
Data
Description
LoRaWAN
SigFox
0
0x30
Frame code
All
information
PART1
1
Status
Status byte
2
ICONE
ICONE indicator (0-5)
3
QAI red duration
In 10 minutes (min 0, max 144 ➔
144x10=24h)
Duration above QAI red indicator
4-5
T° Max
In tenth of °C
6-7
CO2 Max
In ppm
8
H° Max
In %
9-10
T°Min
1/10 °C
11-12
CO2 Min
ppm
Not
provided
13
H°Min
%
14-15
T° Average
1/10 °C
16-17
CO2 Average
ppm
18
H° Average
%
Timestamp
Timestamp of the last measure in
EPOCH 2013 format.
Not
provided

Page 15 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.6 Periodic data frame (0x6A)
The measure frequency is defined by: S321 * S320
The sending frequency is defined by: S321 * S320 * S301
The number of samples per channel is defined by: (S301 + S323)
Maximum number of samples per frame:
•LoRaWAN 868: 9 samples (with or without time stamping)
•Sigfox RC1: 2 samples
Offset
(in byte)
Data
Description
0
0x6A
Frame code
1
Status (AppFlag2 = 0)
Status byte
2-3
T°(t0)
In tenth of °C
4
H(t0)
In %
5-6
CO2 (t0)
In ppm
7-8
T°(t-1)
…
9
H(t-1)
…
10-11
CO2 (t-1)
…
11-12
T°(t-2)
…
13
H(t-2)
14-15
CO2 (t-2)
16-17
T°(t-3)
18
H(t-3)
…
…
Timestamp
Only for LoRaWAN product with timestamping
enabled.
Timestamp of the last measure in EPOCH 2013
format.
Decoding example:
Offset
(in byte)
Data
Description
0
0x6A
Frame code
1
0x80
Frame counter: 4
Bit1@0: LowBat not detected
2-3
0x01B3
435 => 43.5°C for t=0
4
0x3E
62 => 62% for t=0
5-6
0x01A4
420 ➔420 ppm for t0

Page 16 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.7 Alarms (0x6B)
This frame is sent during the appearance, or disappearance, of a threshold exceeding alarm.
Offset
(in byte)
Data
Description
0
0x6B
Frame code
1
Status (AppFlag2 = 0)
Status byte
2
Alarm status
Bit 5: CO2
0: alarm is not active
1: alarm is active
Bit 4: Temperature
0: alarm is not active
1: alarm is active
Bit 0: Humidity
0: alarm is not active
1: alarm is active
3-4
Temperature
In tenth of °C
5
Humidity
In %
6-7
CO2
In ppm
Timestamp
Only for LoRaWAN product with timestamping
enabled.
Timestamp of the frame in EPOCH 2013 format
Decoding example:
Offset
Data
Description
0
0x6B
Frame code
1
0x80
Frame counter: 4
Bit1@0: LowBat not detected
2
0x10
Bit5@1: Alarm CO2 is active
Bit4@1: Alarm Temperature is active
Bit0@0: Alarm Humidity is not active
3-4
0x0246
582 => 58.2°C
5
0x32
50 => 50%
6-7
0x01A4
420 ➔420 ppm

Page 17 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.8 Button alarm (0x51)
This frame is sent when the number of detected events exceeds the threshold.
Offset
(in byte)
Data
Description
0
0x51
Frame code for button
1
Status
Status byte
2
Alarm state
Precisely define the input state.
<0> Current state
<1> State in the previous frame
3-6
Global counter
Global counter of detected events
7-8
Instant counter
Number of events detected since the last alarm
Timestamp
Only for LoRaWAN product with timestamping
enabled. Timestamp of the last input state change
in EPOCH 2013 format.
Decoding example:
Offset
Data
Description
0
0x51
Frame code
1
0x80
Frame counter: 4, Bit1@0: LowBat not detected
2
0x01
Bit0@1 => Current state: ON/CLOSED
Bit1@0 => Previous state: OFF/OPENED
3-6
0x000001230
0x1230 => 4656 events detected since the device
is in production mode
7-8
0x0003
3 events detected since the last alarm sending
2.2.9 Digital input (0x52)
This frame is sent when the number of detected events exceeds the threshold.
Offset
(in byte)
Data
Description
0
0x52
Frame code for digital input
1
Status
Status byte
2
Alarm state
Precisely define the input state.
(ON/CLOSED : 1, OFF/OPEN : 0)
<0> Current state
<1> State in the previous frame
3-6
Global counter
Global counter of detected events
7-8
Instant counter
Number of events detected since the last alarm
Timestamp
Only for LoRaWAN product with timestamping
enabled. Timestamp of the last input state change
in EPOCH 2013 format.
Decoding example:
Offset
Data
Description
0
0x52
Frame code
1
0x80
Frame counter: 4
Bit1@0: LowBat not detected
2
0x01
Bit0@1 => Current state: ON/CLOSED
Bit1@0 => Previous state: OFF/OPENED
3-6
0x000001230
0x1230 => 4656 events detected since the device
is in production mode
7-8
0x0003
3 events detected since the last alarm sending

Page 18 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.10 ACK (0x2F)
This uplink is sent when a downlink 0x1A (calibration) or 0x48 (reboot) or 0x49 (set time) is received.
Offset
(in byte)
Data
Description
0
0x2F
Frame code
1
Status
Status byte
2
Downlink Framecode
Indicate which downlink has generated this uplink
3
Request status
-0x00: N/A
-0x01: success
-0x02: error - generic
-0x03: error –wrong state
-0x04: error –invalid request
-Other: reserved for future
Decoding example:
Offset
(in byte)
Data
Description
0
0x2F
Frame code
1
0x20
Frame counter: 1
Bit1@0: no LowBat
2
0x49
This ACK concerns last received 0x49 request
3
0x01
success
2.2.11 Response to Get register request (0x31)
Following reception of a downlink frame with the code 0x40, the frame 0x31 is transmitted. It contains all the values of
the registers requested in the downlink frame 0x40.
Offset
(in byte)
Data
Description
0
0x31
Frame code
1
Status
Status byte
2-3
Value 1
If value 1 is a 2-byte register
4
Value 2
If value 2 is a 1-byte register
5-8
Value 3
If value 3 is a 4-byte register
…
If an error is detected in the request, the returned 0x31 frame will be empty.
Note: the size of the data registers is variable depending on the register number. Refer to the list of registers to
determine the size of each one and to deduce the total size of the data returned by the 0x31 frame.
Decoding example:
Offset
(in byte)
Data
Description
0
0x31
Frame code
1
0x80
Frame counter: 4
Bit1@0: LowBat not detected
2-3
0x1234
4660 (considering that value 1 is a 2-byte register)
4
0xFF
255 (considering that value 2 is a 1-byte register)
5-8
0x00000000
0 (considering that value 3 is a 4-byte register)
…

Page 19 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.2.12 Response to Set register request (0x33)
Following reception of a downlink frame with the code 0x41, the frame 0x33 is transmitted. It shows whether the
downlink frame (0x41) has been received and gives information on the support status of the latter.
Offset
(in byte)
Data
Description
0
0x33
Frame code
1
Status
2
Request status
-0x00 : N/A
-0x01 : success
-0x02 : success –no update (value to set is the current register value)
-0x03 : error –coherency
-0x04 : error –invalid register
-0x05 : error –invalid value
-0x06 : error –truncated value
-0x07 : error –access not allowed
-0x08 : error –other reason
3-4
Register Id
Indicates to the user the register that caused the error (only if “Request Status” is
different from 0x01).
CAUTION: if the request 0x41 concerns several registers, the device will stop the analysis of the Downlink request at
the first error and will send the Status frame with the reason and the identifier of the register concerned.
In the event of an error, if a partial reconfiguration has taken place before the error was detected, the device restarts
and returns to its last valid configuration. As a result, you will have to configure the device again with the new data.
Decoding example:
Offset
(in byte)
Data
Description
0
0x33
Frame code
1
0x80
Frame counter: 4
Bit4@0: 1 sensor activated
Bit1@0: LowBat not detected
2
0x04
invalid register
3-4
0x0140
320: register S320 does not exist (should be S3XX)
2.2.13 Transmit conditions
Frame
code
Description
Sending conditions
0x10
Status (configuration)
•Product start up
•Exit configuration mode (AT command)
•Reception of frame 0x01 (get product
config)
0x20
Network configuration
•Product start up
•Exit configuration mode (AT command)
•Reception of frame 0x02 (get network
config)
0x30
Keep alive
•Periodically, every 24H
•Reception of frame 0x05 (get value)
0x6A
Periodic data
•Periodically
0x6B
Alarm
•Threshold crossing

Page 20 / 22
adeunis®
Manage & optimize your assets & services
283, rue louis Néel 38920 CROLLES, France
Tél : [phone] E-mail : [e-mail]
www.adeunis.com
2.3 Downlink Frame format
2.3.1 Get applicative configuration (0x01)
Offset
(in byte)
Data
Description
0
0x01
Frame code
When the device receives the downlink, it will generate a product configuration frame (0x10).
2.3.2 Get network configuration (0x02)
Offset
(in byte)
Data
Description
0
0x02
Frame code
When the device receives the downlink, it will generate a network configuration frame (0x20).
2.3.3 Get value (0x05)
Offset
(in byte)
Data
Description
0
0x05
Frame code
When the device receives the downlink, it will generate a KEEP ALIVE frame (0x30) with instant measured
temperatures.
2.3.4 Start Calibration (0x1A)
This frame (0x1A) allows you to start a calibration.
Offset
(in byte)
Data
Description
0
0x1A
Frame code
1-2
Reference
Level in ppm
0: Calibration performed with (S355) register value (400 by default)
200-2000 ppm: Calibration performed with the specified value.
FFFF: restore factory calibration
3-6
Date / time
use for
calibration
0xFFFFFFFF ➔calibration started on downlink reception.
Date / time (EPOCH2013 format). ➔Calibration started when date
reached (See Note 1).
Note: If date / time has already expired when receiving the downlink,
the calibration is started on reception.
Date / time is valid from 2020/01/01 00:00:00 to 2089/12/31 23:59:59
Following the sending of the downlink 0x1A, an uplink ACK (0x2F) is sent.
Note 1: a programmed “Date / time calibration”is cancelled / superseded if a manual calibration is performed while the
target datetime is not reached.
Coding example:
Offset
(in byte)
Data
Description
0
0x1A
Frame code
1-2
0
Use S355 register value (by default 400ppm)
3-6
0x0E38F5AC
2020-07-24 17:38:52