Hide last authors
Xiaoling 151.2 1
2
Ellie Zhang 114.1 3 (% style="text-align:center" %)
Xiaoling 158.2 4 [[image:image-20240104115255-13.png]]
Xiaoling 6.2 5
Xiaoling 158.2 6 (% style="display:none" %) (%%)
Xiaoling 6.2 7
8
Xiaoling 151.2 9
Ellie Zhang 115.1 10
Xiaoling 150.2 11
12
kai 117.1 13 **Table of Contents:**
Ellie Zhang 110.1 14
Xiaoling 42.4 15 {{toc/}}
Xiaoling 6.2 16
17
18
Xiaoling 42.5 19
20
21
kai 116.1 22 = 1. Introduction =
Xiaoling 6.2 23
Xiaoling 158.4 24 == 1.1 What is D2x-LB/LS LoRaWAN Temperature Sensor ==
Xiaoling 9.2 25
Xiaoling 121.3 26
Xiaoling 158.4 27 The Dragino D2x-LB/LS is a (% style="color:blue" %)**LoRaWAN Temperature Sensor**(%%) for Internet of Things solution. D2x-LB/LS has 1 ~~ 3 temperature probes. D2x-LB/LS will convert the Temperature reading to LoRaWAN wireless data and send to IoT platform via LoRaWAN gateway.
Xiaoling 72.5 28
Xiaoling 158.4 29 The LoRa wireless technology used in D2x-LB/LS allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
Xiaoling 6.2 30
Xiaoling 158.4 31 The temperature sensor used in D2x-LB/LS can (% style="color:blue" %)**measure -55°C ~~ 125°C with accuracy ±0.5°C (max ±2.0 °C)**(%%).
Xiaoling 6.2 32
Xiaoling 158.4 33 D2x-LB/LS supports (% style="color:blue" %)**temperature alarm feature**(%%), user can set temperature alarm for instant notice. D2x-LB/LS supports Datalog feature, it can save the data when there is no LoRaWAN network and uplink when network recover.
Edwin Chen 63.1 34
Xiaoling 158.4 35 D2x-LB/LS has max 3 probes which measure maximum 3 temperature points.
Edwin Chen 63.1 36
Xiaoling 158.4 37 D2x-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
Edwin Chen 63.1 38
Xiaoling 158.6 39 D2x-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + li-on battery**(%%) it is designed for long term use up to 5 years.
Xiaoling 6.2 40
Xiaoling 158.4 41 Each D2x-LB/LS is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
Xiaoling 6.2 42
43
kai 116.1 44 == 1.2 ​Features ==
Edwin Chen 64.1 45
Xiaoling 121.3 46
kai 116.1 47 * LoRaWAN 1.0.3 Class A
48 * Ultra-low power consumption
49 * 1 ~~ 3 External Temperature Probes
50 * Measure range -55°C ~~ 125°C
51 * Temperature alarm
52 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
53 * Support Bluetooth v5.1 and LoRaWAN remote configure
Xiaoling 6.2 54 * Support wireless OTA update firmware
55 * Uplink on periodically
56 * Downlink to change configure
Xiaoling 158.4 57 * 8500mAh Li/SOCl2 Battery (D2x-LB)
58 * Solar panel + 3000mAh Li-on battery (D2x-LS)
Xiaoling 6.2 59
Xiaoling 9.2 60 == 1.3 Specification ==
61
62
Xiaoling 42.17 63 (% style="color:#037691" %)**Common DC Characteristics:**
Xiaoling 6.2 64
Xiaoling 158.5 65 * Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
Xiaoling 6.2 66 * Operating Temperature: -40 ~~ 85°C
67
Edwin Chen 64.1 68 (% style="color:#037691" %)**Temperature Sensor:**
69
70 * Dallas DS18B20
71 * Range: -55 to + 125°C
72 * Accuracy ±0.5°C (max ±2.0 °C).
73
Xiaoling 42.17 74 (% style="color:#037691" %)**LoRa Spec:**
Xiaoling 6.2 75
76 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
77 * Max +22 dBm constant RF output vs.
78 * RX sensitivity: down to -139 dBm.
79 * Excellent blocking immunity
80
Xiaoling 42.17 81 (% style="color:#037691" %)**Battery:**
Xiaoling 6.2 82
83 * Li/SOCI2 un-chargeable battery
84 * Capacity: 8500mAh
85 * Self-Discharge: <1% / Year @ 25°C
86 * Max continuously current: 130mA
87 * Max boost current: 2A, 1 second
88
Xiaoling 42.17 89 (% style="color:#037691" %)**Power Consumption**
Xiaoling 6.2 90
91 * Sleep Mode: 5uA @ 3.3v
92 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
93
Edwin Chen 65.1 94 == 1.4 Sleep mode and working mode ==
Xiaoling 6.2 95
96
Xiaoling 42.17 97 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
Xiaoling 6.2 98
Xiaoling 42.17 99 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
Xiaoling 6.2 100
101
Edwin Chen 65.1 102 == 1.5 Button & LEDs ==
Xiaoling 6.2 103
104
Xiaoling 14.2 105 [[image:1675071855856-879.png]]
Xiaoling 6.2 106
107
Xiaoling 98.3 108 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 109 |=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 225px;background-color:#4F81BD;color:white" %)**Action**
Xiaoling 42.32 110 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
Xiaoling 42.17 111 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
Xiaoling 6.2 112 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
113 )))
Xiaoling 42.32 114 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
Xiaoling 42.17 115 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
116 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 6.2 117 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
118 )))
Xiaoling 158.7 119 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means D2x-LB/LS is in Deep Sleep Mode.
Xiaoling 6.2 120
Edwin Chen 65.1 121 == 1.6 BLE connection ==
Xiaoling 6.2 122
123
Xiaoling 158.7 124 D2x-LB/LS support BLE remote configure.
Xiaoling 6.2 125
126
127 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
128
129 * Press button to send an uplink
130 * Press button to active device.
131 * Device Power on or reset.
132
133 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
134
Edwin Chen 69.1 135
Saxer Lin 124.2 136 == 1.7 Pin Definitions ==
Xiaoling 6.2 137
Saxer Lin 143.1 138 [[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230610163213-1.png?width=699&height=404&rev=1.1||alt="image-20230610163213-1.png"]]
Xiaoling 6.2 139
Saxer Lin 124.2 140
141 == 1.8 Hardware Variant ==
142
143
Xiaoling 136.4 144 (% border="1" cellspacing="5" style="width:510px" %)
Xiaoling 158.11 145 |=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 190px;background-color:#4F81BD;color:white" %)Photo|=(% style="width: 218px;background-color:#4F81BD;color:white" %)Probe Info
Xiaoling 140.2 146 |(% style="width:102px" %)D20-LB|(% style="width:190px" %)(((
147 (% style="text-align:center" %)
148 [[image:image-20230526153320-2.jpeg]]
149 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 150 1 x DS28B20 Probe
Xiaoling 6.2 151
Edwin Chen 68.1 152 Cable Length : 2 meters
Edwin Chen 70.1 153
Edwin Chen 71.1 154
Edwin Chen 70.1 155 )))
Xiaoling 140.2 156 |(% style="width:102px" %)D20S-LB|(% style="width:190px" %)(((
157 (% style="text-align:center" %)
158 [[image:image-20230526150859-1.jpeg]]
159 )))|(% style="width:297px" %)(((
Edwin Chen 119.1 160 1 x DS28B20 Probe (Suitable for bury in soil)
161
162 Material: TPE, Cable Length: 2meters
163 )))
Xiaoling 140.2 164 |(% style="width:102px" %)D22-LB|(% style="width:190px" %)(((
165 (% style="text-align:center" %)
166 [[image:image-20230526153345-3.jpeg]]
167 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 168 2 x DS28B20 Probes
169
170 Cable lengths total 1.5meters per probe
171
172 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K21G-210811.pdf]]
Edwin Chen 70.1 173 )))
Edwin Chen 71.1 174 |(% style="width:102px" %)(((
Xiaoling 98.3 175 (((
176 D23-LB
177 )))
178
179 (((
180
181 )))
Xiaoling 140.2 182 )))|(% style="width:190px" %)(((
183 (% style="text-align:center" %)
184 [[image:image-20230526153417-4.jpeg]]
185 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 186 3 x DS28B20 Probes
187
188 Cable lengths total 1.5meters per probe
189
190 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K31G-210811.pdf]]
Edwin Chen 70.1 191 )))
Edwin Chen 68.1 192
193 (% style="display:none" %)
194
195
Xiaoling 72.5 196
Saxer Lin 124.2 197 == 1.9 Mechanical ==
Edwin Chen 68.1 198
199
Xiaoling 17.2 200 [[image:1675143884058-338.png]]
Xiaoling 6.2 201
202
Xiaoling 26.2 203 [[image:1675143899218-599.png]]
Xiaoling 6.2 204
205
Xiaoling 26.2 206 [[image:1675143909447-639.png]]
Xiaoling 6.2 207
Xiaoling 26.2 208
Xiaoling 158.7 209 = 2. Configure D2x-LB/LS to connect to LoRaWAN network =
Xiaoling 26.2 210
211 == 2.1 How it works ==
212
213
Xiaoling 158.7 214 The D2x-LB/LS is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the D2x-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
Xiaoling 6.2 215
216
Xiaoling 26.2 217 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
218
219
Xiaoling 6.2 220 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
221
222 The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
223
224
Xiaoling 158.7 225 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB/LS.
Xiaoling 6.2 226
Xiaoling 158.7 227 Each D2x-LB/LS is shipped with a sticker with the default device EUI as below:
Xiaoling 6.2 228
Ellie Zhang 114.1 229 [[image:image-20230426084024-1.png||alt="图片-20230426084024-1.png" height="236" width="508"]]
Xiaoling 6.2 230
231
232 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
233
234
Xiaoling 42.17 235 (% style="color:blue" %)**Register the device**
Xiaoling 6.2 236
Xiaoling 26.2 237 [[image:1675144099263-405.png]]
Xiaoling 6.2 238
239
Xiaoling 42.17 240 (% style="color:blue" %)**Add APP EUI and DEV EUI**
Xiaoling 6.2 241
Xiaoling 26.2 242 [[image:1675144117571-832.png]]
Xiaoling 6.2 243
244
Xiaoling 42.17 245 (% style="color:blue" %)**Add APP EUI in the application**
Xiaoling 6.2 246
247
Xiaoling 26.2 248 [[image:1675144143021-195.png]]
Xiaoling 6.2 249
250
Xiaoling 42.17 251 (% style="color:blue" %)**Add APP KEY**
Xiaoling 6.2 252
Xiaoling 26.2 253 [[image:1675144157838-392.png]]
Xiaoling 6.2 254
Xiaoling 158.7 255 (% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB/LS
Xiaoling 6.2 256
257
Xiaoling 158.7 258 Press the button for 5 seconds to activate the D2x-LB/LS.
Xiaoling 6.2 259
Xiaoling 42.17 260 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 6.2 261
262 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
263
264
Xiaoling 27.2 265 == 2.3 ​Uplink Payload ==
Xiaoling 6.2 266
Xiaoling 27.2 267 === 2.3.1 Device Status, FPORT~=5 ===
Xiaoling 6.2 268
269
Xiaoling 158.7 270 Users can use the downlink command(**0x26 01**) to ask D2x-LB/LS to send device configure detail, include device configure status. D2x-LB/LS will uplink a payload via FPort=5 to server.
Xiaoling 6.2 271
Edwin Chen 72.1 272 The Payload format is as below.
Xiaoling 6.2 273
Xiaoling 98.9 274 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 275 |(% colspan="6" style="background-color:#4F81BD;color:white" %)**Device Status (FPORT=5)**
Xiaoling 42.32 276 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
277 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
Xiaoling 6.2 278
279 Example parse in TTNv3
280
Saxer Lin 136.1 281 [[image:image-20230524160021-1.png||height="149" width="1193"]]
Xiaoling 6.2 282
283
Xiaoling 158.7 284 (% style="color:#037691" %)**Sensor Model**(%%): For D2x-LB/LS, this value is 0x19
Xiaoling 6.2 285
Xiaoling 42.17 286 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
Xiaoling 6.2 287
Xiaoling 42.17 288 (% style="color:#037691" %)**Frequency Band**:
Xiaoling 6.2 289
Xiaoling 144.2 290 0x01: EU868
Xiaoling 6.2 291
Xiaoling 144.2 292 0x02: US915
Xiaoling 6.2 293
Xiaoling 144.2 294 0x03: IN865
Xiaoling 6.2 295
Xiaoling 144.2 296 0x04: AU915
Xiaoling 6.2 297
Xiaoling 144.2 298 0x05: KZ865
Xiaoling 6.2 299
Xiaoling 144.2 300 0x06: RU864
Xiaoling 6.2 301
Xiaoling 144.2 302 0x07: AS923
Xiaoling 6.2 303
Xiaoling 144.2 304 0x08: AS923-1
Xiaoling 6.2 305
Xiaoling 144.2 306 0x09: AS923-2
Xiaoling 6.2 307
Xiaoling 144.2 308 0x0a: AS923-3
Xiaoling 6.2 309
Xiaoling 144.2 310 0x0b: CN470
Xiaoling 6.2 311
Xiaoling 144.2 312 0x0c: EU433
Xiaoling 6.2 313
Xiaoling 144.2 314 0x0d: KR920
Xiaoling 6.2 315
Xiaoling 144.2 316 0x0e: MA869
Xiaoling 6.2 317
318
Xiaoling 42.17 319 (% style="color:#037691" %)**Sub-Band**:
Xiaoling 6.2 320
321 AU915 and US915:value 0x00 ~~ 0x08
322
323 CN470: value 0x0B ~~ 0x0C
324
325 Other Bands: Always 0x00
326
327
Xiaoling 42.17 328 (% style="color:#037691" %)**Battery Info**:
Xiaoling 6.2 329
330 Check the battery voltage.
331
332 Ex1: 0x0B45 = 2885mV
333
334 Ex2: 0x0B49 = 2889mV
335
336
Edwin Chen 73.1 337 === 2.3.2  Sensor Data. FPORT~=2 ===
Xiaoling 6.2 338
339
Xiaoling 158.7 340 D2x-LB/LS will uplink below payload via FPORT=2 after Joined LoRaWAN Network.
Xiaoling 6.2 341
Xiaoling 158.11 342 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
343 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
Xiaoling 98.16 344 **Size(bytes)**
Xiaoling 158.11 345 )))|=(% style="width: 42px; background-color:#4F81BD;color:white" %)2|=(% style="width: 118px; background-color:#4F81BD;color:white;" %)2|=(% style="width: 42px; background-color:#4F81BD;color:white" %)2|=(% style="width: 118px; background-color:#4F81BD;color:white" %)1|=(% style="width: 70px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px; background-color:#4F81BD;color:white" %)2
Xiaoling 140.3 346 |(% style="width:65px" %)**Value**|(% style="width:66px" %)(((
Saxer Lin 124.2 347 Battery
Xiaoling 140.3 348 )))|(% style="width:108px" %)(((
Saxer Lin 124.2 349 Temp_ Red or Temp _White
Xiaoling 140.3 350 )))|(% style="width:62px" %)(((
Xiaoling 72.2 351 ignore
Xiaoling 140.3 352 )))|(% style="width:106px" %)(((
353 Alarm Flag & MOD& Level of PA8
354 )))|(% style="width:100px" %)(((
Saxer Lin 124.2 355 Temp_White
Xiaoling 140.3 356 )))|(% style="width:95px" %)(((
Saxer Lin 124.2 357 Temp_Black
Edwin Chen 90.1 358
359
Xiaoling 72.2 360 )))
Xiaoling 6.2 361
Edwin Chen 90.1 362 **Payload per each model.**
Bei Jinggeng 45.1 363
Ellie Zhang 114.1 364 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220916152530-2.png?rev=1.1||alt="图片-20220916152530-2.png" height="240" width="901"]]
Bei Jinggeng 45.1 365
Edwin Chen 90.1 366
Saxer Lin 136.1 367 [[image:image-20230524160233-2.png||height="184" width="1173"]]
Edwin Chen 90.1 368
369
Xiaoling 137.4 370 ==== (% style="color:blue" %)**Decode corresponding probe color:**(%%) ====
Edwin Chen 90.1 371
372 **D20:**
373
374 Red <~-~-> C1
375
Xiaoling 121.4 376
Edwin Chen 90.1 377 **D22:**
378
Saxer Lin 136.1 379 White <~-~-> C1 , Red <~-~-> C2
Edwin Chen 90.1 380
Xiaoling 121.4 381
Edwin Chen 90.1 382 **D23:**
383
Saxer Lin 136.1 384 White <~-~->C1  , Red <~-~-> C2  , Black <~-~-> C3
Edwin Chen 90.1 385
386
387
Xiaoling 137.4 388 ==== (% style="color:blue" %)**Battery:**(%%) ====
Xiaoling 6.2 389
Edwin Chen 73.1 390 Sensor Battery Level.
Xiaoling 72.2 391
Xiaoling 6.2 392 Ex1: 0x0B45 = 2885mV
393
394 Ex2: 0x0B49 = 2889mV
395
396
Bei Jinggeng 45.1 397
Xiaoling 137.4 398 ==== (% style="color:blue" %)**Temperature RED or Temperature White :**(%%) ====
Xiaoling 6.2 399
Xiaoling 121.4 400
Xiaoling 137.4 401 (% style="color:red" %)**This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White**
Xiaoling 6.2 402
Xiaoling 72.2 403 **Example**:
Xiaoling 6.2 404
Xiaoling 72.2 405 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 406
Xiaoling 72.2 407 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 37.2 408
Xiaoling 72.2 409 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Bei Jinggeng 47.1 410
Xiaoling 6.2 411
412
Xiaoling 137.4 413 ==== (% style="color:blue" %)**Temperature White:**(%%) ====
Edwin Chen 50.1 414
415
Xiaoling 137.4 416 (% style="color:red" %)**This point to the Red probe in D22-LB/D23-LB.**
Edwin Chen 50.1 417
Xiaoling 137.4 418 (% style="color:red" %)**If it is D20-LB, the value is 0x7FFF, which is 327.67.**
Xiaoling 6.2 419
Saxer Lin 136.1 420
Xiaoling 72.2 421 **Example**:
Xiaoling 37.2 422
Xiaoling 72.2 423 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 424
Xiaoling 72.2 425 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 6.2 426
Xiaoling 72.2 427 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 6.2 428
429
430
Xiaoling 137.4 431 ==== (% style="color:blue" %)**Temperature Black:**(%%) ====
Xiaoling 37.2 432
Xiaoling 6.2 433
Xiaoling 140.2 434 (% style="color:red" %)**This point to the BLACK probe in D23-LB**
Xiaoling 6.2 435
Xiaoling 140.2 436 (% style="color:red" %)**If it is D20-LB/D22-LB, the value is 0x7FFF, which is 327.67.**
Xiaoling 6.2 437
Saxer Lin 136.1 438
Xiaoling 72.2 439 **Example**:
Xiaoling 6.2 440
Xiaoling 72.2 441 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 442
Xiaoling 72.2 443 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 6.2 444
Xiaoling 72.2 445 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 6.2 446
447
448
Xiaoling 137.4 449 ==== (% style="color:blue" %)**Alarm Flag & MOD & Level of PA8:**(%%) ====
Xiaoling 6.2 450
Xiaoling 50.2 451
Xiaoling 72.2 452 **Example:**
Xiaoling 6.2 453
Saxer Lin 136.1 454 If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message.It means that the temperature exceed the alarm value or trigger an interrupt.
Bei Jinggeng 47.1 455
Saxer Lin 136.1 456 If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm.
Xiaoling 72.2 457
Saxer Lin 136.1 458 If payload & 0x80>>7 = 0x01  **~-~->** The PA8 is low level.
Xiaoling 72.2 459
Saxer Lin 136.1 460 If payload & 0x80>>7 =0x00  **~-~->** The PA8 is high level.
461
462 If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message.
463
464 If payload >> 2 = 0x31  **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/S31-LB_S31B-LB/#HPolltheAlarmsettings:]] for detail. 
465
466
Edwin Chen 80.1 467 == 2.4 Payload Decoder file ==
Xiaoling 72.2 468
469
470 (((
471 In TTN, use can add a custom payload so it shows friendly. 
Bei Jinggeng 47.1 472 )))
473
Xiaoling 72.2 474 (((
Saxer Lin 122.1 475 In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from: 
Saxer Lin 122.4 476
477 [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/D20-LB%26D20S-LB%26D22-LB%26D23-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/D20-LB%26D20S-LB%26D22-LB%26D23-LB]]
Saxer Lin 123.1 478
479
Xiaoling 72.2 480 )))
Bei Jinggeng 47.1 481
Edwin Chen 81.1 482 == 2.5 Datalog Feature ==
483
Xiaoling 84.2 484
Xiaoling 158.7 485 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, D2x-LB/LS will store the reading for future retrieving purposes.
Edwin Chen 81.1 486
487
488 === 2.5.1 Ways to get datalog via LoRaWAN ===
489
Xiaoling 84.2 490
Xiaoling 158.7 491 Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], D2x-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network,D2x-LB/LS will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
Edwin Chen 81.1 492
Xiaoling 158.7 493 * a) D2x-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
494 * b) D2x-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but D2x-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if D2x-LB/LS gets a ACK, D2x-LB/LS will consider there is a network connection and resend all NONE-ACK Message.
Edwin Chen 81.1 495
496 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
497
Ellie Zhang 114.1 498 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
Edwin Chen 81.1 499
Xiaoling 121.5 500
Edwin Chen 81.1 501 === 2.5.2 Unix TimeStamp ===
502
Xiaoling 84.2 503
Xiaoling 158.7 504 D2x-LB/LS uses Unix TimeStamp format based on
Edwin Chen 81.1 505
Ellie Zhang 114.1 506 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
Edwin Chen 81.1 507
508 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
509
510 Below is the converter example
511
Ellie Zhang 114.1 512 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
Edwin Chen 81.1 513
514 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
515
516
517 === 2.5.3 Set Device Time ===
518
Xiaoling 84.2 519
Xiaoling 98.10 520 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
Edwin Chen 81.1 521
Xiaoling 158.7 522 Once D2x-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to D2x-LB/LS. If D2x-LB/LS fails to get the time from the server, D2x-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
Edwin Chen 81.1 523
Xiaoling 98.12 524 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
Edwin Chen 81.1 525
526
Edwin Chen 95.1 527 === 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
Edwin Chen 81.1 528
Xiaoling 84.2 529
Edwin Chen 81.1 530 The Datalog poll reply uplink will use below payload format.
531
532 **Retrieval data payload:**
533
Xiaoling 158.11 534 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
535 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
Edwin Chen 81.1 536 **Size(bytes)**
Xiaoling 158.11 537 )))|=(% style="width: 62px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 62px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 118px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 118px; background-color:#4F81BD;color:white" %)**1**|=(% style="width: 100px; background-color:#4F81BD;color:white" %)**4**
Xiaoling 98.16 538 |(% style="width:93px" %)**Value**|(% style="width:54px" %)(((
Saxer Lin 136.1 539 Temp_Black
540 )))|(% style="width:54px" %)Temp_White|(% style="width:132px" %)Temp_ Red or Temp _White|(% style="width:158px" %)(((
Xiaoling 140.7 541 Poll message flag & Alarm Flag& Level of PA8
Saxer Lin 136.1 542 )))|(% style="width:111px" %)Unix Time Stamp
543
Edwin Chen 81.1 544 **Poll message flag & Ext:**
545
Saxer Lin 136.1 546 [[image:image-20230524160709-3.png]]
Edwin Chen 81.1 547
Xiaoling 140.9 548 (% style="color:blue" %)**No ACK Message**(%%):  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
Edwin Chen 81.1 549
Xiaoling 140.9 550 (% style="color:blue" %)**Poll Message Flag**(%%): 1: This message is a poll message reply.
Edwin Chen 81.1 551
552 * Poll Message Flag is set to 1.
553
554 * Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
555
556 For example, in US915 band, the max payload for different DR is:
557
Xiaoling 140.9 558 (% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data
Edwin Chen 81.1 559
Xiaoling 140.9 560 (% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
Edwin Chen 81.1 561
Xiaoling 140.9 562 (% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
Edwin Chen 81.1 563
Xiaoling 140.9 564 (% style="color:blue" %)**d) DR3: **(%%)total payload includes 22 entries of data.
Edwin Chen 81.1 565
566 If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
567
Xiaoling 98.17 568
Edwin Chen 81.1 569 **Example:**
570
Xiaoling 158.7 571 If D2x-LB/LS has below data inside Flash:
Edwin Chen 81.1 572
573
Saxer Lin 136.1 574 [[image:image-20230524160736-4.png]]
Xiaoling 101.2 575
Saxer Lin 136.1 576 If user sends below downlink command: 31646DBAA0646DBB5405
Edwin Chen 81.1 577
Saxer Lin 136.1 578 Where : Start time: 646DBAA0 = time 23/5/24 07:20:00
Edwin Chen 81.1 579
Saxer Lin 136.1 580 Stop time: 646DBB54= time 23/5/24 07:23:00
Edwin Chen 81.1 581
Xiaoling 98.17 582
Xiaoling 158.7 583 **D2x-LB/LS will uplink this payload.**
Edwin Chen 81.1 584
585
Saxer Lin 136.1 586 [[image:image-20230524160755-5.png||height="368" width="1146"]]
Xiaoling 121.5 587
Xiaoling 140.13 588
Xiaoling 98.29 589 (((
Saxer Lin 136.1 590 01 08 01 05 01 08 40 64 6D BA A7 01 09 01 05 01 09 40 64 6D BA B6 01 09 01 05 01 09 40 64 6D BA C6 01 09 01 05 01 09 41 64 6D BA DD 01 09 01 05 01 09 43 64 6D BB 1E 01 09 01 06 01 09 41 64 6D BB 33 01 09 01 06 01 0A 40 64 6D BB 45 01 09 01 06 01 09 40 64 6D BB 51
Xiaoling 98.29 591 )))
Edwin Chen 81.1 592
Xiaoling 98.29 593 (((
Edwin Chen 81.1 594 Where the first 11 bytes is for the first entry:
Xiaoling 98.29 595 )))
Edwin Chen 81.1 596
Xiaoling 98.29 597 (((
Saxer Lin 136.1 598 01 08 01 05 01 08 40 64 6D BA A7
Xiaoling 98.29 599 )))
Edwin Chen 81.1 600
Xiaoling 98.29 601 (((
Saxer Lin 136.1 602 **Temp_Black**=0x0108/10=26.4
Xiaoling 98.29 603 )))
Edwin Chen 81.1 604
Xiaoling 98.29 605 (((
Saxer Lin 136.1 606 **Temp_White**=0x0105/10=26.1
Edwin Chen 81.1 607
Saxer Lin 136.1 608 **Temp_Red or White**=0x0108/10=26.4
Xiaoling 98.29 609 )))
Edwin Chen 81.1 610
Xiaoling 98.29 611 (((
Saxer Lin 136.1 612 **poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.
Xiaoling 98.29 613 )))
Edwin Chen 81.1 614
Xiaoling 98.29 615 (((
Saxer Lin 136.1 616 **Unix time** is 0x646DBAA7=1684912807s=23/5/24 07:20:07
Xiaoling 98.29 617 )))
Edwin Chen 81.1 618
619
Ellie Zhang 114.1 620 (% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的
Bei Jinggeng 47.1 621
Edwin Chen 81.1 622 == 2.6 Temperature Alarm Feature ==
Xiaoling 6.2 623
624
Xiaoling 158.7 625 D2x-LB/LS work flow with Alarm feature.
Xiaoling 6.2 626
627
Ellie Zhang 114.1 628 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220623090437-1.png?rev=1.1||alt="图片-20220623090437-1.png"]]
Xiaoling 6.2 629
630
Edwin Chen 81.1 631 == 2.7 Frequency Plans ==
Xiaoling 6.2 632
633
Xiaoling 158.7 634 The D2x-LB/LS uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
Xiaoling 6.2 635
Xiaoling 37.3 636 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
Xiaoling 6.2 637
638
Edwin Chen 81.1 639 == 2.8 ​Firmware Change Log ==
Xiaoling 6.2 640
641
642 **Firmware download link:**
643
Xiaoling 121.4 644 [[https:~~/~~/www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0>>https://www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0]]
Xiaoling 6.2 645
646
Xiaoling 158.7 647 = 3. Configure D2x-LB/LS =
Xiaoling 37.4 648
Edwin Chen 75.1 649 == 3.1 Configure Methods: ==
Xiaoling 6.2 650
Xiaoling 84.2 651
Xiaoling 158.7 652 D2x-LB/LS supports below configure method:
Xiaoling 6.2 653
Edwin Chen 84.1 654 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
Edwin Chen 97.1 655 * AT Command via UART Connection : See [[Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
Edwin Chen 74.1 656 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
657
Edwin Chen 75.1 658 == 3.2 General Commands ==
Xiaoling 6.2 659
Xiaoling 84.2 660
Xiaoling 6.2 661 These commands are to configure:
662
663 * General system settings like: uplink interval.
664 * LoRaWAN protocol & radio related command.
665
Edwin Chen 75.1 666 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
Xiaoling 6.2 667
Xiaoling 37.5 668 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
Xiaoling 6.2 669
670
Xiaoling 158.7 671 == 3.3 Commands special design for D2x-LB/LS ==
Xiaoling 6.2 672
Edwin Chen 75.1 673
Xiaoling 158.7 674 These commands only valid for D2x-LB/LS, as below:
Xiaoling 6.2 675
676
Edwin Chen 79.1 677 === 3.3.1 Set Transmit Interval Time ===
Xiaoling 6.2 678
Xiaoling 37.5 679
Xiaoling 6.2 680 Feature: Change LoRaWAN End Node Transmit Interval.
681
Xiaoling 42.21 682 (% style="color:blue" %)**AT Command: AT+TDC**
Xiaoling 6.2 683
Xiaoling 98.22 684 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 685 |=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
Xiaoling 42.25 686 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
Xiaoling 6.2 687 30000
688 OK
689 the interval is 30000ms = 30s
690 )))
Xiaoling 42.25 691 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
Xiaoling 6.2 692 OK
693 Set transmit interval to 60000ms = 60 seconds
694 )))
695
Xiaoling 42.21 696 (% style="color:blue" %)**Downlink Command: 0x01**
Xiaoling 6.2 697
698 Format: Command Code (0x01) followed by 3 bytes time value.
699
Xiaoling 43.2 700 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
Xiaoling 6.2 701
Xiaoling 43.2 702 * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
703 * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
Xiaoling 6.2 704
Edwin Chen 79.1 705 === 3.3.2 Get Device Status ===
Xiaoling 6.2 706
Edwin Chen 79.1 707
Edwin Chen 75.1 708 Send a LoRaWAN downlink to ask device send Alarm settings.
Xiaoling 6.2 709
Xiaoling 98.20 710 * (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
Xiaoling 6.2 711
Edwin Chen 76.1 712 Sensor will upload Device Status via FPORT=5. See payload section for detail.
Xiaoling 6.2 713
714
Edwin Chen 79.1 715 === 3.3.3 Set Alarm Thredhold ===
Xiaoling 37.5 716
Xiaoling 84.2 717
Xiaoling 98.20 718 (% style="color:blue" %)**1.  Set for All Probes:**
Xiaoling 6.2 719
Edwin Chen 75.1 720 (% style="color:#037691" %)**AT+18ALARM=min,max**
Edwin Chen 57.1 721
Edwin Chen 75.1 722 * When min=0, and max≠0, Alarm trigger when higher than max
723 * When min≠0, and max=0, Alarm trigger when lower than min
724 * When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
Edwin Chen 57.1 725
Edwin Chen 75.1 726 **Example:**
Edwin Chen 57.1 727
Edwin Chen 75.1 728 AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
Edwin Chen 57.1 729
Xiaoling 6.2 730
Xiaoling 98.20 731 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 732
Edwin Chen 75.1 733 0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
Xiaoling 6.2 734
Edwin Chen 75.1 735 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
Xiaoling 6.2 736
737
Xiaoling 98.20 738 (% style="color:blue" %)**2.  Set for Separate Probe:**
Xiaoling 6.2 739
Edwin Chen 75.1 740 (% style="color:#037691" %)**AT+18ALARM=min,max,index**
Xiaoling 6.2 741
Edwin Chen 75.1 742 Index:
Xiaoling 6.2 743
Edwin Chen 75.1 744 * 1: Temperature_Red
745 * 2: Temperature_White
746 * 3: Temperature_Black
Xiaoling 6.2 747
Edwin Chen 75.1 748 **Example:**
Xiaoling 6.2 749
Edwin Chen 75.1 750 AT+18ALARM=-10,30,1   ~/~/ Alarm when temperature_red < -10 or higher than 30.
Xiaoling 37.5 751
752
Xiaoling 98.20 753 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 754
Edwin Chen 75.1 755 0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
Bei Jinggeng 47.1 756
Edwin Chen 75.1 757 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
Bei Jinggeng 47.1 758
759
Edwin Chen 79.1 760 === 3.3.4 Set Alarm Interval ===
Bei Jinggeng 47.1 761
762
Edwin Chen 75.1 763 The shortest time of two Alarm packet. (unit: min)
Xiaoling 6.2 764
Xiaoling 98.20 765 * (% style="color:blue" %)**AT Command:**
Xiaoling 6.2 766
Edwin Chen 75.1 767 AT+ATDC=30  ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
Bei Jinggeng 47.1 768
Xiaoling 6.2 769
Xiaoling 98.20 770 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 771
Edwin Chen 75.1 772 0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
Xiaoling 43.3 773
Xiaoling 45.2 774
Xiaoling 100.2 775 === 3.3.5 Get Alarm settings ===
Bei Jinggeng 45.1 776
777
Edwin Chen 75.1 778 Send a LoRaWAN downlink to ask device send Alarm settings.
Bei Jinggeng 47.1 779
Edwin Chen 75.1 780 * (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
Bei Jinggeng 47.1 781
Edwin Chen 75.1 782 **Example:**
Bei Jinggeng 47.1 783
Edwin Chen 75.1 784 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/1655948182791-225.png?rev=1.1||alt="1655948182791-225.png"]]
Bei Jinggeng 47.1 785
786
Edwin Chen 75.1 787 **Explain:**
788
789 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
790
Edwin Chen 79.1 791 === 3.3.6 Set Interrupt Mode ===
792
Xiaoling 84.2 793
Saxer Lin 124.2 794 Feature, Set Interrupt mode for PA8 of pin.
Edwin Chen 75.1 795
Saxer Lin 124.2 796 When AT+INTMOD=0 is set, PA8 is used as a digital input port.
797
Edwin Chen 75.1 798 (% style="color:blue" %)**AT Command: AT+INTMOD**
799
Xiaoling 98.21 800 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 801 |=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 196px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Response**
Edwin Chen 75.1 802 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
803 0
Bei Jinggeng 45.1 804 OK
Edwin Chen 75.1 805 the mode is 0 =Disable Interrupt
Bei Jinggeng 45.1 806 )))
Edwin Chen 75.1 807 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
808 Set Transmit Interval
809 0. (Disable Interrupt),
810 ~1. (Trigger by rising and falling edge)
811 2. (Trigger by falling edge)
812 3. (Trigger by rising edge)
813 )))|(% style="width:157px" %)OK
Bei Jinggeng 45.1 814
Edwin Chen 75.1 815 (% style="color:blue" %)**Downlink Command: 0x06**
Bei Jinggeng 45.1 816
Edwin Chen 75.1 817 Format: Command Code (0x06) followed by 3 bytes.
Bei Jinggeng 45.1 818
Edwin Chen 75.1 819 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
Bei Jinggeng 45.1 820
Edwin Chen 75.1 821 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
822 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
823
Saxer Lin 130.1 824 === 3.3.7 Set Power Output Duration ===
Saxer Lin 124.2 825
Xiaoling 140.13 826
Saxer Lin 124.2 827 Control the output duration 5V . Before each sampling, device will
828
829 ~1. first enable the power output to external sensor,
830
831 2. keep it on as per duration, read sensor value and construct uplink payload
832
833 3. final, close the power output.
834
835 (% style="color:blue" %)**AT Command: AT+5VT**
836
837 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 838 |=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 196px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Response**
Saxer Lin 124.2 839 |(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
840 OK
Saxer Lin 144.1 841 |(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
Saxer Lin 124.2 842
843 (% style="color:blue" %)**Downlink Command: 0x07**
844
845
846 Format: Command Code (0x07) followed by 2 bytes.
847
848 The first and second bytes are the time to turn on.
849
850 * Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
851 * Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
852
Mengting Qiu 145.1 853 === 3.3.8 Multiple VDC collections in one uplink(Since firmware version 1.3.2) ===
Xiaoling 144.2 854
Mengting Qiu 144.3 855
856 Added AT+STDC command to collect the voltage of **VDC_INPUT** multiple times and upload it at one time.
857
858 (% style="color:blue" %)**AT Command: AT** **+STDC**
859
860 AT+STDC=aa,bb,bb
861
862 (% style="color:#037691" %)**aa:**(%%)
863 **0:** means disable this function and use TDC to send packets.
864 **1:** means enable this function, use the method of multiple acquisitions to send packets.
865 (% style="color:#037691" %)**bb:**(%%) Each collection interval (s), the value is 1~~65535
866 (% style="color:#037691" %)**cc:**(%%)** **the number of collection times, the value is 1~~120
867
868 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 158.11 869 |(% style="background-color:#4F81BD;color:white; width:160px" %)**Command Example**|(% style="background-color:#4F81BD;color:white; width:215px" %)**Function**|(% style="background-color:#4F81BD;color:white" %)**Response**
Mengting Qiu 144.3 870 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=?|(% style="background-color:#f2f2f2; width:215px" %)Get the mode of multiple acquisitions and one uplink.|(% style="background-color:#f2f2f2" %)1,10,18
871 OK
872 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=1,10,18|(% style="background-color:#f2f2f2; width:215px" %)Set the mode of multiple acquisitions and one uplink, collect once every 10 seconds, and report after 18 times.|(% style="background-color:#f2f2f2" %)(((
873 Attention:Take effect after ATZ
874
875 OK
876 )))
877 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=0, 0,0|(% style="background-color:#f2f2f2; width:215px" %)(((
878 Use the TDC interval to send packets.(default)
879
880
881 )))|(% style="background-color:#f2f2f2" %)(((
882 Attention:Take effect after ATZ
883
884 OK
885 )))
886
887 (% style="color:blue" %)**Downlink Command: 0xAE**
888
889 Format: Command Code (0x08) followed by 5 bytes.
890
891 * Example 1: Downlink Payload: AE 01 02 58 12** ~-~-->**  AT+STDC=1,600,18
892
Edwin Chen 76.1 893 = 4. Battery & Power Consumption =
Xiaoling 6.2 894
Xiaoling 84.2 895
Xiaoling 158.7 896 D2x-LB use ER26500 + SPC1520 battery pack and D2x-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
Xiaoling 37.6 897
Xiaoling 84.2 898 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
Xiaoling 37.6 899
Xiaoling 6.2 900
Edwin Chen 77.1 901 = 5. OTA firmware update =
Xiaoling 6.2 902
903
Xiaoling 158.7 904 User can change firmware D2x-LB/LS to:
Xiaoling 6.2 905
Edwin Chen 98.1 906 * Change Frequency band/ region.
907 * Update with new features.
908 * Fix bugs.
Xiaoling 6.2 909
Xiaoling 143.2 910 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0]]**
Xiaoling 6.2 911
Edwin Chen 98.1 912 Methods to Update Firmware:
Xiaoling 6.2 913
Xiaoling 144.2 914 * (Recommanded way) OTA firmware update via wireless : **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
915 * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
Xiaoling 6.2 916
Edwin Chen 98.1 917 = 6. FAQ =
Xiaoling 6.2 918
919
920
Edwin Chen 77.1 921 = 7. Order Info =
Xiaoling 6.2 922
923
Xiaoling 158.10 924 **Part Number: (% style="color:blue" %)D20-LB-XX or D20-LS-XX(%%) / (% style="color:blue" %)D20S-LB-xx or D20S-LS-XX(%%)(designed for used in Soil or Road) / (% style="color:blue" %)D22-LB-XX or D22-LS-XX (%%)/ (% style="color:blue" %)D23-LB-XX or D20-LS-XX(%%)**
Xiaoling 6.2 925
Xiaoling 53.4 926 (% style="color:red" %)**XX**(%%): The default frequency band
Xiaoling 6.2 927
Xiaoling 53.4 928 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
929
930 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
931
932 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
933
934 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
935
936 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
937
938 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
939
940 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
941
942 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
943
Edwin Chen 77.1 944 = 8. ​Packing Info =
Xiaoling 53.4 945
946
Xiaoling 42.21 947 (% style="color:#037691" %)**Package Includes**:
Xiaoling 6.2 948
Xiaoling 158.7 949 * D2x-LB or D2x-LS LoRaWAN Temperature Sensor
Xiaoling 6.2 950
Xiaoling 42.21 951 (% style="color:#037691" %)**Dimension and weight**:
Xiaoling 6.2 952
953 * Device Size: cm
Xiaoling 53.4 954
Xiaoling 6.2 955 * Device Weight: g
Xiaoling 53.4 956
Xiaoling 6.2 957 * Package Size / pcs : cm
Xiaoling 53.4 958
Xiaoling 6.2 959 * Weight / pcs : g
960
Edwin Chen 77.1 961 = 9. Support =
Xiaoling 6.2 962
Xiaoling 42.2 963
Xiaoling 6.2 964 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
Xiaoling 42.20 965
Xiaoling 121.3 966 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0