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

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0