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, 1 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,7 +190,7 @@ 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 196 **Use below commands:** ... ... @@ -199,6 +199,8 @@ 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 + 202 202 For parameter description, please refer to AT command set 203 203 204 204 [[image:1657249793983-486.png]] ... ... @@ -219,9 +219,12 @@ 219 219 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 220 220 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 221 221 224 + 225 + 222 222 [[image:1657249864775-321.png]] 223 223 224 224 229 + 225 225 [[image:1657249930215-289.png]] 226 226 227 227 ... ... @@ -234,11 +234,13 @@ 234 234 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 235 235 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 236 236 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 237 -* (% style="color:blue" %)**AT+UNAME=UNAME 238 -* (% style="color:blue" %)**AT+PWD=PWD 239 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB 242 +* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 243 +* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 244 +* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/Set the sending topic of MQTT 240 240 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) ~/~/Set the subscription topic of MQTT 241 241 247 + 248 + 242 242 [[image:1657249978444-674.png]] 243 243 244 244 ... ... @@ -245,6 +245,7 @@ 245 245 [[image:1657249990869-686.png]] 246 246 247 247 255 + 248 248 ((( 249 249 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. 250 250 ))) ... ... @@ -253,17 +253,18 @@ 253 253 254 254 === 2.2.7 Use TCP protocol to uplink data === 255 255 264 + 256 256 This feature is supported since firmware version v110 257 257 258 258 259 -* (% style="color:blue" %)**AT+PRO=4 ** (%%) 268 +* (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 260 260 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%) ~/~/ to set TCP server address and port 261 261 262 -[[image: 1657250217799-140.png]]271 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]] 263 263 264 264 265 -[[image:1657250255956-604.png]] 266 266 275 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.jpg]] 267 267 268 268 269 269 === 2.2.8 Change Update Interval === ... ... @@ -270,77 +270,68 @@ 270 270 271 271 User can use below command to change the (% style="color:green" %)**uplink interval**. 272 272 273 -* (% style="color:blue" %) **AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s282 +**~ (% style="color:blue" %)AT+TDC=600 (%%)**(% style="color:blue" %) (%%)~/~/ Set Update Interval to 600s 274 274 275 - (((284 + 276 276 (% style="color:red" %)**NOTE:** 277 -))) 278 278 279 -((( 280 280 (% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 281 -))) 282 282 283 283 284 284 285 -== 2.3 Uplink Payload == 286 286 287 -In this mode, uplink payload includes in total 18 bytes 288 288 289 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 290 -|=(% style="width: 50px;" %)((( 291 -**Size(bytes)** 292 -)))|=(% 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** 293 -|(% 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"]] 294 294 295 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data. 296 296 295 +== 2.3 Uplink Payload == 297 297 298 -[[image:image-20220708111918-4.png]] 299 299 298 +=== 2.3.1 MOD~=0(Default Mode) === 300 300 301 - Thepayload isASCIIstring,representative sameHEX:300 +LSE01 will uplink payload via LoRaWAN with below payload format: 302 302 303 -0x72403155615900640c7817075e0a8c02f900 where: 302 +((( 303 +Uplink payload includes in total 11 bytes. 304 +))) 304 304 305 -* Device ID: 0x 724031556159 = 724031556159 306 -* Version: 0x0064=100=1.0.0 306 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 307 +|((( 308 +**Size** 307 307 308 -* BAT: 0x0c78 = 3192 mV = 3.192V 309 -* Singal: 0x17 = 23 310 -* Soil Moisture: 0x075e= 1886 = 18.86 % 311 -* Soil Temperature:0x0a8c =2700=27 °C 312 -* Soil Conductivity(EC) = 0x02f9 =761 uS /cm 313 -* Interrupt: 0x00 = 0 310 +**(bytes)** 311 +)))|**2**|**2**|**2**|**2**|**2**|**1** 312 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 313 +Temperature 314 314 315 +(Reserve, Ignore now) 316 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|((( 317 +MOD & Digital Interrupt 315 315 319 +(Optional) 320 +))) 316 316 317 -== 2. 4Payload ExplanationndSensor Interface ==322 +=== 2.3.2 MOD~=1(Original value) === 318 318 324 +This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation). 319 319 320 -=== 2.4.1 Device ID === 326 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 327 +|((( 328 +**Size** 321 321 322 -By default, the Device ID equal to the last 6 bytes of IMEI. 330 +**(bytes)** 331 +)))|**2**|**2**|**2**|**2**|**2**|**1** 332 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 333 +Temperature 323 323 324 -User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 335 +(Reserve, Ignore now) 336 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|((( 337 +MOD & Digital Interrupt 325 325 326 -**Example:** 339 +(Optional) 340 +))) 327 327 328 - AT+DEUI=A84041F15612342 +=== 2.3.3 Battery Info === 329 329 330 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 331 - 332 - 333 - 334 -=== 2.4.2 Version Info === 335 - 336 -Specify the software version: 0x64=100, means firmware version 1.00. 337 - 338 -For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0. 339 - 340 - 341 - 342 -=== 2.4.3 Battery Info === 343 - 344 344 ((( 345 345 Check the battery voltage for LSE01. 346 346 ))) ... ... @@ -355,32 +355,14 @@ 355 355 356 356 357 357 358 -=== 2. 4.4gnalStrength===358 +=== 2.3.4 Soil Moisture === 359 359 360 -NB-IoT Network signal Strength. 361 - 362 -**Ex1: 0x1d = 29** 363 - 364 -(% style="color:blue" %)**0**(%%) -113dBm or less 365 - 366 -(% style="color:blue" %)**1**(%%) -111dBm 367 - 368 -(% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm 369 - 370 -(% style="color:blue" %)**31** (%%) -51dBm or greater 371 - 372 -(% style="color:blue" %)**99** (%%) Not known or not detectable 373 - 374 - 375 - 376 -=== 2.4.5 Soil Moisture === 377 - 378 378 ((( 379 379 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. 380 380 ))) 381 381 382 382 ((( 383 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is365 +For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is 384 384 ))) 385 385 386 386 ((( ... ... @@ -393,10 +393,10 @@ 393 393 394 394 395 395 396 -=== 2. 4.6Soil Temperature ===378 +=== 2.3.5 Soil Temperature === 397 397 398 398 ((( 399 - 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 is381 + 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 400 400 ))) 401 401 402 402 ((( ... ... @@ -413,7 +413,7 @@ 413 413 414 414 415 415 416 -=== 2. 4.7Soil Conductivity (EC) ===398 +=== 2.3.6 Soil Conductivity (EC) === 417 417 418 418 ((( 419 419 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). ... ... @@ -420,7 +420,7 @@ 420 420 ))) 421 421 422 422 ((( 423 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.405 +For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 424 424 ))) 425 425 426 426 ((( ... ... @@ -435,41 +435,39 @@ 435 435 436 436 ))) 437 437 438 -=== 2. 4.8DigitalInterrupt===420 +=== 2.3.7 MOD === 439 439 440 - Digital Interruptrefersto pin**(% style="color:blue" %)GPIO_EXTI**(%%),andtherearedifferenttrigger methods.When there isatrigger, the NSE01 will senda packet totheserver.422 +Firmware version at least v2.1 supports changing mode. 441 441 442 - The commandis:424 +For example, bytes[10]=90 443 443 444 - **(% style="color:blue" %)AT+INTMOD=3 **(%%) ~/~/(more info aboutINMOD please refer[[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]]**).**426 +mod=(bytes[10]>>7)&0x01=1. 445 445 446 446 447 - The lower four bits of this data field shows if this packet is generated by interrupt or not. [[Clickhere>>||anchor="H"]] for the hardware andsoftware set up.429 +**Downlink Command:** 448 448 431 +If payload = 0x0A00, workmode=0 449 449 450 - Example:433 +If** **payload =** **0x0A01, workmode=1 451 451 452 -0x(00): Normal uplink packet. 453 453 454 -0x(01): Interrupt Uplink Packet. 455 455 437 +=== 2.3.8 Decode payload in The Things Network === 456 456 439 +While using TTN network, you can add the payload format to decode the payload. 457 457 458 458 459 - === 2.4.9 +5V Output ===442 +[[image:1654505570700-128.png]] 460 460 444 +((( 445 +The payload decoder function for TTN is here: 446 +))) 461 461 462 -NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 448 +((( 449 +LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]] 450 +))) 463 463 464 464 465 -The 5V output time can be controlled by AT Command. 466 - 467 -(% style="color:blue" %)**AT+5VT=1000** 468 - 469 -Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors. 470 - 471 - 472 - 473 473 == 2.4 Uplink Interval == 474 474 475 475 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"]]
- image-20220708111918-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -38.8 KB - Content