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, 8 removed)
Details
- Page properties
-
- Content
-
... ... @@ -172,10 +172,10 @@ 172 172 173 173 In the PC, use below serial tool settings: 174 174 175 -* Baud: 175 +* Baud: (% style="color:green" %)**9600** 176 176 * Data bits:** (% style="color:green" %)8(%%)** 177 177 * Stop bits: (% style="color:green" %)**1** 178 -* Parity: 178 +* Parity: (% style="color:green" %)**None** 179 179 * Flow Control: (% style="color:green" %)**None** 180 180 181 181 ((( ... ... @@ -190,29 +190,28 @@ 190 190 191 191 === 2.2.4 Use CoAP protocol to uplink data === 192 192 193 -(% 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/]]193 +(% style="color:red" %)Note: if you don't have CoAP server, you can refer this link to set up one: (%%)[[http:~~/~~/wiki.dragino.com/index.php?title=Set_up_CoAP_Server>>url:http://wiki.dragino.com/index.php?title=Set_up_CoAP_Server]] 194 194 195 195 196 - **Use below commands:**196 +Use below commands: 197 197 198 198 * (% style="color:blue" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 199 199 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%)~/~/ to set CoAP server address and port 200 200 * (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path 201 201 202 - 203 203 For parameter description, please refer to AT command set 204 204 205 -[[image: 1657249793983-486.png]]204 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]] 206 206 207 207 208 208 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. 209 209 210 -[[image: 1657249831934-534.png]]209 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]] 211 211 212 212 213 - 214 214 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 215 215 214 + 216 216 This feature is supported since firmware version v1.0.1 217 217 218 218 ... ... @@ -220,51 +220,51 @@ 220 220 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 221 221 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 222 222 223 -[[image: 1657249864775-321.png]]222 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.jpg]] 224 224 225 225 226 -[[image:1657249930215-289.png]] 227 227 228 228 229 229 228 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.jpg]] 229 + 230 + 230 230 === 2.2.6 Use MQTT protocol to uplink data === 231 231 233 + 232 232 This feature is supported since firmware version v110 233 233 234 234 235 -* (% style="color:blue" %)**AT+PRO=3 ** (%%) 236 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) 237 -* (% style="color:blue" %)**AT+CLIENT=CLIENT ** 238 -* (% style="color:blue" %)**AT+UNAME=UNAME 239 -* (% style="color:blue" %)**AT+PWD=PWD 240 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB 241 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) 237 +* (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 238 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 239 +* (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 240 +* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 241 +* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 242 +* (% 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 242 242 243 -[[image: 1657249978444-674.png]]245 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.gif]] 244 244 247 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.jpg]] 245 245 246 -[[image:1657249990869-686.png]] 247 247 248 - 249 -((( 250 250 MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 251 -))) 252 252 253 253 254 - 255 255 === 2.2.7 Use TCP protocol to uplink data === 256 256 255 + 257 257 This feature is supported since firmware version v110 258 258 259 259 260 -* (% style="color:blue" %)**AT+PRO=4 ** (%%) 259 +* (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 261 261 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 262 262 263 -[[image: 1657250217799-140.png]]262 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]] 264 264 265 265 266 -[[image:1657250255956-604.png]] 267 267 266 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.jpg]] 268 268 269 269 270 270 === 2.2.8 Change Update Interval === ... ... @@ -271,77 +271,68 @@ 271 271 272 272 User can use below command to change the (% style="color:green" %)**uplink interval**. 273 273 274 -* (% style="color:blue" %) **AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s273 +**~ (% style="color:blue" %)AT+TDC=600 (%%)**(% style="color:blue" %) (%%)~/~/ Set Update Interval to 600s 275 275 276 - (((275 + 277 277 (% style="color:red" %)**NOTE:** 278 -))) 279 279 280 -((( 281 281 (% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 282 -))) 283 283 284 284 285 285 286 -== 2.3 Uplink Payload == 287 287 288 -In this mode, uplink payload includes in total 18 bytes 289 289 290 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 291 -|=(% style="width: 50px;" %)((( 292 -**Size(bytes)** 293 -)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 40px;" %)**1** 294 -|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H"]]|(% style="width:41px" %)[[Ver>>||anchor="H"]]|(% style="width:46px" %)[[BAT>>||anchor="H"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H"]]|(% style="width:108px" %)[[Soil Moisture>>||anchor="H"]]|(% style="width:133px" %)[[Soil Temperature>>||anchor="H"]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>||anchor="H"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H"]] 295 295 296 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data. 297 297 286 +== 2.3 Uplink Payload == 298 298 299 -[[image:image-20220708111918-4.png]] 300 300 289 +=== 2.3.1 MOD~=0(Default Mode) === 301 301 302 - Thepayload isASCIIstring,representative sameHEX:291 +LSE01 will uplink payload via LoRaWAN with below payload format: 303 303 304 -0x72403155615900640c7817075e0a8c02f900 where: 293 +((( 294 +Uplink payload includes in total 11 bytes. 295 +))) 305 305 306 -* Device ID: 0x 724031556159 = 724031556159 307 -* Version: 0x0064=100=1.0.0 297 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 298 +|((( 299 +**Size** 308 308 309 -* BAT: 0x0c78 = 3192 mV = 3.192V 310 -* Singal: 0x17 = 23 311 -* Soil Moisture: 0x075e= 1886 = 18.86 % 312 -* Soil Temperature:0x0a8c =2700=27 °C 313 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 314 -* Interrupt: 0x00 = 0 301 +**(bytes)** 302 +)))|**2**|**2**|**2**|**2**|**2**|**1** 303 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 304 +Temperature 315 315 306 +(Reserve, Ignore now) 307 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|((( 308 +MOD & Digital Interrupt 316 316 310 +(Optional) 311 +))) 317 317 313 +=== 2.3.2 MOD~=1(Original value) === 318 318 319 - ==2.4 PayloadExplanation andSensorInterface==315 +This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation). 320 320 321 -=== 2.4.1 Device ID === 317 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 318 +|((( 319 +**Size** 322 322 323 -By default, the Device ID equal to the last 6 bytes of IMEI. 321 +**(bytes)** 322 +)))|**2**|**2**|**2**|**2**|**2**|**1** 323 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 324 +Temperature 324 324 325 -User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 326 +(Reserve, Ignore now) 327 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|((( 328 +MOD & Digital Interrupt 326 326 327 -**Example:** 330 +(Optional) 331 +))) 328 328 329 - AT+DEUI=A84041F15612333 +=== 2.3.3 Battery Info === 330 330 331 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 332 - 333 - 334 - 335 -=== 2.4.2 Version Info === 336 - 337 -Specify the software version: 0x64=100, means firmware version 1.00. 338 - 339 -For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0. 340 - 341 - 342 - 343 -=== 2.4.3 Battery Info === 344 - 345 345 ((( 346 346 Check the battery voltage for LSE01. 347 347 ))) ... ... @@ -356,32 +356,14 @@ 356 356 357 357 358 358 359 -=== 2. 4.4gnalStrength===349 +=== 2.3.4 Soil Moisture === 360 360 361 -NB-IoT Network signal Strength. 362 - 363 -**Ex1: 0x1d = 29** 364 - 365 -(% style="color:blue" %)**0**(%%) -113dBm or less 366 - 367 -(% style="color:blue" %)**1**(%%) -111dBm 368 - 369 -(% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm 370 - 371 -(% style="color:blue" %)**31** (%%) -51dBm or greater 372 - 373 -(% style="color:blue" %)**99** (%%) Not known or not detectable 374 - 375 - 376 - 377 -=== 2.4.5 Soil Moisture === 378 - 379 379 ((( 380 380 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. 381 381 ))) 382 382 383 383 ((( 384 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is356 +For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is 385 385 ))) 386 386 387 387 ((( ... ... @@ -394,10 +394,10 @@ 394 394 395 395 396 396 397 -=== 2. 4.6Soil Temperature ===369 +=== 2.3.5 Soil Temperature === 398 398 399 399 ((( 400 - 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 is372 + 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 401 401 ))) 402 402 403 403 ((( ... ... @@ -414,7 +414,7 @@ 414 414 415 415 416 416 417 -=== 2. 4.7Soil Conductivity (EC) ===389 +=== 2.3.6 Soil Conductivity (EC) === 418 418 419 419 ((( 420 420 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). ... ... @@ -421,7 +421,7 @@ 421 421 ))) 422 422 423 423 ((( 424 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.396 +For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 425 425 ))) 426 426 427 427 ((( ... ... @@ -436,42 +436,39 @@ 436 436 437 437 ))) 438 438 439 -=== 2. 4.8DigitalInterrupt===411 +=== 2.3.7 MOD === 440 440 413 +Firmware version at least v2.1 supports changing mode. 441 441 442 - Digital Interrupt refers topin **GPIO_EXTI**, and therearedifferent triggermethods. When there is a trigger, theNSE01 willsend a packet to the server.415 +For example, bytes[10]=90 443 443 444 - The commandis:417 +mod=(bytes[10]>>7)&0x01=1. 445 445 446 -**AT+INTMOD=3 ~/~/(more info about INMOD please refer **[[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]]**).** 447 447 420 +**Downlink Command:** 448 448 449 - The lowerfourbits of this data field shows if this packet is generatedbyinterruptornot. [[Click here>>||anchor="H"]] for the hardwareand software set up.422 +If payload = 0x0A00, workmode=0 450 450 424 +If** **payload =** **0x0A01, workmode=1 451 451 452 -Example: 453 453 454 -0x(00): Normal uplink packet. 455 455 456 - 0x(01):InterruptUplinkPacket.428 +=== 2.3.8 Decode payload in The Things Network === 457 457 430 +While using TTN network, you can add the payload format to decode the payload. 458 458 459 459 433 +[[image:1654505570700-128.png]] 460 460 461 -=== 2.4.9 +5V Output === 435 +((( 436 +The payload decoder function for TTN is here: 437 +))) 462 462 439 +((( 440 +LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]] 441 +))) 463 463 464 -NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 465 465 466 - 467 -The 5V output time can be controlled by AT Command. 468 - 469 -**(% style="color:blue" %)AT+5VT=1000** 470 - 471 -Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors. 472 - 473 - 474 - 475 475 == 2.4 Uplink Interval == 476 476 477 477 The LSE01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
- 1657249831934-534.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -72.5 KB - Content
- 1657249864775-321.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.0 KB - Content
- 1657249930215-289.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -77.3 KB - Content
- 1657249978444-674.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -139.5 KB - Content
- 1657249990869-686.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -96.9 KB - Content
- 1657250217799-140.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -98.7 KB - Content
- 1657250255956-604.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -99.0 KB - Content
- image-20220708111918-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -38.8 KB - Content