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)
Details
- Page properties
-
- Content
-
... ... @@ -71,7 +71,7 @@ 71 71 == 2.1 How it works == 72 72 73 73 74 -The LDS12-LBis 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 theLDS12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.74 +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. 75 75 76 76 (% style="display:none" %) (%%) 77 77 ... ... @@ -85,9 +85,9 @@ 85 85 [[image:image-20231110091447-3.png||height="383" width="752"]](% style="display:none" %) 86 86 87 87 88 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB.88 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L. 89 89 90 -Each LDS12-LBis shipped with a sticker with the default device EUI as below:90 +Each DS20L is shipped with a sticker with the default device EUI as below: 91 91 92 92 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 93 93 ... ... @@ -116,10 +116,10 @@ 116 116 [[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"]] 117 117 118 118 119 -(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB119 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L 120 120 121 121 122 -Press the button for 5 seconds to activate the LDS12-LB.122 +Press the button for 5 seconds to activate the DS20L. 123 123 124 124 (% 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. 125 125 ... ... @@ -131,7 +131,7 @@ 131 131 === 2.3.1 Device Status, FPORT~=5 === 132 132 133 133 134 -Users can use the downlink command(**0x26 01**) to ask LDS12-LBto send device configure detail, include device configure status.LDS12-LBwill uplink a payload via FPort=5 to server.134 +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. 135 135 136 136 The Payload format is as below. 137 137 ... ... @@ -145,7 +145,7 @@ 145 145 146 146 [[image:image-20230805103904-1.png||height="131" width="711"]] 147 147 148 -(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24148 +(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24 149 149 150 150 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 151 151 ... ... @@ -200,7 +200,7 @@ 200 200 201 201 202 202 ((( 203 - LDS12-LBwill send this uplink **after** Device Status once join the LoRaWAN network successfully. AndLDS12-LBwill:203 +DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will: 204 204 205 205 periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 206 206 ... ... @@ -225,7 +225,7 @@ 225 225 ==== (% style="color:blue" %)**Battery Info**(%%) ==== 226 226 227 227 228 -Check the battery voltage for LDS12-LB.228 +Check the battery voltage for DS20L. 229 229 230 230 Ex1: 0x0B45 = 2885mV 231 231 ... ... @@ -330,7 +330,7 @@ 330 330 === 2.3.3 Historical measuring distance, FPORT~=3 === 331 331 332 332 333 - LDS12-LBstores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].333 +DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]]. 334 334 335 335 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 336 336 ... ... @@ -355,7 +355,7 @@ 355 355 ))) 356 356 357 357 * ((( 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-LBwill 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, DS20L will send max bytes according to the current DR and Frequency bands. 359 359 ))) 360 360 361 361 For example, in the US915 band, the max payload for different DR is: ... ... @@ -368,7 +368,7 @@ 368 368 369 369 **d) DR3:** total payload includes 22 entries of data. 370 370 371 -If LDS12-LBdoesn't have any data in the polling time. It will uplink 11 bytes of 0371 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0 372 372 373 373 374 374 **Downlink:** ... ... @@ -422,7 +422,7 @@ 422 422 ))) 423 423 424 424 ((( 425 - LDS12-LBTTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]425 +DS20L TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 426 426 ))) 427 427 428 428 ... ... @@ -451,7 +451,7 @@ 451 451 452 452 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 453 453 454 -(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LBand add DevEUI.**454 +(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.** 455 455 456 456 [[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"]] 457 457 ... ... @@ -464,19 +464,19 @@ 464 464 == 2.5 Datalog Feature == 465 465 466 466 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-LBwill 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, DS20L will store the reading for future retrieving purposes. 468 468 469 469 470 470 === 2.5.1 Ways to get datalog via LoRaWAN === 471 471 472 472 473 -Set PNACKMD=1, LDS12-LBwill wait for ACK for every uplink, when there is no LoRaWAN network,LDS12-LBwill 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, 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. 474 474 475 475 * ((( 476 -a) LDS12-LBwill do an ACK check for data records sending to make sure every data arrive server.476 +a) DS20L will do an ACK check for data records sending to make sure every data arrive server. 477 477 ))) 478 478 * ((( 479 -b) LDS12-LBwill send data in **CONFIRMED Mode** when PNACKMD=1, butLDS12-LBwon'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 ifLDS12-LBgets a ACK,LDS12-LBwill consider there is a network connection and resend all NONE-ACK messages.479 +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. 480 480 ))) 481 481 482 482 ... ... @@ -484,7 +484,7 @@ 484 484 === 2.5.2 Unix TimeStamp === 485 485 486 486 487 - LDS12-LBuses Unix TimeStamp format based on487 +DS20L 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 LDS12-LBJoined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toLDS12-LB. IfLDS12-LBfails to get the time from the server,LDS12-LBwill use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).506 +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). 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 LDS12-LBwill send one packet every 5s. range 5~~255s.534 +Uplink Internal =5s,means DS20L 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 LDS12-LBuses 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 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. 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 - (% style="color:inherit; font-family:inherit; font-size:29px" %)3. ConfigureLDS12-LB546 +3. Configure DS20L 547 547 548 548 == 3.1 Configure Methods == 549 549 550 550 551 - LDS12-LBsupports below configure method:551 +DS20L 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 ... ... @@ -570,10 +570,10 @@ 570 570 [[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/]] 571 571 572 572 573 -== 3.3 Commands special design for LDS12-LB==573 +== 3.3 Commands special design for DS20L == 574 574 575 575 576 -These commands only valid for LDS12-LB, as below:576 +These commands only valid for DS20L, as below: 577 577 578 578 579 579 === 3.3.1 Set Transmit Interval Time === ... ... @@ -663,7 +663,7 @@ 663 663 = 4. Battery & Power Consumption = 664 664 665 665 666 - LDS12-LBuseER26500+SPC1520battery pack. See below link for detail information about the battery info and how to replace.666 +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. 667 667 668 668 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 669 669 ... ... @@ -672,7 +672,7 @@ 672 672 673 673 674 674 (% class="wikigeneratedid" %) 675 -User can change firmware LDS12-LBto:675 +User can change firmware DS20L to: 676 676 677 677 * Change Frequency band/ region. 678 678 ... ... @@ -680,7 +680,7 @@ 680 680 681 681 * Fix bugs. 682 682 683 -Firmware and changelog can be downloaded from : **[[Firmware download link>> url:https://www.dropbox.com/sh/w1p7ukjrx49e62r/AAB3uCNCt-koYUvMkZUPBRSca?dl=0]]**683 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]** 684 684 685 685 Methods to Update Firmware: 686 686