<
From version < 99.5 >
edited by Xiaoling
on 2022/05/26 14:21
To version < 99.16 >
edited by Xiaoling
on 2022/07/25 09:18
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,14 +1,18 @@
1 -**~ Contents:**
1 +**~ Table of Contents:**
2 2  
3 3  {{toc/}}
4 4  
5 5  
6 +
6 6  = 1. The Things Network-V3 =
7 7  
8 -== 1.1 Introduction ==
9 9  
10 -=== 1.1.1 What is The Things Network ===
10 +== 1.1  Introduction ==
11 11  
12 +
13 +=== 1.1.1  What is The Things Network ===
14 +
15 +
12 12  (((
13 13  The Things Network is a global collaborative Internet of Things ecosystem that creates networks, devices and solutions using LoRaWAN.
14 14  )))
... ... @@ -16,11 +16,13 @@
16 16  (((
17 17  The Things Network runs The Things Stack Community Edition, which is a crowdsourced, open and decentralized LoRaWAN network. This network is a great way to get started testing devices, applications, and integrations, and get familiar with LoRaWAN.
18 18  
23 +
19 19  
20 20  )))
21 21  
22 -=== 1.1.2 Login or crate an account ===
27 +=== 1.1.2  Login or crate an account ===
23 23  
29 +
24 24  (((
25 25  [[Login or create an account>>url:https://console.cloud.thethings.network/]] to get started with The Things Network and start using The Things Stack Console.
26 26  )))
... ... @@ -28,63 +28,80 @@
28 28  (((
29 29  Once you have an account,get started by following steps for adding Gateway,Device and Intergrations.
30 30  
37 +
31 31  
32 32  )))
33 33  
34 -=== 1.1.3 List the support products and Requirements ===
41 +=== 1.1.3  List the support products and Requirements ===
35 35  
43 +
36 36  LoRaWAN Gateway model: Existing Gateway
37 37  
38 38  
39 -= 2. Gateway Registration for Semtech UDP =
40 40  
41 -== 2.1 Primary LoRaWAN Server ==
48 += 2.  Gateway Registration for Semtech UDP =
42 42  
50 +
51 +== 2.1  Primary LoRaWAN Server ==
52 +
53 +
43 43  [[image:image-20220526134633-2.png||height="616" width="1323"]]
44 44  
45 45  Register Gateway
46 46  
47 47  
59 +
48 48  [[image:image-20220526134826-4.png]]
49 49  
50 50  Put Gateway ID
51 51  
52 52  
65 +
53 53  [[image:image-20220526134759-3.png]]
54 54  
55 55  Choose Frequency Band
56 56  
57 57  
71 +
58 58  [[image:image-20220526134919-5.png]]
59 59  
60 60  Show Status
61 61  
62 62  
63 -== 2.2 Secondary LoRaWAN Server ==
64 64  
65 -=== 2.2.1 Introduction ===
78 +== 2.2  Secondary LoRaWAN Server ==
66 66  
80 +
81 +=== 2.2.1  Introduction ===
82 +
83 +
67 67  The Dragino gateway has supports the Secondary server settings.
68 68  
69 69  
70 -=== 2.2.2 Below list the support products and Requirements: ===
71 71  
88 +=== 2.2.2  Below list the support products and Requirements: ===
89 +
90 +
72 72  (((
73 -~1. LoRaWAN Gateway model: [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
92 +1.  LoRaWAN Gateway model:  [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
74 74  )))
75 75  
76 76  (((
77 -2. Firmware version since :[[lgw~~-~~-build-v5.4.1644658774>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LIG16/Firmware/Release/]]
96 +2.  Firmware version since :  [[lgw~~-~~-build-v5.4.1644658774>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LIG16/Firmware/Release/]]
78 78  )))
79 79  
80 80  
81 -=== 2.2.3 Example ===
82 82  
101 +=== 2.2.3  Example ===
102 +
103 +
83 83  The following takes Helium as a Secondary LoRaWAN server as an example
84 84  
85 85  
86 -=== 2.2.4 Step 1: Download and Install the helium gateway-rs ===
87 87  
108 +=== 2.2.4  Step 1: Download and Install the helium gateway-rs ===
109 +
110 +
88 88  The users is needing to download and install the helium gateway-rs then click the button of Save&Apply
89 89  
90 90  [[image:image-20220526135049-6.png]]
... ... @@ -92,8 +92,10 @@
92 92  Download and Install gateway-rs
93 93  
94 94  
95 -=== 2.2.5 Step 2: Back to Semtech UDP page ===
96 96  
119 +=== 2.2.5  Step 2: Back to Semtech UDP page ===
120 +
121 +
97 97  Back to the page of Semtech UDP check the secondary server settings and click the button of Save&Apply
98 98  
99 99  ​​​​[[image:image-20220526135125-7.png]]
... ... @@ -101,32 +101,41 @@
101 101  Configuration of helium
102 102  
103 103  
104 -= 3. Gateway Registration for Basics Station =
105 105  
106 -== 3.1 Introduction ==
130 += 3.  Gateway Registration for Basics Station =
107 107  
132 +
133 +== 3.1  Introduction ==
134 +
135 +
108 108  (((
109 109  (((
110 110  The LoRa Basics™ Station protocol simplifies management of large scale LoRaWAN networks. LoRa Basics™ Station is the preferred way of connecting Gateways to The Things Stack. [[The LoRa Basics Station doc>>url:https://www.thethingsindustries.com/docs/gateways/lora-basics-station/]]
139 +
140 +
111 111  )))
112 112  )))
113 113  
114 114  (((
115 -**Below list the support products and Requirements:**
145 +(% style="color:blue" %)**Below list the support products and Requirements:**
116 116  )))
117 117  
118 118  (((
119 119  (((
120 - ~1. LoRaWAN Gateway model: [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
150 +1. LoRaWAN Gateway model: [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
121 121  )))
122 122  
123 123  (((
124 124   2. Firmware version since :[[lgw~~-~~-build-v5.4.1640315898>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]
155 +
156 +
157 +
158 +
125 125  )))
126 126  )))
127 127  
128 128  (((
129 -**What do you need to prepare**
163 +(% style="color:blue" %)**What do you need to prepare**
130 130  )))
131 131  
132 132  (((
... ... @@ -133,12 +133,14 @@
133 133  (((
134 134  A gateway that can access the internet normally
135 135  
170 +
136 136  
137 137  )))
138 138  )))
139 139  
140 -== 3.2 Step 1. Add Gateway ==
175 +== 3.2  Step 1: Add Gateway ==
141 141  
177 +
142 142  (((
143 143  (((
144 144  The example for **EU**
... ... @@ -154,6 +154,8 @@
154 154  (((
155 155  (((
156 156  Following picture is the successful added.
193 +
194 +
157 157  )))
158 158  )))
159 159  
... ... @@ -162,52 +162,66 @@
162 162  Add Gateway
163 163  
164 164  
165 -== 3.3 Step 2. Create the API key ==
166 166  
204 +== 3.3  Step 2: Create the API key ==
205 +
206 +
167 167  user need to create the CUPS API key and LNS API key.
168 168  
209 +
169 169  [[image:image-20220526135349-9.png]]
170 170  
171 171  Create CUPS API key
172 172  
173 173  
215 +
174 174  [[image:image-20220526135428-10.png]]
175 175  
176 176  Create LNS API key
177 177  
220 +
178 178  (% style="color:red" %)**Note : Please copy the API key.**
179 179  
180 180  
181 -== 3.4 Step 3. Update the gateway setting ==
182 182  
225 +== 3.4  Step 3: Update the gateway setting ==
226 +
227 +
183 183  In the LoRa Basics Station LNS Authentication Key field, paste the API key you generated in the previous step.
184 184  
230 +
185 185  [[image:image-20220526135528-11.png]]
186 186  
187 187  paste the API key
188 188  
189 189  
190 -== 3.5 Step 4. Access the gateway GUI ==
191 191  
237 +== 3.5  Step 4: Access the gateway GUI ==
238 +
239 +
192 192  User need to update the API key and install the Certificate
193 193  
242 +
194 194  [[image:image-20220526135601-12.png]]
195 195  
196 196  Access the gateway GUI
197 197  
198 198  
199 -== 3.6 Step 5. Configure Station ==
200 200  
249 +== 3.6  Step 5: Configure Station ==
250 +
251 +
201 201  User need to input Server URI, Server CUPS Key and LNS Key, as well as install CUPS certificate.
202 202  
203 -**just to clarify.**
204 204  
255 +(% style="color:blue" %)**just to clarify:**
256 +
205 205  (% class="box" %)
206 206  (((
207 - CUPS Server URI  ~-~-> Server Adress
208 - CUPS Authorization Key         ~-~-> Server CUPS API Key
209 - LNS Authorization Key  ~-~-> Server LNS API Key
210 - CUPS certificate  ~-~-> Server CA(user can use the button to install the certificate by default)
259 + CUPS Server URI  ~-~->  Server Adress
260 + CUPS Authorization Key         ~-~->  Server CUPS API Key
261 + LNS Authorization Key  ~-~->  Server LNS API Key
262 + CUPS certificate  ~-~->  Server CA(user can use the button to install the certificate by default)
211 211  )))
212 212  
213 213  [[image:image-20220526135654-13.png]]
... ... @@ -215,32 +215,41 @@
215 215  Congfigure Station
216 216  
217 217  
218 -== 3.7 Start Station ==
219 219  
271 +== 3.7  Start Station ==
272 +
273 +
220 220  (((
221 221  When the user has finished the configuration,Please click Sace&Apply to start station to connect The Things Network.
222 222  
277 +
223 223  
224 224  )))
225 225  
226 -== 3.8 Siccessful Connection ==
281 +== 3.8  Siccessful Connection ==
227 227  
283 +
228 228  If user completes the above steps,which will see live date in the TTN.
229 229  
286 +
230 230  [[image:image-20220526135734-14.png]]
231 231  
232 232  Station live date
233 233  
234 234  
235 -== 3.9 Trouble Shooting ==
236 236  
293 +== 3.9  Trouble Shooting ==
294 +
295 +
237 237  User can check the station log in the logread/system log page.
238 238  
298 +
239 239  [[image:image-20220526135845-15.png]]
240 240  
241 241  Station Log
242 242  
243 243  
304 +
244 244  and recode the station log in the system/Recode log page.
245 245  
246 246  [[image:image-20220526135940-16.png]]
... ... @@ -248,8 +248,10 @@
248 248  Recore Log
249 249  
250 250  
251 -= 4. Configure node connection to TTNv3 =
252 252  
313 += 4.  Configure node connection to TTNv3 =
314 +
315 +
253 253  (((
254 254  (((
255 255  Following is an example for how to join the TTN v3 LoRaWAN Network.
... ... @@ -266,12 +266,14 @@
266 266  (((
267 267  We take LES01 as an example.
268 268  
332 +
269 269  
270 270  )))
271 271  )))
272 272  
273 -== 4.1 Step1 ==
337 +== 4.1  Step1 ==
274 274  
339 +
275 275  (((
276 276  (((
277 277  Create a device in TTN with the OTAA keys from LSE01.
... ... @@ -295,11 +295,15 @@
295 295  [[image:image-20220526140044-18.png]]
296 296  
297 297  
298 -== 4.2 Step2 ==
299 299  
364 +== 4.2  Step2 ==
365 +
366 +
300 300  (((
301 301  (((
302 302  There are all our nodes in the repository. Users can choose the corresponding brand, model, firmware version and frequency.The decoder and configuration information of the node are pre-configured.Users do not need to configure them.
370 +
371 +
303 303  )))
304 304  )))
305 305  
... ... @@ -306,34 +306,45 @@
306 306  [[image:image-20220526140132-19.png]]
307 307  
308 308  
309 -== 4.3 Step3 ==
310 310  
379 +== 4.3  Step3 ==
380 +
381 +
311 311  Add APP EUI in the application:
312 312  
384 +
313 313  [[image:image-20220526140205-20.png]]
314 314  
315 315  
316 -== 4.4 Step4 ==
317 317  
389 +== 4.4  Step4 ==
390 +
391 +
318 318  Add APP KEY and DEV EUI:
319 319  
394 +
320 320  [[image:image-20220526140251-21.png]]
321 321  
322 322  
323 -= 5. TTN V3 integrated into MQTT server =
324 324  
325 -== 5.1 Introduction ==
399 += 5.  TTN V3 integrated into MQTT server =
326 326  
401 +
402 +== 5.1  Introduction ==
403 +
404 +
327 327  (((
328 328  (((
329 329  The Application Server exposes an MQTT server to work with streaming events. In order to use the MQTT server you need to create a new API key, which will function as connection password. You can also use an existing API key, as long as it has the necessary rights granted.
330 330  
409 +
331 331  
332 332  )))
333 333  )))
334 334  
335 -== 5.2 Create device steps at MQTT ==
414 +== 5.2  Create device steps at MQTT ==
336 336  
416 +
337 337  (((
338 338  (((
339 339  The user creates a new API KEY after creating a device on TTN V3.
... ... @@ -349,6 +349,8 @@
349 349  (((
350 350  (((
351 351  Fill in Broker Address and Broker port.
432 +
433 +
352 352  )))
353 353  )))
354 354  
... ... @@ -357,8 +357,10 @@
357 357  Fill in the username and password into MQTT.
358 358  
359 359  
442 +
360 360  [[image:image-20220526140420-23.png]]
361 361  
445 +
362 362  The Application Server publishes uplink traffic on the following topics:
363 363  
364 364  (% class="box" %)
... ... @@ -375,13 +375,18 @@
375 375  )))
376 376  
377 377  (((
462 +
463 +
378 378  (((
379 -**Note**: Remember that the format of these topics for The Things Stack Open Source would contain {application id} instead of {application id}@{tenant id}.
465 +(% style="color:red" %)**Note**: **Remember that the format of these topics for The Things Stack Open Source would contain {application id} instead of {application id}@{tenant id}.**
466 +
467 +
380 380  )))
381 381  )))
382 382  
383 383  [[image:image-20220526140452-24.png]]
384 384  
473 +
385 385  (((
386 386  (((
387 387  While you could subscribe to all of these topics separately, for the simplicity of this tutorial we use # to subscribe to all topics, i.e. to receive all uplink traffic.
... ... @@ -398,7 +398,11 @@
398 398  
399 399  (((
400 400  (((
401 -**Note**: Remember that the format of this topic for The Things Stack Open Source deployment would be v3/{application id}/devices/{device id}/down/push.
490 +
491 +
492 +(% style="color:red" %)**Note**: **Remember that the format of this topic for The Things Stack Open Source deployment would be v3/{application id}/devices/{device id}/down/push.**
493 +
494 +
402 402  )))
403 403  )))
404 404  
... ... @@ -412,17 +412,23 @@
412 412  
413 413  (((
414 414  To send an unconfirmed downlink message to the device dev1 in application app1 in tenant tenant1 with the hexadecimal payload BE EF on FPort 15 with normal priority, use the topic v3/app1@tenant1/devices/dev1/down/push with the following contents:
508 +
509 +
415 415  )))
416 416  
417 417  (((
418 -**Note**: Use this handy tool to convert hexadecimal to base64.
513 +(% style="color:red" %)**Note**: **Use this handy tool to convert hexadecimal to base64.**
514 +
515 +
419 419  )))
420 420  
421 421  [[image:image-20220526140936-27.png]]
422 422  
423 423  
424 -== 5.3 Send Downlink message ==
425 425  
522 +== 5.3  Send Downlink message ==
523 +
524 +
426 426  (((
427 427  How to configure downlink in TTN V3?
428 428  )))
... ... @@ -432,7 +432,9 @@
432 432  )))
433 433  
434 434  (((
435 -Downlink command:01 00 00 5A
534 +(% style="color:blue" %)**Downlink command: 01 00 00 5A**
535 +
536 +
436 436  )))
437 437  
438 438  [[image:image-20220526141021-28.png]]
... ... @@ -440,6 +440,7 @@
440 440  downlink
441 441  
442 442  
544 +
443 443  After sending, you can view it in live data.
444 444  
445 445  [[image:image-20220526141052-29.png]]
... ... @@ -447,12 +447,15 @@
447 447  downlink
448 448  
449 449  
552 +
450 450  (((
451 451  When downlink is successfully sent, the downlink information can be received on the serial port.
452 452  )))
453 453  
454 454  (((
455 -**Note**: If the downlink byte sent is longer, the number of bytes will be displayed.
558 +(% style="color:red" %)**Note**:** If the downlink byte sent is longer, the number of bytes will be displayed.**
559 +
560 +
456 456  )))
457 457  
458 458  [[image:image-20220526141116-30.png]]
... ... @@ -468,13 +468,13 @@
468 468  
469 469  (((
470 470  (((
471 -If the equipment uses CLASS A. You can set **AT+RPL=2** or send the downlink command: **2102**
576 +If the equipment uses (% style="color:blue" %)**CLASS A**(%%). You can set (% style="color:red" %)**AT+RPL=2** (%%)or send the downlink command: (% style="color:red" %)**2102**
472 472  )))
473 473  )))
474 474  
475 475  (((
476 476  (((
477 -If the equipment uses CLASS C. You can set** AT+RPL=4** or send the downlink command: **2104**
582 +If the equipment uses (% style="color:blue" %)**CLASS C**(%%). You can set** (% style="color:red" %)AT+RPL=4(%%)** or send the downlink command: (% style="color:red" %)**2104**
478 478  )))
479 479  )))
480 480  
... ... @@ -481,6 +481,8 @@
481 481  (((
482 482  (((
483 483  When the device successfully receives the downlink, the server will receive a confirmation packet of 00.
589 +
590 +
484 484  )))
485 485  )))
486 486  
... ... @@ -489,8 +489,10 @@
489 489  downlink
490 490  
491 491  
492 -= 6. Request Remote Support =
493 493  
600 += 6.  Request Remote Support =
601 +
602 +
494 494  (((
495 495  These pages are useful to check what is wrong on the Join process. Below shows the four steps that we can check the Join Process.
496 496  \\If problem not solve, and you need dragino remote support, please follow to this document: [[TTN Support instruction>>url:https://www.dragino.com/downloads/index.php?dir=&file=TTNv3_Support_Guide.pdf]](% style="color:red" %) **If user has checked below steps and still can't solve the problem, please send us (support @ dragino.com) the screenshots for each step to check. They include:**
... ... @@ -502,19 +502,24 @@
502 502  * End Node traffic (from server UI) to shows end node activity in server. (Normally possible)
503 503  * End Node Keys screen shot shows in end node and server. so we can check if the keys are correct. (In most case, we found keys doesn't match, especially APP EUI)
504 504  
505 -**~1. End Device Join Screen shot, we can check:**
506 506  
615 +(% style="color:blue" %)**1. End Device Join Screen shot, we can check:**
616 +
507 507  * If the device is sending join request to server?
508 508  * What frequency the device is sending?
509 509  
620 +
510 510  [[image:image-20220526141308-33.png]]
511 511  
512 512  Console Output from End device to see the transmit frequency
513 513  
514 -User can run **AT+CFG **command to print configuration information.
515 515  
516 -* Is the device in OTAA mode or ABP mode? **AT+NJM=1** (OTAA mode), **AT+NJM=0** (ABP mode)
626 +User can run (% style="color:blue" %)**AT+CFG **(%%)command to print configuration information.
517 517  
628 +* Is the device in OTAA mode or ABP mode? (% style="color:red" %)**AT+NJM=1** (%%)(OTAA mode), (% style="color:red" %)**AT+NJM=0**(%%) (ABP mode)
629 +
630 +
631 +
518 518  [[image:image-20220526141612-36.png]]
519 519  
520 520  
... ... @@ -521,13 +521,17 @@
521 521  Console Output from End device to see the transmit frequency
522 522  
523 523  
524 -**2. Gateway packet traffic in gateway web or ssh. we can check:**
525 525  
639 +(% style="color:blue" %)**2. Gateway packet traffic in gateway web or ssh. we can check:**
640 +
526 526  * (((
527 527  If the gateway receive the Join request packet from sensor? (If this fail, check if the gateway and sensor works on the match frequency)
528 528  )))
529 529  * (((
530 530  If the gateway gets the Join Accept message from server and transmit it via LoRa?
646 +
647 +
648 +
531 531  )))
532 532  
533 533  [[image:image-20220526141739-37.png]]
... ... @@ -535,8 +535,9 @@
535 535  Console Output from Gateway to see packets between end node and server.
536 536  
537 537  
538 -**3. Gateway Traffic Page in LoRaWAN Server**
539 539  
657 +(% style="color:blue" %)**3. Gateway Traffic Page in LoRaWAN Server**
658 +
540 540  * (((
541 541  If the Join Request packet arrive the gateway traffic in server? If not, check the internet connection and gateway LoRaWAN server settings.
542 542  )))
... ... @@ -545,6 +545,9 @@
545 545  )))
546 546  * (((
547 547  If the Join Accept message are in correct frequency? If you set the server to use US915 band, and your end node and gateway is EU868, you will see the Join Accept message are in US915 band so no possible to Join success.
667 +
668 +
669 +
548 548  )))
549 549  
550 550  [[image:image-20220526141823-38.png||height="501" width="1144"]]
... ... @@ -552,18 +552,21 @@
552 552  The Traffic for the End node in the server, use TTNv3 as example
553 553  
554 554  
677 +
555 555  [[image:image-20220526141917-39.png]]
556 556  
557 557  The Traffic for the End node in the server, use TTNv3 as example
558 558  
559 559  
560 -**4. Data Page in LoRaWAN server**
561 561  
684 +(% style="color:blue" %)**4. Data Page in LoRaWAN server**
685 +
562 562  (((
563 563  (((
564 564  (((
565 565  If this data page shows the Join Request message from the end node? If not, most properly you have wrong settings in the keys. Keys in the server doesn't match the keys in End Node.
566 566  
691 +
567 567  [[image:image-20220526141956-40.png]]
568 568  )))
569 569  )))
... ... @@ -572,6 +572,7 @@
572 572  The data for the end device set in server
573 573  
574 574  
700 +
575 575  [[image:image-20220526142033-41.png]]
576 576  
577 577  Check if OTAA Keys match the keys in device
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0