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