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,74 +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>>mailto:350mA@3.3v]] 89 89 90 90 91 - 92 - 93 93 == 1.4 Applications == 94 94 95 -* Smart Buildings & Home Automation 96 -* Logistics and Supply Chain Management 97 -* Smart Metering 98 98 * Smart Agriculture 99 -* Smart Cities 100 -* Smart Factory 101 101 102 102 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %) 103 103 104 104 105 - 106 - 107 107 == 1.5 Pin Definitions == 108 108 109 109 110 -[[image:1657 328609906-564.png]]92 +[[image:1657246476176-652.png]] 111 111 112 112 113 113 114 -= 2. Use N DDS75to communicate with IoT Server =96 += 2. Use NSE01 to communicate with IoT Server = 115 115 116 116 == 2.1 How it works == 117 117 100 + 118 118 ((( 119 -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. 120 120 ))) 121 121 122 122 123 123 ((( 124 -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: 125 125 ))) 126 126 127 -((( 128 - 129 -))) 110 +[[image:image-20220708101605-2.png]] 130 130 131 -[[image:1657328659945-416.png]] 132 - 133 133 ((( 134 134 135 135 ))) 136 136 137 137 138 -== 2.2 Configure the NDDS75 == 139 139 118 +== 2.2 Configure the NSE01 == 140 140 120 + 141 141 === 2.2.1 Test Requirement === 142 142 123 + 143 143 ((( 144 -To use N DDS75in your city, make sure meet below requirements:125 +To use NSE01 in your city, make sure meet below requirements: 145 145 ))) 146 146 147 147 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -149,11 +149,11 @@ 149 149 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 150 150 151 151 ((( 152 -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 153 153 ))) 154 154 155 155 156 -[[image:1657 328756309-230.png]]137 +[[image:1657249419225-449.png]] 157 157 158 158 159 159 ... ... @@ -168,19 +168,18 @@ 168 168 ))) 169 169 170 170 171 -[[image:1657 328884227-504.png]]152 +[[image:1657249468462-536.png]] 172 172 173 173 174 174 175 -=== 2.2.3 Connect USB – TTL to N DDS75to configure it ===156 +=== 2.2.3 Connect USB – TTL to NSE01 to configure it === 176 176 177 177 ((( 178 178 ((( 179 -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. 180 180 ))) 181 181 ))) 182 182 183 -[[image:image-20220709092052-2.png]] 184 184 185 185 **Connection:** 186 186 ... ... @@ -200,13 +200,13 @@ 200 200 * Flow Control: (% style="color:green" %)**None** 201 201 202 202 ((( 203 -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. 204 204 ))) 205 205 206 -[[image: 1657329814315-101.png]]186 +[[image:image-20220708110657-3.png]] 207 207 208 208 ((( 209 -(% 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/]] 210 210 ))) 211 211 212 212 ... ... @@ -224,44 +224,48 @@ 224 224 225 225 For parameter description, please refer to AT command set 226 226 227 -[[image:165733 0452568-615.png]]207 +[[image:1657249793983-486.png]] 228 228 229 229 230 -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. 231 231 232 -[[image:165733 0472797-498.png]]212 +[[image:1657249831934-534.png]] 233 233 234 234 235 235 236 236 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 237 237 218 +This feature is supported since firmware version v1.0.1 238 238 220 + 239 239 * (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 240 240 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 241 241 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 242 242 243 -[[image:1657 330501006-241.png]]225 +[[image:1657249864775-321.png]] 244 244 245 245 246 -[[image:16573 30533775-472.png]]228 +[[image:1657249930215-289.png]] 247 247 248 248 249 249 250 250 === 2.2.6 Use MQTT protocol to uplink data === 251 251 234 +This feature is supported since firmware version v110 252 252 236 + 253 253 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 254 254 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 255 255 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 256 256 * (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 257 257 * (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 258 -* (% style="color:blue" %)**AT+PUBTOPIC=N DDS75_PUB **(%%)~/~/Set the sending topic of MQTT259 -* (% 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 260 260 261 261 [[image:1657249978444-674.png]] 262 262 263 263 264 -[[image:1657 330723006-866.png]]248 +[[image:1657249990869-686.png]] 265 265 266 266 267 267 ((( ... ... @@ -272,14 +272,16 @@ 272 272 273 273 === 2.2.7 Use TCP protocol to uplink data === 274 274 259 +This feature is supported since firmware version v110 275 275 261 + 276 276 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 277 277 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 278 278 279 -[[image: image-20220709093918-1.png]]265 +[[image:1657250217799-140.png]] 280 280 281 281 282 -[[image: image-20220709093918-2.png]]268 +[[image:1657250255956-604.png]] 283 283 284 284 285 285 ... ... @@ -301,52 +301,36 @@ 301 301 302 302 == 2.3 Uplink Payload == 303 303 304 -In this mode, uplink payload includes in total 1 4bytes290 +In this mode, uplink payload includes in total 18 bytes 305 305 306 - 307 307 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 308 308 |=(% style="width: 60px;" %)((( 309 309 **Size(bytes)** 310 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 50px;" %)**1** 311 -|(% 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"]] 312 312 313 313 ((( 314 -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. 315 315 ))) 316 316 317 317 318 -[[image: 1657331036973-987.png]]303 +[[image:image-20220708111918-4.png]] 319 319 320 - (((305 + 321 321 The payload is ASCII string, representative same HEX: 322 -))) 323 323 324 -((( 325 -0x72403155615900640c6c19029200 where: 326 -))) 308 +0x72403155615900640c7817075e0a8c02f900 where: 327 327 328 -* ((( 329 -Device ID: 0x724031556159 = 724031556159 330 -))) 331 -* ((( 332 -Version: 0x0064=100=1.0.0 333 -))) 310 +* Device ID: 0x 724031556159 = 724031556159 311 +* Version: 0x0064=100=1.0.0 334 334 335 -* ((( 336 -BAT: 0x0c6c = 3180 mV = 3.180V 337 -))) 338 -* ((( 339 -Signal: 0x19 = 25 340 -))) 341 -* ((( 342 -Distance: 0x0292= 658 mm 343 -))) 344 -* ((( 345 -Interrupt: 0x00 = 0 346 -))) 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 347 347 348 - 349 - 350 350 == 2.4 Payload Explanation and Sensor Interface == 351 351 352 352 ... ... @@ -369,7 +369,7 @@ 369 369 ))) 370 370 371 371 ((( 372 -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. 373 373 ))) 374 374 375 375 ... ... @@ -381,7 +381,7 @@ 381 381 ))) 382 382 383 383 ((( 384 -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. 385 385 ))) 386 386 387 387 ... ... @@ -436,17 +436,63 @@ 436 436 437 437 === 2.4.5 Soil Moisture === 438 438 439 -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 +))) 440 440 441 -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 +))) 442 442 443 443 ((( 422 + 423 +))) 424 + 444 444 ((( 445 -(% style="color:#4f81bd" %)** B05(H) =2821(D) =2821mm.**426 +(% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.** 446 446 ))) 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 447 447 ))) 448 448 449 449 ((( 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 +((( 450 450 451 451 ))) 452 452 ... ... @@ -454,10 +454,10 @@ 454 454 455 455 ))) 456 456 457 -=== 2.4. 6Digital Interrupt ===473 +=== 2.4.8 Digital Interrupt === 458 458 459 459 ((( 460 -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. 461 461 ))) 462 462 463 463 ((( ... ... @@ -488,10 +488,10 @@ 488 488 489 489 490 490 491 -=== 2.4. 7+5V Output ===507 +=== 2.4.9 +5V Output === 492 492 493 493 ((( 494 -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. 495 495 ))) 496 496 497 497
- 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