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

Applications

Navigation

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