Skip to Content
Version 116.5 by Xiaoling on 2023/11/13 11:28
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20231110085342-2.png||height="481" width="481"]]
3
4
5
6
7
8
9
10
11 **Table of Contents：**
12
13 {{toc/}}
14
15
16
17
18
19
20 = 1. Introduction =
21
22 == 1.1 What is LoRaWAN Smart Distance Detector ==
23
24
25 The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN. DS20L can measure range between 3cm ~~ 200cm.
26
27 DS20L allows users to send data and reach extremely long ranges via LoRaWAN. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current 
28 consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
29
30 DS20L has a (% style="color:blue" %)**built-in 2400mAh non-chargeable battery**(%%) for long-term use up to several years*. Users can also power DS20L with an external power source for (% style="color:blue" %)**continuous measuring and distance alarm / counting purposes.**
31
32 DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
33
34
35 [[image:image-20231110102635-5.png||height="402" width="807"]]
36
37
38 == 1.2 ​Features ==
39
40
41 * LoRaWAN Class A protocol
42 * LiDAR distance detector, range 3 ~~ 200cm
43 * Periodically detect or continuously detect mode
44 * AT Commands to change parameters
45 * Remotely configure parameters via LoRaWAN Downlink
46 * Alarm & Counting mode
47 * Firmware upgradable via program port or LoRa protocol
48 * Built-in 2400mAh battery or power by external power source
49
50 == 1.3 Specification ==
51
52
53 (% style="color:#037691" %)**LiDAR Sensor:**
54
55 * Operation Temperature: -40 ~~ 80 °C
56 * Operation Humidity: 0~~99.9%RH (no Dew)
57 * Storage Temperature: -10 ~~ 45°C
58 * Measure Range: 3cm~~200cm @ 90% reflectivity
59 * Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm)
60 * ToF FoV: ±9°, Total 18°
61 * Light source: VCSEL
62
63
64
65 == 1.4 Power Consumption ==
66
67
68 (% style="color:#037691" %)**Battery Power Mode:**
69
70 * Idle: 0.003 mA @ 3.3v
71 * Max : 360 mA
72
73 (% style="color:#037691" %)**Continuously mode**:
74
75 * Idle: 21 mA @ 3.3v
76 * Max : 360 mA
77
78
79
80 = 2. Configure DS20L to connect to LoRaWAN network =
81
82 == 2.1 How it works ==
83
84
85 The DS20L 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 DS20L. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
86
87 (% style="display:none" %) (%%)
88
89 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
90
91
92 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.
93
94 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.(% style="display:none" %)
95
96 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
97
98 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
99
100 Each DS20L is shipped with a sticker with the default device EUI as below:
101
102 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
103
104
105 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
106
107
108 (% style="color:blue" %)**Register the device**
109
110 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]]
111
112
113 (% style="color:blue" %)**Add APP EUI and DEV EUI**
114
115 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]]
116
117
118 (% style="color:blue" %)**Add APP EUI in the application**
119
120
121 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]]
122
123
124 (% style="color:blue" %)**Add APP KEY**
125
126 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
127
128
129 (% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
130
131
132 Press the button for 5 seconds to activate the DS20L.
133
134 (% 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.
135
136 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
137
138
139 == 2.3 ​Uplink Payload ==
140
141 === 2.3.1 Device Status, FPORT~=5 ===
142
143
144 Users can use the downlink command(**0x26 01**) to ask DS20L to send device configure detail, include device configure status. DS20L will uplink a payload via FPort=5 to server.
145
146 The Payload format is as below.
147
148 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
149 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
150 **Size(bytes)**
151 )))|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**1**|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**2**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 50px;" %)**2**
152 |(% style="width:62.5px" %)Value|(% style="width:110px" %)Sensor Model|(% style="width:48px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:91px" %)Sub-band|(% style="width:60px" %)BAT
153
154 Example parse in TTNv3
155
156 [[image:image-20230805103904-1.png||height="131" width="711"]]
157
158 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24
159
160 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
161
162 (% style="color:blue" %)**Frequency Band**:
163
164 0x01: EU868
165
166 0x02: US915
167
168 0x03: IN865
169
170 0x04: AU915
171
172 0x05: KZ865
173
174 0x06: RU864
175
176 0x07: AS923
177
178 0x08: AS923-1
179
180 0x09: AS923-2
181
182 0x0a: AS923-3
183
184 0x0b: CN470
185
186 0x0c: EU433
187
188 0x0d: KR920
189
190 0x0e: MA869
191
192 (% style="color:blue" %)**Sub-Band**:
193
194 AU915 and US915:value 0x00 ~~ 0x08
195
196 CN470: value 0x0B ~~ 0x0C
197
198 Other Bands: Always 0x00
199
200 (% style="color:blue" %)**Battery Info**:
201
202 Check the battery voltage.
203
204 Ex1: 0x0B45 = 2885mV
205
206 Ex2: 0x0B49 = 2889mV
207
208
209 === 2.3.2 Uplink Payload, FPORT~=2 ===
210
211
212 (((
213 DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will:
214
215 periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
216
217 Uplink Payload totals 11 bytes.
218 )))
219
220 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
221 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
222 **Size(bytes)**
223 )))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white; width: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**
224 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)(((
225 [[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]]
226 )))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)(((
227 [[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]
228 )))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((
229 [[Message Type>>||anchor="HMessageType"]]
230 )))
231
232 [[image:image-20230805104104-2.png||height="136" width="754"]]
233
234
235 ==== (% style="color:blue" %)**Battery Info**(%%) ====
236
237
238 Check the battery voltage for DS20L.
239
240 Ex1: 0x0B45 = 2885mV
241
242 Ex2: 0x0B49 = 2889mV
243
244
245 ==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ====
246
247
248 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
249
250
251 **Example**:
252
253 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
254
255 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
256
257
258 ==== (% style="color:blue" %)**Distance**(%%) ====
259
260
261 Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength.
262
263
264 **Example**:
265
266 If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm.
267
268
269 ==== (% style="color:blue" %)**Distance signal strength**(%%) ====
270
271
272 Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible.
273
274
275 **Example**:
276
277 If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
278
279 Customers can judge whether they need to adjust the environment based on the signal strength.
280
281
282 **1) When the sensor detects valid data:**
283
284 [[image:image-20230805155335-1.png||height="145" width="724"]]
285
286
287 **2) When the sensor detects invalid data:**
288
289 [[image:image-20230805155428-2.png||height="139" width="726"]]
290
291
292 **3) When the sensor is not connected:**
293
294 [[image:image-20230805155515-3.png||height="143" width="725"]]
295
296
297 ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
298
299
300 This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up.
301
302 Note: The Internet Pin is a separate pin in the screw terminal. See pin mapping of GPIO_EXTI .
303
304 **Example:**
305
306 If byte[0]&0x01=0x00 : Normal uplink packet.
307
308 If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
309
310
311 ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
312
313
314 Characterize the internal temperature value of the sensor.
315
316 **Example: **
317 If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
318 If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
319
320
321 ==== (% style="color:blue" %)**Message Type**(%%) ====
322
323
324 (((
325 For a normal uplink payload, the message type is always 0x01.
326 )))
327
328 (((
329 Valid Message Type:
330 )))
331
332 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
333 |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**
334 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
335 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
336
337 [[image:image-20230805150315-4.png||height="233" width="723"]]
338
339
340 === 2.3.3 Historical measuring distance, FPORT~=3 ===
341
342
343 DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
344
345 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
346
347 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
348 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
349 **Size(bytes)**
350 )))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD; color: white; width: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4
351 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
352 Reserve(0xFF)
353 )))|Distance|Distance signal strength|(% style="width:88px" %)(((
354 LiDAR temp
355 )))|(% style="width:85px" %)Unix TimeStamp
356
357 **Interrupt flag & Interrupt level:**
358
359 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
360 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
361 **Size(bit)**
362 )))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0**
363 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)(((
364 Interrupt flag
365 )))
366
367 * (((
368 Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands.
369 )))
370
371 For example, in the US915 band, the max payload for different DR is:
372
373 **a) DR0:** max is 11 bytes so one entry of data
374
375 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
376
377 **c) DR2:** total payload includes 11 entries of data
378
379 **d) DR3:** total payload includes 22 entries of data.
380
381 If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
382
383
384 **Downlink:**
385
386 0x31 64 CC 68 0C 64 CC 69 74 05
387
388 [[image:image-20230805144936-2.png||height="113" width="746"]]
389
390 **Uplink:**
391
392 43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D
393
394
395 **Parsed Value:**
396
397 [DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
398
399
400 [360,176,30,High,True,2023-08-04 02:53:00],
401
402 [355,168,30,Low,False,2023-08-04 02:53:29],
403
404 [245,211,30,Low,False,2023-08-04 02:54:29],
405
406 [57,700,30,Low,False,2023-08-04 02:55:29],
407
408 [361,164,30,Low,True,2023-08-04 02:56:00],
409
410 [337,184,30,Low,False,2023-08-04 02:56:40],
411
412 [20,4458,30,Low,False,2023-08-04 02:57:40],
413
414 [362,173,30,Low,False,2023-08-04 02:58:53],
415
416
417 **History read from serial port：**
418
419 [[image:image-20230805145056-3.png]]
420
421
422 === 2.3.4 Decode payload in The Things Network ===
423
424
425 While using TTN network, you can add the payload format to decode the payload.
426
427 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]
428
429
430 (((
431 The payload decoder function for TTN is here:
432 )))
433
434 (((
435 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
436 )))
437
438
439 == 2.4 ​Show Data in DataCake IoT Server ==
440
441
442 (((
443 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
444 )))
445
446
447 (((
448 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
449 )))
450
451 (((
452 (% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
453 )))
454
455
456 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592790040-760.png?rev=1.1||alt="1654592790040-760.png"]]
457
458
459 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592800389-571.png?rev=1.1||alt="1654592800389-571.png"]]
460
461
462 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
463
464 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
465
466 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654851029373-510.png?rev=1.1||alt="1654851029373-510.png"]]
467
468
469 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
470
471 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]
472
473
474 == 2.5 Datalog Feature ==
475
476
477 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS20L will store the reading for future retrieving purposes.
478
479
480 === 2.5.1 Ways to get datalog via LoRaWAN ===
481
482
483 Set PNACKMD=1, DS20L will wait for ACK for every uplink, when there is no LoRaWAN network, DS20L 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.
484
485 * (((
486 a) DS20L will do an ACK check for data records sending to make sure every data arrive server.
487 )))
488 * (((
489 b) DS20L will send data in **CONFIRMED Mode** when PNACKMD=1, but DS20L 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 DS20L gets a ACK, DS20L will consider there is a network connection and resend all NONE-ACK messages.
490 )))
491
492 === 2.5.2 Unix TimeStamp ===
493
494
495 DS20L uses Unix TimeStamp format based on
496
497 [[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"]]
498
499 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
500
501 Below is the converter example
502
503 [[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"]]
504
505
506 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
507
508
509 === 2.5.3 Set Device Time ===
510
511
512 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
513
514 Once DS20L Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS20L. If DS20L fails to get the time from the server, DS20L will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
515
516 (% 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.**
517
518
519 === 2.5.4 Poll sensor value ===
520
521
522 Users can poll sensor values based on timestamps. Below is the downlink command.
523
524 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
525 |(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**
526 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**
527 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval
528
529 (((
530 Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
531 )))
532
533 (((
534 For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]
535 )))
536
537 (((
538 Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
539 )))
540
541 (((
542 Uplink Internal =5s，means DS20L will send one packet every 5s. range 5~~255s.
543 )))
544
545
546 == 2.6 Frequency Plans ==
547
548
549 The DS20L 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.
550
551 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
552
553
554 3. Configure DS20L
555
556 == 3.1 Configure Methods ==
557
558
559 DS20L supports below configure method:
560
561 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
562
563 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
564
565 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
566
567 == 3.2 General Commands ==
568
569
570 These commands are to configure:
571
572 * General system settings like: uplink interval.
573
574 * LoRaWAN protocol & radio related command.
575
576 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
577
578 [[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/]]
579
580
581 == 3.3 Commands special design for DS20L ==
582
583
584 These commands only valid for DS20L, as below:
585
586
587 === 3.3.1 Set Transmit Interval Time ===
588
589
590 (((
591 Feature: Change LoRaWAN End Node Transmit Interval.
592 )))
593
594 (((
595 (% style="color:blue" %)**AT Command: AT+TDC**
596 )))
597
598 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
599 |=(% 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**
600 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
601 30000
602 OK
603 the interval is 30000ms = 30s
604 )))
605 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
606 OK
607 Set transmit interval to 60000ms = 60 seconds
608 )))
609
610 (((
611 (% style="color:blue" %)**Downlink Command: 0x01**
612 )))
613
614 (((
615 Format: Command Code (0x01) followed by 3 bytes time value.
616 )))
617
618 (((
619 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
620 )))
621
622 * (((
623 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
624 )))
625 * (((
626 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds 
627
628
629
630 )))
631
632 === 3.3.2 Set Interrupt Mode ===
633
634
635 Feature, Set Interrupt mode for pin of GPIO_EXTI.
636
637 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
638
639 (% style="color:blue" %)**AT Command: AT+INTMOD**
640
641 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
642 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
643 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
644 0
645 OK
646 the mode is 0 =Disable Interrupt
647 )))
648 |(% style="width:154px" %)(((
649 AT+INTMOD=2
650
651 (default)
652 )))|(% style="width:196px" %)(((
653 Set Transmit Interval
654 0. (Disable Interrupt),
655 ~1. (Trigger by rising and falling edge)
656 2. (Trigger by falling edge)
657 3. (Trigger by rising edge)
658 )))|(% style="width:157px" %)OK
659
660 (% style="color:blue" %)**Downlink Command: 0x06**
661
662 Format: Command Code (0x06) followed by 3 bytes.
663
664 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
665
666 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
667
668 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
669
670 = 4. Battery & Power Consumption =
671
672
673 DS20L use built-in 2400mAh non-chargeable battery for long-term use up to several years*. See below link for detail information about the battery info and how to replace.
674
675 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
676
677
678 = 5. OTA Firmware update =
679
680
681 (% class="wikigeneratedid" %)
682 User can change firmware DS20L to:
683
684 * Change Frequency band/ region.
685
686 * Update with new features.
687
688 * Fix bugs.
689
690 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
691
692 Methods to Update Firmware:
693
694 * (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/]]**
695
696 * 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]]**.
697
698 = 6. FAQ =
699
700 == 6.1 What is the frequency plan for DS20L? ==
701
702
703 DS20L use the same frequency as other Dragino products. User can see the detail from this link:  [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]]
704
705
706 = 7. Trouble Shooting =
707
708 == 7.1 AT Command input doesn't work ==
709
710
711 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
712
713
714 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
715
716
717 (((
718 (% style="color:blue" %)**Cause ①**(%%)**：**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance. (such as glass and water, etc.)
719 )))
720
721 (((
722 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
723 )))
724
725
726 (((
727 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
728 )))
729
730 (((
731 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
732 )))
733
734
735 = 8. Order Info =
736
737
738 Part Number: (% style="color:blue" %)**DS20L-XXX**
739
740 (% style="color:red" %)**XXX**(%%): **The default frequency band**
741
742 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
743
744 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
745
746 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
747
748 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
749
750 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
751
752 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
753
754 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
755
756 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
757
758 = 9. ​Packing Info =
759
760
761 (% style="color:#037691" %)**Package Includes**:
762
763 * DS20L LoRaWAN Smart Distance Detector x 1
764
765 (% style="color:#037691" %)**Dimension and weight**:
766
767 * Device Size: cm
768
769 * Device Weight: g
770
771 * Package Size / pcs : cm
772
773 * Weight / pcs : g
774
775 = 10. Support =
776
777
778 * 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.
779
780 * 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]].