Last modified by Kilight Cao on 2024/06/22 10:43
<
From version < 98.16 >
edited by Xiaoling
on 2022/05/07 17:09
To version < 99.13 >
edited by Xiaoling
on 2022/05/25 16:30
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -PG1302
1 +PG1302 LoRaWAN Concentrator
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:Main.User Manual for All Gateway models.WebHome@pg1302.jpg]]
2 +[[image:Main.User Manual for All Gateway models.WebHome@pg1302.jpg||height="391" width="549"]]
3 3  
4 4  
5 5  
... ... @@ -6,6 +6,7 @@
6 6  **PG1302 LoRaWAN Concentrator User Manual**
7 7  
8 8  
9 +**Table of Contents：**
9 9  
10 10  {{toc/}}
11 11  
... ... @@ -15,17 +15,23 @@
15 15  
16 16  )))
17 17  
18 -=== 1. Introduction ===
19 += 1. Introduction =
19 19  
20 -==== 1.1 What is PG1302 LoRaWAN Concentrator? ====
21 +== 1.1 What is PG1302 LoRaWAN Concentrator? ==
21 21  
23 +(((
22 22  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.
25 +)))
23 23  
27 +(((
24 24  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.
29 +)))
25 25  
31 +(((
26 26  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.
33 +)))
27 27  
28 -==== 1.2 Features ====
35 +== 1.2 Features ==
29 29  
30 30  * Base on Semtech SX1302 solution
31 31  * Support Raspberry Pi 3B/3B+/4
... ... @@ -34,33 +34,28 @@
34 34  * Mini-PCIe Interface
35 35  * Converter board to support Raspberry Pi
36 36  
37 -==== 1.3 General Interfaces ====
44 +== 1.3 General Interfaces ==
38 38  
39 39  * SPI interface for LoRa
40 40  * Power Input: 5v, 1A
41 41  * 1 x I-PEX for LoRa
42 42  
43 -==== 1.4 Pin Mapping ====
50 +== 1.4 Pin Mapping ==
44 44  
45 45   [[image:1651743282627-547.png||height="402" width="425"]]
46 46  
54 +== 1.5 LEDs ==
47 47  
48 -
49 -==== 1.5 LEDs ====
50 -
51 51   TX: Blink when transmit a packet
52 52   RX: Blink when receive a packet
53 53   Config: Always ON
54 54  
60 +== 1.6 Power Consumption ==
55 55  
56 -
57 -==== 1.6 Power Consumption ====
58 -
59 59   TBD
60 60  
64 +== 1.7 Applications ==
61 61  
62 -==== 1.7 Applications ====
63 -
64 64  * Smart Buildings & Home Automation
65 65  * Logistics and Supply Chain Management
66 66  * Smart Metering
... ... @@ -68,46 +68,36 @@
68 68  * Smart Cities
69 69  * Smart Factory
70 70  
71 -=== 2. Example: Set up as LoRaWAN gateway. ===
73 += 2. Example: Set up as LoRaWAN gateway. =
72 72  
73 -==== 2.1 System structure ====
75 +== 2.1 System structure ==
74 74  
75 75  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.
76 76  
77 77  [[image:1651743698677-436.png||height="457" width="686"]]
78 78  
81 +== 2.2 Hardware Installation ==
79 79  
83 +(% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
80 80  
81 -==== 2.2 Hardware Installation ====
82 -
83 -**Important Notice: **Please power the RPI with 5V,3A cable.
84 -
85 85  [[image:1651743803032-803.png]]
86 86  
87 += 3. Install the software? =
87 87  
88 -
89 -=== 3. Install the software? ===
90 -
91 91  There are two ways to install software in RPi4 to use PG1302.
92 92  
93 93  * Flash SD card with Dragino pre-build image which support Web UI.
94 94  * Install lora packet forwarder in existing RPi OS.
95 95  
96 -=== 4. Flash with pre-build image ===
94 += 4. Flash with pre-build image =
97 97  
98 -==== 4.1 Download the dragino image for RPI ====
96 +== 4.1 Download the dragino image for RPI ==
99 99  
100 -(((
101 101  Download PG1302_for_Rpi4_64_with_webui from
102 -)))
103 -
104 -(((
105 105  [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
106 -)))
107 107  
101 +== 4.2 Flash the image to SD card ==
108 108  
109 -==== 4.2 Flash the image to SD card ====
110 -
111 111  Flash the image to SD card:
112 112  
113 113  [[image:1651744119133-233.png||height="373" width="621"]]
... ... @@ -116,9 +116,8 @@
116 116  
117 117   [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
118 118  
111 +== 4.3 Access the Linux console ==
119 119  
120 -==== 4.3 Access the Linux console ====
121 -
122 122  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
123 123  
124 124  [[image:1651744193675-591.png||height="450" width="466"]]
... ... @@ -125,56 +125,48 @@
125 125  
126 126  The account details for Web Login are:
127 127  
128 -**~ User Name: root**
129 -
130 -**~ Password:   dragino**
131 -
132 -
133 -**~ Backup account**
134 -
135 -**~ Pi/dragino**
136 -
137 -After log in, you will be in the Linux console and type command here.
138 -
139 -[[image:1651744358515-107.png||height="366" width="581"]]
140 -
141 -
142 -==== 4.4 Access the WebUI of RPi4. ====
143 -
144 -===== 4.4.1 Home page =====
145 -
146 146  (((
147 -Open a browser on the PC and type the RPI ip address
120 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
148 148  )))
149 149  
150 150  (((
151 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
124 +**~ (% style="color:#0000ff" %)Password:   dragino(%%)**
152 152  )))
153 153  
154 154  (((
155 -You will see the login interface of RPI as shown below.
128 +
156 156  )))
157 157  
158 158  (((
159 -The account details for Web Login are:
132 +**~ (% style="color:#0000ff" %)Backup account(%%)**
160 160  )))
161 161  
162 162  (((
163 -**~ User Name: root**
136 +**~ (% style="color:#0000ff" %)Pi/dragino(%%)**
164 164  )))
165 165  
139 +After log in, you will be in the Linux console and type command here.
140 +
141 +[[image:1651744358515-107.png||height="366" width="581"]]
142 +
143 +== 4.4 Access the WebUI of RPi4. ==
144 +
145 +=== 4.4.1 Home page ===
146 +
147 +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 uplink router)
148 +You will see the login interface of RPI as shown below.
149 +The account details for Web Login are:
150 +
166 166  (((
167 -**~ Password:   dragino**
152 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
153 +(% style="color:#0000ff" %)** Password:   dragino**
168 168  )))
169 169  
170 170  [[image:1651744457761-993.png||height="352" width="621"]]
171 171  
158 +=== 4.4.2 LoRa Page ===
172 172  
173 -===== 4.4.2 LoRa Page =====
174 -
175 -(((
176 176  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.
177 -)))
178 178  
179 179  [[image:1651744554845-970.png||height="328" width="621"]]
180 180  
... ... @@ -188,24 +188,20 @@
188 188  
189 189  page LogRead ~-~-> LoRa Log
190 190  
191 -Note *: See this instruction for how to customize frequency band
174 +Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]
192 192  
193 -[[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]]
194 194  
177 +=== 4.4.3 LoRaWAN Page ===
195 195  
196 -===== 4.4.3 LoRaWAN Page =====
179 +==== 4.4.3.1 Semtech UDP ====
197 197  
198 -====== 4.4.3.1 Semtech UDP ======
199 -
200 200  [[image:1651744767914-283.png||height="352" width="621"]]
201 201  
202 -Note *: See this instruction for how to configure TTN.
183 +Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].
203 203  
204 -[[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);"]]
205 205  
186 +==== 4.4.3.2 Basic Station ====
206 206  
207 -====== 4.4.3.2 Basic Station ======
208 -
209 209  [[image:1651744890629-683.png||height="380" width="621"]]
210 210  
211 211  Note *: See this instruction for how to configure TTN.
... ... @@ -212,59 +212,48 @@
212 212  
213 213  [[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]]
214 214  
194 +=== 4.4.4 LogRead ===
215 215  
216 -===== 4.4.4 LogRead =====
196 +==== 4.4.4.1 LoRa Log ====
217 217  
218 -====== 4.4.4.1 LoRa Log ======
219 -
220 220  [[image:1651744955955-452.png||height="571" width="621"]]
221 221  
222 222  Show the frequency for LoRa Radio and traffics.
223 223  
202 +==== 4.4.4.2 System Log ====
224 224  
225 -====== 4.4.4.2 System Log ======
226 -
227 227  Show system log.
228 228  
229 229  [[image:1651745003470-264.png||height="477" width="621"]]
230 230  
208 +==== 4.4.4.3 Record Log ====
231 231  
232 -====== 4.4.4.3 Record Log ======
233 -
234 234  **Record the system log.**
235 235  
236 236  [[image:1651745069814-662.png||height="144" width="621"]]
237 237  
214 += 5. Install stand alone LoRa Packet Forwarder. =
238 238  
239 -=== 5. Install stand alone LoRa Packet Forwarder. ===
216 +== 5.1 OS requirement ==
240 240  
241 -==== 5.1 OS requirement ====
242 -
243 243  RPI in this example is RPI model 4B with fresh Raspbian OS install.
244 244  
245 - pi@raspberrypi:~~$ cat /etc/os-release
246 -
220 +(% class="box" %)
221 +(((
222 + pi@raspberrypi:~~$ cat /etc/os-release
247 247   PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
248 -
249 249   NAME="Raspbian GNU/Linux"
250 -
251 251   VERSION_ID="8"
252 -
253 253   VERSION="8 (jessie)"
254 -
255 255   ID=raspbian
256 -
257 257   ID_LIKE=debian
258 -
259 259   HOME_URL="http:~/~/www.raspbian.org/"
260 -
261 261   SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
262 -
263 263   BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
232 +)))
264 264  
234 +== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ==
265 265  
266 -==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
267 -
268 268  In RPI, run below command to get a Gateway ID
269 269  
270 270  (% class="box infomessage" %)
... ... @@ -275,8 +275,10 @@
275 275  [[image:1651745210205-512.png||height="130" width="621"]]
276 276  
277 277  (((
246 +(((
278 278  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.
279 279  )))
249 +)))
280 280  
281 281  [[image:1651745267862-321.png||height="526" width="621"]]
282 282  
... ... @@ -286,51 +286,54 @@
286 286  
287 287  [[image:1651745366987-458.png||height="363" width="621"]]
288 288  
259 +=== 5.2.1 Download and install LoRaWAN packet forwarder ===
289 289  
290 -===== 5.2.1 Download and install LoRaWAN packet forwarder =====
291 -
292 292  Enable SPI and I2C first:
293 293  
294 294  a)SPI needs to be enabled on the Raspberry Pi
295 295  
296 -Run sudo raspi-config to open the config window
265 +Run (% style="background-color:#dcdcdc" %)**sudo raspi-config**(%%) to open the config window
297 297  
298 -[[image:1651745476754-240.png||height="235" width="631"]]
267 +[[image:1651745476754-240.png||height="234" width="629"]]
299 299  
300 300  [[image:image-20220505181135-1.png]]
301 301  
302 -[[image:image-20220505181135-2.png]]
271 +[[image:image-20220505181135-2.png||height="229" width="622"]]
303 303  
304 304  In RPI , Fist: Enter root account:
305 305  
306 -[[image:1651745583363-614.png]]
275 +(((
276 +[[image:1651745583363-614.png||height="151" width="732"]]
277 +)))
307 307  
308 -
309 309  and then run:
310 310  
311 -wget [[https:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/auto_install.sh>>url:https://www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/auto_install.sh]]
281 +(% style="background-color:#dcdcdc" %)wget [[https:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/auto_install.sh>>url:https://www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/auto_install.sh]]
312 312  
313 -chmod +x ./auto_install.sh
283 +(% style="background-color:#dcdcdc" %)chmod +x ./auto_install.sh
314 314  
315 -./auto_install.sh
285 +(% style="background-color:#dcdcdc" %)./auto_install.sh
316 316  
317 -[[image:1651745611629-818.png]]
287 +(((
288 +[[image:1651745611629-818.png||height="225" width="729"]]
289 +)))
318 318  
319 319  This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
320 320  
321 321  You can get these output:
322 322  
295 +(((
323 323  [[image:1651745657252-173.png||height="426" width="621"]]
297 +)))
324 324  
299 +=== 5.2.2 Config Gateway ID, Frequency Band and Server address ===
325 325  
326 -===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
327 -
328 328  (((
329 -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.**
302 +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.**
330 330  )))
331 331  
332 332  (((
333 -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.
306 +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.
334 334  )))
335 335  
336 336  [[image:1651745709709-887.png||height="820" width="621"]]
... ... @@ -339,32 +339,26 @@
339 339  
340 340  [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
341 341  
315 +And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file.
342 342  
343 -And the default frequency band is US915 in **global_conf.json** file.
344 -
345 345  [[image:1651745838008-820.png||height="650" width="621"]]
346 346  
347 -* If user want to change to other frequency bands, User can copy the file from **/etc/lora/cfg-302 **and put it into** /etc/lora/global_conf.json.**
319 +* 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(%%).**
348 348  
349 349   1).Chose your need the name of region frequency.
350 350  
351 -[[image:1651745867516-322.png]]
323 +[[image:1651745867516-322.png||height="83" width="740"]]
352 352  
353 353   2). Use this command to copy it.
354 354  
355 355   cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
356 356  
357 -[[image:1651745984006-868.png]]
329 +[[image:1651745984006-868.png||height="87" width="745"]]
358 358  
359 -* If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
331 +* If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
360 360  
361 -(% class="wikigeneratedid" %)
362 -(((
363 -
364 -)))
333 +=== 5.2.3 Check result ===
365 365  
366 -===== 5.2.3 Check result =====
367 -
368 368  (((
369 369  Run below command to restart the dragino_fwd:
370 370  )))
... ... @@ -392,7 +392,7 @@
392 392  )))
393 393  )))
394 394  
395 -[[image:1651746045057-414.png]]
362 +[[image:1651746045057-414.png||height="193" width="729"]]
396 396  
397 397  The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
398 398  
... ... @@ -403,62 +403,67 @@
403 403  
404 404  (% class="box infomessage" %)
405 405  (((
406 - **// sudo journalctl -u draginofwd -f//**
373 + sudo journalctl -u draginofwd -f
407 407  )))
408 408  
409 -[[image:1651746111963-838.png]]
376 +[[image:1651746111963-838.png||height="184" width="730"]]
410 410  
411 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
378 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in **TTN v3 –> Gateway ~-~-> Live data**
412 412  
413 -
414 414  [[image:1651746139304-966.png||height="326" width="621"]]
415 415  
382 +=== 5.2.4 Commands to handle service ===
416 416  
417 -===== 5.2.4 Commands to handle service =====
384 +* (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service:  sudo systemctl stop draginofwd
385 +* (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
386 +* (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd
387 +* (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot:  sudo systemctl enable draginofwd
388 +* (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd:  sudo systemctl status draginofwd
418 418  
419 -* **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
420 -* **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
421 -* **Start** dragino_fwd : sudo systemctl start draginofwd
422 -* **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
423 -* **Show status** of dragino_fwd:  sudo systemctl status draginofwd
390 += 6. Order Info =
424 424  
425 -=== 6. Order Info ===
392 +Part Number: (% style="color:#0000ff" %)**PG1302-XX**   (%%) Or  Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX   **(%%)(Include RPi converter board for RPI 3/4)
426 426  
427 -Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
394 +**~ (% style="color:#0000ff" %)XX:(%%)**
428 428  
429 -**~ XX:**
396 +* (% style="color:#0000ff" %)868 (%%)(For Bands: EU868,IN865)
397 +* (% style="color:#0000ff" %)915 (%%)(For Bands: US915,AU915,AS923,KR920)
398 +* (% style="color:#0000ff" %)470 (%%)(For Band: CN470)
430 430  
431 -* 868 (For Bands: EU868,IN865)
432 -* 915 (For Bands: US915,AU915,AS923,KR920)
433 -* 470 (For Band: CN470)
400 += 7. Packing Info =
434 434  
435 -=== 7. Packing Info ===
436 -
437 437  (((
438 438  **PG1302 Package Includes**:
439 439  )))
440 440  
441 441  (((
407 +(((
442 442  * PG1302 x 1
409 +* LoRa Antenna x 1
443 443  )))
411 +)))
444 444  
445 445  (((
414 +**PG1302-PI Package Includes**:
415 +)))
416 +
417 +* PG1302 x 1
446 446  * LoRa Antenna x 1
419 +* RPi3/4 converter PCB
420 +* Screws to hole converter PCB on RPI.
421 +
422 +(((
423 += 8. Support =
424 +
425 +(((
426 +If you are experiencing issues and can’t solve, you can send mail to
447 447  )))
448 448  
449 449  (((
450 -**PG1302-PI Package Includes**:
430 +[[support@dragino.com>>mailto:support@dragino.com]]
451 451  )))
452 452  
453 -* (((
454 -PG1302 x 1
433 +(((
434 +With your question as detail as possible. We will reply and help you in the shortest.
455 455  )))
456 -* (((
457 -LoRa Antenna x 1
458 458  )))
459 -* (((
460 -RPi3/4 converter PCB
461 -)))
462 -* (((
463 -Screws to hole converter PCB on RPI.
464 -)))

Applications

Navigation

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