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, 0 added, 1 removed)
Details
- Page properties
-
- Content
-
... ... @@ -16,27 +16,18 @@ 16 16 17 17 = **1. Introduction** = 18 18 19 - 20 20 == **1.1 What is PG1302 LoRaWAN Concentrator?** == 21 21 22 22 23 -((( 24 24 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. 25 -))) 26 26 27 -((( 28 28 The PG1302 is designed to use with Raspberry Pi to build smart metering fixed networks and Internet of Things applications with up to 5000 nodes per km2 in a moderately interfered environment. 29 -))) 30 30 31 -((( 32 32 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. 33 -))) 34 34 35 35 36 - 37 37 == **1.2 Features** == 38 38 39 - 40 40 * Base on Semtech SX1302 solution 41 41 * Support Raspberry Pi 3B/3B+/4 42 42 * Up to -140dBm sensitivity ... ... @@ -44,49 +44,28 @@ 44 44 * Mini-PCIe Interface 45 45 * Converter board to support Raspberry Pi 46 46 38 +== **1.3 General Interfaces** == 47 47 48 - 49 - 50 -== **1.3 General Interfaces for PG1302** == 51 - 52 - 53 53 * SPI interface for LoRa 54 54 * Power Input: 5v, 1A 55 55 * 1 x I-PEX for LoRa 56 56 57 - 58 - 59 - 60 60 == **1.4 Pin Mapping** == 61 61 62 - 63 63 [[image:1651743282627-547.png||height="402" width="425"]] 64 64 65 - 66 - 67 67 == **1.5 LEDs** == 68 68 50 + TX: Blink when transmit a packet 51 + RX: Blink when receive a packet 52 + Config: Always ON 69 69 70 -((( 71 -TX: Blink when transmit a packet 72 -RX: Blink when receive a packet 73 -Config: Always ON 74 -))) 75 - 76 - 77 - 78 78 == **1.6 Power Consumption** == 79 79 56 + TBD 80 80 81 -<300mA @ 3.3v. 82 - 83 -Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]] 84 - 85 - 86 - 87 87 == **1.7 Applications** == 88 88 89 - 90 90 * Smart Buildings & Home Automation 91 91 * Logistics and Supply Chain Management 92 92 * Smart Metering ... ... @@ -94,77 +94,53 @@ 94 94 * Smart Cities 95 95 * Smart Factory 96 96 67 += **2. Example: Set up as LoRaWAN gateway.** = 97 97 98 - 99 - 100 -= **2. Example: Set up as LoRaWAN gateway** = 101 - 102 - 103 103 == **2.1 System structure** == 104 104 105 105 106 -((( 107 107 This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with [[TheThingsNetwork>>url:http://www.thethingsnetwork.org/]](TTN) LoRaWAN server. Set up method for other server are similar. 108 108 109 - 110 -))) 111 - 112 112 [[image:1651743698677-436.png||height="457" width="686"]] 113 113 114 114 115 - 116 116 == **2.2 Hardware Installation** == 117 117 118 - 119 119 (% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.** 120 120 121 -[[image: image-20220621104746-1.png||height="381" width="451"]]81 +[[image:1651743803032-803.png]] 122 122 123 123 124 - 125 125 = **3. Install the software?** = 126 126 127 - 128 128 There are two ways to install the software in RPi4 to use PG1302. 129 129 130 130 * Flash SD card with Dragino pre-build image which supports Web UI. 131 131 * Install Lora packet forwarder in existing RPi OS. 132 132 133 - 134 - 135 - 136 136 = **4. Flash with pre-build image** = 137 137 138 - 139 139 == **4.1 Download the dragino image for RPI** == 140 140 95 +Download PG1302_for_Rpi4_64_with_webui from 96 +[[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 141 141 142 -((( 143 -Download PG1302_for_Rpi4_64_with_webui from: [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 144 -))) 145 145 146 - 147 - 148 148 == **4.2 Flash the image to an SD card** == 149 149 150 - 151 151 Flash the image to the SD card: 152 152 153 153 [[image:1651744119133-233.png||height="373" width="621"]] 154 154 105 + Note: Download the flash tool following this link 155 155 156 - (%style="color:red"%)**Note:Download the flash tool following this link:**[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]107 + [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]] 157 157 158 158 159 - 160 160 == **4.3 Access the Linux console** == 161 161 112 +Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s management portal, you should be able to find what IP address the router has assigned to the RPI. You can use this IP to connect the WEB UI or SSH access of RPI. Make sure your PC and the RPI is in the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]]) to access it. Below are screenshots 162 162 163 -((( 164 -Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router's management portal, you should be able to find what IP address the router has assigned to the RPI. You can use this IP to connect the WEB UI or SSH access of RPI. Make sure your PC and the RPI is in the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]]) to access it. Below are screenshots 165 -))) 166 - 167 - 168 168 [[image:1651744193675-591.png||height="450" width="466"]] 169 169 170 170 The account details for Web Login are: ... ... @@ -196,118 +196,89 @@ 196 196 [[image:1651744358515-107.png||height="366" width="581"]] 197 197 198 198 145 +== **4.4 Access the WebUI of RPi4.** == 199 199 200 -== **4.4 Access the WebUI of RPi4** == 201 - 202 - 203 203 === **4.4.1 Home page** === 204 204 205 - 206 -((( 207 -Open a browser on the PC and type the RPI ip address **http:~/~/IP_ADDRESS ** (If the IP is assigned by the uplink router) 149 +Open a browser on the PC and type the RPI ip address[[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by the uplink router) 208 208 You will see the login interface of RPI as shown below. 209 209 The account details for Web Login are: 210 -))) 211 211 212 212 ((( 213 213 **~ (% style="color:#0000ff" %)User Name: root(%%)** 214 214 (% style="color:#0000ff" %)** Password: dragino** 215 - 216 - 217 217 ))) 218 218 219 219 [[image:1651744457761-993.png||height="352" width="621"]] 220 220 221 221 222 - 223 223 === **4.4.2 LoRa Page** === 224 224 225 - 226 226 This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN protocol, and user can customize the band* as well. 227 227 228 - 229 229 [[image:1651744554845-970.png||height="328" width="621"]] 230 230 231 - 232 232 Different PG1302 hardware version can support different frequency range: 233 233 234 -* (% style="color:red" %)**868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.** 235 -* (% style="color:red" %)**915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920** 169 +➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. 236 236 171 +➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920 237 237 238 -After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:#037691" %)**page LogRead ~-~-> LoRa Log**173 +After user choose the frequency plan, he can see the actually frequency in used by checking the 239 239 240 - (% style="color:red"%)**Note*: [[See this instruction for how to customize frequency band>>doc:Main.Howto customizedLoRaWANfrequency band.WebHome]]**175 +page LogRead ~-~-> LoRa Log 241 241 177 +Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]] 242 242 243 243 244 244 === **4.4.3 LoRaWAN Page** === 245 245 246 - 247 247 ==== **4.4.3.1 Semtech UDP** ==== 248 248 249 - 250 250 [[image:1651744767914-283.png||height="352" width="621"]] 251 251 186 +Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]]. 252 252 253 -(% style="color:red" %)**Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].** 254 254 255 - 256 - 257 257 ==== **4.4.3.2 Basic Station** ==== 258 258 259 - 260 260 [[image:1651744890629-683.png||height="380" width="621"]] 261 261 193 +Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]]. 262 262 263 -(% style="color:red" %)**Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].** 264 264 265 - 266 - 267 267 === **4.4.4 LogRead** === 268 268 269 - 270 270 ==== **4.4.4.1 LoRa Log** ==== 271 271 272 - 273 273 [[image:1651744955955-452.png||height="571" width="621"]] 274 274 275 - 276 276 Show the frequency for LoRa Radio and traffics. 277 277 278 278 279 - 280 280 ==== **4.4.4.2 System Log** ==== 281 281 282 - 283 283 Show system log. 284 284 285 - 286 286 [[image:1651745003470-264.png||height="477" width="621"]] 287 287 288 288 289 - 290 290 ==== **4.4.4.3 Record Log** ==== 291 291 292 - 293 293 **Record the system log.** 294 294 295 - 296 296 [[image:1651745069814-662.png||height="144" width="621"]] 297 297 298 298 219 += **5. Install stand-alone LoRa Packet Forwarder.** = 299 299 300 -= **5. Install stand-alone LoRa Packet Forwarder** = 301 - 302 - 303 303 == **5.1 OS requirement** == 304 304 305 - 306 306 RPI in this example is RPI model 4B with fresh Raspbian OS install. 307 307 308 308 (% class="box" %) 309 309 ((( 310 - 227 + pi@raspberrypi:~~$ cat /etc/os-release 311 311 PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)" 312 312 NAME="Raspbian GNU/Linux" 313 313 VERSION_ID="8" ... ... @@ -321,26 +321,20 @@ 321 321 322 322 ))) 323 323 241 +== **5.2 Get Gateway ID in Raspberry and input this in TTN v3.** == 324 324 325 - 326 -== **5.2 Get Gateway ID in Raspberry and input this in TTN v3** == 327 - 328 - 329 329 In RPI, run the below command to get a Gateway ID 330 330 331 331 (% class="box infomessage" %) 332 332 ((( 333 - **~ifconfig eth0**247 + ifconfig eth0 334 334 ))) 335 335 336 336 [[image:1651745210205-512.png||height="130" width="621"]] 337 337 338 - 339 339 ((( 340 340 ((( 341 341 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. 342 - 343 - 344 344 ))) 345 345 ))) 346 346 ... ... @@ -348,21 +348,17 @@ 348 348 349 349 [[image:1651745306744-481.png||height="478" width="621"]] 350 350 351 - 352 352 After set up, the status should show not connected as below: 353 353 354 354 [[image:1651745366987-458.png||height="363" width="621"]] 355 355 266 +=== 5.2.1 Download and install LoRaWAN packet forwarder === 356 356 357 - 358 -=== **5.2.1 Download and install LoRaWAN packet forwarder** === 359 - 360 - 361 361 Enable SPI and I2C first: 362 362 363 -a) 270 +a)SPI needs to be enabled on the Raspberry Pi 364 364 365 -Run yellow" %)272 +Run (% style="background-color:#dcdcdc" %)**sudo raspi-config**(%%) to open the config window 366 366 367 367 [[image:1651745476754-240.png||height="234" width="629"]] 368 368 ... ... @@ -370,14 +370,10 @@ 370 370 371 371 [[image:image-20220505181135-2.png||height="229" width="622"]] 372 372 373 - 374 - 375 375 In RPI, Fist: Enter the root account: 376 376 377 377 ((( 378 378 [[image:1651745583363-614.png||height="151" width="732"]] 379 - 380 - 381 381 ))) 382 382 383 383 and then run: ... ... @@ -394,19 +394,14 @@ 394 394 395 395 This will download the packet forwarder package from Dragino Server to RPI, and start install the package. 396 396 397 - 398 398 You can get these output: 399 399 400 400 ((( 401 401 [[image:1651745657252-173.png||height="426" width="621"]] 402 - 403 - 404 - 405 405 ))) 406 406 407 -=== **5.2.2 Config Gateway ID, Frequency Band and Server address**===306 +=== 5.2.2 Config Gateway ID, Frequency Band and Server address === 408 408 409 - 410 410 ((( 411 411 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.** 412 412 ))) ... ... @@ -413,47 +413,34 @@ 413 413 414 414 ((( 415 415 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. 416 - 417 - 418 418 ))) 419 419 420 420 [[image:1651745709709-887.png||height="820" width="621"]] 421 421 318 +User can find the TTN v3 server address from: 422 422 423 - 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]]320 +[[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]] 424 424 425 425 And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file. 426 426 427 427 [[image:1651745838008-820.png||height="650" width="621"]] 428 428 429 - 430 430 * 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(%%).** 431 431 432 - **~1).**328 + 1).Chose your need the name of region frequency. 433 433 434 - 435 435 [[image:1651745867516-322.png||height="83" width="740"]] 436 436 332 + 2). Use this command to copy it. 437 437 334 + cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json 438 438 439 -**~ 2). Use this command to copy it.** 440 - 441 -(% class="box infomessage" %) 442 -((( 443 -**cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json** 444 -))) 445 - 446 446 [[image:1651745984006-868.png||height="87" width="745"]] 447 447 448 - 449 449 * If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)**global_conf.json**(%%) file. 450 450 340 +=== 5.2.3 Check result === 451 451 452 - 453 - 454 -=== **5.2.3 Check result** === 455 - 456 - 457 457 ((( 458 458 Run below command to restart the dragino_fwd: 459 459 ))) ... ... @@ -461,16 +461,15 @@ 461 461 ((( 462 462 (% class="box infomessage" %) 463 463 ((( 464 - **sudo systemctl stop draginofwd**349 +sudo systemctl stop draginofwd 465 465 ))) 466 466 467 467 (% class="box infomessage" %) 468 468 ((( 469 - **sudo systemctl start draginofwd**354 +sudo systemctl start draginofwd 470 470 ))) 471 471 ))) 472 472 473 - 474 474 ((( 475 475 debug check the ruing status of fwd: 476 476 ))) ... ... @@ -478,41 +478,32 @@ 478 478 ((( 479 479 (% class="box infomessage" %) 480 480 ((( 481 - **sudo systemctl status draginofwd**365 +sudo systemctl status draginofwd 482 482 ))) 483 483 ))) 484 484 485 485 [[image:1651746045057-414.png||height="193" width="729"]] 486 486 487 - 488 - 489 489 The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 490 490 491 - 492 492 [[image:1651746078253-168.png||height="372" width="621"]] 493 493 494 494 495 - 496 496 We can check dragino_fwd running states in RPi by running: 497 497 498 498 (% class="box infomessage" %) 499 499 ((( 500 - **~sudo journalctl -u draginofwd -f**380 + sudo journalctl -u draginofwd -f 501 501 ))) 502 502 503 503 [[image:1651746111963-838.png||height="184" width="730"]] 504 504 385 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in **TTN v3 –> Gateway ~-~-> Live data** 505 505 506 - 507 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)**TTN v3 –> Gateway ~-~-> Live data** 508 - 509 509 [[image:1651746139304-966.png||height="326" width="621"]] 510 510 389 +=== 5.2.4 Commands to handle service === 511 511 512 - 513 -=== **5.2.4 Commands to handle service** === 514 - 515 - 516 516 * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service: sudo systemctl stop draginofwd 517 517 * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd 518 518 * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd ... ... @@ -519,28 +519,19 @@ 519 519 * (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot: sudo systemctl enable draginofwd 520 520 * (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd: sudo systemctl status draginofwd 521 521 397 += 6. Order Info = 522 522 523 - 524 - 525 -= **6. Order Info** = 526 - 527 - 528 528 Part Number: (% style="color:#0000ff" %)**PG1302-XX** (%%) Or Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX **(%%)(Include RPi converter board for RPI 3/4) 529 529 530 530 **~ (% style="color:#0000ff" %)XX:(%%)** 531 531 532 -* (% style="color: red" %)**868** (%%)(For Bands: EU868,IN865)533 -* (% style="color: red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)534 -* (% style="color: red" %)**470** (%%)(For Band: CN470)403 +* (% style="color:#0000ff" %)**868** (%%)(For Bands: EU868,IN865) 404 +* (% style="color:#0000ff" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920) 405 +* (% style="color:#0000ff" %)**470** (%%)(For Band: CN470) 535 535 407 += 7. Packing Info = 536 536 537 - 538 - 539 -= **7. Packing Info** = 540 - 541 541 ((( 542 - 543 - 544 544 **PG1302 Package Includes**: 545 545 ))) 546 546 ... ... @@ -552,9 +552,6 @@ 552 552 ))) 553 553 554 554 ((( 555 - 556 - 557 - 558 558 **PG1302-PI Package Includes**: 559 559 ))) 560 560 ... ... @@ -563,22 +563,11 @@ 563 563 * RPi3/4 converter PCB 564 564 * Screws to hole converter PCB on RPI. 565 565 566 - 567 - 568 -**PG1302-PI Dimension and weight: ** 569 - 570 -* Device Size: 18 x 8 x 4 cm 571 -* Weight: 150g 572 - 573 - 574 - 575 - 576 576 ((( 577 -= **8. Support**=430 += 8. Support = 578 578 579 - 580 580 ((( 581 -If you are experiencing issues and can 't solve, you can send mail to433 +If you are experiencing issues and can’t solve, you can send mail to 582 582 ))) 583 583 584 584 ((( ... ... @@ -587,8 +587,5 @@ 587 587 588 588 ((( 589 589 With your question as detail as possible. We will reply and help you in the shortest. 590 - 591 - 592 - 593 593 ))) 594 594 )))
- image-20220621104746-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -861.7 KB - Content