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"]] ... ... @@ -96,25 +96,144 @@ 96 96 * STOP Mode: 10uA @ 3.3v 97 97 * Max transmit power: 350mA@3.3v 98 98 99 -== 1.4 Applications==99 +== 1.4 Suitable Container & Liquid == 100 100 101 101 102 -* S martBuildings& HomeAutomation103 -* LogisticsandSupplyChainManagement104 -* SmartMetering105 -* SmartAgriculture106 -* SmartCities107 -* SmartFactory102 +* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc. 103 +* Container shape is regular, and surface is smooth. 104 +* Container Thickness: 105 +** Pure metal material. 2~~8mm, best is 3~~5mm 106 +** Pure non metal material: <10 mm 107 +* Pure liquid without irregular deposition. 108 108 109 - ==1.5 Sleep modeand working mode==109 +(% style="display:none" %) 110 110 111 +== 1.5 Install DDS20-NB == 111 111 113 + 114 +(% style="color:blue" %)**Step 1**(%%): ** Choose the installation point.** 115 + 116 +DDS20-NB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position. 117 + 118 +[[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-20220615091045-3.png?rev=1.1||alt="image-20220615091045-3.png"]] 119 + 120 + 121 +((( 122 +(% style="color:blue" %)**Step 2**(%%): **Polish the installation point.** 123 +))) 124 + 125 +((( 126 +For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth. 127 +))) 128 + 129 +[[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-20230613143052-5.png?rev=1.1||alt="image-20230613143052-5.png"]] 130 + 131 + 132 +No polish needed if the container is shine metal surface without paint or non-metal container. 133 + 134 +[[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-20230613143125-6.png?rev=1.1||alt="image-20230613143125-6.png"]] 135 + 136 + 137 +((( 138 +(% style="color:blue" %)**Step3: **(%%)**Test the installation point.** 139 +))) 140 + 141 +((( 142 +Power on DDS20-NB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point. 143 +))) 144 + 145 +((( 146 +It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level. 147 +))) 148 + 149 +((( 150 +After paste the DDS20-NB well, power on DDS20-NB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life. 151 +))) 152 + 153 + 154 +((( 155 +(% style="color:blue" %)**LED Status:** 156 +))) 157 + 158 +* ((( 159 +**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well. 160 +))) 161 + 162 +* ((( 163 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point. 164 +))) 165 +* ((( 166 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good. 167 +))) 168 + 169 +((( 170 +DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that. 171 +))) 172 + 173 + 174 +((( 175 +(% style="color:red" %)**Note :**(%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 176 +))) 177 + 178 + 179 +((( 180 +(% style="color:blue" %)**Step4: **(%%)**Install use Epoxy ab glue.** 181 +))) 182 + 183 +((( 184 +Prepare Eproxy AB glue. 185 +))) 186 + 187 +((( 188 +Put Eproxy AB glue in the sensor and press it hard on the container installation point. 189 +))) 190 + 191 +((( 192 +Reset DDS20-NB and see if the BLUE LED is slowly blinking. 193 +))) 194 + 195 +[[image:image-20230809172509-1.png]] 196 + 197 +((( 198 +(% style="color:red" %)**Note :**(% style="color:red; display:none" %)** ** 199 + 200 +(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position. 201 +))) 202 + 203 +((( 204 +(% style="color:red" %)**2:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 205 +))) 206 + 207 + 208 +== 1.6 Applications == 209 + 210 + 211 +* Smart liquid control solution 212 + 213 +* Smart liquefied gas solution 214 + 215 +== 1.7 Precautions == 216 + 217 + 218 +* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights. 219 + 220 +* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container. 221 + 222 +* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable. 223 + 224 +(% style="display:none" %) 225 + 226 + 227 + 228 +== 1.8 Sleep mode and working mode == 229 + 230 + 112 112 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 113 113 114 114 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 115 115 116 116 117 -== 1. 6Button & LEDs ==236 +== 1.9 Button & LEDs == 118 118 119 119 120 120 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] ... ... @@ -133,10 +133,10 @@ 133 133 ))) 134 134 |(% 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. 135 135 136 -== 1. 7BLE connection ==255 +== 1.10 BLE connection == 137 137 138 138 139 -S 31x-NB support BLE remote configure and firmware update.258 +DDS20-NB support BLE remote configure and firmware update. 140 140 141 141 142 142 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: ... ... @@ -148,21 +148,19 @@ 148 148 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 149 149 150 150 151 -== 1. 8Pin Definitions & Switch ==270 +== 1.11 Pin Definitions & Switch == 152 152 153 153 154 -S31x-NB use the mother board from S31-NB which as below. 155 - 156 156 [[image:image-20230819104805-5.png]] 157 157 158 158 159 -=== 1. 8.1 Jumper JP2 ===276 +=== 1.11.1 Jumper JP2 === 160 160 161 161 162 162 Power on Device when put this jumper. 163 163 164 164 165 -=== 1. 8.2 BOOT MODE / SW1 ===282 +=== 1.11.2 BOOT MODE / SW1 === 166 166 167 167 168 168 **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run. ... ... @@ -170,61 +170,48 @@ 170 170 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug 171 171 172 172 173 -=== 1. 8.3 Reset Button ===290 +=== 1.11.3 Reset Button === 174 174 175 175 176 176 Press to reboot the device. 177 177 295 +(% style="display:none" %) 178 178 179 -== 1.9 Hardware Variant == 180 180 298 +== 1.12 Mechanical == 181 181 182 -(% border="1" cellspacing="5" style="width:410px" %) 183 -|=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 126px; background-color:#4F81BD;color:white" %)Photo|=(% style="width: 179px;background-color:#4F81BD;color:white" %)Probe Info 184 -|(% style="width:102px" %)((( 185 -S31-NB 186 -)))|(% style="width:126px" %)((( 187 -(% style="text-align:center" %) 188 -[[image:image-20230819110632-6.png||height="130" width="104"]] 189 -)))|(% style="width:179px" %)((( 190 -1 x SHT31 Probe 191 191 192 - Cableength :3301 +[[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"]] 193 193 194 - 195 -))) 196 -|(% style="width:102px" %)((( 197 -S31B-NB 198 -)))|(% style="width:126px" %)((( 199 -(% style="text-align:center" %) 200 -[[image:image-20230819110702-7.png||height="164" width="90"]] 201 -)))|(% style="width:179px" %)((( 202 -1 x SHT31 Probe 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"]] 203 203 204 -Installed in device. 205 -))) 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"]] 206 206 207 -(% style="display:none" %) 208 208 308 +(% style="color:blue" %)**Probe Mechanical:** 209 209 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"]] 210 210 211 - = 2. UseS31-NBtomunicatewith IoTServer312 +[[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"]] 212 212 314 + 315 += 2. Use DDS20-NB to communicate with IoT Server = 316 + 213 213 == 2.1 Send data to IoT server via NB-IoT network == 214 214 215 215 216 -The S 31-NB is equipped with a NB-IoT module, the pre-loaded firmware in S31-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by S31-NB.320 +The DDS20-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS20-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by DDS20-NB. 217 217 218 218 219 219 Below shows the network structure: 220 220 221 -[[image:1692 415924540-357.png]]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"]] 222 222 223 223 224 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S 31-NB.328 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DDS20-NB. 225 225 226 226 227 -(% 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 S 31-NB send data to IoT server.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. 228 228 229 229 * 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]]. 230 230 ... ... @@ -254,13 +254,13 @@ 254 254 [[image:image-20230819113244-11.png||height="141" width="367"]] 255 255 )))|(% style="width:170px" %) 256 256 257 -(% 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 S 31-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]].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]]. 258 258 259 259 260 260 == 2.2 Payload Types == 261 261 262 262 263 -To meet different server requirement, S 31-NB supports different payload type.367 +To meet different server requirement, DDS20-NB supports different payload type. 264 264 265 265 **Includes:** 266 266 ... ... @@ -286,7 +286,7 @@ 286 286 287 287 This is the General Json Format. As below: 288 288 289 -(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S 31x-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}}**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}}** 290 290 291 291 292 292 (% style="color:red" %)**Notice, from above payload:** ... ... @@ -309,7 +309,7 @@ 309 309 310 310 These bytes include the hardware and software version. 311 311 312 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S 31B-NB& S31-NB416 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for DDS20-NB 313 313 314 314 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100 315 315 ... ... @@ -336,20 +336,6 @@ 336 336 **99** Not known or not detectable 337 337 338 338 339 -(% style="color:blue" %)**Temperature: ** 340 - 341 -If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree 342 - 343 -If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 344 - 345 -(FF3F & 8000: Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 346 - 347 - 348 -(% style="color:blue" %)**Humidity: ** 349 - 350 -Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1% 351 - 352 - 353 353 (% style="color:blue" %)**TimeStamp: ** 354 354 355 355 Unit TimeStamp Example: 64d49439(H) = 1691653177(D) ... ... @@ -376,61 +376,123 @@ 376 376 377 377 (% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28** 378 378 469 +== 2.3 Uplink Payload == 379 379 380 -== 2.3 Test Uplink and Change Update Interval == 381 381 472 +((( 473 +DDS20-NB will uplink payload via LoRaWAN with below payload format: 474 +))) 382 382 383 -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 +))) 384 384 385 -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.1A0BatteryInfo"]]|((( 483 +[[Distance>>||anchor="H2.3.2A0Distance"]] 484 +(unit: mm) 485 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|((( 486 +[[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 487 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 386 386 387 - (% style="color:#037691"%)**AT+TDC=600** (%%) ~/~/SetUpdateIntervalo 600s489 +[[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"]] 388 388 389 -User can also push the button for more than 1 seconds to activate an uplink. 390 390 492 +=== 2.3.1 Battery Info === 391 391 392 -== 2.4 Multi-Samplings and One uplink == 393 393 495 +Check the battery voltage for DDS20-NB. 394 394 395 - To save battery life, S31-NBwill sample temperature & humidity data every 15minutesand send one uplink every2hours. So each uplink it will include8stored data + 1 real-time data. They are defined by:497 +Ex1: 0x0B45 = 2885mV 396 396 397 - * (% style="color:#037691"%)**AT+TR=900** (%%) ~/~/ The unit is seconds, and the default is to record data once every900seconds(15 minutes, the minimum can be set to 180 seconds)499 +Ex2: 0x0B49 = 2889mV 398 398 399 -* (% 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. 400 400 401 - Thediagrambelow explainshe relationship between TR, NOUD, and TDC moreclearly:502 +=== 2.3.2 Distance === 402 402 403 -[[image:1692424376354-959.png]] 404 404 505 +((( 506 +Get the distance. Flat object range 20mm - 2000mm. 507 +))) 405 405 406 -== 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" %)** ** 407 407 512 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 513 +))) 408 408 409 - Oneach sampling defineby AT+TR ( default900sor 15 minutes),when thevalueexceedherange, itwilltriggeranAlarm andimmediatelysendsa uplink.515 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 410 410 517 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 411 411 412 - (%style="color:blue"%)**AT Commands:**519 +=== 2.3.3 Interrupt Pin === 413 413 414 -(% style="color:#037691" %)**AT+ SHHUM=min,max** 415 415 416 - Example: AT+ SHHUM=50,80 ~/~/ Alarm when humiditylowerthan50orhigherhan80.522 +This data field shows if this packet is generated by interrupt or not. 417 417 524 +**Example:** 418 418 419 - (%style="color:#037691" %)**AT+ SHTEMP=min,max**526 +0x00: Normal uplink packet. 420 420 421 - Example:AT+ SHTEMP=20,30 ~/~/ Alarm whenmperaturelower than20 or higherthan 30528 +0x01: Interrupt Uplink Packet. 422 422 423 423 424 - (%style="color:red"%)**Notice:**531 +=== 2.3.4 DS18B20 Temperature sensor === 425 425 426 -* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.** 427 427 428 - * If useronly want tosendonly minor max, user canset thearmtoavaluethatdevice won’treach. 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. 429 429 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 + 430 430 == 2.6 Trggier an uplink by external interrupt == 431 431 432 432 433 -S 31-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. 434 434 435 435 (% style="color:blue" %)**AT command:** 436 436 ... ... @@ -444,12 +444,12 @@ 444 444 445 445 * (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 446 446 447 -= 3. Configure S 31x-NB =599 += 3. Configure DDS20-NB = 448 448 449 449 == 3.1 Configure Methods == 450 450 451 451 452 -S 31x-NB supports below configure method:604 +DDS20-NB supports below configure method: 453 453 454 454 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 455 455 ... ... @@ -538,7 +538,7 @@ 538 538 = 4. Battery & Power Consumption = 539 539 540 540 541 -S 31x-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. 542 542 543 543 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 544 544 ... ... @@ -552,7 +552,7 @@ 552 552 553 553 * Fix bugs. 554 554 555 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/ fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]**707 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]** 556 556 557 557 Methods to Update Firmware: 558 558 ... ... @@ -570,11 +570,22 @@ 570 570 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]] 571 571 572 572 573 -= 7. OrderInfo =725 += 7. Trouble Shooting = 574 574 727 +== 7.1 Why i always see 0x0000 or 0 for the distance value? == 575 575 576 -Part Number: (% style="color:blue" %)**S31-NB-XX / S31B-NB-XX** 577 577 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 + 578 578 (% style="color:red" %)**XX**(%%): 579 579 580 580 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card) ... ... @@ -584,12 +584,12 @@ 584 584 (% 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 585 585 586 586 587 -= 8. Packing Info =750 += 9. Packing Info = 588 588 589 589 590 590 (% style="color:#037691" %)**Package Includes**: 591 591 592 -* S 31-NBor S31-NBNB-IoTSensorNode x 1755 +* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1 593 593 594 594 * External antenna x 1 595 595 ... ... @@ -603,7 +603,7 @@ 603 603 604 604 * Weight / pcs : 180g 605 605 606 -= 9. Support =769 += 10. Support = 607 607 608 608 609 609 * 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.