Last modified by Mengting Qiu on 2023/12/14 11:15

From version 112.1
edited by Xiaoling
on 2023/11/10 09:14
Change comment: Uploaded new attachment "image-20231110091447-3.png", version {1}
To version 94.1
edited by Saxer Lin
on 2023/08/05 14:43
Change comment: Uploaded new attachment "image-20230805144259-1.png", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DS20L -- LoRaWAN Smart Distance Detector User Manual
1 +LDS12-LB -- LoRaWAN LiDAR ToF Distance Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20231110085342-2.png||height="481" width="481"]]
2 +[[image:image-20230614153353-1.png]]
3 3  
4 4  
5 5  
... ... @@ -7,7 +7,6 @@
7 7  
8 8  
9 9  
10 -
11 11  **Table of Contents:**
12 12  
13 13  {{toc/}}
... ... @@ -46,8 +46,8 @@
46 46  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
47 47  * Ultra-low power consumption
48 48  * Laser technology for distance detection
49 -* Measure Distance: 0.1m~~12m
50 -* Accuracy :  ±5cm@(0.1-5m), ±1%@(5m-12m)
48 +* Measure Distance: 0.1m~~12m @ 90% Reflectivity
49 +* Accuracy :  ±5cm@(0.1-6m), ±1%@(6m-12m)
51 51  * Monitor Battery Level
52 52  * Support Bluetooth v5.1 and LoRaWAN remote configure
53 53  * Support wireless OTA update firmware
... ... @@ -55,6 +55,7 @@
55 55  * Downlink to change configure
56 56  * 8500mAh Battery for long term use
57 57  
57 +
58 58  == 1.3 Specification ==
59 59  
60 60  
... ... @@ -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-5m), ±1%@(5m-12m)
74 -* Distance resolution : 1cm
73 +* Accuracy : ±5cm@(0.1-6m), ±1%@(6m-12m)
74 +* Distance resolution : 5mm
75 75  * Ambient light immunity : 70klux
76 76  * Enclosure rating : IP65
77 77  * Light source : LED
... ... @@ -100,6 +100,7 @@
100 100  * Sleep Mode: 5uA @ 3.3v
101 101  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
102 102  
103 +
103 103  == 1.4 Applications ==
104 104  
105 105  
... ... @@ -111,6 +111,7 @@
111 111  * Automatic control
112 112  * Sewer
113 113  
115 +
114 114  (% style="display:none" %)
115 115  
116 116  == 1.5 Sleep mode and working mode ==
... ... @@ -140,6 +140,7 @@
140 140  )))
141 141  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
142 142  
145 +
143 143  == 1.7 BLE connection ==
144 144  
145 145  
... ... @@ -156,8 +156,8 @@
156 156  
157 157  == 1.8 Pin Definitions ==
158 158  
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"]]
159 159  
160 -[[image:image-20230805144259-1.png||height="413" width="741"]]
161 161  
162 162  == 1.9 Mechanical ==
163 163  
... ... @@ -313,7 +313,7 @@
313 313  (((
314 314  LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
315 315  
316 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
319 +periodically send this uplink every 20 minutes, this interval [[can be changed>>https://111]].
317 317  
318 318  Uplink Payload totals 11 bytes.
319 319  )))
... ... @@ -380,33 +380,18 @@
380 380  Customers can judge whether they need to adjust the environment based on the signal strength.
381 381  
382 382  
383 -**1) When the sensor detects valid data:**
384 -
385 -[[image:image-20230805155335-1.png||height="145" width="724"]]
386 -
387 -
388 -**2) When the sensor detects invalid data:**
389 -
390 -[[image:image-20230805155428-2.png||height="139" width="726"]]
391 -
392 -
393 -**3) When the sensor is not connected:**
394 -
395 -[[image:image-20230805155515-3.png||height="143" width="725"]]
396 -
397 -
398 398  ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
399 399  
400 400  
401 401  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.
402 402  
403 -Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
391 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]].
404 404  
405 405  **Example:**
406 406  
407 -If byte[0]&0x01=0x00 : Normal uplink packet.
395 +0x00: Normal uplink packet.
408 408  
409 -If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
397 +0x01: Interrupt Uplink Packet.
410 410  
411 411  
412 412  ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
... ... @@ -432,97 +432,13 @@
432 432  
433 433  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
434 434  |=(% 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**
435 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
436 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info 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"]]
437 437  
438 -[[image:image-20230805150315-4.png||height="233" width="723"]]
439 439  
427 +=== 2.3.3 Decode payload in The Things Network ===
440 440  
441 -=== 2.3.3 Historical measuring distance, FPORT~=3 ===
442 442  
443 -
444 -LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
445 -
446 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
447 -
448 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
449 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
450 -**Size(bytes)**
451 -)))|=(% 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
452 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
453 -Reserve(0xFF)
454 -)))|Distance|Distance signal strength|(% style="width:88px" %)(((
455 -LiDAR temp
456 -)))|(% style="width:85px" %)Unix TimeStamp
457 -
458 -**Interrupt flag & Interrupt level:**
459 -
460 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
461 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
462 -**Size(bit)**
463 -)))|=(% 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**
464 -|(% 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" %)(((
465 -Interrupt flag
466 -)))
467 -
468 -* (((
469 -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.
470 -)))
471 -
472 -For example, in the US915 band, the max payload for different DR is:
473 -
474 -**a) DR0:** max is 11 bytes so one entry of data
475 -
476 -**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
477 -
478 -**c) DR2:** total payload includes 11 entries of data
479 -
480 -**d) DR3:** total payload includes 22 entries of data.
481 -
482 -If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
483 -
484 -
485 -**Downlink:**
486 -
487 -0x31 64 CC 68 0C 64 CC 69 74 05
488 -
489 -[[image:image-20230805144936-2.png||height="113" width="746"]]
490 -
491 -**Uplink:**
492 -
493 -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
494 -
495 -
496 -**Parsed Value:**
497 -
498 -[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME]
499 -
500 -
501 -[360,176,30,High,True,2023-08-04 02:53:00],
502 -
503 -[355,168,30,Low,False,2023-08-04 02:53:29],
504 -
505 -[245,211,30,Low,False,2023-08-04 02:54:29],
506 -
507 -[57,700,30,Low,False,2023-08-04 02:55:29],
508 -
509 -[361,164,30,Low,True,2023-08-04 02:56:00],
510 -
511 -[337,184,30,Low,False,2023-08-04 02:56:40],
512 -
513 -[20,4458,30,Low,False,2023-08-04 02:57:40],
514 -
515 -[362,173,30,Low,False,2023-08-04 02:58:53],
516 -
517 -
518 -**History read from serial port:**
519 -
520 -[[image:image-20230805145056-3.png]]
521 -
522 -
523 -=== 2.3.4 Decode payload in The Things Network ===
524 -
525 -
526 526  While using TTN network, you can add the payload format to decode the payload.
527 527  
528 528  [[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"]]
... ... @@ -715,6 +715,7 @@
715 715  * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.
716 716  * The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window.
717 717  
622 +
718 718  === 2.7.4  Reflectivity of different objects ===
719 719  
720 720  
... ... @@ -741,6 +741,7 @@
741 741  |(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200%
742 742  |(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300%
743 743  
649 +
744 744  = 3. Configure LDS12-LB =
745 745  
746 746  == 3.1 Configure Methods ==
... ... @@ -754,6 +754,7 @@
754 754  
755 755  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
756 756  
663 +
757 757  == 3.2 General Commands ==
758 758  
759 759  
... ... @@ -822,9 +822,9 @@
822 822  === 3.3.2 Set Interrupt Mode ===
823 823  
824 824  
825 -Feature, Set Interrupt mode for pin of GPIO_EXTI.
732 +Feature, Set Interrupt mode for PA8 of pin.
826 826  
827 -When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
734 +When AT+INTMOD=0 is set, PA8 is used as a digital input port.
828 828  
829 829  (% style="color:blue" %)**AT Command: AT+INTMOD**
830 830  
... ... @@ -835,11 +835,7 @@
835 835  OK
836 836  the mode is 0 =Disable Interrupt
837 837  )))
838 -|(% style="width:154px" %)(((
839 -AT+INTMOD=2
840 -
841 -(default)
842 -)))|(% style="width:196px" %)(((
745 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
843 843  Set Transmit Interval
844 844  0. (Disable Interrupt),
845 845  ~1. (Trigger by rising and falling edge)
... ... @@ -857,9 +857,10 @@
857 857  
858 858  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
859 859  
763 +
860 860  === 3.3.3  Set Power Output Duration ===
861 861  
862 -Control the output duration 3V3(pin of VBAT_OUT) . Before each sampling, device will
766 +Control the output duration 3V3 . Before each sampling, device will
863 863  
864 864  ~1. first enable the power output to external sensor,
865 865  
... ... @@ -875,7 +875,6 @@
875 875  OK
876 876  |(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
877 877  |(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK
878 -|(% style="width:154px" %)AT+3V3T=65535|(% style="width:196px" %)Always turn off the power supply of 3V3 pin.|(% style="width:157px" %)OK
879 879  
880 880  (% style="color:blue" %)**Downlink Command: 0x07**(%%)
881 881  Format: Command Code (0x07) followed by 3 bytes.
... ... @@ -884,8 +884,8 @@
884 884  
885 885  * Example 1: Downlink Payload: 07 01 00 00  **~-~-->**  AT+3V3T=0
886 886  * Example 2: Downlink Payload: 07 01 01 F4  **~-~-->**  AT+3V3T=500
887 -* Example 3: Downlink Payload: 07 01 FF FF  **~-~-->**  AT+3V3T=65535
888 888  
791 +
889 889  = 4. Battery & Power Consumption =
890 890  
891 891  
... ... @@ -914,6 +914,7 @@
914 914  
915 915  * 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]]**.
916 916  
820 +
917 917  = 6. FAQ =
918 918  
919 919  == 6.1 What is the frequency plan for LDS12-LB? ==
... ... @@ -974,6 +974,7 @@
974 974  
975 975  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
976 976  
881 +
977 977  = 9. ​Packing Info =
978 978  
979 979  
... ... @@ -991,6 +991,7 @@
991 991  
992 992  * Weight / pcs : g
993 993  
899 +
994 994  = 10. Support =
995 995  
996 996  
image-20230805144936-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -37.5 KB
Content
image-20230805145056-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -30.7 KB
Content
image-20230805150315-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -90.6 KB
Content
image-20230805155335-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -45.4 KB
Content
image-20230805155428-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -45.5 KB
Content
image-20230805155515-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -45.7 KB
Content
image-20231110085300-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -613.3 KB
Content
image-20231110085342-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -178.7 KB
Content
image-20231110091447-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -85.4 KB
Content