Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 5 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -206,107 +206,91 @@ 206 206 === 2.3.2 Uplink Payload, FPORT~=2 === 207 207 208 208 209 -((( 210 -DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will: 209 +==== (% style="color:red" %)**MOD~=1**(%%) ==== 211 211 212 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 213 - 214 -Uplink Payload totals 11 bytes. 215 -))) 216 - 217 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 218 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 219 -**Size(bytes)** 220 -)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white; width: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1** 221 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)((( 222 -[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]] 223 -)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)((( 224 -[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]] 225 -)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)((( 226 -[[Message Type>>||anchor="HMessageType"]] 227 -))) 228 - 229 -==== **MOD~=1** ==== 230 - 231 231 Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts. 232 232 233 233 Uplink Payload totals 10 bytes. 234 234 235 -(% border="1" cellspacing="4" style=" width:510px;background-color:#f2f2f2" %)236 -|(% style=" width:60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:30px;background-color:#4F81BD;color:white" %)**2**|(% style="width:130px;background-color:#4F81BD;color:white" %)**1**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**|(% style="width:100px;background-color:#4F81BD;color:white" %)**1**|(% style="width:120px;background-color:#4F81BD;color:white" %)**4**237 -|(% style="width:91px" %)Value|(% style="width:41px" %) [[BAT>>||anchor="HBatteryInfo"]]|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count215 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 216 +|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4** 217 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count 238 238 219 +[[image:1701155076393-719.png]] 239 239 240 - [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]221 +(% style="color:blue" %)**Battery Info:** 241 241 242 -==== **Battery Info** ==== 243 - 244 244 Check the battery voltage for DS20L 245 245 246 246 Ex1: 0x0E10 = 3600mV 247 247 248 -**MOD & Alarm & Interrupt** 249 249 250 -**MOD:** 228 +(% style="color:blue" %)**MOD & Alarm & Interrupt:** 251 251 230 +(% style="color:red" %)**MOD:** 231 + 252 252 **Example: ** (0x60>>6) & 0x3f =1 253 253 254 254 **0x01:** Regularly detect distance and report. 255 255 **0x02: ** Uninterrupted measurement (external power supply). 256 256 257 -**Alarm:** 237 +(% style="color:red" %)**Alarm:** 258 258 259 259 When the detection distance exceeds the limit, the alarm flag is set to 1. 260 260 261 -**Interrupt:** 241 +(% style="color:red" %)**Interrupt:** 262 262 263 263 Whether it is an external interrupt. 264 264 265 -==== Distance** info** ==== 266 266 246 +(% style="color:blue" %)**Distance info:** 247 + 267 267 **Example**: 268 268 269 269 If payload is: 0708H: distance = 0708H = 1800 mm 270 270 271 -==== **Sensor State** ==== 272 272 253 +(% style="color:blue" %)**Sensor State:** 254 + 273 273 Ex1: 0x00: Normal collection distance 274 274 275 275 Ex2 0x0x: Distance collection is wrong 276 276 277 -==== **Interript Count** ==== 278 278 260 +(% style="color:blue" %)**Interript Count:** 261 + 279 279 If payload is:000007D0H: count = 07D0H =2000 280 280 281 -**MOD=2** 282 282 283 -Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes. 284 284 285 -(% border="1" cellspacing="4" style="width:510px;background-color:#f2f2f2" %) 286 -|(% style="width:60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:30px;background-color:#4F81BD;color:white" %)**2**|(% style="width:130px;background-color:#4F81BD;color:white" %)**1**|(% style="width:70px;background-color:#4F81BD;color:white" %)**4**|(% style="width:100px;background-color:#4F81BD;color:white" %)**2**|(% style="width:120px;background-color:#4F81BD;color:white" %)**2** 287 -|(% style="width:91px" %)Value|(% style="width:41px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 266 +==== (% style="color:red" %)**MOD~=2**(%%)** ** ==== 288 288 268 +Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes. 289 289 290 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 270 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 271 +|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2** 272 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 291 291 292 - **MOD & Alarm & Do & Limit** **flag**274 +[[image:1701155150328-206.png]] 293 293 294 -**MOD:** 276 +(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 295 295 278 +(% style="color:red" %)**MOD:** 279 + 296 296 **Example: ** (0x60>>6) & 0x3f =1 297 297 298 298 **0x01:** Regularly detect distance and report. 299 299 **0x02: ** Uninterrupted measurement (external power supply). 300 300 301 -**Alarm:** 285 +(% style="color:red" %)**Alarm:** 302 302 303 303 When the detection distance exceeds the limit, the alarm flag is set to 1. 304 304 305 -**Do:** 289 +(% style="color:red" %)**Do:** 306 306 307 307 When the distance exceeds the set threshold, pull the Do pin high. 308 308 309 -**Limit ****flag:**293 +(% style="color:red" %)**Limit flag:** 310 310 311 311 Mode for setting threshold: 0~~5 312 312 ... ... @@ -322,100 +322,20 @@ 322 322 323 323 5: is greater than the upper limit 324 324 325 -**Upper limit:** 326 326 310 +(% style="color:blue" %)**Upper limit:** 311 + 327 327 The upper limit of the threshold cannot exceed 2000mm. 328 328 329 -**Lower limit:** 330 330 315 +(% style="color:blue" %)**Lower limit:** 316 + 331 331 The lower limit of the threshold cannot be less than 3mm. 332 332 333 333 334 -=== 2.3.3 Historicalmeasuringdistance,FPORT~=3===320 +=== 2.3.3 Decode payload in The Things Network === 335 335 336 336 337 -DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]]. 338 - 339 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 340 - 341 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 342 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 343 -**Size(bytes)** 344 -)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD; color: white; width: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4 345 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 346 -Reserve(0xFF) 347 -)))|Distance|Distance signal strength|(% style="width:88px" %)((( 348 -LiDAR temp 349 -)))|(% style="width:85px" %)Unix TimeStamp 350 - 351 -**Interrupt flag & Interrupt level:** 352 - 353 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 354 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 355 -**Size(bit)** 356 -)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0** 357 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)((( 358 -Interrupt flag 359 -))) 360 - 361 -* ((( 362 -Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands. 363 -))) 364 - 365 -For example, in the US915 band, the max payload for different DR is: 366 - 367 -**a) DR0:** max is 11 bytes so one entry of data 368 - 369 -**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 370 - 371 -**c) DR2:** total payload includes 11 entries of data 372 - 373 -**d) DR3:** total payload includes 22 entries of data. 374 - 375 -If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0 376 - 377 - 378 -**Downlink:** 379 - 380 -0x31 64 CC 68 0C 64 CC 69 74 05 381 - 382 -[[image:image-20230805144936-2.png||height="113" width="746"]] 383 - 384 -**Uplink:** 385 - 386 -43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D 387 - 388 - 389 -**Parsed Value:** 390 - 391 -[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME] 392 - 393 - 394 -[360,176,30,High,True,2023-08-04 02:53:00], 395 - 396 -[355,168,30,Low,False,2023-08-04 02:53:29], 397 - 398 -[245,211,30,Low,False,2023-08-04 02:54:29], 399 - 400 -[57,700,30,Low,False,2023-08-04 02:55:29], 401 - 402 -[361,164,30,Low,True,2023-08-04 02:56:00], 403 - 404 -[337,184,30,Low,False,2023-08-04 02:56:40], 405 - 406 -[20,4458,30,Low,False,2023-08-04 02:57:40], 407 - 408 -[362,173,30,Low,False,2023-08-04 02:58:53], 409 - 410 - 411 -**History read from serial port:** 412 - 413 -[[image:image-20230805145056-3.png]] 414 - 415 - 416 -=== 2.3.4 Decode payload in The Things Network === 417 - 418 - 419 419 While using TTN network, you can add the payload format to decode the payload. 420 420 421 421 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]] ... ... @@ -462,7 +462,7 @@ 462 462 463 463 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 464 464 465 -[[image: 1701152946067-561.png]]369 +[[image:image-20231129085201-1.png||height="515" width="961"]] 466 466 467 467 468 468 == 2.5 Frequency Plans == ... ... @@ -546,6 +546,9 @@ 546 546 ))) 547 547 * ((( 548 548 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 453 + 454 + 455 + 549 549 ))) 550 550 551 551 === 3.3.2 Set Interrupt Mode === ... ... @@ -586,7 +586,6 @@ 586 586 587 587 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 588 588 589 - 590 590 == 3.3.3 Set work mode == 591 591 592 592 ... ... @@ -625,10 +625,33 @@ 625 625 ))) 626 626 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 627 627 534 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 535 +|(% rowspan="11" style="color:blue; width:120px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits 536 +|(% style="width:251px" %)1: Use upper and lower limits 537 +|(% style="width:251px" %)2: Less than the lower limit 538 +|(% style="width:251px" %)3: Greater than the lower limit 539 +|(% style="width:251px" %)4: Less than the upper limit 540 +|(% style="width:251px" %)5: Greater than the upper limit 541 +|(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM 542 +|(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM 543 +|(% rowspan="2" style="width:226px" %)The fourth bit sets the over-limit alarm or person or object count.|(% style="width:251px" %)0 Over-limit alarm, DO output is high 544 +|(% style="width:251px" %)1 Person or object counting statistics 545 +|(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)((( 546 +0~~10000ms 628 628 548 + 549 +))) 629 629 551 + 630 630 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 631 -|(% rowspan="11" style="color:blue; width:120px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits 553 +|(% rowspan="11" style="color:blue; width:120px" %)** 554 + 555 + 556 + 557 + 558 + 559 + 560 +AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits 632 632 |(% style="width:251px" %)1: Use upper and lower limits 633 633 |(% style="width:251px" %)2: Less than the lower limit 634 634 |(% style="width:251px" %)3: Greater than the lower limit ... ... @@ -644,6 +644,8 @@ 644 644 645 645 ))) 646 646 576 + 577 + 647 647 (% style="color:blue" %)**Downlink Command: 0x07** 648 648 649 649 Format: Command Code (0x07) followed by 9bytes. ... ... @@ -652,8 +652,14 @@ 652 652 653 653 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 654 654 586 +* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,0,100,0,400 655 655 588 +* Example 3: Downlink Payload: 070300000064000190 **~-~-->** AT+MOD=3,1800,100,0,400 656 656 590 +* Example 4: Downlink Payload: 070407080000000190 **~-~-->** AT+MOD=4,0,100,0,400 591 + 592 +* Example 5: Downlink Payload: 070507080000000190 **~-~-->** AT+MOD=5,1800,100,0,400 593 + 657 657 = 4. Battery & Power Consumption = 658 658 659 659 ... ... @@ -690,6 +690,33 @@ 690 690 DS20L use the same frequency as other Dragino products. User can see the detail from this link: [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]] 691 691 692 692 630 +== 6.2 DS20L programming line == 631 + 632 + 633 +缺图 后续补上 634 + 635 +feature: 636 + 637 +for AT commands 638 + 639 +Update the firmware of DS20L 640 + 641 +Support interrupt mode 642 + 643 + 644 +== 6.3 LiDAR probe position == 645 + 646 + 647 +[[image:1701155390576-216.png||height="285" width="307"]] 648 + 649 +The black oval hole in the picture is the LiDAR probe. 650 + 651 + 652 +== 6.4 Interface definition == 653 + 654 +[[image:image-20231128151132-2.png||height="305" width="557"]] 655 + 656 + 693 693 = 7. Trouble Shooting = 694 694 695 695 == 7.1 AT Command input doesn't work ==
- 1701155076393-719.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.6 KB - Content
- 1701155150328-206.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.6 KB - Content
- 1701155390576-216.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +293.9 KB - Content
- image-20231128151132-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +281.2 KB - Content
- image-20231129085201-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +70.6 KB - Content