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