Skip to Content
Last modified by Mengting Qiu on 2025/07/08 11:11
From version 204.1
edited by Dilisi S
on 2025/06/01 17:19
Change comment: June 01 edits - part 2
To version 205.1
edited by Dilisi S
on 2025/06/01 17:51
Change comment: June 01 - Add ThingsEye

Summary

Details

Page properties
Content
... ... @@ -210,7 +210,6 @@
210 210  * AppEUI
211 211  * AppKey
212 212  
213 -
214 214  We recommend using the **OTAA **activation method because it is more secure than the ABP method. After adding the registration information, press the **ACT **button to activate the LDS25-LB/LS. It will automatically join the network using OTAA and start sending sensor values. The default uplink interval is **20 **minutes.
215 215  
216 216  
... ... @@ -229,7 +229,6 @@
229 229  
230 230  * Manually
231 231  
232 -
233 233  ==== 2.2.1.1 Creating an application ====
234 234  
235 235  Sign up for a free account with [[The Things Stack Sandbox>>url:https://eu1.cloud.thethings.network/]] if you do not have one yet. Then, create an application as shown in the screenshots below.
... ... @@ -726,13 +726,168 @@
726 726  [[image:image-20250403170530-6.jpeg]]
727 727  
728 728  
729 -== 2.5 Datalog Feature ==
727 +== 2.5 Integrating with IoT platforms ==
730 730  
729 +The LDS25-LB/LS sensor data can be integrated with other IoT platforms for better visualizing and analyzing the data. In this section, we will show you how to integrate sensor data from The Things Stack with some popular IoT platforms.
731 731  
731 +=== 2.5.1 Integrate and show data on ThingsEye ===
732 +
733 +The Things Stack application supports integration with ThingsEye.io. Once integrated, ThingsEye.io acts as an MQTT client for The Things Stack MQTT broker, allowing it to subscribe to upstream traffic and publish downlink traffic.
734 +
735 +{{info}}
736 +The integration will link The Things Stack application (with all the devices) with ThingsEye. You can select sensor data fields from each device when creating the ThingsEye dashboards.
737 +{{/info}}
738 +
739 +
740 +==== 2.5.1.1 Configuring The Things Stack ====
741 +
742 +We use The Things Stack Sandbox in this example:
743 +
744 +* In **The Things Stack Sandbox**, go to the **Application **for the LDS25-LB/LS you added.
745 +* Select **MQTT** under **Integrations** in the left menu.
746 +* In the **Connection information **section, under **Connection credentials**, The Things Stack displays an auto-generated **username**. You can use it or provide a new one.
747 +* Click the **Generate new API key** button to generate a password. You can view it by clicking on the **visibility toggle/eye** icon. The API key works as the password.
748 +
749 +
750 +(% class="box infomessage" %)
751 +(((
752 +The username and  password (API key) you created here are required in the next section.
753 +)))
754 +
755 +
756 +(% class="wikigeneratedid" %)
757 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/tts-mqtt-integration.png?rev=1.1||alt="tts-mqtt-integration.png"]]
758 +
759 +
760 +==== 2.5.1.2 Configuring ThingsEye.io ====
761 +
762 +The ThingsEye.io IoT platform is not open for self-registration at the moment. If you are interested in testing the platform, please send your project information to admin@thingseye.io, and we will create an account for you.
763 +
764 +* Login to your [[ThingsEye.io >>url:https://thingseye.io/]]account.
765 +* Under the **Integrations center**, click **Integrations**.
766 +* Click the **Add integration** button (the button with the **+** symbol).
767 +
768 +
769 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-1.png?rev=1.2||alt="thingseye-io-step-1.png"]]
770 +
771 +
772 +On the **Add integration** window, configure the following:
773 +
774 +**Basic settings:**
775 +
776 +* Select **The Things Stack Community** from the **Integration type** list.
777 +* Enter a suitable name for your integration in the **Name **text** **box or keep the default name.
778 +* Ensure the following options are turned on.
779 +** Enable integration
780 +** Debug mode
781 +** Allow create devices or assets
782 +* Click the **Next** button. you will be navigated to the **Uplink data converter** tab.
783 +
784 +
785 +(% class="wikigeneratedid" %)
786 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-2.png?rev=1.1||alt="thingseye-io-step-2.png"]]
787 +
788 +
789 +**Uplink data converter:**
790 +
791 +* Click the **Create new** button if it is not selected by default.
792 +* Enter a suitable name for the uplink data converter in the **Name **text** **box or keep the default name.
793 +* Click the **JavaScript** button.
794 +* Paste the uplink decoder function into the text area (first, delete the default code). The demo uplink decoder function can be found [[here>>url:https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js]].
795 +* Click the **Next** button. You will be navigated to the **Downlink data converter **tab.
796 +
797 +
798 +(% class="wikigeneratedid" %)
799 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-3.png?rev=1.1||alt="thingseye-io-step-3.png"]]
800 +
801 +
802 +**Downlink data converter (this is an optional step):**
803 +
804 +* Click the **Create new** button if it is not selected by default.
805 +* Enter a suitable name for the downlink data converter in the **Name **text** **box or keep the default name.
806 +* Click the **JavaScript** button.
807 +* Paste the downlink decoder function into the text area (first, delete the default code). The demo downlink decoder function can be found [[here>>url:https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js]].
808 +* Click the **Next** button. You will be navigated to the **Connection** tab.
809 +
810 +
811 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-4.png?rev=1.1||alt="thingseye-io-step-4.png"]]
812 +
813 +
814 +**Connection:**
815 +
816 +* Choose **Region** from the **Host type**.
817 +* Enter the **cluster** of your **The Things Stack** in the **Region** textbox. You can find the cluster in the url (e.g., https:~/~/**eu1**.cloud.thethings.network/...).
818 +* Enter the **Username** and **Password** of the MQTT integration in the **Credentials** section. The **username **and **password **can be found on the MQTT integration page of your The Things Stack account (see **2.5.1.1 Configuring The Things Stack**).
819 +* Click the **Check connection** button to test the connection. If the connection is successful, you will see the message saying **Connected**.
820 +
821 +
822 +(% class="wikigeneratedid" %)
823 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/message-1.png?rev=1.1||alt="message-1.png"]]
824 +
825 +
826 +
827 +(% class="wikigeneratedid" %)
828 +Click the **Add** button.
829 +
830 +
831 +(% class="wikigeneratedid" %)
832 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-5.png?rev=1.1||alt="thingseye-io-step-5.png"]]
833 +
834 +
835 +(% class="wikigeneratedid" %)
836 +Your integration has been added to the** Integrations** list and will be displayed on the **Integrations** page. Check whether the status is shown as **Active**. If not, review your configuration settings and correct any errors.
837 +
838 +
839 +(% class="wikigeneratedid" %)
840 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye.io_integrationsCenter_integrations.png?rev=1.2||alt="thingseye.io_integrationsCenter_integrations.png"]]
841 +
842 +
843 +==== 2.5.1.3 Viewing integration details ====
844 +
845 +Click on your integration from the list. The **Integration details** window will appear with the **Details **tab selected. The **Details **tab shows all the settings you have provided for this integration.
846 +
847 +
848 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/integration-details.png?rev=1.1||alt="integration-details.png"]]
849 +
850 +
851 +If you want to edit the settings you have provided, click on the **Toggle edit mode** button. Once you have done click on the **Apply changes **button.
852 +
853 +{{info}}
854 +See also [[ThingsEye documentation>>url:https://wiki.thingseye.io/xwiki/bin/view/Main/]].
855 +{{/info}}
856 +
857 +
858 +==== 2.5.1.4 Viewing events ====
859 +
860 +The **Events **tab displays all the uplink messages from the LDS25-LB/LS.
861 +
862 +* Select **Debug **from the **Event type** dropdown.
863 +* Select the** time frame** from the **time window**.
864 +
865 +
866 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-events.png?rev=1.1||alt="thingseye-events.png"]]
867 +
868 +
869 +* To view the **JSON payload** of a message, click on the **three dots (...)** in the **Message** column of the desired message.
870 +
871 +
872 +==== 2.5.1.5 Viewing Sensor data on a dashboard ====
873 +
874 +You can create a dashboard with ThingsEye to visualize the sensor data coming from the LDS25-LB/LS. The following image shows a dashboard created for the LDS25-LB/LS. See **Creating a dashboard** in ThingsEye documentation for more information.
875 +
876 +
877 +==== 2.5.1.6 Deleting an integration ====
878 +
879 +If you want to delete an integration, click the **Delete integration** button on the Integrations page.
880 +
881 +
882 +== 2.6 Datalog Feature ==
883 +
884 +
732 732  Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LDS25-LB/LS will store the reading for future retrieving purposes.
733 733  
734 734  
735 -=== 2.5.1 Ways to get datalog via LoRaWAN ===
888 +=== 2.6.1 Ways to get datalog via LoRaWAN ===
736 736  
737 737  
738 738  Set PNACKMD=1, LDS25-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, LDS25-LB/LS 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.
... ... @@ -744,7 +744,7 @@
744 744  b) LDS25-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but LDS25-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if LDS25-LB/LS gets a ACK, LDS25-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
745 745  )))
746 746  
747 -=== 2.5.2 Unix Timestamp ===
900 +=== 2.6.2 Unix Timestamp ===
748 748  
749 749  
750 750  LDS25-LB/LS uses Unix Timestamp format based on the following:
... ... @@ -761,7 +761,7 @@
761 761  So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
762 762  
763 763  
764 -=== 2.5.3 Set Device Time ===
917 +=== 2.6.3 Set Device Time ===
765 765  
766 766  
767 767  You need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable time synchronization via MAC command.
... ... @@ -776,7 +776,7 @@
776 776  (% style="color:red" %)**If the server does not  support this command, it will discard uplink packets containing the time request. As a result, the user will lose that packet when using TTN v2 with SYNCMOD=1.**
777 777  
778 778  
779 -=== 2.5.4 Poll sensor value ===
932 +=== 2.6.4 Poll sensor value ===
780 780  
781 781  
782 782  Users can poll sensor values based on timestamps. Below is the downlink command.
... ... @@ -803,7 +803,7 @@
803 803  )))
804 804  
805 805  
806 -== 2.6 Frequency Plans ==
959 +== 2.7 Frequency Plans ==
807 807  
808 808  
809 809  The LDS25-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
... ... @@ -811,9 +811,9 @@
811 811  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
812 812  
813 813  
814 -== 2.7 LiDAR ToF Measurement ==
967 +== 2.8 LiDAR ToF Measurement ==
815 815  
816 -=== 2.7.1 Principle of Distance Measurement ===
969 +=== 2.8.1 Principle of Distance Measurement ===
817 817  
818 818  
819 819  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.
... ... @@ -821,7 +821,7 @@
821 821  [[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"]]
822 822  
823 823  
824 -=== 2.7.2 Distance Measurement Characteristics ===
977 +=== 2.8.2 Distance Measurement Characteristics ===
825 825  
826 826  
827 827  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.
... ... @@ -848,7 +848,7 @@
848 848  )))
849 849  
850 850  
851 -=== 2.7.3 Notes on usage ===
1004 +=== 2.8.3 Notes on usage ===
852 852  
853 853  
854 854  Possible invalid or incorrect readings with LiDAR ToF technology:
... ... @@ -858,7 +858,7 @@
858 858  * If the LiDAR probe is covered with dirt or debris, the readings may be incorrect. In this case, clean the probe.
859 859  * The sensor window is made of acrylic. Do not touch it with alcohol-based substances, as this may damage the window.
860 860  
861 -=== 2.7.4 Reflectivity of different objects ===
1014 +=== 2.8.4 Reflectivity of different objects ===
862 862  
863 863  
864 864  (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:379px" %)