Last modified by Xiaoling on 2025/04/27 16:45

From version 113.3
edited by Xiaoling
on 2022/06/10 15:04
Change comment: There is no comment for this version
To version 109.5
edited by Xiaoling
on 2022/06/10 13:48
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,7 +4,6 @@
4 4  
5 5  **Contents:**
6 6  
7 -{{toc/}}
8 8  
9 9  
10 10  
... ... @@ -11,7 +11,6 @@
11 11  
12 12  
13 13  
14 -
15 15  = 1.  Introduction =
16 16  
17 17  == 1.1 ​ What is LoRaWAN LiDAR ToF Distance Sensor ==
... ... @@ -19,30 +19,18 @@
19 19  (((
20 20  
21 21  
22 -(((
23 23  The Dragino LLDS12 is a (% style="color:blue" %)**LoRaWAN LiDAR ToF (Time of Flight) Distance Sensor**(%%) for Internet of Things solution. It is capable to measure the distance to an object as close as 10 centimeters (+/- 5cm up to 6m) and as far as 12 meters (+/-1% starting at 6m)!. The LiDAR probe uses laser induction technology for distance measurement.
24 -)))
25 25  
26 -(((
27 27  The LLDS12 can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc.
28 -)))
29 29  
30 -(((
31 31  It detects the distance between the measured object and the sensor, and uploads the value via wireless to LoRaWAN IoT Server.
32 -)))
33 33  
34 -(((
35 35  The LoRa wireless technology used in LLDS12 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
36 -)))
37 37  
38 -(((
39 39  LLDS12 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
40 -)))
41 41  
42 -(((
43 43  Each LLDS12 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
44 44  )))
45 -)))
46 46  
47 47  
48 48  [[image:1654826306458-414.png]]
... ... @@ -63,9 +63,6 @@
63 63  * Downlink to change configure
64 64  * 8500mAh Battery for long term use
65 65  
66 -
67 -
68 -
69 69  == 1.3  Probe Specification ==
70 70  
71 71  * Storage temperature :-20℃~~75℃
... ... @@ -81,9 +81,6 @@
81 81  * Material of enclosure - ABS+PC
82 82  * Wire length - 25cm
83 83  
84 -
85 -
86 -
87 87  == 1.4  Probe Dimension ==
88 88  
89 89  
... ... @@ -90,6 +90,7 @@
90 90  [[image:1654827224480-952.png]]
91 91  
92 92  
73 +
93 93  == 1.5 ​ Applications ==
94 94  
95 95  * Horizontal distance measurement
... ... @@ -106,6 +106,8 @@
106 106  [[image:1654827332142-133.png]]
107 107  
108 108  
90 +
91 +
109 109  = 2.  Configure LLDS12 to connect to LoRaWAN network =
110 110  
111 111  == 2.1  How it works ==
... ... @@ -115,7 +115,7 @@
115 115  )))
116 116  
117 117  (((
118 -In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H6.A0UseATCommand"]]to set the keys in the LLDS12.
101 +In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H6.UseATCommand"]]to set the keys in the LLDS12.
119 119  )))
120 120  
121 121  
... ... @@ -206,12 +206,14 @@
206 206  |=(% style="width: 62.5px;" %)(((
207 207  **Size (bytes)**
208 208  )))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
209 -|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:62.5px" %)(((
210 -[[Temperature DS18B20>>||anchor="H2.3.2A0DS18B20Temperaturesensor"]]
211 -)))|[[Distance>>||anchor="H2.3.3A0Distance"]]|[[Distance signal strength>>||anchor="H2.3.4A0Distancesignalstrength"]]|(((
212 -[[Interrupt flag>>||anchor="H2.3.5A0InterruptPin"]]
213 -)))|[[LiDAR temp>>||anchor="H2.3.6A0LiDARtemp"]]|(((
214 -[[Message Type>>||anchor="H2.3.7A0MessageType"]]
192 +|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
193 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
194 +
195 +[[DS18B20>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
196 +)))|[[Distance>>||anchor="H"]]|[[Distance signal strength>>||anchor="H2.3.4SoilTemperature"]]|(((
197 +[[Interrupt flag>>||anchor="H2.3.5InterruptPin"]]
198 +)))|[[LiDAR temp>>||anchor="H"]]|(((
199 +[[Message Type>>||anchor="H2.3.6MessageType"]]
215 215  )))
216 216  
217 217  [[image:1654833689380-972.png]]
... ... @@ -253,24 +253,23 @@
253 253  
254 254  
255 255  
256 -=== 2.3.4  Distance signal strength ===
241 +=== 2.3.4 Soil Temperature ===
257 257  
258 -Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible.
243 +Get Soil Temperature 
259 259  
260 260  
261 261  **Example**:
262 262  
263 -If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
248 +If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
264 264  
265 -Customers can judge whether they need to adjust the environment based on the signal strength.
250 +If payload is: **FF3FH** (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
266 266  
267 267  
268 268  
269 -=== 2.3.5  Interrupt Pin ===
254 +=== 2.3.5 Interrupt Pin ===
270 270  
271 -This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H4.2A0SetInterruptMode"]] for the hardware and software set up.
256 +This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up.
272 272  
273 -Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.6A0Pinmappingandpoweron"]].
274 274  
275 275  **Example:**
276 276  
... ... @@ -280,18 +280,8 @@
280 280  
281 281  
282 282  
283 -=== 2.3.6  LiDAR temp ===
267 +=== 2.3.6 Message Type ===
284 284  
285 -Characterize the internal temperature value of the sensor.
286 -
287 -**Example: **
288 -If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
289 -If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
290 -
291 -
292 -
293 -=== 2.3.7  Message Type ===
294 -
295 295  (((
296 296  For a normal uplink payload, the message type is always 0x01.
297 297  )))
... ... @@ -303,10 +303,11 @@
303 303  
304 304  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
305 305  |=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload**
306 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3A0200BUplinkPayload"]]
307 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H4.3A0GetFirmwareVersionInfo"]]
280 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
281 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
282 +|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
308 308  
309 -=== 2.3. Decode payload in The Things Network ===
284 +=== 2.3.7 Decode payload in The Things Network ===
310 310  
311 311  While using TTN network, you can add the payload format to decode the payload.
312 312  
... ... @@ -318,7 +318,7 @@
318 318  )))
319 319  
320 320  (((
321 -LLDS12 TTN Payload Decoder: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LLDS12/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LLDS12/Decoder/]]
296 +LSPH01 TTN Payload Decoder: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]]
322 322  )))
323 323  
324 324  
... ... @@ -474,7 +474,7 @@
474 474  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
475 475  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
476 476  
477 -=== 2.6.3  CN470-510 (CN470) ===
452 +=== 2.6.3 CN470-510 (CN470) ===
478 478  
479 479  (((
480 480  Used in China, Default use CHE=1
... ... @@ -563,7 +563,7 @@
563 563  
564 564  
565 565  
566 -=== 2.6.4  AU915-928(AU915) ===
541 +=== 2.6.4 AU915-928(AU915) ===
567 567  
568 568  (((
569 569  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
... ... @@ -584,7 +584,7 @@
584 584  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
585 585  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
586 586  
587 -=== 2.6.5  AS920-923 & AS923-925 (AS923) ===
562 +=== 2.6.5 AS920-923 & AS923-925 (AS923) ===
588 588  
589 589  (((
590 590  (% style="color:blue" %)**Default Uplink channel:**
... ... @@ -693,7 +693,7 @@
693 693  
694 694  
695 695  
696 -=== 2.6.6  KR920-923 (KR920) ===
671 +=== 2.6.6 KR920-923 (KR920) ===
697 697  
698 698  (((
699 699  (% style="color:blue" %)**Default channel:**
... ... @@ -766,7 +766,7 @@
766 766  
767 767  
768 768  
769 -=== 2.6.7  IN865-867 (IN865) ===
744 +=== 2.6.7 IN865-867 (IN865) ===
770 770  
771 771  (((
772 772  (% style="color:blue" %)**Uplink:**
... ... @@ -816,7 +816,7 @@
816 816  **Firmware download link: **[[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LLDS12/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LLDS12/Firmware/]]
817 817  
818 818  
819 -**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
794 +**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
820 820  
821 821  
822 822  
... ... @@ -837,37 +837,25 @@
837 837  [[image:1654831774373-275.png]]
838 838  
839 839  
840 -(((
841 -(% style="color:blue" %)**① **(%%)Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.
842 -)))
815 +①Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.
843 843  
844 -(((
845 -(% style="color:blue" %)**② **(%%)Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.
846 -)))
817 +②Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.
847 847  
848 -(((
849 -(% style="color:blue" %)**③ **(%%)Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.
850 -)))
819 +③Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.
851 851  
852 852  
853 -(((
854 854  Vertical Coordinates: Represents the radius of light spot for The LiDAR probe at the different distances. The diameter of light spot depends on the FOV of The LiDAR probe (the term of FOV generally refers to the smaller value between the receiving angle and the transmitting angle), which is calculated as follows:
855 -)))
856 856  
857 857  
858 858  [[image:1654831797521-720.png]]
859 859  
860 860  
861 -(((
862 862  In the formula above, d is the diameter of light spot; D is detecting range; β is the value of the receiving angle of The LiDAR probe, 3.6°. Correspondence between the diameter of light spot and detecting range is given in Table below.
863 -)))
864 864  
865 865  [[image:1654831810009-716.png]]
866 866  
867 867  
868 -(((
869 869  If the light spot reaches two objects with different distances, as shown in Figure 3, the output distance value will be a value between the actual distance values of the two objects. For a high accuracy requirement in practice, the above situation should be noticed to avoid the measurement error.
870 -)))
871 871  
872 872  
873 873  
... ... @@ -883,78 +883,52 @@
883 883  = 4.  Configure LLDS12 via AT Command or LoRaWAN Downlink =
884 884  
885 885  (((
886 -(((
887 887  Use can configure LLDS12 via AT Command or LoRaWAN Downlink.
888 888  )))
889 -)))
890 890  
891 891  * (((
892 -(((
893 -AT Command Connection: See [[FAQ>>||anchor="H7.A0FAQ"]].
853 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
894 894  )))
895 -)))
896 896  * (((
897 -(((
898 -LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
856 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
899 899  )))
900 -)))
901 901  
902 902  (((
903 -(((
904 904  
905 -)))
906 906  
907 -(((
908 908  There are two kinds of commands to configure LLDS12, they are:
909 909  )))
910 -)))
911 911  
912 912  * (((
913 -(((
914 914  (% style="color:#4f81bd" %)** General Commands**.
915 915  )))
916 -)))
917 917  
918 918  (((
919 -(((
920 920  These commands are to configure:
921 921  )))
922 -)))
923 923  
924 924  * (((
925 -(((
926 926  General system settings like: uplink interval.
927 927  )))
928 -)))
929 929  * (((
930 -(((
931 931  LoRaWAN protocol & radio related command.
932 932  )))
933 -)))
934 934  
935 935  (((
936 -(((
937 -They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
881 +They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
938 938  )))
939 -)))
940 940  
941 941  (((
942 -(((
943 943  
944 944  )))
945 -)))
946 946  
947 947  * (((
948 -(((
949 949  (% style="color:#4f81bd" %)** Commands special design for LLDS12**
950 950  )))
951 -)))
952 952  
953 953  (((
954 -(((
955 955  These commands only valid for LLDS12, as below:
956 956  )))
957 -)))
958 958  
959 959  
960 960  
... ... @@ -967,6 +967,7 @@
967 967  [[image:image-20220607171554-8.png]]
968 968  
969 969  
907 +
970 970  (((
971 971  (% style="color:#037691" %)**Downlink Command: 0x01**
972 972  )))
... ... @@ -989,7 +989,6 @@
989 989  
990 990  )))
991 991  
992 -
993 993  == 4.2  Set Interrupt Mode ==
994 994  
995 995  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -999,6 +999,8 @@
999 999  [[image:image-20220610105806-2.png]]
1000 1000  
1001 1001  
939 +
940 +
1002 1002  (((
1003 1003  (% style="color:#037691" %)**Downlink Command: 0x06**
1004 1004  )))
... ... @@ -1018,7 +1018,6 @@
1018 1018  Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1019 1019  )))
1020 1020  
1021 -
1022 1022  == 4.3  Get Firmware Version Info ==
1023 1023  
1024 1024  Feature: use downlink to get firmware version.
... ... @@ -1047,7 +1047,7 @@
1047 1047  
1048 1048  Version
1049 1049  )))|Sensor Type|Reserve|(((
1050 -[[Message Type>>||anchor="H2.3.7A0MessageType"]]
988 +[[Message Type>>||anchor="H2.3.6MessageType"]]
1051 1051  Always 0x02
1052 1052  )))
1053 1053  
... ... @@ -1215,19 +1215,13 @@
1215 1215  
1216 1216  
1217 1217  (((
1218 -(((
1219 -In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LLDS12.
1156 +In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1220 1220  )))
1221 1221  
1222 -(((
1223 -LLDS12 will output system info once power on as below:
1224 -)))
1225 -)))
1226 1226  
1227 -
1228 1228   [[image:1654593712276-618.png]]
1229 1229  
1230 -Valid AT Command please check [[Configure Device>>||anchor="H4.A0ConfigureLLDS12viaATCommandorLoRaWANDownlink"]].
1162 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1231 1231  
1232 1232  
1233 1233  = 7.  FAQ =
... ... @@ -1234,7 +1234,7 @@
1234 1234  
1235 1235  == 7.1  How to change the LoRa Frequency Bands/Region ==
1236 1236  
1237 -You can follow the instructions for [[how to upgrade image>>||anchor="H2.8A0200BFirmwareChangeLog"]].
1169 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1238 1238  When downloading the images, choose the required image file for download. ​
1239 1239  
1240 1240  
... ... @@ -1243,9 +1243,7 @@
1243 1243  == 8.1  AT Commands input doesn’t work ==
1244 1244  
1245 1245  
1246 -(((
1247 1247  In the case if user can see the console output but can’t type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn’t send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
1248 -)))
1249 1249  
1250 1250  
1251 1251  == 8.2  Significant error between the output distant value of LiDAR and actual distance ==