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