Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Content
-
... ... @@ -33,7 +33,7 @@ 33 33 34 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. 35 35 36 -[[image:image-2023111010 2635-5.png||height="402" width="807"]]36 +[[image:image-20231110091506-4.png||height="391" width="768"]] 37 37 38 38 39 39 == 1.2 Features == ... ... @@ -49,8 +49,6 @@ 49 49 * Firmware upgradable via program port or LoRa protocol 50 50 * Built-in 2400mAh battery or power by external power source 51 51 52 - 53 - 54 54 == 1.3 Specification == 55 55 56 56 ... ... @@ -64,16 +64,16 @@ 64 64 * ToF FoV: ±9°, Total 18° 65 65 * Light source: VCSEL 66 66 65 + 67 67 (% style="display:none" %) 68 68 69 69 70 - 71 71 = 2. Configure DS20L to connect to LoRaWAN network = 72 72 73 73 == 2.1 How it works == 74 74 75 75 76 -The DS2 0L 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. 77 77 78 78 (% style="display:none" %) (%%) 79 79 ... ... @@ -82,14 +82,15 @@ 82 82 83 83 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. 84 84 85 -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. 86 86 87 -[[image:image-20231110 102635-5.png||height="402" width="807"]](% style="display:none" %)85 +[[image:image-20231110091447-3.png||height="383" width="752"]](% style="display:none" %) 88 88 89 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L. 90 90 91 - EachDS20Lisshipped withastickerwith thedefaultdevice EUI asbelow:88 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB. 92 92 90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below: 91 + 93 93 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 94 94 95 95 ... ... @@ -117,10 +117,10 @@ 117 117 [[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"]] 118 118 119 119 120 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS2 0L119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB 121 121 122 122 123 -Press the button for 5 seconds to activate the DS2 0L.122 +Press the button for 5 seconds to activate the LDS12-LB. 124 124 125 125 (% 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. 126 126 ... ... @@ -132,7 +132,7 @@ 132 132 === 2.3.1 Device Status, FPORT~=5 === 133 133 134 134 135 -Users can use the downlink command(**0x26 01**) to ask DS2 0L 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. 136 136 137 137 The Payload format is as below. 138 138 ... ... @@ -146,7 +146,7 @@ 146 146 147 147 [[image:image-20230805103904-1.png||height="131" width="711"]] 148 148 149 -(% style="color:blue" %)**Sensor Model**(%%): For DS2 0L, this value is 0x24148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24 150 150 151 151 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 152 152 ... ... @@ -201,7 +201,7 @@ 201 201 202 202 203 203 ((( 204 -DS2 0L 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: 205 205 206 206 periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 207 207 ... ... @@ -226,7 +226,7 @@ 226 226 ==== (% style="color:blue" %)**Battery Info**(%%) ==== 227 227 228 228 229 -Check the battery voltage for DS2 0L.228 +Check the battery voltage for LDS12-LB. 230 230 231 231 Ex1: 0x0B45 = 2885mV 232 232 ... ... @@ -290,7 +290,7 @@ 290 290 291 291 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. 292 292 293 -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 . 294 294 295 295 **Example:** 296 296 ... ... @@ -331,7 +331,7 @@ 331 331 === 2.3.3 Historical measuring distance, FPORT~=3 === 332 332 333 333 334 -DS2 0L 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"]]. 335 335 336 336 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 337 337 ... ... @@ -356,7 +356,7 @@ 356 356 ))) 357 357 358 358 * ((( 359 -Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS2 0L 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. 360 360 ))) 361 361 362 362 For example, in the US915 band, the max payload for different DR is: ... ... @@ -369,7 +369,7 @@ 369 369 370 370 **d) DR3:** total payload includes 22 entries of data. 371 371 372 -If DS2 0L doesn't have any data in the polling time. It will uplink 11 bytes of 0371 +If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 373 373 374 374 375 375 **Downlink:** ... ... @@ -423,7 +423,7 @@ 423 423 ))) 424 424 425 425 ((( 426 -DS2 0L 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]] 427 427 ))) 428 428 429 429 ... ... @@ -452,7 +452,7 @@ 452 452 453 453 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 454 454 455 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS2 0L and add DevEUI.**454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.** 456 456 457 457 [[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"]] 458 458 ... ... @@ -465,26 +465,27 @@ 465 465 == 2.5 Datalog Feature == 466 466 467 467 468 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS2 0L 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. 469 469 470 470 471 471 === 2.5.1 Ways to get datalog via LoRaWAN === 472 472 473 473 474 -Set PNACKMD=1, DS2 0L will wait for ACK for every uplink, when there is no LoRaWAN network,0L 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. 475 475 476 476 * ((( 477 -a) DS2 0L 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. 478 478 ))) 479 479 * ((( 480 -b) DS2 0L 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. 481 481 ))) 482 482 483 483 483 + 484 484 === 2.5.2 Unix TimeStamp === 485 485 486 486 487 -DS2 0L uses Unix TimeStamp format based on487 +LDS12-LB uses Unix TimeStamp format based on 488 488 489 489 [[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"]] 490 490 ... ... @@ -503,7 +503,7 @@ 503 503 504 504 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 505 505 506 -Once DS2 0L 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). 507 507 508 508 (% 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.** 509 509 ... ... @@ -531,7 +531,7 @@ 531 531 ))) 532 532 533 533 ((( 534 -Uplink Internal =5s,means DS2 0L 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. 535 535 ))) 536 536 537 537 ... ... @@ -538,17 +538,17 @@ 538 538 == 2.6 Frequency Plans == 539 539 540 540 541 -The DS2 0L 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. 542 542 543 543 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 544 544 545 545 546 -3. Configure DS2 0L546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB 547 547 548 548 == 3.1 Configure Methods == 549 549 550 550 551 -DS2 0L supports below configure method:551 +LDS12-LB supports below configure method: 552 552 553 553 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 554 554 ... ... @@ -556,8 +556,6 @@ 556 556 557 557 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 558 558 559 - 560 - 561 561 == 3.2 General Commands == 562 562 563 563 ... ... @@ -572,10 +572,10 @@ 572 572 [[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/]] 573 573 574 574 575 -== 3.3 Commands special design for DS2 0L ==573 +== 3.3 Commands special design for LDS12-LB == 576 576 577 577 578 -These commands only valid for DS2 0L, as below:576 +These commands only valid for LDS12-LB, as below: 579 579 580 580 581 581 === 3.3.1 Set Transmit Interval Time === ... ... @@ -662,11 +662,10 @@ 662 662 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 663 663 664 664 665 - 666 666 = 4. Battery & Power Consumption = 667 667 668 668 669 -DS2 0L usebuilt-in2400mAhnon-chargeablebatteryfor long-term use upto 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. 670 670 671 671 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 672 672 ... ... @@ -675,7 +675,7 @@ 675 675 676 676 677 677 (% class="wikigeneratedid" %) 678 -User can change firmware DS2 0L to:675 +User can change firmware LDS12-LB to: 679 679 680 680 * Change Frequency band/ region. 681 681 ... ... @@ -683,7 +683,7 @@ 683 683 684 684 * Fix bugs. 685 685 686 -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]]** 687 687 688 688 Methods to Update Firmware: 689 689 ... ... @@ -691,14 +691,12 @@ 691 691 692 692 * 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]]**. 693 693 694 - 695 - 696 696 = 6. FAQ = 697 697 698 -== 6.1 What is the frequency plan for DS2 0L? ==693 +== 6.1 What is the frequency plan for LDS12-LB? == 699 699 700 700 701 -DS2 0L 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"]] 702 702 703 703 704 704 = 7. Trouble Shooting = ... ... @@ -753,8 +753,6 @@ 753 753 754 754 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 755 755 756 - 757 - 758 758 = 9. Packing Info = 759 759 760 760 ... ... @@ -772,8 +772,6 @@ 772 772 773 773 * Weight / pcs : g 774 774 775 - 776 - 777 777 = 10. Support = 778 778 779 779
- image-20231110102635-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -84.7 KB - Content