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,24 +11,24 @@ 11 11 12 12 **PG1302 LoRaWAN Concentrator User Manual** 13 13 14 -[[image:1651796979665-130.png]] 15 15 16 -Document Version: 1.0.0 17 17 18 -Image Version: v1.0 19 19 20 20 18 +{{toc/}} 21 21 22 22 23 - {{toc numbered="true" depth="4"/}}21 +---- 24 24 23 +(% class="wikigeneratedid" id="H" %) 24 +((( 25 + 26 +))) 25 25 28 +=== 1. Introduction === 26 26 30 +==== 1.1 What is PG1302 LoRaWAN Concentrator? ==== 27 27 28 -~1. Introduction 29 - 30 - 1.1 What is PG1302 LoRaWAN Concentrator? 31 - 32 32 ((( 33 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. 34 34 ))) ... ... @@ -47,7 +47,7 @@ 47 47 ))) 48 48 ))) 49 49 50 -1.2 Features 50 +==== 1.2 Features ==== 51 51 52 52 * Base on Semtech SX1302 solution 53 53 * Support Raspberry Pi 3B/3B+/4 ... ... @@ -56,35 +56,33 @@ 56 56 * Mini-PCIe Interface 57 57 * Converter board to support Raspberry Pi 58 58 59 +==== 1.3 General Interfaces ==== 59 59 60 -1.3 General Interfaces 61 - 62 62 * SPI interface for LoRa 63 63 * Power Input: 5v, 1A 64 64 * 1 x I-PEX for LoRa 65 65 65 +==== 1.4 Pin Mapping ==== 66 66 67 -1.4 Pin Mapping 68 - 69 69 [[image:1651743282627-547.png||height="402" width="425"]] 70 70 71 71 72 72 73 -1.5 LEDs 71 +==== 1.5 LEDs ==== 74 74 75 - 73 + TX: Blink when transmit a packet 76 76 77 - 75 + RX: Blink when receive a packet 78 78 79 - 77 + Config: Always ON 80 80 81 81 82 -1.6 Power Consumption 80 +==== 1.6 Power Consumption ==== 83 83 84 - 82 + TBD 85 85 86 86 87 -1.7 Applications 85 +==== 1.7 Applications ==== 88 88 89 89 * Smart Buildings & Home Automation 90 90 * Logistics and Supply Chain Management ... ... @@ -93,12 +93,13 @@ 93 93 * Smart Cities 94 94 * Smart Factory 95 95 94 +=== 2. Example: Set up as LoRaWAN gateway. === 96 96 97 -2. Example:Setup asLoRaWAN gateway.96 +==== 2.1 System structure ==== 98 98 99 - 2.1Systemstructure98 + 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. 100 100 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。100 + Set up method for other server are similar. 102 102 103 103 (% style="text-align:center" %) 104 104 [[image:1651743698677-436.png||height="457" width="686"]] ... ... @@ -105,7 +105,7 @@ 105 105 106 106 107 107 108 -2.2 Hardware Installation 107 +==== 2.2 Hardware Installation ==== 109 109 110 110 **~ Important Notice: **Please power the RPI with 5V,3A cable. 111 111 ... ... @@ -114,7 +114,7 @@ 114 114 115 115 116 116 117 -3. Install the software? 116 +=== 3. Install the software? === 118 118 119 119 There are two ways to install software in RPi4 to use PG1302. 120 120 ... ... @@ -121,19 +121,18 @@ 121 121 * Flash SD card with Dragino pre-build image which support Web UI. 122 122 * Install lora packet forwarder in existing RPi OS. 123 123 123 +=== 4. Flash with pre-build image === 124 124 125 -4. Flashwithpre-buildimage125 +==== 4.1 Download the dragino image for RPI ==== 126 126 127 - 4.1 Download the dragino image for RPI 128 - 129 129 Download PG1302_for_Rpi4_64_with_webui from 130 130 131 131 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 132 132 133 133 134 -4.2 Flash the image to SD card 132 +==== 4.2 Flash the image to SD card ==== 135 135 136 - Flash the image to SD card: 134 + Flash the image to SD card: 137 137 138 138 (% style="text-align:center" %) 139 139 [[image:1651744119133-233.png||height="373" width="621"]] ... ... @@ -143,12 +143,23 @@ 143 143 [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]] 144 144 145 145 146 -4.3 Access the Linux console .144 +==== 4.3 Access the Linux console ==== 147 147 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. 146 +((( 147 +((( 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 149 +))) 149 149 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 151 +((( 152 + 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. 153 +))) 151 151 155 +((( 156 + 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 157 +))) 158 +))) 159 + 160 + 152 152 (% style="text-align:center" %) 153 153 [[image:1651744193675-591.png||height="450" width="466"]] 154 154 ... ... @@ -171,19 +171,18 @@ 171 171 [[image:1651744358515-107.png||height="366" width="581"]] 172 172 173 173 174 - 4.4 Access the WebUI of RPi4. 183 +==== 4.4 Access the WebUI of RPi4. ==== 175 175 176 - 185 +===== 4.4.1 Home page ===== 177 177 178 - 187 + Open a browser on the PC and type the RPI ip address 179 179 180 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router) 189 + [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router) 181 181 191 + You will see the login interface of RPI as shown below. 182 182 183 - Youwillseethelogininterfaceof RPI as shown below.193 + The account details for Web Login are: 184 184 185 - The account details for Web Login are: 186 - 187 187 **~ User Name: root** 188 188 189 189 **~ Password: dragino** ... ... @@ -192,7 +192,7 @@ 192 192 [[image:1651744457761-993.png||height="352" width="621"]] 193 193 194 194 195 -4.4.2 LoRa Page 203 +===== 4.4.2 LoRa Page ===== 196 196 197 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. 198 198 ... ... @@ -216,66 +216,61 @@ 216 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]] 217 217 218 218 219 -4.4.3 LoRaWAN Page 227 +===== 4.4.3 LoRaWAN Page ===== 220 220 221 - 229 +====== 4.4.3.1 Semtech UDP ====== 222 222 223 223 224 224 (% style="text-align:center" %) 225 225 [[image:1651744767914-283.png||height="352" width="621"]] 226 226 235 + Note *: See this instruction for how to configure TTN. 227 227 237 + [[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);"]] 228 228 229 - Note *: See this instruction for how to configure TTN. 230 230 231 - [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_TTN>>url:https://wiki.dragino.com/index.php?title=Notes_for_TTN]]240 +====== 4.4.3.2 Basic Station ====== 232 232 233 - 234 -4.4.3.2 Basic Station 235 - 236 236 (% style="text-align:center" %) 237 237 [[image:1651744890629-683.png||height="380" width="621"]] 238 238 245 + Note *: See this instruction for how to configure TTN. 239 239 240 - Note *: SeethisnstructionforhowtofigureTTN.247 + [[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]] 241 241 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]] 243 243 250 +===== 4.4.4 LogRead ===== 244 244 245 -4.4.4 Lo gRead252 +====== 4.4.4.1 LoRa Log ====== 246 246 247 - 4.4.4.1 LoRa Log 248 - 249 249 (% style="text-align:center" %) 250 250 [[image:1651744955955-452.png||height="571" width="621"]] 251 251 257 + Show the frequency for LoRa Radio and traffics. 252 252 253 - Show the frequency for LoRa Radio and traffics. 254 254 260 +====== 4.4.4.2 System Log ====== 255 255 256 - 4.4.4.2SystemLog262 + Show system log. 257 257 258 - Show system log. 259 - 260 260 (% style="text-align:center" %) 261 261 [[image:1651745003470-264.png||height="477" width="621"]] 262 262 263 263 264 264 265 -4.4.4.3 Record Log 269 +====== 4.4.4.3 Record Log ====== 266 266 271 +**~ Record the system log.** 267 267 268 -**Record the system log.** 269 - 270 270 (% style="text-align:center" %) 271 271 [[image:1651745069814-662.png||height="144" width="621"]] 272 272 273 273 274 -5. Install stand alone LoRa Packet Forwarder. 277 +=== 5. Install stand alone LoRa Packet Forwarder. === 275 275 276 - 5.1 OS requirement 279 +==== 5.1 OS requirement ==== 277 277 278 - 281 + RPI in this example is RPI model 4B with fresh Raspbian OS install. 279 279 280 280 pi@raspberrypi:~~$ cat /etc/os-release 281 281 ... ... @@ -298,18 +298,20 @@ 298 298 BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs" 299 299 300 300 301 -5.2 Get Gateway ID in Raspberry and input this in TTN v3. 304 +==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ==== 302 302 303 - 306 + In RPI, run below command to get a Gateway ID 304 304 305 - 308 + (% class="mark" %)ifconfig eth0 306 306 307 307 (% style="text-align:center" %) 308 308 [[image:1651745210205-512.png||height="130" width="621"]] 309 309 310 310 311 - Make sure to select legacy packet forwarder.314 + 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. 312 312 316 + Make sure to select legacy packet forwarder. 317 + 313 313 (% style="text-align:center" %) 314 314 [[image:1651745267862-321.png||height="526" width="621"]] 315 315 ... ... @@ -324,9 +324,8 @@ 324 324 [[image:1651745366987-458.png||height="363" width="621"]] 325 325 326 326 332 +===== 5.2.1 Download and install LoRaWAN packet forwarder ===== 327 327 328 -5.2.1 Download and install LoRaWAN packet forwarder 329 - 330 330 Enable SPI and I2C first: 331 331 332 332 a)SPI needs to be enabled on the Raspberry Pi ... ... @@ -372,22 +372,22 @@ 372 372 [[image:1651745657252-173.png||height="426" width="621"]] 373 373 374 374 375 -5. 5.2 Config Gateway ID, Frequency Band and Server address379 +===== 5.2.2 Config Gateway ID, Frequency Band and Server address ===== 376 376 377 - 381 + 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** 378 378 379 - 383 + 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. 380 380 381 381 (% style="text-align:center" %) 382 382 [[image:1651745709709-887.png||height="820" width="621"]] 383 383 384 384 385 - 389 + User can find the TTN v3 server address from: 386 386 387 - 391 + [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]] 388 388 389 389 390 - 394 + And the default frequency band is US915 in **global_conf.json** file. 391 391 392 392 (% style="text-align:center" %) 393 393 [[image:1651745838008-820.png||height="650" width="621"]] ... ... @@ -411,48 +411,48 @@ 411 411 412 412 * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file. 413 413 418 +(% class="wikigeneratedid" %) 419 +((( 420 + 421 +))) 414 414 415 -5.2.3 Check result 423 +===== 5.2.3 Check result ===== 416 416 417 - 425 + Run below command to restart the dragino_fwd: 418 418 419 419 sudo systemctl stop draginofwd 420 420 421 421 sudo systemctl start draginofwd 422 422 423 - 431 + debug check the ruing status of fwd: 424 424 425 - sudo systemctl status draginofwd 433 + sudo systemctl status draginofwd 426 426 427 427 (% style="text-align:center" %) 428 428 [[image:1651746045057-414.png]] 429 429 430 430 431 - 439 + The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: 432 432 433 433 (% style="text-align:center" %) 434 434 [[image:1651746078253-168.png||height="372" width="621"]] 435 435 436 436 445 + We can check dragino_fwd running states in RPi by running: 437 437 438 - We canheckdragino_fwdrunning states in RPi by running:447 + //**sudo journalctl -u draginofwd -f**// 439 439 440 - //**sudo journalctl -u draginofwd -f**// 441 - 442 442 (% style="text-align:center" %) 443 443 [[image:1651746111963-838.png]] 444 444 452 + If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data 445 445 446 - 447 - If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data 448 - 449 449 (% style="text-align:center" %) 450 450 [[image:1651746139304-966.png||height="326" width="621"]] 451 451 452 452 458 +===== 5.2.4 Commands to handle service ===== 453 453 454 -5.2.4 Commands to handle service 455 - 456 456 * **Stop** dragino_fwd service: sudo systemctl stop draginofwd 457 457 * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd 458 458 * **Start** dragino_fwd : sudo systemctl start draginofwd ... ... @@ -459,26 +459,24 @@ 459 459 * **Auto run** dragino_fwd after boot: sudo systemctl enable draginofwd 460 460 * **Show status** of dragino_fwd: sudo systemctl status draginofwd 461 461 466 +=== 6. Order Info === 462 462 463 - 6.Order Info468 + Part Number: **PG1302-XX** Or Part Number: **PG1302-PI-XX **(Include RPi converter board for RPI 3/4) 464 464 465 - Part Number:**PG1302-XX**OrPartNumber:**PG1302-PI-XX(Include RPi converter board for RPI 3/4)470 +**~ XX:** 466 466 467 -**~ XX:** 468 - 469 469 * 868 (For Bands: EU868,IN865) 470 470 * 915 (For Bands: US915,AU915,AS923,KR920) 471 471 * 470 (For Band: CN470) 472 472 476 +=== 7. Packing Info === 473 473 474 - 7.Packing Info478 +**~ PG1302 Package Includes**: 475 475 476 -**~ PG1302 Package Includes**: 477 - 478 478 * PG1302 x 1 479 479 * LoRa Antenna x 1 480 480 481 -**~ PG1302-PI Package Includes**: 483 +**~ PG1302-PI Package Includes**: 482 482 483 483 * PG1302 x 1 484 484 * LoRa Antenna x 1 ... ... @@ -485,15 +485,14 @@ 485 485 * RPi3/4 converter PCB 486 486 * Screws to hole converter PCB on RPI. 487 487 490 +=== 8. Reference === 488 488 489 -8. Reference 490 - 491 491 * Datasheet, User Manual & Software Download: 492 492 493 493 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] 494 494 495 495 496 -9. Support 497 +=== 9. Support === 497 497 498 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 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