Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 116.5
edited by Xiaoling
on 2023/11/13 11:28
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,6 +44,7 @@
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  
... ... @@ -61,28 +61,15 @@
61 61  * Light source: VCSEL
62 62  
63 63  
66 +(% style="display:none" %)
64 64  
65 -== 1.4 Power Consumption ==
66 66  
67 -
68 -(% style="color:#037691" %)**Battery Power Mode:**
69 -
70 -* Idle: 0.003 mA @ 3.3v
71 -* Max : 360 mA
72 -
73 -(% style="color:#037691" %)**Continuously mode**:
74 -
75 -* Idle: 21 mA @ 3.3v
76 -* Max : 360 mA
77 -
78 -
79 -
80 80  = 2. Configure DS20L to connect to LoRaWAN network =
81 81  
82 82  == 2.1 How it works ==
83 83  
84 84  
85 -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.
86 86  
87 87  (% style="display:none" %) (%%)
88 88  
... ... @@ -91,14 +91,15 @@
91 91  
92 92  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.
93 93  
94 -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.
95 95  
96 -[[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" %)
97 97  
98 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
99 99  
100 -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.
101 101  
90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below:
91 +
102 102  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
103 103  
104 104  
... ... @@ -126,10 +126,10 @@
126 126  [[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"]]
127 127  
128 128  
129 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB
130 130  
131 131  
132 -Press the button for 5 seconds to activate the DS20L.
122 +Press the button for 5 seconds to activate the LDS12-LB.
133 133  
134 134  (% 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.
135 135  
... ... @@ -141,7 +141,7 @@
141 141  === 2.3.1 Device Status, FPORT~=5 ===
142 142  
143 143  
144 -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.
145 145  
146 146  The Payload format is as below.
147 147  
... ... @@ -155,7 +155,7 @@
155 155  
156 156  [[image:image-20230805103904-1.png||height="131" width="711"]]
157 157  
158 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24
148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
159 159  
160 160  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
161 161  
... ... @@ -210,7 +210,7 @@
210 210  
211 211  
212 212  (((
213 -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:
214 214  
215 215  periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
216 216  
... ... @@ -235,7 +235,7 @@
235 235  ==== (% style="color:blue" %)**Battery Info**(%%) ====
236 236  
237 237  
238 -Check the battery voltage for DS20L.
228 +Check the battery voltage for LDS12-LB.
239 239  
240 240  Ex1: 0x0B45 = 2885mV
241 241  
... ... @@ -299,7 +299,7 @@
299 299  
300 300  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.
301 301  
302 -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 .
303 303  
304 304  **Example:**
305 305  
... ... @@ -340,7 +340,7 @@
340 340  === 2.3.3 Historical measuring distance, FPORT~=3 ===
341 341  
342 342  
343 -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"]].
344 344  
345 345  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
346 346  
... ... @@ -365,7 +365,7 @@
365 365  )))
366 366  
367 367  * (((
368 -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.
369 369  )))
370 370  
371 371  For example, in the US915 band, the max payload for different DR is:
... ... @@ -378,7 +378,7 @@
378 378  
379 379  **d) DR3:** total payload includes 22 entries of data.
380 380  
381 -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
382 382  
383 383  
384 384  **Downlink:**
... ... @@ -432,7 +432,7 @@
432 432  )))
433 433  
434 434  (((
435 -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]]
436 436  )))
437 437  
438 438  
... ... @@ -461,7 +461,7 @@
461 461  
462 462  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
463 463  
464 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.**
465 465  
466 466  [[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"]]
467 467  
... ... @@ -474,25 +474,27 @@
474 474  == 2.5 Datalog Feature ==
475 475  
476 476  
477 -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.
478 478  
479 479  
480 480  === 2.5.1 Ways to get datalog via LoRaWAN ===
481 481  
482 482  
483 -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.
484 484  
485 485  * (((
486 -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.
487 487  )))
488 488  * (((
489 -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.
490 490  )))
491 491  
482 +
483 +
492 492  === 2.5.2 Unix TimeStamp ===
493 493  
494 494  
495 -DS20L uses Unix TimeStamp format based on
487 +LDS12-LB uses Unix TimeStamp format based on
496 496  
497 497  [[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"]]
498 498  
... ... @@ -511,7 +511,7 @@
511 511  
512 512  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
513 513  
514 -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).
515 515  
516 516  (% 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.**
517 517  
... ... @@ -539,7 +539,7 @@
539 539  )))
540 540  
541 541  (((
542 -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.
543 543  )))
544 544  
545 545  
... ... @@ -546,17 +546,17 @@
546 546  == 2.6 Frequency Plans ==
547 547  
548 548  
549 -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.
550 550  
551 551  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
552 552  
553 553  
554 -3. Configure DS20L
546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB
555 555  
556 556  == 3.1 Configure Methods ==
557 557  
558 558  
559 -DS20L supports below configure method:
551 +LDS12-LB supports below configure method:
560 560  
561 561  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
562 562  
... ... @@ -578,10 +578,10 @@
578 578  [[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/]]
579 579  
580 580  
581 -== 3.3 Commands special design for DS20L ==
573 +== 3.3 Commands special design for LDS12-LB ==
582 582  
583 583  
584 -These commands only valid for DS20L, as below:
576 +These commands only valid for LDS12-LB, as below:
585 585  
586 586  
587 587  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -667,10 +667,11 @@
667 667  
668 668  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
669 669  
662 +
670 670  = 4. Battery & Power Consumption =
671 671  
672 672  
673 -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.
674 674  
675 675  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
676 676  
... ... @@ -679,7 +679,7 @@
679 679  
680 680  
681 681  (% class="wikigeneratedid" %)
682 -User can change firmware DS20L to:
675 +User can change firmware LDS12-LB to:
683 683  
684 684  * Change Frequency band/ region.
685 685  
... ... @@ -687,7 +687,7 @@
687 687  
688 688  * Fix bugs.
689 689  
690 -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]]**
691 691  
692 692  Methods to Update Firmware:
693 693  
... ... @@ -697,10 +697,10 @@
697 697  
698 698  = 6. FAQ =
699 699  
700 -== 6.1 What is the frequency plan for DS20L? ==
693 +== 6.1 What is the frequency plan for LDS12-LB? ==
701 701  
702 702  
703 -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"]]
704 704  
705 705  
706 706  = 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