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.18
edited by Xiaoling
on 2023/09/11 15:48
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"]]
... ... @@ -295,8 +295,25 @@
295 295  (% style="display:none" %)
296 296  
297 297  
298 -= 2. Use S31-NB to communicate with IoT Server =
298 +== 1.12 Mechanical ==
299 299  
300 +
301 +[[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"]]
302 +
303 +[[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"]]
304 +
305 +[[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"]]
306 +
307 +
308 +(% style="color:blue" %)**Probe Mechanical:**
309 +
310 +[[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"]]
311 +
312 +[[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"]]
313 +
314 +
315 += 2. Use DDS20-NB to communicate with IoT Server =
316 +
300 300  == 2.1 Send data to IoT server via NB-IoT network ==
301 301  
302 302  
... ... @@ -449,61 +449,193 @@
449 449  
450 450  (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
451 451  
469 +== 2.3  ​Uplink Payload ==
452 452  
453 -== 2.3 Test Uplink and Change Update Interval ==
454 454  
472 +(((
473 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
474 +)))
455 455  
456 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
476 +(((
477 +Uplink payload includes in total 8 bytes.
478 +)))
457 457  
458 -User can use below commands to change the (% style="color:blue" %)**uplink interval**.
480 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
481 +|=(% 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
482 +|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.2A0BatteryInfo"]]|(((
483 +[[Distance>>||anchor="H2.3.3A0Distance"]]
484 +(unit: mm)
485 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.4A0InterruptPin"]]|(((
486 +[[Temperature (Optional)>>||anchor="H2.3.5A0DS18B20Temperaturesensor"]]
487 +)))|[[Sensor Flag>>||anchor="H2.3.6A0SensorFlag"]]
459 459  
460 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
489 +[[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"]]
461 461  
462 -User can also push the button for more than 1 seconds to activate an uplink.
463 463  
492 +=== 2.3.1 Device Status, FPORT~=5 ===
464 464  
465 -== 2.4 Multi-Samplings and One uplink ==
466 466  
495 +(((
496 +Users can use the downlink command(**0x26 01**) to ask DDS20-NB to send device configure detail, include device configure status. DDS20-NB will uplink a payload via FPort=5 to server.
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:
498 +The Payload format is as below.
499 +)))
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)
501 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %)
502 +|=(% colspan="6" style="background-color:#4F81BD;color:white" %)Device Status (FPORT=5)
503 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:140px" %)**2**|(% style="width:140px" %)**1**|(% style="width:70px" %)**1**|(% style="width:70px" %)**2**
504 +|(% style="width:94px" %)**Value**|(% style="width:68px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:86px" %)Frequency Band|(% style="width:61px" %)Sub-band|(% style="width:61px" %)BAT
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.
506 +[[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/DDS20.png?width=1336&height=241&rev=1.1||alt="DDS20.png"]]
473 473  
474 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
475 475  
476 -[[image:1692424376354-959.png]]
509 +(% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-NB, this value is 0x29
477 477  
511 +(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version
478 478  
479 -== 2.5 Humidity and Temperature alarm function ==
513 +(% style="color:#037691" %)**Frequency Band**(%%)**:**
480 480  
515 +0x01: EU868
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.
517 +0x02: US915
483 483  
519 +0x03: IN865
484 484  
485 -(% style="color:blue" %)**AT Commands:**
521 +0x04: AU915
486 486  
487 -(% style="color:#037691" %)**AT+ SHHUM=min,max**
523 +0x05: KZ865
488 488  
489 -Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
525 +0x06: RU864
490 490  
527 +0x07: AS923
491 491  
492 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
529 +0x08: AS923-1
493 493  
494 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
531 +0x09: AS923-2
495 495  
533 +0x0a: AS923-3
496 496  
497 -(% style="color:red" %)**Notice:**
535 +0x0b: CN470
498 498  
499 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
537 +0x0c: EU433
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.**
539 +0x0d: KR920
502 502  
541 +0x0e: MA869
542 +
543 +
544 +(% style="color:#037691" %)**Sub-Band**(%%)**:**
545 +
546 +AU915 and US915: value 0x00 ~~ 0x08
547 +
548 +CN470: value 0x0B ~~ 0x0C
549 +
550 +Other Bands: Always 0x00
551 +
552 +
553 +(% style="color:#037691" %)**Battery Info:**
554 +
555 +Check the battery voltage.
556 +
557 +Ex1: 0x0B45 = 2885mV
558 +
559 +Ex2: 0x0B49 = 2889mV
560 +
561 +
562 +=== 2.3.2  Battery Info ===
563 +
564 +
565 +Check the battery voltage for DDS20-NB.
566 +
567 +Ex1: 0x0B45 = 2885mV
568 +
569 +Ex2: 0x0B49 = 2889mV
570 +
571 +
572 +=== 2.3.3  Distance ===
573 +
574 +
575 +(((
576 +Get the distance. Flat object range 20mm - 2000mm.
577 +)))
578 +
579 +(((
580 +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" %)** **
581 +
582 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
583 +)))
584 +
585 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
586 +
587 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
588 +
589 +=== 2.3.4  Interrupt Pin ===
590 +
591 +
592 +This data field shows if this packet is generated by interrupt or not.
593 +
594 +**Example:**
595 +
596 +0x00: Normal uplink packet.
597 +
598 +0x01: Interrupt Uplink Packet.
599 +
600 +
601 +=== 2.3.5  DS18B20 Temperature sensor ===
602 +
603 +
604 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
605 +
606 +**Example**:
607 +
608 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
609 +
610 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
611 +
612 +
613 +=== 2.3.6  Sensor Flag ===
614 +
615 +
616 +(((
617 +0x01: Detect Ultrasonic Sensor
618 +)))
619 +
620 +(((
621 +0x00: No Ultrasonic Sensor
622 +
623 +
624 +)))
625 +
626 +== 2.4 Test Uplink and Change Update Interval ==
627 +
628 +
629 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
630 +
631 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
632 +
633 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
634 +
635 +User can also push the button for more than 1 seconds to activate an uplink.
636 +
637 +
638 +== 2.5 Multi-Samplings and One uplink ==
639 +
640 +
641 +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:
642 +
643 +* (% 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)
644 +
645 +* (% 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.
646 +
647 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
648 +
649 +[[image:1692424376354-959.png]]
650 +
651 +
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.
655 +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,12 +517,13 @@
517 517  
518 518  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
519 519  
520 -= 3. Configure S31x-NB =
521 521  
670 += 3. Configure DDS20-NB =
671 +
522 522  == 3.1 Configure Methods ==
523 523  
524 524  
525 -S31x-NB supports below configure method:
675 +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  
... ... @@ -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.
764 +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  
... ... @@ -643,11 +643,22 @@
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 =
796 += 7.  Trouble Shooting =
647 647  
798 +== 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  
801 +(((
802 +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.
803 +
804 +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.
805 +)))
806 +
807 += 8. Order Info =
808 +
809 +
810 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
811 +
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 =
821 += 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
826 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
666 666  
667 667  * External antenna x 1
668 668  
... ... @@ -676,7 +676,7 @@
676 676  
677 677  * Weight / pcs : 180g
678 678  
679 -= 9. Support =
840 += 10. Support =
680 680  
681 681  
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.