Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 84.8
edited by Xiaoling
on 2023/09/11 14:57
Change comment: There is no comment for this version
To version 84.25
edited by Xiaoling
on 2023/09/11 16:02
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -16,19 +16,19 @@
16 16  == 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor ==
17 17  
18 18  
19 -The Dragino DDS20-NB is a **NB-IoT Ultrasonic liquid level sensor** for Internet of Things solution. It uses **none-contact method **to measure the **height of liquid** in a container without opening the container, and send IoT platform via NB-IoT network.
19 +The Dragino DDS20-NB is a (% style="color:blue" %)**NB-IoT Ultrasonic liquid level sensor**(%%) for Internet of Things solution. It uses (% style="color:blue" %)**none-contact method **(%%)to measure the (% style="color:blue" %)**height of liquid**(%%) in a container without opening the container, and send IoT platform via NB-IoT network.
20 20  
21 21  The DDS20-NB sensor is installed directly below the container to detect the height of the liquid level. User doesn't need to open a hole on the container to be tested. The none-contact measurement makes the measurement safety, easier and possible for some strict situation. 
22 22  
23 -DDS20-NB uses **ultrasonic sensing technology** for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: **toxic substances**, **strong acids**, **strong alkalis** and **various pure liquids** in high-temperature and high-pressure airtight containers.
23 +DDS20-NB uses (% style="color:blue" %)**ultrasonic sensing technology**(%%) for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: (% style="color:blue" %)**toxic substances**, **strong acids**, **strong alkalis**(%%) and (% style="color:blue" %)**various pure liquids**(%%) in high-temperature and high-pressure airtight containers.
24 24  
25 -PS-NB-NA supports different uplink methods including **MQTT, MQTTs, UDP & TCP** for different application requirement, and support uplinks to various IoT Servers.
25 +DDS20-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
26 26  
27 -PS-NB-NA **supports BLE configure **and** OTA update** which make user easy to use.
27 +DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
28 28  
29 -PS-NB-NA is powered by **8500mAh Li-SOCI2 battery**, it is designed for long-term use up to severa years.
29 +DDS20-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to severa years.
30 30  
31 -PS-NB-NA has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
31 +DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
32 32  
33 33  
34 34  [[image:image-20230911140426-2.png||height="320" width="951"]]
... ... @@ -51,6 +51,8 @@
51 51  * 8500mAh Battery for long term use
52 52  * Nano SIM card slot for NB-IoT SIM
53 53  
54 +
55 +
54 54  == 1.3 Specification ==
55 55  
56 56  
... ... @@ -96,6 +96,8 @@
96 96  * STOP Mode: 10uA @ 3.3v
97 97  * Max transmit power: 350mA@3.3v
98 98  
101 +
102 +
99 99  == 1.4 Suitable Container & Liquid ==
100 100  
101 101  
... ... @@ -106,6 +106,8 @@
106 106  ** Pure non metal material: <10 mm
107 107  * Pure liquid without irregular deposition.
108 108  
113 +
114 +
109 109  (% style="display:none" %)
110 110  
111 111  == 1.5 Install DDS20-NB ==
... ... @@ -192,7 +192,7 @@
192 192  Reset DDS20-NB and see if the BLUE LED is slowly blinking.
193 193  )))
194 194  
195 -[[image:image-20230809172509-1.png]]
201 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230809172509-1.png?rev=1.1||alt="image-20230809172509-1.png"]]
196 196  
197 197  (((
198 198  (% style="color:red" %)**Note :**(% style="color:red; display:none" %)** **
... ... @@ -212,6 +212,8 @@
212 212  
213 213  * Smart liquefied gas solution
214 214  
221 +
222 +
215 215  == 1.7 Precautions ==
216 216  
217 217  
... ... @@ -252,6 +252,8 @@
252 252  )))
253 253  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
254 254  
263 +
264 +
255 255  == 1.10 BLE connection ==
256 256  
257 257  
... ... @@ -295,8 +295,25 @@
295 295  (% style="display:none" %)
296 296  
297 297  
298 -= 2. Use S31-NB to communicate with IoT Server =
308 +== 1.12 Mechanical ==
299 299  
310 +
311 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]]
312 +
313 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1||alt="1675143899218-599.png"]]
314 +
315 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143909447-639.png?rev=1.1||alt="1675143909447-639.png"]]
316 +
317 +
318 +(% style="color:blue" %)**Probe Mechanical:**
319 +
320 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-1.png?rev=1.1||alt="image-20220615090910-1.png"]]
321 +
322 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-2.png?rev=1.1||alt="image-20220615090910-2.png"]]
323 +
324 +
325 += 2. Use DDS20-NB to communicate with IoT Server =
326 +
300 300  == 2.1 Send data to IoT server via NB-IoT network ==
301 301  
302 302  
... ... @@ -382,6 +382,8 @@
382 382  
383 383  * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time.
384 384  
412 +
413 +
385 385  === 2.2.2 HEX format Payload(Type~=0) ===
386 386  
387 387  
... ... @@ -450,60 +450,125 @@
450 450  (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
451 451  
452 452  
453 -== 2.3 Test Uplink and Change Update Interval ==
482 +== 2.3  ​Uplink Payload ==
454 454  
455 455  
456 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
485 +(((
486 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
487 +)))
457 457  
458 -User can use below commands to change the (% style="color:blue" %)**uplink interval**.
489 +(((
490 +Uplink payload includes in total 8 bytes.
491 +)))
459 459  
460 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
493 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
494 +|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)1
495 +|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
496 +[[Distance>>||anchor="H2.3.2A0Distance"]]
497 +(unit: mm)
498 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
499 +[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
500 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
461 461  
462 -User can also push the button for more than 1 seconds to activate an uplink.
502 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20230702135733.png?width=964&height=215&rev=1.1||alt="微信截图_20230702135733.png"]]
463 463  
464 464  
465 -== 2.4 Multi-Samplings and One uplink ==
505 +=== 2.3.1  Battery Info ===
466 466  
467 467  
468 -To save battery life, DDS20-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
508 +Check the battery voltage for DDS20-NB.
469 469  
470 -* (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
510 +Ex1: 0x0B45 = 2885mV
471 471  
472 -* (% style="color:#037691" %)**AT+NOUD=8**     (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
512 +Ex2: 0x0B49 = 2889mV
473 473  
474 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
475 475  
476 -[[image:1692424376354-959.png]]
515 +=== 2.3.2  Distance ===
477 477  
478 478  
479 -== 2.5 Humidity and Temperature alarm function ==
518 +(((
519 +Get the distance. Flat object range 20mm - 2000mm.
520 +)))
480 480  
522 +(((
523 +For example, if the data you get from the register is **0x06 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **
481 481  
482 -On each sampling define by AT+TR ( default 900s or 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink.
525 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
526 +)))
483 483  
528 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
484 484  
485 -(% style="color:blue" %)**AT Commands:**
530 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
486 486  
487 -(% style="color:#037691" %)**AT+ SHHUM=min,max**
488 488  
489 -Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
490 490  
534 +=== 2.3.3  Interrupt Pin ===
491 491  
492 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
493 493  
494 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
537 +This data field shows if this packet is generated by interrupt or not.
495 495  
539 +**Example:**
496 496  
497 -(% style="color:red" %)**Notice:**
541 +0x00: Normal uplink packet.
498 498  
499 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
543 +0x01: Interrupt Uplink Packet.
500 500  
501 -* If user only want to send only min or max, user can set the alarm to a value that device won’t reach. For example: (% style="color:#037691" %)**AT+SHTEMP=-80,0.**
502 502  
546 +=== 2.3.4  DS18B20 Temperature sensor ===
547 +
548 +
549 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
550 +
551 +**Example**:
552 +
553 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
554 +
555 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
556 +
557 +
558 +=== 2.3.5  Sensor Flag ===
559 +
560 +
561 +(((
562 +0x01: Detect Ultrasonic Sensor
563 +)))
564 +
565 +(((
566 +0x00: No Ultrasonic Sensor
567 +
568 +
569 +)))
570 +
571 +== 2.4 Test Uplink and Change Update Interval ==
572 +
573 +
574 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
575 +
576 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
577 +
578 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
579 +
580 +User can also push the button for more than 1 seconds to activate an uplink.
581 +
582 +
583 +== 2.5 Multi-Samplings and One uplink ==
584 +
585 +
586 +To save battery life, DDS20-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
587 +
588 +* (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
589 +
590 +* (% style="color:#037691" %)**AT+NOUD=8**     (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
591 +
592 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
593 +
594 +[[image:1692424376354-959.png]]
595 +
596 +
503 503  == 2.6 Trggier an uplink by external interrupt ==
504 504  
505 505  
506 -S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
600 +DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
507 507  
508 508  (% style="color:blue" %)**AT command:**
509 509  
... ... @@ -517,17 +517,21 @@
517 517  
518 518  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
519 519  
520 -= 3. Configure S31x-NB =
521 521  
615 +
616 += 3. Configure DDS20-NB =
617 +
522 522  == 3.1 Configure Methods ==
523 523  
524 524  
525 -S31x-NB supports below configure method:
621 +DDS20-NB supports below configure method:
526 526  
527 527  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
528 528  
529 529  * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
530 530  
627 +
628 +
531 531  == 3.2 AT Commands Set ==
532 532  
533 533  
... ... @@ -611,7 +611,7 @@
611 611  = 4. Battery & Power Consumption =
612 612  
613 613  
614 -S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
712 +DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
615 615  
616 616  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
617 617  
... ... @@ -625,7 +625,7 @@
625 625  
626 626  * Fix bugs.
627 627  
628 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**
726 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]**
629 629  
630 630  Methods to Update Firmware:
631 631  
... ... @@ -633,6 +633,8 @@
633 633  
634 634  * 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]]**.
635 635  
734 +
735 +
636 636  = 6. FAQ =
637 637  
638 638  == 6.1 How can I access t BC660K-GL AT Commands? ==
... ... @@ -643,11 +643,24 @@
643 643  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
644 644  
645 645  
646 -= 7. Order Info =
746 += 7.  Trouble Shooting =
647 647  
748 +== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
648 648  
649 -Part Number: (% style="color:blue" %)**S31-NB-XX  / S31B-NB-XX**
650 650  
751 +(((
752 +DDS20-NB has a strict [[**installation requirement**>>||anchor="H1.5A0InstallDDS20-NB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00.
753 +
754 +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.
755 +
756 +
757 +)))
758 +
759 += 8. Order Info =
760 +
761 +
762 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
763 +
651 651  (% style="color:red" %)**XX**(%%):
652 652  
653 653  * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
... ... @@ -657,12 +657,12 @@
657 657  (% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
658 658  
659 659  
660 -= 8. ​Packing Info =
773 += 9. ​Packing Info =
661 661  
662 662  
663 663  (% style="color:#037691" %)**Package Includes**:
664 664  
665 -* S31-NB or S31-NB NB-IoT Sensor Node x 1
778 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
666 666  
667 667  * External antenna x 1
668 668  
... ... @@ -676,9 +676,11 @@
676 676  
677 677  * Weight / pcs : 180g
678 678  
679 -= 9. Support =
680 680  
681 681  
794 += 10. Support =
795 +
796 +
682 682  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
683 683  
684 684  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].