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,18 +1,14 @@ 1 -**~ Table ofContents:**1 +**~ Contents:** 2 2 3 3 {{toc/}} 4 4 5 5 6 - 7 7 = 1. The Things Network-V3 = 8 8 8 +== 1.1 Introduction == 9 9 10 -== 1.1 Introduction ==10 +=== 1.1.1 What is The Things Network === 11 11 12 - 13 -=== 1.1.1 What is The Things Network === 14 - 15 - 16 16 ((( 17 17 The Things Network is a global collaborative Internet of Things ecosystem that creates networks, devices and solutions using LoRaWAN. 18 18 ))) ... ... @@ -20,13 +20,11 @@ 20 20 ((( 21 21 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. 22 22 23 - 24 24 25 25 ))) 26 26 27 -=== 1.1.2 22 +=== 1.1.2 Login or crate an account === 28 28 29 - 30 30 ((( 31 31 [[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. 32 32 ))) ... ... @@ -34,80 +34,63 @@ 34 34 ((( 35 35 Once you have an account,get started by following steps for adding Gateway,Device and Intergrations. 36 36 37 - 38 38 39 39 ))) 40 40 41 -=== 1.1.3 34 +=== 1.1.3 List the support products and Requirements === 42 42 43 - 44 44 LoRaWAN Gateway model: Existing Gateway 45 45 46 46 39 += 2. Gateway Registration for Semtech UDP = 47 47 48 -= 2. Gateway RegistrationforSemtechUDP=41 +== 2.1 Primary LoRaWAN Server == 49 49 50 - 51 -== 2.1 Primary LoRaWAN Server == 52 - 53 - 54 54 [[image:image-20220526134633-2.png||height="616" width="1323"]] 55 55 56 56 Register Gateway 57 57 58 58 59 - 60 60 [[image:image-20220526134826-4.png]] 61 61 62 62 Put Gateway ID 63 63 64 64 65 - 66 66 [[image:image-20220526134759-3.png]] 67 67 68 68 Choose Frequency Band 69 69 70 70 71 - 72 72 [[image:image-20220526134919-5.png]] 73 73 74 74 Show Status 75 75 76 76 63 +== 2.2 Secondary LoRaWAN Server == 77 77 78 -== 2.2 SecondaryLoRaWAN Server==65 +=== 2.2.1 Introduction === 79 79 80 - 81 -=== 2.2.1 Introduction === 82 - 83 - 84 84 The Dragino gateway has supports the Secondary server settings. 85 85 86 86 70 +=== 2.2.2 Below list the support products and Requirements: === 87 87 88 -=== 2.2.2 Below list the support products and Requirements: === 89 - 90 - 91 91 ((( 92 -1. 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]] 93 93 ))) 94 94 95 95 ((( 96 -2. 77 +2. Firmware version since :[[lgw~~-~~-build-v5.4.1644658774>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LIG16/Firmware/Release/]] 97 97 ))) 98 98 99 99 81 +=== 2.2.3 Example === 100 100 101 -=== 2.2.3 Example === 102 - 103 - 104 104 The following takes Helium as a Secondary LoRaWAN server as an example 105 105 106 106 86 +=== 2.2.4 Step 1: Download and Install the helium gateway-rs === 107 107 108 -=== 2.2.4 Step 1: Download and Install the helium gateway-rs === 109 - 110 - 111 111 The users is needing to download and install the helium gateway-rs then click the button of Save&Apply 112 112 113 113 [[image:image-20220526135049-6.png]] ... ... @@ -115,10 +115,8 @@ 115 115 Download and Install gateway-rs 116 116 117 117 95 +=== 2.2.5 Step 2: Back to Semtech UDP page === 118 118 119 -=== 2.2.5 Step 2: Back to Semtech UDP page === 120 - 121 - 122 122 Back to the page of Semtech UDP check the secondary server settings and click the button of Save&Apply 123 123 124 124 [[image:image-20220526135125-7.png]] ... ... @@ -126,41 +126,32 @@ 126 126 Configuration of helium 127 127 128 128 104 += 3. Gateway Registration for Basics Station = 129 129 130 -= 3. Gateway Registration for Basics Station =106 +== 3.1 Introduction == 131 131 132 - 133 -== 3.1 Introduction == 134 - 135 - 136 136 ((( 137 137 ((( 138 138 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 - 141 141 ))) 142 142 ))) 143 143 144 144 ((( 145 - (% style="color:blue" %)**Below list the support products and Requirements:**115 +**Below list the support products and Requirements:** 146 146 ))) 147 147 148 148 ((( 149 149 ((( 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]] 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]] 151 151 ))) 152 152 153 153 ((( 154 154 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 - 159 159 ))) 160 160 ))) 161 161 162 162 ((( 163 - (% style="color:blue" %)**What do you need to prepare**129 +**What do you need to prepare** 164 164 ))) 165 165 166 166 ((( ... ... @@ -167,14 +167,12 @@ 167 167 ((( 168 168 A gateway that can access the internet normally 169 169 170 - 171 171 172 172 ))) 173 173 ))) 174 174 175 -== 3.2 :Add Gateway ==140 +== 3.2 Step 1. Add Gateway == 176 176 177 - 178 178 ((( 179 179 ((( 180 180 The example for **EU** ... ... @@ -190,8 +190,6 @@ 190 190 ((( 191 191 ((( 192 192 Following picture is the successful added. 193 - 194 - 195 195 ))) 196 196 ))) 197 197 ... ... @@ -200,66 +200,52 @@ 200 200 Add Gateway 201 201 202 202 165 +== 3.3 Step 2. Create the API key == 203 203 204 -== 3.3 Step 2: Create the API key == 205 - 206 - 207 207 user need to create the CUPS API key and LNS API key. 208 208 209 - 210 210 [[image:image-20220526135349-9.png]] 211 211 212 212 Create CUPS API key 213 213 214 214 215 - 216 216 [[image:image-20220526135428-10.png]] 217 217 218 218 Create LNS API key 219 219 220 - 221 221 (% style="color:red" %)**Note : Please copy the API key.** 222 222 223 223 181 +== 3.4 Step 3. Update the gateway setting == 224 224 225 -== 3.4 Step 3: Update the gateway setting == 226 - 227 - 228 228 In the LoRa Basics Station LNS Authentication Key field, paste the API key you generated in the previous step. 229 229 230 - 231 231 [[image:image-20220526135528-11.png]] 232 232 233 233 paste the API key 234 234 235 235 190 +== 3.5 Step 4. Access the gateway GUI == 236 236 237 -== 3.5 Step 4: Access the gateway GUI == 238 - 239 - 240 240 User need to update the API key and install the Certificate 241 241 242 - 243 243 [[image:image-20220526135601-12.png]] 244 244 245 245 Access the gateway GUI 246 246 247 247 199 +== 3.6 Step 5. Configure Station == 248 248 249 -== 3.6 Step 5: Configure Station == 250 - 251 - 252 252 User need to input Server URI, Server CUPS Key and LNS Key, as well as install CUPS certificate. 253 253 203 +**just to clarify.** 254 254 255 -(% style="color:blue" %)**just to clarify:** 256 - 257 257 (% class="box" %) 258 258 ((( 259 - CUPS Server URI ~-~-> 260 - CUPS Authorization Key ~-~-> 261 - LNS Authorization Key ~-~-> 262 - CUPS certificate 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) 263 263 ))) 264 264 265 265 [[image:image-20220526135654-13.png]] ... ... @@ -267,41 +267,32 @@ 267 267 Congfigure Station 268 268 269 269 218 +== 3.7 Start Station == 270 270 271 -== 3.7 Start Station == 272 - 273 - 274 274 ((( 275 275 When the user has finished the configuration,Please click Sace&Apply to start station to connect The Things Network. 276 276 277 - 278 278 279 279 ))) 280 280 281 -== 3.8 226 +== 3.8 Siccessful Connection == 282 282 283 - 284 284 If user completes the above steps,which will see live date in the TTN. 285 285 286 - 287 287 [[image:image-20220526135734-14.png]] 288 288 289 289 Station live date 290 290 291 291 235 +== 3.9 Trouble Shooting == 292 292 293 -== 3.9 Trouble Shooting == 294 - 295 - 296 296 User can check the station log in the logread/system log page. 297 297 298 - 299 299 [[image:image-20220526135845-15.png]] 300 300 301 301 Station Log 302 302 303 303 304 - 305 305 and recode the station log in the system/Recode log page. 306 306 307 307 [[image:image-20220526135940-16.png]] ... ... @@ -309,10 +309,8 @@ 309 309 Recore Log 310 310 311 311 251 += 4. Configure node connection to TTNv3 = 312 312 313 -= 4. Configure node connection to TTNv3 = 314 - 315 - 316 316 ((( 317 317 ((( 318 318 Following is an example for how to join the TTN v3 LoRaWAN Network. ... ... @@ -329,14 +329,12 @@ 329 329 ((( 330 330 We take LES01 as an example. 331 331 332 - 333 333 334 334 ))) 335 335 ))) 336 336 337 -== 4.1 273 +== 4.1 Step1 == 338 338 339 - 340 340 ((( 341 341 ((( 342 342 Create a device in TTN with the OTAA keys from LSE01. ... ... @@ -360,15 +360,11 @@ 360 360 [[image:image-20220526140044-18.png]] 361 361 362 362 298 +== 4.2 Step2 == 363 363 364 -== 4.2 Step2 == 365 - 366 - 367 367 ((( 368 368 ((( 369 369 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 - 372 372 ))) 373 373 ))) 374 374 ... ... @@ -375,45 +375,34 @@ 375 375 [[image:image-20220526140132-19.png]] 376 376 377 377 309 +== 4.3 Step3 == 378 378 379 -== 4.3 Step3 == 380 - 381 - 382 382 Add APP EUI in the application: 383 383 384 - 385 385 [[image:image-20220526140205-20.png]] 386 386 387 387 316 +== 4.4 Step4 == 388 388 389 -== 4.4 Step4 == 390 - 391 - 392 392 Add APP KEY and DEV EUI: 393 393 394 - 395 395 [[image:image-20220526140251-21.png]] 396 396 397 397 323 += 5. TTN V3 integrated into MQTT server = 398 398 399 -= 5. TTN V3 integratedintoMQTT server=325 +== 5.1 Introduction == 400 400 401 - 402 -== 5.1 Introduction == 403 - 404 - 405 405 ((( 406 406 ((( 407 407 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. 408 408 409 - 410 410 411 411 ))) 412 412 ))) 413 413 414 -== 5.2 335 +== 5.2 Create device steps at MQTT == 415 415 416 - 417 417 ((( 418 418 ((( 419 419 The user creates a new API KEY after creating a device on TTN V3. ... ... @@ -429,8 +429,6 @@ 429 429 ((( 430 430 ((( 431 431 Fill in Broker Address and Broker port. 432 - 433 - 434 434 ))) 435 435 ))) 436 436 ... ... @@ -439,10 +439,8 @@ 439 439 Fill in the username and password into MQTT. 440 440 441 441 442 - 443 443 [[image:image-20220526140420-23.png]] 444 444 445 - 446 446 The Application Server publishes uplink traffic on the following topics: 447 447 448 448 (% class="box" %) ... ... @@ -459,18 +459,13 @@ 459 459 ))) 460 460 461 461 ((( 462 - 463 - 464 464 ((( 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 - 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}. 468 468 ))) 469 469 ))) 470 470 471 471 [[image:image-20220526140452-24.png]] 472 472 473 - 474 474 ((( 475 475 ((( 476 476 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. ... ... @@ -487,11 +487,7 @@ 487 487 488 488 ((( 489 489 ((( 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 - 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. 495 495 ))) 496 496 ))) 497 497 ... ... @@ -505,23 +505,17 @@ 505 505 506 506 ((( 507 507 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 - 510 510 ))) 511 511 512 512 ((( 513 -(% style="color:red" %)**Note**: **Use this handy tool to convert hexadecimal to base64.** 514 - 515 - 418 +**Note**: Use this handy tool to convert hexadecimal to base64. 516 516 ))) 517 517 518 518 [[image:image-20220526140936-27.png]] 519 519 520 520 424 +== 5.3 Send Downlink message == 521 521 522 -== 5.3 Send Downlink message == 523 - 524 - 525 525 ((( 526 526 How to configure downlink in TTN V3? 527 527 ))) ... ... @@ -531,9 +531,7 @@ 531 531 ))) 532 532 533 533 ((( 534 -(% style="color:blue" %)**Downlink command: 01 00 00 5A** 535 - 536 - 435 +Downlink command:01 00 00 5A 537 537 ))) 538 538 539 539 [[image:image-20220526141021-28.png]] ... ... @@ -541,7 +541,6 @@ 541 541 downlink 542 542 543 543 544 - 545 545 After sending, you can view it in live data. 546 546 547 547 [[image:image-20220526141052-29.png]] ... ... @@ -549,15 +549,12 @@ 549 549 downlink 550 550 551 551 552 - 553 553 ((( 554 554 When downlink is successfully sent, the downlink information can be received on the serial port. 555 555 ))) 556 556 557 557 ((( 558 -(% style="color:red" %)**Note**:** If the downlink byte sent is longer, the number of bytes will be displayed.** 559 - 560 - 455 +**Note**: If the downlink byte sent is longer, the number of bytes will be displayed. 561 561 ))) 562 562 563 563 [[image:image-20220526141116-30.png]] ... ... @@ -573,13 +573,13 @@ 573 573 574 574 ((( 575 575 ((( 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**471 +If the equipment uses CLASS A. You can set **AT+RPL=2** or send the downlink command: **2102** 577 577 ))) 578 578 ))) 579 579 580 580 ((( 581 581 ((( 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**477 +If the equipment uses CLASS C. You can set** AT+RPL=4** or send the downlink command: **2104** 583 583 ))) 584 584 ))) 585 585 ... ... @@ -586,8 +586,6 @@ 586 586 ((( 587 587 ((( 588 588 When the device successfully receives the downlink, the server will receive a confirmation packet of 00. 589 - 590 - 591 591 ))) 592 592 ))) 593 593 ... ... @@ -596,10 +596,8 @@ 596 596 downlink 597 597 598 598 492 += 6. Request Remote Support = 599 599 600 -= 6. Request Remote Support = 601 - 602 - 603 603 ((( 604 604 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. 605 605 \\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:** ... ... @@ -611,24 +611,19 @@ 611 611 * End Node traffic (from server UI) to shows end node activity in server. (Normally possible) 612 612 * 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) 613 613 505 +**~1. End Device Join Screen shot, we can check:** 614 614 615 -(% style="color:blue" %)**1. End Device Join Screen shot, we can check:** 616 - 617 617 * If the device is sending join request to server? 618 618 * What frequency the device is sending? 619 619 620 - 621 621 [[image:image-20220526141308-33.png]] 622 622 623 623 Console Output from End device to see the transmit frequency 624 624 514 +User can run **AT+CFG **command to print configuration information. 625 625 626 - Usercanrun(%style="color:blue"%)**AT+CFG**(%%)commandtoprintconfiguration information.516 +* Is the device in OTAA mode or ABP mode? **AT+NJM=1** (OTAA mode), **AT+NJM=0** (ABP mode) 627 627 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 - 632 632 [[image:image-20220526141612-36.png]] 633 633 634 634 ... ... @@ -635,17 +635,13 @@ 635 635 Console Output from End device to see the transmit frequency 636 636 637 637 524 +**2. Gateway packet traffic in gateway web or ssh. we can check:** 638 638 639 -(% style="color:blue" %)**2. Gateway packet traffic in gateway web or ssh. we can check:** 640 - 641 641 * ((( 642 642 If the gateway receive the Join request packet from sensor? (If this fail, check if the gateway and sensor works on the match frequency) 643 643 ))) 644 644 * ((( 645 645 If the gateway gets the Join Accept message from server and transmit it via LoRa? 646 - 647 - 648 - 649 649 ))) 650 650 651 651 [[image:image-20220526141739-37.png]] ... ... @@ -653,9 +653,8 @@ 653 653 Console Output from Gateway to see packets between end node and server. 654 654 655 655 538 +**3. Gateway Traffic Page in LoRaWAN Server** 656 656 657 -(% style="color:blue" %)**3. Gateway Traffic Page in LoRaWAN Server** 658 - 659 659 * ((( 660 660 If the Join Request packet arrive the gateway traffic in server? If not, check the internet connection and gateway LoRaWAN server settings. 661 661 ))) ... ... @@ -664,9 +664,6 @@ 664 664 ))) 665 665 * ((( 666 666 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 - 670 670 ))) 671 671 672 672 [[image:image-20220526141823-38.png||height="501" width="1144"]] ... ... @@ -674,21 +674,18 @@ 674 674 The Traffic for the End node in the server, use TTNv3 as example 675 675 676 676 677 - 678 678 [[image:image-20220526141917-39.png]] 679 679 680 680 The Traffic for the End node in the server, use TTNv3 as example 681 681 682 682 560 +**4. Data Page in LoRaWAN server** 683 683 684 -(% style="color:blue" %)**4. Data Page in LoRaWAN server** 685 - 686 686 ((( 687 687 ((( 688 688 ((( 689 689 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. 690 690 691 - 692 692 [[image:image-20220526141956-40.png]] 693 693 ))) 694 694 ))) ... ... @@ -697,7 +697,6 @@ 697 697 The data for the end device set in server 698 698 699 699 700 - 701 701 [[image:image-20220526142033-41.png]] 702 702 703 703 Check if OTAA Keys match the keys in device