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

Applications

Navigation

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