Version 114.1 by Ellie Zhang on 2023/05/06 14:45
Show last authors
1 (% style="text-align:center" %)
2 [[image:D20-D22-D23-1.jpg]]
3
4
5
6 **目录：**
7
8 {{toc/}}
9
10
11
12
13
14
15 = 一、简介 =
16
17 == 1.1 什么是 D2x-LB LoRaWAN 温度传感器 ==
18
19
20 (((
21 Dragino D2x-LB 是用于物联网解决方案的(% style="color:blue" %)**LoRaWAN 温度传感器。D2x**(%%) -LB 有1 ~~ 3 个温度探测头。D2x-LB 将温度读取数据转换为LoRaWAN 无线数据并通过LoRaWAN网关发送到物联网平台。
22 )))
23
24 (((
25 D2x-LB中使用的LoRa无线技术允许设备发送数据并以低数据速率达到极远距离。它提供超长距离射频通信和高抗干扰性，同时最大程度地减少电流消耗。
26 )))
27
28 (((
29 D2x-LB中使用的温度传感器可以(% style="color:blue" %)**测量-55°C ~~ 125°C，浓度为±0.5°C（最大±2.0 °C）**(%%)。
30 )))
31
32 (((
33 D2x-LB支持(% style="color:blue" %)**温度报警功能，**(%%)用户可以设置温度报警即时通知。D2x-LB支持Datalog功能，可以在没有LoRaWAN网络时保存数据，在网络交换复时保存上行数据。
34 )))
35
36 (((
37 D2x-LB 最多有 3 个探头，最多可测量 3 个温度点。
38 )))
39
40 (((
41 D2x-LB(% style="color:blue" %)**支持BLE配置**(%%)和(% style="color:blue" %)**无线OTA更新**(%%)，用户易于使用。
42 )))
43
44 (((
45 D2x-LB 由(% style="color:blue" %)**8500mAh Li-SOCI2 电池**(%%)供电，可长期使用长达 5 年。
46 )))
47
48 (((
49 每个 D2x-LB 都预加载了一组用于 LoRaWAN 注册的唯一密钥，将这些密钥注册到本地 LoRaWAN 服务器，开机后它将自动连接。
50 )))
51
52
53 == 1.2 特点 ==
54
55 * LoRaWAN 1.0.3 A 类
56 * 超低功耗
57 * 1 ~~ 3 个外部温度探头
58 * 测量范围 -55°C ~~ 125°C
59 * 温度报警
60 * 频段：CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
61 * 支持蓝牙 v5.1 和 LoRaWAN 远程配置
62 * Support wireless OTA update firmware
63 * Uplink on periodically
64 * Downlink to change configure
65 * 8500mAh Battery for long term use
66
67 == 1.3 Specification ==
68
69
70 (% style="color:#037691" %)**Common DC Characteristics:**
71
72 * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
73 * Operating Temperature: -40 ~~ 85°C
74
75 (% style="color:#037691" %)**Temperature Sensor:**
76
77 * Dallas DS18B20
78 * Range: -55 to + 125°C
79 * Accuracy ±0.5°C (max ±2.0 °C).
80
81 (% style="color:#037691" %)**LoRa Spec:**
82
83 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
84 * Max +22 dBm constant RF output vs.
85 * RX sensitivity: down to -139 dBm.
86 * Excellent blocking immunity
87
88 (% style="color:#037691" %)**Battery:**
89
90 * Li/SOCI2 un-chargeable battery
91 * Capacity: 8500mAh
92 * Self-Discharge: <1% / Year @ 25°C
93 * Max continuously current: 130mA
94 * Max boost current: 2A, 1 second
95
96 (% style="color:#037691" %)**Power Consumption**
97
98 * Sleep Mode: 5uA @ 3.3v
99 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
100
101 == 1.4 Sleep mode and working mode ==
102
103
104 (% 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.
105
106 (% 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.
107
108
109 == 1.5 Button & LEDs ==
110
111
112 [[image:1675071855856-879.png]]
113
114
115 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
116 |=(% 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**
117 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
118 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
119 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
120 )))
121 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
122 (% 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.
123 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
124 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.
125 )))
126 |(% 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.
127
128 == 1.6 BLE connection ==
129
130
131 D2x-LB support BLE remote configure.
132
133
134 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:
135
136 * Press button to send an uplink
137 * Press button to active device.
138 * Device Power on or reset.
139
140 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
141
142
143 == 1.7  Hardware Variant ==
144
145
146 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
147 |=(% 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
148 |(% style="width:102px" %)D20-LB|(% style="width:190px" %)[[image:D20.jpg]]|(% style="width:297px" %)(((
149 1 x DS28B20 Probe
150
151 Cable Length : 2 meters
152
153
154 )))
155 |(% style="width:102px" %)D22-LB|(% style="width:190px" %)[[image:D22.jpg]]|(% style="width:297px" %)(((
156 2 x DS28B20 Probes
157
158 Cable lengths total 1.5meters per probe
159
160 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]]
161 )))
162 |(% style="width:102px" %)(((
163 (((
164 D23-LB
165 )))
166
167 (((
168
169 )))
170 )))|(% style="width:190px" %)[[image:D23.jpg]]|(% style="width:297px" %)(((
171 3 x DS28B20 Probes
172
173 Cable lengths total 1.5meters per probe
174
175 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]]
176 )))
177
178 (% style="display:none" %)
179
180
181
182 == 1.8 Mechanical ==
183
184
185 [[image:1675143884058-338.png]]
186
187
188 [[image:1675143899218-599.png]]
189
190
191 [[image:1675143909447-639.png]]
192
193
194 = 2. Configure D2x-LB to connect to LoRaWAN network =
195
196 == 2.1 How it works ==
197
198
199 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.
200
201
202 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
203
204
205 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.
206
207 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.
208
209
210 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB.
211
212 Each D2x-LB is shipped with a sticker with the default device EUI as below:
213
214 [[image:image-20230426084024-1.png||alt="图片-20230426084024-1.png" height="236" width="508"]]
215
216
217 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
218
219
220 (% style="color:blue" %)**Register the device**
221
222 [[image:1675144099263-405.png]]
223
224
225 (% style="color:blue" %)**Add APP EUI and DEV EUI**
226
227 [[image:1675144117571-832.png]]
228
229
230 (% style="color:blue" %)**Add APP EUI in the application**
231
232
233 [[image:1675144143021-195.png]]
234
235
236 (% style="color:blue" %)**Add APP KEY**
237
238 [[image:1675144157838-392.png]]
239
240 (% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB
241
242
243 Press the button for 5 seconds to activate the D2x-LB.
244
245 (% 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.
246
247 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
248
249
250 == 2.3 ​Uplink Payload ==
251
252 === 2.3.1 Device Status, FPORT~=5 ===
253
254
255 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.
256
257 The Payload format is as below.
258
259
260 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
261 |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
262 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
263 |(% 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
264
265 Example parse in TTNv3
266
267 [[image:image-20230415153147-2.png||alt="图片-20230415153147-2.png" height="220" width="1120"]]
268
269
270 (% style="color:#037691" %)**Sensor Model**(%%): For D2x-LB, this value is 0x19
271
272 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
273
274 (% style="color:#037691" %)**Frequency Band**:
275
276 *0x01: EU868
277
278 *0x02: US915
279
280 *0x03: IN865
281
282 *0x04: AU915
283
284 *0x05: KZ865
285
286 *0x06: RU864
287
288 *0x07: AS923
289
290 *0x08: AS923-1
291
292 *0x09: AS923-2
293
294 *0x0a: AS923-3
295
296 *0x0b: CN470
297
298 *0x0c: EU433
299
300 *0x0d: KR920
301
302 *0x0e: MA869
303
304
305 (% style="color:#037691" %)**Sub-Band**:
306
307 AU915 and US915:value 0x00 ~~ 0x08
308
309 CN470: value 0x0B ~~ 0x0C
310
311 Other Bands: Always 0x00
312
313
314 (% style="color:#037691" %)**Battery Info**:
315
316 Check the battery voltage.
317
318 Ex1: 0x0B45 = 2885mV
319
320 Ex2: 0x0B49 = 2889mV
321
322
323 === 2.3.2  Sensor Data. FPORT~=2 ===
324
325
326 D2x-LB will uplink below payload via FPORT=2 after Joined LoRaWAN Network.
327
328 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
329 |=(% style="width: 62.5px;background-color:#D9E2F3" %)(((
330 **Size(bytes)**
331 )))|=(% style="width: 60px;background-color:#D9E2F3" %)2|=(% style="width: 120px;background-color:#D9E2F3" %)2|=(% style="width: 60px;background-color:#D9E2F3" %)2|=(% style="width: 65px;background-color:#D9E2F3" %)1|=(% style="width: 65px;background-color:#D9E2F3" %)**2**|=(% style="width: 65px;background-color:#D9E2F3" %)2
332 |(% style="width:65px" %)**Value**|(((
333 [[Battery>>||anchor="HBattery:"]]
334 )))|(% style="width:91px" %)(((
335 [[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]
336 )))|(% style="width:61px" %)(((
337 ignore
338 )))|(% style="width:91px" %)(((
339 [[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]
340 )))|(% style="width:99px" %)(((
341 [[Temp_White>>||anchor="HTemperatureWhite:"]]
342 )))|(% style="width:97px" %)(((
343 [[Temp_Black>>||anchor="HTemperatureBlack:"]]
344
345
346 )))
347
348 **Payload per each model.**
349
350 [[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"]]
351
352
353 [[image:image-20230415154139-3.png||alt="图片-20230415154139-3.png" height="215" width="1179"]]
354
355
356 ==== (% style="color:#4472c4" %)**Decode corresponding probe color：**(%%) ====
357
358 **D20:**
359
360 Red <~-~-> C1
361
362 **D22:**
363
364 White <~-~-> C1 Red <~-~-> C2
365
366 **D23:**
367
368 White <~-~->C1 Red <~-~-> C2 Black <~-~-> C3
369
370
371
372 ==== (% style="color:#4472c4" %)**Battery:**(%%) ====
373
374 Sensor Battery Level.
375
376 Ex1: 0x0B45 = 2885mV
377
378 Ex2: 0x0B49 = 2889mV
379
380
381
382 ==== (% style="color:#4472c4" %)**Temperature RED or Temperature White :**(%%) ====
383
384 **This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White**
385
386 **Example**:
387
388 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
389
390 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
391
392 （FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
393
394
395
396 ==== (% style="color:#4472c4" %)**Temperature White:**(%%) ====
397
398
399 **This point to the Red probe in D22-LB/D23-LB**
400
401
402 **Example**:
403
404 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
405
406 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
407
408 （FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
409
410
411
412 ==== (% style="color:#4472c4" %)**Temperature Black:**(%%) ====
413
414
415 **This point to the BLACK probe in D23-LB**
416
417
418 **Example**:
419
420 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
421
422 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
423
424 （FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
425
426
427
428 ==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ====
429
430
431 **Example:**
432
433 If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
434
435 If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
436
437
438 == 2.4 Payload Decoder file ==
439
440
441 (((
442 In TTN, use can add a custom payload so it shows friendly. 
443 )))
444
445 (((
446 In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
447 )))
448
449
450 == 2.5 Datalog Feature ==
451
452
453 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.
454
455
456 === 2.5.1 Ways to get datalog via LoRaWAN ===
457
458
459 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.
460
461 * a) D2x-LB will do an ACK check for data records sending to make sure every data arrive server.
462 * 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.
463
464 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
465
466 [[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"]]
467
468 === 2.5.2 Unix TimeStamp ===
469
470
471 D2x-LB uses Unix TimeStamp format based on
472
473 [[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"]]
474
475 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
476
477 Below is the converter example
478
479 [[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"]]
480
481 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
482
483
484 === 2.5.3 Set Device Time ===
485
486
487 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
488
489 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).
490
491 (% 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.**
492
493
494 === 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
495
496
497 The Datalog poll reply uplink will use below payload format.
498
499 **Retrieval data payload:**
500
501 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
502 |=(% style="width: 90px;background-color:#D9E2F3" %)(((
503 **Size(bytes)**
504 )))|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 115px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 104px; background-color: rgb(217, 226, 243);" %)**1**|=(% style="width: 80px; background-color: rgb(217, 226, 243);" %)**4**
505 |(% style="width:93px" %)**Value**|(% style="width:54px" %)(((
506 [[Temp_Black>>||anchor="HTemperatureBlack:"]]
507 )))|(% style="width:54px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:87px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:104px" %)Poll message flag & Ext|(% style="width:55px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]]
508
509 **Poll message flag & Ext:**
510
511 [[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-20221006192726-1.png?width=754&height=112&rev=1.1||alt="图片-20221006192726-1.png" height="112" width="754"]]
512
513 **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)
514
515 **Poll Message Flag**: 1: This message is a poll message reply.
516
517 * Poll Message Flag is set to 1.
518
519 * Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
520
521 For example, in US915 band, the max payload for different DR is:
522
523 **a) DR0:** max is 11 bytes so one entry of data
524
525 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
526
527 **c) DR2:** total payload includes 11 entries of data
528
529 **d) DR3: **total payload includes 22 entries of data.
530
531 If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
532
533
534 **Example:**
535
536 If D2x-LB has below data inside Flash:
537
538 [[image:1682646331023-772.png]]
539
540
541 If user sends below downlink command: 3160065F9760066DA705
542
543 Where : Start time: 60065F97 = time 21/1/19 04:27:03
544
545 Stop time: 60066DA7= time 21/1/19 05:27:03
546
547
548 **D2x-LB will uplink this payload.**
549
550 [[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-13.png?width=727&height=421&rev=1.1||alt="图片-20220523001219-13.png" height="421" width="727"]]
551
552 (((
553 __**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
554 )))
555
556 (((
557 Where the first 11 bytes is for the first entry:
558 )))
559
560 (((
561 7FFF089801464160065F97
562 )))
563
564 (((
565 **Ext sensor data**=0x7FFF/100=327.67
566 )))
567
568 (((
569 **Temp**=0x088E/100=22.00
570 )))
571
572 (((
573 **Hum**=0x014B/10=32.6
574 )))
575
576 (((
577 **poll message flag & Ext**=0x41,means reply data,Ext=1
578 )))
579
580 (((
581 **Unix time** is 0x60066009=1611030423s=21/1/19 04:27:03
582 )))
583
584
585 (% 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="单击并拖动以调整大小" %)的
586
587 == 2.6 Temperature Alarm Feature ==
588
589
590 D2x-LB work flow with Alarm feature.
591
592
593 [[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"]]
594
595
596 == 2.7 Frequency Plans ==
597
598
599 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.
600
601 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
602
603
604 == 2.8 ​Firmware Change Log ==
605
606
607 **Firmware download link:**
608
609 [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
610
611
612 = 3. Configure D2x-LB =
613
614 == 3.1 Configure Methods: ==
615
616
617 D2x-LB supports below configure method:
618
619 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
620 * 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]].
621 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
622
623 == 3.2 General Commands ==
624
625
626 These commands are to configure:
627
628 * General system settings like: uplink interval.
629 * LoRaWAN protocol & radio related command.
630
631 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
632
633 [[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/]]
634
635
636 == 3.3 Commands special design for D2x-LB ==
637
638
639 These commands only valid for D2x-LB, as below:
640
641
642 === 3.3.1 Set Transmit Interval Time ===
643
644
645 Feature: Change LoRaWAN End Node Transmit Interval.
646
647 (% style="color:blue" %)**AT Command: AT+TDC**
648
649 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
650 |=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
651 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
652 30000
653 OK
654 the interval is 30000ms = 30s
655 )))
656 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
657 OK
658 Set transmit interval to 60000ms = 60 seconds
659 )))
660
661 (% style="color:blue" %)**Downlink Command: 0x01**
662
663 Format: Command Code (0x01) followed by 3 bytes time value.
664
665 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
666
667 * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
668 * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
669
670 === 3.3.2 Get Device Status ===
671
672
673 Send a LoRaWAN downlink to ask device send Alarm settings.
674
675 * (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
676
677 Sensor will upload Device Status via FPORT=5. See payload section for detail.
678
679
680 === 3.3.3 Set Alarm Thredhold ===
681
682
683 (% style="color:blue" %)**1.  Set for All Probes:**
684
685 (% style="color:#037691" %)**AT+18ALARM=min,max**
686
687 * When min=0, and max≠0, Alarm trigger when higher than max
688 * When min≠0, and max=0, Alarm trigger when lower than min
689 * When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
690
691 **Example:**
692
693 AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
694
695
696 * (% style="color:blue" %)**Downlink Payload:**
697
698 0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
699
700 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
701
702
703 (% style="color:blue" %)**2.  Set for Separate Probe:**
704
705 (% style="color:#037691" %)**AT+18ALARM=min,max,index**
706
707 Index:
708
709 * 1: Temperature_Red
710 * 2: Temperature_White
711 * 3: Temperature_Black
712
713 **Example:**
714
715 AT+18ALARM=-10,30,1   ~/~/ Alarm when temperature_red < -10 or higher than 30.
716
717
718 * (% style="color:blue" %)**Downlink Payload:**
719
720 0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
721
722 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
723
724
725 === 3.3.4 Set Alarm Interval ===
726
727
728 The shortest time of two Alarm packet. (unit: min)
729
730 * (% style="color:blue" %)**AT Command:**
731
732 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.
733
734
735 * (% style="color:blue" %)**Downlink Payload:**
736
737 0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
738
739
740 === 3.3.5 Get Alarm settings ===
741
742
743 Send a LoRaWAN downlink to ask device send Alarm settings.
744
745 * (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
746
747 **Example:**
748
749 [[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"]]
750
751
752 **Explain:**
753
754 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
755
756 === 3.3.6 Set Interrupt Mode ===
757
758
759 Feature, Set Interrupt mode for GPIO_EXIT.
760
761 (% style="color:blue" %)**AT Command: AT+INTMOD**
762
763 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
764 |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
765 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
766 0
767 OK
768 the mode is 0 =Disable Interrupt
769 )))
770 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
771 Set Transmit Interval
772 0. (Disable Interrupt),
773 ~1. (Trigger by rising and falling edge)
774 2. (Trigger by falling edge)
775 3. (Trigger by rising edge)
776 )))|(% style="width:157px" %)OK
777
778 (% style="color:blue" %)**Downlink Command: 0x06**
779
780 Format: Command Code (0x06) followed by 3 bytes.
781
782 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
783
784 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
785 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
786
787 = 4. Battery & Power Consumption =
788
789
790 D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
791
792 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
793
794
795 = 5. OTA firmware update =
796
797
798 User can change firmware D2x-LB to:
799
800 * Change Frequency band/ region.
801 * Update with new features.
802 * Fix bugs.
803
804 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
805
806
807 Methods to Update Firmware:
808
809 * (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/]]
810 * 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]]**.
811
812 = 6. FAQ =
813
814
815
816 = 7. Order Info =
817
818
819 Part Number: (% style="color:blue" %)**D20-LB-XX  / D22-LB-XX / D23-LB-XX**
820
821 (% style="color:red" %)**XX**(%%): The default frequency band
822
823 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
824
825 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
826
827 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
828
829 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
830
831 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
832
833 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
834
835 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
836
837 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
838
839 = 8. ​Packing Info =
840
841
842 (% style="color:#037691" %)**Package Includes**:
843
844 * D2x-LB LoRaWAN Temperature Sensor
845
846 (% style="color:#037691" %)**Dimension and weight**:
847
848 * Device Size: cm
849
850 * Device Weight: g
851
852 * Package Size / pcs : cm
853
854 * Weight / pcs : g
855
856 = 9. Support =
857
858
859 * 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.
860
861 * 提供尽可能多的关于您的询问的信息（产品型号、准确描述您的问题和复制它的步骤等）并发送邮件至 [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]

Applications

Navigation

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