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)
Details
- Page properties
-
- Content
-
... ... @@ -11,51 +11,35 @@ 11 11 12 12 **PG1302 LoRaWAN Concentrator User Manual** 13 13 14 +[[image:1651796979665-130.png]] 14 14 16 +Document Version: 1.0.0 15 15 18 +Image Version: v1.0 16 16 17 17 18 -{{toc/}} 19 19 20 20 21 - ----23 +{{toc numbered="true" depth="4"/}} 22 22 23 -(% class="wikigeneratedid" id="H" %) 24 -((( 25 - 26 -))) 27 27 28 -=== 1. Introduction === 29 29 30 -==== 1.1 What is PG1302 LoRaWAN Concentrator? ==== 31 31 28 +~1. Introduction 29 + 30 + 1.1 What is PG1302 LoRaWAN Concentrator? 31 + 32 32 ((( 33 -((( 34 -((( 35 -((( 36 -The PG1302 is a 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. 33 +The PG1302 is a 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. 37 37 ))) 38 -))) 39 -))) 40 40 41 41 ((( 42 -((( 43 -((( 44 44 The PG1302 is design to use with Raspberry Pi to build smart metering fixed networks and Internet of Things applications with up to 5000 nodes per km2 in moderately interfered environment. 45 45 ))) 46 -))) 47 -))) 48 -))) 49 49 50 50 ((( 51 -((( 52 -((( 53 -((( 54 54 PG1302 is fully compatible with RPi3/4, 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 exist OS. 55 55 ))) 56 -))) 57 -))) 58 -))) 59 59 60 60 ((( 61 61 ((( ... ... @@ -63,7 +63,7 @@ 63 63 ))) 64 64 ))) 65 65 66 - ====1.2 Features====50 +1.2 Features 67 67 68 68 * Base on Semtech SX1302 solution 69 69 * Support Raspberry Pi 3B/3B+/4 ... ... @@ -72,39 +72,35 @@ 72 72 * Mini-PCIe Interface 73 73 * Converter board to support Raspberry Pi 74 74 75 -==== 1.3 General Interfaces ==== 76 76 60 +1.3 General Interfaces 61 + 77 77 * SPI interface for LoRa 78 78 * Power Input: 5v, 1A 79 79 * 1 x I-PEX for LoRa 80 80 81 -==== 1.4 Pin Mapping ==== 82 82 67 +1.4 Pin Mapping 68 + 83 83 [[image:1651743282627-547.png||height="402" width="425"]] 84 84 85 85 86 86 87 - ====1.5 LEDs====73 +1.5 LEDs 88 88 89 -((( 90 - TX: Blink when transmit a packet 91 -))) 75 + TX: Blink when transmit a packet 92 92 93 -((( 94 - RX: Blink when receive a packet 95 -))) 77 + RX: Blink when receive a packet 96 96 97 -((( 98 - Config: Always ON 99 -))) 79 + Config: Always ON 100 100 101 101 102 - ====1.6 Power Consumption====82 +1.6 Power Consumption 103 103 104 - TBD 84 + TBD 105 105 106 106 107 - ====1.7 Applications====87 +1.7 Applications 108 108 109 109 * Smart Buildings & Home Automation 110 110 * Logistics and Supply Chain Management ... ... @@ -113,27 +113,28 @@ 113 113 * Smart Cities 114 114 * Smart Factory 115 115 116 -=== 2. Example: Set up as LoRaWAN gateway. === 117 117 118 - ====2.1Systemstructure====97 +2. Example: Set up as LoRaWAN gateway. 119 119 120 -((( 121 -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. 122 -))) 99 + 2.1 System structure 123 123 101 + This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with [[TheThingsNetwork>>http://www.thethingsnetwork.org/]](TTN) LoRaWAN server.. Set up method for other server are similar。 102 + 103 +(% style="text-align:center" %) 124 124 [[image:1651743698677-436.png||height="457" width="686"]] 125 125 126 126 127 127 128 - ====2.2 Hardware Installation====108 +2.2 Hardware Installation 129 129 130 -**Important Notice: **Please power the RPI with 5V,3A cable. 110 +**~ Important Notice: **Please power the RPI with 5V,3A cable. 131 131 112 +(% style="text-align:center" %) 132 132 [[image:1651743803032-803.png]] 133 133 134 134 135 135 136 - ===3. Install the software?===117 +3. Install the software? 137 137 138 138 There are two ways to install software in RPi4 to use PG1302. 139 139 ... ... @@ -140,23 +140,21 @@ 140 140 * Flash SD card with Dragino pre-build image which support Web UI. 141 141 * Install lora packet forwarder in existing RPi OS. 142 142 143 -=== 4. Flash with pre-build image === 144 144 145 - ====4.1Downloadthedraginoimagefor RPI ====125 +4. Flash with pre-build image 146 146 147 -((( 148 - Download PG1302_for_Rpi4_64_with_webui from 149 -))) 127 + 4.1 Download the dragino image for RPI 150 150 151 -((( 152 - [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 153 -))) 129 + Download PG1302_for_Rpi4_64_with_webui from 154 154 131 + [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 155 155 156 -==== 4.2 Flash the image to SD card ==== 157 157 158 - :134 +4.2 Flash the image to SD card 159 159 136 + Flash the image to SD card: 137 + 138 +(% style="text-align:center" %) 160 160 [[image:1651744119133-233.png||height="373" width="621"]] 161 161 162 162 Note: Download the flash tool following this link ... ... @@ -164,12 +164,13 @@ 164 164 [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]] 165 165 166 166 167 - ====4.3 Access the Linux console====146 +4.3 Access the Linux console. 168 168 169 -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. 148 + 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. 170 170 171 -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 150 + 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 172 172 152 +(% style="text-align:center" %) 173 173 [[image:1651744193675-591.png||height="450" width="466"]] 174 174 175 175 ... ... @@ -187,111 +187,115 @@ 187 187 188 188 After log in, you will be in the Linux console and type command here. 189 189 170 +(% style="text-align:center" %) 190 190 [[image:1651744358515-107.png||height="366" width="581"]] 191 191 192 192 193 - ====4.4 Access the WebUI of RPi4.====174 + 4.4 Access the WebUI of RPi4. 194 194 195 - =====4.4.1 Home page=====176 + 4.4.1 Home page 196 196 197 -((( 198 -Open a browser on the PC and type the RPI ip address 199 -))) 178 + Open a browser on the PC and type the RPI ip address 200 200 201 -((( 202 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router) 203 -))) 180 + [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router) 204 204 205 -((( 206 -You will see the login interface of RPI as shown below. 207 -))) 208 208 209 -((( 210 -The account details for Web Login are: 211 -))) 183 + You will see the login interface of RPI as shown below. 212 212 213 -((( 185 + The account details for Web Login are: 186 + 214 214 **~ User Name: root** 215 -))) 216 216 217 -((( 218 218 **~ Password: dragino** 219 -))) 220 220 191 +(% style="text-align:center" %) 221 221 [[image:1651744457761-993.png||height="352" width="621"]] 222 222 223 223 224 - =====4.4.2 LoRa Page=====195 +4.4.2 LoRa Page 225 225 226 -((( 227 -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. 228 -))) 197 + 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. 229 229 199 +(% style="text-align:center" %) 230 230 [[image:1651744554845-970.png||height="328" width="621"]] 231 231 232 -Different PG1302 hardware version can support different frequency range: 233 233 234 - ➢868:validfrequency:863Mhz ~~ 870Mhz.forbandsEU868,RU864, IN865 orKZ865.203 + Different PG1302 hardware version can support different frequency range: 235 235 236 -➢ 915: valid frequency:902Mhz ~~928Mhz. for bands US915,AU915,AS923or KR920205 + ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. 237 237 238 - Afteruserchoosethefrequencyplan,hecansee theactuallyfrequencyinusedbycheckingthe207 + ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920 239 239 240 -page LogRead ~-~-> LoRa Log 241 241 242 - Note*: Seethisinstructionforhowtocustomize frequencyband210 + After user choose the frequency plan, he can see the actually frequency in used by checking the 243 243 244 - [[http:~~/~~/wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway>>url:http://wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway]]212 + page LogRead ~-~-> LoRa Log 245 245 214 + Note *: See this instruction for how to customize frequency band 246 246 247 - =====4.4.3 LoRaWAN Page====216 + [[http:~~/~~/wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway>>url:http://wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway]] 248 248 249 -====== 4.4.3.1 Semtech UDP ====== 250 250 219 +4.4.3 LoRaWAN Page 220 + 221 + 4.4.3.1 Semtech UDP 222 + 223 + 224 +(% style="text-align:center" %) 251 251 [[image:1651744767914-283.png||height="352" width="621"]] 252 252 253 - Note *: See this instruction for how to configure TTN. 254 254 255 - [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_TTN>>url:https://wiki.dragino.com/index.php?title=Notes_for_TTN||style="background-color: rgb(255, 255, 255);"]] 256 256 229 + Note *: See this instruction for how to configure TTN. 257 257 258 - ======4.4.3.2BasicStation=====231 + [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_TTN>>url:https://wiki.dragino.com/index.php?title=Notes_for_TTN]] 259 259 233 + 234 +4.4.3.2 Basic Station 235 + 236 +(% style="text-align:center" %) 260 260 [[image:1651744890629-683.png||height="380" width="621"]] 261 261 262 -Note *: See this instruction for how to configure TTN. 263 263 264 - [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core>>url:https://wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core]]240 + Note *: See this instruction for how to configure TTN. 265 265 242 + [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core>>url:https://wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core]] 266 266 267 -===== 4.4.4 LogRead ===== 268 268 269 - ======4.4.4.1LoRaLog ======245 +4.4.4 LogRead 270 270 247 + 4.4.4.1 LoRa Log 248 + 249 +(% style="text-align:center" %) 271 271 [[image:1651744955955-452.png||height="571" width="621"]] 272 272 273 -Show the frequency for LoRa Radio and traffics. 274 274 253 + Show the frequency for LoRa Radio and traffics. 275 275 276 -====== 4.4.4.2 System Log ====== 277 277 278 - Showsystemlog.256 +4.4.4.2 System Log 279 279 258 + Show system log. 259 + 260 +(% style="text-align:center" %) 280 280 [[image:1651745003470-264.png||height="477" width="621"]] 281 281 282 282 283 -====== 4.4.4.3 Record Log ====== 284 284 265 +4.4.4.3 Record Log 266 + 267 + 285 285 **Record the system log.** 286 286 270 +(% style="text-align:center" %) 287 287 [[image:1651745069814-662.png||height="144" width="621"]] 288 288 289 289 290 - ===5. Install stand alone LoRa Packet Forwarder.===274 +5. Install stand alone LoRa Packet Forwarder. 291 291 292 - ====5.1 OS requirement====276 + 5.1 OS requirement 293 293 294 -RPI in this example is RPI model 4B with fresh Raspbian OS install. 278 + RPI in this example is RPI model 4B with fresh Raspbian OS install. 295 295 296 296 pi@raspberrypi:~~$ cat /etc/os-release 297 297 ... ... @@ -314,18 +314,18 @@ 314 314 BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs" 315 315 316 316 317 - ====5.2 Get Gateway ID in Raspberry and input this in TTN v3.====301 +5.2 Get Gateway ID in Raspberry and input this in TTN v3. 318 318 319 -In RPI, run below command to get a Gateway ID 303 + In RPI, run below command to get a Gateway ID 320 320 321 - (%class="mark"%)ifconfig eth0305 + ifconfig eth0 322 322 307 +(% style="text-align:center" %) 323 323 [[image:1651745210205-512.png||height="130" width="621"]] 324 324 325 -((( 326 -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. 327 -))) 328 328 311 + 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. 312 + 329 329 (% style="text-align:center" %) 330 330 [[image:1651745267862-321.png||height="526" width="621"]] 331 331 ... ... @@ -340,8 +340,9 @@ 340 340 [[image:1651745366987-458.png||height="363" width="621"]] 341 341 342 342 343 -===== 5.2.1 Download and install LoRaWAN packet forwarder ===== 344 344 328 +5.2.1 Download and install LoRaWAN packet forwarder 329 + 345 345 Enable SPI and I2C first: 346 346 347 347 a)SPI needs to be enabled on the Raspberry Pi ... ... @@ -387,34 +387,22 @@ 387 387 [[image:1651745657252-173.png||height="426" width="621"]] 388 388 389 389 390 - =====5.2.2 Config Gateway ID, Frequency Band and Server address=====375 +5.5.2 Config Gateway ID, Frequency Band and Server address 391 391 392 -((( 393 - After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the 394 -))) 377 + After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the **gateway_ID** in file **local_conf.json** 395 395 396 -((( 397 -**~ gateway_ID** in file **local_conf.json** 398 -))) 379 + The default LoRaWAN server points to localhost, user need to put the correct server address to the server_address field in file **local_conf.json**, like below. 399 399 400 -((( 401 - The default LoRaWAN server points to localhost, user need to put the correct server address to the 402 -))) 403 - 404 -((( 405 - server_address field in file **local_conf.json**, like below. 406 -))) 407 - 408 408 (% style="text-align:center" %) 409 409 [[image:1651745709709-887.png||height="820" width="621"]] 410 410 411 411 412 - User can find the TTN v3 server address from: 385 + User can find the TTN v3 server address from: 413 413 414 - [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]] 387 + [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]] 415 415 416 416 417 - And the default frequency band is US915 in **global_conf.json** file. 390 + And the default frequency band is US915 in **global_conf.json** file. 418 418 419 419 (% style="text-align:center" %) 420 420 [[image:1651745838008-820.png||height="650" width="621"]] ... ... @@ -438,60 +438,48 @@ 438 438 439 439 * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file. 440 440 441 -(% class="wikigeneratedid" %) 442 -((( 443 - 444 -))) 445 445 446 - =====5.2.3 Check result=====415 +5.2.3 Check result 447 447 448 -((( 449 - Run below command to restart the dragino_fwd: 450 -))) 417 + Run below command to restart the dragino_fwd: 451 451 452 -((( 453 453 sudo systemctl stop draginofwd 454 -))) 455 455 456 -((( 457 457 sudo systemctl start draginofwd 458 -))) 459 459 460 -((( 461 - debug check the ruing status of fwd: 462 -))) 423 + debug check the ruing status of fwd: 463 463 464 -((( 465 - sudo systemctl status draginofwd 466 -))) 425 + sudo systemctl status draginofwd 467 467 468 468 (% style="text-align:center" %) 469 469 [[image:1651746045057-414.png]] 470 470 471 471 472 - The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 431 + The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 473 473 474 474 (% style="text-align:center" %) 475 475 [[image:1651746078253-168.png||height="372" width="621"]] 476 476 477 477 478 -We can check dragino_fwd running states in RPi by running: 479 479 480 -(% class="box infomessage" %) 481 -((( 482 - **// sudo journalctl -u draginofwd -f//** 483 -))) 438 + We can check dragino_fwd running states in RPi by running: 484 484 440 + //**sudo journalctl -u draginofwd -f**// 441 + 442 +(% style="text-align:center" %) 485 485 [[image:1651746111963-838.png]] 486 486 487 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data 488 488 489 489 447 + If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data 448 + 449 +(% style="text-align:center" %) 490 490 [[image:1651746139304-966.png||height="326" width="621"]] 491 491 492 492 493 -===== 5.2.4 Commands to handle service ===== 494 494 454 +5.2.4 Commands to handle service 455 + 495 495 * **Stop** dragino_fwd service: sudo systemctl stop draginofwd 496 496 * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd 497 497 * **Start** dragino_fwd : sudo systemctl start draginofwd ... ... @@ -498,42 +498,43 @@ 498 498 * **Auto run** dragino_fwd after boot: sudo systemctl enable draginofwd 499 499 * **Show status** of dragino_fwd: sudo systemctl status draginofwd 500 500 501 -=== 6. Order Info === 502 502 503 - Part Number: **PG1302-XX**OrPart Number:**PG1302-PI-XX **(Include RPi converter boardfor RPI 3/4)463 +6. Order Info 504 504 505 -** ~XX:**465 + Part Number: **PG1302-XX** Or Part Number: **PG1302-PI-XX **(Include RPi converter board for RPI 3/4) 506 506 467 +**~ XX:** 468 + 507 507 * 868 (For Bands: EU868,IN865) 508 508 * 915 (For Bands: US915,AU915,AS923,KR920) 509 509 * 470 (For Band: CN470) 510 510 511 -=== 7. Packing Info === 512 512 513 -((( 514 -**~ PG1302 Package Includes**: 515 -))) 474 +7. Packing Info 516 516 517 -* ((( 518 -PG1302 x 1 519 -))) 520 -* ((( 521 -LoRa Antenna x 1 522 -))) 476 +**~ PG1302 Package Includes**: 523 523 524 -((( 525 -**~ PG1302-PI Package Includes**: 526 -))) 478 +* PG1302 x 1 479 +* LoRa Antenna x 1 527 527 528 -* ((( 529 -PG1302 x 1 530 -))) 531 -* ((( 532 -LoRa Antenna x 1 533 -))) 534 -* ((( 535 -RPi3/4 converter PCB 536 -))) 537 -* ((( 538 -Screws to hole converter PCB on RPI. 539 -))) 481 +**~ PG1302-PI Package Includes**: 482 + 483 +* PG1302 x 1 484 +* LoRa Antenna x 1 485 +* RPi3/4 converter PCB 486 +* Screws to hole converter PCB on RPI. 487 + 488 + 489 +8. Reference 490 + 491 +* Datasheet, User Manual & Software Download: 492 + 493 + [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 494 + 495 + 496 +9. Support 497 + 498 +* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 499 +* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to 500 + 501 + [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]