Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 84.20
edited by Xiaoling
on 2023/09/11 15:51
Change comment: There is no comment for this version
To version 84.6
edited by Xiaoling
on 2023/09/11 14:53
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  
... ... @@ -325,10 +325,10 @@
325 325  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-NB_NB-IoT_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230911140426-2.png?width=951&height=320&rev=1.1||alt="image-20230911140426-2.png"]]
326 326  
327 327  
328 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB.
311 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB.
329 329  
330 330  
331 -(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DDS20-NB send data to IoT server.
314 +(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server.
332 332  
333 333  * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
334 334  
... ... @@ -358,13 +358,13 @@
358 358  [[image:image-20230819113244-11.png||height="141" width="367"]]
359 359  )))|(% style="width:170px" %)
360 360  
361 -(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DDS20-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
344 +(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate S31-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
362 362  
363 363  
364 364  == 2.2 ​Payload Types ==
365 365  
366 366  
367 -To meet different server requirement, DDS20-NB supports different payload type.
350 +To meet different server requirement, S31-NB supports different payload type.
368 368  
369 369  **Includes:**
370 370  
... ... @@ -390,7 +390,7 @@
390 390  
391 391  This is the General Json Format. As below:
392 392  
393 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":DDS20-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}**
376 +(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S31x-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}**
394 394  
395 395  
396 396  (% style="color:red" %)**Notice, from above payload:**
... ... @@ -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,123 +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-NB 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:#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"]]
472 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
488 488  
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"]]
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  Battery Info ===
493 493  
479 +== 2.4 Multi-Samplings and One uplink ==
494 494  
495 -Check the battery voltage for DDS20-NB.
496 496  
497 -Ex1: 0x0B45 = 2885mV
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:
498 498  
499 -Ex2: 0x0B49 = 2889mV
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)
500 500  
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.
501 501  
502 -=== 2.3.2  Distance ===
488 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
503 503  
490 +[[image:1692424376354-959.png]]
504 504  
505 -(((
506 -Get the distance. Flat object range 20mm - 2000mm.
507 -)))
508 508  
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" %)** **
493 +== 2.5 Humidity and Temperature alarm function ==
511 511  
512 -(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
513 -)))
514 514  
515 -* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
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.
516 516  
517 -* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
518 518  
519 -=== 2.3.3  Interrupt Pin ===
499 +(% style="color:blue" %)**AT Commands:**
520 520  
501 +(% style="color:#037691" %)**AT+ SHHUM=min,max**
521 521  
522 -This data field shows if this packet is generated by interrupt or not.
503 +Example: AT+ SHHUM=50,80  ~/~/ Alarm when humidity lower than 50 or higher than 80.
523 523  
524 -**Example:**
525 525  
526 -0x00: Normal uplink packet.
506 +(% style="color:#037691" %)**AT+ SHTEMP=min,max**
527 527  
528 -0x01: Interrupt Uplink Packet.
508 +Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
529 529  
530 530  
531 -=== 2.3.4  DS18B20 Temperature sensor ===
511 +(% style="color:red" %)**Notice:**
532 532  
513 +* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
533 533  
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.
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.**
535 535  
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 -
582 582  == 2.6 Trggier an uplink by external interrupt ==
583 583  
584 584  
585 -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.
586 586  
587 587  (% style="color:blue" %)**AT command:**
588 588  
... ... @@ -596,12 +596,12 @@
596 596  
597 597  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
598 598  
599 -= 3. Configure DDS20-NB =
534 += 3. Configure S31x-NB =
600 600  
601 601  == 3.1 Configure Methods ==
602 602  
603 603  
604 -DDS20-NB supports below configure method:
539 +S31x-NB supports below configure method:
605 605  
606 606  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
607 607  
... ... @@ -690,7 +690,7 @@
690 690  = 4. Battery & Power Consumption =
691 691  
692 692  
693 -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.
694 694  
695 695  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
696 696  
... ... @@ -722,22 +722,11 @@
722 722  [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
723 723  
724 724  
725 -= 7.  Trouble Shooting =
660 += 7. Order Info =
726 726  
727 -== 7.1  Why i always see 0x0000 or 0 for the distance value? ==
728 728  
663 +Part Number: (% style="color:blue" %)**S31-NB-XX  / S31B-NB-XX**
729 729  
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 -
741 741  (% style="color:red" %)**XX**(%%):
742 742  
743 743  * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
... ... @@ -747,12 +747,12 @@
747 747  (% 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
748 748  
749 749  
750 -= 9. ​Packing Info =
674 += 8. ​Packing Info =
751 751  
752 752  
753 753  (% style="color:#037691" %)**Package Includes**:
754 754  
755 -* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
679 +* S31-NB or S31-NB NB-IoT Sensor Node x 1
756 756  
757 757  * External antenna x 1
758 758  
... ... @@ -766,7 +766,7 @@
766 766  
767 767  * Weight / pcs : 180g
768 768  
769 -= 10. Support =
693 += 9. Support =
770 770  
771 771  
772 772  * 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.