Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual
Last modified by Bei Jinggeng on 2024/05/31 09:53
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.David - Content
-
... ... @@ -7,6 +7,7 @@ 7 7 8 8 **Table of Contents:** 9 9 10 +{{toc/}} 10 10 11 11 12 12 ... ... @@ -15,6 +15,7 @@ 15 15 16 16 = 1. Introduction = 17 17 19 + 18 18 == 1.1 What is NDDS75 Distance Detection Sensor == 19 19 20 20 ((( ... ... @@ -21,20 +21,34 @@ 21 21 22 22 23 23 ((( 26 +((( 24 24 The Dragino NDDS75 is a (% style="color:blue" %)**NB-IoT Distance Detection Sensor**(%%) for Internet of Things solution. It is designed to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses ultrasonic sensing technology for distance measurement, and temperature compensation is performed internally to improve the reliability of data. 25 -\\The NDDS75 can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc. It detects the distance between the measured object and the sensor, and uploads the value via wireless to IoT Server via NB-IoT Network. 26 -\\NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage. 27 -\\NDDS75 supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP** (%%)for different application requirement. 28 -\\NDDS75 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 29 -\\To use NDDS75, user needs to check if there is NB-IoT coverage in local area and with the bands NDDS75 supports. If the local operate support it, user needs to get a NB-IoT SIM card from local operator and install NDDS75 to get NB-IoT network connection. 30 30 ))) 31 31 32 - 30 +((( 31 +The NDDS75 can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc. It detects the distance between the measured object and the sensor, and uploads the value via wireless to IoT Server via NB-IoT Network. 33 33 ))) 34 34 35 -[[image:1654503236291-817.png]] 34 +((( 35 +NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage. 36 +))) 36 36 38 +((( 39 +NDDS75 supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP** (%%)for different application requirement. 40 +))) 37 37 42 +((( 43 +NDDS75 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 44 +))) 45 + 46 +((( 47 +To use NDDS75, user needs to check if there is NB-IoT coverage in local area and with the bands NDDS75 supports. If the local operate support it, user needs to get a NB-IoT SIM card from local operator and install NDDS75 to get NB-IoT network connection. 48 +))) 49 +))) 50 + 51 + 52 +))) 53 + 38 38 [[image:1657327959271-447.png]] 39 39 40 40 ... ... @@ -87,9 +87,9 @@ 87 87 * Max transmit power: 350mA@3.3v 88 88 89 89 90 - 91 91 == 1.4 Applications == 92 92 108 + 93 93 * Smart Buildings & Home Automation 94 94 * Logistics and Supply Chain Management 95 95 * Smart Metering ... ... @@ -102,6 +102,7 @@ 102 102 103 103 104 104 121 + 105 105 == 1.5 Pin Definitions == 106 106 107 107 ... ... @@ -111,8 +111,10 @@ 111 111 112 112 = 2. Use NDDS75 to communicate with IoT Server = 113 113 131 + 114 114 == 2.1 How it works == 115 115 134 + 116 116 ((( 117 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. 118 118 ))) ... ... @@ -138,16 +138,17 @@ 138 138 139 139 === 2.2.1 Test Requirement === 140 140 160 + 141 141 ((( 142 142 To use NDDS75 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. 146 -* The local NB-IoT network used the band that NS E01supports.166 +* The local NB-IoT network used the band that NDDS75 supports. 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 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 170 +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. 151 151 ))) 152 152 153 153 ... ... @@ -157,6 +157,7 @@ 157 157 158 158 === 2.2.2 Insert SIM card === 159 159 180 + 160 160 ((( 161 161 Insert the NB-IoT Card get from your provider. 162 162 ))) ... ... @@ -172,6 +172,7 @@ 172 172 173 173 === 2.2.3 Connect USB – TTL to NDDS75 to configure it === 174 174 196 + 175 175 ((( 176 176 ((( 177 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. ... ... @@ -180,6 +180,7 @@ 180 180 181 181 [[image:image-20220709092052-2.png]] 182 182 205 + 183 183 **Connection:** 184 184 185 185 (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND ... ... @@ -203,8 +203,9 @@ 203 203 204 204 [[image:1657329814315-101.png]] 205 205 229 + 206 206 ((( 207 -(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dr agino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]231 +(% style="color:red" %)**Note: the valid AT Commands can be found at: **(%%)**[[https:~~/~~/www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0>>https://www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0]]** 208 208 ))) 209 209 210 210 ... ... @@ -211,21 +211,38 @@ 211 211 212 212 === 2.2.4 Use CoAP protocol to uplink data === 213 213 214 -(% style="color:red" %)Note: if you don't have CoAP server, you can refer this link to set up one: (%%)[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]] 215 215 239 +(% style="color:red" %)**Note: if you don't have CoAP server, you can refer this link to set up one: **(%%)**[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]** 216 216 241 + 242 +((( 217 217 **Use below commands:** 244 +))) 218 218 219 -* (% style="color:blue" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 220 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%)~/~/ to set CoAP server address and port 221 -* (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path 246 +* ((( 247 +(% style="color:blue" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 248 +))) 249 +* ((( 250 +(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%)~/~/ to set CoAP server address and port 251 +))) 252 +* ((( 253 +(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path 222 222 255 + 256 + 257 +))) 258 + 259 +((( 223 223 For parameter description, please refer to AT command set 261 +))) 224 224 225 225 [[image:1657330452568-615.png]] 226 226 227 227 266 + 267 +((( 228 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. 269 +))) 229 229 230 230 [[image:1657330472797-498.png]] 231 231 ... ... @@ -234,11 +234,10 @@ 234 234 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 235 235 236 236 237 -* (% style="color:blue" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 278 +* (% 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 -* (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 280 +* (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/ If the server does not respond, this command is unnecessary 240 240 241 - 242 242 [[image:1657330501006-241.png]] 243 243 244 244 ... ... @@ -249,11 +249,11 @@ 249 249 === 2.2.6 Use MQTT protocol to uplink data === 250 250 251 251 252 -* (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 253 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 254 -* (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 255 -* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 256 -* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 292 +* (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 293 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 294 +* (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 295 +* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 296 +* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 257 257 * (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB **(%%)~/~/Set the sending topic of MQTT 258 258 * (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB **(%%) ~/~/Set the subscription topic of MQTT 259 259 ... ... @@ -275,7 +275,6 @@ 275 275 * (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 276 276 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 277 277 278 - 279 279 [[image:image-20220709093918-1.png]] 280 280 281 281 ... ... @@ -283,62 +283,108 @@ 283 283 284 284 285 285 286 - 287 - 288 - 289 289 === 2.2.8 Change Update Interval === 290 290 327 + 291 291 User can use below command to change the (% style="color:green" %)**uplink interval**. 292 292 293 293 * (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 294 294 295 295 ((( 296 -(% style="color:red" %)**NOTE:** 297 -))) 333 +(% style="color:red" %)**NOTE: By default, the device will send an uplink message every 1 hour.** 298 298 299 -((( 300 -(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 335 + 301 301 ))) 302 302 338 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 303 303 340 +**By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).** 304 304 342 + 305 305 == 2.3 Uplink Payload == 306 306 307 -In this mode, uplink payload includes in total 18 bytes 308 308 309 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 346 +In this mode, uplink payload includes in total 14 bytes 347 + 348 + 349 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:440px" %) 310 310 |=(% style="width: 60px;" %)((( 311 311 **Size(bytes)** 312 -)))|=(% 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**313 -|(% 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:10 8px" %)[[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"]]352 +)))|=(% style="width: 60px;" %)**6**|=(% style="width: 35px;" %)2|=(% style="width: 35px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 100px;" %)**2**|=(% style="width: 60px;" %)**1** 353 +|(% 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:120px" %)[[Distance (unit: mm)>>||anchor="H2.4.5A0Distance"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.6A0DigitalInterrupt"]] 314 314 315 315 ((( 316 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NS E01 uplink data.356 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS751 uplink data. 317 317 ))) 318 318 319 319 320 -[[image: image-20220708111918-4.png]]360 +[[image:1657331036973-987.png]] 321 321 322 322 363 +((( 323 323 The payload is ASCII string, representative same HEX: 365 +))) 324 324 325 -0x72403155615900640c7817075e0a8c02f900 where: 367 +((( 368 +0x72403155615900640c6c19029200 where: 369 +))) 326 326 327 -* Device ID: 0x 724031556159 = 724031556159 328 -* Version: 0x0064=100=1.0.0 371 +* ((( 372 +Device ID: 0x724031556159 = 724031556159 373 +))) 374 +* ((( 375 +Version: 0x0064=100=1.0.0 376 +))) 329 329 330 -* BAT: 0x0c78 = 3192 mV = 3.192V 331 -* Singal: 0x17 = 23 332 -* Soil Moisture: 0x075e= 1886 = 18.86 % 333 -* Soil Temperature:0x0a8c =2700=27 °C 334 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 335 -* Interrupt: 0x00 = 0 378 +* ((( 379 +BAT: 0x0c6c = 3180 mV = 3.180V 380 +))) 381 +* ((( 382 +Signal: 0x19 = 25 383 +))) 384 +* ((( 385 +Distance: 0x0292= 658 mm 386 +))) 387 +* ((( 388 +Interrupt: 0x00 = 0 336 336 390 + 391 +))) 392 + 393 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 394 + 395 +In this mode, uplink payload includes 69 bytes in total by default. 396 + 397 +Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded. 398 + 399 +|**Size(bytes)**|**8**|2|2|1|1|1|2|4|2|4 400 +|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Distance|Timestamp|Distance|Timestamp....... 401 + 402 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS75 uplink data. 403 + 404 +[[image:image-20220908175246-1.png]] 405 + 406 +The payload is ASCII string, representative same HEX: 407 + 408 +0x(% style="color:red" %)f867787050213317(% style="color:blue" %)0084(% style="color:green" %)0cf4(% style="color:red" %)1e(% style="color:blue" %)01(% style="color:green" %)00(% style="color:red" %)**//00396319bb32//**00396319baf0//**00396319ba3c**//00396319b988//**00396319b8d4**//00396319b820//**00396319b76c**//00396319b6b8//**00396319b604**//(%%) where: 409 + 410 +* (% style="color:green" %)Device ID: f867787050213317 = f867787050213317 411 +* (% style="color:red" %)Version: 0x0084=132=1.3.2 412 +* (% style="color:green" %)BAT: 0x0cf4 = 3316 mV = 3.316V 413 +* (% style="color:blue" %)Singal: 0x1e = 30 414 +* (% style="color:red" %)Mod: 0x01 = 1 415 +* Interrupt: 0x00= 0 416 +* Distance: 0x0039= 57 = 57 417 +* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 418 +* Distance,Time stamp : 00396319baf0 419 +* (% style="color:red" %) 8 sets of recorded data: Distance,Time stamp : //**00396319ba3c**//,....... 420 + 337 337 == 2.4 Payload Explanation and Sensor Interface == 338 338 339 339 340 340 === 2.4.1 Device ID === 341 341 426 + 342 342 ((( 343 343 By default, the Device ID equal to the last 6 bytes of IMEI. 344 344 ))) ... ... @@ -345,6 +345,8 @@ 345 345 346 346 ((( 347 347 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 433 + 434 + 348 348 ))) 349 349 350 350 ((( ... ... @@ -356,19 +356,29 @@ 356 356 ))) 357 357 358 358 ((( 359 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 446 +The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID. 360 360 ))) 361 361 362 362 450 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 363 363 452 +By default, the Device ID equal to the last 15 bits of IMEI. 453 + 454 +User can use **AT+DEUI** to set Device ID 455 + 456 +**Example:** 457 + 458 +AT+DEUI=868411056754138 459 + 364 364 === 2.4.2 Version Info === 365 365 462 + 366 366 ((( 367 367 Specify the software version: 0x64=100, means firmware version 1.00. 368 368 ))) 369 369 370 370 ((( 371 -For example: 0x00 64 : this device is NS E01with firmware version 1.0.0.468 +For example: 0x00 64 : this device is NDDS75 with firmware version 1.0.0. 372 372 ))) 373 373 374 374 ... ... @@ -375,9 +375,6 @@ 375 375 376 376 === 2.4.3 Battery Info === 377 377 378 -((( 379 -Check the battery voltage for LSE01. 380 -))) 381 381 382 382 ((( 383 383 Ex1: 0x0B45 = 2885mV ... ... @@ -391,6 +391,7 @@ 391 391 392 392 === 2.4.4 Signal Strength === 393 393 488 + 394 394 ((( 395 395 NB-IoT Network signal Strength. 396 396 ))) ... ... @@ -421,65 +421,22 @@ 421 421 422 422 423 423 424 -=== 2.4.5 Soil Moisture ===519 +=== 2.4.5 Distance === 425 425 426 -((( 427 -((( 428 -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. 429 -))) 430 -))) 431 431 432 -((( 433 -((( 434 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is 435 -))) 436 -))) 522 +Get the distance. Flat object range 280mm - 7500mm. 437 437 438 438 ((( 439 - 525 +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 442 ((( 443 -(% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.** 444 -))) 445 - 446 - 447 - 448 -=== 2.4.6 Soil Temperature === 449 - 450 450 ((( 451 - Getthetemperatureinthesoil.Thevaluerangeoftheregisteris-4000-+800(Decimal),dividethisvalueby100togetthetemperatureinthesoil.Forexample,ifthedatayougetfromtheregisteris__**0x090xEC**__,thetemperaturecontentinthesoilis530 +(% style="color:blue" %)** 0B05(H) = 2821(D) = 2821mm.** 452 452 ))) 453 - 454 -((( 455 -**Example**: 456 456 ))) 457 457 458 458 ((( 459 -If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C 460 -))) 461 - 462 -((( 463 -If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C 464 -))) 465 - 466 - 467 - 468 -=== 2.4.7 Soil Conductivity (EC) === 469 - 470 -((( 471 -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). 472 -))) 473 - 474 -((( 475 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 476 -))) 477 - 478 -((( 479 -Generally, the EC value of irrigation water is less than 800uS / cm. 480 -))) 481 - 482 -((( 483 483 484 484 ))) 485 485 ... ... @@ -487,10 +487,11 @@ 487 487 488 488 ))) 489 489 490 -=== 2.4. 8Digital Interrupt ===542 +=== 2.4.6 Digital Interrupt === 491 491 544 + 492 492 ((( 493 -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.546 +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. 494 494 ))) 495 495 496 496 ((( ... ... @@ -521,19 +521,24 @@ 521 521 522 522 523 523 524 -=== 2.4. 9+5V Output ===577 +=== 2.4.7 +5V Output === 525 525 579 + 526 526 ((( 527 -NS E01will enable +5V output before all sampling and disable the +5v after all sampling.581 +NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 528 528 ))) 529 529 530 530 531 531 ((( 532 532 The 5V output time can be controlled by AT Command. 587 + 588 + 533 533 ))) 534 534 535 535 ((( 536 536 (% style="color:blue" %)**AT+5VT=1000** 593 + 594 + 537 537 ))) 538 538 539 539 ((( ... ... @@ -544,11 +544,12 @@ 544 544 545 545 == 2.5 Downlink Payload == 546 546 547 -By default, NSE01 prints the downlink payload to console port. 548 548 549 - [[image:image-20220708133731-5.png]]606 +By default, NDDS75 prints the downlink payload to console port. 550 550 608 +[[image:image-20220709100028-1.png]] 551 551 610 + 552 552 ((( 553 553 (% style="color:blue" %)**Examples:** 554 554 ))) ... ... @@ -582,7 +582,7 @@ 582 582 ))) 583 583 584 584 ((( 585 -If payload = 0x04FF, it will reset the NS E01644 +If payload = 0x04FF, it will reset the NDDS75 586 586 ))) 587 587 588 588 ... ... @@ -593,79 +593,89 @@ 593 593 ))) 594 594 595 595 655 +== 2.6 Distance alarm function == 596 596 597 - ==2.6LED Indicator ==657 +➢ AT Command: 598 598 599 -((( 600 -The NSE01 has an internal LED which is to show the status of different state. 659 +AT+ LDDSALARM=min,max 601 601 661 +² When min=0, and max≠0, Alarm higher than max 602 602 603 -* 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) 604 -* Then the LED will be on for 1 second means device is boot normally. 605 -* After NSE01 join NB-IoT network. The LED will be ON for 3 seconds. 606 -* For each uplink probe, LED will be on for 500ms. 607 -))) 663 +² When min≠0, and max=0, Alarm lower than min 608 608 665 +² When min≠0 and max≠0, Alarm higher than max or lower than min 609 609 667 +Example: 610 610 669 +AT+ LDDSALARM=260,2000 ~/~/ Alarm when distance lower than 260. 611 611 612 -== 2.7 Installation in Soil == 613 613 614 - __**Measurementthesoilsurface**__672 +== 2.7 Set the number of data to be uploaded and the recording time == 615 615 616 -((( 617 -Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting. [[https:~~/~~/img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg>>url:https://img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg]] 618 -))) 674 +➢ AT Command: 619 619 620 - [[image:1657259653666-883.png]]676 +AT+TR=900 ~/~/The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 621 621 678 +AT+NOUD=8 ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 622 622 623 -((( 624 - 680 +== 2.8 Read or Clear cached data == 625 625 626 -((( 627 -Dig a hole with diameter > 20CM. 628 -))) 682 +➢ AT Command: 629 629 630 -((( 631 -Horizontal insert the probe to the soil and fill the hole for long term measurement. 632 -))) 633 -))) 684 +AT+CDP ~/~/ Read cached data 634 634 635 -[[image: 1654506665940-119.png]]686 +[[image:image-20220908175333-2.png]] 636 636 688 +AT+CDP=0 ~/~/ Clear cached data 689 + 690 +== 2.9 LED Indicator == 691 + 692 + 693 +The NDDS75 has an internal LED which is to show the status of different state. 694 + 695 + 696 +* 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) 697 +* Then the LED will be on for 1 second means device is boot normally. 698 +* After NDDS75 join NB-IoT network. The LED will be ON for 3 seconds. 699 +* For each uplink probe, LED will be on for 500ms. 700 + 637 637 ((( 638 638 639 639 ))) 640 640 641 641 642 -== 2.8 Firmware Change Log == 643 643 707 +== 2.10 Firmware Change Log == 644 644 645 -Download URL & Firmware Change log 646 646 647 -[[www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/Firmware/]] 710 +((( 711 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/3hb94r49iszmstx/AADvSJcXxahEUfxqKWVnZx-La?dl=0>>https://www.dropbox.com/sh/3hb94r49iszmstx/AADvSJcXxahEUfxqKWVnZx-La?dl=0]] 712 +))) 648 648 714 +((( 715 + 716 +))) 649 649 650 -Upgrade Instruction: [[Upgrade_Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 718 +((( 719 +Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 720 +))) 651 651 652 652 653 653 654 -== 2. 9Battery Analysis ==724 +== 2.11 Battery Analysis == 655 655 656 -=== 2.9.1 Battery Type === 657 657 727 +=== 2.11.1 Battery Type === 658 658 729 + 659 659 ((( 660 -The NS E01battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.731 +The NDDS75 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter. 661 661 ))) 662 662 663 - 664 664 ((( 665 665 The battery is designed to last for several years depends on the actually use environment and update interval. 666 666 ))) 667 667 668 - 669 669 ((( 670 670 The battery related documents as below: 671 671 ))) ... ... @@ -675,13 +675,14 @@ 675 675 * [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 676 676 677 677 ((( 678 -[[image:image-2022070 8140453-6.png]]747 +[[image:image-20220709101450-2.png]] 679 679 ))) 680 680 681 681 682 682 683 -=== 2. 9.2 Power consumption Analyze ===752 +=== 2.11.2 Power consumption Analyze === 684 684 754 + 685 685 ((( 686 686 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval. 687 687 ))) ... ... @@ -714,12 +714,13 @@ 714 714 And the Life expectation in difference case will be shown on the right. 715 715 ))) 716 716 717 -[[image:image-2022070 8141352-7.jpeg]]787 +[[image:image-20220709110451-3.png]] 718 718 719 719 720 720 721 -=== 2. 9.3 Battery Note ===791 +=== 2.11.3 Battery Note === 722 722 793 + 723 723 ((( 724 724 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 725 725 ))) ... ... @@ -726,10 +726,11 @@ 726 726 727 727 728 728 729 -=== 2. 9.4 Replace the battery ===800 +=== 2.11.4 Replace the battery === 730 730 802 + 731 731 ((( 732 -The default battery pack of NS E01includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).804 +The default battery pack of NDDS75 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes). 733 733 ))) 734 734 735 735 ... ... @@ -736,6 +736,7 @@ 736 736 737 737 = 3. Access NB-IoT Module = 738 738 811 + 739 739 ((( 740 740 Users can directly access the AT command set of the NB-IoT module. 741 741 ))) ... ... @@ -742,19 +742,23 @@ 742 742 743 743 ((( 744 744 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 818 + 819 + 745 745 ))) 746 746 747 -[[image:16572 61278785-153.png]]822 +[[image:1657333200519-600.png]] 748 748 749 749 750 750 751 751 = 4. Using the AT Commands = 752 752 828 + 753 753 == 4.1 Access AT Commands == 754 754 755 -See this link for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]] 756 756 832 +See this link for detail: [[https:~~/~~/www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0>>https://www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0]] 757 757 834 + 758 758 AT+<CMD>? : Help on <CMD> 759 759 760 760 AT+<CMD> : Run <CMD> ... ... @@ -794,7 +794,23 @@ 794 794 795 795 AT+SERVADDR : Server Address 796 796 874 +AT+TR : Get or Set record time" 797 797 876 +AT+APN : Get or set the APN 877 + 878 +AT+FBAND : Get or Set whether to automatically modify the frequency band 879 + 880 +AT+DNSCFG : Get or Set DNS Server 881 + 882 +AT+GETSENSORVALUE : Returns the current sensor measurement 883 + 884 +AT+NOUD : Get or Set the number of data to be uploaded 885 + 886 +AT+CDP : Read or Clear cached data 887 + 888 +AT+LDDSALARM : Get or Set alarm of distance 889 + 890 + 798 798 (% style="color:#037691" %)**COAP Management** 799 799 800 800 AT+URI : Resource parameters ... ... @@ -828,6 +828,7 @@ 828 828 829 829 = 5. FAQ = 830 830 924 + 831 831 == 5.1 How to Upgrade Firmware == 832 832 833 833 ... ... @@ -840,20 +840,14 @@ 840 840 ))) 841 841 842 842 ((( 843 -(% style="color:red" %)Notice, NS E01and LSE01share the same mother board. They use the same connection and method to update.937 +(% style="color:red" %)**Notice, NDDS75 and LDDS75 share the same mother board. They use the same connection and method to update.** 844 844 ))) 845 845 846 846 847 847 848 -== 5.2 Can I calibrate NSE01 to different soil types? == 849 - 850 -((( 851 -NSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]]. 852 -))) 853 - 854 - 855 855 = 6. Trouble Shooting = 856 856 944 + 857 857 == 6.1 Connection problem when uploading firmware == 858 858 859 859 ... ... @@ -869,6 +869,7 @@ 869 869 870 870 == 6.2 AT Command input doesn't work == 871 871 960 + 872 872 ((( 873 873 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string. 874 874 ... ... @@ -879,7 +879,7 @@ 879 879 = 7. Order Info = 880 880 881 881 882 -Part Number**:** (% style="color:#4f81bd" %)**NS E01**971 +Part Number**:** (% style="color:#4f81bd" %)**NSDDS75** 883 883 884 884 885 885 (% class="wikigeneratedid" %) ... ... @@ -894,7 +894,7 @@ 894 894 895 895 (% style="color:#037691" %)**Package Includes**: 896 896 897 -* NS E01NB-IoTSoil Moisture&ECSensor x 1986 +* NDDS75 NB-IoT Distance Detect Sensor Node x 1 898 898 * External antenna x 1 899 899 ))) 900 900 ... ... @@ -901,10 +901,13 @@ 901 901 ((( 902 902 903 903 993 + 904 904 (% style="color:#037691" %)**Dimension and weight**: 905 905 906 -* Size: 195 x 125 x 55 mm 907 -* Weight: 420g 996 +* Device Size: 13.0 x 5 x 4.5 cm 997 +* Device Weight: 150g 998 +* Package Size / pcs : 15 x 12x 5.5 cm 999 +* Weight / pcs : 220g 908 908 ))) 909 909 910 910 ((( ... ... @@ -916,5 +916,6 @@ 916 916 917 917 = 9. Support = 918 918 1011 + 919 919 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 920 920 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
- 1657332990863-496.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +138.2 KB - Content
- 1657333200519-600.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +126.1 KB - Content
- image-20220709100028-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +8.8 KB - Content
- image-20220709101450-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +138.5 KB - Content
- image-20220709110451-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +611.5 KB - Content
- image-20220908175246-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.7 KB - Content
- image-20220908175333-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +31.1 KB - Content