Last modified by Kilight Cao on 2024/06/22 10:43
<
From version < 67.1 >
edited by Xiaoling
on 2022/05/06 11:06
To version < 85.1 >
edited by Xiaoling
on 2022/05/06 15:42
>
Change comment: There is no comment for this version

Summary

Details

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

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0