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,26 +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 -**AT+DOL=5,1800,0,0,400** 565 -)))|(% 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 566 566 |(% style="width:251px" %)1: Use upper and lower limits 567 567 |(% style="width:251px" %)2: Less than the lower limit 568 568 |(% style="width:251px" %)3: Greater than the lower limit ... ... @@ -578,8 +578,6 @@ 578 578 579 579 ))) 580 580 581 - 582 - 583 583 (% style="color:blue" %)**Downlink Command: 0x07** 584 584 585 585 Format: Command Code (0x07) followed by 9bytes. ... ... @@ -590,7 +590,7 @@ 590 590 591 591 * Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,0,100,0,400 592 592 593 -* Example 3: Downlink Payload: 070300000064000190 649 +* Example 3: Downlink Payload: 0703200000064000190 **~-~-->** AT+MOD=3,1800,100,0,400 594 594 595 595 * Example 4: Downlink Payload: 070407080000000190 **~-~-->** AT+MOD=4,0,100,0,400 596 596 ... ... @@ -626,8 +626,6 @@ 626 626 627 627 * 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]]**. 628 628 629 - 630 - 631 631 = 6. FAQ = 632 632 633 633 == 6.1 What is the frequency plan for DS20L? == ... ... @@ -715,8 +715,6 @@ 715 715 716 716 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 717 717 718 - 719 - 720 720 = 9. Packing Info = 721 721 722 722 ... ... @@ -734,8 +734,6 @@ 734 734 735 735 * Weight / pcs : g 736 736 737 - 738 - 739 739 = 10. Support = 740 740 741 741