Changes for page PG1302 -- LoRaWAN Concentrator User Manual
Last modified by Kilight Cao on 2024/06/22 10:43
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 9 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -20,7 +20,7 @@ 20 20 21 21 22 22 ((( 23 -The PG1302 is a (% style="color: green" %)**multi-channel high-performance transmitter/receiver**(%%) designed to simultaneously receive several LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection between a central wireless data concentrator and a massive amount of wireless end-points spread over a very wide range of distances.23 +The PG1302 is a (% style="color:blue" %)**multi-channel high-performance transmitter/receiver**(%%) designed to simultaneously receive several LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection between a central wireless data concentrator and a massive amount of wireless end-points spread over a very wide range of distances. 24 24 ))) 25 25 26 26 ((( ... ... @@ -28,7 +28,7 @@ 28 28 ))) 29 29 30 30 ((( 31 -PG1302 is fully compatible with (% style="color: green" %)**RPi3/4 or Tinker Board**(%%), users can use the pre-build OS from Dragino to set up and easy to use the module by Web UI. Or install the raw LoRaWAN driver in the existing OS.31 +PG1302 is fully compatible with (% style="color:blue" %)**RPi3/4 or Tinker Board**(%%), users can use the pre-build OS from Dragino to set up and easy to use the module by Web UI. Or install the raw LoRaWAN driver in the existing OS. 32 32 ))) 33 33 34 34 ... ... @@ -117,10 +117,12 @@ 117 117 * Flash SD card with Dragino pre-build image which supports Web UI. 118 118 * Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in existing RPi OS. 119 119 120 + 120 120 **TinkerBoard2/2S, ** 121 121 122 122 * Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS. 123 123 125 + 124 124 **Orange Pi PC/PC PLUS.** 125 125 126 126 * Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS. ... ... @@ -262,7 +262,6 @@ 262 262 263 263 Show system log. 264 264 265 - 266 266 [[image:1651745003470-264.png||height="477" width="621"]] 267 267 268 268 ... ... @@ -271,7 +271,6 @@ 271 271 272 272 **Record the system log.** 273 273 274 - 275 275 [[image:1651745069814-662.png||height="144" width="621"]] 276 276 277 277 ... ... @@ -312,7 +312,7 @@ 312 312 313 313 (% class="box" %) 314 314 ((( 315 - pi@raspberrypi:~~$ cat /etc/os-release 315 +**~ pi@raspberrypi:~~$ cat /etc/os-release 316 316 PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)" 317 317 NAME="Raspbian GNU/Linux" 318 318 VERSION_ID="8" ... ... @@ -321,18 +321,31 @@ 321 321 ID_LIKE=debian 322 322 HOME_URL="http:~/~/www.raspbian.org/" 323 323 SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums" 324 - BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs" 324 + BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"** 325 325 326 326 327 327 ))) 328 328 329 329 330 -5.2 Select the mode of connection to the server 330 +== 5.2 Select the mode of connection to the server == 331 331 332 332 333 - == 5.2 GetGateway IDspberryand inputthis inTTN v3 ==333 +The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode. 334 334 335 +The User can choose one of the methods as the connection mode. 335 335 337 + 338 +**~1. Semtech UDP Mode ~-~-> 5.2.1** 339 + 340 +**2. Basic Station Mode ~-~-> 5.2.2** 341 + 342 + 343 +=== 5.2.1 Semtech UDP Mode === 344 + 345 + 346 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 347 + 348 + 336 336 In RPI, run the below command to get a Gateway ID 337 337 338 338 (% class="box infomessage" %) ... ... @@ -347,6 +347,10 @@ 347 347 ((( 348 348 We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the gateway ID: b827ebxxxxbcffff. Input this to TTN v3. Make sure to select legacy packet forwarder. 349 349 363 + 364 + 365 +==== **b). Input this Gateway EUI to the TTN-Stack** ==== 366 + 350 350 351 351 ))) 352 352 ))) ... ... @@ -356,18 +356,20 @@ 356 356 [[image:1651745306744-481.png||height="478" width="621"]] 357 357 358 358 359 -After set up, the status should show not connected as below: 360 360 377 +==== **c). After Register, the status should show not connected as below:** ==== 378 + 379 + 361 361 [[image:1651745366987-458.png||height="363" width="621"]] 362 362 363 363 364 -=== 5.2.1 Download and install LoRaWAN packet forwarder === 365 365 384 +==== **d). Enable SPI and I2C on your device** ==== 366 366 367 -Enable SPI and I2C first: 368 368 369 - a) SPI needstobe enabledontheRaspberryPi387 +**the below example is using Raspberry 4B.** 370 370 389 + 371 371 Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window 372 372 373 373 [[image:1651745476754-240.png||height="234" width="629"]] ... ... @@ -380,35 +380,38 @@ 380 380 381 381 382 382 383 - InRPI,Fist:Enter the root account:402 +==== **e). Access the root account:** ==== 384 384 385 385 ((( 386 386 [[image:1651745583363-614.png||height="151" width="732"]] 387 387 407 + 388 388 389 389 ))) 390 390 411 +==== **f). Modify the configuration of FWD** ==== 391 391 392 -=== 5.2.2 Select the appropriate device version to download: === 393 393 414 +((( 415 +After installation, user can find the configuration file in** (% style="color:#0000ff" %)/etc/lora/ (%%)**Replace the gateway ID we got above to the (% style="color:#0000ff" %)**gateway_ID** (%%)in file (% style="color:#0000ff" %)**local_conf.json.** 416 +))) 394 394 395 - 396 396 ((( 397 - 419 +The default LoRaWAN server points to localhost, user need to put the correct server address to the server_address field in file (% style="color:#0000ff" %)**local_conf.json**(%%), like below. 398 398 399 399 400 - 401 -))) 422 +the User can find the lora configuration directory in (% style="color:#0000ff" %)**/etc/lora/**(%%) there are the cfg-302 directory and the global_conf.json, and local_conf.json files. 402 402 403 -=== 5.2.3 Config Gateway ID, Frequency Band and Server address === 424 +/etc/lora/ 425 +├── cfg-302 ~-~--> global configuration file 426 +├── devskey ~-~--> Database 427 +├── global_conf.json ~-~--> Frequency plan for current applications 428 +└── local_conf.json ~-~--> Local fwd configuration 404 404 430 +At default, the users need to change two configurations file: global_conf.json and local_conf.json. 405 405 406 -((( 407 -After installation, user can find the configuration file in** (% style="color:#0000ff" %)/etc/lora/ (%%)**Replace the gateway ID we got above to the (% style="color:#0000ff" %)**gateway_ID** (%%)in file (% style="color:#0000ff" %)**local_conf.json.** 408 -))) 409 409 410 -((( 411 -The default LoRaWAN server points to localhost, user need to put the correct server address to the server_address field in file (% style="color:#0000ff" %)**local_conf.json**(%%), like below. 433 +===== **1.) Configure gateway EUI and server address, port for fwd** ===== 412 412 413 413 414 414 ))) ... ... @@ -416,24 +416,30 @@ 416 416 [[image:1651745709709-887.png||height="820" width="621"]] 417 417 418 418 419 -User can find the TTN v3 server address from :[[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]441 +**Note: Users can find the TTN v3 server address from [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]** 420 420 421 -And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file. 422 422 444 +===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** ===== 445 + 446 + 447 +the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file. 448 + 423 423 [[image:1651745838008-820.png||height="650" width="621"]] 424 424 425 425 426 - *If user want to change to other frequency bands, User can copy the file from(% style="color:#0000ff" %)** /etc/lora/cfg-302**(%%) ** **and put it into** (% style="color:#0000ff" %)/etc/lora/global_conf.json(%%).**452 +If the user wants to change to other frequency bands, the User can copy the file from(% style="color:#0000ff" %)** /etc/lora/cfg-302**(%%) ** **and put it into** (% style="color:#0000ff" %)/etc/lora/global_conf.json(%%).** 427 427 428 -** ~ 1). Choseyour needthe nameofregionrequency.**454 +**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //** 429 429 430 430 431 -[[image:1651745867516-322.png||height="83" width="740"]] 432 432 458 +====== **Selecting the appropriate frequency plan for your region in cfg-302.** ====== 433 433 460 +[[image:1651745867516-322.png||height="83" width="740"]] 434 434 435 -**~ 2). Use this command to copy it.** 436 436 463 +====== **Override the global_conf.json** ====== 464 + 437 437 (% class="box infomessage" %) 438 438 ((( 439 439 **cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json** ... ... @@ -442,29 +442,20 @@ 442 442 [[image:1651745984006-868.png||height="87" width="745"]] 443 443 444 444 445 - *Ifuser wants to changetotherLoRaWAN server,modifythe(% style="color:#0000ff" %)**global_conf.json**(%%)file.473 +==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ==== 446 446 447 447 448 -=== 5.2.4 Check result === 449 - 450 - 451 451 ((( 452 -Run below command to restart the dragino_fwd: 477 +Run the below command to restart the dragino_fwd: 453 453 ))) 454 454 455 455 ((( 456 456 (% class="box infomessage" %) 457 457 ((( 458 -**sudo systemctl stop draginofwd** 459 -))) 460 - 461 -(% class="box infomessage" %) 462 -((( 463 463 **sudo systemctl start draginofwd** 464 464 ))) 465 465 ))) 466 466 467 - 468 468 ((( 469 469 debug check the ruing status of fwd: 470 470 ))) ... ... @@ -479,15 +479,13 @@ 479 479 [[image:1651746045057-414.png||height="193" width="729"]] 480 480 481 481 501 +Wait for a few minutes, the gateway will be online/active on the TTN-Stack. 482 482 483 -The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 484 - 485 - 486 486 [[image:1651746078253-168.png||height="372" width="621"]] 487 487 488 488 489 489 490 - Wecan checkdragino_fwd running statesin RPi byrunning:507 +Get the draginofwd real-time running log: 491 491 492 492 (% class="box infomessage" %) 493 493 ((( ... ... @@ -503,9 +503,8 @@ 503 503 [[image:1651746139304-966.png||height="326" width="621"]] 504 504 505 505 506 -=== 5.2.5Commands to handle service ===523 +==== **h). Commands to handle service** ==== 507 507 508 - 509 509 * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service: sudo systemctl stop draginofwd 510 510 * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd 511 511 * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd ... ... @@ -513,9 +513,141 @@ 513 513 * (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd: sudo systemctl status draginofwd 514 514 515 515 516 -= 6.OrderInfo =532 +=== 5.2.2 Basic Station Mode. === 517 517 518 518 535 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 536 + 537 + 538 +In RPI, run the below command to get a Gateway EUI 539 + 540 +(% class="box infomessage" %) 541 +((( 542 +**~ ifconfig eth0** 543 +))) 544 + 545 +[[image:1651745210205-512.png||height="130" width="621"]] 546 + 547 + 548 +((( 549 +((( 550 +We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the gateway ID: b827ebxxxxbcffff. Input this to TTN v3. Make sure to select legacy packet forwarder. 551 +))) 552 +))) 553 + 554 + 555 + 556 +==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ==== 557 + 558 + 559 +[[image:image-20230329164417-5.png]] 560 + 561 + 562 + 563 +==== **c). Download the gateway API keys, and then upload them to the gateway.** ==== 564 + 565 + 566 +[[image:image-20230329164704-6.png]] 567 + 568 + 569 +==== **d). The status Shows disconnect.** ==== 570 + 571 + 572 +[[image:image-20230329165619-7.png||height="568" width="948"]] 573 + 574 + 575 +==== **e.) Uploda API keys into the gateway** ==== 576 + 577 + 578 +the User can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/**(%%) there is the station.conf files, and ttnstack directory. 579 + 580 +//**directory tree:**// 581 + 582 +///etc/station/ 583 +├── station.conf 584 +└── ttnstack ~-~--> ** ttnstack configuration file directory** 585 + ├── cups.trust ~-~--> ttnstack auth file 586 + ├── cups.uri ~-~--> ttnstack server URI file 587 + └── station.conf ~-~-~-~-> backup configuration file// 588 + 589 + 590 + 591 +**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))** 592 + 593 +eg: 594 + 595 +/etc/station/ 596 +├── cups.key ~-~--> uploaded by you 597 +├── lns.key ~-~--> uploaded by you 598 +├── station.conf 599 + 600 + 601 +==== **f). Configure gateway EUI and server address** ==== 602 + 603 + 604 +[[image:image-20230329195650-10.png]] 605 + 606 + 607 +After the user enters the correct parameters, the server will be run automatically 608 + 609 + 610 +Tree Directory: 611 + 612 +/etc/station/ 613 +├── cups.key 614 +├── cups.trust 615 +├── cups.uri 616 +├── lns.key 617 +├── start-configure.sh 618 +├── station.conf 619 +└── ttnstack 620 + ├── cups.trust 621 + ├── cups.uri 622 + └── station.conf 623 + 624 + 625 +==== **g). Check station running log** ==== 626 + 627 + 628 +tail -f /var/log/station.log 629 + 630 + 631 +[[image:image-20230329201624-11.png]] 632 + 633 + 634 += 6. Trouble Shooting = 635 + 636 +== 6.1 Failed to start the concentrator how to debug == 637 + 638 + 639 +--When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled,-- 640 + 641 +--Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct.-- 642 + 643 +(% class="box infomessage" %) 644 +((( 645 +--**i2cdetect -y 1**-- 646 +))) 647 + 648 +**Note: This method has been removed because the i2c had been removed on the latest PG1302.** 649 + 650 + 651 + 652 +Check whether the SPI path of the configuration file is correct, 653 + 654 +(% class="box infomessage" %) 655 +((( 656 +**cat /etc/lora/global_conf.json ** 657 +))) 658 + 659 +(% class="wikigeneratedid" %) 660 +[[image:image-20230518092732-2.png||height="378" width="691"]] 661 + 662 + 663 + 664 += 7. Order Info = 665 + 666 + 519 519 Part Number: (% style="color:#0000ff" %)**PG1302-XX** (%%) Or Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX **(%%)(Include RPi converter board for RPI 3/4) 520 520 521 521 **~ (% style="color:#0000ff" %)XX:(%%)** ... ... @@ -525,24 +525,21 @@ 525 525 * (% style="color:red" %)**470** (%%)(For Band: CN470) 526 526 527 527 528 -= 7. Packing Info =676 += 8. Packing Info = 529 529 530 -((( 531 - 532 532 679 +((( 533 533 **PG1302 Package Includes**: 534 534 ))) 535 535 536 536 ((( 537 -((( 538 538 * PG1302 x 1 539 539 * LoRa Antenna x 1 540 540 ))) 541 -))) 542 542 543 -((( 544 - 545 545 689 + 690 +((( 546 546 **PG1302-PI Package Includes**: 547 547 ))) 548 548 ... ... @@ -551,6 +551,7 @@ 551 551 * RPi3/4 converter PCB 552 552 * Screws to hole converter PCB on RPI. 553 553 699 + 554 554 **PG1302-PI Dimension and weight: ** 555 555 556 556 * Device Size: 18 x 8 x 4 cm ... ... @@ -557,22 +557,13 @@ 557 557 * Weight: 150g 558 558 559 559 560 -((( 561 -= 8. Support = 706 += 9. Support = 562 562 563 563 564 564 ((( 565 -If you are experiencing issues and can't solve, you can send mail to 710 +If you are experiencing issues and can't solve, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]]. 566 566 ))) 567 567 568 568 ((( 569 -[[support@dragino.com>>mailto:support@dragino.com]] 570 -))) 571 - 572 -((( 573 573 With your question as detail as possible. We will reply and help you in the shortest. 574 - 575 - 576 - 577 577 ))) 578 -)))
- image-20230329164417-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.4 KB - Content
- image-20230329164704-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +16.6 KB - Content
- image-20230329165619-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +106.9 KB - Content
- image-20230329195416-8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +9.3 KB - Content
- image-20230329195442-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +9.9 KB - Content
- image-20230329195650-10.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.7 KB - Content
- image-20230329201624-11.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +20.1 KB - Content
- image-20230518091900-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +6.8 KB - Content
- image-20230518092732-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +35.1 KB - Content