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)
Details
- Page properties
-
- Content
-
... ... @@ -298,19 +298,19 @@ 298 298 299 299 (% style="color:red" %)**Limit flag:** 300 300 301 -Mode for setting threshold: **0~~5**301 +Mode for setting threshold: 0~~5 302 302 303 - **0:**does not use upper and lower limits303 +0: does not use upper and lower limits 304 304 305 - **1:**Use upper and lower limits305 +1: Use upper and lower limits 306 306 307 - **2:**is less than the lower limit value307 +2: is less than the lower limit value 308 308 309 - **3:**is greater than the lower limit value309 +3: is greater than the lower limit value 310 310 311 - **4:**is less than the upper limit311 +4: is less than the upper limit 312 312 313 - **5:**is greater than the upper limit313 +5: is greater than the upper limit 314 314 315 315 316 316 (% style="color:blue" %)**Upper limit:** ... ... @@ -323,9 +323,91 @@ 323 323 The lower limit of the threshold cannot be less than 3mm. 324 324 325 325 326 -== 2. 4 Decodepayloadin TheThingsNetwork==326 +=== 2.3.3 Historical measuring distance, FPORT~=3 === 327 327 328 328 329 +DS20L stores sensor values and users can retrieve these history values via the downlink command. 330 + 331 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 332 + 333 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 334 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 335 +**Size(bytes)** 336 +)))|=(% 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 337 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 338 +Reserve(0xFF) 339 +)))|Distance|Distance signal strength|(% style="width:88px" %)((( 340 +LiDAR temp 341 +)))|(% style="width:85px" %)Unix TimeStamp 342 + 343 +**Interrupt flag & Interrupt level:** 344 + 345 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 346 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 347 +**Size(bit)** 348 +)))|=(% 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** 349 +|(% 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" %)((( 350 +Interrupt flag 351 +))) 352 + 353 +* ((( 354 +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. 355 +))) 356 + 357 +For example, in the US915 band, the max payload for different DR is: 358 + 359 +**a) DR0:** max is 11 bytes so one entry of data 360 + 361 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 362 + 363 +**c) DR2:** total payload includes 11 entries of data 364 + 365 +**d) DR3:** total payload includes 22 entries of data. 366 + 367 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0 368 + 369 + 370 +**Downlink:** 371 + 372 +0x31 64 CC 68 0C 64 CC 69 74 05 373 + 374 +[[image:image-20230805144936-2.png||height="113" width="746"]] 375 + 376 +**Uplink:** 377 + 378 +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 379 + 380 + 381 +**Parsed Value:** 382 + 383 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME] 384 + 385 + 386 +[360,176,30,High,True,2023-08-04 02:53:00], 387 + 388 +[355,168,30,Low,False,2023-08-04 02:53:29], 389 + 390 +[245,211,30,Low,False,2023-08-04 02:54:29], 391 + 392 +[57,700,30,Low,False,2023-08-04 02:55:29], 393 + 394 +[361,164,30,Low,True,2023-08-04 02:56:00], 395 + 396 +[337,184,30,Low,False,2023-08-04 02:56:40], 397 + 398 +[20,4458,30,Low,False,2023-08-04 02:57:40], 399 + 400 +[362,173,30,Low,False,2023-08-04 02:58:53], 401 + 402 + 403 +**History read from serial port:** 404 + 405 +[[image:image-20230805145056-3.png]] 406 + 407 + 408 +=== 2.3.4 Decode payload in The Things Network === 409 + 410 + 329 329 While using TTN network, you can add the payload format to decode the payload. 330 330 331 331 [[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"]] ... ... @@ -340,7 +340,7 @@ 340 340 ))) 341 341 342 342 343 -== 2. 5Show Data in DataCake IoT Server ==425 +== 2.4 Show Data in DataCake IoT Server == 344 344 345 345 346 346 ((( ... ... @@ -372,10 +372,10 @@ 372 372 373 373 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 374 374 375 -[[image: image-20231129085201-1.png||height="515" width="961"]]457 +[[image:1701152946067-561.png]] 376 376 377 377 378 -== 2. 6Frequency Plans ==460 +== 2.5 Frequency Plans == 379 379 380 380 381 381 The DS20L uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets. ... ... @@ -396,8 +396,6 @@ 396 396 397 397 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 398 398 399 - 400 - 401 401 == 3.2 General Commands == 402 402 403 403 ... ... @@ -501,11 +501,9 @@ 501 501 502 502 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 503 503 584 +== 3.3.3 Set work mode == 504 504 505 505 506 -=== 3.3.3 Set work mode === 507 - 508 - 509 509 Feature: Switch working mode 510 510 511 511 (% style="color:blue" %)**AT Command: AT+MOD** ... ... @@ -524,8 +524,6 @@ 524 524 525 525 * **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 526 526 527 - 528 - 529 529 === 3.3.4 Set threshold and threshold mode === 530 530 531 531 ... ... @@ -543,30 +543,8 @@ 543 543 ))) 544 544 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 545 545 546 - 547 - 548 548 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 549 -|(% rowspan="11" style="color:blue; width:120px" %)((( 550 - 551 - 552 - 553 - 554 - 555 - 556 - 557 - 558 - 559 - 560 - 561 - 562 - 563 - 564 - 565 - 566 - 567 - 568 -**AT+DOL=5,1800,0,0,400** 569 -)))|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits 623 +|(% 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 570 570 |(% style="width:251px" %)1: Use upper and lower limits 571 571 |(% style="width:251px" %)2: Less than the lower limit 572 572 |(% style="width:251px" %)3: Greater than the lower limit ... ... @@ -582,8 +582,6 @@ 582 582 583 583 ))) 584 584 585 - 586 - 587 587 (% style="color:blue" %)**Downlink Command: 0x07** 588 588 589 589 Format: Command Code (0x07) followed by 9bytes. ... ... @@ -594,7 +594,7 @@ 594 594 595 595 * Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,0,100,0,400 596 596 597 -* Example 3: Downlink Payload: 070300000064000190 649 +* Example 3: Downlink Payload: 0703200000064000190 **~-~-->** AT+MOD=3,1800,100,0,400 598 598 599 599 * Example 4: Downlink Payload: 070407080000000190 **~-~-->** AT+MOD=4,0,100,0,400 600 600 ... ... @@ -630,8 +630,6 @@ 630 630 631 631 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**. 632 632 633 - 634 - 635 635 = 6. FAQ = 636 636 637 637 == 6.1 What is the frequency plan for DS20L? == ... ... @@ -719,8 +719,6 @@ 719 719 720 720 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 721 721 722 - 723 - 724 724 = 9. Packing Info = 725 725 726 726 ... ... @@ -738,8 +738,6 @@ 738 738 739 739 * Weight / pcs : g 740 740 741 - 742 - 743 743 = 10. Support = 744 744 745 745