Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 115.1
edited by Edwin Chen
on 2023/11/11 10:33
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
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,10 +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 -
51 51  == 1.3 Specification ==
52 52  
53 53  
... ... @@ -61,30 +61,16 @@
61 61  * ToF FoV: ±9°, Total 18°
62 62  * Light source: VCSEL
63 63  
65 +
64 64  (% style="display:none" %)
65 65  
66 66  
67 -== 1.4 Power Consumption ==
68 -
69 -
70 -**Battery Power Mode:**
71 -
72 -* Idle: xxx mA @ 3.3v
73 -* Max : xxx mA
74 -
75 -
76 -**Continuously mode**:
77 -
78 -* Idle: xxx mA @ 3.3v
79 -* Max : xxx mA
80 -
81 -
82 82  = 2. Configure DS20L to connect to LoRaWAN network =
83 83  
84 84  == 2.1 How it works ==
85 85  
86 86  
87 -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.
88 88  
89 89  (% style="display:none" %) (%%)
90 90  
... ... @@ -93,14 +93,15 @@
93 93  
94 94  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.
95 95  
96 -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.
97 97  
98 -[[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" %)
99 99  
100 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
101 101  
102 -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.
103 103  
90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below:
91 +
104 104  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
105 105  
106 106  
... ... @@ -128,10 +128,10 @@
128 128  [[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"]]
129 129  
130 130  
131 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB
132 132  
133 133  
134 -Press the button for 5 seconds to activate the DS20L.
122 +Press the button for 5 seconds to activate the LDS12-LB.
135 135  
136 136  (% 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.
137 137  
... ... @@ -143,7 +143,7 @@
143 143  === 2.3.1 Device Status, FPORT~=5 ===
144 144  
145 145  
146 -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.
147 147  
148 148  The Payload format is as below.
149 149  
... ... @@ -157,7 +157,7 @@
157 157  
158 158  [[image:image-20230805103904-1.png||height="131" width="711"]]
159 159  
160 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24
148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
161 161  
162 162  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
163 163  
... ... @@ -212,7 +212,7 @@
212 212  
213 213  
214 214  (((
215 -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:
216 216  
217 217  periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
218 218  
... ... @@ -237,7 +237,7 @@
237 237  ==== (% style="color:blue" %)**Battery Info**(%%) ====
238 238  
239 239  
240 -Check the battery voltage for DS20L.
228 +Check the battery voltage for LDS12-LB.
241 241  
242 242  Ex1: 0x0B45 = 2885mV
243 243  
... ... @@ -301,7 +301,7 @@
301 301  
302 302  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.
303 303  
304 -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 .
305 305  
306 306  **Example:**
307 307  
... ... @@ -342,7 +342,7 @@
342 342  === 2.3.3 Historical measuring distance, FPORT~=3 ===
343 343  
344 344  
345 -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"]].
346 346  
347 347  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
348 348  
... ... @@ -367,7 +367,7 @@
367 367  )))
368 368  
369 369  * (((
370 -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.
371 371  )))
372 372  
373 373  For example, in the US915 band, the max payload for different DR is:
... ... @@ -380,7 +380,7 @@
380 380  
381 381  **d) DR3:** total payload includes 22 entries of data.
382 382  
383 -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
384 384  
385 385  
386 386  **Downlink:**
... ... @@ -434,7 +434,7 @@
434 434  )))
435 435  
436 436  (((
437 -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]]
438 438  )))
439 439  
440 440  
... ... @@ -463,7 +463,7 @@
463 463  
464 464  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
465 465  
466 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.**
467 467  
468 468  [[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"]]
469 469  
... ... @@ -476,25 +476,27 @@
476 476  == 2.5 Datalog Feature ==
477 477  
478 478  
479 -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.
480 480  
481 481  
482 482  === 2.5.1 Ways to get datalog via LoRaWAN ===
483 483  
484 484  
485 -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.
486 486  
487 487  * (((
488 -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.
489 489  )))
490 490  * (((
491 -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.
492 492  )))
493 493  
482 +
483 +
494 494  === 2.5.2 Unix TimeStamp ===
495 495  
496 496  
497 -DS20L uses Unix TimeStamp format based on
487 +LDS12-LB uses Unix TimeStamp format based on
498 498  
499 499  [[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"]]
500 500  
... ... @@ -513,7 +513,7 @@
513 513  
514 514  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
515 515  
516 -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).
517 517  
518 518  (% 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.**
519 519  
... ... @@ -541,7 +541,7 @@
541 541  )))
542 542  
543 543  (((
544 -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.
545 545  )))
546 546  
547 547  
... ... @@ -548,17 +548,17 @@
548 548  == 2.6 Frequency Plans ==
549 549  
550 550  
551 -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.
552 552  
553 553  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
554 554  
555 555  
556 -3. Configure DS20L
546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB
557 557  
558 558  == 3.1 Configure Methods ==
559 559  
560 560  
561 -DS20L supports below configure method:
551 +LDS12-LB supports below configure method:
562 562  
563 563  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
564 564  
... ... @@ -566,7 +566,6 @@
566 566  
567 567  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
568 568  
569 -
570 570  == 3.2 General Commands ==
571 571  
572 572  
... ... @@ -581,10 +581,10 @@
581 581  [[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/]]
582 582  
583 583  
584 -== 3.3 Commands special design for DS20L ==
573 +== 3.3 Commands special design for LDS12-LB ==
585 585  
586 586  
587 -These commands only valid for DS20L, as below:
576 +These commands only valid for LDS12-LB, as below:
588 588  
589 589  
590 590  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -674,7 +674,7 @@
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  
... ... @@ -699,13 +699,12 @@
699 699  
700 700  * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
701 701  
702 -
703 703  = 6. FAQ =
704 704  
705 -== 6.1 What is the frequency plan for DS20L? ==
693 +== 6.1 What is the frequency plan for LDS12-LB? ==
706 706  
707 707  
708 -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"]]
709 709  
710 710  
711 711  = 7. Trouble Shooting =
... ... @@ -760,7 +760,6 @@
760 760  
761 761  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
762 762  
763 -
764 764  = 9. ​Packing Info =
765 765  
766 766  
... ... @@ -778,7 +778,6 @@
778 778  
779 779  * Weight / pcs : g
780 780  
781 -
782 782  = 10. Support =
783 783  
784 784  
image-20231110102635-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -84.7 KB
Content