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, 9 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 ((( ... ... @@ -190,10 +190,10 @@ 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/in dex.php?title=Set_up_CoAP_Server>>url:http://wiki.dragino.com/index.php?title=Set_up_CoAP_Server]]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/]] 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 ... ... @@ -201,17 +201,17 @@ 201 201 202 202 For parameter description, please refer to AT command set 203 203 204 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]]204 +[[image:1657249793983-486.png]] 205 205 206 206 207 207 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. 208 208 209 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]]209 +[[image:1657249831934-534.png]] 210 210 211 211 212 + 212 212 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 213 213 214 - 215 215 This feature is supported since firmware version v1.0.1 216 216 217 217 ... ... @@ -219,51 +219,51 @@ 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 222 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.jpg]]222 +[[image:1657249864775-321.png]] 223 223 224 224 225 +[[image:1657249930215-289.png]] 225 225 226 226 227 227 228 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.jpg]] 229 - 230 - 231 231 === 2.2.6 Use MQTT protocol to uplink data === 232 232 233 - 234 234 This feature is supported since firmware version v110 235 235 236 236 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 234 +* (% style="color:blue" %)**AT+PRO=3 ** (%%) ~/~/Set to use MQTT protocol to uplink 235 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 ** (%%) ~/~/Set MQTT server address and port 236 +* (% style="color:blue" %)**AT+CLIENT=CLIENT ** (%%)~/~/Set up the CLIENT of MQTT 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 240 +* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%) ~/~/Set the subscription topic of MQTT 244 244 245 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.gif]]242 +[[image:1657249978444-674.png]] 246 246 247 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.jpg]] 248 248 245 +[[image:1657249990869-686.png]] 249 249 247 + 248 +((( 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. 250 +))) 251 251 252 252 253 + 253 253 === 2.2.7 Use TCP protocol to uplink data === 254 254 255 - 256 256 This feature is supported since firmware version v110 257 257 258 258 259 -* (% style="color:blue" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 259 +* (% 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: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]]262 +[[image:1657250217799-140.png]] 263 263 264 264 265 +[[image:1657250255956-604.png]] 265 265 266 -[[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,68 +270,76 @@ 270 270 271 271 User can use below command to change the (% style="color:green" %)**uplink interval**. 272 272 273 -* *~(%%)**(%style="color:blue"%)(%%)~/~/ Set Update Interval to 600s273 +* (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 274 274 275 - 275 +((( 276 276 (% style="color:red" %)**NOTE:** 277 +))) 277 277 279 +((( 278 278 (% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 281 +))) 279 279 280 280 281 281 285 +== 2.3 Uplink Payload == 282 282 287 +In this mode, uplink payload includes in total 18 bytes 283 283 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"]] 284 284 295 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data. 285 285 286 -== 2.3 Uplink Payload == 287 287 298 +[[image:image-20220708111918-4.png]] 288 288 289 -=== 2.3.1 MOD~=0(Default Mode) === 290 290 291 - LSE01will uplink payloadviaLoRaWANwithbelowpayload format:301 +The payload is ASCII string, representative same HEX: 292 292 293 -((( 294 -Uplink payload includes in total 11 bytes. 295 -))) 303 +0x72403155615900640c7817075e0a8c02f900 where: 296 296 297 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 298 -|((( 299 -**Size** 305 +* Device ID: 0x 724031556159 = 724031556159 306 +* Version: 0x0064=100=1.0.0 300 300 301 -**(bytes)** 302 -)))|**2**|**2**|**2**|**2**|**2**|**1** 303 -|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 304 -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 305 305 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 309 309 310 -(Optional) 311 -))) 316 +== 2.4 Payload Explanation and Sensor Interface == 312 312 313 -=== 2.3.2 MOD~=1(Original value) === 314 314 315 - Thismode can get the original ADvalueof moisture and original conductivity (with temperaturedriftcompensation).319 +=== 2.4.1 Device ID === 316 316 317 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 318 -|((( 319 -**Size** 321 +By default, the Device ID equal to the last 6 bytes of IMEI. 320 320 321 -**(bytes)** 322 -)))|**2**|**2**|**2**|**2**|**2**|**1** 323 -|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 324 -Temperature 323 +User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 325 325 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 325 +**Example:** 329 329 330 -(Optional) 331 -))) 327 +AT+DEUI=A84041F15612 332 332 333 - ===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. 334 334 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 + 335 335 ((( 336 336 Check the battery voltage for LSE01. 337 337 ))) ... ... @@ -346,14 +346,32 @@ 346 346 347 347 348 348 349 -=== 2. 3.4 SoilMoisture ===357 +=== 2.4.4 Signal Strength === 350 350 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 + 351 351 ((( 352 352 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. 353 353 ))) 354 354 355 355 ((( 356 -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 357 357 ))) 358 358 359 359 ((( ... ... @@ -366,10 +366,10 @@ 366 366 367 367 368 368 369 -=== 2. 3.5Soil Temperature ===395 +=== 2.4.6 Soil Temperature === 370 370 371 371 ((( 372 - 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 373 373 ))) 374 374 375 375 ((( ... ... @@ -386,7 +386,7 @@ 386 386 387 387 388 388 389 -=== 2. 3.6Soil Conductivity (EC) ===415 +=== 2.4.7 Soil Conductivity (EC) === 390 390 391 391 ((( 392 392 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). ... ... @@ -393,7 +393,7 @@ 393 393 ))) 394 394 395 395 ((( 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. 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. 397 397 ))) 398 398 399 399 ((( ... ... @@ -408,52 +408,47 @@ 408 408 409 409 ))) 410 410 411 -=== 2. 3.7MOD ===437 +=== 2.4.8 Digital Interrupt === 412 412 413 - 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. 414 414 415 - Forexample,bytes[10]=90441 +The command is: 416 416 417 - 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]])**.** 418 418 419 419 420 - **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. 421 421 422 -If payload = 0x0A00, workmode=0 423 423 424 - If** **payload =** **0x0A01, workmode=1449 +Example: 425 425 451 +0x(00): Normal uplink packet. 426 426 453 +0x(01): Interrupt Uplink Packet. 427 427 428 -=== 2.3.8 Decode payload in The Things Network === 429 429 430 -While using TTN network, you can add the payload format to decode the payload. 431 431 457 +=== 2.4.9 +5V Output === 432 432 433 - [[image:1654505570700-128.png]]459 +NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 434 434 435 -((( 436 -The payload decoder function for TTN is here: 437 -))) 438 438 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 -))) 462 +The 5V output time can be controlled by AT Command. 442 442 464 +(% style="color:blue" %)**AT+5VT=1000** 443 443 444 - ==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. 445 445 446 -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"]] 447 447 448 448 470 +== 2.5 Downlink Payload == 449 449 450 -== 2.5 Downlink Payload == 451 - 452 452 By default, LSE50 prints the downlink payload to console port. 453 453 454 -[[image:image-20220 606165544-8.png]]474 +[[image:image-20220708133731-5.png]] 455 455 456 456 477 + 457 457 ((( 458 458 (% style="color:blue" %)**Examples:** 459 459 )))
- 1657249864775-321.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.0 KB - Content
- 1657249930215-289.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +77.3 KB - Content
- 1657249978444-674.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +139.5 KB - Content
- 1657249990869-686.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +96.9 KB - Content
- 1657250217799-140.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +98.7 KB - Content
- 1657250255956-604.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +99.0 KB - Content
- 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