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.24
edited by Xiaoling
on 2023/09/11 16:01
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"]]
... ... @@ -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]]
195 +[[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  
215 +
216 +
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  
257 +
258 +
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 =
302 +== 1.12 Mechanical ==
299 299  
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/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]]
306 +
307 +[[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"]]
308 +
309 +[[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"]]
310 +
311 +
312 +(% style="color:blue" %)**Probe Mechanical:**
313 +
314 +[[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"]]
315 +
316 +[[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"]]
317 +
318 +
319 += 2. Use DDS20-NB to communicate with IoT Server =
320 +
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  
406 +
407 +
385 385  === 2.2.2 HEX format Payload(Type~=0) ===
386 386  
387 387  
... ... @@ -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
422 +(% 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)
... ... @@ -464,60 +464,125 @@
464 464  (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
465 465  
466 466  
467 -== 2.3 Test Uplink and Change Update Interval ==
476 +== 2.3  Uplink Payload ==
468 468  
469 469  
470 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
479 +(((
480 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 
481 +)))
471 471  
472 -User can use below commands to change the (% style="color:blue" %)**uplink interval**.
483 +(((
484 +Uplink payload includes in total 8 bytes.
485 +)))
473 473  
474 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
487 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
488 +|=(% 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
489 +|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
490 +[[Distance>>||anchor="H2.3.2A0Distance"]]
491 +(unit: mm)
492 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
493 +[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
494 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
475 475  
476 -User can also push the button for more than 1 seconds to activate an uplink.
496 +[[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"]]
477 477  
478 478  
479 -== 2.4 Multi-Samplings and One uplink ==
499 +=== 2.3.1  Battery Info ===
480 480  
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:
502 +Check the battery voltage for DDS20-NB.
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)
504 +Ex1: 0x0B45 = 2885mV
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.
506 +Ex2: 0x0B49 = 2889mV
487 487  
488 -The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
489 489  
490 -[[image:1692424376354-959.png]]
509 +=== 2.3.2  Distance ===
491 491  
492 492  
493 -== 2.5 Humidity and Temperature alarm function ==
512 +(((
513 +Get the distance. Flat object range 20mm - 2000mm.
514 +)))
494 494  
516 +(((
517 +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" %)** **
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.
519 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
520 +)))
497 497  
522 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
498 498  
499 -(% style="color:blue" %)**AT Commands:**
524 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
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.
504 504  
528 +=== 2.3.3  Interrupt Pin ===
505 505  
506 -(% style="color:#037691" %)**AT+ SHTEMP=min,max**
507 507  
508 -Example: AT+ SHTEMP=20,30  ~/~/ Alarm when temperature lower than 20 or higher than 30
531 +This data field shows if this packet is generated by interrupt or not.
509 509  
533 +**Example:**
510 510  
511 -(% style="color:red" %)**Notice:**
535 +0x00: Normal uplink packet.
512 512  
513 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
537 +0x01: Interrupt Uplink Packet.
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.**
516 516  
540 +=== 2.3.4  DS18B20 Temperature sensor ===
541 +
542 +
543 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
544 +
545 +**Example**:
546 +
547 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
548 +
549 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
550 +
551 +
552 +=== 2.3.5  Sensor Flag ===
553 +
554 +
555 +(((
556 +0x01: Detect Ultrasonic Sensor
557 +)))
558 +
559 +(((
560 +0x00: No Ultrasonic Sensor
561 +
562 +
563 +)))
564 +
565 +== 2.4 Test Uplink and Change Update Interval ==
566 +
567 +
568 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
569 +
570 +User can use below commands to change the (% style="color:blue" %)**uplink interval**.
571 +
572 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
573 +
574 +User can also push the button for more than 1 seconds to activate an uplink.
575 +
576 +
577 +== 2.5 Multi-Samplings and One uplink ==
578 +
579 +
580 +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:
581 +
582 +* (% 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)
583 +
584 +* (% 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.
585 +
586 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
587 +
588 +[[image:1692424376354-959.png]]
589 +
590 +
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.
594 +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,17 +531,21 @@
531 531  
532 532  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
533 533  
534 -= 3. Configure S31x-NB =
535 535  
609 +
610 += 3. Configure DDS20-NB =
611 +
536 536  == 3.1 Configure Methods ==
537 537  
538 538  
539 -S31x-NB supports below configure method:
615 +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  
543 543  * 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]].
544 544  
621 +
622 +
545 545  == 3.2 AT Commands Set ==
546 546  
547 547  
... ... @@ -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.
706 +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  
... ... @@ -639,7 +639,7 @@
639 639  
640 640  * Fix bugs.
641 641  
642 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**
720 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]**
643 643  
644 644  Methods to Update Firmware:
645 645  
... ... @@ -647,6 +647,8 @@
647 647  
648 648  * 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]]**.
649 649  
728 +
729 +
650 650  = 6. FAQ =
651 651  
652 652  == 6.1 How can I access t BC660K-GL AT Commands? ==
... ... @@ -657,11 +657,24 @@
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 =
740 += 7.  Trouble Shooting =
661 661  
742 +== 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  
745 +(((
746 +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.
747 +
748 +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.
749 +
750 +
751 +)))
752 +
753 += 8. Order Info =
754 +
755 +
756 +Part Number: (% style="color:blue" %)**DDS20-NB-XX**
757 +
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 =
767 += 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
772 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
680 680  
681 681  * External antenna x 1
682 682  
... ... @@ -690,9 +690,11 @@
690 690  
691 691  * Weight / pcs : 180g
692 692  
693 -= 9. Support =
694 694  
695 695  
788 += 10. Support =
789 +
790 +
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.
697 697  
698 698  * 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]].