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, 4 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: (% style="color:green" %)**9600** 175 +* Baud: (% style="color:green" %)**9600** 176 176 * Data bits:** (% style="color:green" %)8(%%)** 177 177 * Stop bits: (% style="color:green" %)**1** 178 -* Parity: (% style="color:green" %)**None** 178 +* Parity: (% style="color:green" %)**None** 179 179 * Flow Control: (% style="color:green" %)**None** 180 180 181 181 ((( ... ... @@ -199,8 +199,6 @@ 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 - 204 204 For parameter description, please refer to AT command set 205 205 206 206 [[image:1657249793983-486.png]] ... ... @@ -221,12 +221,9 @@ 221 221 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 222 222 * (% style="color:blue" %)**AT+CFM=1 ** (%%) ~/~/If the server does not respond, this command is unnecessary 223 223 224 - 225 - 226 226 [[image:1657249864775-321.png]] 227 227 228 228 229 - 230 230 [[image:1657249930215-289.png]] 231 231 232 232 ... ... @@ -239,13 +239,11 @@ 239 239 * (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 240 240 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 241 241 * (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 242 -* (% style="color:blue" %)**AT+UNAME=UNAME 243 -* (% style="color:blue" %)**AT+PWD=PWD 244 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB 237 +* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/Set the username of MQTT 238 +* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/Set the password of MQTT 239 +* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/Set the sending topic of MQTT 245 245 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) ~/~/Set the subscription topic of MQTT 246 246 247 - 248 - 249 249 [[image:1657249978444-674.png]] 250 250 251 251 ... ... @@ -252,7 +252,6 @@ 252 252 [[image:1657249990869-686.png]] 253 253 254 254 255 - 256 256 ((( 257 257 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. 258 258 ))) ... ... @@ -273,6 +273,7 @@ 273 273 [[image:1657250255956-604.png]] 274 274 275 275 268 + 276 276 === 2.2.8 Change Update Interval === 277 277 278 278 User can use below command to change the (% style="color:green" %)**uplink interval**. ... ... @@ -279,7 +279,6 @@ 279 279 280 280 * (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 281 281 282 - 283 283 ((( 284 284 (% style="color:red" %)**NOTE:** 285 285 ))) ... ... @@ -290,59 +290,64 @@ 290 290 291 291 292 292 285 +== 2.3 Uplink Payload == 293 293 287 +In this mode, uplink payload includes in total 18 bytes 294 294 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"]] 295 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 297 -== 2.3 Uplink Payload == 298 298 298 +[[image:image-20220708111918-4.png]] 299 299 300 -=== 2.3.1 MOD~=0(Default Mode) === 301 301 302 - LSE01will uplink payloadviaLoRaWANwithbelowpayload format:301 +The payload is ASCII string, representative same HEX: 303 303 304 -((( 305 -Uplink payload includes in total 11 bytes. 306 -))) 303 +0x72403155615900640c7817075e0a8c02f900 where: 307 307 308 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 309 -|((( 310 -**Size** 305 +* Device ID: 0x 724031556159 = 724031556159 306 +* Version: 0x0064=100=1.0.0 311 311 312 -**(bytes)** 313 -)))|**2**|**2**|**2**|**2**|**2**|**1** 314 -|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 315 -Temperature 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 316 316 317 -(Reserve, Ignore now) 318 -)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|((( 319 -MOD & Digital Interrupt 320 320 321 -(Optional) 322 -))) 316 +== 2.4 Payload Explanation and Sensor Interface == 323 323 324 -=== 2.3.2 MOD~=1(Original value) === 325 325 326 - Thismode can get the original ADvalueof moisture and original conductivity (with temperaturedriftcompensation).319 +=== 2.4.1 Device ID === 327 327 328 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 329 -|((( 330 -**Size** 321 +By default, the Device ID equal to the last 6 bytes of IMEI. 331 331 332 -**(bytes)** 333 -)))|**2**|**2**|**2**|**2**|**2**|**1** 334 -|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 335 -Temperature 323 +User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 336 336 337 -(Reserve, Ignore now) 338 -)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|((( 339 -MOD & Digital Interrupt 325 +**Example:** 340 340 341 -(Optional) 342 -))) 327 +AT+DEUI=A84041F15612 343 343 344 - ===2.3.3BatteryInfo===329 +The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 345 345 331 + 332 + 333 +=== 2.4.2 Version Info === 334 + 335 +Specify the software version: 0x64=100, means firmware version 1.00. 336 + 337 +For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0. 338 + 339 + 340 + 341 +=== 2.4.3 Battery Info === 342 + 346 346 ((( 347 347 Check the battery voltage for LSE01. 348 348 ))) ... ... @@ -357,14 +357,32 @@ 357 357 358 358 359 359 360 -=== 2. 3.4 SoilMoisture ===357 +=== 2.4.4 Signal Strength === 361 361 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 + 362 362 ((( 363 363 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. 364 364 ))) 365 365 366 366 ((( 367 -For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is 382 +For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is 368 368 ))) 369 369 370 370 ((( ... ... @@ -377,10 +377,10 @@ 377 377 378 378 379 379 380 -=== 2. 3.5Soil Temperature ===395 +=== 2.4.6 Soil Temperature === 381 381 382 382 ((( 383 - 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 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 is 384 384 ))) 385 385 386 386 ((( ... ... @@ -397,7 +397,7 @@ 397 397 398 398 399 399 400 -=== 2. 3.6Soil Conductivity (EC) ===415 +=== 2.4.7 Soil Conductivity (EC) === 401 401 402 402 ((( 403 403 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). ... ... @@ -404,7 +404,7 @@ 404 404 ))) 405 405 406 406 ((( 407 -For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm. 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. 408 408 ))) 409 409 410 410 ((( ... ... @@ -419,52 +419,47 @@ 419 419 420 420 ))) 421 421 422 -=== 2. 3.7MOD ===437 +=== 2.4.8 Digital Interrupt === 423 423 424 - Firmwareversionatleastv2.1supportschangingmode.439 +Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSE01 will send a packet to the server. 425 425 426 - Forexample,bytes[10]=90441 +The command is: 427 427 428 - mod=(bytes[10]>>7)&0x01=1.443 +(% style="color:blue" %)**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]])**.** 429 429 430 430 431 - **Downlink Command:**446 +The lower four bits of this data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H"]] for the hardware and software set up. 432 432 433 -If payload = 0x0A00, workmode=0 434 434 435 - If** **payload =** **0x0A01, workmode=1449 +Example: 436 436 451 +0x(00): Normal uplink packet. 437 437 453 +0x(01): Interrupt Uplink Packet. 438 438 439 -=== 2.3.8 Decode payload in The Things Network === 440 440 441 -While using TTN network, you can add the payload format to decode the payload. 442 442 457 +=== 2.4.9 +5V Output === 443 443 444 - [[image:1654505570700-128.png]]459 +NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 445 445 446 -((( 447 -The payload decoder function for TTN is here: 448 -))) 449 449 450 -((( 451 -LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]] 452 -))) 462 +The 5V output time can be controlled by AT Command. 453 453 464 +(% style="color:blue" %)**AT+5VT=1000** 454 454 455 - ==2.4UplinkInterval==466 +Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors. 456 456 457 -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"]] 458 458 459 459 470 +== 2.5 Downlink Payload == 460 460 461 -== 2.5 Downlink Payload == 462 - 463 463 By default, LSE50 prints the downlink payload to console port. 464 464 465 -[[image:image-20220 606165544-8.png]]474 +[[image:image-20220708133731-5.png]] 466 466 467 467 477 + 468 468 ((( 469 469 (% style="color:blue" %)**Examples:** 470 470 )))
- 1657259653666-883.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +344.4 KB - Content
- image-20220708111918-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +38.8 KB - Content
- image-20220708133731-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +8.7 KB - Content
- image-20220708140453-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +132.7 KB - Content