Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual
Last modified by Bei Jinggeng on 2024/05/31 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 15 removed)
- 1657327959271-447.png
- 1657328609906-564.png
- 1657328659945-416.png
- 1657328756309-230.png
- 1657328884227-504.png
- 1657329814315-101.png
- 1657330452568-615.png
- 1657330472797-498.png
- 1657330501006-241.png
- 1657330533775-472.png
- 1657330723006-866.png
- 1657331036973-987.png
- image-20220709092052-2.png
- image-20220709093918-1.png
- image-20220709093918-2.png
Details
- Page properties
-
- Content
-
... ... @@ -35,28 +35,25 @@ 35 35 [[image:1654503236291-817.png]] 36 36 37 37 38 -[[image:1657 327959271-447.png]]38 +[[image:1657245163077-232.png]] 39 39 40 40 41 41 42 42 == 1.2 Features == 43 43 44 - 45 45 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 46 -* Ultra low power consumption 47 -* Distance Detection by Ultrasonic technology 48 -* Flat object range 280mm - 7500mm 49 -* Accuracy: ±(1cm+S*0.3%) (S: Distance) 50 -* Cable Length: 25cm 45 +* Monitor Soil Moisture 46 +* Monitor Soil Temperature 47 +* Monitor Soil Conductivity 51 51 * AT Commands to change parameters 52 52 * Uplink on periodically 53 53 * Downlink to change configure 54 54 * IP66 Waterproof Enclosure 52 +* Ultra-Low Power consumption 53 +* AT Commands to change parameters 55 55 * Micro SIM card slot for NB-IoT SIM 56 56 * 8500mAh Battery for long term use 57 57 58 - 59 - 60 60 == 1.3 Specification == 61 61 62 62 ... ... @@ -74,71 +74,58 @@ 74 74 * - B20 @H-FDD: 800MHz 75 75 * - B28 @H-FDD: 700MHz 76 76 77 -(% style="color:#037691" %)** Battery:**74 +Probe(% style="color:#037691" %)** Specification:** 78 78 79 -* Li/SOCI2 un-chargeable battery 80 -* Capacity: 8500mAh 81 -* Self Discharge: <1% / Year @ 25°C 82 -* Max continuously current: 130mA 83 -* Max boost current: 2A, 1 second 76 +Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height. 84 84 85 - (% style="color:#037691" %)**Power Consumption**78 +[[image:image-20220708101224-1.png]] 86 86 87 -* STOP Mode: 10uA @ 3.3v 88 -* Max transmit power: 350mA@3.3v 89 89 81 + 90 90 == 1.4 Applications == 91 91 92 -* Smart Buildings & Home Automation 93 -* Logistics and Supply Chain Management 94 -* Smart Metering 95 95 * Smart Agriculture 96 -* Smart Cities 97 -* Smart Factory 98 98 99 99 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %) 100 100 101 101 102 - 103 - 104 104 == 1.5 Pin Definitions == 105 105 106 106 107 -[[image:1657 328609906-564.png]]92 +[[image:1657246476176-652.png]] 108 108 109 109 110 110 111 -= 2. Use N DDS75to communicate with IoT Server =96 += 2. Use NSE01 to communicate with IoT Server = 112 112 113 113 == 2.1 How it works == 114 114 100 + 115 115 ((( 116 -The N DDS75is equipped with a NB-IoT module, the pre-loaded firmware in NDDS75will 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 NDDS75.102 +The NSE01 is equipped with a NB-IoT module, the pre-loaded firmware in NSE01 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 NSE01. 117 117 ))) 118 118 119 119 120 120 ((( 121 -The diagram below shows the working flow in default firmware of N DDS75:107 +The diagram below shows the working flow in default firmware of NSE01: 122 122 ))) 123 123 124 -((( 125 - 126 -))) 110 +[[image:image-20220708101605-2.png]] 127 127 128 -[[image:1657328659945-416.png]] 129 - 130 130 ((( 131 131 132 132 ))) 133 133 134 134 135 -== 2.2 Configure the NDDS75 == 136 136 118 +== 2.2 Configure the NSE01 == 137 137 120 + 138 138 === 2.2.1 Test Requirement === 139 139 123 + 140 140 ((( 141 -To use N DDS75in your city, make sure meet below requirements:125 +To use NSE01 in your city, make sure meet below requirements: 142 142 ))) 143 143 144 144 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -146,11 +146,11 @@ 146 146 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 147 147 148 148 ((( 149 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The DDS75will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server133 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSE01 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server 150 150 ))) 151 151 152 152 153 -[[image:1657 328756309-230.png]]137 +[[image:1657249419225-449.png]] 154 154 155 155 156 156 ... ... @@ -165,19 +165,18 @@ 165 165 ))) 166 166 167 167 168 -[[image:1657 328884227-504.png]]152 +[[image:1657249468462-536.png]] 169 169 170 170 171 171 172 -=== 2.2.3 Connect USB – TTL to N DDS75to configure it ===156 +=== 2.2.3 Connect USB – TTL to NSE01 to configure it === 173 173 174 174 ((( 175 175 ((( 176 -User need to configure N DDS75via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NDDS75support AT Commands, user can use a USB to TTL adapter to connect to NDDS75and use AT Commands to configure it, as below.160 +User need to configure NSE01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below. 177 177 ))) 178 178 ))) 179 179 180 -[[image:image-20220709092052-2.png]] 181 181 182 182 **Connection:** 183 183 ... ... @@ -197,13 +197,13 @@ 197 197 * Flow Control: (% style="color:green" %)**None** 198 198 199 199 ((( 200 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on N DDS75. NDDS75will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.183 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input. 201 201 ))) 202 202 203 -[[image: 1657329814315-101.png]]186 +[[image:image-20220708110657-3.png]] 204 204 205 205 ((( 206 -(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http s:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]189 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]] 207 207 ))) 208 208 209 209 ... ... @@ -221,44 +221,48 @@ 221 221 222 222 For parameter description, please refer to AT command set 223 223 224 -[[image:165733 0452568-615.png]]207 +[[image:1657249793983-486.png]] 225 225 226 226 227 -After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), N DDS75will start to uplink sensor values to CoAP server.210 +After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server. 228 228 229 -[[image:165733 0472797-498.png]]212 +[[image:1657249831934-534.png]] 230 230 231 231 232 232 233 233 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 234 234 218 +This feature is supported since firmware version v1.0.1 235 235 220 + 236 236 * (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 237 237 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 238 238 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 239 239 240 -[[image:1657 330501006-241.png]]225 +[[image:1657249864775-321.png]] 241 241 242 242 243 -[[image:16573 30533775-472.png]]228 +[[image:1657249930215-289.png]] 244 244 245 245 246 246 247 247 === 2.2.6 Use MQTT protocol to uplink data === 248 248 234 +This feature is supported since firmware version v110 249 249 236 + 250 250 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 251 251 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 252 252 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 253 253 * (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 254 254 * (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 255 -* (% style="color:blue" %)**AT+PUBTOPIC=N DDS75_PUB **(%%)~/~/Set the sending topic of MQTT256 -* (% style="color:blue" %)**AT+SUBTOPIC=N DDS75_SUB **(%%) ~/~/Set the subscription topic of MQTT242 +* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/Set the sending topic of MQTT 243 +* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) ~/~/Set the subscription topic of MQTT 257 257 258 258 [[image:1657249978444-674.png]] 259 259 260 260 261 -[[image:1657 330723006-866.png]]248 +[[image:1657249990869-686.png]] 262 262 263 263 264 264 ((( ... ... @@ -269,14 +269,16 @@ 269 269 270 270 === 2.2.7 Use TCP protocol to uplink data === 271 271 259 +This feature is supported since firmware version v110 272 272 261 + 273 273 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 274 274 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 275 275 276 -[[image: image-20220709093918-1.png]]265 +[[image:1657250217799-140.png]] 277 277 278 278 279 -[[image: image-20220709093918-2.png]]268 +[[image:1657250255956-604.png]] 280 280 281 281 282 282 ... ... @@ -298,52 +298,36 @@ 298 298 299 299 == 2.3 Uplink Payload == 300 300 301 -In this mode, uplink payload includes in total 1 4bytes290 +In this mode, uplink payload includes in total 18 bytes 302 302 303 - 304 304 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 305 305 |=(% style="width: 60px;" %)((( 306 306 **Size(bytes)** 307 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 50px;" %)**1** 308 -|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:108px" %)[[ Distanceunit: mm)>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.8A0DigitalInterrupt"]]295 +)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**2**|=(% style="width: 50px;" %)**1** 296 +|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:108px" %)[[Soil Moisture>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:133px" %)[[Soil Temperature>>||anchor="H2.4.6A0SoilTemperature"]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>||anchor="H2.4.7A0SoilConductivity28EC29"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.8A0DigitalInterrupt"]] 309 309 310 310 ((( 311 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the N DDS751 uplink data.299 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data. 312 312 ))) 313 313 314 314 315 -[[image: 1657331036973-987.png]]303 +[[image:image-20220708111918-4.png]] 316 316 317 - (((305 + 318 318 The payload is ASCII string, representative same HEX: 319 -))) 320 320 321 -((( 322 -0x72403155615900640c6c19029200 where: 323 -))) 308 +0x72403155615900640c7817075e0a8c02f900 where: 324 324 325 -* ((( 326 -Device ID: 0x724031556159 = 724031556159 327 -))) 328 -* ((( 329 -Version: 0x0064=100=1.0.0 330 -))) 310 +* Device ID: 0x 724031556159 = 724031556159 311 +* Version: 0x0064=100=1.0.0 331 331 332 -* ((( 333 -BAT: 0x0c6c = 3180 mV = 3.180V 334 -))) 335 -* ((( 336 -Signal: 0x19 = 25 337 -))) 338 -* ((( 339 -Distance: 0x0292= 658 mm 340 -))) 341 -* ((( 342 -Interrupt: 0x00 = 0 343 -))) 313 +* BAT: 0x0c78 = 3192 mV = 3.192V 314 +* Singal: 0x17 = 23 315 +* Soil Moisture: 0x075e= 1886 = 18.86 % 316 +* Soil Temperature:0x0a8c =2700=27 °C 317 +* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 318 +* Interrupt: 0x00 = 0 344 344 345 - 346 - 347 347 == 2.4 Payload Explanation and Sensor Interface == 348 348 349 349 ... ... @@ -366,7 +366,7 @@ 366 366 ))) 367 367 368 368 ((( 369 -The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR**won't erase Device ID.342 +The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 370 370 ))) 371 371 372 372 ... ... @@ -378,7 +378,7 @@ 378 378 ))) 379 379 380 380 ((( 381 -For example: 0x00 64 : this device is N DDS75with firmware version 1.0.0.354 +For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0. 382 382 ))) 383 383 384 384 ... ... @@ -433,17 +433,63 @@ 433 433 434 434 === 2.4.5 Soil Moisture === 435 435 436 -Get the distance. Flat object range 280mm - 7500mm. 409 +((( 410 +((( 411 +Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil. 412 +))) 413 +))) 437 437 438 -For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is 415 +((( 416 +((( 417 +For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is 418 +))) 419 +))) 439 439 440 440 ((( 422 + 423 +))) 424 + 441 441 ((( 442 -(% style="color:#4f81bd" %)** B05(H) =2821(D) =2821mm.**426 +(% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.** 443 443 ))) 428 + 429 + 430 + 431 +=== 2.4.6 Soil Temperature === 432 + 433 +((( 434 +Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is __**0x09 0xEC**__, the temperature content in the soil is 444 444 ))) 445 445 446 446 ((( 438 +**Example**: 439 +))) 440 + 441 +((( 442 +If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C 443 +))) 444 + 445 +((( 446 +If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C 447 +))) 448 + 449 + 450 + 451 +=== 2.4.7 Soil Conductivity (EC) === 452 + 453 +((( 454 +Obtain (% style="color:#4f81bd" %)**__soluble salt concentration__**(%%) in soil or (% style="color:#4f81bd" %)**__soluble ion concentration in liquid fertilizer__**(%%) or (% style="color:#4f81bd" %)**__planting medium__**(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000). 455 +))) 456 + 457 +((( 458 +For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 459 +))) 460 + 461 +((( 462 +Generally, the EC value of irrigation water is less than 800uS / cm. 463 +))) 464 + 465 +((( 447 447 448 448 ))) 449 449 ... ... @@ -451,10 +451,10 @@ 451 451 452 452 ))) 453 453 454 -=== 2.4. 6Digital Interrupt ===473 +=== 2.4.8 Digital Interrupt === 455 455 456 456 ((( 457 -Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the N DDS75will send a packet to the server.476 +Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSE01 will send a packet to the server. 458 458 ))) 459 459 460 460 ((( ... ... @@ -485,10 +485,10 @@ 485 485 486 486 487 487 488 -=== 2.4. 7+5V Output ===507 +=== 2.4.9 +5V Output === 489 489 490 490 ((( 491 -N DDS75will enable +5V output before all sampling and disable the +5v after all sampling.510 +NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 492 492 ))) 493 493 494 494
- 1657327959271-447.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.3 KB - Content
- 1657328609906-564.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -492.6 KB - Content
- 1657328659945-416.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.8 KB - Content
- 1657328756309-230.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.5 KB - Content
- 1657328884227-504.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -483.6 KB - Content
- 1657329814315-101.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.3 KB - Content
- 1657330452568-615.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -71.3 KB - Content
- 1657330472797-498.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -68.9 KB - Content
- 1657330501006-241.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -119.2 KB - Content
- 1657330533775-472.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -74.9 KB - Content
- 1657330723006-866.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -74.1 KB - Content
- 1657331036973-987.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -83.8 KB - Content
- image-20220709092052-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -247.3 KB - Content
- image-20220709093918-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -42.2 KB - Content
- image-20220709093918-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -61.9 KB - Content