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 ... ... @@ -120,10 +120,14 @@ 120 120 * Flash SD card with Dragino pre-build image which supports Web UI. 121 121 * 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. 122 122 123 + 124 + 123 123 **TinkerBoard2/2S, ** 124 124 125 125 * 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. 126 126 129 + 130 + 127 127 **Orange Pi PC/PC PLUS.** 128 128 129 129 * 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. ... ... @@ -266,7 +266,6 @@ 266 266 267 267 Show system log. 268 268 269 - 270 270 [[image:1651745003470-264.png||height="477" width="621"]] 271 271 272 272 ... ... @@ -275,20 +275,47 @@ 275 275 276 276 **Record the system log.** 277 277 278 - 279 279 [[image:1651745069814-662.png||height="144" width="621"]] 280 280 281 281 282 282 = 5. Install stand-alone LoRa Packet Forwarder = 283 283 284 -== 5.1 OSrequirement ==286 +== 5.1 Choose the right installation package for your OS == 285 285 286 286 289 +((( 290 +**draginofwd-32bit (RPI, Orange PI)** 291 + 292 +**Download URL:** https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb 293 + 294 +**Linux Command:** wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb 295 + 296 + 297 +**dragino-64bit (RPI, Orange PI)** 298 + 299 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb 300 +))) 301 + 302 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb 303 + 304 + 305 +**dragino-tiker-32bit (Tinker Board)** 306 + 307 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb 308 + 309 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb 310 + 311 + 312 +**Install details:** 313 + 314 +[[image:image-20220928181226-1.png||height="218" width="1100"]] 315 + 316 + 287 287 RPI in this example is RPI model 4B with fresh Raspbian OS install. 288 288 289 289 (% class="box" %) 290 290 ((( 291 - pi@raspberrypi:~~$ cat /etc/os-release 321 +**~ pi@raspberrypi:~~$ cat /etc/os-release 292 292 PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)" 293 293 NAME="Raspbian GNU/Linux" 294 294 VERSION_ID="8" ... ... @@ -297,15 +297,31 @@ 297 297 ID_LIKE=debian 298 298 HOME_URL="http:~/~/www.raspbian.org/" 299 299 SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums" 300 - BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs" 330 + BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"** 301 301 302 302 303 303 ))) 304 304 305 305 306 -== 5.2 GetGatewayID in Raspberryandinput thisin TTNv3==336 +== 5.2 Select the mode of connection to the server == 307 307 308 308 339 +The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode. 340 + 341 +The User can choose one of the methods as the connection mode. 342 + 343 + 344 +**~1. Semtech UDP Mode ~-~-> 5.2.1** 345 + 346 +**2. Basic Station Mode ~-~-> 5.2.2** 347 + 348 + 349 +=== 5.2.1 Semtech UDP Mode === 350 + 351 + 352 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 353 + 354 + 309 309 In RPI, run the below command to get a Gateway ID 310 310 311 311 (% class="box infomessage" %) ... ... @@ -320,6 +320,10 @@ 320 320 ((( 321 321 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. 322 322 369 + 370 + 371 +==== **b). Input this Gateway EUI to the TTN-Stack** ==== 372 + 323 323 324 324 ))) 325 325 ))) ... ... @@ -329,18 +329,20 @@ 329 329 [[image:1651745306744-481.png||height="478" width="621"]] 330 330 331 331 332 -After set up, the status should show not connected as below: 333 333 383 +==== **c). After Register, the status should show not connected as below:** ==== 384 + 385 + 334 334 [[image:1651745366987-458.png||height="363" width="621"]] 335 335 336 336 337 -=== 5.2.1 Download and install LoRaWAN packet forwarder === 338 338 390 +==== **d). Enable SPI and I2C on your device** ==== 339 339 340 -Enable SPI and I2C first: 341 341 342 - a) SPI needstobe enabledontheRaspberryPi393 +**the below example is using Raspberry 4B.** 343 343 395 + 344 344 Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window 345 345 346 346 [[image:1651745476754-240.png||height="234" width="629"]] ... ... @@ -353,77 +353,69 @@ 353 353 354 354 355 355 356 - InRPI,Fist:Enter the root account:408 +==== **e). Access the root account:** ==== 357 357 358 358 ((( 359 359 [[image:1651745583363-614.png||height="151" width="732"]] 360 360 413 + 361 361 362 362 ))) 363 363 417 +==== **f). Modify the configuration of FWD** ==== 364 364 365 -=== 5.2.2 Select the appropriate device version to download: === 366 366 367 - 368 368 ((( 369 -**draginofwd-32bit (RPI, Orange PI)** 370 - 371 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb 372 - 373 - 374 -**dragino-64bit (RPI, Orange PI)** 421 +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.** 375 375 ))) 376 376 377 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb 424 +((( 425 +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. 378 378 379 379 380 - **dragino-tiker-32bit(TinkerBoard)**428 +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. 381 381 382 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb 430 +/etc/lora/ 431 +├── cfg-302 ~-~--> global configuration file 432 +├── devskey ~-~--> Database 433 +├── global_conf.json ~-~--> Frequency plan for current applications 434 +└── local_conf.json ~-~--> Local fwd configuration 383 383 436 +At default, the users need to change two configurations file: global_conf.json and local_conf.json. 384 384 385 -((( 386 - 387 387 388 - [[image:image-20220928181226-1.png||height="218"width="1100"]]439 +===== **1.) Configure gateway EUI and server address, port for fwd** ===== 389 389 390 390 391 391 ))) 392 392 393 - ===5.2.3 ConfigGatewayID, Frequency Bandand Server address===444 +[[image:1651745709709-887.png||height="820" width="621"]] 394 394 395 395 396 -((( 397 -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.** 398 -))) 447 +**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]]** 399 399 400 -((( 401 -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. 402 402 403 - 404 -))) 450 +===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** ===== 405 405 406 -[[image:1651745709709-887.png||height="820" width="621"]] 407 407 453 +the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file. 408 408 409 - User can find the TTN v3 serveraddress from:[[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]455 +[[image:1651745838008-820.png||height="650" width="621"]] 410 410 411 -And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file. 412 412 413 - [[image:1651745838008-820.png||height="650"width="621"]]458 +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(%%).** 414 414 460 +**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //** 415 415 416 -* 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(%%).** 417 417 418 -**~ 1). Chose your need the name of region frequency.** 419 419 464 +====== **Selecting the appropriate frequency plan for your region in cfg-302.** ====== 420 420 421 421 [[image:1651745867516-322.png||height="83" width="740"]] 422 422 423 423 469 +====== **Override the global_conf.json** ====== 424 424 425 -**~ 2). Use this command to copy it.** 426 - 427 427 (% class="box infomessage" %) 428 428 ((( 429 429 **cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json** ... ... @@ -432,30 +432,20 @@ 432 432 [[image:1651745984006-868.png||height="87" width="745"]] 433 433 434 434 435 - *Ifuser wants to changetotherLoRaWAN server,modifythe(% style="color:#0000ff" %)**global_conf.json**(%%)file.479 +==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ==== 436 436 437 437 438 - 439 -=== 5.2.4 Check result === 440 - 441 - 442 442 ((( 443 -Run below command to restart the dragino_fwd: 483 +Run the below command to restart the dragino_fwd: 444 444 ))) 445 445 446 446 ((( 447 447 (% class="box infomessage" %) 448 448 ((( 449 -**sudo systemctl stop draginofwd** 450 -))) 451 - 452 -(% class="box infomessage" %) 453 -((( 454 454 **sudo systemctl start draginofwd** 455 455 ))) 456 456 ))) 457 457 458 - 459 459 ((( 460 460 debug check the ruing status of fwd: 461 461 ))) ... ... @@ -470,15 +470,13 @@ 470 470 [[image:1651746045057-414.png||height="193" width="729"]] 471 471 472 472 507 +Wait for a few minutes, the gateway will be online/active on the TTN-Stack. 473 473 474 -The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 475 - 476 - 477 477 [[image:1651746078253-168.png||height="372" width="621"]] 478 478 479 479 480 480 481 - Wecan checkdragino_fwd running statesin RPi byrunning:513 +Get the draginofwd real-time running log: 482 482 483 483 (% class="box infomessage" %) 484 484 ((( ... ... @@ -494,9 +494,8 @@ 494 494 [[image:1651746139304-966.png||height="326" width="621"]] 495 495 496 496 497 -=== 5.2.5Commands to handle service ===529 +==== **h). Commands to handle service** ==== 498 498 499 - 500 500 * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service: sudo systemctl stop draginofwd 501 501 * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd 502 502 * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd ... ... @@ -505,9 +505,140 @@ 505 505 506 506 507 507 508 -= 6.OrderInfo =539 +=== 5.2.2 Basic Station Mode. === 509 509 510 510 542 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 543 + 544 + 545 +In RPI, run the below command to get a Gateway EUI 546 + 547 +(% class="box infomessage" %) 548 +((( 549 +**~ ifconfig eth0** 550 +))) 551 + 552 +[[image:1651745210205-512.png||height="130" width="621"]] 553 + 554 + 555 +((( 556 +((( 557 +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. 558 +))) 559 +))) 560 + 561 + 562 + 563 +==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ==== 564 + 565 + 566 +[[image:image-20230329164417-5.png]] 567 + 568 + 569 + 570 +==== **c). Download the gateway API keys, and then upload them to the gateway.** ==== 571 + 572 + 573 +[[image:image-20230329164704-6.png]] 574 + 575 + 576 +==== **d). The status Shows disconnect.** ==== 577 + 578 + 579 +[[image:image-20230329165619-7.png||height="568" width="948"]] 580 + 581 + 582 +==== **e.) Uploda API keys into the gateway** ==== 583 + 584 + 585 +the User can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/**(%%) there is the station.conf files, and ttnstack directory. 586 + 587 +//**directory tree:**// 588 + 589 +///etc/station/ 590 +├── station.conf 591 +└── ttnstack ~-~--> ** ttnstack configuration file directory** 592 + ├── cups.trust ~-~--> ttnstack auth file 593 + ├── cups.uri ~-~--> ttnstack server URI file 594 + └── station.conf ~-~-~-~-> backup configuration file// 595 + 596 + 597 + 598 +**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))** 599 + 600 +eg: 601 + 602 +/etc/station/ 603 +├── cups.key ~-~--> uploaded by you 604 +├── lns.key ~-~--> uploaded by you 605 +├── station.conf 606 + 607 + 608 +==== **f). Configure gateway EUI and server address** ==== 609 + 610 + 611 +[[image:image-20230329195650-10.png]] 612 + 613 + 614 +After the user enters the correct parameters, the server will be run automatically 615 + 616 + 617 +Tree Directory: 618 + 619 +/etc/station/ 620 +├── cups.key 621 +├── cups.trust 622 +├── cups.uri 623 +├── lns.key 624 +├── start-configure.sh 625 +├── station.conf 626 +└── ttnstack 627 + ├── cups.trust 628 + ├── cups.uri 629 + └── station.conf 630 + 631 + 632 +==== **g). Check station running log** ==== 633 + 634 + 635 +tail -f /var/log/station.log 636 + 637 + 638 +[[image:image-20230329201624-11.png]] 639 + 640 + 641 += 6. Trouble Shooting = 642 + 643 +== 6.1 Failed to start the concentrator how to debug == 644 + 645 + 646 +When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled, 647 + 648 +Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct. 649 + 650 +(% class="box infomessage" %) 651 +((( 652 +**i2cdetect -y 1** 653 +))) 654 + 655 +[[image:image-20230518091900-1.png]] 656 + 657 + 658 +Check whether the SPI path of the configuration file is correct, 659 + 660 +(% class="box infomessage" %) 661 +((( 662 +**cat /etc/lora/global_conf.json ** 663 +))) 664 + 665 +(% class="wikigeneratedid" %) 666 +[[image:image-20230518092732-2.png||height="378" width="691"]] 667 + 668 + 669 + 670 += 7. Order Info = 671 + 672 + 511 511 Part Number: (% style="color:#0000ff" %)**PG1302-XX** (%%) Or Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX **(%%)(Include RPi converter board for RPI 3/4) 512 512 513 513 **~ (% style="color:#0000ff" %)XX:(%%)** ... ... @@ -518,24 +518,21 @@ 518 518 519 519 520 520 521 -= 7. Packing Info =683 += 8. Packing Info = 522 522 523 -((( 524 - 525 525 686 +((( 526 526 **PG1302 Package Includes**: 527 527 ))) 528 528 529 529 ((( 530 -((( 531 531 * PG1302 x 1 532 532 * LoRa Antenna x 1 533 533 ))) 534 -))) 535 535 536 -((( 537 - 538 538 696 + 697 +((( 539 539 **PG1302-PI Package Includes**: 540 540 ))) 541 541 ... ... @@ -544,6 +544,8 @@ 544 544 * RPi3/4 converter PCB 545 545 * Screws to hole converter PCB on RPI. 546 546 706 + 707 + 547 547 **PG1302-PI Dimension and weight: ** 548 548 549 549 * Device Size: 18 x 8 x 4 cm ... ... @@ -551,22 +551,13 @@ 551 551 552 552 553 553 554 -((( 555 -= 8. Support = 715 += 9. Support = 556 556 557 557 558 558 ((( 559 -If you are experiencing issues and can't solve, you can send mail to 719 +If you are experiencing issues and can't solve, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]]. 560 560 ))) 561 561 562 562 ((( 563 -[[support@dragino.com>>mailto:support@dragino.com]] 564 -))) 565 - 566 -((( 567 567 With your question as detail as possible. We will reply and help you in the shortest. 568 - 569 - 570 - 571 571 ))) 572 -)))
- 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