Smart_DELTA_P-Technical_Reference_Manual_APP_2.0.4.pdf

<aside> 💡 Applicable for APP versions >= 2.0.2

</aside>

DOCUMENTATION GUIDE

TABLE OF CONTENTS

REGISTERS

1.1 Generic registers

Register Size (bytes) Base Descriptio n 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 Keep alive period 8640 (24h) 2 ... 65535 X 10 seconds
301 2 10 Transmit period and observation windows of data for sensors

20 |     1 ... 360 | ‘Observation windows’, default value 20 samples. Number of backups (history logs) to be done before: ·  Aggregate evaluation and detector analysis ·  sending a frame (thus defining the sending period). | | 308 | 4 | 16 | LED activity | 0x7F | 0 … 0x3FFFF | Default 0x7F, other values: reserved | | 320 | 2 | 10 | History period for Delta Pressure and Analog channel |       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. ·  Additional readings are only used for alarm evaluation. ·  Additional readings are never taken into account by the detector or for aggregate evaluation. | | 321 | 2 | 10 | Sampling period | 15 (30s) | 1 ... 65535 | X 2 seconds | | 325 | 2 | 16 | Delta P sensor, aggregates list |             1 Average | <Bit> 0.     Average 1.     Variance 2.     Standard Deviation 3.     Skewness 4.     Kurtosis 5.     Median 6.     Gradient 7.     Peak counter 8.     Average crossing counter 9.     Min & Max | 0 → Raw data, periodic frame 0x53 ≠ 0 → aggregate data, frame 0x67   Bits<15:13> reserved Bits <11:0> 1 bit per aggregate Bit i = 0 → aggregate OFF Bit i = 1 → aggregate ON   Coding example 0x0083 = means, variance, peak counter variance, pics → Bit 0 = 1 = Moyenne ON → Bit 1 = 1 = variance ON → Bits <2-6> = 0, aggregates 2 to 6 OFF → Bit 7 = 1 = Peak Counter ON → Bit <8-12> = 0, aggregates ≥ 8 OFF |

Register Size (bytes) Base Description Default value Min-Max Value Comments
326 2 16 0-10V sensor, aggregates list
1
Average

Same as 325 | 0 → Raw data, periodic frame 0x55 ≠ 0 → aggregate data, periodic frame 0x67   Same as 325 | | 355 | 2 | 10 | Delta P Sensor, peak delta | 1 | 1-359 | Unit sample Peak detection every ‘n’ samples | | 356 | 2 | 10 | 0-10V sensor, Peak delta | 1 | Same as above | Same as above | | 357 | 2 | 11 | Delta P Sensor, low threshold | -200 | +32767/-32768 | Signed value (unit Pa) | | 358 | 2 | 11 | 0-10V sensor, low threshold | 0 | Same as above | Signed value (unit 1/1000 V) | | 359 | 2 | 11 | Delta P Sensor, high threshold | 30 | +32767/-32768 | Signed value (unit Pa) | | 360 | 2 | 11 | 0-10V sensor, high threshold | 2500 | Same as above | Signed value (unit 1/1000 V) |

Note: In Smart delta P product, Delta pressure and analog channel measurements are always performed synchronously • at the same rate • and with the same number of samples (without oversampling)

1.3 Digital inputs/outputs registers

Register Size (bytes) Base Description Default value Min-Max value Comments
380 1 16 Digital Input/Output 1Configuration

0x00 | <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 4 = Output | | | 381 | 2 | 10 | Digital I/O 1 threshold | 1 | 1 – 65535 | Number of detections before to send the frame | | 382 | 1 | 16 | Digital input/output2 Configuration |         0x00 | <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 4=Output ON | |

383 2 10 Digital I/O 2 threshold 1 1 – 65535 Number of detections before to send the frame alarm
390 4 10 Digital input 1 global counter
0
0 – 232-1 In-RAM counters that
stores all the detected
events 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 | Digital input 2 global counter | 0 | 0 – 232-1 | In-RAM counters that stores all the detected events on the channel

This register is not saved in EEPROM. Its value is therefore set to 0 if the product is not powered anymore | | 392 | 1 | 10 | Digital input 1 output state | 0 (OFF) | 0 (OFF / OPEN) – 1 (ON / CLOSED) | If channel is configured as an output, this register determines its state.

This register is not saved in EEPROM. Its value is therefore set to 0 if the product is not powered anymore | | 393 | 1 | 10 | Digital input 2 output state | 0 (OFF) | 0 (OFF / OPEN) – 1 (ON / CLOSED) | If channel is configured as an output, this register determines its state.

This register is not saved in EEPROM. Its value is therefore set to 0 if the product is not powered anymore |

1.4 Radio registers

LoRaWAN Network Registers

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: 7 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 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
216 LORA APP-KEY (firstpart – 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 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
218 LORA APP-KEY (thirdpart – MID LSB) 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
219 LORA APP-KEY (fourth part – LSB) 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
220 LoRaWAN Options Hexadecimal Default: 5
Bit 0: Activation of the ADR ON(1)/OFF(0)
Bit 1: Reserved
Bit 2: DUTY CYCLE ON(1)/DUTY CYCLE OFF(0)
Bits 3 & 4: Reserved
Bits 5: CLASS C (1)/ CLASS A (0)
Bits 6 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. 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
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:

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:

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.2 | X 1 second Period: 1 minute to 30 days | | 313 | 2 | 10 | Weighting factor for initial authentication attempts | 1 | 1-65535 | V2.1.2 | | | 314 | 1 | 10 | Number of tries for each authentication attempt | 10 | 1-255 | V2.1.2 | |

1.5 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 Note
Sensor, High threshold < Sensor low threshold Aggregate peak unevaluable
peak delta > observation windows Aggregate peak unevaluable
Alarm settings inconsistencyHigh threshold + hysteresis < low threshold + hysteresis NOT SUPPORTED

2. RADIO PROTOCOL

Data with size greater than 1 byte will be transmitted MSB first. In LoRaWAN, frames are sent on port 1. Reminder: Lora Wan 868, max uplink and downlink payload is 51 bytes

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 to 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
Frame Counter (FC) AppFlag2 AppFlag1 HW Low Bat Config
No Error 0x00 to 0x07 0 0 0 0 0
Configuration done 0x00 to 0x07 0 0 0 0 1
Low bat 0x00 to 0x07 0 0 0 1 0
Detector Error 0x00 to 0x07 0 0 1 0 0
AppFlag1 0x00 to 0x07 0 1 0 0 0
AppFlag2 0x00 to 0x07 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: