Changes for page Notes for TTN
Last modified by Mengting Qiu on 2024/08/20 17:29
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,4 +1,4 @@ 1 -**~ Contents:** 1 +**~ Table of Contents:** 2 2 3 3 {{toc/}} 4 4 ... ... @@ -6,10 +6,13 @@ 6 6 7 7 = 1. The Things Network-V3 = 8 8 9 -== 1.1 Introduction == 10 10 11 -== =1.1.1Whats The ThingsNetwork===10 +== 1.1 Introduction == 12 12 12 + 13 +=== 1.1.1 What is The Things Network === 14 + 15 + 13 13 ((( 14 14 The Things Network is a global collaborative Internet of Things ecosystem that creates networks, devices and solutions using LoRaWAN. 15 15 ))) ... ... @@ -17,11 +17,13 @@ 17 17 ((( 18 18 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. 19 19 23 + 20 20 21 21 ))) 22 22 23 -=== 1.1.2 Login or crate an account === 27 +=== 1.1.2 Login or crate an account === 24 24 29 + 25 25 ((( 26 26 [[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. 27 27 ))) ... ... @@ -29,63 +29,80 @@ 29 29 ((( 30 30 Once you have an account,get started by following steps for adding Gateway,Device and Intergrations. 31 31 37 + 32 32 33 33 ))) 34 34 35 -=== 1.1.3 List the support products and Requirements === 41 +=== 1.1.3 List the support products and Requirements === 36 36 43 + 37 37 LoRaWAN Gateway model: Existing Gateway 38 38 39 39 40 -= 2. Gateway Registration for Semtech UDP = 41 41 42 -= =2.1PrimaryLoRaWANServer==48 += 2. Gateway Registration for Semtech UDP = 43 43 50 + 51 +== 2.1 Primary LoRaWAN Server == 52 + 53 + 44 44 [[image:image-20220526134633-2.png||height="616" width="1323"]] 45 45 46 46 Register Gateway 47 47 48 48 59 + 49 49 [[image:image-20220526134826-4.png]] 50 50 51 51 Put Gateway ID 52 52 53 53 65 + 54 54 [[image:image-20220526134759-3.png]] 55 55 56 56 Choose Frequency Band 57 57 58 58 71 + 59 59 [[image:image-20220526134919-5.png]] 60 60 61 61 Show Status 62 62 63 63 64 -== 2.2 Secondary LoRaWAN Server == 65 65 66 -== =2.2.1Introduction ===78 +== 2.2 Secondary LoRaWAN Server == 67 67 80 + 81 +=== 2.2.1 Introduction === 82 + 83 + 68 68 The Dragino gateway has supports the Secondary server settings. 69 69 70 70 71 -=== 2.2.2 Below list the support products and Requirements: === 72 72 88 +=== 2.2.2 Below list the support products and Requirements: === 89 + 90 + 73 73 ((( 74 - ~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]] 75 75 ))) 76 76 77 77 ((( 78 -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/]] 79 79 ))) 80 80 81 81 82 -=== 2.2.3 Example === 83 83 101 +=== 2.2.3 Example === 102 + 103 + 84 84 The following takes Helium as a Secondary LoRaWAN server as an example 85 85 86 86 87 -=== 2.2.4 Step 1: Download and Install the helium gateway-rs === 88 88 108 +=== 2.2.4 Step 1: Download and Install the helium gateway-rs === 109 + 110 + 89 89 The users is needing to download and install the helium gateway-rs then click the button of Save&Apply 90 90 91 91 [[image:image-20220526135049-6.png]] ... ... @@ -93,8 +93,10 @@ 93 93 Download and Install gateway-rs 94 94 95 95 96 -=== 2.2.5 Step 2: Back to Semtech UDP page === 97 97 119 +=== 2.2.5 Step 2: Back to Semtech UDP page === 120 + 121 + 98 98 Back to the page of Semtech UDP check the secondary server settings and click the button of Save&Apply 99 99 100 100 [[image:image-20220526135125-7.png]] ... ... @@ -102,32 +102,41 @@ 102 102 Configuration of helium 103 103 104 104 105 -= 3. Gateway Registration for Basics Station = 106 106 107 -= =3.1Introduction ==130 += 3. Gateway Registration for Basics Station = 108 108 132 + 133 +== 3.1 Introduction == 134 + 135 + 109 109 ((( 110 110 ((( 111 111 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 + 112 112 ))) 113 113 ))) 114 114 115 115 ((( 116 -**Below list the support products and Requirements:** 145 +(% style="color:blue" %)**Below list the support products and Requirements:** 117 117 ))) 118 118 119 119 ((( 120 120 ((( 121 - ~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]] 122 122 ))) 123 123 124 124 ((( 125 125 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 + 126 126 ))) 127 127 ))) 128 128 129 129 ((( 130 -**What do you need to prepare** 163 +(% style="color:blue" %)**What do you need to prepare** 131 131 ))) 132 132 133 133 ((( ... ... @@ -134,12 +134,14 @@ 134 134 ((( 135 135 A gateway that can access the internet normally 136 136 170 + 137 137 138 138 ))) 139 139 ))) 140 140 141 -== 3.2 Step 1 .Add Gateway ==175 +== 3.2 Step 1: Add Gateway == 142 142 177 + 143 143 ((( 144 144 ((( 145 145 The example for **EU** ... ... @@ -155,6 +155,8 @@ 155 155 ((( 156 156 ((( 157 157 Following picture is the successful added. 193 + 194 + 158 158 ))) 159 159 ))) 160 160 ... ... @@ -163,52 +163,66 @@ 163 163 Add Gateway 164 164 165 165 166 -== 3.3 Step 2. Create the API key == 167 167 204 +== 3.3 Step 2: Create the API key == 205 + 206 + 168 168 user need to create the CUPS API key and LNS API key. 169 169 209 + 170 170 [[image:image-20220526135349-9.png]] 171 171 172 172 Create CUPS API key 173 173 174 174 215 + 175 175 [[image:image-20220526135428-10.png]] 176 176 177 177 Create LNS API key 178 178 220 + 179 179 (% style="color:red" %)**Note : Please copy the API key.** 180 180 181 181 182 -== 3.4 Step 3. Update the gateway setting == 183 183 225 +== 3.4 Step 3: Update the gateway setting == 226 + 227 + 184 184 In the LoRa Basics Station LNS Authentication Key field, paste the API key you generated in the previous step. 185 185 230 + 186 186 [[image:image-20220526135528-11.png]] 187 187 188 188 paste the API key 189 189 190 190 191 -== 3.5 Step 4. Access the gateway GUI == 192 192 237 +== 3.5 Step 4: Access the gateway GUI == 238 + 239 + 193 193 User need to update the API key and install the Certificate 194 194 242 + 195 195 [[image:image-20220526135601-12.png]] 196 196 197 197 Access the gateway GUI 198 198 199 199 200 -== 3.6 Step 5. Configure Station == 201 201 249 +== 3.6 Step 5: Configure Station == 250 + 251 + 202 202 User need to input Server URI, Server CUPS Key and LNS Key, as well as install CUPS certificate. 203 203 204 -**just to clarify.** 205 205 255 +(% style="color:blue" %)**just to clarify:** 256 + 206 206 (% class="box" %) 207 207 ((( 208 - CUPS Server URI ~-~-> Server Adress 209 - CUPS Authorization Key ~-~-> Server CUPS API Key 210 - LNS Authorization Key ~-~-> Server LNS API Key 211 - 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) 212 212 ))) 213 213 214 214 [[image:image-20220526135654-13.png]] ... ... @@ -216,32 +216,41 @@ 216 216 Congfigure Station 217 217 218 218 219 -== 3.7 Start Station == 220 220 271 +== 3.7 Start Station == 272 + 273 + 221 221 ((( 222 222 When the user has finished the configuration,Please click Sace&Apply to start station to connect The Things Network. 223 223 277 + 224 224 225 225 ))) 226 226 227 -== 3.8 Siccessful Connection == 281 +== 3.8 Siccessful Connection == 228 228 283 + 229 229 If user completes the above steps,which will see live date in the TTN. 230 230 286 + 231 231 [[image:image-20220526135734-14.png]] 232 232 233 233 Station live date 234 234 235 235 236 -== 3.9 Trouble Shooting == 237 237 293 +== 3.9 Trouble Shooting == 294 + 295 + 238 238 User can check the station log in the logread/system log page. 239 239 298 + 240 240 [[image:image-20220526135845-15.png]] 241 241 242 242 Station Log 243 243 244 244 304 + 245 245 and recode the station log in the system/Recode log page. 246 246 247 247 [[image:image-20220526135940-16.png]] ... ... @@ -249,8 +249,10 @@ 249 249 Recore Log 250 250 251 251 252 -= 4. Configure node connection to TTNv3 = 253 253 313 += 4. Configure node connection to TTNv3 = 314 + 315 + 254 254 ((( 255 255 ((( 256 256 Following is an example for how to join the TTN v3 LoRaWAN Network. ... ... @@ -267,12 +267,14 @@ 267 267 ((( 268 268 We take LES01 as an example. 269 269 332 + 270 270 271 271 ))) 272 272 ))) 273 273 274 -== 4.1 Step1 == 337 +== 4.1 Step1 == 275 275 339 + 276 276 ((( 277 277 ((( 278 278 Create a device in TTN with the OTAA keys from LSE01. ... ... @@ -296,11 +296,15 @@ 296 296 [[image:image-20220526140044-18.png]] 297 297 298 298 299 -== 4.2 Step2 == 300 300 364 +== 4.2 Step2 == 365 + 366 + 301 301 ((( 302 302 ((( 303 303 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 + 304 304 ))) 305 305 ))) 306 306 ... ... @@ -307,34 +307,45 @@ 307 307 [[image:image-20220526140132-19.png]] 308 308 309 309 310 -== 4.3 Step3 == 311 311 379 +== 4.3 Step3 == 380 + 381 + 312 312 Add APP EUI in the application: 313 313 384 + 314 314 [[image:image-20220526140205-20.png]] 315 315 316 316 317 -== 4.4 Step4 == 318 318 389 +== 4.4 Step4 == 390 + 391 + 319 319 Add APP KEY and DEV EUI: 320 320 394 + 321 321 [[image:image-20220526140251-21.png]] 322 322 323 323 324 -= 5. TTN V3 integrated into MQTT server = 325 325 326 -= =5.1Introduction ==399 += 5. TTN V3 integrated into MQTT server = 327 327 401 + 402 +== 5.1 Introduction == 403 + 404 + 328 328 ((( 329 329 ((( 330 330 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. 331 331 409 + 332 332 333 333 ))) 334 334 ))) 335 335 336 -== 5.2 Create device steps at MQTT == 414 +== 5.2 Create device steps at MQTT == 337 337 416 + 338 338 ((( 339 339 ((( 340 340 The user creates a new API KEY after creating a device on TTN V3. ... ... @@ -350,6 +350,8 @@ 350 350 ((( 351 351 ((( 352 352 Fill in Broker Address and Broker port. 432 + 433 + 353 353 ))) 354 354 ))) 355 355 ... ... @@ -358,8 +358,10 @@ 358 358 Fill in the username and password into MQTT. 359 359 360 360 442 + 361 361 [[image:image-20220526140420-23.png]] 362 362 445 + 363 363 The Application Server publishes uplink traffic on the following topics: 364 364 365 365 (% class="box" %) ... ... @@ -376,13 +376,18 @@ 376 376 ))) 377 377 378 378 ((( 462 + 463 + 379 379 ((( 380 -**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 + 381 381 ))) 382 382 ))) 383 383 384 384 [[image:image-20220526140452-24.png]] 385 385 473 + 386 386 ((( 387 387 ((( 388 388 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. ... ... @@ -399,7 +399,11 @@ 399 399 400 400 ((( 401 401 ((( 402 -**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 + 403 403 ))) 404 404 ))) 405 405 ... ... @@ -413,17 +413,23 @@ 413 413 414 414 ((( 415 415 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 + 416 416 ))) 417 417 418 418 ((( 419 -**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 + 420 420 ))) 421 421 422 422 [[image:image-20220526140936-27.png]] 423 423 424 424 425 -== 5.3 Send Downlink message == 426 426 522 +== 5.3 Send Downlink message == 523 + 524 + 427 427 ((( 428 428 How to configure downlink in TTN V3? 429 429 ))) ... ... @@ -433,7 +433,9 @@ 433 433 ))) 434 434 435 435 ((( 436 -Downlink command:01 00 00 5A 534 +(% style="color:blue" %)**Downlink command: 01 00 00 5A** 535 + 536 + 437 437 ))) 438 438 439 439 [[image:image-20220526141021-28.png]] ... ... @@ -441,6 +441,7 @@ 441 441 downlink 442 442 443 443 544 + 444 444 After sending, you can view it in live data. 445 445 446 446 [[image:image-20220526141052-29.png]] ... ... @@ -448,12 +448,15 @@ 448 448 downlink 449 449 450 450 552 + 451 451 ((( 452 452 When downlink is successfully sent, the downlink information can be received on the serial port. 453 453 ))) 454 454 455 455 ((( 456 -**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 + 457 457 ))) 458 458 459 459 [[image:image-20220526141116-30.png]] ... ... @@ -469,13 +469,13 @@ 469 469 470 470 ((( 471 471 ((( 472 -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** 473 473 ))) 474 474 ))) 475 475 476 476 ((( 477 477 ((( 478 -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** 479 479 ))) 480 480 ))) 481 481 ... ... @@ -482,6 +482,8 @@ 482 482 ((( 483 483 ((( 484 484 When the device successfully receives the downlink, the server will receive a confirmation packet of 00. 589 + 590 + 485 485 ))) 486 486 ))) 487 487 ... ... @@ -490,8 +490,10 @@ 490 490 downlink 491 491 492 492 493 -= 6. Request Remote Support = 494 494 600 += 6. Request Remote Support = 601 + 602 + 495 495 ((( 496 496 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. 497 497 \\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:** ... ... @@ -503,19 +503,24 @@ 503 503 * End Node traffic (from server UI) to shows end node activity in server. (Normally possible) 504 504 * 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) 505 505 506 -**~1. End Device Join Screen shot, we can check:** 507 507 615 +(% style="color:blue" %)**1. End Device Join Screen shot, we can check:** 616 + 508 508 * If the device is sending join request to server? 509 509 * What frequency the device is sending? 510 510 620 + 511 511 [[image:image-20220526141308-33.png]] 512 512 513 513 Console Output from End device to see the transmit frequency 514 514 515 -User can run **AT+CFG **command to print configuration information. 516 516 517 - * IsthedeviceinOTAAmoder ABP mode?**AT+NJM=1**OTAA mode),**AT+NJM=0**(ABPmode)626 +User can run (% style="color:blue" %)**AT+CFG **(%%)command to print configuration information. 518 518 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 + 519 519 [[image:image-20220526141612-36.png]] 520 520 521 521 ... ... @@ -522,13 +522,17 @@ 522 522 Console Output from End device to see the transmit frequency 523 523 524 524 525 -**2. Gateway packet traffic in gateway web or ssh. we can check:** 526 526 639 +(% style="color:blue" %)**2. Gateway packet traffic in gateway web or ssh. we can check:** 640 + 527 527 * ((( 528 528 If the gateway receive the Join request packet from sensor? (If this fail, check if the gateway and sensor works on the match frequency) 529 529 ))) 530 530 * ((( 531 531 If the gateway gets the Join Accept message from server and transmit it via LoRa? 646 + 647 + 648 + 532 532 ))) 533 533 534 534 [[image:image-20220526141739-37.png]] ... ... @@ -536,8 +536,9 @@ 536 536 Console Output from Gateway to see packets between end node and server. 537 537 538 538 539 -**3. Gateway Traffic Page in LoRaWAN Server** 540 540 657 +(% style="color:blue" %)**3. Gateway Traffic Page in LoRaWAN Server** 658 + 541 541 * ((( 542 542 If the Join Request packet arrive the gateway traffic in server? If not, check the internet connection and gateway LoRaWAN server settings. 543 543 ))) ... ... @@ -546,6 +546,9 @@ 546 546 ))) 547 547 * ((( 548 548 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 + 549 549 ))) 550 550 551 551 [[image:image-20220526141823-38.png||height="501" width="1144"]] ... ... @@ -553,18 +553,21 @@ 553 553 The Traffic for the End node in the server, use TTNv3 as example 554 554 555 555 677 + 556 556 [[image:image-20220526141917-39.png]] 557 557 558 558 The Traffic for the End node in the server, use TTNv3 as example 559 559 560 560 561 -**4. Data Page in LoRaWAN server** 562 562 684 +(% style="color:blue" %)**4. Data Page in LoRaWAN server** 685 + 563 563 ((( 564 564 ((( 565 565 ((( 566 566 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. 567 567 691 + 568 568 [[image:image-20220526141956-40.png]] 569 569 ))) 570 570 ))) ... ... @@ -573,6 +573,7 @@ 573 573 The data for the end device set in server 574 574 575 575 700 + 576 576 [[image:image-20220526142033-41.png]] 577 577 578 578 Check if OTAA Keys match the keys in device