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
-
... ... @@ -57,7 +57,6 @@ 57 57 * IP66 Waterproof Enclosure 58 58 * 8500mAh Battery for long term use 59 59 60 - 61 61 == 1.3 Specification == 62 62 63 63 ... ... @@ -94,9 +94,8 @@ 94 94 * Container Thickness: 95 95 ** Pure metal material. 2~~8mm, best is 3~~5mm 96 96 ** Pure non metal material: <10 mm 97 -* Pure liquid without irregular deposition. 96 +* Pure liquid without irregular deposition.(% style="display:none" %) 98 98 99 -(% style="display:none" %) 100 100 101 101 == 1.5 Install DDS20-LB == 102 102 ... ... @@ -142,11 +142,11 @@ 142 142 143 143 144 144 ((( 145 -(% style="color: blue" %)**LED Status:**143 +(% style="color:red" %)**LED Status:** 146 146 ))) 147 147 148 148 * ((( 149 - **Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.147 +Onboard LED: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well. 150 150 ))) 151 151 152 152 * ((( ... ... @@ -162,10 +162,14 @@ 162 162 163 163 164 164 ((( 165 -(% style="color:red" %)**Note :** (%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.163 +(% style="color:red" %)**Note 2:** 166 166 ))) 167 167 166 +((( 167 +(% style="color:red" %)**Ultrasonic coupling paste** (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 168 +))) 168 168 170 + 169 169 ((( 170 170 (% style="color:blue" %)**Step4: **(%%)Install use Epoxy ab glue. 171 171 ))) ... ... @@ -186,13 +186,11 @@ 186 186 187 187 188 188 ((( 189 -(% style="color:red" %)**Note :** 190 - 191 -(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position. 191 +(% style="color:red" %)**Note 1:(%%) (% style="color:blue" %)Eproxy AB glue**(%%) needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position. 192 192 ))) 193 193 194 194 ((( 195 -(% style="color:red" %)**2: **(%%)**(% style="color:blue" %)Eproxy AB glue(%%)**is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.195 +(% style="color:red" %)**Note 2:(%%) (% style="color:blue" %)Eproxy AB glue**(%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 196 196 ))) 197 197 198 198 ... ... @@ -203,6 +203,8 @@ 203 203 204 204 * Smart liquefied gas solution. 205 205 206 + 207 + 206 206 == 1.7 Precautions == 207 207 208 208 ... ... @@ -212,6 +212,7 @@ 212 212 213 213 * When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable.(% style="display:none" %) 214 214 217 + 215 215 == 1.8 Sleep mode and working mode == 216 216 217 217 ... ... @@ -283,7 +283,7 @@ 283 283 == 2.1 How it works == 284 284 285 285 286 -The DDS 20-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 DDS20-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.289 +The DDS45-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 DDS45-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes. 287 287 288 288 (% style="display:none" %) (%%) 289 289 ... ... @@ -297,9 +297,9 @@ 297 297 [[image:image-20230613140140-4.png||height="453" width="800"]](% style="display:none" %) 298 298 299 299 300 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DDS 20-LB.303 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DDS45-LB. 301 301 302 -Each DDS 20-LB is shipped with a sticker with the default device EUI as below:305 +Each DDS45-LB is shipped with a sticker with the default device EUI as below: 303 303 304 304 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 305 305 ... ... @@ -328,10 +328,10 @@ 328 328 [[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"]] 329 329 330 330 331 -(% style="color:blue" %)**Step 2:**(%%) Activate on DDS 20-LB334 +(% style="color:blue" %)**Step 2:**(%%) Activate on DDS45-LB 332 332 333 333 334 -Press the button for 5 seconds to activate the DDS 20-LB.337 +Press the button for 5 seconds to activate the DDS45-LB. 335 335 336 336 (% 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. 337 337 ... ... @@ -342,7 +342,7 @@ 342 342 343 343 344 344 ((( 345 -DDS 20-LB will uplink payload via LoRaWAN with below payload format:348 +DDS45-LB will uplink payload via LoRaWAN with below payload format: 346 346 ))) 347 347 348 348 ((( ... ... @@ -360,13 +360,13 @@ 360 360 [[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 361 361 )))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 362 362 363 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS 20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]]366 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]] 364 364 365 365 366 366 === 2.3.1 Battery Info === 367 367 368 368 369 -Check the battery voltage for DDS 20-LB.372 +Check the battery voltage for DDS45-LB. 370 370 371 371 Ex1: 0x0B45 = 2885mV 372 372 ... ... @@ -377,19 +377,18 @@ 377 377 378 378 379 379 ((( 380 -Get the distance. Flat object range 20mm -2000mm.383 +Get the distance. Flat object range 30mm - 4500mm. 381 381 ))) 382 382 383 383 ((( 384 -For example, if the data you get from the register is **0x0 60x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **387 +For example, if the data you get from the register is **0x0B 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** ** 385 385 386 -(% style="color:blue" %)**0 605(H) = 1541(D) = 1541mm.**389 +(% style="color:blue" %)**0B05(H) = 2821 (D) = 2821 mm.** 387 387 ))) 388 388 389 389 * If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 393 +* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00. 390 390 391 -* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 392 - 393 393 === 2.3.3 Interrupt Pin === 394 394 395 395 ... ... @@ -436,7 +436,7 @@ 436 436 The payload decoder function for TTN V3 is here: 437 437 438 438 ((( 439 -DDS 20-LB TTN V3 Payload Decoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]441 +DDS45-LB TTN V3 Payload Decoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 440 440 ))) 441 441 442 442 ... ... @@ -443,7 +443,7 @@ 443 443 == 2.4 Uplink Interval == 444 444 445 445 446 -The DDS 20-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>||anchor="H3.3.1SetTransmitIntervalTime"]]448 +The DDS45-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>||anchor="H3.3.1SetTransmitIntervalTime"]] 447 447 448 448 449 449 == 2.5 Show Data in DataCake IoT Server == ... ... @@ -471,7 +471,7 @@ 471 471 472 472 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 473 473 474 -(% style="color:blue" %)**Step 4**(%%)**: Search the DDS 20-LB and add DevEUI.**476 +(% style="color:blue" %)**Step 4**(%%)**: Search the DDS45-LB and add DevEUI.** 475 475 476 476 [[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"]] 477 477 ... ... @@ -485,19 +485,19 @@ 485 485 == 2.6 Datalog Feature == 486 486 487 487 488 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DDS 20-LB will store the reading for future retrieving purposes.490 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DDS45-LB will store the reading for future retrieving purposes. 489 489 490 490 491 491 === 2.6.1 Ways to get datalog via LoRaWAN === 492 492 493 493 494 -Set PNACKMD=1, DDS 20-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DDS20-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.496 +Set PNACKMD=1, DDS45-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DDS45-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. 495 495 496 496 * ((( 497 -a) DDS 20-LB will do an ACK check for data records sending to make sure every data arrive server.499 +a) DDS45-LB will do an ACK check for data records sending to make sure every data arrive server. 498 498 ))) 499 499 * ((( 500 -b) DDS 20-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DDS20-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 DDS20-LB gets a ACK, DDS20-LB will consider there is a network connection and resend all NONE-ACK messages.502 +b) DDS45-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DDS45-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 DDS45-LB gets a ACK, DDS45-LB will consider there is a network connection and resend all NONE-ACK messages. 501 501 ))) 502 502 503 503 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -508,7 +508,7 @@ 508 508 === 2.6.2 Unix TimeStamp === 509 509 510 510 511 -DDS 20-LB uses Unix TimeStamp format based on513 +DDS45-LB uses Unix TimeStamp format based on 512 512 513 513 [[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"]] 514 514 ... ... @@ -527,7 +527,7 @@ 527 527 528 528 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 529 529 530 -Once DDS 20-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DDS20-LB. If DDS20-LB fails to get the time from the server, DDS20-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).532 +Once DDS45-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DDS45-LB. If DDS45-LB fails to get the time from the server, DDS45-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 531 531 532 532 (% 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.** 533 533 ... ... @@ -555,7 +555,7 @@ 555 555 ))) 556 556 557 557 ((( 558 -Uplink Internal =5s,means DDS 20-LB will send one packet every 5s. range 5~~255s.560 +Uplink Internal =5s,means DDS45-LB will send one packet every 5s. range 5~~255s. 559 559 ))) 560 560 561 561 ... ... @@ -562,17 +562,17 @@ 562 562 == 2.7 Frequency Plans == 563 563 564 564 565 -The DDS 20-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.567 +The DDS45-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. 566 566 567 567 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 568 568 569 569 570 -= 3. Configure DDS 20-LB =572 += 3. Configure DDS45-LB = 571 571 572 572 == 3.1 Configure Methods == 573 573 574 574 575 -DDS 20-LB supports below configure method:577 +DDS45-LB supports below configure method: 576 576 577 577 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 578 578 ... ... @@ -594,10 +594,10 @@ 594 594 [[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/]] 595 595 596 596 597 -== 3.3 Commands special design for DDS 20-LB ==599 +== 3.3 Commands special design for DDS45-LB == 598 598 599 599 600 -These commands only valid for DDS 20-LB, as below:602 +These commands only valid for DDS45-LB, as below: 601 601 602 602 603 603 === 3.3.1 Set Transmit Interval Time === ... ... @@ -679,7 +679,7 @@ 679 679 = 4. Battery & Power Consumption = 680 680 681 681 682 -DDS 20-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.684 +DDS45-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 683 683 684 684 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 685 685 ... ... @@ -688,7 +688,7 @@ 688 688 689 689 690 690 (% class="wikigeneratedid" %) 691 -User can change firmware DDS 20-LB to:693 +User can change firmware DDS45-LB to: 692 692 693 693 * Change Frequency band/ region. 694 694 ... ... @@ -696,26 +696,26 @@ 696 696 697 697 * Fix bugs. 698 698 699 -Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/ ph4uyz0rchflrnw/AADr1f_5Sg30804NItpfOQbla?dl=0]]**701 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/a5ue0nfrzqy9nz6/AABbvlATosDJKDwBmbirVbMYa?dl=0]]** 700 700 701 701 Methods to Update Firmware: 702 702 703 -* (Recommanded way) OTA firmware update via wireless: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**705 +* (Recommanded way) OTA firmware update via wireless: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]] 704 704 705 705 * 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]]**. 706 706 707 707 = 6. FAQ = 708 708 709 -== 6.1 What is the frequency plan for DDS 20-LB? ==711 +== 6.1 What is the frequency plan for DDS45-LB? == 710 710 711 711 712 -DDS 20-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"]]714 +DDS45-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"]] 713 713 714 714 715 -== 6.2 Can I use DDS 20-LB in condensation environment? ==717 +== 6.2 Can I use DDS45-LB in condensation environment? == 716 716 717 717 718 -DDS 20-LB is not suitable to be used in condensation environment. Condensation on the DDS20-LB probe will affect the reading and always got 0.720 +DDS45-LB is not suitable to be used in condensation environment. Condensation on the DDS45-LB probe will affect the reading and always got 0. 719 719 720 720 721 721 = 7. Trouble Shooting = ... ... @@ -732,20 +732,41 @@ 732 732 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string. 733 733 734 734 735 -== 7.3 Why i always see0x0000or0forthedistancevalue?==737 +== 7.3 Why does the sensor reading show 0 or "No sensor" == 736 736 737 737 738 -((( 739 -LDDS20 has a strict [[**installation requirement**>>||anchor="H1.5A0InstallDDS20-LB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00. 740 +~1. The measurement object is very close to the sensor, but in the blind spot of the sensor. 740 740 741 -If you have followed the instruction requirement exactly but still see the 0x00 reading issue, please. please double-check the decoder, you can check the raw payload to verify. 742 -))) 742 +2. Sensor wiring is disconnected 743 743 744 +3. Not using the correct decoder 744 744 746 + 747 +== 7.4 Abnormal readings The gap between multiple readings is too large or the gap between the readings and the actual value is too large == 748 + 749 + 750 +1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.) 751 + 752 +2) Does it change with temperature, temperature will affect its measurement 753 + 754 +3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode. 755 + 756 +downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1** 757 + 758 +4) After entering the debug mode, it will send 20 pieces of data at a time, and you can send its uplink to us for analysis 759 + 760 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20230113135125-2.png?width=1057&height=136&rev=1.1||alt="image-20230113135125-2.png"]] 761 + 762 + 763 +Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data. 764 + 765 +Please send the data to us for check. 766 + 767 + 745 745 = 8. Order Info = 746 746 747 747 748 -Part Number: (% style="color:blue" %)**DDS 20-LB-XXX**771 +Part Number: (% style="color:blue" %)**DDS45-LB-XXX** 749 749 750 750 (% style="color:red" %)**XXX**(%%): **The default frequency band** 751 751 ... ... @@ -770,7 +770,7 @@ 770 770 771 771 (% style="color:#037691" %)**Package Includes**: 772 772 773 -* DDS 20-LB LoRaWANUltrasonicLiquid LevelSensor x 1796 +* DDS45-LB LoRaWAN Distance Detection Sensor x 1 774 774 775 775 (% style="color:#037691" %)**Dimension and weight**: 776 776