Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 120.6
edited by Xiaoling
on 2023/11/28 14:53
Change comment: There is no comment for this version
To version 125.4
edited by Xiaoling
on 2023/11/29 09:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -206,107 +206,91 @@
206 206  === 2.3.2 Uplink Payload, FPORT~=2 ===
207 207  
208 208  
209 -(((
210 -DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will:
209 +==== (% style="color:red" %)**MOD~=1**(%%) ====
211 211  
212 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
213 -
214 -Uplink Payload totals 11 bytes.
215 -)))
216 -
217 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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 -)))
228 -
229 -==== **MOD~=1** ====
230 -
231 231  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.
232 232  
233 233  Uplink Payload totals 10 bytes.
234 234  
235 -(% border="1" cellspacing="4" style="width:510px;background-color:#f2f2f2" %)
236 -|(% style="width:60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:30px;background-color:#4F81BD;color:white" %)**2**|(% style="width:130px;background-color:#4F81BD;color:white" %)**1**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**|(% style="width:100px;background-color:#4F81BD;color:white" %)**1**|(% style="width:120px;background-color:#4F81BD;color:white" %)**4**
237 -|(% style="width:91px" %)Value|(% style="width:41px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count
215 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
216 +|(% 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**
217 +|(% 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
238 238  
219 +[[image:1701155076393-719.png]]
239 239  
240 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
221 +(% style="color:blue" %)**Battery Info:**
241 241  
242 -==== **Battery Info** ====
243 -
244 244  Check the battery voltage for DS20L
245 245  
246 246  Ex1: 0x0E10 = 3600mV
247 247  
248 -**MOD & Alarm & Interrupt**
249 249  
250 -**MOD:**
228 +(% style="color:blue" %)**MOD & Alarm & Interrupt:**
251 251  
230 +(% style="color:red" %)**MOD:**
231 +
252 252  **Example: ** (0x60>>6) & 0x3f =1
253 253  
254 254  **0x01:**  Regularly detect distance and report.
255 255  **0x02: ** Uninterrupted measurement (external power supply).
256 256  
257 -**Alarm:**
237 +(% style="color:red" %)**Alarm:**
258 258  
259 259  When the detection distance exceeds the limit, the alarm flag is set to 1.
260 260  
261 -**Interrupt:**
241 +(% style="color:red" %)**Interrupt:**
262 262  
263 263  Whether it is an external interrupt.
264 264  
265 -==== Distance** info** ====
266 266  
246 +(% style="color:blue" %)**Distance info:**
247 +
267 267  **Example**:
268 268  
269 269  If payload is: 0708H: distance = 0708H = 1800 mm
270 270  
271 -==== **Sensor State** ====
272 272  
253 +(% style="color:blue" %)**Sensor State:**
254 +
273 273  Ex1: 0x00: Normal collection distance
274 274  
275 275  Ex2 0x0x: Distance collection is wrong
276 276  
277 -==== **Interript Count** ====
278 278  
260 +(% style="color:blue" %)**Interript Count:**
261 +
279 279  If payload is:000007D0H: count = 07D0H =2000
280 280  
281 -**MOD=2**
282 282  
283 -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.
284 284  
285 -(% border="1" cellspacing="4" style="width:510px;background-color:#f2f2f2" %)
286 -|(% style="width:60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:30px;background-color:#4F81BD;color:white" %)**2**|(% style="width:120px;background-color:#4F81BD;color:white" %)**1**|(% style="width:120px;background-color:#4F81BD;color:white" %)**4**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**
287 -|(% style="width:91px" %)Value|(% style="width:41px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% 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
266 +==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
288 288  
268 +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.
289 289  
290 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
270 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
271 +|(% 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**
272 +|(% 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
291 291  
292 -**MOD & Alarm & Do & Limit** **flag**
274 +[[image:1701155150328-206.png]]
293 293  
294 -**MOD:**
276 +(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
295 295  
278 +(% style="color:red" %)**MOD:**
279 +
296 296  **Example: ** (0x60>>6) & 0x3f =1
297 297  
298 298  **0x01:**  Regularly detect distance and report.
299 299  **0x02: ** Uninterrupted measurement (external power supply).
300 300  
301 -**Alarm:**
285 +(% style="color:red" %)**Alarm:**
302 302  
303 303  When the detection distance exceeds the limit, the alarm flag is set to 1.
304 304  
305 -**Do:**
289 +(% style="color:red" %)**Do:**
306 306  
307 307  When the distance exceeds the set threshold, pull the Do pin high.
308 308  
309 -**Limit** **flag:**
293 +(% style="color:red" %)**Limit flag:**
310 310  
311 311  Mode for setting threshold: 0~~5
312 312  
... ... @@ -322,100 +322,20 @@
322 322  
323 323  5: is greater than the upper limit
324 324  
325 -**Upper limit:**
326 326  
310 +(% style="color:blue" %)**Upper limit:**
311 +
327 327  The upper limit of the threshold cannot exceed 2000mm.
328 328  
329 -**Lower limit:**
330 330  
315 +(% style="color:blue" %)**Lower limit:**
316 +
331 331  The lower limit of the threshold cannot be less than 3mm.
332 332  
333 333  
334 -=== 2.3.3 Historical measuring distance, FPORT~=3 ===
320 +=== 2.3.3 Decode payload in The Things Network ===
335 335  
336 336  
337 -DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
338 -
339 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
340 -
341 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
342 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
343 -**Size(bytes)**
344 -)))|=(% 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
345 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
346 -Reserve(0xFF)
347 -)))|Distance|Distance signal strength|(% style="width:88px" %)(((
348 -LiDAR temp
349 -)))|(% style="width:85px" %)Unix TimeStamp
350 -
351 -**Interrupt flag & Interrupt level:**
352 -
353 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
354 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
355 -**Size(bit)**
356 -)))|=(% 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**
357 -|(% 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" %)(((
358 -Interrupt flag
359 -)))
360 -
361 -* (((
362 -Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands.
363 -)))
364 -
365 -For example, in the US915 band, the max payload for different DR is:
366 -
367 -**a) DR0:** max is 11 bytes so one entry of data
368 -
369 -**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
370 -
371 -**c) DR2:** total payload includes 11 entries of data
372 -
373 -**d) DR3:** total payload includes 22 entries of data.
374 -
375 -If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
376 -
377 -
378 -**Downlink:**
379 -
380 -0x31 64 CC 68 0C 64 CC 69 74 05
381 -
382 -[[image:image-20230805144936-2.png||height="113" width="746"]]
383 -
384 -**Uplink:**
385 -
386 -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
387 -
388 -
389 -**Parsed Value:**
390 -
391 -[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
392 -
393 -
394 -[360,176,30,High,True,2023-08-04 02:53:00],
395 -
396 -[355,168,30,Low,False,2023-08-04 02:53:29],
397 -
398 -[245,211,30,Low,False,2023-08-04 02:54:29],
399 -
400 -[57,700,30,Low,False,2023-08-04 02:55:29],
401 -
402 -[361,164,30,Low,True,2023-08-04 02:56:00],
403 -
404 -[337,184,30,Low,False,2023-08-04 02:56:40],
405 -
406 -[20,4458,30,Low,False,2023-08-04 02:57:40],
407 -
408 -[362,173,30,Low,False,2023-08-04 02:58:53],
409 -
410 -
411 -**History read from serial port：**
412 -
413 -[[image:image-20230805145056-3.png]]
414 -
415 -
416 -=== 2.3.4 Decode payload in The Things Network ===
417 -
418 -
419 419  While using TTN network, you can add the payload format to decode the payload.
420 420  
421 421  [[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"]]
... ... @@ -462,7 +462,7 @@
462 462  
463 463  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
464 464  
465 -[[image:1701152946067-561.png]]
369 +[[image:image-20231129085201-1.png||height="515" width="961"]]
466 466  
467 467  
468 468  == 2.5 Frequency Plans ==
... ... @@ -546,6 +546,9 @@
546 546  )))
547 547  * (((
548 548  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
453 +
454 +
455 +
549 549  )))
550 550  
551 551  === 3.3.2 Set Interrupt Mode ===
... ... @@ -586,10 +586,9 @@
586 586  
587 587  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
588 588  
496 +=== 3.3.3 Set work mode ===
589 589  
590 -== 3.3.3 Set work mode ==
591 591  
592 -
593 593  Feature: Switch working mode
594 594  
595 595  (% style="color:blue" %)**AT Command: AT+MOD**
... ... @@ -625,10 +625,21 @@
625 625  )))
626 626  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
627 627  
534 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
535 +|(% rowspan="11" style="color:blue; width:120px" %)(((
536 +
628 628  
629 629  
630 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
631 -|(% 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
539 +
540 +
541 +
542 +
543 +
544 +
545 +
546 +
547 +**AT+DOL=5,1800,0,0,400**
548 +)))|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits
632 632  |(% style="width:251px" %)1: Use upper and lower limits
633 633  |(% style="width:251px" %)2: Less than the lower limit
634 634  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -644,6 +644,11 @@
644 644  
645 645  )))
646 646  
564 +
565 +
566 +
567 +
568 +
647 647  (% style="color:blue" %)**Downlink Command: 0x07**
648 648  
649 649  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -652,8 +652,14 @@
652 652  
653 653  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
654 654  
577 +* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
655 655  
579 +* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
656 656  
581 +* Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
582 +
583 +* Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
584 +
657 657  = 4. Battery & Power Consumption =
658 658  
659 659  
... ... @@ -690,6 +690,33 @@
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  
621 +== 6.2 DS20L programming line ==
622 +
623 +
624 +缺图 后续补上
625 +
626 +feature:
627 +
628 +for AT commands
629 +
630 +Update the firmware of DS20L
631 +
632 +Support interrupt mode
633 +
634 +
635 +== 6.3 LiDAR probe position ==
636 +
637 +
638 +[[image:1701155390576-216.png||height="285" width="307"]]
639 +
640 +The black oval hole in the picture is the LiDAR probe.
641 +
642 +
643 +== 6.4 Interface definition ==
644 +
645 +[[image:image-20231128151132-2.png||height="305" width="557"]]
646 +
647 +
693 693  = 7. Trouble Shooting =
694 694  
695 695  == 7.1 AT Command input doesn't work ==
1701155076393-719.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +54.6 KB
Content
1701155150328-206.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +54.6 KB
Content
1701155390576-216.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +293.9 KB
Content
image-20231128151132-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +281.2 KB
Content
image-20231129085201-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.6 KB
Content