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 (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Saxer1 +XWiki.Xiaoling - Content
-
... ... @@ -45,8 +45,8 @@ 45 45 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 46 46 * Ultra-low power consumption 47 47 * Laser technology for distance detection 48 -* Measure Distance: 0.1m~~12m @ 90% Reflectivity49 -* Accuracy : ±5cm@(0.1- 6m), ±1%@(6m-12m)48 +* Measure Distance: 0.1m~~12m 49 +* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m) 50 50 * Monitor Battery Level 51 51 * Support Bluetooth v5.1 and LoRaWAN remote configure 52 52 * Support wireless OTA update firmware ... ... @@ -70,8 +70,8 @@ 70 70 * Measure Distance: 71 71 ** 0.1m ~~ 12m @ 90% Reflectivity 72 72 ** 0.1m ~~ 4m @ 10% Reflectivity 73 -* Accuracy : ±5cm@(0.1- 6m), ±1%@(6m-12m)74 -* Distance resolution : 5mm73 +* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m) 74 +* Distance resolution : 1cm 75 75 * Ambient light immunity : 70klux 76 76 * Enclosure rating : IP65 77 77 * Light source : LED ... ... @@ -159,8 +159,8 @@ 159 159 160 160 == 1.8 Pin Definitions == 161 161 162 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/WL03A-LB_LoRaWAN_None-Position_Rope_Type_Water_Leak_Controller_User_Manual/WebHome/image-20230613144156-1.png?rev=1.1||alt="image-20230613144156-1.png"]] 163 163 163 +[[image:image-20230805144259-1.png||height="413" width="741"]] 164 164 165 165 == 1.9 Mechanical == 166 166 ... ... @@ -316,7 +316,7 @@ 316 316 ((( 317 317 LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will: 318 318 319 -periodically send this uplink every 20 minutes, this interval [[can be changed>>ht tps://111]].319 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 320 320 321 321 Uplink Payload totals 11 bytes. 322 322 ))) ... ... @@ -383,18 +383,33 @@ 383 383 Customers can judge whether they need to adjust the environment based on the signal strength. 384 384 385 385 386 +**1) When the sensor detects valid data:** 387 + 388 +[[image:image-20230805155335-1.png||height="145" width="724"]] 389 + 390 + 391 +**2) When the sensor detects invalid data:** 392 + 393 +[[image:image-20230805155428-2.png||height="139" width="726"]] 394 + 395 + 396 +**3) When the sensor is not connected:** 397 + 398 +[[image:image-20230805155515-3.png||height="143" width="725"]] 399 + 400 + 386 386 ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ==== 387 387 388 388 389 389 This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up. 390 390 391 -Note: The Internet Pin is a separate pin in the screw terminal. See 406 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI . 392 392 393 393 **Example:** 394 394 395 -0x00: Normal uplink packet. 410 +If byte[0]&0x01=0x00 : Normal uplink packet. 396 396 397 -0x01: Interrupt Uplink Packet. 412 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet. 398 398 399 399 400 400 ==== (% style="color:blue" %)**LiDAR temp**(%%) ==== ... ... @@ -420,13 +420,97 @@ 420 420 421 421 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %) 422 422 |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload** 423 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %) [[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]424 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %) [[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]]438 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload 439 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload 425 425 441 +[[image:image-20230805150315-4.png||height="233" width="723"]] 426 426 427 -=== 2.3.3 Decode payload in The Things Network === 428 428 444 +=== 2.3.3 Historical measuring distance, FPORT~=3 === 429 429 446 + 447 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]]. 448 + 449 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 450 + 451 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 452 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 453 +**Size(bytes)** 454 +)))|=(% 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 455 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 456 +Reserve(0xFF) 457 +)))|Distance|Distance signal strength|(% style="width:88px" %)((( 458 +LiDAR temp 459 +)))|(% style="width:85px" %)Unix TimeStamp 460 + 461 +**Interrupt flag & Interrupt level:** 462 + 463 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 464 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 465 +**Size(bit)** 466 +)))|=(% 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** 467 +|(% 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" %)((( 468 +Interrupt flag 469 +))) 470 + 471 +* ((( 472 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands. 473 +))) 474 + 475 +For example, in the US915 band, the max payload for different DR is: 476 + 477 +**a) DR0:** max is 11 bytes so one entry of data 478 + 479 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 480 + 481 +**c) DR2:** total payload includes 11 entries of data 482 + 483 +**d) DR3:** total payload includes 22 entries of data. 484 + 485 +If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 486 + 487 + 488 +**Downlink:** 489 + 490 +0x31 64 CC 68 0C 64 CC 69 74 05 491 + 492 +[[image:image-20230805144936-2.png||height="113" width="746"]] 493 + 494 +**Uplink:** 495 + 496 +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 497 + 498 + 499 +**Parsed Value:** 500 + 501 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME] 502 + 503 + 504 +[360,176,30,High,True,2023-08-04 02:53:00], 505 + 506 +[355,168,30,Low,False,2023-08-04 02:53:29], 507 + 508 +[245,211,30,Low,False,2023-08-04 02:54:29], 509 + 510 +[57,700,30,Low,False,2023-08-04 02:55:29], 511 + 512 +[361,164,30,Low,True,2023-08-04 02:56:00], 513 + 514 +[337,184,30,Low,False,2023-08-04 02:56:40], 515 + 516 +[20,4458,30,Low,False,2023-08-04 02:57:40], 517 + 518 +[362,173,30,Low,False,2023-08-04 02:58:53], 519 + 520 + 521 +**History read from serial port:** 522 + 523 +[[image:image-20230805145056-3.png]] 524 + 525 + 526 +=== 2.3.4 Decode payload in The Things Network === 527 + 528 + 430 430 While using TTN network, you can add the payload format to decode the payload. 431 431 432 432 [[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"]] ... ... @@ -729,9 +729,9 @@ 729 729 === 3.3.2 Set Interrupt Mode === 730 730 731 731 732 -Feature, Set Interrupt mode for PA8ofpin.831 +Feature, Set Interrupt mode for pin of GPIO_EXTI. 733 733 734 -When AT+INTMOD=0 is set, P A8is used as a digital input port.833 +When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port. 735 735 736 736 (% style="color:blue" %)**AT Command: AT+INTMOD** 737 737 ... ... @@ -742,7 +742,11 @@ 742 742 OK 743 743 the mode is 0 =Disable Interrupt 744 744 ))) 745 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 844 +|(% style="width:154px" %)((( 845 +AT+INTMOD=2 846 + 847 +(default) 848 +)))|(% style="width:196px" %)((( 746 746 Set Transmit Interval 747 747 0. (Disable Interrupt), 748 748 ~1. (Trigger by rising and falling edge) ... ... @@ -763,7 +763,7 @@ 763 763 764 764 === 3.3.3 Set Power Output Duration === 765 765 766 -Control the output duration 3V3 . Before each sampling, device will 869 +Control the output duration 3V3(pin of VBAT_OUT) . Before each sampling, device will 767 767 768 768 ~1. first enable the power output to external sensor, 769 769 ... ... @@ -779,6 +779,7 @@ 779 779 OK 780 780 |(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 781 781 |(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK 885 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:196px" %)Always turn off the power supply of 3V3 pin.|(% style="width:157px" %)OK 782 782 783 783 (% style="color:blue" %)**Downlink Command: 0x07**(%%) 784 784 Format: Command Code (0x07) followed by 3 bytes. ... ... @@ -787,6 +787,7 @@ 787 787 788 788 * Example 1: Downlink Payload: 07 01 00 00 **~-~-->** AT+3V3T=0 789 789 * Example 2: Downlink Payload: 07 01 01 F4 **~-~-->** AT+3V3T=500 894 +* Example 3: Downlink Payload: 07 01 FF FF **~-~-->** AT+3V3T=65535 790 790 791 791 792 792 = 4. Battery & Power Consumption =
- image-20230805144259-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +872.7 KB - Content
- image-20230805144936-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +37.5 KB - Content
- image-20230805145056-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +30.7 KB - Content
- image-20230805150315-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +90.6 KB - Content
- image-20230805155335-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +45.4 KB - Content
- image-20230805155428-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +45.5 KB - Content
- image-20230805155515-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +45.7 KB - Content