Changes for page PG1302 -- LoRaWAN Concentrator User Manual
Last modified by Kilight Cao on 2024/06/22 10:43
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 9 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Kilight - Content
-
... ... @@ -36,7 +36,7 @@ 36 36 37 37 38 38 * Base on Semtech SX1302 solution 39 -* Support Raspberry Pi 3B/3B+/4 39 +* Support Raspberry Pi 3B/3B+/4, TinkerBoard2/2S, Orange Pi Pc/PC PLUS. 40 40 * Up to -140dBm sensitivity 41 41 * Support 3.3v and 5v. 42 42 * Mini-PCIe Interface ... ... @@ -43,7 +43,6 @@ 43 43 * Converter board to support Raspberry Pi 44 44 45 45 46 - 47 47 == 1.3 General Interfaces for PG1302 == 48 48 49 49 ... ... @@ -50,10 +50,9 @@ 50 50 * SPI interface for LoRa 51 51 * Power Input: 5v, 1A 52 52 * 1 x I-PEX for LoRa 53 -* Working Temperature: -40 ℃ ~~ 65℃52 +* Working Temperature: -40 ℃ ~~ 80℃ 54 54 55 55 56 - 57 57 == 1.4 Pin Mapping == 58 58 59 59 ... ... @@ -60,7 +60,6 @@ 60 60 [[image:1651743282627-547.png||height="402" width="425"]] 61 61 62 62 63 - 64 64 == 1.5 LEDs == 65 65 66 66 ... ... @@ -90,7 +90,6 @@ 90 90 * Smart Factory 91 91 92 92 93 - 94 94 = 2. Example: Set up as LoRaWAN gateway = 95 95 96 96 == 2.1 System structure == ... ... @@ -105,7 +105,6 @@ 105 105 [[image:1651743698677-436.png||height="457" width="686"]] 106 106 107 107 108 - 109 109 == 2.2 Hardware Installation == 110 110 111 111 ... ... @@ -114,17 +114,23 @@ 114 114 [[image:image-20220621104746-1.png||height="381" width="451"]] 115 115 116 116 117 - 118 118 = 3. Install the software? = 119 119 120 120 121 - There are two waysto install the software in RPi4to use PG1302.115 +**Raspberry Pi 3B/3B+/4,** 122 122 123 123 * Flash SD card with Dragino pre-build image which supports Web UI. 124 -* Install Loratforwarder in existing RPi OS.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. 125 125 120 +**TinkerBoard2/2S, ** 126 126 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. 127 127 124 +**Orange Pi PC/PC PLUS.** 125 + 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. 127 + 128 + 128 128 = 4. Flash with pre-build image = 129 129 130 130 == 4.1 Download the dragino image for RPI == ... ... @@ -261,7 +261,6 @@ 261 261 262 262 Show system log. 263 263 264 - 265 265 [[image:1651745003470-264.png||height="477" width="621"]] 266 266 267 267 ... ... @@ -270,15 +270,42 @@ 270 270 271 271 **Record the system log.** 272 272 273 - 274 274 [[image:1651745069814-662.png||height="144" width="621"]] 275 275 276 276 277 277 = 5. Install stand-alone LoRa Packet Forwarder = 278 278 279 -== 5.1 OSrequirement ==278 +== 5.1 Choose the right installation package for your OS == 280 280 281 281 281 +((( 282 +**draginofwd-32bit (RPI, Orange PI)** 283 + 284 +**Download URL:** https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb 285 + 286 +**Linux Command:** wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb 287 + 288 + 289 +**dragino-64bit (RPI, Orange PI)** 290 + 291 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb 292 +))) 293 + 294 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb 295 + 296 + 297 +**dragino-tiker-32bit (Tinker Board)** 298 + 299 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb 300 + 301 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb 302 + 303 + 304 +**Install details:** 305 + 306 +[[image:image-20220928181226-1.png||height="218" width="1100"]] 307 + 308 + 282 282 RPI in this example is RPI model 4B with fresh Raspbian OS install. 283 283 284 284 (% class="box" %) ... ... @@ -298,9 +298,25 @@ 298 298 ))) 299 299 300 300 301 -== 5.2 GetGatewayID in Raspberryandinput thisin TTNv3==328 +== 5.2 Select the mode of connection to the server == 302 302 303 303 331 +The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode. 332 + 333 +The User can choose one of the methods as the connection mode. 334 + 335 + 336 +**~1. Semtech UDP Mode ~-~-> 5.2.1** 337 + 338 +**2. Basic Station Mode ~-~-> 5.2.2** 339 + 340 + 341 +=== 5.2.1 Semtech UDP Mode === 342 + 343 + 344 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 345 + 346 + 304 304 In RPI, run the below command to get a Gateway ID 305 305 306 306 (% class="box infomessage" %) ... ... @@ -315,6 +315,10 @@ 315 315 ((( 316 316 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. 317 317 361 + 362 + 363 +==== **b). Input this Gateway EUI to the TTN-Stack** ==== 364 + 318 318 319 319 ))) 320 320 ))) ... ... @@ -324,18 +324,20 @@ 324 324 [[image:1651745306744-481.png||height="478" width="621"]] 325 325 326 326 327 -After set up, the status should show not connected as below: 328 328 375 +==== **c). After Register, the status should show not connected as below:** ==== 376 + 377 + 329 329 [[image:1651745366987-458.png||height="363" width="621"]] 330 330 331 331 332 -=== 5.2.1 Download and install LoRaWAN packet forwarder === 333 333 382 +==== **d). Enable SPI and I2C on your device** ==== 334 334 335 -Enable SPI and I2C first: 336 336 337 - a) SPI needstobe enabledontheRaspberryPi385 +**the below example is using Raspberry 4B.** 338 338 387 + 339 339 Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window 340 340 341 341 [[image:1651745476754-240.png||height="234" width="629"]] ... ... @@ -348,77 +348,69 @@ 348 348 349 349 350 350 351 - InRPI,Fist:Enter the root account:400 +==== **e). Access the root account:** ==== 352 352 353 353 ((( 354 354 [[image:1651745583363-614.png||height="151" width="732"]] 355 355 405 + 356 356 357 357 ))) 358 358 409 +==== **f). Modify the configuration of FWD** ==== 359 359 360 -**Select the appropriate device version to download:** 361 361 362 - 363 363 ((( 364 -**draginofwd-32bit** 365 - 366 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb 367 - 368 - 369 -**dragino-64bit** 413 +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.** 370 370 ))) 371 371 372 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb 416 +((( 417 +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. 373 373 374 374 375 - **dragino-tiker-32bit**420 +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. 376 376 377 -wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb 422 +/etc/lora/ 423 +├── cfg-302 ~-~--> global configuration file 424 +├── devskey ~-~--> Database 425 +├── global_conf.json ~-~--> Frequency plan for current applications 426 +└── local_conf.json ~-~--> Local fwd configuration 378 378 428 +At default, the users need to change two configurations file: global_conf.json and local_conf.json. 379 379 380 -((( 381 - 382 382 383 - [[image:image-20220928181226-1.png||height="218"width="1100"]]431 +===== **1.) Configure gateway EUI and server address, port for fwd** ===== 384 384 385 385 386 386 ))) 387 387 388 - ===5.2.2 ConfigGatewayID, Frequency Bandand Server address===436 +[[image:1651745709709-887.png||height="820" width="621"]] 389 389 390 390 391 -((( 392 -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.** 393 -))) 439 +**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]]** 394 394 395 -((( 396 -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. 397 397 398 - 399 -))) 442 +===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** ===== 400 400 401 -[[image:1651745709709-887.png||height="820" width="621"]] 402 402 445 +the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file. 403 403 404 - 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]]447 +[[image:1651745838008-820.png||height="650" width="621"]] 405 405 406 -And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file. 407 407 408 - [[image:1651745838008-820.png||height="650"width="621"]]450 +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(%%).** 409 409 452 +**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //** 410 410 411 -* 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(%%).** 412 412 413 -**~ 1). Chose your need the name of region frequency.** 414 414 456 +====== **Selecting the appropriate frequency plan for your region in cfg-302.** ====== 415 415 416 416 [[image:1651745867516-322.png||height="83" width="740"]] 417 417 418 418 461 +====== **Override the global_conf.json** ====== 419 419 420 -**~ 2). Use this command to copy it.** 421 - 422 422 (% class="box infomessage" %) 423 423 ((( 424 424 **cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json** ... ... @@ -427,30 +427,20 @@ 427 427 [[image:1651745984006-868.png||height="87" width="745"]] 428 428 429 429 430 - *Ifuser wants to changetotherLoRaWAN server,modifythe(% style="color:#0000ff" %)**global_conf.json**(%%)file.471 +==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ==== 431 431 432 432 433 - 434 -=== 5.2.3 Check result === 435 - 436 - 437 437 ((( 438 -Run below command to restart the dragino_fwd: 475 +Run the below command to restart the dragino_fwd: 439 439 ))) 440 440 441 441 ((( 442 442 (% class="box infomessage" %) 443 443 ((( 444 -**sudo systemctl stop draginofwd** 445 -))) 446 - 447 -(% class="box infomessage" %) 448 -((( 449 449 **sudo systemctl start draginofwd** 450 450 ))) 451 451 ))) 452 452 453 - 454 454 ((( 455 455 debug check the ruing status of fwd: 456 456 ))) ... ... @@ -465,15 +465,13 @@ 465 465 [[image:1651746045057-414.png||height="193" width="729"]] 466 466 467 467 499 +Wait for a few minutes, the gateway will be online/active on the TTN-Stack. 468 468 469 -The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 470 - 471 - 472 472 [[image:1651746078253-168.png||height="372" width="621"]] 473 473 474 474 475 475 476 - Wecan checkdragino_fwd running statesin RPi byrunning:505 +Get the draginofwd real-time running log: 477 477 478 478 (% class="box infomessage" %) 479 479 ((( ... ... @@ -489,9 +489,8 @@ 489 489 [[image:1651746139304-966.png||height="326" width="621"]] 490 490 491 491 492 -=== 5.2.4Commands to handle service ===521 +==== **h). Commands to handle service** ==== 493 493 494 - 495 495 * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service: sudo systemctl stop draginofwd 496 496 * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd 497 497 * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd ... ... @@ -499,10 +499,141 @@ 499 499 * (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd: sudo systemctl status draginofwd 500 500 501 501 530 +=== 5.2.2 Basic Station Mode. === 502 502 503 -= 6. Order Info = 504 504 533 +==== **a). Get a gateway EUI from the device ETH MAC.** ==== 505 505 535 + 536 +In RPI, run the below command to get a Gateway EUI 537 + 538 +(% class="box infomessage" %) 539 +((( 540 +**~ ifconfig eth0** 541 +))) 542 + 543 +[[image:1651745210205-512.png||height="130" width="621"]] 544 + 545 + 546 +((( 547 +((( 548 +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. 549 +))) 550 +))) 551 + 552 + 553 + 554 +==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ==== 555 + 556 + 557 +[[image:image-20230329164417-5.png]] 558 + 559 + 560 + 561 +==== **c). Download the gateway API keys, and then upload them to the gateway.** ==== 562 + 563 + 564 +[[image:image-20230329164704-6.png]] 565 + 566 + 567 +==== **d). The status Shows disconnect.** ==== 568 + 569 + 570 +[[image:image-20230329165619-7.png||height="568" width="948"]] 571 + 572 + 573 +==== **e.) Uploda API keys into the gateway** ==== 574 + 575 + 576 +the User can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/**(%%) there is the station.conf files, and ttnstack directory. 577 + 578 +//**directory tree:**// 579 + 580 +///etc/station/ 581 +├── station.conf 582 +└── ttnstack ~-~--> ** ttnstack configuration file directory** 583 + ├── cups.trust ~-~--> ttnstack auth file 584 + ├── cups.uri ~-~--> ttnstack server URI file 585 + └── station.conf ~-~-~-~-> backup configuration file// 586 + 587 + 588 + 589 +**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))** 590 + 591 +eg: 592 + 593 +/etc/station/ 594 +├── cups.key ~-~--> uploaded by you 595 +├── lns.key ~-~--> uploaded by you 596 +├── station.conf 597 + 598 + 599 +==== **f). Configure gateway EUI and server address** ==== 600 + 601 + 602 +[[image:image-20230329195650-10.png]] 603 + 604 + 605 +After the user enters the correct parameters, the server will be run automatically 606 + 607 + 608 +Tree Directory: 609 + 610 +/etc/station/ 611 +├── cups.key 612 +├── cups.trust 613 +├── cups.uri 614 +├── lns.key 615 +├── start-configure.sh 616 +├── station.conf 617 +└── ttnstack 618 + ├── cups.trust 619 + ├── cups.uri 620 + └── station.conf 621 + 622 + 623 +==== **g). Check station running log** ==== 624 + 625 + 626 +tail -f /var/log/station.log 627 + 628 + 629 +[[image:image-20230329201624-11.png]] 630 + 631 + 632 += 6. Trouble Shooting = 633 + 634 + 635 +== 6.1 Failed to start the concentrator how to debug == 636 + 637 + 638 +When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled, 639 + 640 +Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct. 641 + 642 +(% class="box infomessage" %) 643 +((( 644 +i2cdetect -y 1 645 +))) 646 + 647 +[[image:image-20230518091900-1.png]] 648 + 649 + 650 +Check whether the SPI path of the configuration file is correct, 651 + 652 +(% class="box infomessage" %) 653 +((( 654 +cat /etc/lora/global_conf.json 655 +))) 656 + 657 +(% class="wikigeneratedid" %) 658 +[[image:image-20230518092732-2.png||height="378" width="691"]] 659 + 660 + 661 + 662 += 7. Order Info = 663 + 664 + 506 506 Part Number: (% style="color:#0000ff" %)**PG1302-XX** (%%) Or Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX **(%%)(Include RPi converter board for RPI 3/4) 507 507 508 508 **~ (% style="color:#0000ff" %)XX:(%%)** ... ... @@ -512,25 +512,20 @@ 512 512 * (% style="color:red" %)**470** (%%)(For Band: CN470) 513 513 514 514 674 += 8. Packing Info = 515 515 516 -= 7. Packing Info = 517 517 518 518 ((( 519 - 520 - 521 521 **PG1302 Package Includes**: 522 522 ))) 523 523 524 524 ((( 525 -((( 526 526 * PG1302 x 1 527 527 * LoRa Antenna x 1 528 528 ))) 529 -))) 530 530 531 -((( 532 - 533 533 687 +((( 534 534 **PG1302-PI Package Includes**: 535 535 ))) 536 536 ... ... @@ -539,7 +539,6 @@ 539 539 * RPi3/4 converter PCB 540 540 * Screws to hole converter PCB on RPI. 541 541 542 - 543 543 **PG1302-PI Dimension and weight: ** 544 544 545 545 * Device Size: 18 x 8 x 4 cm ... ... @@ -546,11 +546,9 @@ 546 546 * Weight: 150g 547 547 548 548 702 += 9. Support = 549 549 550 -((( 551 -= 8. Support = 552 552 553 - 554 554 ((( 555 555 If you are experiencing issues and can't solve, you can send mail to 556 556 ))) ... ... @@ -561,8 +561,4 @@ 561 561 562 562 ((( 563 563 With your question as detail as possible. We will reply and help you in the shortest. 564 - 565 - 566 - 567 567 ))) 568 -)))
- 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