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