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

From version 115.2
edited by Xiaoling
on 2022/06/10 15:13
Change comment: There is no comment for this version
To version 109.1
edited by Xiaoling
on 2022/06/10 12:01
Change comment: Uploaded new attachment "1654833689380-972.png", version {1}

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]]
... ... @@ -88,6 +88,7 @@
88 88  [[image:1654827224480-952.png]]
89 89  
90 90  
77 +
91 91  == 1.5 ​ Applications ==
92 92  
93 93  * Horizontal distance measurement
... ... @@ -106,6 +106,8 @@
106 106  [[image:1654827332142-133.png]]
107 107  
108 108  
96 +
97 +
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.
107 +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  
... ... @@ -191,7 +191,7 @@
191 191  == 2.3  ​Uplink Payload ==
192 192  
193 193  (((
194 -LLDS12 will uplink payload via LoRaWAN with below payload format: 
183 +LSPH01 will uplink payload via LoRaWAN with below payload format: 
195 195  )))
196 196  
197 197  (((
... ... @@ -199,7 +199,7 @@
199 199  )))
200 200  
201 201  (((
202 -
191 +Normal uplink payload:
203 203  )))
204 204  
205 205  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
... ... @@ -206,22 +206,24 @@
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"]]
198 +|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
199 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
200 +
201 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
202 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
203 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
204 +)))|Reserve|(((
205 +[[Message Type>>||anchor="H2.3.6MessageType"]]
215 215  )))
216 216  
217 -[[image:1654833689380-972.png]]
208 +[[image:1654592721645-318.png]]
218 218  
219 219  
220 220  
221 -=== 2.3.1  Battery Info ===
212 +=== 2.3.1 Battery Info ===
222 222  
223 223  
224 -Check the battery voltage for LLDS12.
215 +Check the battery voltage for LSPH01.
225 225  
226 226  Ex1: 0x0B45 = 2885mV
227 227  
... ... @@ -229,7 +229,7 @@
229 229  
230 230  
231 231  
232 -=== 2.3.2  DS18B20 Temperature sensor ===
223 +=== 2.3.2 DS18B20 Temperature sensor ===
233 233  
234 234  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
235 235  
... ... @@ -242,35 +242,33 @@
242 242  
243 243  
244 244  
245 -=== 2.3.3  Distance ===
236 +=== 2.3.3 Soil pH ===
246 246  
247 -Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength.
238 +Range: 0 ~~ 14 pH
248 248  
240 +**Example:**
249 249  
250 -**Example**:
242 +(% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
251 251  
252 -If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm.
253 253  
254 254  
246 +=== 2.3.4 Soil Temperature ===
255 255  
256 -=== 2.3.4  Distance signal strength ===
248 +Get 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.
259 259  
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.
253 +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.
255 +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 ===
259 +=== 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.
261 +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 ===
272 +=== 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,13 +303,12 @@
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"]]
285 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
286 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
287 +|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
308 308  
289 +=== 2.3.7 Decode payload in The Things Network ===
309 309  
310 -
311 -=== 2.3.8  Decode payload in The Things Network ===
312 -
313 313  While using TTN network, you can add the payload format to decode the payload.
314 314  
315 315  
... ... @@ -320,7 +320,7 @@
320 320  )))
321 321  
322 322  (((
323 -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/]]
301 +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/]]
324 324  )))
325 325  
326 326  
... ... @@ -476,10 +476,8 @@
476 476  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
477 477  * 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)
478 478  
457 +=== 2.6.3 CN470-510 (CN470) ===
479 479  
480 -
481 -=== 2.6.3  CN470-510 (CN470) ===
482 -
483 483  (((
484 484  Used in China, Default use CHE=1
485 485  )))
... ... @@ -567,7 +567,7 @@
567 567  
568 568  
569 569  
570 -=== 2.6.4  AU915-928(AU915) ===
546 +=== 2.6.4 AU915-928(AU915) ===
571 571  
572 572  (((
573 573  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
... ... @@ -588,10 +588,8 @@
588 588  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
589 589  * 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)
590 590  
567 +=== 2.6.5 AS920-923 & AS923-925 (AS923) ===
591 591  
592 -
593 -=== 2.6.5  AS920-923 & AS923-925 (AS923) ===
594 -
595 595  (((
596 596  (% style="color:blue" %)**Default Uplink channel:**
597 597  )))
... ... @@ -699,7 +699,7 @@
699 699  
700 700  
701 701  
702 -=== 2.6.6  KR920-923 (KR920) ===
676 +=== 2.6.6 KR920-923 (KR920) ===
703 703  
704 704  (((
705 705  (% style="color:blue" %)**Default channel:**
... ... @@ -772,7 +772,7 @@
772 772  
773 773  
774 774  
775 -=== 2.6.7  IN865-867 (IN865) ===
749 +=== 2.6.7 IN865-867 (IN865) ===
776 776  
777 777  (((
778 778  (% style="color:blue" %)**Uplink:**
... ... @@ -817,7 +817,6 @@
817 817  * Blink once when device transmit a packet.
818 818  
819 819  
820 -
821 821  == 2.8  ​Firmware Change Log ==
822 822  
823 823  
... ... @@ -824,7 +824,7 @@
824 824  **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/]]
825 825  
826 826  
827 -**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
800 +**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
828 828  
829 829  
830 830  
... ... @@ -845,37 +845,25 @@
845 845  [[image:1654831774373-275.png]]
846 846  
847 847  
848 -(((
849 -(% style="color:blue" %)**① **(%%)Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.
850 -)))
821 +①Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.
851 851  
852 -(((
853 -(% style="color:blue" %)**② **(%%)Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.
854 -)))
823 +②Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.
855 855  
856 -(((
857 -(% style="color:blue" %)**③ **(%%)Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.
858 -)))
825 +③Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.
859 859  
860 860  
861 -(((
862 862  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:
863 -)))
864 864  
865 865  
866 866  [[image:1654831797521-720.png]]
867 867  
868 868  
869 -(((
870 870  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.
871 -)))
872 872  
873 873  [[image:1654831810009-716.png]]
874 874  
875 875  
876 -(((
877 877  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.
878 -)))
879 879  
880 880  
881 881  
... ... @@ -888,83 +888,55 @@
888 888  * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.
889 889  * The sensor window is made by Acrylic. Don’t touch it with alcohol material. This will destroy the sensor window.
890 890  
891 -
892 -
893 893  = 4.  Configure LLDS12 via AT Command or LoRaWAN Downlink =
894 894  
895 895  (((
896 -(((
897 897  Use can configure LLDS12 via AT Command or LoRaWAN Downlink.
898 898  )))
899 -)))
900 900  
901 901  * (((
902 -(((
903 -AT Command Connection: See [[FAQ>>||anchor="H7.A0FAQ"]].
859 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
904 904  )))
905 -)))
906 906  * (((
907 -(((
908 -LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
862 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
909 909  )))
910 -)))
911 911  
912 912  (((
913 -(((
914 914  
915 -)))
916 916  
917 -(((
918 918  There are two kinds of commands to configure LLDS12, they are:
919 919  )))
920 -)))
921 921  
922 922  * (((
923 -(((
924 924  (% style="color:#4f81bd" %)** General Commands**.
925 925  )))
926 -)))
927 927  
928 928  (((
929 -(((
930 930  These commands are to configure:
931 931  )))
932 -)))
933 933  
934 934  * (((
935 -(((
936 936  General system settings like: uplink interval.
937 937  )))
938 -)))
939 939  * (((
940 -(((
941 941  LoRaWAN protocol & radio related command.
942 942  )))
943 -)))
944 944  
945 945  (((
946 -(((
947 -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]]
887 +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/]]
948 948  )))
949 -)))
950 950  
951 951  (((
952 -(((
953 953  
954 954  )))
955 -)))
956 956  
957 957  * (((
958 -(((
959 959  (% style="color:#4f81bd" %)** Commands special design for LLDS12**
960 960  )))
961 -)))
962 962  
963 963  (((
964 -(((
965 965  These commands only valid for LLDS12, as below:
966 966  )))
967 -)))
968 968  
969 969  
970 970  
... ... @@ -977,6 +977,7 @@
977 977  [[image:image-20220607171554-8.png]]
978 978  
979 979  
913 +
980 980  (((
981 981  (% style="color:#037691" %)**Downlink Command: 0x01**
982 982  )))
... ... @@ -994,9 +994,10 @@
994 994  )))
995 995  * (((
996 996  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
997 -)))
998 998  
999 999  
933 +
934 +)))
1000 1000  
1001 1001  == 4.2  Set Interrupt Mode ==
1002 1002  
... ... @@ -1007,6 +1007,8 @@
1007 1007  [[image:image-20220610105806-2.png]]
1008 1008  
1009 1009  
945 +
946 +
1010 1010  (((
1011 1011  (% style="color:#037691" %)**Downlink Command: 0x06**
1012 1012  )))
... ... @@ -1026,8 +1026,6 @@
1026 1026  Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1027 1027  )))
1028 1028  
1029 -
1030 -
1031 1031  == 4.3  Get Firmware Version Info ==
1032 1032  
1033 1033  Feature: use downlink to get firmware version.
... ... @@ -1056,7 +1056,7 @@
1056 1056  
1057 1057  Version
1058 1058  )))|Sensor Type|Reserve|(((
1059 -[[Message Type>>||anchor="H2.3.7A0MessageType"]]
994 +[[Message Type>>||anchor="H2.3.6MessageType"]]
1060 1060  Always 0x02
1061 1061  )))
1062 1062  
... ... @@ -1224,19 +1224,13 @@
1224 1224  
1225 1225  
1226 1226  (((
1227 -(((
1228 -In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LLDS12.
1162 +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:
1229 1229  )))
1230 1230  
1231 -(((
1232 -LLDS12 will output system info once power on as below:
1233 -)))
1234 -)))
1235 1235  
1236 -
1237 1237   [[image:1654593712276-618.png]]
1238 1238  
1239 -Valid AT Command please check [[Configure Device>>||anchor="H4.A0ConfigureLLDS12viaATCommandorLoRaWANDownlink"]].
1168 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1240 1240  
1241 1241  
1242 1242  = 7.  FAQ =
... ... @@ -1243,7 +1243,7 @@
1243 1243  
1244 1244  == 7.1  How to change the LoRa Frequency Bands/Region ==
1245 1245  
1246 -You can follow the instructions for [[how to upgrade image>>||anchor="H2.8A0200BFirmwareChangeLog"]].
1175 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1247 1247  When downloading the images, choose the required image file for download. ​
1248 1248  
1249 1249  
... ... @@ -1252,9 +1252,7 @@
1252 1252  == 8.1  AT Commands input doesn’t work ==
1253 1253  
1254 1254  
1255 -(((
1256 1256  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.
1257 -)))
1258 1258  
1259 1259  
1260 1260  == 8.2  Significant error between the output distant value of LiDAR and actual distance ==
... ... @@ -1299,8 +1299,6 @@
1299 1299  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1300 1300  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1301 1301  
1302 -
1303 -
1304 1304  = 10. ​ Packing Info =
1305 1305  
1306 1306  
... ... @@ -1315,9 +1315,9 @@
1315 1315  * Package Size / pcs : cm
1316 1316  * Weight / pcs : g
1317 1317  
1318 -
1319 -
1320 1320  = 11.  ​Support =
1321 1321  
1322 1322  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1323 1323  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]].
1247 +
1248 +