Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 124.3
edited by Xiaoling
on 2023/11/28 15:14
Change comment: There is no comment for this version
To version 143.1
edited by Mengting Qiu
on 2023/12/07 15:42
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.ting
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  
10 10  
11 -**Table of Contents：**
11 +**Table of Contents:(% style="display:none" %) (%%)**
12 12  
13 13  {{toc/}}
14 14  
... ... @@ -91,7 +91,7 @@
91 91  
92 92  [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
93 93  
94 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
94 +=== Step 1: Create a device in TTN with the OTAA keys from DS20L. ===
95 95  
96 96  Each DS20L is shipped with a sticker with the default device EUI as below:
97 97  
... ... @@ -98,32 +98,22 @@
98 98  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
99 99  
100 100  
101 -You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
101 +You can enter this key in the LoRaWAN Server portal. Below is TTN V3 screenshot:
102 102  
103 103  
104 104  (% style="color:blue" %)**Register the device**
105 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"]]
106 +[[image:image-20231207144600-2.png||height="703" width="756"]]
107 107  
108 108  
109 -(% style="color:blue" %)**Add APP EUI and DEV EUI**
109 +(% style="color:blue" %)**Add DevEUI and AppKey**
110 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"]]
111 +[[image:image-20231207145121-5.png||height="540" width="756"]]
112 112  
113 113  
114 -(% style="color:blue" %)**Add APP EUI in the application**
115 115  
115 +=== Step 2: Activate on DS20L ===
116 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 127  [[image:image-20231128133704-1.png||height="189" width="441"]]
128 128  
129 129  Press the button for 5 seconds to activate the DS20L.
... ... @@ -133,6 +133,7 @@
133 133  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
134 134  
135 135  
126 +
136 136  == 2.3 ​Uplink Payload ==
137 137  
138 138  === 2.3.1 Device Status, FPORT~=5 ===
... ... @@ -150,7 +150,7 @@
150 150  
151 151  Example parse in TTNv3
152 152  
153 -[[image:1701149922873-259.png]]
144 +[[image:image-20231206151412-3.png||height="179" width="1070"]]
154 154  
155 155  (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
156 156  
... ... @@ -216,7 +216,7 @@
216 216  |(% 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**
217 217  |(% 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
218 218  
219 -[[image:1701155076393-719.png]]
210 +[[image:image-20231206195704-6.png||height="238" width="999"]]
220 220  
221 221  (% style="color:blue" %)**Battery Info:**
222 222  
... ... @@ -292,19 +292,19 @@
292 292  
293 293  (% style="color:red" %)**Limit flag:**
294 294  
295 -Mode for setting threshold: 0~~5
286 +Mode for setting threshold: **0~~5**
296 296  
297 -0: does not use upper and lower limits
288 +**0:** does not use upper and lower limits
298 298  
299 -1: Use upper and lower limits
290 +**1:** Use upper and lower limits
300 300  
301 -2: is less than the lower limit value
292 +**2:** is less than the lower limit value
302 302  
303 -3: is greater than the lower limit value
294 +**3:** is greater than the lower limit value
304 304  
305 -4: is less than the upper limit
296 +**4:** is less than the upper limit
306 306  
307 -5: is greater than the upper limit
298 +**5:** is greater than the upper limit
308 308  
309 309  
310 310  (% style="color:blue" %)**Upper limit:**
... ... @@ -317,94 +317,12 @@
317 317  The lower limit of the threshold cannot be less than 3mm.
318 318  
319 319  
320 -=== 2.3.3 Historical measuring distance, FPORT~=3 ===
311 +== 2.4 Decode payload in The Things Network ==
321 321  
322 322  
323 -DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
324 -
325 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
326 -
327 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
328 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
329 -**Size(bytes)**
330 -)))|=(% 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
331 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
332 -Reserve(0xFF)
333 -)))|Distance|Distance signal strength|(% style="width:88px" %)(((
334 -LiDAR temp
335 -)))|(% style="width:85px" %)Unix TimeStamp
336 -
337 -**Interrupt flag & Interrupt level:**
338 -
339 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
340 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
341 -**Size(bit)**
342 -)))|=(% 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**
343 -|(% 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" %)(((
344 -Interrupt flag
345 -)))
346 -
347 -* (((
348 -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.
349 -)))
350 -
351 -For example, in the US915 band, the max payload for different DR is:
352 -
353 -**a) DR0:** max is 11 bytes so one entry of data
354 -
355 -**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
356 -
357 -**c) DR2:** total payload includes 11 entries of data
358 -
359 -**d) DR3:** total payload includes 22 entries of data.
360 -
361 -If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
362 -
363 -
364 -**Downlink:**
365 -
366 -0x31 64 CC 68 0C 64 CC 69 74 05
367 -
368 -[[image:image-20230805144936-2.png||height="113" width="746"]]
369 -
370 -**Uplink:**
371 -
372 -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
373 -
374 -
375 -**Parsed Value:**
376 -
377 -[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
378 -
379 -
380 -[360,176,30,High,True,2023-08-04 02:53:00],
381 -
382 -[355,168,30,Low,False,2023-08-04 02:53:29],
383 -
384 -[245,211,30,Low,False,2023-08-04 02:54:29],
385 -
386 -[57,700,30,Low,False,2023-08-04 02:55:29],
387 -
388 -[361,164,30,Low,True,2023-08-04 02:56:00],
389 -
390 -[337,184,30,Low,False,2023-08-04 02:56:40],
391 -
392 -[20,4458,30,Low,False,2023-08-04 02:57:40],
393 -
394 -[362,173,30,Low,False,2023-08-04 02:58:53],
395 -
396 -
397 -**History read from serial port：**
398 -
399 -[[image:image-20230805145056-3.png]]
400 -
401 -
402 -=== 2.3.4 Decode payload in The Things Network ===
403 -
404 -
405 405  While using TTN network, you can add the payload format to decode the payload.
406 406  
407 -[[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"]]
316 +[[image:image-20231206143515-1.png||height="534" width="759"]]
408 408  
409 409  
410 410  (((
... ... @@ -416,7 +416,7 @@
416 416  )))
417 417  
418 418  
419 -== 2.4 ​Show Data in DataCake IoT Server ==
328 +== 2.5 ​Show Data in DataCake IoT Server ==
420 420  
421 421  
422 422  (((
... ... @@ -433,10 +433,10 @@
433 433  )))
434 434  
435 435  
436 -[[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"]]
345 +[[image:image-20231207153532-6.png||height="579" width="888"]]
437 437  
438 438  
439 -[[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"]]
348 +[[image:image-20231207154046-7.png||height="441" width="846"]]
440 440  
441 441  
442 442  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
... ... @@ -448,10 +448,10 @@
448 448  
449 449  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
450 450  
451 -[[image:1701152946067-561.png]]
360 +[[image:image-20231129100454-2.png||height="501" width="928"]]
452 452  
453 453  
454 -== 2.5 Frequency Plans ==
363 +== 2.6 Frequency Plans ==
455 455  
456 456  
457 457  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.
... ... @@ -532,6 +532,9 @@
532 532  )))
533 533  * (((
534 534  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
444 +
445 +
446 +
535 535  )))
536 536  
537 537  === 3.3.2 Set Interrupt Mode ===
... ... @@ -572,7 +572,7 @@
572 572  
573 573  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
574 574  
575 -== 3.3.3 Set work mode ==
487 +=== 3.3.3 Set work mode ===
576 576  
577 577  
578 578  Feature: Switch working mode
... ... @@ -589,9 +589,9 @@
589 589  
590 590  (% style="color:blue" %)**Downlink Command:**
591 591  
592 -* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
504 +* **Example: **0x0A01 ~/~/  Same as AT+MOD=1
593 593  
594 -* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
506 +* **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
595 595  
596 596  === 3.3.4 Set threshold and threshold mode ===
597 597  
... ... @@ -610,9 +610,29 @@
610 610  )))
611 611  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
612 612  
613 -
614 614  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
615 -|(% 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
526 +|(% rowspan="11" style="color:blue; width:120px" %)(((
527 +
528 +
529 +
530 +
531 +
532 +
533 +
534 +
535 +
536 +
537 +
538 +**AT+DOL=5,1800,0,0,400**
539 +)))|(% rowspan="6" style="width:240px" %)(((
540 +
541 +
542 +
543 +
544 +
545 +
546 +The first bit sets the limit mode
547 +)))|(% style="width:150px" %)0: Do not use upper and lower limits
616 616  |(% style="width:251px" %)1: Use upper and lower limits
617 617  |(% style="width:251px" %)2: Less than the lower limit
618 618  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -630,21 +630,22 @@
630 630  
631 631  (% style="color:blue" %)**Downlink Command: 0x07**
632 632  
633 -Format: Command Code (0x07) followed by 9bytes.
565 +Format: Command Code (0x07) followed by 9 bytes.
634 634  
635 -* Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
567 +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.
636 636  
569 +* Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
570 +
637 637  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
638 638  
639 639  * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
640 640  
641 -* Example 3: Downlink Payload: 0703200000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
575 +* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
642 642  
643 643  * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
644 644  
645 645  * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
646 646  
647 -
648 648  = 4. Battery & Power Consumption =
649 649  
650 650  
image-20231129085201-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.6 KB
Content
image-20231129100454-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.1 KB
Content
image-20231206143515-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +89.5 KB
Content
image-20231206144950-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +41.0 KB
Content
image-20231206151412-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +58.8 KB
Content
image-20231206154621-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +71.2 KB
Content
image-20231206194804-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +53.7 KB
Content
image-20231206195704-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +64.1 KB
Content
image-20231207142208-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +27.2 KB
Content
image-20231207144600-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +55.4 KB
Content
image-20231207144837-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +31.1 KB
Content
image-20231207144856-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +31.1 KB
Content
image-20231207145121-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +33.3 KB
Content
image-20231207153532-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +164.7 KB
Content
image-20231207154046-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +23.0 KB
Content