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, 14 removed)
- 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
-
... ... @@ -41,21 +41,19 @@ 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 59 == 1.3 Specification == 60 60 61 61 ... ... @@ -73,73 +73,58 @@ 73 73 * - B20 @H-FDD: 800MHz 74 74 * - B28 @H-FDD: 700MHz 75 75 76 -(% style="color:#037691" %)** Battery:**74 +Probe(% style="color:#037691" %)** Specification:** 77 77 78 -* Li/SOCI2 un-chargeable battery 79 -* Capacity: 8500mAh 80 -* Self Discharge: <1% / Year @ 25°C 81 -* Max continuously current: 130mA 82 -* 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. 83 83 84 - (% style="color:#037691" %)**Power Consumption**78 +[[image:image-20220708101224-1.png]] 85 85 86 -* STOP Mode: 10uA @ 3.3v 87 -* Max transmit power: [[350mA@3.3v>>mailto:350mA@3.3v]] 88 88 89 89 90 - 91 91 == 1.4 Applications == 92 92 93 -* Smart Buildings & Home Automation 94 -* Logistics and Supply Chain Management 95 -* Smart Metering 96 96 * Smart Agriculture 97 -* Smart Cities 98 -* Smart Factory 99 99 100 100 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %) 101 101 102 102 103 - 104 - 105 105 == 1.5 Pin Definitions == 106 106 107 107 108 -[[image:1657 328609906-564.png]]92 +[[image:1657246476176-652.png]] 109 109 110 110 111 111 112 -= 2. Use N DDS75to communicate with IoT Server =96 += 2. Use NSE01 to communicate with IoT Server = 113 113 114 114 == 2.1 How it works == 115 115 100 + 116 116 ((( 117 -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. 118 118 ))) 119 119 120 120 121 121 ((( 122 -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: 123 123 ))) 124 124 125 -((( 126 - 127 -))) 110 +[[image:image-20220708101605-2.png]] 128 128 129 -[[image:1657328659945-416.png]] 130 - 131 131 ((( 132 132 133 133 ))) 134 134 135 135 136 -== 2.2 Configure the NDDS75 == 137 137 118 +== 2.2 Configure the NSE01 == 138 138 120 + 139 139 === 2.2.1 Test Requirement === 140 140 123 + 141 141 ((( 142 -To use N DDS75in your city, make sure meet below requirements:125 +To use NSE01 in your city, make sure meet below requirements: 143 143 ))) 144 144 145 145 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -147,11 +147,11 @@ 147 147 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 148 148 149 149 ((( 150 -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 151 151 ))) 152 152 153 153 154 -[[image:1657 328756309-230.png]]137 +[[image:1657249419225-449.png]] 155 155 156 156 157 157 ... ... @@ -166,19 +166,18 @@ 166 166 ))) 167 167 168 168 169 -[[image:1657 328884227-504.png]]152 +[[image:1657249468462-536.png]] 170 170 171 171 172 172 173 -=== 2.2.3 Connect USB – TTL to N DDS75to configure it ===156 +=== 2.2.3 Connect USB – TTL to NSE01 to configure it === 174 174 175 175 ((( 176 176 ((( 177 -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. 178 178 ))) 179 179 ))) 180 180 181 -[[image:image-20220709092052-2.png]] 182 182 183 183 **Connection:** 184 184 ... ... @@ -198,13 +198,13 @@ 198 198 * Flow Control: (% style="color:green" %)**None** 199 199 200 200 ((( 201 -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. 202 202 ))) 203 203 204 -[[image: 1657329814315-101.png]]186 +[[image:image-20220708110657-3.png]] 205 205 206 206 ((( 207 -(% 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/]] 208 208 ))) 209 209 210 210 ... ... @@ -222,44 +222,48 @@ 222 222 223 223 For parameter description, please refer to AT command set 224 224 225 -[[image:165733 0452568-615.png]]207 +[[image:1657249793983-486.png]] 226 226 227 227 228 -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. 229 229 230 -[[image:165733 0472797-498.png]]212 +[[image:1657249831934-534.png]] 231 231 232 232 233 233 234 234 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 235 235 218 +This feature is supported since firmware version v1.0.1 236 236 220 + 237 237 * (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 238 238 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 239 239 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 240 240 241 -[[image:1657 330501006-241.png]]225 +[[image:1657249864775-321.png]] 242 242 243 243 244 -[[image:16573 30533775-472.png]]228 +[[image:1657249930215-289.png]] 245 245 246 246 247 247 248 248 === 2.2.6 Use MQTT protocol to uplink data === 249 249 234 +This feature is supported since firmware version v110 250 250 236 + 251 251 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 252 252 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 253 253 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 254 254 * (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 255 255 * (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 256 -* (% style="color:blue" %)**AT+PUBTOPIC=N DDS75_PUB **(%%)~/~/Set the sending topic of MQTT257 -* (% 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 258 258 259 259 [[image:1657249978444-674.png]] 260 260 261 261 262 -[[image:1657 330723006-866.png]]248 +[[image:1657249990869-686.png]] 263 263 264 264 265 265 ((( ... ... @@ -270,14 +270,16 @@ 270 270 271 271 === 2.2.7 Use TCP protocol to uplink data === 272 272 259 +This feature is supported since firmware version v110 273 273 261 + 274 274 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 275 275 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 276 276 277 -[[image: image-20220709093918-1.png]]265 +[[image:1657250217799-140.png]] 278 278 279 279 280 -[[image: image-20220709093918-2.png]]268 +[[image:1657250255956-604.png]] 281 281 282 282 283 283 ... ... @@ -299,51 +299,36 @@ 299 299 300 300 == 2.3 Uplink Payload == 301 301 302 -In this mode, uplink payload includes in total 1 4bytes290 +In this mode, uplink payload includes in total 18 bytes 303 303 304 - 305 305 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 306 306 |=(% style="width: 60px;" %)((( 307 307 **Size(bytes)** 308 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 50px;" %)**1** 309 -|(% 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"]] 310 310 311 311 ((( 312 -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. 313 313 ))) 314 314 315 315 316 -[[image: 1657331036973-987.png]]303 +[[image:image-20220708111918-4.png]] 317 317 318 - (((305 + 319 319 The payload is ASCII string, representative same HEX: 320 -))) 321 321 322 -((( 323 -0x72403155615900640c6c19029200 where: 324 -))) 308 +0x72403155615900640c7817075e0a8c02f900 where: 325 325 326 -* ((( 327 -Device ID: 0x724031556159 = 724031556159 328 -))) 329 -* ((( 330 -Version: 0x0064=100=1.0.0 331 -))) 310 +* Device ID: 0x 724031556159 = 724031556159 311 +* Version: 0x0064=100=1.0.0 332 332 333 -* ((( 334 -BAT: 0x0c6c = 3180 mV = 3.180V 335 -))) 336 -* ((( 337 -Signal: 0x19 = 25 338 -))) 339 -* ((( 340 -Distance: 0x0292= 658 mm 341 -))) 342 -* ((( 343 -Interrupt: 0x00 = 0 344 -))) 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 345 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:b lue" %)**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
- 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