Changes for page wiki_test
Last modified by Mengting Qiu on 2024/09/05 17:35
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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-NAsupports 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-NAis 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-NAhas 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"]] ... ... @@ -51,6 +51,8 @@ 51 51 * 8500mAh Battery for long term use 52 52 * Nano SIM card slot for NB-IoT SIM 53 53 54 + 55 + 54 54 == 1.3 Specification == 55 55 56 56 ... ... @@ -96,6 +96,8 @@ 96 96 * STOP Mode: 10uA @ 3.3v 97 97 * Max transmit power: 350mA@3.3v 98 98 101 + 102 + 99 99 == 1.4 Suitable Container & Liquid == 100 100 101 101 ... ... @@ -106,6 +106,8 @@ 106 106 ** Pure non metal material: <10 mm 107 107 * Pure liquid without irregular deposition. 108 108 113 + 114 + 109 109 (% style="display:none" %) 110 110 111 111 == 1.5 Install DDS20-NB == ... ... @@ -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]] 201 +[[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 221 + 222 + 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 263 + 264 + 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 tocommunicatewith IoT Server=308 +== 1.12 Mechanical == 299 299 310 + 311 +[[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"]] 312 + 313 +[[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"]] 314 + 315 +[[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"]] 316 + 317 + 318 +(% style="color:blue" %)**Probe Mechanical:** 319 + 320 +[[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"]] 321 + 322 +[[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"]] 323 + 324 + 325 += 2. Use DDS20-NB to communicate with IoT Server = 326 + 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 412 + 413 + 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 S 31B-NB& S31-NB428 +(% 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 TestUplink and Change UpdateInterval==482 +== 2.3 Uplink Payload == 468 468 469 469 470 -By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 485 +((( 486 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 487 +))) 471 471 472 -User can use below commands to change the (% style="color:blue" %)**uplink interval**. 489 +((( 490 +Uplink payload includes in total 8 bytes. 491 +))) 473 473 474 -(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 493 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 494 +|=(% 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 495 +|(% style="width:95px" %)Value|(% style="width:61px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|((( 496 +[[Distance>>||anchor="H2.3.2A0Distance"]] 497 +(unit: mm) 498 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|((( 499 +[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 500 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 475 475 476 - Usercanalsopush thebuttonmore than1 secondstoctivateplink.502 +[[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. 4Multi-Samplings and Oneuplink==505 +=== 2.3.1 Battery Info === 480 480 481 481 482 - To savebatterylife, S31-NB will sampletemperature& humidity data every15 minutes and send one uplink every 2 hours. So each uplink itwill include8 storeddata + 1 real-time data.They are defined by:508 +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 (15minutes,the minimum can be set to 180 seconds)510 +Ex1: 0x0B45 = 2885mV 485 485 486 - * (% style="color:#037691"%)**AT+NOUD=8**(%%)~/~/ The device uploads 8 sets of recorded data by default. Up to 32sets of record data can be uploaded.512 +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]]515 +=== 2.3.2 Distance === 491 491 492 492 493 -== 2.5 Humidity and Temperature alarm function == 518 +((( 519 +Get the distance. Flat object range 20mm - 2000mm. 520 +))) 494 494 522 +((( 523 +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. 525 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 526 +))) 497 497 528 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 498 498 499 - (%style="color:blue"%)**AT Commands:**530 +* 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 534 +=== 2.3.3 Interrupt Pin === 505 505 506 -(% style="color:#037691" %)**AT+ SHTEMP=min,max** 507 507 508 - Example:AT+SHTEMP=20,30~/~/ Alarmwhentemperaturelowerhan20orhigher than30537 +This data field shows if this packet is generated by interrupt or not. 509 509 539 +**Example:** 510 510 511 - (% style="color:red"%)**Notice:**541 +0x00: Normal uplink packet. 512 512 513 - *To disableAlarm, usercan setmin and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**543 +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 546 +=== 2.3.4 DS18B20 Temperature sensor === 547 + 548 + 549 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 550 + 551 +**Example**: 552 + 553 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 554 + 555 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 556 + 557 + 558 +=== 2.3.5 Sensor Flag === 559 + 560 + 561 +((( 562 +0x01: Detect Ultrasonic Sensor 563 +))) 564 + 565 +((( 566 +0x00: No Ultrasonic Sensor 567 + 568 + 569 +))) 570 + 571 +== 2.4 Test Uplink and Change Update Interval == 572 + 573 + 574 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 575 + 576 +User can use below commands to change the (% style="color:blue" %)**uplink interval**. 577 + 578 +(% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s 579 + 580 +User can also push the button for more than 1 seconds to activate an uplink. 581 + 582 + 583 +== 2.5 Multi-Samplings and One uplink == 584 + 585 + 586 +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: 587 + 588 +* (% 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) 589 + 590 +* (% 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. 591 + 592 +The diagram below explains the relationship between TR, NOUD, and TDC more clearly: 593 + 594 +[[image:1692424376354-959.png]] 595 + 596 + 517 517 == 2.6 Trggier an uplink by external interrupt == 518 518 519 519 520 -S 31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.600 +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 615 + 616 += 3. Configure DDS20-NB = 617 + 536 536 == 3.1 Configure Methods == 537 537 538 538 539 -S 31x-NB supports below configure method:621 +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 627 + 628 + 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 -S 31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.712 +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]]**726 +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 734 + 735 + 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. OrderInfo =746 += 7. Trouble Shooting = 661 661 748 +== 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 751 +((( 752 +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. 753 + 754 +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. 755 + 756 + 757 +))) 758 + 759 += 8. Order Info = 760 + 761 + 762 +Part Number: (% style="color:blue" %)**DDS20-NB-XX** 763 + 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 =773 += 9. Packing Info = 675 675 676 676 677 677 (% style="color:#037691" %)**Package Includes**: 678 678 679 -* S 31-NBor S31-NBNB-IoTSensorNode x 1778 +* 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 794 += 10. Support = 795 + 796 + 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]].