<
From version < 99.14 >
edited by Xiaoling
on 2022/05/25 16:36
To version < 98.23 >
edited by Xiaoling
on 2022/05/14 15:29
>
Change comment: There is no comment for this version

Summary

Details

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