Last modified by Mengting Qiu on 2025/07/08 11:11

From version 203.1
edited by Dilisi S
on 2025/06/01 14:29
Change comment: June 01 edits - part 1
To version 204.1
edited by Dilisi S
on 2025/06/01 17:19
Change comment: June 01 edits - part 2

Summary

Details

Page properties
Content
... ... @@ -185,80 +185,142 @@
185 185  [[image:image-20250403170001-2.jpeg]]
186 186  
187 187  
188 -= 2. Configure LDS25-LB/LS to connect to LoRaWAN network =
188 += 2. Registering LDS25-LB/LS with a LoRaWAN Network Server =
189 189  
190 -== 2.1 How it works ==
191 191  
191 +**The LDS25-LB/LS can be registered with any LoRaWAN network server. In this documentation, we use The Things Stack as an example, but similar settings may apply to other LoRaWAN network servers.**
192 192  
193 +
194 +== 2.1 How does the LDS25-LB/LS work? ==
195 +
196 +
193 193  The LDS25-LB/LS is configured in LoRaWAN **Class A** mode by default. The device ships with unique registration information that can be used to configure it for OTAA (Over-The-Air Activation).
194 -To connect to a local LoRaWAN network, you must first register the device with the respective LoRaWAN network server using the registration information. 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.
198 +To connect to a local LoRaWAN network, you must first register the device with the respective LoRaWAN network server using the registration information.
195 195  
196 196  (% style="display:none" %) (%%)
197 197  
198 -== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
202 +The LDS25-LB/LS's registration information can be found inside the device package.
199 199  
204 +[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
200 200  
201 -Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
202 202  
203 -The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
207 +The registration information includes the following:
204 204  
209 +* DevEUI
210 +* AppEUI
211 +* AppKey
212 +
213 +
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 +
216 +
217 +== 2.2 ​Registering with The Things Stack ==
218 +
219 +
220 +In this section we will guide you through on how to register the LDS25-LB/LS with The Things Stack. If your area has **The Things Stack** community network coverage, you can use it without setting up your own network. If not, you can set up your own LoRaWAN network coverage by using our [[**LPS8N**>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/200-lps8n.html]] LoRaWAN gateway.
221 +
222 +The typical end-to-end network setup with LDS25-LB/LS and LPS8v2 is shown below:
223 +
224 +
205 205  [[image:image-20241008144342-3.png]]
206 206  
207 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS25-LB/LS.
208 208  
209 -Each LDS25-LB/LS is shipped with a sticker with the default device EUI as below:
228 +=== 2.2.1 Add LDS25-LB/LS to The Things Stack ===
210 210  
211 -[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
230 +* Manually
212 212  
213 213  
214 -You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
233 +==== 2.2.1.1 Creating an application ====
215 215  
216 -(% style="color:blue" %)**Create the application.**
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.
217 217  
237 +
218 218  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
219 219  
220 220  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
221 221  
222 -(% style="color:blue" %)**Add devices to the created Application.**
223 223  
243 +==== 2.2.1.2 Adding using the LoRaWAN device repository ====
244 +
245 +You can refer to the screenshots below to register your LDS25-LB/LS using The Things Stack's LoRaWAN device repository.
246 +
247 +On The Things Stack console:
248 +
249 +~1. Click **Applications**.
250 +
251 +2. Click the + button and then choose **Register end device in an application** form the drop-down list.
252 +
253 +3. Select your application from the pop-up window.
254 +
255 +
224 224  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
225 225  
226 226  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
227 227  
228 -(% style="color:blue" %)**Enter end device specifics manually.**
229 229  
261 +On the **Register end device** page:
262 +
263 +~1. Select **Enter end device specifies manually** option.
264 +
265 +2. **Frequency plan**: Select the frequency plan that matches your device. E.g.: Europe 863-870 MHz (SF9 for RX2 - recommended).
266 +
267 +3. **LoRaWAN version**: LoRaWAN Specification 1.0.3
268 +
269 +4. **Regional Parameters version**: You can't change it and it will select automatically.
270 +
271 +5. **JoinEUI**: Enter the **AppEUI** of the device (see the registration information sticker) and Click the **Confirm** button.
272 +
230 230  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
231 231  
232 -(% style="color:blue" %)**Add DevEUI and AppKey.**
233 233  
234 -(% style="color:blue" %)**Customize a platform ID for the device.**
276 +6. **DevEUI**: Enter the DevEUI of the device (see the registration information sticker).
235 235  
278 +7. **AppKey**: Enter the AppKey of the device (see the registration information sticker).
279 +
280 +8. **End device ID**: Enter a name for your end device to uniquely identify it within this application.
281 +
282 +9. Click **View registered end device** option.
283 +
284 +10. Click **Register end device** button.
285 +
286 +
236 236  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
237 237  
238 238  
290 +You will be navigated to the **Device overview **page.
239 239  
240 -(% style="color:blue" %)**Step 2:**(%%) Add decoder.
241 241  
242 -In TTN, user can add a custom payload so it shows friendly reading.
293 +==== 2.2.1.3 Uplink Decoder in The Things Stack ====
243 243  
244 -Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]
295 +When the uplink payload arrives in The Things Stack, it is displayed in HEX format, which is not easy to read. You can add the LDS25-LB/LS decoder in The Things Stack for easier readability of each sensor readings.
245 245  
246 -Below is TTN screen shot:
297 +The uplink decoder can be added to the** Payload Formatters** of your device in The Things Stack. Refer to the screenshot below.
247 247  
299 +~1. Click **Uplink** tab.
248 248  
301 +2. **Formatter type:** Select Custom Javascript formatter.
302 +
303 +3. **Formatter code**: Copy the uplink payload formatter code from our [[dragino-end-node-decoder GitHub repository>>https://github.com/dragino/dragino-end-node-decoder/tree/main/]] and paste it here.
304 +
305 +4. Finally, click on the **Save changes** button.
306 +
307 +
249 249  [[image:image-20241009140556-1.png||height="488" width="1184"]]
250 250  
251 251  [[image:image-20241009140603-2.png||height="562" width="1168"]]
252 252  
253 253  
254 -(% style="color:blue" %)**Step 3:**(%%) Activate on LDS25-LB/LS
255 255  
256 -Press the button for 5 seconds to activate the LDS25-LB/LS.
257 257  
258 -(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
315 +==== 2.2.1.4 Activate the device by pressing and holding the ACT button for more than 5 seconds. ====
259 259  
260 -After join success, it will start to upload messages to TTN and you can see the messages in the panel.
317 +Press and hold the button for 5 seconds to activate the LDS25-LB/LS.
261 261  
319 +The green LED will blink rapidly 5 times, and the device will enter OTAA mode for 3 seconds. Then it will begin the LoRaWAN join procedure. Once successfully joined to the network, the green LED will stay on for 5 seconds.
320 +
321 +After a successful join, the device will start uploading messages to The Things Stack, and you will be able to see the messages in the panel.
322 +
323 +
262 262  [[image:image-20241009140815-3.png||height="301" width="1317"]]
263 263  
264 264