Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 84.16
edited by Xiaoling
on 2023/09/11 15:41
Change comment: There is no comment for this version
To version 84.7
edited by Xiaoling
on 2023/09/11 14:54
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 (% 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.
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.
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 (% 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.
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.
24 24  
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.
25 +PS-NB-NA supports different uplink methods including **MQTT, MQTTs, UDP & TCP** for different application requirement, and support uplinks to various IoT Servers.
26 26  
27 -DDS20-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
27 +PS-NB-NA **supports BLE configure **and** OTA update** which make user easy to use.
28 28  
29 -DDS20-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to severa years.
29 +PS-NB-NA is powered by **8500mAh Li-SOCI2 battery**, it is designed for long-term use up to severa years.
30 30  
31 -DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
31 +PS-NB-NA 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,25 +295,8 @@
295 295  (% style="display:none" %)
296 296  
297 297  
298 -== 1.12 Mechanical ==
298 += 2. Use S31-NB to communicate with IoT Server =
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 -
317 317  == 2.1 Send data to IoT server via NB-IoT network ==
318 318  
319 319  
... ... @@ -413,7 +413,7 @@
413 413  
414 414  These bytes include the hardware and software version.
415 415  
416 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB
399 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
417 417  
418 418  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
419 419  
... ... @@ -440,6 +440,20 @@
440 440  **99**    Not known or not detectable
441 441  
442 442  
426 +(% style="color:blue" %)**Temperature: **
427 +
428 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
429 +
430 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
431 +
432 +(FF3F & 8000: Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
433 +
434 +
435 +(% style="color:blue" %)**Humidity:   **
436 +
437 +Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
438 +
439 +
443 443  (% style="color:blue" %)**TimeStamp:   **
444 444  
445 445  Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
... ... @@ -466,193 +466,61 @@
466 466  
467 467  (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
468 468  
469 -== 2.3  ​Uplink Payload ==
470 470  
467 +== 2.3 Test Uplink and Change Update Interval ==
471 471  
472 -(((
473 -DDS20-LB will uplink payload via LoRaWAN with below payload format: 
474 -)))
475 475  
476 -(((
477 -Uplink payload includes in total 8 bytes.
478 -)))
470 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
479 479  
480 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
481 -|=(% style="width: 95px; background-color:#D9E2F3;color:#0070C0" %)(% style="display:none" %) (%%)Size(bytes)|=(% style="width: 61px; background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)1|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)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"]]
472 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
488 488  
489 -[[image:微信截图_20230702135733.png||height="215" width="964"]]
474 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
490 490  
476 +User can also push the button for more than 1 seconds to activate an uplink.
491 491  
492 -=== 2.3.1 Device Status, FPORT~=5 ===
493 493  
479 +== 2.4 Multi-Samplings and One uplink ==
494 494  
495 -(((
496 -Users can use the downlink command(**0x26 01**) to ask DDS20-LB to send device configure detail, include device configure status. DDS20-LB will uplink a payload via FPort=5 to server.
497 497  
498 -The Payload format is as below.
499 -)))
482 +To save battery life, S31-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:
500 500  
501 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %)
502 -|=(% colspan="6" style="background-color:#D9E2F3;color:#0070C0" %)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
484 +* (% 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)
505 505  
506 -[[image:DDS20.png||height="241" width="1336"]]
486 +* (% 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.
507 507  
488 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
508 508  
509 -(% style="color:#037691" %)**Sensor Model**(%%)**:** For DDS20-LB, this value is 0x29
490 +[[image:1692424376354-959.png]]
510 510  
511 -(% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version
512 512  
513 -(% style="color:#037691" %)**Frequency Band**(%%)**:**
493 +== 2.5 Humidity and Temperature alarm function ==
514 514  
515 -0x01: EU868
516 516  
517 -0x02: US915
496 +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.
518 518  
519 -0x03: IN865
520 520  
521 -0x04: AU915
499 +(% style="color:blue" %)**AT Commands:**
522 522  
523 -0x05: KZ865
501 +(% style="color:#037691" %)**AT+ SHHUM=min,max**
524 524  
525 -0x06: RU864
503 +Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
526 526  
527 -0x07: AS923
528 528  
529 -0x08: AS923-1
506 +(% style="color:#037691" %)**AT+ SHTEMP=min,max**
530 530  
531 -0x09: AS923-2
508 +Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
532 532  
533 -0x0a: AS923-3
534 534  
535 -0x0b: CN470
511 +(% style="color:red" %)**Notice:**
536 536  
537 -0x0c: EU433
513 +* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
538 538  
539 -0x0d: KR920
515 +* 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.**
540 540  
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-LB.
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 -
652 652  == 2.6 Trggier an uplink by external interrupt ==
653 653  
654 654  
655 -DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
520 +S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
656 656  
657 657  (% style="color:blue" %)**AT command:**
658 658  
... ... @@ -666,12 +666,12 @@
666 666  
667 667  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
668 668  
669 -= 3. Configure DDS20-NB =
534 += 3. Configure S31x-NB =
670 670  
671 671  == 3.1 Configure Methods ==
672 672  
673 673  
674 -DDS20-NB supports below configure method:
539 +S31x-NB supports below configure method:
675 675  
676 676  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
677 677  
... ... @@ -760,7 +760,7 @@
760 760  = 4. Battery & Power Consumption =
761 761  
762 762  
763 -DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
628 +S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
764 764  
765 765  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
766 766  
... ... @@ -792,22 +792,11 @@
792 792  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
793 793  
794 794  
795 -= 7.  Trouble Shooting =
660 += 7. Order Info =
796 796  
797 -== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
798 798  
663 +Part Number: (% style="color:blue" %)**S31-NB-XX  / S31B-NB-XX**
799 799  
800 -(((
801 -DDS20-LB has a strict [[**installation requirement**>>||anchor="1.5A0InstallDDS20-LB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00.
802 -
803 -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.
804 -)))
805 -
806 -= 8. Order Info =
807 -
808 -
809 -Part Number: (% style="color:blue" %)**DDS20-NB-XX**
810 -
811 811  (% style="color:red" %)**XX**(%%):
812 812  
813 813  * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
... ... @@ -817,12 +817,12 @@
817 817  (% 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
818 818  
819 819  
820 -= 9. ​Packing Info =
674 += 8. ​Packing Info =
821 821  
822 822  
823 823  (% style="color:#037691" %)**Package Includes**:
824 824  
825 -* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
679 +* S31-NB or S31-NB NB-IoT Sensor Node x 1
826 826  
827 827  * External antenna x 1
828 828  
... ... @@ -836,7 +836,7 @@
836 836  
837 837  * Weight / pcs : 180g
838 838  
839 -= 10. Support =
693 += 9. Support =
840 840  
841 841  
842 842  * 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.