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