Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 116.4
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,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  
... ... @@ -62,30 +62,15 @@
62 62  * Light source: VCSEL
63 63  
64 64  
66 +(% style="display:none" %)
65 65  
66 66  
67 -== 1.4 Power Consumption ==
68 -
69 -
70 -(% style="color:#037691" %)**Battery Power Mode:**
71 -
72 -* Idle: 0.003 mA @ 3.3v
73 -* Max : 360 mA
74 -
75 -(% style="color:#037691" %)**Continuously mode**:
76 -
77 -* Idle: 21 mA @ 3.3v
78 -* Max : 360 mA
79 -
80 -
81 -
82 -
83 83  = 2. Configure DS20L to connect to LoRaWAN network =
84 84  
85 85  == 2.1 How it works ==
86 86  
87 87  
88 -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.
89 89  
90 90  (% style="display:none" %) (%%)
91 91  
... ... @@ -94,14 +94,15 @@
94 94  
95 95  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.
96 96  
97 -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.
98 98  
99 -[[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" %)
100 100  
101 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
102 102  
103 -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.
104 104  
90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below:
91 +
105 105  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
106 106  
107 107  
... ... @@ -129,10 +129,10 @@
129 129  [[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"]]
130 130  
131 131  
132 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB
133 133  
134 134  
135 -Press the button for 5 seconds to activate the DS20L.
122 +Press the button for 5 seconds to activate the LDS12-LB.
136 136  
137 137  (% 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.
138 138  
... ... @@ -144,7 +144,7 @@
144 144  === 2.3.1 Device Status, FPORT~=5 ===
145 145  
146 146  
147 -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.
148 148  
149 149  The Payload format is as below.
150 150  
... ... @@ -158,7 +158,7 @@
158 158  
159 159  [[image:image-20230805103904-1.png||height="131" width="711"]]
160 160  
161 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24
148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
162 162  
163 163  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
164 164  
... ... @@ -213,7 +213,7 @@
213 213  
214 214  
215 215  (((
216 -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:
217 217  
218 218  periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
219 219  
... ... @@ -238,7 +238,7 @@
238 238  ==== (% style="color:blue" %)**Battery Info**(%%) ====
239 239  
240 240  
241 -Check the battery voltage for DS20L.
228 +Check the battery voltage for LDS12-LB.
242 242  
243 243  Ex1: 0x0B45 = 2885mV
244 244  
... ... @@ -302,7 +302,7 @@
302 302  
303 303  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.
304 304  
305 -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 .
306 306  
307 307  **Example:**
308 308  
... ... @@ -343,7 +343,7 @@
343 343  === 2.3.3 Historical measuring distance, FPORT~=3 ===
344 344  
345 345  
346 -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"]].
347 347  
348 348  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
349 349  
... ... @@ -368,7 +368,7 @@
368 368  )))
369 369  
370 370  * (((
371 -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.
372 372  )))
373 373  
374 374  For example, in the US915 band, the max payload for different DR is:
... ... @@ -381,7 +381,7 @@
381 381  
382 382  **d) DR3:** total payload includes 22 entries of data.
383 383  
384 -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
385 385  
386 386  
387 387  **Downlink:**
... ... @@ -435,7 +435,7 @@
435 435  )))
436 436  
437 437  (((
438 -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]]
439 439  )))
440 440  
441 441  
... ... @@ -464,7 +464,7 @@
464 464  
465 465  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
466 466  
467 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.**
468 468  
469 469  [[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"]]
470 470  
... ... @@ -477,25 +477,27 @@
477 477  == 2.5 Datalog Feature ==
478 478  
479 479  
480 -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.
481 481  
482 482  
483 483  === 2.5.1 Ways to get datalog via LoRaWAN ===
484 484  
485 485  
486 -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.
487 487  
488 488  * (((
489 -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.
490 490  )))
491 491  * (((
492 -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.
493 493  )))
494 494  
482 +
483 +
495 495  === 2.5.2 Unix TimeStamp ===
496 496  
497 497  
498 -DS20L uses Unix TimeStamp format based on
487 +LDS12-LB uses Unix TimeStamp format based on
499 499  
500 500  [[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"]]
501 501  
... ... @@ -514,7 +514,7 @@
514 514  
515 515  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
516 516  
517 -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).
518 518  
519 519  (% 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.**
520 520  
... ... @@ -542,7 +542,7 @@
542 542  )))
543 543  
544 544  (((
545 -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.
546 546  )))
547 547  
548 548  
... ... @@ -549,17 +549,17 @@
549 549  == 2.6 Frequency Plans ==
550 550  
551 551  
552 -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.
553 553  
554 554  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
555 555  
556 556  
557 -3. Configure DS20L
546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB
558 558  
559 559  == 3.1 Configure Methods ==
560 560  
561 561  
562 -DS20L supports below configure method:
551 +LDS12-LB supports below configure method:
563 563  
564 564  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
565 565  
... ... @@ -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 ===
... ... @@ -670,10 +670,11 @@
670 670  
671 671  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
672 672  
662 +
673 673  = 4. Battery & Power Consumption =
674 674  
675 675  
676 -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.
677 677  
678 678  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
679 679  
... ... @@ -682,7 +682,7 @@
682 682  
683 683  
684 684  (% class="wikigeneratedid" %)
685 -User can change firmware DS20L to:
675 +User can change firmware LDS12-LB to:
686 686  
687 687  * Change Frequency band/ region.
688 688  
... ... @@ -690,7 +690,7 @@
690 690  
691 691  * Fix bugs.
692 692  
693 -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]]**
694 694  
695 695  Methods to Update Firmware:
696 696  
... ... @@ -700,10 +700,10 @@
700 700  
701 701  = 6. FAQ =
702 702  
703 -== 6.1 What is the frequency plan for DS20L? ==
693 +== 6.1 What is the frequency plan for LDS12-LB? ==
704 704  
705 705  
706 -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"]]
707 707  
708 708  
709 709  = 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