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, 16 added, 0 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
- image-20220709100028-1.png
Details
- Page properties
-
- Content
-
... ... @@ -35,25 +35,27 @@ 35 35 [[image:1654503236291-817.png]] 36 36 37 37 38 -[[image:16572 45163077-232.png]]38 +[[image:1657327959271-447.png]] 39 39 40 40 41 41 42 42 == 1.2 Features == 43 43 44 + 44 44 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 45 -* Monitor Soil Moisture 46 -* Monitor Soil Temperature 47 -* Monitor Soil Conductivity 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 48 48 * AT Commands to change parameters 49 49 * Uplink on periodically 50 50 * Downlink to change configure 51 51 * IP66 Waterproof Enclosure 52 -* Ultra-Low Power consumption 53 -* AT Commands to change parameters 54 54 * Micro SIM card slot for NB-IoT SIM 55 55 * 8500mAh Battery for long term use 56 56 58 + 57 57 == 1.3 Specification == 58 58 59 59 ... ... @@ -71,58 +71,73 @@ 71 71 * - B20 @H-FDD: 800MHz 72 72 * - B28 @H-FDD: 700MHz 73 73 74 - Probe(% style="color:#037691" %)**Specification:**76 +(% style="color:#037691" %)**Battery:** 75 75 76 -Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height. 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 77 77 78 - [[image:image-20220708101224-1.png]]84 +(% style="color:#037691" %)**Power Consumption** 79 79 86 +* STOP Mode: 10uA @ 3.3v 87 +* Max transmit power: [[350mA@3.3v>>mailto:350mA@3.3v]] 80 80 81 81 90 + 82 82 == 1.4 Applications == 83 83 93 +* Smart Buildings & Home Automation 94 +* Logistics and Supply Chain Management 95 +* Smart Metering 84 84 * Smart Agriculture 97 +* Smart Cities 98 +* Smart Factory 85 85 86 86 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %) 87 87 88 88 103 + 104 + 89 89 == 1.5 Pin Definitions == 90 90 91 91 92 -[[image:16572 46476176-652.png]]108 +[[image:1657328609906-564.png]] 93 93 94 94 95 95 96 -= 2. Use NS E01to communicate with IoT Server =112 += 2. Use NDDS75 to communicate with IoT Server = 97 97 98 98 == 2.1 How it works == 99 99 100 - 101 101 ((( 102 -The NS E01is equipped with a NB-IoT module, the pre-loaded firmware in NSE01will 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 +The NDDS75 is equipped with a NB-IoT module, the pre-loaded firmware in NDDS75 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 NDDS75. 103 103 ))) 104 104 105 105 106 106 ((( 107 -The diagram below shows the working flow in default firmware of NS E01:122 +The diagram below shows the working flow in default firmware of NDDS75: 108 108 ))) 109 109 110 -[[image:image-20220708101605-2.png]] 111 - 112 112 ((( 113 113 114 114 ))) 115 115 129 +[[image:1657328659945-416.png]] 116 116 131 +((( 132 + 133 +))) 117 117 118 -== 2.2 Configure the NSE01 == 119 119 136 +== 2.2 Configure the NDDS75 == 120 120 138 + 121 121 === 2.2.1 Test Requirement === 122 122 123 - 124 124 ((( 125 -To use NS E01in your city, make sure meet below requirements:142 +To use NDDS75 in your city, make sure meet below requirements: 126 126 ))) 127 127 128 128 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -130,11 +130,11 @@ 130 130 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 131 131 132 132 ((( 133 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The E01will 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 server150 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDDS75 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 134 134 ))) 135 135 136 136 137 -[[image:16572 49419225-449.png]]154 +[[image:1657328756309-230.png]] 138 138 139 139 140 140 ... ... @@ -149,18 +149,19 @@ 149 149 ))) 150 150 151 151 152 -[[image:16572 49468462-536.png]]169 +[[image:1657328884227-504.png]] 153 153 154 154 155 155 156 -=== 2.2.3 Connect USB – TTL to NS E01to configure it ===173 +=== 2.2.3 Connect USB – TTL to NDDS75 to configure it === 157 157 158 158 ((( 159 159 ((( 160 -User need to configure NS E01via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01support AT Commands, user can use a USB to TTL adapter to connect to NSE01and use AT Commands to configure it, as below.177 +User need to configure NDDS75 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NDDS75 support AT Commands, user can use a USB to TTL adapter to connect to NDDS75 and use AT Commands to configure it, as below. 161 161 ))) 162 162 ))) 163 163 181 +[[image:image-20220709092052-2.png]] 164 164 165 165 **Connection:** 166 166 ... ... @@ -180,13 +180,13 @@ 180 180 * Flow Control: (% style="color:green" %)**None** 181 181 182 182 ((( 183 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NS E01. NSE01will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.201 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NDDS75. NDDS75 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input. 184 184 ))) 185 185 186 -[[image: image-20220708110657-3.png]]204 +[[image:1657329814315-101.png]] 187 187 188 188 ((( 189 -(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NS E01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]207 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]] 190 190 ))) 191 191 192 192 ... ... @@ -204,48 +204,44 @@ 204 204 205 205 For parameter description, please refer to AT command set 206 206 207 -[[image:1657 249793983-486.png]]225 +[[image:1657330452568-615.png]] 208 208 209 209 210 -After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NS E01will start to uplink sensor values to CoAP server.228 +After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NDDS75 will start to uplink sensor values to CoAP server. 211 211 212 -[[image:1657 249831934-534.png]]230 +[[image:1657330472797-498.png]] 213 213 214 214 215 215 216 216 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 217 217 218 -This feature is supported since firmware version v1.0.1 219 219 220 - 221 221 * (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 222 222 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 223 223 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 224 224 225 -[[image:1657 249864775-321.png]]241 +[[image:1657330501006-241.png]] 226 226 227 227 228 -[[image:1657 249930215-289.png]]244 +[[image:1657330533775-472.png]] 229 229 230 230 231 231 232 232 === 2.2.6 Use MQTT protocol to uplink data === 233 233 234 -This feature is supported since firmware version v110 235 235 236 - 237 237 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 238 238 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 239 239 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 240 240 * (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 241 241 * (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 242 -* (% style="color:blue" %)**AT+PUBTOPIC=NS E01_PUB243 -* (% style="color:blue" %)**AT+SUBTOPIC=NS E01_SUB **(%%)256 +* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB **(%%)~/~/Set the sending topic of MQTT 257 +* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB **(%%) ~/~/Set the subscription topic of MQTT 244 244 245 245 [[image:1657249978444-674.png]] 246 246 247 247 248 -[[image:16572 49990869-686.png]]262 +[[image:1657330723006-866.png]] 249 249 250 250 251 251 ((( ... ... @@ -256,16 +256,14 @@ 256 256 257 257 === 2.2.7 Use TCP protocol to uplink data === 258 258 259 -This feature is supported since firmware version v110 260 260 261 - 262 262 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 263 263 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 264 264 265 -[[image: 1657250217799-140.png]]277 +[[image:image-20220709093918-1.png]] 266 266 267 267 268 -[[image: 1657250255956-604.png]]280 +[[image:image-20220709093918-2.png]] 269 269 270 270 271 271 ... ... @@ -287,36 +287,51 @@ 287 287 288 288 == 2.3 Uplink Payload == 289 289 290 -In this mode, uplink payload includes in total 1 8bytes302 +In this mode, uplink payload includes in total 14 bytes 291 291 304 + 292 292 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 293 293 |=(% style="width: 60px;" %)((( 294 294 **Size(bytes)** 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"]]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" %)[[Distance (unit: mm)>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.8A0DigitalInterrupt"]] 297 297 298 298 ((( 299 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NS E01 uplink data.312 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS751 uplink data. 300 300 ))) 301 301 302 302 303 -[[image: image-20220708111918-4.png]]316 +[[image:1657331036973-987.png]] 304 304 305 - 318 +((( 306 306 The payload is ASCII string, representative same HEX: 320 +))) 307 307 308 -0x72403155615900640c7817075e0a8c02f900 where: 322 +((( 323 +0x72403155615900640c6c19029200 where: 324 +))) 309 309 310 -* Device ID: 0x 724031556159 = 724031556159 311 -* Version: 0x0064=100=1.0.0 326 +* ((( 327 +Device ID: 0x724031556159 = 724031556159 328 +))) 329 +* ((( 330 +Version: 0x0064=100=1.0.0 331 +))) 312 312 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 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 +))) 319 319 346 + 320 320 == 2.4 Payload Explanation and Sensor Interface == 321 321 322 322 ... ... @@ -339,7 +339,7 @@ 339 339 ))) 340 340 341 341 ((( 342 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 369 +The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID. 343 343 ))) 344 344 345 345 ... ... @@ -351,7 +351,7 @@ 351 351 ))) 352 352 353 353 ((( 354 -For example: 0x00 64 : this device is NS E01with firmware version 1.0.0.381 +For example: 0x00 64 : this device is NDDS75 with firmware version 1.0.0. 355 355 ))) 356 356 357 357 ... ... @@ -406,63 +406,17 @@ 406 406 407 407 === 2.4.5 Soil Moisture === 408 408 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 -))) 436 +Get the distance. Flat object range 280mm - 7500mm. 414 414 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 -))) 438 +For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is 420 420 421 421 ((( 422 - 423 -))) 424 - 425 425 ((( 426 -(% style="color: #4f81bd" %)**05DC(H) = 1500(D)/100= 15%.**442 +(% style="color:blue" %)** 0B05(H) = 2821(D) = 2821mm.** 427 427 ))) 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 435 435 ))) 436 436 437 437 ((( 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 -((( 466 466 467 467 ))) 468 468 ... ... @@ -470,10 +470,10 @@ 470 470 471 471 ))) 472 472 473 -=== 2.4. 8Digital Interrupt ===454 +=== 2.4.6 Digital Interrupt === 474 474 475 475 ((( 476 -Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NS E01will send a packet to the server.457 +Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NDDS75 will send a packet to the server. 477 477 ))) 478 478 479 479 ((( ... ... @@ -504,10 +504,10 @@ 504 504 505 505 506 506 507 -=== 2.4. 9+5V Output ===488 +=== 2.4.7 +5V Output === 508 508 509 509 ((( 510 -NS E01will enable +5V output before all sampling and disable the +5v after all sampling.491 +NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 511 511 ))) 512 512 513 513
- 1657327959271-447.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +78.3 KB - Content
- 1657328609906-564.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +492.6 KB - Content
- 1657328659945-416.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +78.8 KB - Content
- 1657328756309-230.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +78.5 KB - Content
- 1657328884227-504.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +483.6 KB - Content
- 1657329814315-101.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +85.3 KB - Content
- 1657330452568-615.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +71.3 KB - Content
- 1657330472797-498.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +68.9 KB - Content
- 1657330501006-241.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +119.2 KB - Content
- 1657330533775-472.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +74.9 KB - Content
- 1657330723006-866.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +74.1 KB - Content
- 1657331036973-987.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +83.8 KB - Content
- image-20220709092052-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +247.3 KB - Content
- image-20220709093918-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +42.2 KB - Content
- image-20220709093918-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +61.9 KB - Content
- image-20220709100028-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +8.8 KB - Content