Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 91.1
edited by Saxer Lin
on 2023/08/05 10:39
Change comment: Uploaded new attachment "image-20230805103904-1.png", version {1}
To version 109.11
edited by Xiaoling
on 2023/08/07 09:45
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -163,8 +163,8 @@
163 163  
164 164  == 1.8 Pin Definitions ==
165 165  
166 -[[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"]]
167 167  
167 +[[image:image-20230805144259-1.png||height="413" width="741"]]
168 168  
169 169  == 1.9 Mechanical ==
170 170  
... ... @@ -261,6 +261,8 @@
261 261  
262 262  Example parse in TTNv3
263 263  
264 +[[image:image-20230805103904-1.png||height="131" width="711"]]
265 +
264 264  (% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
265 265  
266 266  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
... ... @@ -316,11 +316,11 @@
316 316  
317 317  
318 318  (((
319 -LDS12-LB will uplink payload via LoRaWAN with below payload format: 
320 -)))
321 +LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
321 321  
322 -(((
323 -Uplink payload includes in total 11 bytes.
323 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
324 +
325 +Uplink Payload totals 11 bytes.
324 324  )))
325 325  
326 326  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
... ... @@ -335,7 +335,7 @@
335 335  [[Message Type>>||anchor="HMessageType"]]
336 336  )))
337 337  
338 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654833689380-972.png?rev=1.1||alt="1654833689380-972.png"]]
340 +[[image:image-20230805104104-2.png||height="136" width="754"]]
339 339  
340 340  
341 341  ==== (% style="color:blue" %)**Battery Info**(%%) ====
... ... @@ -385,18 +385,33 @@
385 385  Customers can judge whether they need to adjust the environment based on the signal strength.
386 386  
387 387  
390 +**1) When the sensor detects valid data:**
391 +
392 +[[image:image-20230805155335-1.png||height="145" width="724"]]
393 +
394 +
395 +**2) When the sensor detects invalid data:**
396 +
397 +[[image:image-20230805155428-2.png||height="139" width="726"]]
398 +
399 +
400 +**3) When the sensor is not connected:**
401 +
402 +[[image:image-20230805155515-3.png||height="143" width="725"]]
403 +
404 +
388 388  ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
389 389  
390 390  
391 391  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.
392 392  
393 -Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]].
410 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
394 394  
395 395  **Example:**
396 396  
397 -0x00: Normal uplink packet.
414 +If byte[0]&0x01=0x00 : Normal uplink packet.
398 398  
399 -0x01: Interrupt Uplink Packet.
416 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
400 400  
401 401  
402 402  ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
... ... @@ -422,14 +422,97 @@
422 422  
423 423  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
424 424  |=(% 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**
425 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
426 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]]
442 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
443 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
427 427  
445 +[[image:image-20230805150315-4.png||height="233" width="723"]]
428 428  
429 429  
430 -=== 2.3.3 Decode payload in The Things Network ===
448 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
431 431  
432 432  
451 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
452 +
453 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
454 +
455 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
456 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
457 +**Size(bytes)**
458 +)))|=(% 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
459 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
460 +Reserve(0xFF)
461 +)))|Distance|Distance signal strength|(% style="width:88px" %)(((
462 +LiDAR temp
463 +)))|(% style="width:85px" %)Unix TimeStamp
464 +
465 +**Interrupt flag & Interrupt level:**
466 +
467 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
468 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
469 +**Size(bit)**
470 +)))|=(% 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**
471 +|(% 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" %)(((
472 +Interrupt flag
473 +)))
474 +
475 +* (((
476 +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.
477 +)))
478 +
479 +For example, in the US915 band, the max payload for different DR is:
480 +
481 +**a) DR0:** max is 11 bytes so one entry of data
482 +
483 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
484 +
485 +**c) DR2:** total payload includes 11 entries of data
486 +
487 +**d) DR3:** total payload includes 22 entries of data.
488 +
489 +If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
490 +
491 +
492 +**Downlink:**
493 +
494 +0x31 64 CC 68 0C 64 CC 69 74 05
495 +
496 +[[image:image-20230805144936-2.png||height="113" width="746"]]
497 +
498 +**Uplink:**
499 +
500 +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
501 +
502 +
503 +**Parsed Value:**
504 +
505 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
506 +
507 +
508 +[360,176,30,High,True,2023-08-04 02:53:00],
509 +
510 +[355,168,30,Low,False,2023-08-04 02:53:29],
511 +
512 +[245,211,30,Low,False,2023-08-04 02:54:29],
513 +
514 +[57,700,30,Low,False,2023-08-04 02:55:29],
515 +
516 +[361,164,30,Low,True,2023-08-04 02:56:00],
517 +
518 +[337,184,30,Low,False,2023-08-04 02:56:40],
519 +
520 +[20,4458,30,Low,False,2023-08-04 02:57:40],
521 +
522 +[362,173,30,Low,False,2023-08-04 02:58:53],
523 +
524 +
525 +**History read from serial port：**
526 +
527 +[[image:image-20230805145056-3.png]]
528 +
529 +
530 +=== 2.3.4 Decode payload in The Things Network ===
531 +
532 +
433 433  While using TTN network, you can add the payload format to decode the payload.
434 434  
435 435  [[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"]]
... ... @@ -444,15 +444,9 @@
444 444  )))
445 445  
446 446  
447 -== 2.4 Uplink Interval ==
547 +== 2.4 ​Show Data in DataCake IoT Server ==
448 448  
449 449  
450 -The LDS12-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>||anchor="H3.3.1SetTransmitIntervalTime"]]
451 -
452 -
453 -== 2.5 ​Show Data in DataCake IoT Server ==
454 -
455 -
456 456  (((
457 457  [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
458 458  )))
... ... @@ -485,13 +485,13 @@
485 485  [[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"]]
486 486  
487 487  
488 -== 2.6 Datalog Feature ==
582 +== 2.5 Datalog Feature ==
489 489  
490 490  
491 491  Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LDS12-LB will store the reading for future retrieving purposes.
492 492  
493 493  
494 -=== 2.6.1 Ways to get datalog via LoRaWAN ===
588 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
495 495  
496 496  
497 497  Set PNACKMD=1, LDS12-LB will wait for ACK for every uplink, when there is no LoRaWAN network,LDS12-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
... ... @@ -508,7 +508,7 @@
508 508  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
509 509  
510 510  
511 -=== 2.6.2 Unix TimeStamp ===
605 +=== 2.5.2 Unix TimeStamp ===
512 512  
513 513  
514 514  LDS12-LB uses Unix TimeStamp format based on
... ... @@ -525,7 +525,7 @@
525 525  So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
526 526  
527 527  
528 -=== 2.6.3 Set Device Time ===
622 +=== 2.5.3 Set Device Time ===
529 529  
530 530  
531 531  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
... ... @@ -535,7 +535,7 @@
535 535  (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
536 536  
537 537  
538 -=== 2.6.4 Poll sensor value ===
632 +=== 2.5.4 Poll sensor value ===
539 539  
540 540  
541 541  Users can poll sensor values based on timestamps. Below is the downlink command.
... ... @@ -562,7 +562,7 @@
562 562  )))
563 563  
564 564  
565 -== 2.7 Frequency Plans ==
659 +== 2.6 Frequency Plans ==
566 566  
567 567  
568 568  The LDS12-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
... ... @@ -570,9 +570,9 @@
570 570  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
571 571  
572 572  
573 -== 2.8 LiDAR ToF Measurement ==
667 +== 2.7 LiDAR ToF Measurement ==
574 574  
575 -=== 2.8.1 Principle of Distance Measurement ===
669 +=== 2.7.1 Principle of Distance Measurement ===
576 576  
577 577  
578 578  The LiDAR probe is based on TOF, namely, Time of Flight principle. To be specific, the product emits modulation wave of near infrared ray on a periodic basis, which will be reflected after contacting object. The product obtains the time of flight by measuring round-trip phase difference and then calculates relative range between the product and the detection object, as shown below.
... ... @@ -580,7 +580,7 @@
580 580  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831757579-263.png?rev=1.1||alt="1654831757579-263.png"]]
581 581  
582 582  
583 -=== 2.8.2 Distance Measurement Characteristics ===
677 +=== 2.7.2 Distance Measurement Characteristics ===
584 584  
585 585  
586 586  With optimization of light path and algorithm, The LiDAR probe has minimized influence from external environment on distance measurement performance. Despite that, the range of distance measurement may still be affected by the environment illumination intensity and the reflectivity of detection object. As shown in below:
... ... @@ -618,7 +618,7 @@
618 618  )))
619 619  
620 620  
621 -=== 2.8.3 Notice of usage ===
715 +=== 2.7.3 Notice of usage ===
622 622  
623 623  
624 624  Possible invalid /wrong reading for LiDAR ToF tech:
... ... @@ -630,7 +630,7 @@
630 630  
631 631  
632 632  
633 -=== 2.8.4  Reflectivity of different objects ===
727 +=== 2.7.4  Reflectivity of different objects ===
634 634  
635 635  
636 636  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:379px" %)
... ... @@ -741,9 +741,9 @@
741 741  === 3.3.2 Set Interrupt Mode ===
742 742  
743 743  
744 -Feature, Set Interrupt mode for PA8 of pin.
838 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
745 745  
746 -When AT+INTMOD=0 is set, PA8 is used as a digital input port.
840 +When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
747 747  
748 748  (% style="color:blue" %)**AT Command: AT+INTMOD**
749 749  
... ... @@ -754,7 +754,11 @@
754 754  OK
755 755  the mode is 0 =Disable Interrupt
756 756  )))
757 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
851 +|(% style="width:154px" %)(((
852 +AT+INTMOD=2
853 +
854 +(default)
855 +)))|(% style="width:196px" %)(((
758 758  Set Transmit Interval
759 759  0. (Disable Interrupt),
760 760  ~1. (Trigger by rising and falling edge)
... ... @@ -776,7 +776,7 @@
776 776  
777 777  === 3.3.3  Set Power Output Duration ===
778 778  
779 -Control the output duration 3V3 . Before each sampling, device will
877 +Control the output duration 3V3(pin of VBAT_OUT) . Before each sampling, device will
780 780  
781 781  ~1. first enable the power output to external sensor,
782 782  
... ... @@ -792,6 +792,7 @@
792 792  OK
793 793  |(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
794 794  |(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK
893 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:196px" %)Always turn off the power supply of 3V3 pin.|(% style="width:157px" %)OK
795 795  
796 796  (% style="color:blue" %)**Downlink Command: 0x07**(%%)
797 797  Format: Command Code (0x07) followed by 3 bytes.
... ... @@ -800,6 +800,7 @@
800 800  
801 801  * Example 1: Downlink Payload: 07 01 00 00  **~-~-->**  AT+3V3T=0
802 802  * Example 2: Downlink Payload: 07 01 01 F4  **~-~-->**  AT+3V3T=500
902 +* Example 3: Downlink Payload: 07 01 FF FF  **~-~-->**  AT+3V3T=65535
803 803  
804 804  
805 805  
image-20230805104104-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +46.3 KB
Content
image-20230805144259-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +872.7 KB
Content
image-20230805144936-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.5 KB
Content
image-20230805145056-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +30.7 KB
Content
image-20230805150315-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +90.6 KB
Content
image-20230805155335-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +45.4 KB
Content
image-20230805155428-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +45.5 KB
Content
image-20230805155515-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +45.7 KB
Content