Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 84.7
edited by Xiaoling
on 2023/09/11 14:54
Change comment: There is no comment for this version
To version 84.20
edited by Xiaoling
on 2023/09/11 15:51
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  
... ... @@ -396,7 +396,7 @@
396 396  
397 397  These bytes include the hardware and software version.
398 398  
399 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
416 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB
400 400  
401 401  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
402 402  
... ... @@ -423,20 +423,6 @@
423 423  **99**    Not known or not detectable
424 424  
425 425  
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 -
440 440  (% style="color:blue" %)**TimeStamp:   **
441 441  
442 442  Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
... ... @@ -463,61 +463,123 @@
463 463  
464 464  (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
465 465  
469 +== 2.3  ​Uplink Payload ==
466 466  
467 -== 2.3 Test Uplink and Change Update Interval ==
468 468  
472 +(((
473 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
474 +)))
469 469  
470 -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 +)))
471 471  
472 -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"]]
473 473  
474 -(% 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"]]
475 475  
476 -User can also push the button for more than 1 seconds to activate an uplink.
477 477  
492 +=== 2.3.1  Battery Info ===
478 478  
479 -== 2.4 Multi-Samplings and One uplink ==
480 480  
495 +Check the battery voltage for DDS20-NB.
481 481  
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:
497 +Ex1: 0x0B45 = 2885mV
483 483  
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)
499 +Ex2: 0x0B49 = 2889mV
485 485  
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.
487 487  
488 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
502 +=== 2.3.2  Distance ===
489 489  
490 -[[image:1692424376354-959.png]]
491 491  
505 +(((
506 +Get the distance. Flat object range 20mm - 2000mm.
507 +)))
492 492  
493 -== 2.5 Humidity and Temperature alarm function ==
509 +(((
510 +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" %)** **
494 494  
512 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
513 +)))
495 495  
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.
515 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
497 497  
517 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
498 498  
499 -(% style="color:blue" %)**AT Commands:**
519 +=== 2.3.3  Interrupt Pin ===
500 500  
501 -(% style="color:#037691" %)**AT+ SHHUM=min,max**
502 502  
503 -Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
522 +This data field shows if this packet is generated by interrupt or not.
504 504  
524 +**Example:**
505 505  
506 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
526 +0x00: Normal uplink packet.
507 507  
508 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
528 +0x01: Interrupt Uplink Packet.
509 509  
510 510  
511 -(% style="color:red" %)**Notice:**
531 +=== 2.3.4  DS18B20 Temperature sensor ===
512 512  
513 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
514 514  
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.**
534 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
516 516  
536 +**Example**:
537 +
538 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
539 +
540 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
541 +
542 +
543 +=== 2.3.5  Sensor Flag ===
544 +
545 +
546 +(((
547 +0x01: Detect Ultrasonic Sensor
548 +)))
549 +
550 +(((
551 +0x00: No Ultrasonic Sensor
552 +
553 +
554 +)))
555 +
556 +== 2.4 Test Uplink and Change Update Interval ==
557 +
558 +
559 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
560 +
561 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
562 +
563 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
564 +
565 +User can also push the button for more than 1 seconds to activate an uplink.
566 +
567 +
568 +== 2.5 Multi-Samplings and One uplink ==
569 +
570 +
571 +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:
572 +
573 +* (% 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)
574 +
575 +* (% 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.
576 +
577 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
578 +
579 +[[image:1692424376354-959.png]]
580 +
581 +
517 517  == 2.6 Trggier an uplink by external interrupt ==
518 518  
519 519  
520 -S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
585 +DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
521 521  
522 522  (% style="color:blue" %)**AT command:**
523 523  
... ... @@ -531,12 +531,12 @@
531 531  
532 532  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
533 533  
534 -= 3. Configure S31x-NB =
599 += 3. Configure DDS20-NB =
535 535  
536 536  == 3.1 Configure Methods ==
537 537  
538 538  
539 -S31x-NB supports below configure method:
604 +DDS20-NB supports below configure method:
540 540  
541 541  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
542 542  
... ... @@ -625,7 +625,7 @@
625 625  = 4. Battery & Power Consumption =
626 626  
627 627  
628 -S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
693 +DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
629 629  
630 630  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
631 631  
... ... @@ -657,11 +657,22 @@
657 657  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
658 658  
659 659  
660 -= 7. Order Info =
725 += 7.  Trouble Shooting =
661 661  
727 +== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
662 662  
663 -Part Number: (% style="color:blue" %)**S31-NB-XX  / S31B-NB-XX**
664 664  
730 +(((
731 +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.
732 +
733 +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.
734 +)))
735 +
736 += 8. Order Info =
737 +
738 +
739 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
740 +
665 665  (% style="color:red" %)**XX**(%%):
666 666  
667 667  * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
... ... @@ -671,12 +671,12 @@
671 671  (% 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
672 672  
673 673  
674 -= 8. ​Packing Info =
750 += 9. ​Packing Info =
675 675  
676 676  
677 677  (% style="color:#037691" %)**Package Includes**:
678 678  
679 -* S31-NB or S31-NB NB-IoT Sensor Node x 1
755 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
680 680  
681 681  * External antenna x 1
682 682  
... ... @@ -690,7 +690,7 @@
690 690  
691 691  * Weight / pcs : 180g
692 692  
693 -= 9. Support =
769 += 10. Support =
694 694  
695 695  
696 696  * 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.