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, 15 added, 0 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
- image-20220709100028-1.png
Details
- Page properties
-
- Content
-
... ... @@ -56,7 +56,6 @@ 56 56 * 8500mAh Battery for long term use 57 57 58 58 59 - 60 60 == 1.3 Specification == 61 61 62 62 ... ... @@ -74,7 +74,6 @@ 74 74 * - B20 @H-FDD: 800MHz 75 75 * - B28 @H-FDD: 700MHz 76 76 77 - 78 78 (% style="color:#037691" %)**Battery:** 79 79 80 80 * Li/SOCI2 un-chargeable battery ... ... @@ -83,15 +83,13 @@ 83 83 * Max continuously current: 130mA 84 84 * Max boost current: 2A, 1 second 85 85 86 - 87 87 (% style="color:#037691" %)**Power Consumption** 88 88 89 89 * STOP Mode: 10uA @ 3.3v 90 -* Max transmit power: 350mA@3.3v 87 +* Max transmit power: [[350mA@3.3v>>mailto:350mA@3.3v]] 91 91 92 92 93 93 94 - 95 95 == 1.4 Applications == 96 96 97 97 * Smart Buildings & Home Automation ... ... @@ -109,40 +109,41 @@ 109 109 == 1.5 Pin Definitions == 110 110 111 111 112 -[[image:16572 46476176-652.png]]108 +[[image:1657328609906-564.png]] 113 113 114 114 115 115 116 -= 2. Use NS E01to communicate with IoT Server =112 += 2. Use NDDS75 to communicate with IoT Server = 117 117 118 118 == 2.1 How it works == 119 119 120 - 121 121 ((( 122 -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. 123 123 ))) 124 124 125 125 126 126 ((( 127 -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: 128 128 ))) 129 129 130 -[[image:image-20220708101605-2.png]] 131 - 132 132 ((( 133 133 134 134 ))) 135 135 129 +[[image:1657328659945-416.png]] 136 136 131 +((( 132 + 133 +))) 137 137 138 -== 2.2 Configure the NSE01 == 139 139 136 +== 2.2 Configure the NDDS75 == 140 140 138 + 141 141 === 2.2.1 Test Requirement === 142 142 143 - 144 144 ((( 145 -To use NS E01in your city, make sure meet below requirements:142 +To use NDDS75 in your city, make sure meet below requirements: 146 146 ))) 147 147 148 148 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -150,11 +150,11 @@ 150 150 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 151 151 152 152 ((( 153 -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 154 154 ))) 155 155 156 156 157 -[[image:16572 49419225-449.png]]154 +[[image:1657328756309-230.png]] 158 158 159 159 160 160 ... ... @@ -169,18 +169,19 @@ 169 169 ))) 170 170 171 171 172 -[[image:16572 49468462-536.png]]169 +[[image:1657328884227-504.png]] 173 173 174 174 175 175 176 -=== 2.2.3 Connect USB – TTL to NS E01to configure it ===173 +=== 2.2.3 Connect USB – TTL to NDDS75 to configure it === 177 177 178 178 ((( 179 179 ((( 180 -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. 181 181 ))) 182 182 ))) 183 183 181 +[[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 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. 204 204 ))) 205 205 206 -[[image: image-20220708110657-3.png]]204 +[[image:1657329814315-101.png]] 207 207 208 208 ((( 209 -(% 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/]] 210 210 ))) 211 211 212 212 ... ... @@ -224,48 +224,44 @@ 224 224 225 225 For parameter description, please refer to AT command set 226 226 227 -[[image:1657 249793983-486.png]]225 +[[image:1657330452568-615.png]] 228 228 229 229 230 -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. 231 231 232 -[[image:1657 249831934-534.png]]230 +[[image:1657330472797-498.png]] 233 233 234 234 235 235 236 236 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 237 237 238 -This feature is supported since firmware version v1.0.1 239 239 240 - 241 241 * (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 242 242 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 243 243 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 244 244 245 -[[image:1657 249864775-321.png]]241 +[[image:1657330501006-241.png]] 246 246 247 247 248 -[[image:1657 249930215-289.png]]244 +[[image:1657330533775-472.png]] 249 249 250 250 251 251 252 252 === 2.2.6 Use MQTT protocol to uplink data === 253 253 254 -This feature is supported since firmware version v110 255 255 256 - 257 257 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 258 258 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 259 259 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 260 260 * (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 261 261 * (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 262 -* (% style="color:blue" %)**AT+PUBTOPIC=NS E01_PUB263 -* (% 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 264 264 265 265 [[image:1657249978444-674.png]] 266 266 267 267 268 -[[image:16572 49990869-686.png]]262 +[[image:1657330723006-866.png]] 269 269 270 270 271 271 ((( ... ... @@ -276,16 +276,14 @@ 276 276 277 277 === 2.2.7 Use TCP protocol to uplink data === 278 278 279 -This feature is supported since firmware version v110 280 280 281 - 282 282 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 283 283 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 284 284 285 -[[image: 1657250217799-140.png]]277 +[[image:image-20220709093918-1.png]] 286 286 287 287 288 -[[image: 1657250255956-604.png]]280 +[[image:image-20220709093918-2.png]] 289 289 290 290 291 291 ... ... @@ -307,36 +307,51 @@ 307 307 308 308 == 2.3 Uplink Payload == 309 309 310 -In this mode, uplink payload includes in total 1 8bytes302 +In this mode, uplink payload includes in total 14 bytes 311 311 304 + 312 312 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 313 313 |=(% style="width: 60px;" %)((( 314 314 **Size(bytes)** 315 -)))|=(% 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**316 -|(% 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"]] 317 317 318 318 ((( 319 -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. 320 320 ))) 321 321 322 322 323 -[[image: image-20220708111918-4.png]]316 +[[image:1657331036973-987.png]] 324 324 325 - 318 +((( 326 326 The payload is ASCII string, representative same HEX: 320 +))) 327 327 328 -0x72403155615900640c7817075e0a8c02f900 where: 322 +((( 323 +0x72403155615900640c6c19029200 where: 324 +))) 329 329 330 -* Device ID: 0x 724031556159 = 724031556159 331 -* Version: 0x0064=100=1.0.0 326 +* ((( 327 +Device ID: 0x724031556159 = 724031556159 328 +))) 329 +* ((( 330 +Version: 0x0064=100=1.0.0 331 +))) 332 332 333 -* BAT: 0x0c78 = 3192 mV = 3.192V 334 -* Singal: 0x17 = 23 335 -* Soil Moisture: 0x075e= 1886 = 18.86 % 336 -* Soil Temperature:0x0a8c =2700=27 °C 337 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 338 -* 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 +))) 339 339 346 + 340 340 == 2.4 Payload Explanation and Sensor Interface == 341 341 342 342 ... ... @@ -359,7 +359,7 @@ 359 359 ))) 360 360 361 361 ((( 362 -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. 363 363 ))) 364 364 365 365 ... ... @@ -371,7 +371,7 @@ 371 371 ))) 372 372 373 373 ((( 374 -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. 375 375 ))) 376 376 377 377 ... ... @@ -426,63 +426,17 @@ 426 426 427 427 === 2.4.5 Soil Moisture === 428 428 429 -((( 430 -((( 431 -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. 432 -))) 433 -))) 436 +Get the distance. Flat object range 280mm - 7500mm. 434 434 435 -((( 436 -((( 437 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is 438 -))) 439 -))) 438 +For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is 440 440 441 441 ((( 442 - 443 -))) 444 - 445 445 ((( 446 -(% style="color: #4f81bd" %)**05DC(H) = 1500(D)/100= 15%.**442 +(% style="color:blue" %)** 0B05(H) = 2821(D) = 2821mm.** 447 447 ))) 448 - 449 - 450 - 451 -=== 2.4.6 Soil Temperature === 452 - 453 -((( 454 -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 455 455 ))) 456 456 457 457 ((( 458 -**Example**: 459 -))) 460 - 461 -((( 462 -If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C 463 -))) 464 - 465 -((( 466 -If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C 467 -))) 468 - 469 - 470 - 471 -=== 2.4.7 Soil Conductivity (EC) === 472 - 473 -((( 474 -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). 475 -))) 476 - 477 -((( 478 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 479 -))) 480 - 481 -((( 482 -Generally, the EC value of irrigation water is less than 800uS / cm. 483 -))) 484 - 485 -((( 486 486 487 487 ))) 488 488 ... ... @@ -490,10 +490,10 @@ 490 490 491 491 ))) 492 492 493 -=== 2.4. 8Digital Interrupt ===454 +=== 2.4.6 Digital Interrupt === 494 494 495 495 ((( 496 -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. 497 497 ))) 498 498 499 499 ((( ... ... @@ -524,10 +524,10 @@ 524 524 525 525 526 526 527 -=== 2.4. 9+5V Output ===488 +=== 2.4.7 +5V Output === 528 528 529 529 ((( 530 -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. 531 531 ))) 532 532 533 533 ... ... @@ -547,9 +547,9 @@ 547 547 548 548 == 2.5 Downlink Payload == 549 549 550 -By default, NS E01prints the downlink payload to console port.511 +By default, NDDS75 prints the downlink payload to console port. 551 551 552 -[[image:image-2022070 8133731-5.png]]513 +[[image:image-20220709100028-1.png]] 553 553 554 554 555 555 ((( ... ... @@ -585,7 +585,7 @@ 585 585 ))) 586 586 587 587 ((( 588 -If payload = 0x04FF, it will reset the NS E01549 +If payload = 0x04FF, it will reset the NDDS75 589 589 ))) 590 590 591 591 ... ... @@ -599,19 +599,21 @@ 599 599 600 600 == 2.6 LED Indicator == 601 601 602 -((( 603 -The NSE01 has an internal LED which is to show the status of different state. 604 604 564 +The NDDS75 has an internal LED which is to show the status of different state. 605 605 606 -* When power on, NSE01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe) 566 + 567 +* When power on, NDDS75 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe) 607 607 * Then the LED will be on for 1 second means device is boot normally. 608 -* After NS E01join NB-IoT network. The LED will be ON for 3 seconds.569 +* After NDDS75 join NB-IoT network. The LED will be ON for 3 seconds. 609 609 * For each uplink probe, LED will be on for 500ms. 571 + 572 +((( 573 + 610 610 ))) 611 611 612 612 613 613 614 - 615 615 == 2.7 Installation in Soil == 616 616 617 617 __**Measurement the soil surface**__
- 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