<
From version < 96.1 >
edited by Edwin Chen
on 2022/05/06 20:06
To version < 128.1 >
edited by Kilight Cao
on 2023/05/18 09:28
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -PG1302
1 +PG1302 - LoRaWAN Concentrator User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Kilight
Content
... ... @@ -1,155 +3,84 @@
1 -
2 -
3 3  (% style="text-align:center" %)
4 -[[image:Main.User Manual for All Gateway models.WebHome@pg1302.jpg]]
2 +[[image:image-20220616085956-1.jpeg||height="609" width="609"]]
5 5  
6 6  
7 7  
8 8  
7 +**Table of Contents:**
9 9  
10 -
11 -
12 -**PG1302 LoRaWAN Concentrator User Manual**
13 -
14 -
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 ===
17 += 1. Introduction =
29 29  
30 -==== 1.1 What is PG1302 LoRaWAN Concentrator? ====
19 +== 1.1 What is PG1302 LoRaWAN Concentrator? ==
31 31  
32 -(((
33 -(((
34 -(((
35 -(((
36 - The PG1302 is a multi-channel high performance transmitter/receiver designed to simultaneously receive several
37 -)))
38 -)))
39 39  
40 40  (((
41 -(((
42 - LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection
23 +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.
43 43  )))
44 44  
45 45  (((
46 - between a central wireless data concentrator and a massive amount of wireless end-points spread over
27 +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.
47 47  )))
48 48  
49 49  (((
50 - a very wide range of distances.
31 +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.
51 51  )))
52 -)))
53 -)))
54 54  
55 -(((
56 -(((
57 -(((
58 -
59 -)))
60 -)))
61 -)))
62 -)))
63 63  
64 -(((
65 -(((
66 -(((
67 -(((
68 - The PG1302 is design to use with Raspberry Pi to build smart metering fixed networks and Internet of Things
69 -)))
70 -)))
35 +== 1.2 Features ==
71 71  
72 -(((
73 -(((
74 - applications with up to 5000 nodes per km2 in moderately interfered environment.
75 -)))
76 -)))
77 -)))
78 78  
79 -(((
80 -(((
81 -(((
82 -
83 -)))
84 -)))
85 -)))
86 -)))
87 -
88 -(((
89 -(((
90 -(((
91 -(((
92 - PG1302 is fully compatible with RPi3/4, users can use the pre-build OS from Dragino to set up and easy to use the
93 -)))
94 -)))
95 -
96 -(((
97 -(((
98 - module by Web UI. Or install the raw lorawan driver in the exist OS.
99 -)))
100 -)))
101 -)))
102 -)))
103 -
104 -(((
105 -(((
106 -
107 -)))
108 -)))
109 -
110 -==== 1.2 Features ====
111 -
112 112  * Base on Semtech SX1302 solution
113 -* Support Raspberry Pi 3B/3B+/4
39 +* Support Raspberry Pi 3B/3B+/4, TinkerBoard2/2S, Orange Pi Pc/PC PLUS.
114 114  * Up to -140dBm sensitivity
115 115  * Support 3.3v and 5v.
116 116  * Mini-PCIe Interface
117 117  * Converter board to support Raspberry Pi
118 118  
119 -==== 1.3 General Interfaces ====
120 120  
46 +== 1.3 General Interfaces for PG1302 ==
47 +
48 +
121 121  * SPI interface for LoRa
122 122  * Power Input: 5v, 1A
123 123  * 1 x I-PEX for LoRa
52 +* Working Temperature: -40 ℃ ~~ 80℃
124 124  
125 -==== 1.4 Pin Mapping ====
126 126  
55 +== 1.4 Pin Mapping ==
56 +
57 +
127 127   [[image:1651743282627-547.png||height="402" width="425"]]
128 128  
129 129  
61 +== 1.5 LEDs ==
130 130  
131 -==== 1.5 LEDs ====
132 132  
133 133  (((
134 - TX: Blink when transmit a packet
65 +TX: Blink when transmit a packet
66 +RX: Blink when receive a packet
67 +Config: Always ON
135 135  )))
136 136  
137 -(((
138 - RX: Blink when receive a packet
139 -)))
140 140  
141 -(((
142 - Config: Always ON
143 -)))
71 +== 1.6 Power Consumption ==
144 144  
145 145  
146 -==== 1.6 Power Consumption ====
74 +<300mA @ 3.3v.
147 147  
148 - TBD
76 +Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
149 149  
150 150  
151 -==== 1.7 Applications ====
79 +== 1.7 Applications ==
152 152  
81 +
153 153  * Smart Buildings & Home Automation
154 154  * Logistics and Supply Chain Management
155 155  * Smart Metering
... ... @@ -157,478 +157,630 @@
157 157  * Smart Cities
158 158  * Smart Factory
159 159  
160 -=== 2. Example: Set up as LoRaWAN gateway. ===
161 161  
162 -==== 2.1 System structure ====
90 += 2. Example: Set up as LoRaWAN gateway =
163 163  
164 -(((
165 - This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with
166 -)))
92 +== 2.1 System structure ==
167 167  
94 +
168 168  (((
169 - [[TheThingsNetwork>>url:http://www.thethingsnetwork.org/]](TTN) LoRaWAN server. Set up method for other server are similar.
96 +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.
97 +
98 +
170 170  )))
171 171  
172 -(% style="text-align:center" %)
173 173  [[image:1651743698677-436.png||height="457" width="686"]]
174 174  
175 175  
104 +== 2.2 Hardware Installation ==
176 176  
177 -==== 2.2 Hardware Installation ====
178 178  
179 -**~ Important Notice: **Please power the RPI with 5V,3A cable.
107 +(% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
180 180  
181 -(% style="text-align:center" %)
182 -[[image:1651743803032-803.png]]
109 +[[image:image-20220621104746-1.png||height="381" width="451"]]
183 183  
184 184  
112 += 3. Install the software? =
185 185  
186 -=== 3. Install the software? ===
187 187  
188 - There are two ways to install software in RPi4 to use PG1302.
115 +**Raspberry Pi 3B/3B+/4,**
189 189  
190 -* Flash SD card with Dragino pre-build image which support Web UI.
191 -* Install lora packet forwarder in existing RPi OS.
117 +* Flash SD card with Dragino pre-build image which supports Web UI.
118 +* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in existing RPi OS.
192 192  
193 -=== 4. Flash with pre-build image ===
120 +**TinkerBoard2/2S, **
194 194  
195 -==== 4.1 Download the dragino image for RPI ====
122 +* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS.
196 196  
197 -(((
198 - Download PG1302_for_Rpi4_64_with_webui from
199 -)))
124 +**Orange Pi PC/PC PLUS.**
200 200  
126 +* Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS.
127 +
128 +
129 += 4. Flash with pre-build image =
130 +
131 +== 4.1 Download the dragino image for RPI ==
132 +
133 +
201 201  (((
202 - [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
135 +Download PG1302_for_Rpi4_64_with_webui from: [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
203 203  )))
204 204  
205 205  
206 -==== 4.2 Flash the image to SD card ====
139 +== 4.2 Flash the image to an SD card ==
207 207  
208 - Flash the image to SD card:
209 209  
210 -(% style="text-align:center" %)
142 +Flash the image to the SD card:
143 +
211 211  [[image:1651744119133-233.png||height="373" width="621"]]
212 212  
213 - Note: Download the flash tool following this link
214 214  
215 - [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
147 +(% style="color:red" %)**Note: Download the flash tool following this link:**[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
216 216  
217 217  
218 -==== 4.3 Access the Linux console ====
150 +== 4.3 Access the Linux console ==
219 219  
152 +
220 220  (((
154 +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
155 +)))
156 +
157 +
158 +[[image:1651744193675-591.png||height="450" width="466"]]
159 +
160 +The account details for Web Login are:
161 +
221 221  (((
163 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
164 +)))
165 +
222 222  (((
223 - Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s
167 +**~ (% style="color:#0000ff" %)Password:   dragino(%%)**
224 224  )))
225 225  
226 226  (((
227 - management portal, you should be able to find what IP address the router has assigned to the RPI. You can
171 +
228 228  )))
229 229  
230 230  (((
231 - use this IP to connect the WEB UI or SSH access of RPI.
175 +**~ (% style="color:#0000ff" %)Backup account(%%)**
232 232  )))
233 -)))
234 234  
235 235  (((
236 -(((
237 - 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.
179 +**~ (% style="color:#0000ff" %)Pi/dragino(%%)**
180 +
181 +
238 238  )))
239 239  
184 +After logging in, you will be in the Linux console and type the command here.
185 +
186 +[[image:1651744358515-107.png||height="366" width="581"]]
187 +
188 +
189 +== 4.4 Access the WebUI of RPi4 ==
190 +
191 +=== 4.4.1 Home page ===
192 +
193 +
240 240  (((
241 - Below are screenshots
195 +Open a browser on the PC and type the RPI ip address **http:~/~/IP_ADDRESS ** (If the IP is assigned by the uplink router)
196 +You will see the login interface of RPI as shown below.
197 +The account details for Web Login are:
242 242  )))
243 -)))
244 -)))
245 245  
200 +(((
201 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
202 +(% style="color:#0000ff" %)** Password:   dragino**
246 246  
247 -(% style="text-align:center" %)
248 -[[image:1651744193675-591.png||height="450" width="466"]]
204 +
205 +)))
249 249  
207 +[[image:1651744457761-993.png||height="352" width="621"]]
250 250  
251 - The account details for Web Login are:
252 252  
253 -**~ User Name: root**
210 +=== 4.4.2 LoRa Page ===
254 254  
255 -**~ Password:   dragino**
256 256  
213 +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.
257 257  
258 -**~ Backup account**
259 259  
260 -**~ Pi/dragino**
216 +[[image:1651744554845-970.png||height="328" width="621"]]
261 261  
262 262  
263 - After log in, you will be in the Linux console and type command here.
219 +Different PG1302 hardware version can support different frequency range:
264 264  
265 -(% style="text-align:center" %)
266 -[[image:1651744358515-107.png||height="366" width="581"]]
221 +* (% style="color:red" %)**868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.**
222 +* (% style="color:red" %)**915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920**
267 267  
224 +After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:#037691" %)**page LogRead ~-~-> LoRa Log**
268 268  
269 -==== 4.4 Access the WebUI of RPi4. ====
226 +(% style="color:red" %)**Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
270 270  
271 -===== 4.4.1 Home page =====
272 272  
273 -(((
274 - Open a browser on the PC and type the RPI ip address
275 -)))
229 +=== 4.4.3 LoRaWAN Page ===
276 276  
277 -(((
278 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
279 -)))
231 +==== 4.4.3.1 Semtech UDP ====
280 280  
281 -(((
282 - You will see the login interface of RPI as shown below.
283 -)))
284 284  
285 -(((
286 - The account details for Web Login are:
287 -)))
234 +[[image:1651744767914-283.png||height="352" width="621"]]
288 288  
289 -(((
290 -**~ User Name: root**
291 -)))
292 292  
293 -(((
294 -**~ Password:   dragino**
295 -)))
237 +(% style="color:red" %)**Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].**
296 296  
297 -(% style="text-align:center" %)
298 -[[image:1651744457761-993.png||height="352" width="621"]]
299 299  
240 +==== 4.4.3.2 Basic Station ====
300 300  
301 -===== 4.4.2 LoRa Page =====
302 302  
303 -(((
304 - This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
305 -)))
243 +[[image:1651744890629-683.png||height="380" width="621"]]
306 306  
307 -(((
308 - protocol, and user can customize the band* as well.
309 -)))
310 310  
311 -(% style="text-align:center" %)
312 -[[image:1651744554845-970.png||height="328" width="621"]]
246 +(% style="color:red" %)**Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**
313 313  
314 - Different PG1302 hardware version can support different frequency range:
315 315  
316 - ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
249 +=== 4.4.4 LogRead ===
317 317  
318 - ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
251 +==== 4.4.4.1 LoRa Log ====
319 319  
320 - After user choose the frequency plan, he can see the actually frequency in used by checking the
321 321  
322 - page LogRead ~-~-> LoRa Log
254 +[[image:1651744955955-452.png||height="571" width="621"]]
323 323  
324 - Note *: See this instruction for how to customize frequency band
325 325  
326 - [[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]]
257 +Show the frequency for LoRa Radio and traffics.
327 327  
328 328  
329 -===== 4.4.3 LoRaWAN Page =====
260 +==== 4.4.4.2 System Log ====
330 330  
331 -====== 4.4.3.1 Semtech UDP ======
332 332  
263 +Show system log.
333 333  
334 -(% style="text-align:center" %)
335 -[[image:1651744767914-283.png||height="352" width="621"]]
265 +[[image:1651745003470-264.png||height="477" width="621"]]
336 336  
337 - Note *: See this instruction for how to configure TTN.
338 338  
339 - [[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);"]]
268 +==== 4.4.4.3 Record Log ====
340 340  
341 341  
342 -====== 4.4.3.2 Basic Station ======
271 +**Record the system log.**
343 343  
344 -(% style="text-align:center" %)
345 -[[image:1651744890629-683.png||height="380" width="621"]]
273 +[[image:1651745069814-662.png||height="144" width="621"]]
346 346  
347 - Note *: See this instruction for how to configure TTN.
348 348  
349 - [[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]]
276 += 5. Install stand-alone LoRa Packet Forwarder =
350 350  
278 +== 5.1 Choose the right installation package for your OS ==
351 351  
352 -===== 4.4.4 LogRead =====
353 353  
354 -====== 4.4.4.1 LoRa Log ======
281 +(((
282 +**draginofwd-32bit (RPI, Orange PI)**
355 355  
356 -(% style="text-align:center" %)
357 -[[image:1651744955955-452.png||height="571" width="621"]]
284 +**Download URL:** https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb
358 358  
359 - Show the frequency for LoRa Radio and traffics.
286 +**Linux Command:** wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb
360 360  
361 361  
362 -====== 4.4.4.2 System Log ======
289 +**dragino-64bit (RPI, Orange PI)**
363 363  
364 - Show system log.
291 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb
292 +)))
365 365  
366 -(% style="text-align:center" %)
367 -[[image:1651745003470-264.png||height="477" width="621"]]
294 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb
368 368  
369 369  
297 +**dragino-tiker-32bit (Tinker Board)**
370 370  
371 -====== 4.4.4.3 Record Log ======
299 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb
372 372  
373 -**~ Record the system log.**
301 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb
374 374  
375 -(% style="text-align:center" %)
376 -[[image:1651745069814-662.png||height="144" width="621"]]
377 377  
304 +**Install details:**
378 378  
379 -=== 5. Install stand alone LoRa Packet Forwarder. ===
306 +[[image:image-20220928181226-1.png||height="218" width="1100"]]
380 380  
381 -==== 5.1 OS requirement ====
382 382  
383 - RPI in this example is RPI model 4B with fresh Raspbian OS install.
309 +RPI in this example is RPI model 4B with fresh Raspbian OS install.
384 384  
311 +(% class="box" %)
312 +(((
385 385   pi@raspberrypi:~~$ cat /etc/os-release
386 -
387 387   PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
388 -
389 389   NAME="Raspbian GNU/Linux"
390 -
391 391   VERSION_ID="8"
392 -
393 393   VERSION="8 (jessie)"
394 -
395 395   ID=raspbian
396 -
397 397   ID_LIKE=debian
398 -
399 399   HOME_URL="http:~/~/www.raspbian.org/"
400 -
401 401   SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
402 -
403 403   BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
404 404  
324 +
325 +)))
405 405  
406 -==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
407 407  
408 - In RPI, run below command to get a Gateway ID
328 +== 5.2 Select the mode of connection to the server ==
409 409  
410 - (% class="mark" %)ifconfig eth0
411 411  
412 -(% style="text-align:center" %)
413 -[[image:1651745210205-512.png||height="130" width="621"]]
331 +The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode.
414 414  
333 +The User can choose one of the methods as the connection mode.
334 +
335 +
336 +**~1. Semtech UDP Mode  ~-~-> 5.2.1**
337 +
338 +**2. Basic Station Mode  ~-~-> 5.2.2**
339 +
340 +
341 +=== 5.2.1 Semtech UDP Mode ===
342 +
343 +
344 +==== **a). Get a gateway EUI from the device ETH MAC.** ====
345 +
346 +
347 +In RPI, run the below command to get a Gateway ID
348 +
349 +(% class="box infomessage" %)
415 415  (((
416 - We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
351 +**~ ifconfig eth0**
417 417  )))
418 418  
354 +[[image:1651745210205-512.png||height="130" width="621"]]
355 +
356 +
419 419  (((
420 - gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
358 +(((
359 +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.
360 +
361 +
362 +
363 +==== **b). Input this Gateway EUI to the TTN-Stack** ====
364 +
365 +
421 421  )))
367 +)))
422 422  
423 -(% style="text-align:center" %)
424 424  [[image:1651745267862-321.png||height="526" width="621"]]
425 425  
371 +[[image:1651745306744-481.png||height="478" width="621"]]
426 426  
427 427  
428 -(% style="text-align:center" %)
429 -[[image:1651745306744-481.png||height="478" width="621"]]
430 430  
431 -After set up, the status should show not connected as below:
375 +==== **c). After Register, the status should show not connected as below:** ====
432 432  
433 -(% style="text-align:center" %)
377 +
434 434  [[image:1651745366987-458.png||height="363" width="621"]]
435 435  
436 436  
437 -===== 5.2.1 Download and install LoRaWAN packet forwarder =====
438 438  
439 - Enable SPI and I2C first:
382 +==== **d). Enable SPI and I2C on your device** ====
440 440  
441 - a)SPI needs to be enabled on the Raspberry Pi
442 442  
443 - Run sudo raspi-config to open the config window
385 +**the below example is using Raspberry 4B.**
444 444  
445 -(% style="text-align:center" %)
446 -[[image:1651745476754-240.png||height="235" width="631"]]
447 447  
388 +Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window
448 448  
449 -(% style="text-align:center" %)
450 -[[image:image-20220505181135-1.png]]
390 +[[image:1651745476754-240.png||height="234" width="629"]]
451 451  
452 -(% style="text-align:center" %)
453 -[[image:image-20220505181135-2.png]]
454 454  
393 +[[image:image-20220505181135-1.png]]
455 455  
456 456  
396 +[[image:image-20220505181135-2.png||height="229" width="622"]]
457 457  
458 - In RPI , Fist: Enter root account:
459 459  
460 -(% style="text-align:center" %)
461 -[[image:1651745583363-614.png]]
462 462  
400 +==== **e). Access the root account:** ====
463 463  
464 - and then run:
402 +(((
403 +[[image:1651745583363-614.png||height="151" width="732"]]
465 465  
466 - 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]]
467 467  
468 - chmod +x ./auto_install.sh
406 +
407 +)))
469 469  
470 - ./auto_install.sh
409 +==== **f). Modify the configuration of FWD** ====
471 471  
472 -(% style="text-align:center" %)
473 -[[image:1651745611629-818.png]]
474 474  
412 +(((
413 +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.**
414 +)))
475 475  
476 - This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
416 +(((
417 +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.
477 477  
478 - You can get these output:
479 479  
480 -(% style="text-align:center" %)
481 -[[image:1651745657252-173.png||height="426" width="621"]]
420 +the User can find the lora configuration directory in (% style="color:#0000ff" %)**/etc/lora/**(%%) there are the cfg-302 directory and the global_conf.json, and local_conf.json files.
482 482  
422 +/etc/lora/
423 +├── cfg-302  ~-~--> global configuration file
424 +├── devskey  ~-~--> Database
425 +├── global_conf.json  ~-~--> Frequency plan for current applications
426 +└── local_conf.json  ~-~--> Local fwd configuration
483 483  
484 -===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
428 +At default, the users need to change two configurations file: global_conf.json and local_conf.json.
485 485  
486 -(((
487 - After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
488 -)))
489 489  
490 -(((
491 -**~ gateway_ID** in file **local_conf.json**
492 -)))
431 +===== **1.) Configure gateway EUI and server address, port for fwd** =====
493 493  
494 -(((
495 - The default LoRaWAN server points to localhost, user need to put the correct server address to the
433 +
496 496  )))
497 497  
498 -(((
499 - server_address field in file **local_conf.json**, like below.
500 -)))
501 -
502 -(% style="text-align:center" %)
503 503  [[image:1651745709709-887.png||height="820" width="621"]]
504 504  
505 505  
506 - User can find the TTN v3 server address from:
439 +**Note: Users can find the TTN v3 server address from [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]**
507 507  
508 - [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
509 509  
442 +===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** =====
510 510  
511 - And the default frequency band is US915 in **global_conf.json** file.
512 512  
513 -(% style="text-align:center" %)
445 +the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
446 +
514 514  [[image:1651745838008-820.png||height="650" width="621"]]
515 515  
516 516  
517 -* 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.**
450 +If the user wants to change to other frequency bands, the 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(%%).**
518 518  
519 - 1).Chose your need the name of region frequency.
452 +**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //**
520 520  
521 -(% style="text-align:center" %)
522 -[[image:1651745867516-322.png]]
523 523  
524 524  
525 - 2). Use this command to copy it.
456 +====== **Selecting the appropriate frequency plan for your region in cfg-302.** ======
526 526  
527 - cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
458 +[[image:1651745867516-322.png||height="83" width="740"]]
528 528  
529 -(% style="text-align:center" %)
530 -[[image:1651745984006-868.png]]
531 531  
461 +====== **Override the global_conf.json** ======
532 532  
533 -* If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
534 -
535 -(% class="wikigeneratedid" %)
463 +(% class="box infomessage" %)
536 536  (((
537 -
465 +**cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json**
538 538  )))
539 539  
540 -===== 5.2.3 Check result =====
468 +[[image:1651745984006-868.png||height="87" width="745"]]
541 541  
542 -(((
543 - Run below command to restart the dragino_fwd:
544 -)))
545 545  
471 +==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ====
472 +
473 +
546 546  (((
547 - sudo systemctl stop draginofwd
475 +Run the below command to restart the dragino_fwd:
548 548  )))
549 549  
550 550  (((
551 - sudo systemctl start draginofwd
479 +(% class="box infomessage" %)
480 +(((
481 +**sudo systemctl start draginofwd**
552 552  )))
483 +)))
553 553  
554 554  (((
555 - debug check the ruing status of fwd:
486 +debug check the ruing status of fwd:
556 556  )))
557 557  
558 558  (((
559 - sudo systemctl status draginofwd
490 +(% class="box infomessage" %)
491 +(((
492 +**sudo systemctl status draginofwd**
560 560  )))
494 +)))
561 561  
562 -(% style="text-align:center" %)
563 -[[image:1651746045057-414.png]]
496 +[[image:1651746045057-414.png||height="193" width="729"]]
564 564  
565 565  
566 - The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
499 +Wait for a few minutes, the gateway will be online/active on the TTN-Stack.
567 567  
568 -(% style="text-align:center" %)
569 569  [[image:1651746078253-168.png||height="372" width="621"]]
570 570  
571 571  
572 -We can check dragino_fwd running states in RPi by running:
573 573  
505 +Get the draginofwd real-time running log:
506 +
574 574  (% class="box infomessage" %)
575 575  (((
576 - **// sudo journalctl -u draginofwd -f//**
509 +**~ sudo journalctl -u draginofwd -f**
577 577  )))
578 578  
579 -[[image:1651746111963-838.png]]
512 +[[image:1651746111963-838.png||height="184" width="730"]]
580 580  
581 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
582 582  
583 583  
516 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)**TTN v3 –> Gateway ~-~-> Live data**
517 +
584 584  [[image:1651746139304-966.png||height="326" width="621"]]
585 585  
586 586  
587 -===== 5.2.4 Commands to handle service =====
521 +==== **h). Commands to handle service** ====
588 588  
589 -* **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
590 -* **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
591 -* **Start** dragino_fwd : sudo systemctl start draginofwd
592 -* **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
593 -* **Show status** of dragino_fwd:  sudo systemctl status draginofwd
523 +* (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service:  sudo systemctl stop draginofwd
524 +* (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
525 +* (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd
526 +* (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot:  sudo systemctl enable draginofwd
527 +* (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd:  sudo systemctl status draginofwd
594 594  
595 -=== 6. Order Info ===
596 596  
597 - Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
530 +=== 5.2.2 Basic Station Mode. ===
598 598  
599 -**~ XX:**
600 600  
601 -* 868 (For Bands: EU868,IN865)
602 -* 915 (For Bands: US915,AU915,AS923,KR920)
603 -* 470 (For Band: CN470)
533 +==== **a). Get a gateway EUI from the device ETH MAC.** ====
604 604  
605 -=== 7. Packing Info ===
606 606  
536 +In RPI, run the below command to get a Gateway EUI
537 +
538 +(% class="box infomessage" %)
607 607  (((
608 -**~ PG1302 Package Includes**:
540 +**~ ifconfig eth0**
609 609  )))
610 610  
611 -* (((
612 -PG1302 x 1
543 +[[image:1651745210205-512.png||height="130" width="621"]]
544 +
545 +
546 +(((
547 +(((
548 +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.
613 613  )))
614 -* (((
615 -LoRa Antenna x 1
616 616  )))
617 617  
552 +
553 +
554 +==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ====
555 +
556 +
557 +[[image:image-20230329164417-5.png]]
558 +
559 +
560 +
561 +==== **c). Download the gateway API keys, and then upload them to the gateway.** ====
562 +
563 +
564 +[[image:image-20230329164704-6.png]]
565 +
566 +
567 +==== **d). The status Shows disconnect.** ====
568 +
569 +
570 +[[image:image-20230329165619-7.png||height="568" width="948"]]
571 +
572 +
573 +==== **e.) Uploda API keys into the gateway** ====
574 +
575 +
576 +the User can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/**(%%) there is the station.conf files, and ttnstack directory.
577 +
578 +//**directory tree:**//
579 +
580 +///etc/station/
581 +├── station.conf 
582 +└── ttnstack  ~-~--> ** ttnstack configuration file directory**
583 + ├── cups.trust  ~-~-->  ttnstack auth file
584 + ├── cups.uri  ~-~-->  ttnstack server URI file
585 + └── station.conf  ~-~-~-~-> backup configuration file//
586 +
587 +
588 +
589 +**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))**
590 +
591 +eg:
592 +
593 +/etc/station/
594 +├── cups.key  ~-~--> uploaded by you
595 +├── lns.key  ~-~--> uploaded by you
596 +├── station.conf
597 +
598 +
599 +==== **f). Configure gateway EUI and server address** ====
600 +
601 +
602 +[[image:image-20230329195650-10.png]]
603 +
604 +
605 +After the user enters the correct parameters, the server will be run automatically
606 +
607 +
608 +Tree Directory:
609 +
610 +/etc/station/
611 +├── cups.key
612 +├── cups.trust
613 +├── cups.uri
614 +├── lns.key
615 +├── start-configure.sh
616 +├── station.conf
617 +└── ttnstack
618 + ├── cups.trust
619 + ├── cups.uri
620 + └── station.conf
621 +
622 +
623 +==== **g). Check station running log** ====
624 +
625 +
626 +tail -f /var/log/station.log
627 +
628 +
629 +[[image:image-20230329201624-11.png]]
630 +
631 +
632 += 6. Trouble Shooting =
633 +
634 +
635 +== 6.1 Failed to start the concentrator how to debug ==
636 +
637 +
638 +When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled,
639 +
640 +Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct.
641 +
642 +(% class="box infomessage" %)
618 618  (((
619 -**~ PG1302-PI Package Includes**:
644 +i2cdetect -y 1
620 620  )))
621 621  
622 -* (((
623 -PG1302 x 1
647 +[[image:image-20230518091900-1.png]]
648 +
649 +
650 +Check whether the SPI path of the configuration file is correct,
651 +
652 +(% class="box infomessage" %)
653 +(((
654 +cat /etc/lora/global_conf.json
624 624  )))
625 -* (((
626 -LoRa Antenna x 1
656 +
657 +(% class="wikigeneratedid" %)
658 +[[image:image-20230518092732-2.png||height="378" width="691"]]
659 +
660 +
661 +
662 += 7. Order Info =
663 +
664 +
665 +Part Number: (% style="color:#0000ff" %)**PG1302-XX**   (%%) Or  Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX   **(%%)(Include RPi converter board for RPI 3/4)
666 +
667 +**~ (% style="color:#0000ff" %)XX:(%%)**
668 +
669 +* (% style="color:red" %)**868** (%%)(For Bands: EU868,IN865)
670 +* (% style="color:red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)
671 +* (% style="color:red" %)**470** (%%)(For Band: CN470)
672 +
673 +
674 += 8. Packing Info =
675 +
676 +
677 +(((
678 +**PG1302 Package Includes**:
627 627  )))
628 -* (((
629 -RPi3/4 converter PCB
680 +
681 +(((
682 +* PG1302 x 1
683 +* LoRa Antenna x 1
630 630  )))
631 -* (((
632 -Screws to hole converter PCB on RPI.
685 +
686 +
687 +(((
688 +**PG1302-PI Package Includes**:
633 633  )))
634 634  
691 +* PG1302 x 1
692 +* LoRa Antenna x 1
693 +* RPi3/4 converter PCB
694 +* Screws to hole converter PCB on RPI.
695 +
696 +**PG1302-PI Dimension and weight: **
697 +
698 +* Device Size: 18 x 8 x 4 cm
699 +* Weight: 150g
700 +
701 +
702 += 9. Support =
703 +
704 +
705 +(((
706 +If you are experiencing issues and can't solve, you can send mail to
707 +)))
708 +
709 +(((
710 +[[support@dragino.com>>mailto:support@dragino.com]]
711 +)))
712 +
713 +(((
714 +With your question as detail as possible. We will reply and help you in the shortest.
715 +)))
image-20220616085956-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +717.6 KB
Content
image-20220621104746-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +861.7 KB
Content
image-20220928181226-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +29.1 KB
Content
image-20230329164417-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +46.4 KB
Content
image-20230329164704-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +16.6 KB
Content
image-20230329165619-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +106.9 KB
Content
image-20230329195416-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +9.3 KB
Content
image-20230329195442-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +9.9 KB
Content
image-20230329195650-10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +27.7 KB
Content
image-20230329201624-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +20.1 KB
Content
image-20230518091900-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +6.8 KB
Content
image-20230518092732-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +35.1 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0