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)
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 ((( ... ... @@ -199,6 +199,7 @@ 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 + 202 202 For parameter description, please refer to AT command set 203 203 204 204 [[image:1657249793983-486.png]] ... ... @@ -219,9 +219,11 @@ 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 223 + 222 222 [[image:1657249864775-321.png]] 223 223 224 224 227 + 225 225 [[image:1657249930215-289.png]] 226 226 227 227 ... ... @@ -239,6 +239,7 @@ 239 239 * (% 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 245 + 242 242 [[image:1657249978444-674.png]] 243 243 244 244 ... ... @@ -245,6 +245,7 @@ 245 245 [[image:1657249990869-686.png]] 246 246 247 247 252 + 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 ))) ... ... @@ -265,7 +265,6 @@ 265 265 [[image:1657250255956-604.png]] 266 266 267 267 268 - 269 269 === 2.2.8 Change Update Interval === 270 270 271 271 User can use below command to change the (% style="color:green" %)**uplink interval**. ... ... @@ -290,7 +290,7 @@ 290 290 |=(% style="width: 50px;" %)((( 291 291 **Size(bytes)** 292 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"]]297 +|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>path:#Device_ID]]|(% style="width:41px" %)[[Ver>>path:#Version]]|(% style="width:46px" %)[[BAT>>path:#battery]]|(% style="width:123px" %)[[Signal Strength>>path:#Signal]]|(% style="width:108px" %)[[Soil Moisture>>path:#Payload_Explain]]|(% style="width:133px" %)[[Soil Temperature>>path:#Payload_Explain]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>path:#Payload_Explain]]|(% style="width:80px" %)[[Interrupt>>path:#Interrupt]] 294 294 295 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 ... ... @@ -313,33 +313,53 @@ 313 313 * Interrupt: 0x00 = 0 314 314 315 315 316 -== 2.4 Payload Explanation and Sensor Interface == 317 317 321 +=== 2.3.1 MOD~=0(Default Mode) === 318 318 319 - === 2.4.1DeviceID===323 +LSE01 will uplink payload via LoRaWAN with below payload format: 320 320 321 -By default, the Device ID equal to the last 6 bytes of IMEI. 325 +((( 326 +Uplink payload includes in total 11 bytes. 327 +))) 322 322 323 -User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 329 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 330 +|((( 331 +**Size** 324 324 325 -**Example:** 333 +**(bytes)** 334 +)))|**2**|**2**|**2**|**2**|**2**|**1** 335 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 336 +Temperature 326 326 327 -AT+DEUI=A84041F15612 338 +(Reserve, Ignore now) 339 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|((( 340 +MOD & Digital Interrupt 328 328 329 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 342 +(Optional) 343 +))) 330 330 345 +=== 2.3.2 MOD~=1(Original value) === 331 331 347 +This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation). 332 332 333 -=== 2.4.2 Version Info === 349 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 350 +|((( 351 +**Size** 334 334 335 -Specify the software version: 0x64=100, means firmware version 1.00. 353 +**(bytes)** 354 +)))|**2**|**2**|**2**|**2**|**2**|**1** 355 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 356 +Temperature 336 336 337 -For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0. 358 +(Reserve, Ignore now) 359 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|((( 360 +MOD & Digital Interrupt 338 338 362 +(Optional) 363 +))) 339 339 365 +=== 2.3.3 Battery Info === 340 340 341 -=== 2.4.3 Battery Info === 342 - 343 343 ((( 344 344 Check the battery voltage for LSE01. 345 345 ))) ... ... @@ -354,32 +354,14 @@ 354 354 355 355 356 356 357 -=== 2. 4.4gnalStrength===381 +=== 2.3.4 Soil Moisture === 358 358 359 -NB-IoT Network signal Strength. 360 - 361 -**Ex1: 0x1d = 29** 362 - 363 -(% style="color:blue" %)**0**(%%) -113dBm or less 364 - 365 -(% style="color:blue" %)**1**(%%) -111dBm 366 - 367 -(% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm 368 - 369 -(% style="color:blue" %)**31** (%%) -51dBm or greater 370 - 371 -(% style="color:blue" %)**99** (%%) Not known or not detectable 372 - 373 - 374 - 375 -=== 2.4.5 Soil Moisture === 376 - 377 377 ((( 378 378 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. 379 379 ))) 380 380 381 381 ((( 382 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is388 +For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is 383 383 ))) 384 384 385 385 ((( ... ... @@ -392,10 +392,10 @@ 392 392 393 393 394 394 395 -=== 2. 4.6Soil Temperature ===401 +=== 2.3.5 Soil Temperature === 396 396 397 397 ((( 398 - 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 is404 + 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 399 399 ))) 400 400 401 401 ((( ... ... @@ -412,7 +412,7 @@ 412 412 413 413 414 414 415 -=== 2. 4.7Soil Conductivity (EC) ===421 +=== 2.3.6 Soil Conductivity (EC) === 416 416 417 417 ((( 418 418 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). ... ... @@ -419,7 +419,7 @@ 419 419 ))) 420 420 421 421 ((( 422 -For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.428 +For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 423 423 ))) 424 424 425 425 ((( ... ... @@ -434,41 +434,39 @@ 434 434 435 435 ))) 436 436 437 -=== 2. 4.8DigitalInterrupt===443 +=== 2.3.7 MOD === 438 438 439 - Digital Interruptrefersto pin(% style="color:blue" %)**GPIO_EXTI**(%%),andtherearedifferenttrigger methods.When there isatrigger, the NSE01 will senda packet totheserver.445 +Firmware version at least v2.1 supports changing mode. 440 440 441 - The commandis:447 +For example, bytes[10]=90 442 442 443 - (% 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]])**.**449 +mod=(bytes[10]>>7)&0x01=1. 444 444 445 445 446 - 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.452 +**Downlink Command:** 447 447 454 +If payload = 0x0A00, workmode=0 448 448 449 - Example:456 +If** **payload =** **0x0A01, workmode=1 450 450 451 -0x(00): Normal uplink packet. 452 452 453 -0x(01): Interrupt Uplink Packet. 454 454 460 +=== 2.3.8 Decode payload in The Things Network === 455 455 462 +While using TTN network, you can add the payload format to decode the payload. 456 456 457 457 458 - === 2.4.9 +5V Output ===465 +[[image:1654505570700-128.png]] 459 459 467 +((( 468 +The payload decoder function for TTN is here: 469 +))) 460 460 461 -NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 471 +((( 472 +LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]] 473 +))) 462 462 463 463 464 -The 5V output time can be controlled by AT Command. 465 - 466 -(% style="color:blue" %)**AT+5VT=1000** 467 - 468 -Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors. 469 - 470 - 471 - 472 472 == 2.4 Uplink Interval == 473 473 474 474 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"]]