Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 124.4
edited by Xiaoling
on 2023/11/28 15:18
Change comment: There is no comment for this version
To version 120.1
edited by Xiaoling
on 2023/11/28 14:29
Change comment: Uploaded new attachment "1701152946067-561.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -47,8 +47,6 @@
47 47  * Firmware upgradable via program port or LoRa protocol
48 48  * Built-in 2400mAh battery or power by external power source
49 49  
50 -
51 -
52 52  == 1.3 Specification ==
53 53  
54 54  
... ... @@ -62,8 +62,6 @@
62 62  * ToF FoV: ±9°, Total 18°
63 63  * Light source: VCSEL
64 64  
65 -
66 -
67 67  == 1.4 Power Consumption ==
68 68  
69 69  
... ... @@ -77,8 +77,6 @@
77 77  * Idle: 21 mA @ 3.3v
78 78  * Max : 360 mA
79 79  
80 -
81 -
82 82  = 2. Configure DS20L to connect to LoRaWAN network =
83 83  
84 84  == 2.1 How it works ==
... ... @@ -212,121 +212,138 @@
212 212  === 2.3.2 Uplink Payload, FPORT~=2 ===
213 213  
214 214  
215 -==== (% style="color:red" %)**MOD~=1**(%%) ====
209 +(((
210 +DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will:
216 216  
217 -Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts.
212 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
218 218  
219 -Uplink Payload totals 10 bytes.
214 +Uplink Payload totals 11 bytes.
215 +)))
220 220  
221 221  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
222 -|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4**
223 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count
218 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
219 +**Size(bytes)**
220 +)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% 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: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**
221 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)(((
222 +[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]]
223 +)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)(((
224 +[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]
225 +)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((
226 +[[Message Type>>||anchor="HMessageType"]]
227 +)))
224 224  
225 -[[image:1701155076393-719.png]]
229 +[[image:image-20230805104104-2.png||height="136" width="754"]]
226 226  
227 -(% style="color:blue" %)**Battery Info:**
228 228  
229 -Check the battery voltage for DS20L
232 +==== (% style="color:blue" %)**Battery Info**(%%) ====
230 230  
231 -Ex1: 0x0E10 = 3600mV
232 232  
235 +Check the battery voltage for DS20L.
233 233  
234 -(% style="color:blue" %)**MOD & Alarm & Interrupt:**
237 +Ex1: 0x0B45 = 2885mV
235 235  
236 -(% style="color:red" %)**MOD:**
239 +Ex2: 0x0B49 = 2889mV
237 237  
238 -**Example: ** (0x60>>6) & 0x3f =1
239 239  
240 -**0x01:**  Regularly detect distance and report.
241 -**0x02: ** Uninterrupted measurement (external power supply).
242 +==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ====
242 242  
243 -(% style="color:red" %)**Alarm:**
244 244  
245 -When the detection distance exceeds the limit, the alarm flag is set to 1.
245 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
246 246  
247 -(% style="color:red" %)**Interrupt:**
248 248  
249 -Whether it is an external interrupt.
248 +**Example**:
250 250  
250 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
251 251  
252 -(% style="color:blue" %)**Distance info:**
252 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
253 253  
254 +
255 +==== (% style="color:blue" %)**Distance**(%%) ====
256 +
257 +
258 +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.
259 +
260 +
254 254  **Example**:
255 255  
256 -If payload is: 0708H: distance = 0708H = 1800 mm
263 +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.
257 257  
258 258  
259 -(% style="color:blue" %)**Sensor State:**
266 +==== (% style="color:blue" %)**Distance signal strength**(%%) ====
260 260  
261 -Ex1: 0x00: Normal collection distance
262 262  
263 -Ex2 0x0x: Distance collection is wrong
269 +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.
264 264  
265 265  
266 -(% style="color:blue" %)**Interript Count:**
272 +**Example**:
267 267  
268 -If payload is:000007D0H: count = 07D0H =2000
274 +If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
269 269  
276 +Customers can judge whether they need to adjust the environment based on the signal strength.
270 270  
271 271  
272 -==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
279 +**1) When the sensor detects valid data:**
273 273  
274 -Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes.
281 +[[image:image-20230805155335-1.png||height="145" width="724"]]
275 275  
276 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
277 -|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
278 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
279 279  
280 -[[image:1701155150328-206.png]]
284 +**2) When the sensor detects invalid data:**
281 281  
282 -(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
286 +[[image:image-20230805155428-2.png||height="139" width="726"]]
283 283  
284 -(% style="color:red" %)**MOD:**
285 285  
286 -**Example: ** (0x60>>6) & 0x3f =1
289 +**3) When the sensor is not connected:**
287 287  
288 -**0x01:**  Regularly detect distance and report.
289 -**0x02: ** Uninterrupted measurement (external power supply).
291 +[[image:image-20230805155515-3.png||height="143" width="725"]]
290 290  
291 -(% style="color:red" %)**Alarm:**
292 292  
293 -When the detection distance exceeds the limit, the alarm flag is set to 1.
294 +==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
294 294  
295 -(% style="color:red" %)**Do:**
296 296  
297 -When the distance exceeds the set threshold, pull the Do pin high.
297 +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.
298 298  
299 -(% style="color:red" %)**Limit flag:**
299 +Note: The Internet Pin is a separate pin in the screw terminal. See pin mapping of GPIO_EXTI .
300 300  
301 -Mode for setting threshold: 0~~5
301 +**Example:**
302 302  
303 -0: does not use upper and lower limits
303 +If byte[0]&0x01=0x00 : Normal uplink packet.
304 304  
305 -1: Use upper and lower limits
305 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
306 306  
307 -2: is less than the lower limit value
308 308  
309 -3: is greater than the lower limit value
308 +==== (% style="color:blue" %)**LiDAR temp**(%%) ====
310 310  
311 -4: is less than the upper limit
312 312  
313 -5: is greater than the upper limit
311 +Characterize the internal temperature value of the sensor.
314 314  
313 +**Example: **
314 +If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
315 +If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
315 315  
316 -(% style="color:blue" %)**Upper limit:**
317 317  
318 -The upper limit of the threshold cannot exceed 2000mm.
318 +==== (% style="color:blue" %)**Message Type**(%%) ====
319 319  
320 320  
321 -(% style="color:blue" %)**Lower limit:**
321 +(((
322 +For a normal uplink payload, the message type is always 0x01.
323 +)))
322 322  
323 -The lower limit of the threshold cannot be less than 3mm.
325 +(((
326 +Valid Message Type:
327 +)))
324 324  
329 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
330 +|=(% 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**
331 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
332 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
325 325  
334 +[[image:image-20230805150315-4.png||height="233" width="723"]]
335 +
336 +
326 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.
340 +DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
330 330  
331 331  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
332 332  
... ... @@ -454,7 +454,7 @@
454 454  
455 455  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
456 456  
457 -[[image:1701152946067-561.png]]
468 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]
458 458  
459 459  
460 460  == 2.5 Frequency Plans ==
... ... @@ -538,9 +538,6 @@
538 538  )))
539 539  * (((
540 540  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
541 -
542 -
543 -
544 544  )))
545 545  
546 546  === 3.3.2 Set Interrupt Mode ===
... ... @@ -581,6 +581,7 @@
581 581  
582 582  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
583 583  
592 +
584 584  == 3.3.3 Set work mode ==
585 585  
586 586  
... ... @@ -619,6 +619,8 @@
619 619  )))
620 620  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
621 621  
631 +
632 +
622 622  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
623 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
624 624  |(% style="width:251px" %)1: Use upper and lower limits
... ... @@ -644,16 +644,8 @@
644 644  
645 645  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
646 646  
647 -* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
648 648  
649 -* Example 3: Downlink Payload: 0703200000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
650 650  
651 -* Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
652 -
653 -* Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
654 -
655 -
656 -
657 657  = 4. Battery & Power Consumption =
658 658  
659 659  
... ... @@ -690,33 +690,6 @@
690 690  DS20L use the same frequency as other Dragino products. User can see the detail from this link:  [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]]
691 691  
692 692  
693 -== 6.2 DS20L programming line ==
694 -
695 -
696 -缺图 后续补上
697 -
698 -feature:
699 -
700 -for AT commands
701 -
702 -Update the firmware of DS20L
703 -
704 -Support interrupt mode
705 -
706 -
707 -== 6.3 LiDAR probe position ==
708 -
709 -
710 -[[image:1701155390576-216.png||height="285" width="307"]]
711 -
712 -The black oval hole in the picture is the LiDAR probe.
713 -
714 -
715 -== 6.4 Interface definition ==
716 -
717 -[[image:image-20231128151132-2.png||height="305" width="557"]]
718 -
719 -
720 720  = 7. Trouble Shooting =
721 721  
722 722  == 7.1 AT Command input doesn't work ==
1701155076393-719.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -54.6 KB
Content
1701155150328-206.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -54.6 KB
Content
1701155390576-216.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -293.9 KB
Content
image-20231128151132-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -281.2 KB
Content