Last modified by Mengting Qiu on 2023/12/14 11:15
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:(% style="display:none" %) (%%)**
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 (% style="color:#037691" %)**LiDAR Sensor:**
53
54 * Operation Temperature: -40 ~~ 80 °C
55 * Operation Humidity: 0~~99.9%RH (no Dew)
56 * Storage Temperature: -10 ~~ 45°C
57 * Measure Range: 3cm~~200cm @ 90% reflectivity
58 * Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm)
59 * ToF FoV: ±9°, Total 18°
60 * Light source: VCSEL
61
62 == 1.4 Power Consumption ==
63
64
65 (% style="color:#037691" %)**Battery Power Mode:**
66
67 * Idle: 3uA @ 3.3v
68 * Max : 360 mA
69
70 (% style="color:#037691" %)**Continuously mode**:
71
72 * Idle: 21 mA @ 3.3v
73 * Max : 360 mA
74
75 == 1.5 Use Case ==
76
77 (% class="mark" %)**Regular Distance Detect**
78
79 [[image:image-20231211220922-1.png||height="352" width="605"]]
80
81
82 (% class="mark" %)**Counting / Alarm**
83
84 [[image:image-20231211221253-2.png]]
85
86
87 [[image:image-20231211221436-3.png]]
88
89
90 = 2. Configure DS20L to connect to LoRaWAN network =
91
92 == 2.1 How it works ==
93
94
95 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.
96
97 (% style="display:none" %) (%%)
98
99 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
100
101
102 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.
103
104 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" %)
105
106 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
107
108 === Step 1: Create a device in TTN with the OTAA keys from DS20L. ===
109
110 Each DS20L is shipped with a sticker with the default device EUI as below:
111
112 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
113
114
115 You can enter this key in the LoRaWAN Server portal. Below is TTN V3 screenshot:
116
117
118 (% style="color:blue" %)**Register the device**
119
120 [[image:image-20231207144600-2.png||height="703" width="756"]]
121
122
123 (% style="color:blue" %)**Add DevEUI and AppKey**
124
125 [[image:image-20231207145121-5.png||height="540" width="756"]]
126
127
128
129 === Step 2: Activate DS20L ===
130
131 [[image:image-20231128133704-1.png||height="189" width="441"]]
132
133 Press the button for 5 seconds to activate the DS20L.
134
135 The switch is switched to (% style="color:blue" %)**E** (%%)and the external power supply is used.
136
137 The switch is switched to (% style="color:blue" %)**I** (%%)and DS20L will be power by the built-in battery.
138
139 (% 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.
140
141 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
142
143
144
145 == 2.3 ​Uplink Payload ==
146
147 === 2.3.1 Device Status, FPORT~=5 ===
148
149
150 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.
151
152 The Payload format is as below.
153
154 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
155 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
156 **Size(bytes)**
157 )))|=(% 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**
158 |(% 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
159
160 Example parse in TTNv3
161
162 [[image:image-20231206151412-3.png||height="179" width="1070"]]
163
164 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
165
166 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
167
168 (% style="color:blue" %)**Frequency Band**:
169
170 0x01: EU868
171
172 0x02: US915
173
174 0x03: IN865
175
176 0x04: AU915
177
178 0x05: KZ865
179
180 0x06: RU864
181
182 0x07: AS923
183
184 0x08: AS923-1
185
186 0x09: AS923-2
187
188 0x0a: AS923-3
189
190 0x0b: CN470
191
192 0x0c: EU433
193
194 0x0d: KR920
195
196 0x0e: MA869
197
198 (% style="color:blue" %)**Sub-Band**:
199
200 AU915 and US915:value 0x00 ~~ 0x08
201
202 CN470: value 0x0B ~~ 0x0C
203
204 Other Bands: Always 0x00
205
206 (% style="color:blue" %)**Battery Info**:
207
208 Check the battery voltage.
209
210 Ex1: 0x0B45 = 2885mV
211
212 Ex2: 0x0B49 = 2889mV
213
214
215 === 2.3.2 Uplink Payload, FPORT~=2 ===
216
217
218 ==== (% style="color:red" %)**AT+MOD~=1**(%%) ====
219
220 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.
221
222 **Uplink Payload totals 10 bytes.**
223
224 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
225 |(% style="background-color:#4f81bd; color:White; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:White; width:30px" %)**2**|(% style="background-color:#4f81bd; color:White; width:130px" %)**1**|(% style="background-color:#4f81bd; color:White; width:70px" %)**2**|(% style="background-color:#4f81bd; color:White; width:100px" %)**1**|(% style="background-color:#4f81bd; color:White; width:120px" %)**4**
226 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+ Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count
227
228 **MOD+ Alarm+ Interrupt:**
229
230 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %)
231 |(% style="background-color:#4f81bd; color:White; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:White; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:White; width:70px" %)**bit5**|(% style="background-color:#4f81bd; color:White; width:120px" %)**bit4**
232 |(% style="width:80px" %)Value|(% style="width:80px" %)MOD|(% style="width:89px" %)Digital Interrupt
233 |(% style="width:167px" %)(((
234 Distance Alarm
235
236 0: No Alarm;
237
238 1: Alarm
239 )))
240
241 Example parse in TTNv3
242
243 [[image:image-20231209152917-1.png||height="300" width="1172"]]
244
245 (% style="color:blue" %)**Battery Info:**
246
247 Check the battery voltage for DS20L
248
249 Ex1: 0x0E10 = 3600mV
250
251
252 (% style="color:blue" %)**MOD & Alarm & Interrupt:**
253
254 (% style="color:red" %)**MOD:**
255
256 **Example: ** (0x60>>6) & 0x3f =1
257
258 **0x01:**  Regularly detect distance and report.
259 **0x02: ** Uninterrupted measurement (external power supply).
260
261 (% style="color:red" %)**Alarm:**
262
263 When the detection distance exceeds the limit, the alarm flag is set to 1.
264
265 (% style="color:red" %)**Interrupt:**
266
267 Whether it is an external interrupt.
268
269
270 (% style="color:blue" %)**Distance info:**
271
272 **Example**:
273
274 If payload is: 0708H: distance = 0708H = 1800 mm
275
276
277 (% style="color:blue" %)**Sensor State:**
278
279 Ex1: 0x00: Distance Reading is valid
280
281 Ex2: 0x0x: Distance Reading is invalid
282
283
284 (% style="color:blue" %)**Interrupt Count:**
285
286 If payload is:000007D0H: count = 07D0H =2000
287
288
289
290 ==== (% style="color:red" %)**AT+MOD~=2**(%%)** ** ====
291
292
293 The power consumption of uninterrupted measurement is high, and the device needs to use external power supply.(The switch is switched to E and the external power supply is used.)
294
295 [[image:image-20231128133704-1.png||height="189" width="441"]]
296
297
298 * **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120**
299
300 (% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %)
301 Continuously measurement with Alarm. When the distance exceeds the limit, the output IO high, instant alarm.
302
303 (% class="wikigeneratedid" %)
304 **Uplink Payload totals 9 bytes.**
305
306 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
307 |(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:35px" %)**2**|(% style="background-color:#4f81bd; color:white; width:86px" %)**1**|(% style="background-color:#4f81bd; color:white; width:86px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
308 |(% style="width:60px" %)Value|(% style="width:41px" %)BAT|(% style="width:156px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:60px" %)Distance |(% style="width:86px" %)Upper limit|(% style="width:86px" %)Lower limit
309
310 **MOD+DO+ Alarm+ Do flag+ Limit flag:**
311
312 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
313 |(% style="background-color:#4f81bd; color:white; width:30px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:35px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]**
314 |(% style="width:30px" %)Value|(% style="width:30px" %)MOD|(% style="width:60px" %)(((
315 (((
316 DO
317 )))
318
319 (((
320 0：Within limit
321
322 1：Out of limit
323 )))
324 )))|(% style="width:73px" %)(((
325 Alarm
326
327 0: No Alarm;
328
329 1: Alarm
330 )))|(% style="width:150px" %)(((
331 DO flag
332
333 0：the over-limit alarm mode
334
335 1：the person or object count mode
336 )))|(% style="width:103px" %)Limit flag
337 (0~~3)
338
339 Example parse in TTNv3
340
341 [[image:image-20231209171127-3.png||height="374" width="1209"]]
342
343 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
344
345 (% style="color:red" %)**MOD:**
346
347 **Example: ** (0x60>>6) & 0x3f =1
348
349 **0x01:**  Regularly detect distance and report.
350 **0x02: ** Uninterrupted measurement (external power supply).
351
352 (% style="color:red" %)**Alarm:**
353
354 When the detection distance exceeds the limit, the alarm flag is set to 1.
355
356 (% style="color:red" %)**DO:**
357
358 Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
359
360 (% style="color:red" %)**Threshold Flag for Alarm:**
361
362 Mode for setting threshold: **0~~3**
363
364 **0:** Distance limit range is not enabled, alarm:0.
365
366 **1:** Trigger Alarm if distance exceed the range between lower and upper.
367
368 **2:** Trigger Alarm if distance smaller than the upper limit.
369
370 **3: **Trigger Alarm if distance bigger than the lower limit .
371
372
373 (% style="color:blue" %)**Distance:**
374
375 Actual sampling distance values.
376
377 **Example:**
378
379 **AT+DOL=1,500,244,**(% style="color:red" %)0(%%)**,120  **
380
381 The distance is detected every 120ms.
382
383 When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time.
384
385 When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted.
386
387 If payload is: 0708H: distance = 0708H = 1800 mm
388
389
390 (% style="color:blue" %)**Upper limit:**
391
392 Show the pre-set upper limit in Hex, Unit: mm.
393
394 Ex: 01F4(H)=500mm
395
396
397 (% style="color:blue" %)**Lower limit:**
398
399 Show the pre-set lower limit in Hex, Unit: mm.
400
401 Ex: 0xF4(H)=244mm
402
403
404 * **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
405
406 Continuously measurement with Alarm, detect and count people or things passing by in distance limit mode.
407
408 **Uplink Payload totals 11 bytes.**
409
410 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
411 |(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
412 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
413
414 **MOD+DO+ Alarm+ Do flag+ Limit flag:**
415
416 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
417 |(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]**
418 |(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)(((
419 (((
420 DO
421 )))
422
423 (((
424 0：Within limit
425
426 1：Out of limit
427 )))
428 )))|(% style="width:73px" %)(((
429 Alarm
430
431 0: No Alarm;
432
433 1: Alarm
434 )))|(% style="width:150px" %)(((
435 DO flag
436
437 0：the over-limit alarm mode
438
439 1：the person or object count mode
440 )))|(% style="width:103px" %)Limit flag
441 (0~~3)
442
443 Example parse in TTNv3
444
445 [[image:image-20231209173457-5.png||height="277" width="1098"]]
446
447 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
448
449 (% style="color:red" %)**MOD:**
450
451 **Example: ** (0x60>>6) & 0x3f =1
452
453 **0x01:**  Regularly detect distance and report.
454 **0x02: ** Uninterrupted measurement (external power supply).
455
456 (% style="color:red" %)**Alarm:**
457
458 When the detection distance exceeds the limit, the alarm flag is set to 1.
459
460 (% style="color:red" %)**Do:**
461
462 Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
463
464 (% style="color:red" %)**Threshold Flag for Alarm:**
465
466 Mode for setting threshold: **0~~3**
467
468 **0:** does not use upper and lower limits
469
470 **1:** Use upper and lower limits
471
472 **2:** Less than the upper limit
473
474 **3: **Greater than the lower limit
475
476
477 (% style="color:blue" %)**Distance limit alarm count:**
478
479 People or objects are collected and counted within a limited distance.
480
481 The detection of a stationary person or object at each sampling time will be repeated three times, and the fourth sampling count will be added by 1.
482
483 **Example:**
484
485 **AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120   **
486
487 People or objects passing within the distance range of [244mm,500mm] are detected and counted every 120ms.
488
489 If payload is: 0x56H, interrupt count =0x56H =86
490
491
492 (% style="color:blue" %)**Upper limit:**
493
494 Show the pre-set upper limit in Hex, Unit: mm.
495
496 Ex: 01F4(H)=500mm
497
498
499 (% style="color:blue" %)**Lower limit:**
500
501 Show the pre-set lower limit in Hex, Unit: mm.
502
503 Ex: 0xF4(H)=244mm
504
505
506 == 2.4 Decode payload in The Things Network ==
507
508
509 While using TTN network, you can add the payload format to decode the payload.
510
511 [[image:image-20231206143515-1.png||height="534" width="759"]]
512
513
514 (((
515 The payload decoder function for TTN is here:
516 )))
517
518 (((
519 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
520 )))
521
522
523 == 2.5 ​Show Data in DataCake IoT Server ==
524
525
526 (((
527 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onhuman-friendlya in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
528 )))
529
530
531 (((
532 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
533 )))
534
535 (((
536 (% 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:**
537 )))
538
539
540 [[image:image-20231207153532-6.png||height="562" width="861"]]
541
542
543 [[image:image-20231207155940-8.png]]
544
545 For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]]
546
547 [[image:image-20231207160733-11.png||height="429" width="759"]]
548
549
550 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
551
552 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
553
554 [[image:image-20231207160343-10.png||height="665" width="705"]]
555
556
557 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
558
559 [[image:image-20231129100454-2.png||height="501" width="928"]]
560
561
562 == 2.6 Frequency Plans ==
563
564
565 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.
566
567 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
568
569
570 = 3. Configure DS20L =
571
572 == 3.1 Configure Methods ==
573
574
575 DS20L supports below configure method:
576
577 * 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.5UARTConnectionforDS20Lmotherboard]].
578
579 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
580
581 == 3.2 General Commands ==
582
583
584 These commands are to configure:
585
586 * General system settings like: uplink interval.
587
588 * LoRaWAN protocol & radio related command.
589
590 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
591
592 [[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/]]
593
594
595 == 3.3 Commands special design for DS20L ==
596
597
598 Below commands only valid for DS20L, as below:
599
600
601 === 3.3.1 Set Transmit Interval Time ===
602
603
604 (((
605 Feature: Change LoRaWAN End Node Transmit Interval.
606 )))
607
608 (((
609 (% style="color:blue" %)**AT Command: AT+TDC**
610 )))
611
612 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
613 |=(% 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**
614 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
615 30000
616 OK
617 the interval is 30000ms = 30s
618 )))
619 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
620 OK
621 Set transmit interval to 60000ms = 60 seconds
622 )))
623
624 (((
625 (% style="color:blue" %)**Downlink Command: 0x01**
626 )))
627
628 (((
629 Format: Command Code (0x01) followed by 3 bytes time value.
630 )))
631
632 (((
633 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
634 )))
635
636 * (((
637 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
638 )))
639 * (((
640 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
641
642
643
644 )))
645
646 === 3.3.2 Set Interrupt Mode ===
647
648
649 Feature, Set Interrupt mode for pin of GPIO_EXTI.
650
651 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
652
653 (% style="color:blue" %)**AT Command: AT+INTMOD**
654
655 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
656 |=(% 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**
657 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
658 0
659 OK
660 the mode is 0 =Disable Interrupt
661 )))
662 |(% style="width:154px" %)(((
663 AT+INTMOD=3
664
665 (default)
666 )))|(% style="width:196px" %)(((
667 Set Transmit Interval
668 0. (Disable Interrupt),
669 ~1. (Trigger by rising and falling edge)
670 2. (Trigger by falling edge)
671 3. (Trigger by rising edge)
672 )))|(% style="width:157px" %)OK
673
674 (% style="color:blue" %)**Downlink Command: 0x06**
675
676 Format: Command Code (0x06) followed by 3 bytes.
677
678 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
679
680 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
681
682 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
683
684 === 3.3.3 Set work mode ===
685
686
687 Feature: Switch working mode
688
689 (% style="color:blue" %)**AT Command: AT+MOD**
690
691 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
692 |=(% 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**
693 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
694 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
695 OK
696 Attention: Take effect after ATZ
697 )))
698 |(% style="width:162px" %)AT+MOD=2|(% style="width:191px" %)Set the working mode to(((
699 Continuously measurement with Alarm.
700 )))|(% style="width:191px" %)(((
701 OK
702 Attention: Take effect after ATZ
703 )))
704
705 (% style="color:blue" %)**Downlink Command:**
706
707 * **Example: **0x0A01 ~/~/  Same as AT+MOD=1
708
709 * **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
710
711 === 3.3.4 Set threshold and threshold mode ===
712
713
714 Feature, Set threshold and threshold mode
715
716 When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
717
718 (% style="color:blue" %)**AT Command: AT+DOL**
719
720 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
721 |(% 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**
722 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
723 0,0,0,0,400
724 OK
725 )))
726 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
727
728 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
729 |=(% 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" %) Parameter
730 |(% rowspan="11" style="color:blue; width:120px" %)(((
731
732
733
734
735
736
737
738
739
740
741
742 **AT+DOL=1,1800,3,0,400**
743 )))|(% rowspan="4" style="width:240px" %)(((
744
745
746
747
748 The first bit sets the limit mode
749 )))|(% style="width:150px" %)0: Do not use upper and lower limits
750 |(% style="width:251px" %)1: Use upper and lower limits
751 |(% style="width:251px" %)2:Less than the upper limit
752 |(% style="width:251px" %)3: Greater than the lower limit
753 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
754 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
755 |(% 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
756 |(% style="width:251px" %)1 Person or object counting statistics
757 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
758 100~~10000ms
759
760
761 )))
762
763 (% style="color:blue" %)**Downlink Command: 0x07**
764
765 Format: Command Code (0x07) followed by 9 bytes.
766
767 If the downlink payload=**07 01 0708 0064 00 0190**, it means set the END Node's limit mode to 0x01,upper limit value to 0x0708=1800(mm), lower limit value to 0x0064=100(mm), to over-limit alarm(0x00) ,the sampling time to 0x0190=400(ms), while type code is 0x07.
768
769 * Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
770
771 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
772
773 * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800,100,0,400
774
775 * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,0,100,0,400
776
777 (% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.**
778
779 **For example:**
780
781 * **AT+MOD=1**
782
783 **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
784
785 Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1:
786
787 [[image:image-20231211113204-2.png||height="292" width="1093"]]
788
789 * **AT+MOD=2  **
790
791 **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
792
793 If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1:
794
795 [[image:image-20231211114932-3.png||height="277" width="1248"]]
796
797
798
799
800
801 = 4. Battery & Power Consumption =
802
803
804 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.
805
806 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
807
808
809 = 5. OTA Firmware update =
810
811
812 (% class="wikigeneratedid" %)
813 User can change firmware DS20L to:
814
815 * Change Frequency band/ region.
816
817 * Update with new features.
818
819 * Fix bugs.
820
821 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
822
823 Methods to Update Firmware:
824
825 * (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/]]**
826
827 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.5UARTConnectionforDS20Lmotherboard]]**.
828
829 = 6. FAQ =
830
831 == 6.1 What is the frequency plan for DS20L? ==
832
833
834 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"]]
835
836
837 == 6.2 DS20L programming line ==
838
839
840 [[image:image-20231212150243-1.jpeg||height="448" width="1009"]]
841
842 feature:
843
844 for AT commands
845
846 Update the firmware of DS20L
847
848 Support interrupt mode
849
850
851 == 6.3 LiDAR probe position ==
852
853
854 [[image:1701155390576-216.png||height="285" width="307"]]
855
856 The black oval hole in the picture is the LiDAR probe.
857
858
859 == 6.4 Interface definition ==
860
861 [[image:image-20231128151132-2.png||height="305" width="557"]]
862
863
864 = 7. Trouble Shooting =
865
866 == 7.1 AT Command input doesn't work ==
867
868
869 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.
870
871
872 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
873
874
875 (((
876 (% 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.)
877 )))
878
879 (((
880 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
881 )))
882
883
884 (((
885 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
886 )))
887
888 (((
889 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
890 )))
891
892
893 = 8. Order Info =
894
895
896 Part Number: (% style="color:blue" %)**DS20L-XXX**
897
898 (% style="color:red" %)**XXX**(%%): **The default frequency band**
899
900 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
901
902 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
903
904 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
905
906 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
907
908 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
909
910 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
911
912 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
913
914 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
915
916 = 9. ​Packing Info =
917
918
919 (% style="color:#037691" %)**Package Includes**:
920
921 * DS20L LoRaWAN Smart Distance Detector x 1
922
923 (% style="color:#037691" %)**Dimension and weight**:
924
925 * Device Size: cm
926
927 * Device Weight: g
928
929 * Package Size / pcs : cm
930
931 * Weight / pcs : g
932
933 = 10. Support =
934
935
936 * 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.
937
938 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].

Applications

Navigation

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