<
From version < 67.1 >
edited by Xiaoling
on 2022/05/06 11:06
To version < 94.1 >
edited by Edwin Chen
on 2022/05/06 20:02
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
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  
... ... @@ -28,25 +28,85 @@
28 28  ==== 1.1 What is PG1302 LoRaWAN Concentrator? ====
29 29  
30 30  (((
31 -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 +(((
34 +(((
35 +(((
36 + The PG1302 is a multi-channel high performance transmitter/receiver designed to simultaneously receive several
32 32  )))
38 +)))
33 33  
34 34  (((
35 -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.
41 +(((
42 + LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection
36 36  )))
37 37  
38 38  (((
39 -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.
46 + between a central wireless data concentrator and a massive amount of wireless end-points spread over
40 40  )))
41 41  
42 42  (((
50 + a very wide range of distances.
51 +)))
52 +)))
53 +)))
54 +
43 43  (((
56 +(((
57 +(((
44 44  
45 45  )))
46 46  )))
61 +)))
62 +)))
47 47  
48 -1.2 Features
64 +(((
65 +(((
66 +(((
67 +(((
68 + The PG1302 is design to use with Raspberry Pi to build smart metering fixed networks and Internet of Things
69 +)))
70 +)))
49 49  
72 +(((
73 +(((
74 + applications with up to 5000 nodes per km2 in moderately interfered environment.
75 +)))
76 +)))
77 +)))
78 +
79 +(((
80 +(((
81 +(((
82 +
83 +)))
84 +)))
85 +)))
86 +)))
87 +
88 +(((
89 +(((
90 +(((
91 +(((
92 + PG1302 is fully compatible with RPi3/4, users can use the pre-build OS from Dragino to set up and easy to use the
93 +)))
94 +)))
95 +
96 +(((
97 +(((
98 + module by Web UI. Or install the raw lorawan driver in the exist OS.
99 +)))
100 +)))
101 +)))
102 +)))
103 +
104 +(((
105 +(((
106 +
107 +)))
108 +)))
109 +
110 +==== 1.2 Features ====
111 +
50 50  * Base on Semtech SX1302 solution
51 51  * Support Raspberry Pi 3B/3B+/4
52 52  * Up to -140dBm sensitivity
... ... @@ -54,33 +54,39 @@
54 54  * Mini-PCIe Interface
55 55  * Converter board to support Raspberry Pi
56 56  
57 -1.3 General Interfaces
119 +==== 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
125 +==== 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
131 +==== 1.5 LEDs ====
70 70  
71 - TX: Blink when transmit a packet
133 +(((
134 + TX: Blink when transmit a packet
135 +)))
72 72  
73 - RX: Blink when receive a packet
137 +(((
138 + RX: Blink when receive a packet
139 +)))
74 74  
75 - Config: Always ON
141 +(((
142 + Config: Always ON
143 +)))
76 76  
77 77  
78 -1.6 Power Consumption
146 +==== 1.6 Power Consumption ====
79 79  
80 - TBD
148 + TBD
81 81  
82 82  
83 -1.7 Applications
151 +==== 1.7 Applications ====
84 84  
85 85  * Smart Buildings & Home Automation
86 86  * Logistics and Supply Chain Management
... ... @@ -89,18 +89,24 @@
89 89  * Smart Cities
90 90  * Smart Factory
91 91  
92 -2. Example: Set up as LoRaWAN gateway.
160 +=== 2. Example: Set up as LoRaWAN gateway. ===
93 93  
94 - 2.1 System structure
162 +==== 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。
164 +(((
165 + This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with
166 +)))
97 97  
168 +(((
169 + [[TheThingsNetwork>>url:http://www.thethingsnetwork.org/]](TTN) LoRaWAN server. Set up method for other server are similar.
170 +)))
171 +
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
177 +==== 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?
186 +=== 3. Install the software? ===
113 113  
114 114   There are two ways to install software in RPi4 to use PG1302.
115 115  
... ... @@ -116,18 +116,22 @@
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
193 +=== 4. Flash with pre-build image ===
120 120  
121 - 4.1 Download the dragino image for RPI
195 +==== 4.1 Download the dragino image for RPI ====
122 122  
123 - Download PG1302_for_Rpi4_64_with_webui from
197 +(((
198 + Download PG1302_for_Rpi4_64_with_webui from
199 +)))
124 124  
125 - [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
201 +(((
202 + [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
203 +)))
126 126  
127 127  
128 -4.2 Flash the image to SD card
206 +==== 4.2 Flash the image to SD card ====
129 129  
130 - Flash the image to SD card:
208 + 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,35 @@
137 137   [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
138 138  
139 139  
140 -4.3 Access the Linux console.
218 +==== 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.
220 +(((
221 +(((
222 +(((
223 + Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s
224 +)))
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
226 +(((
227 + management portal, you should be able to find what IP address the router has assigned to the RPI. You can
228 +)))
145 145  
230 +(((
231 + use this IP to connect the WEB UI or SSH access of RPI.
232 +)))
233 +)))
234 +
235 +(((
236 +(((
237 + 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.
238 +)))
239 +
240 +(((
241 + Below are screenshots
242 +)))
243 +)))
244 +)))
245 +
246 +
146 146  (% style="text-align:center" %)
147 147  [[image:1651744193675-591.png||height="450" width="466"]]
148 148  
... ... @@ -165,35 +165,51 @@
165 165  [[image:1651744358515-107.png||height="366" width="581"]]
166 166  
167 167  
168 - 4.4 Access the WebUI of RPi4.
269 +==== 4.4 Access the WebUI of RPi4. ====
169 169  
170 - 4.4.1 Home page
271 +===== 4.4.1 Home page =====
171 171  
172 - Open a browser on the PC and type the RPI ip address
273 +(((
274 + Open a browser on the PC and type the RPI ip address
275 +)))
173 173  
174 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
277 +(((
278 + [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
279 +)))
175 175  
281 +(((
282 + You will see the login interface of RPI as shown below.
283 +)))
176 176  
177 - You will see the login interface of RPI as shown below.
285 +(((
286 + The account details for Web Login are:
287 +)))
178 178  
179 - The account details for Web Login are:
180 -
289 +(((
181 181  **~ User Name: root**
291 +)))
182 182  
293 +(((
183 183  **~ Password:   dragino**
295 +)))
184 184  
185 185  (% style="text-align:center" %)
186 186  [[image:1651744457761-993.png||height="352" width="621"]]
187 187  
188 188  
189 -4.4.2 LoRa Page
301 +===== 4.4.2 LoRa Page =====
190 190  
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.
303 +(((
304 + This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
305 +)))
192 192  
307 +(((
308 + protocol, and user can customize the band* as well.
309 +)))
310 +
193 193  (% style="text-align:center" %)
194 194  [[image:1651744554845-970.png||height="328" width="621"]]
195 195  
196 -
197 197   Different PG1302 hardware version can support different frequency range:
198 198  
199 199   ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
... ... @@ -200,7 +200,6 @@
200 200  
201 201   ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
202 202  
203 -
204 204   After user choose the frequency plan, he can see the actually frequency in used by checking the
205 205  
206 206   page LogRead ~-~-> LoRa Log
... ... @@ -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
329 +===== 4.4.3 LoRaWAN Page =====
214 214  
215 - 4.4.3.1 Semtech UDP
331 +====== 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  
337 + Note *: See this instruction for how to configure TTN.
221 221  
339 + [[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]]
342 +====== 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  
347 + Note *: See this instruction for how to configure TTN.
233 233  
234 - Note *: See this instruction for how to configure TTN.
349 + [[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  
352 +===== 4.4.4 LogRead =====
238 238  
239 -4.4.4 LogRead
354 +====== 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  
359 + Show the frequency for LoRa Radio and traffics.
246 246  
247 - Show the frequency for LoRa Radio and traffics.
248 248  
362 +====== 4.4.4.2 System Log ======
249 249  
250 -4.4.4.2 System Log
364 + 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
371 +====== 4.4.4.3 Record Log ======
260 260  
373 +**~ 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.
379 +=== 5. Install stand alone LoRa Packet Forwarder. ===
269 269  
270 - 5.1 OS requirement
381 +==== 5.1 OS requirement ====
271 271  
272 - RPI in this example is RPI model 4B with fresh Raspbian OS install.
383 + 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,17 +292,22 @@
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.
406 +==== 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
408 + In RPI, run below command to get a Gateway ID
298 298  
299 - ifconfig eth0
410 + (% class="mark" %)ifconfig eth0
300 300  
301 301  (% style="text-align:center" %)
302 302  [[image:1651745210205-512.png||height="130" width="621"]]
303 303  
415 +(((
416 + We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
417 +)))
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.
419 +(((
420 + gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
421 +)))
306 306  
307 307  (% style="text-align:center" %)
308 308  [[image:1651745267862-321.png||height="526" width="621"]]
... ... @@ -318,9 +318,8 @@
318 318  [[image:1651745366987-458.png||height="363" width="621"]]
319 319  
320 320  
437 +===== 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,34 @@
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
484 +===== 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**
486 +(((
487 + After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
488 +)))
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.
490 +(((
491 +**~ gateway_ID** in file **local_conf.json**
492 +)))
374 374  
494 +(((
495 + The default LoRaWAN server points to localhost, user need to put the correct server address to the
496 +)))
497 +
498 +(((
499 + server_address field in file **local_conf.json**, like below.
500 +)))
501 +
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:
506 + 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]]
508 + [[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.
511 + 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,57 @@
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
535 +(% class="wikigeneratedid" %)
536 +(((
537 +
538 +)))
409 409  
410 - Run below command to restart the dragino_fwd:
540 +===== 5.2.3 Check result =====
411 411  
542 +(((
543 + Run below command to restart the dragino_fwd:
544 +)))
545 +
546 +(((
412 412   sudo systemctl stop draginofwd
548 +)))
413 413  
550 +(((
414 414   sudo systemctl start draginofwd
552 +)))
415 415  
416 - debug check the ruing status of fwd:
554 +(((
555 + debug check the ruing status of fwd:
556 +)))
417 417  
418 - sudo systemctl status draginofwd
558 +(((
559 + sudo systemctl status draginofwd
560 +)))
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:
566 + 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  
572 + 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:
574 + //**sudo journalctl -u draginofwd -f**//
432 432  
433 - //**sudo journalctl -u draginofwd -f**//
434 -
435 -(% style="text-align:center" %)
436 436  [[image:1651746111963-838.png]]
437 437  
578 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
438 438  
439 439  
440 - If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
441 -
442 -(% style="text-align:center" %)
443 443  [[image:1651746139304-966.png||height="326" width="621"]]
444 444  
445 445  
584 +===== 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,40 +452,44 @@
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
592 +=== 6. Order Info ===
456 456  
457 - Part Number: **PG1302-XX**  Or Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
594 + Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
458 458  
459 -**~ XX:**
596 +**~ 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
602 +=== 7. Packing Info ===
466 466  
467 -**~ PG1302 Package Includes**:
604 +(((
605 +**~ PG1302 Package Includes**:
606 +)))
468 468  
469 -* PG1302 x 1
470 -* LoRa Antenna x 1
608 +* (((
609 +PG1302 x 1
610 +)))
611 +* (((
612 +LoRa Antenna x 1
613 +)))
471 471  
472 -**~ PG1302-PI Package Includes**:
615 +(((
616 +**~ PG1302-PI Package Includes**:
617 +)))
473 473  
474 -* PG1302 x 1
475 -* LoRa Antenna x 1
476 -* RPi3/4 converter PCB
477 -* Screws to hole converter PCB on RPI.
619 +* (((
620 +PG1302 x 1
621 +)))
622 +* (((
623 +LoRa Antenna x 1
624 +)))
625 +* (((
626 +RPi3/4 converter PCB
627 +)))
628 +* (((
629 +Screws to hole converter PCB on RPI.
630 +)))
478 478  
479 -8. Reference
480 -
481 -* Datasheet, User Manual & Software Download:
482 -
483 - [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
484 -
485 -
486 -9. Support
487 -
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 -* 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
490 -
491 - [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]
632 +
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0