Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 116.3
edited by Xiaoling
on 2023/11/13 10:38
Change comment: There is no comment for this version
To version 113.5
edited by Xiaoling
on 2023/11/10 09:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -22,7 +22,7 @@
22 22  == 1.1 What is LoRaWAN Smart Distance Detector ==
23 23  
24 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.
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.
26 26  
27 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 28  consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
... ... @@ -31,8 +31,9 @@
31 31  
32 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 33  
34 +DS20L supports (% style="color:blue" %)**Datalog feature**(%%). It will record the data when there is no network coverage and users can retrieve the sensor value later to ensure no miss for every sensor reading.
34 34  
35 -[[image:image-20231110102635-5.png||height="402" width="807"]]
36 +[[image:image-20231110091506-4.png||height="391" width="768"]]
36 36  
37 37  
38 38  == 1.2 ​Features ==
... ... @@ -44,11 +44,10 @@
44 44  * AT Commands to change parameters
45 45  * Remotely configure parameters via LoRaWAN Downlink
46 46  * Alarm & Counting mode
48 +* Datalog Feature
47 47  * Firmware upgradable via program port or LoRa protocol
48 48  * Built-in 2400mAh battery or power by external power source
49 49  
50 -(% style="display:none" %)
51 -
52 52  == 1.3 Specification ==
53 53  
54 54  
... ... @@ -62,31 +62,16 @@
62 62  * ToF FoV: ±9°, Total 18°
63 63  * Light source: VCSEL
64 64  
65 +
65 65  (% style="display:none" %)
66 66  
67 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 84  = 2. Configure DS20L to connect to LoRaWAN network =
85 85  
86 86  == 2.1 How it works ==
87 87  
88 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.
74 +The LDS12-LB 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 LDS12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
90 90  
91 91  (% style="display:none" %) (%%)
92 92  
... ... @@ -95,14 +95,15 @@
95 95  
96 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 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" %)
83 +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.
99 99  
100 -[[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
85 +[[image:image-20231110091447-3.png||height="383" width="752"]](% style="display:none" %)
101 101  
102 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
103 103  
104 -Each DS20L is shipped with a sticker with the default device EUI as below:
88 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB.
105 105  
90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below:
91 +
106 106  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
107 107  
108 108  
... ... @@ -130,10 +130,10 @@
130 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 131  
132 132  
133 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB
134 134  
135 135  
136 -Press the button for 5 seconds to activate the DS20L.
122 +Press the button for 5 seconds to activate the LDS12-LB.
137 137  
138 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 139  
... ... @@ -145,7 +145,7 @@
145 145  === 2.3.1 Device Status, FPORT~=5 ===
146 146  
147 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.
134 +Users can use the downlink command(**0x26 01**) to ask LDS12-LB to send device configure detail, include device configure status. LDS12-LB will uplink a payload via FPort=5 to server.
149 149  
150 150  The Payload format is as below.
151 151  
... ... @@ -159,7 +159,7 @@
159 159  
160 160  [[image:image-20230805103904-1.png||height="131" width="711"]]
161 161  
162 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24
148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
163 163  
164 164  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
165 165  
... ... @@ -214,7 +214,7 @@
214 214  
215 215  
216 216  (((
217 -DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will:
203 +LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
218 218  
219 219  periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
220 220  
... ... @@ -239,7 +239,7 @@
239 239  ==== (% style="color:blue" %)**Battery Info**(%%) ====
240 240  
241 241  
242 -Check the battery voltage for DS20L.
228 +Check the battery voltage for LDS12-LB.
243 243  
244 244  Ex1: 0x0B45 = 2885mV
245 245  
... ... @@ -303,7 +303,7 @@
303 303  
304 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 305  
306 -Note: The Internet Pin is a separate pin in the screw terminal. See pin mapping of GPIO_EXTI .
292 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
307 307  
308 308  **Example:**
309 309  
... ... @@ -344,7 +344,7 @@
344 344  === 2.3.3 Historical measuring distance, FPORT~=3 ===
345 345  
346 346  
347 -DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
333 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
348 348  
349 349  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
350 350  
... ... @@ -369,7 +369,7 @@
369 369  )))
370 370  
371 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.
358 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
373 373  )))
374 374  
375 375  For example, in the US915 band, the max payload for different DR is:
... ... @@ -382,7 +382,7 @@
382 382  
383 383  **d) DR3:** total payload includes 22 entries of data.
384 384  
385 -If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
371 +If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
386 386  
387 387  
388 388  **Downlink:**
... ... @@ -436,7 +436,7 @@
436 436  )))
437 437  
438 438  (((
439 -DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
425 +LDS12-LB TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
440 440  )))
441 441  
442 442  
... ... @@ -465,7 +465,7 @@
465 465  
466 466  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
467 467  
468 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.**
469 469  
470 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 471  
... ... @@ -478,25 +478,27 @@
478 478  == 2.5 Datalog Feature ==
479 479  
480 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.
467 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LDS12-LB will store the reading for future retrieving purposes.
482 482  
483 483  
484 484  === 2.5.1 Ways to get datalog via LoRaWAN ===
485 485  
486 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.
473 +Set PNACKMD=1, LDS12-LB will wait for ACK for every uplink, when there is no LoRaWAN network,LDS12-LB 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 488  
489 489  * (((
490 -a) DS20L will do an ACK check for data records sending to make sure every data arrive server.
476 +a) LDS12-LB will do an ACK check for data records sending to make sure every data arrive server.
491 491  )))
492 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.
479 +b) LDS12-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but LDS12-LB 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 LDS12-LB gets a ACK, LDS12-LB will consider there is a network connection and resend all NONE-ACK messages.
494 494  )))
495 495  
482 +
483 +
496 496  === 2.5.2 Unix TimeStamp ===
497 497  
498 498  
499 -DS20L uses Unix TimeStamp format based on
487 +LDS12-LB uses Unix TimeStamp format based on
500 500  
501 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 502  
... ... @@ -515,7 +515,7 @@
515 515  
516 516  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
517 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).
506 +Once LDS12-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LDS12-LB. If LDS12-LB fails to get the time from the server, LDS12-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
519 519  
520 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 521  
... ... @@ -543,7 +543,7 @@
543 543  )))
544 544  
545 545  (((
546 -Uplink Internal =5s，means DS20L will send one packet every 5s. range 5~~255s.
534 +Uplink Internal =5s，means LDS12-LB will send one packet every 5s. range 5~~255s.
547 547  )))
548 548  
549 549  
... ... @@ -550,17 +550,17 @@
550 550  == 2.6 Frequency Plans ==
551 551  
552 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.
541 +The LDS12-LB 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 554  
555 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 556  
557 557  
558 -3. Configure DS20L
546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB
559 559  
560 560  == 3.1 Configure Methods ==
561 561  
562 562  
563 -DS20L supports below configure method:
551 +LDS12-LB supports below configure method:
564 564  
565 565  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
566 566  
... ... @@ -582,10 +582,10 @@
582 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 583  
584 584  
585 -== 3.3 Commands special design for DS20L ==
573 +== 3.3 Commands special design for LDS12-LB ==
586 586  
587 587  
588 -These commands only valid for DS20L, as below:
576 +These commands only valid for LDS12-LB, as below:
589 589  
590 590  
591 591  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -671,10 +671,11 @@
671 671  
672 672  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
673 673  
662 +
674 674  = 4. Battery & Power Consumption =
675 675  
676 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.
666 +LDS12-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
678 678  
679 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 680  
... ... @@ -683,7 +683,7 @@
683 683  
684 684  
685 685  (% class="wikigeneratedid" %)
686 -User can change firmware DS20L to:
675 +User can change firmware LDS12-LB to:
687 687  
688 688  * Change Frequency band/ region.
689 689  
... ... @@ -691,7 +691,7 @@
691 691  
692 692  * Fix bugs.
693 693  
694 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
683 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/w1p7ukjrx49e62r/AAB3uCNCt-koYUvMkZUPBRSca?dl=0]]**
695 695  
696 696  Methods to Update Firmware:
697 697  
... ... @@ -701,10 +701,10 @@
701 701  
702 702  = 6. FAQ =
703 703  
704 -== 6.1 What is the frequency plan for DS20L? ==
693 +== 6.1 What is the frequency plan for LDS12-LB? ==
705 705  
706 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"]]
696 +LDS12-LB 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 708  
709 709  
710 710  = 7. Trouble Shooting =
image-20231110102635-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -84.7 KB
Content