Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 90.18
edited by Xiaoling
on 2023/07/15 15:53
Change comment: There is no comment for this version
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
Content
... ... @@ -145,6 +145,8 @@
145 145  )))
146 146  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
147 147  
148 +
149 +
148 148  == 1.7 BLE connection ==
149 149  
150 150  
... ... @@ -161,8 +161,8 @@
161 161  
162 162  == 1.8 Pin Definitions ==
163 163  
164 -[[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"]]
165 165  
167 +[[image:image-20230805144259-1.png||height="413" width="741"]]
166 166  
167 167  == 1.9 Mechanical ==
168 168  
... ... @@ -259,6 +259,8 @@
259 259  
260 260  Example parse in TTNv3
261 261  
264 +[[image:image-20230805103904-1.png||height="131" width="711"]]
265 +
262 262  (% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
263 263  
264 264  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
... ... @@ -314,11 +314,11 @@
314 314  
315 315  
316 316  (((
317 -LDS12-LB will uplink payload via LoRaWAN with below payload format: 
318 -)))
321 +LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
319 319  
320 -(((
321 -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.
322 322  )))
323 323  
324 324  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
... ... @@ -333,7 +333,7 @@
333 333  [[Message Type>>||anchor="HMessageType"]]
334 334  )))
335 335  
336 -[[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"]]
337 337  
338 338  
339 339  ==== (% style="color:blue" %)**Battery Info**(%%) ====
... ... @@ -383,18 +383,33 @@
383 383  Customers can judge whether they need to adjust the environment based on the signal strength.
384 384  
385 385  
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 +
386 386  ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
387 387  
388 388  
389 389  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.
390 390  
391 -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 .
392 392  
393 393  **Example:**
394 394  
395 -0x00: Normal uplink packet.
414 +If byte[0]&0x01=0x00 : Normal uplink packet.
396 396  
397 -0x01: Interrupt Uplink Packet.
416 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
398 398  
399 399  
400 400  ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
... ... @@ -420,12 +420,97 @@
420 420  
421 421  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
422 422  |=(% 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**
423 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
424 -|(% 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
425 425  
426 -=== 2.3.3 Decode payload in The Things Network ===
445 +[[image:image-20230805150315-4.png||height="233" width="723"]]
427 427  
428 428  
448 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
449 +
450 +
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 +
429 429  While using TTN network, you can add the payload format to decode the payload.
430 430  
431 431  [[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"]]
... ... @@ -440,15 +440,9 @@
440 440  )))
441 441  
442 442  
443 -== 2.4 Uplink Interval ==
547 +== 2.4 ​Show Data in DataCake IoT Server ==
444 444  
445 445  
446 -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"]]
447 -
448 -
449 -== 2.5 ​Show Data in DataCake IoT Server ==
450 -
451 -
452 452  (((
453 453  [[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:
454 454  )))
... ... @@ -481,13 +481,13 @@
481 481  [[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"]]
482 482  
483 483  
484 -== 2.6 Datalog Feature ==
582 +== 2.5 Datalog Feature ==
485 485  
486 486  
487 487  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.
488 488  
489 489  
490 -=== 2.6.1 Ways to get datalog via LoRaWAN ===
588 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
491 491  
492 492  
493 493  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.
... ... @@ -504,7 +504,7 @@
504 504  [[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"]]
505 505  
506 506  
507 -=== 2.6.2 Unix TimeStamp ===
605 +=== 2.5.2 Unix TimeStamp ===
508 508  
509 509  
510 510  LDS12-LB uses Unix TimeStamp format based on
... ... @@ -521,7 +521,7 @@
521 521  So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
522 522  
523 523  
524 -=== 2.6.3 Set Device Time ===
622 +=== 2.5.3 Set Device Time ===
525 525  
526 526  
527 527  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
... ... @@ -531,7 +531,7 @@
531 531  (% 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.**
532 532  
533 533  
534 -=== 2.6.4 Poll sensor value ===
632 +=== 2.5.4 Poll sensor value ===
535 535  
536 536  
537 537  Users can poll sensor values based on timestamps. Below is the downlink command.
... ... @@ -558,7 +558,7 @@
558 558  )))
559 559  
560 560  
561 -== 2.7 Frequency Plans ==
659 +== 2.6 Frequency Plans ==
562 562  
563 563  
564 564  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.
... ... @@ -566,9 +566,9 @@
566 566  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
567 567  
568 568  
569 -== 2.8 LiDAR ToF Measurement ==
667 +== 2.7 LiDAR ToF Measurement ==
570 570  
571 -=== 2.8.1 Principle of Distance Measurement ===
669 +=== 2.7.1 Principle of Distance Measurement ===
572 572  
573 573  
574 574  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.
... ... @@ -576,7 +576,7 @@
576 576  [[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"]]
577 577  
578 578  
579 -=== 2.8.2 Distance Measurement Characteristics ===
677 +=== 2.7.2 Distance Measurement Characteristics ===
580 580  
581 581  
582 582  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:
... ... @@ -614,7 +614,7 @@
614 614  )))
615 615  
616 616  
617 -=== 2.8.3 Notice of usage ===
715 +=== 2.7.3 Notice of usage ===
618 618  
619 619  
620 620  Possible invalid /wrong reading for LiDAR ToF tech:
... ... @@ -624,9 +624,11 @@
624 624  * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.
625 625  * The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window.
626 626  
627 -=== 2.8.4  Reflectivity of different objects ===
628 628  
629 629  
727 +=== 2.7.4  Reflectivity of different objects ===
728 +
729 +
630 630  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:379px" %)
631 631  |=(% style="width: 54px;background-color:#4F81BD;color:white" %)Item|=(% style="width: 231px;background-color:#4F81BD;color:white" %)Material|=(% style="width: 94px;background-color:#4F81BD;color:white" %)Relectivity
632 632  |(% style="width:53px" %)1|(% style="width:229px" %)Black foam rubber|(% style="width:93px" %)2.4%
... ... @@ -650,6 +650,8 @@
650 650  |(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200%
651 651  |(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300%
652 652  
753 +
754 +
653 653  = 3. Configure LDS12-LB =
654 654  
655 655  == 3.1 Configure Methods ==
... ... @@ -663,6 +663,8 @@
663 663  
664 664  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
665 665  
768 +
769 +
666 666  == 3.2 General Commands ==
667 667  
668 668  
... ... @@ -731,9 +731,9 @@
731 731  === 3.3.2 Set Interrupt Mode ===
732 732  
733 733  
734 -Feature, Set Interrupt mode for PA8 of pin.
838 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
735 735  
736 -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.
737 737  
738 738  (% style="color:blue" %)**AT Command: AT+INTMOD**
739 739  
... ... @@ -744,7 +744,11 @@
744 744  OK
745 745  the mode is 0 =Disable Interrupt
746 746  )))
747 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
851 +|(% style="width:154px" %)(((
852 +AT+INTMOD=2
853 +
854 +(default)
855 +)))|(% style="width:196px" %)(((
748 748  Set Transmit Interval
749 749  0. (Disable Interrupt),
750 750  ~1. (Trigger by rising and falling edge)
... ... @@ -762,9 +762,11 @@
762 762  
763 763  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
764 764  
873 +
874 +
765 765  === 3.3.3  Set Power Output Duration ===
766 766  
767 -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
768 768  
769 769  ~1. first enable the power output to external sensor,
770 770  
... ... @@ -780,6 +780,7 @@
780 780  OK
781 781  |(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
782 782  |(% 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
783 783  
784 784  (% style="color:blue" %)**Downlink Command: 0x07**(%%)
785 785  Format: Command Code (0x07) followed by 3 bytes.
... ... @@ -788,7 +788,10 @@
788 788  
789 789  * Example 1: Downlink Payload: 07 01 00 00  **~-~-->**  AT+3V3T=0
790 790  * Example 2: Downlink Payload: 07 01 01 F4  **~-~-->**  AT+3V3T=500
902 +* Example 3: Downlink Payload: 07 01 FF FF  **~-~-->**  AT+3V3T=65535
791 791  
904 +
905 +
792 792  = 4. Battery & Power Consumption =
793 793  
794 794  
... ... @@ -817,6 +817,8 @@
817 817  
818 818  * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
819 819  
934 +
935 +
820 820  = 6. FAQ =
821 821  
822 822  == 6.1 What is the frequency plan for LDS12-LB? ==
... ... @@ -877,6 +877,8 @@
877 877  
878 878  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
879 879  
996 +
997 +
880 880  = 9. ​Packing Info =
881 881  
882 882  
... ... @@ -894,6 +894,8 @@
894 894  
895 895  * Weight / pcs : g
896 896  
1015 +
1016 +
897 897  = 10. Support =
898 898  
899 899  
image-20230805103904-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +46.9 KB
Content
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