Last modified by Kilight Cao on 2024/06/22 10:43

From version 98.5
edited by Xiaoling
on 2022/05/07 11:54
Change comment: There is no comment for this version
To version 156.1
edited by Kilight Cao
on 2024/06/22 10:43
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.Xiaoling
1 +XWiki.Kilight
Content
... ... @@ -1,111 +3,95 @@
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 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 -)))
38 -)))
39 -)))
40 40  
41 41  (((
42 -(((
43 -(((
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.
23 +The PG1302 is a (% style="color:blue" %)**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.
45 45  )))
46 -)))
47 -)))
48 -)))
49 49  
50 50  (((
51 -(((
52 -(((
53 -(((
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.
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.
55 55  )))
56 -)))
57 -)))
58 -)))
59 59  
60 60  (((
61 -(((
62 -
31 +PG1302 is fully compatible with (% style="color:blue" %)**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.
63 63  )))
64 -)))
65 65  
66 -==== 1.2 Features ====
67 67  
35 +== 1.2 Features ==
36 +
37 +
68 68  * Base on Semtech SX1302 solution
69 -* Support Raspberry Pi 3B/3B+/4
39 +* Support Raspberry Pi 3B/3B+/4/4B/5/5B, TinkerBoard2/2S, Orange Pi Pc/PC PLUS.
70 70  * Up to -140dBm sensitivity
71 71  * Support 3.3v and 5v.
72 72  * Mini-PCIe Interface
73 73  * Converter board to support Raspberry Pi
74 74  
75 -==== 1.3 General Interfaces ====
45 +== 1.3 General Interfaces for PG1302 ==
76 76  
47 +
77 77  * SPI interface for LoRa
78 78  * Power Input: 5v, 1A
79 79  * 1 x I-PEX for LoRa
51 +* Working Temperature: -40 ℃ ~~ 80℃
80 80  
81 -==== 1.4 Pin Mapping ====
53 +== 1.4 Pin Mapping ==
82 82  
83 - [[image:1651743282627-547.png||height="402" width="425"]]
84 84  
85 85  
57 +[[image:image-20240506170941-3.png]]
86 86  
87 -==== 1.5 LEDs ====
59 +== 1.5 LEDs ==
88 88  
89 -(((
90 - TX: Blink when transmit a packet
91 -)))
92 92  
93 93  (((
94 - RX: Blink when receive a packet
63 +TX: Blink when transmit a packet
64 +RX: Blink when receiving a packet
65 +Config: Always ON
95 95  )))
96 96  
97 -(((
98 - Config: Always ON
99 -)))
100 100  
69 +== 1.6 Power Consumption ==
101 101  
102 -==== 1.6 Power Consumption ====
103 103  
104 - TBD
72 +<300mA @ 3.3v.
105 105  
74 +Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
106 106  
107 -==== 1.7 Applications ====
108 108  
77 +== 1.7 Antenna Installation ==
78 +
79 +
80 +Left:  **GPS antenna**
81 +
82 +Right:  **LoRa Antenna**
83 +
84 +[[image:https://www.thethingsnetwork.org/forum/uploads/default/original/3X/6/2/624619afa8d75a2c21bfd1e3687afaa75ad61cbc.jpeg||alt="PG1302_70"]]
85 +
86 +
87 +
88 +
89 +
90 +== 1.8 Applications ==
91 +
92 +
109 109  * Smart Buildings & Home Automation
110 110  * Logistics and Supply Chain Management
111 111  * Smart Metering
... ... @@ -113,445 +113,734 @@
113 113  * Smart Cities
114 114  * Smart Factory
115 115  
116 -=== 2. Example: Set up as LoRaWAN gateway. ===
100 += 2. Example: Set up as LoRaWAN gateway =
117 117  
118 -==== 2.1 System structure ====
102 +== 2.1 System structure ==
119 119  
104 +
120 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.
107 +
108 +
122 122  )))
123 123  
124 124  [[image:1651743698677-436.png||height="457" width="686"]]
125 125  
126 126  
114 +== 2.2 Hardware Installation ==
127 127  
128 -==== 2.2 Hardware Installation ====
129 129  
130 -**~ Important Notice: **Please power the RPI with 5V,3A cable.
117 +(% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
131 131  
132 -[[image:1651743803032-803.png]]
119 +[[image:image-20220621104746-1.png||height="351" width="415"]]
133 133  
134 134  
122 += 3. Install the software. =
135 135  
136 -=== 3. Install the software? ===
137 137  
138 - There are two ways to install software in RPi4 to use PG1302.
125 +**Raspberry Pi 3B/3B+/4B/5B**
139 139  
140 -* Flash SD card with Dragino pre-build image which support Web UI.
141 -* Install lora packet forwarder in existing RPi OS.
127 +* Flash SD card with Dragino pre-build image which supports Web UI.
128 +* 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.
142 142  
143 -=== 4. Flash with pre-build image ===
130 +**TinkerBoard2/2S, **
144 144  
145 -==== 4.1 Download the dragino image for RPI ====
132 +* 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.
146 146  
147 -(((
148 - Download PG1302_for_Rpi4_64_with_webui from
149 -)))
134 +**Orange Pi PC/PC PLUS.**
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 -)))
136 +* 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.
154 154  
138 += 4. Flash with pre-build image =
155 155  
156 -==== 4.2 Flash the image to SD card ====
140 +== 4.1 Download the dragino image for RPI ==
157 157  
158 - Flash the image to SD card:
159 159  
160 -[[image:1651744119133-233.png||height="373" width="621"]]
143 +(((
144 +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]]
145 +)))
161 161  
162 - Note: Download the flash tool following this link
163 163  
164 - [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
148 +== 4.2 Flash the image to an SD card ==
165 165  
166 166  
167 -==== 4.3 Access the Linux console ====
151 +Flash the image to the SD card:
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.
153 +[[image:1651744119133-233.png||height="373" width="621"]]
170 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 172  
173 -[[image:1651744193675-591.png||height="450" width="466"]]
156 +(% style="color:red" %)**Note: Download the flash tool following this link:**[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
174 174  
175 175  
176 - The account details for Web Login are:
159 +== 4.3 Access the Linux console ==
177 177  
178 -**~ User Name: root**
179 179  
180 -**~ Password:   dragino**
162 +(((
163 +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
164 +)))
181 181  
182 182  
183 -**~ Backup account**
167 +[[image:1651744193675-591.png||height="450" width="466"]]
184 184  
185 -**~ Pi/dragino**
169 +The account details for Web Login are:
186 186  
187 -
188 - After log in, you will be in the Linux console and type command here.
189 -
190 -[[image:1651744358515-107.png||height="366" width="581"]]
191 -
192 -
193 -==== 4.4 Access the WebUI of RPi4. ====
194 -
195 -===== 4.4.1 Home page =====
196 -
197 197  (((
198 -Open a browser on the PC and type the RPI ip address
172 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
199 199  )))
200 200  
201 201  (((
202 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
176 +**~ (% style="color:#0000ff" %)Password:   dragino(%%)**
203 203  )))
204 204  
205 205  (((
206 -You will see the login interface of RPI as shown below.
180 +
207 207  )))
208 208  
209 209  (((
210 -The account details for Web Login are:
184 +**~ (% style="color:#0000ff" %)Backup account(%%)**
211 211  )))
212 212  
213 213  (((
214 -**~ User Name: root**
215 -)))
188 +**~ (% style="color:#0000ff" %)Pi/dragino(%%)**
216 216  
217 -(((
218 -**~ Password:   dragino**
190 +
219 219  )))
220 220  
221 -(% style="text-align:center" %)
222 -[[image:1651744457761-993.png||height="352" width="621"]]
193 +After logging in, you will be in the Linux console and type the command here.
223 223  
195 +[[image:1651744358515-107.png||height="366" width="581"]]
224 224  
225 -===== 4.4.2 LoRa Page =====
226 226  
198 +== 4.4 Access the WebUI of RPi4 ==
199 +
200 +=== 4.4.1 Home page ===
201 +
202 +
227 227  (((
228 - This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
204 +Open a browser on the PC and type the RPI ip address **http:~/~/IP_ADDRESS ** (If the IP is assigned by the uplink router)
205 +You will see the login interface of RPI as shown below.
206 +The account details for Web Login are:
229 229  )))
230 230  
231 231  (((
232 - protocol, and user can customize the band* as well.
210 +**~ (% style="color:#0000ff" %)User Name: root(%%)**
211 +(% style="color:#0000ff" %)** Password:   dragino**
212 +
213 +
233 233  )))
234 234  
235 -(% style="text-align:center" %)
236 -[[image:1651744554845-970.png||height="328" width="621"]]
216 +[[image:1651744457761-993.png||height="352" width="621"]]
237 237  
238 - Different PG1302 hardware version can support different frequency range:
239 239  
240 - ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
219 +=== 4.4.2 LoRa Page ===
241 241  
242 - ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
243 243  
244 - After user choose the frequency plan, he can see the actually frequency in used by checking the
222 +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.
245 245  
246 - page LogRead ~-~-> LoRa Log
247 247  
248 - Note *: See this instruction for how to customize frequency band
225 +[[image:1651744554845-970.png||height="328" width="621"]]
249 249  
250 - [[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]]
251 251  
228 +Different PG1302 hardware version can support different frequency range:
252 252  
253 -===== 4.4.3 LoRaWAN Page =====
230 +* (% style="color:red" %)**868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.**
231 +* (% style="color:red" %)**915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920**
254 254  
255 -====== 4.4.3.1 Semtech UDP ======
233 +After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:#037691" %)**page LogRead ~-~-> LoRa Log**
256 256  
235 +(% style="color:red" %)**Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
257 257  
258 -(% style="text-align:center" %)
237 +
238 +=== 4.4.3 LoRaWAN Page ===
239 +
240 +==== 4.4.3.1 Semtech UDP ====
241 +
242 +
259 259  [[image:1651744767914-283.png||height="352" width="621"]]
260 260  
261 - Note *: See this instruction for how to configure TTN.
262 262  
263 - [[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);"]]
246 +(% style="color:red" %)**Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].**
264 264  
265 265  
266 -====== 4.4.3.2 Basic Station ======
249 +==== 4.4.3.2 Basic Station ====
267 267  
268 -(% style="text-align:center" %)
251 +
269 269  [[image:1651744890629-683.png||height="380" width="621"]]
270 270  
271 - Note *: See this instruction for how to configure TTN.
272 272  
273 - [[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]]
255 +(% style="color:red" %)**Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**
274 274  
275 275  
276 -===== 4.4.4 LogRead =====
258 +=== 4.4.4 LogRead ===
277 277  
278 -====== 4.4.4.1 LoRa Log ======
260 +==== 4.4.4.1 LoRa Log ====
279 279  
280 -(% style="text-align:center" %)
262 +
281 281  [[image:1651744955955-452.png||height="571" width="621"]]
282 282  
283 - Show the frequency for LoRa Radio and traffics.
284 284  
266 +Show the frequency for LoRa Radio and traffics.
285 285  
286 -====== 4.4.4.2 System Log ======
287 287  
288 - Show system log.
269 +==== 4.4.4.2 System Log ====
289 289  
290 -(% style="text-align:center" %)
271 +
272 +Show system log.
273 +
291 291  [[image:1651745003470-264.png||height="477" width="621"]]
292 292  
293 293  
277 +==== 4.4.4.3 Record Log ====
294 294  
295 -====== 4.4.4.3 Record Log ======
296 296  
297 -**~ Record the system log.**
280 +**Record the system log.**
298 298  
299 -(% style="text-align:center" %)
300 300  [[image:1651745069814-662.png||height="144" width="621"]]
301 301  
302 302  
303 -=== 5. Install stand alone LoRa Packet Forwarder. ===
285 += 5. Install stand-alone LoRa Packet Forwarder =
304 304  
305 -==== 5.1 OS requirement ====
287 +== 5.1 Choose the right installation package for your OS ==
306 306  
307 - RPI in this example is RPI model 4B with fresh Raspbian OS install.
308 308  
309 - pi@raspberrypi:~~$ cat /etc/os-release
290 +(((
291 +**draginofwd-32bit (RPI, Orange PI)**
310 310  
311 - PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
293 +**Download URL:** https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb
312 312  
313 - NAME="Raspbian GNU/Linux"
295 +**Linux Command:** wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-32bit.deb && dpkg -i draginofwd-32bit.deb
314 314  
315 - VERSION_ID="8"
316 316  
317 - VERSION="8 (jessie)"
298 +**dragino-64bit (RPI, Orange PI)**
318 318  
319 - ID=raspbian
300 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb
301 +)))
320 320  
321 - ID_LIKE=debian
303 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-64bit.deb && dpkg -i draginofwd-64bit.deb
322 322  
323 - HOME_URL="http:~/~/www.raspbian.org/"
324 324  
306 +**dragino-tiker-32bit (Tinker Board)**
307 +
308 +**Download URL: **https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb
309 +
310 +**Linux Command: **wget https:~/~/www.dragino.com/downloads/downloads/LoRa_Gateway/PG1302/software/draginofwd-tinker-32bit.deb && dpkg -i draginofwd-tinker-32bit.deb
311 +
312 +
313 +**Install details:**
314 +
315 +[[image:image-20220928181226-1.png||height="218" width="1100"]]
316 +
317 +
318 +RPI in this example is RPI model 4B with fresh Raspbian OS install.
319 +
320 +(% class="box" %)
321 +(((
322 +**~ pi@raspberrypi:~~$ cat /etc/os-release
323 + PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
324 + NAME="Raspbian GNU/Linux"
325 + VERSION_ID="8"
326 + VERSION="8 (jessie)"
327 + ID=raspbian
328 + ID_LIKE=debian
329 + HOME_URL="http:~/~/www.raspbian.org/"
325 325   SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
331 + BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"**
326 326  
327 - BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
333 +
334 +)))
328 328  
329 329  
330 -==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
337 +== 5.2 Select the mode of connection to the server ==
331 331  
332 - In RPI, run below command to get a Gateway ID
333 333  
334 - (% class="mark" %)ifconfig eth0
340 +The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode.
335 335  
336 -(% style="text-align:center" %)
337 -[[image:1651745210205-512.png||height="130" width="621"]]
342 +The User can choose one of the methods as the connection mode.
338 338  
344 +
345 +**~1. Semtech UDP Mode  ~-~-> 5.2.1**
346 +
347 +**2. Basic Station Mode  ~-~-> 5.2.2**
348 +
349 +
350 +=== 5.2.1 Semtech UDP Mode ===
351 +
352 +
353 +==== **a). Get a gateway EUI from the device ETH MAC.** ====
354 +
355 +
356 +In RPI, run the below command to get a Gateway ID
357 +
358 +(% class="box infomessage" %)
339 339  (((
340 - We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
360 +**~ ifconfig eth0**
341 341  )))
342 342  
363 +[[image:1651745210205-512.png||height="130" width="621"]]
364 +
365 +
343 343  (((
344 - gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
367 +(((
368 +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.
369 +
370 +
371 +
372 +==== **b). Input this Gateway EUI to the TTN-Stack** ====
373 +
374 +
345 345  )))
376 +)))
346 346  
347 -(% style="text-align:center" %)
348 348  [[image:1651745267862-321.png||height="526" width="621"]]
349 349  
380 +[[image:1651745306744-481.png||height="478" width="621"]]
350 350  
351 351  
352 -(% style="text-align:center" %)
353 -[[image:1651745306744-481.png||height="478" width="621"]]
354 354  
355 -After set up, the status should show not connected as below:
384 +==== **c). After Register, the status should show not connected as below:** ====
356 356  
357 -(% style="text-align:center" %)
386 +
358 358  [[image:1651745366987-458.png||height="363" width="621"]]
359 359  
360 360  
361 -===== 5.2.1 Download and install LoRaWAN packet forwarder =====
362 362  
363 - Enable SPI and I2C first:
391 +==== **d). Enable SPI and I2C on your device** ====
364 364  
365 - a)SPI needs to be enabled on the Raspberry Pi
366 366  
367 - Run sudo raspi-config to open the config window
394 +**the below example is using Raspberry 4B.**
368 368  
369 -(% style="text-align:center" %)
370 -[[image:1651745476754-240.png||height="235" width="631"]]
371 371  
397 +Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window
372 372  
373 -(% style="text-align:center" %)
399 +[[image:1651745476754-240.png||height="234" width="629"]]
400 +
401 +
374 374  [[image:image-20220505181135-1.png]]
375 375  
376 -(% style="text-align:center" %)
377 -[[image:image-20220505181135-2.png]]
378 378  
405 +[[image:image-20220505181135-2.png||height="229" width="622"]]
379 379  
380 380  
381 381  
382 - In RPI , Fist: Enter root account:
409 +==== **e). Access the root account:** ====
383 383  
384 -(% style="text-align:center" %)
385 -[[image:1651745583363-614.png]]
411 +(((
412 +[[image:1651745583363-614.png||height="151" width="732"]]
386 386  
387 387  
388 - and then run:
415 +
416 +)))
389 389  
390 - 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]]
418 +==== **f). Modify the configuration of FWD** ====
391 391  
392 - chmod +x ./auto_install.sh
393 393  
394 - ./auto_install.sh
421 +(((
422 +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.**
423 +)))
395 395  
396 -(% style="text-align:center" %)
397 -[[image:1651745611629-818.png]]
425 +(((
426 +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.
398 398  
399 399  
400 - This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
429 +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.
401 401  
402 - You can get these output:
431 +/etc/lora/
432 +├── cfg-302  ~-~--> global configuration file
433 +├── devskey  ~-~--> Database
434 +├── global_conf.json  ~-~--> Frequency plan for current applications
435 +└── local_conf.json  ~-~--> Local fwd configuration
403 403  
404 -(% style="text-align:center" %)
405 -[[image:1651745657252-173.png||height="426" width="621"]]
437 +At default, the users need to change two configurations file: global_conf.json and local_conf.json.
406 406  
407 407  
408 -===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
440 +===== **1.Configure gateway EUI and server address, port for fwd** =====
409 409  
442 +
443 +)))
444 +
445 +[[image:1651745709709-887.png||height="820" width="621"]]
446 +
447 +
448 +**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]]**
449 +
450 +
451 +===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** =====
452 +
453 +
454 +the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
455 +
456 +[[image:1651745838008-820.png||height="650" width="621"]]
457 +
458 +
459 +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(%%).**
460 +
461 +**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //**
462 +
463 +
464 +
465 +====== **Selecting the appropriate frequency plan for your region in cfg-302.** ======
466 +
467 +[[image:1651745867516-322.png||height="83" width="740"]]
468 +
469 +
470 +====== **Override the global_conf.json** ======
471 +
472 +(% class="box infomessage" %)
410 410  (((
411 - After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
474 +**cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json**
412 412  )))
413 413  
477 +[[image:1651745984006-868.png||height="87" width="745"]]
478 +
479 +
480 +==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ====
481 +
482 +
414 414  (((
415 -**~ gateway_ID** in file **local_conf.json**
484 +Run the below command to restart the dragino_fwd:
416 416  )))
417 417  
418 418  (((
419 - The default LoRaWAN server points to localhost, user need to put the correct server address to the
488 +(% class="box infomessage" %)
489 +(((
490 +**sudo systemctl start draginofwd**
420 420  )))
492 +)))
421 421  
422 422  (((
423 - server_address field in file **local_conf.json**, like below.
495 +debug check the ruing status of fwd:
424 424  )))
425 425  
426 -(% style="text-align:center" %)
427 -[[image:1651745709709-887.png||height="820" width="621"]]
498 +(((
499 +(% class="box infomessage" %)
500 +(((
501 +**sudo systemctl status draginofwd**
502 +)))
503 +)))
428 428  
505 +[[image:1651746045057-414.png||height="193" width="729"]]
429 429  
430 - User can find the TTN v3 server address from:
431 431  
432 - [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
508 +Wait for a few minutes, the gateway will be online/active on the TTN-Stack.
433 433  
510 +[[image:1651746078253-168.png||height="372" width="621"]]
434 434  
435 - And the default frequency band is US915 in **global_conf.json** file.
436 436  
437 -(% style="text-align:center" %)
438 -[[image:1651745838008-820.png||height="650" width="621"]]
439 439  
514 +Get the draginofwd real-time running log:
440 440  
441 -* 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.**
516 +(% class="box infomessage" %)
517 +(((
518 +**~ sudo journalctl -u draginofwd -f**
519 +)))
442 442  
443 - 1).Chose your need the name of region frequency.
521 +[[image:1651746111963-838.png||height="184" width="730"]]
444 444  
445 -(% style="text-align:center" %)
446 -[[image:1651745867516-322.png]]
447 447  
448 448  
449 - 2). Use this command to copy it.
525 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)**TTN v3 –> Gateway ~-~-> Live data**
450 450  
451 - cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
527 +[[image:1651746139304-966.png||height="326" width="621"]]
452 452  
453 -(% style="text-align:center" %)
454 -[[image:1651745984006-868.png]]
455 455  
530 +==== **h). Commands to handle service** ====
456 456  
457 -* If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
532 +* (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service:  sudo systemctl stop draginofwd
533 +* (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
534 +* (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd
535 +* (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot:  sudo systemctl enable draginofwd
536 +* (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd:  sudo systemctl status draginofwd
458 458  
459 -(% class="wikigeneratedid" %)
460 -(((
461 -
462 -)))
463 463  
464 -===== 5.2.3 Check result =====
465 465  
540 +
541 +=== 5.2.2 Basic Station Mode. ===
542 +
543 +
544 +The following example is connecting to TTNv3 via basic station:
545 +
546 +**[[Server Addresses ~| The Things Stack for Basic Station (thethingsindustries.com)>>https://console.cloud.thethings.network/]]**
547 +
548 +
549 +==== **a). Get a gateway EUI from the device ETH MAC.** ====
550 +
551 +
552 +In RPI, run the below command to get a Gateway EUI
553 +
554 +(% class="box infomessage" %)
466 466  (((
467 - Run below command to restart the dragino_fwd:
556 +**~ ifconfig eth0**
468 468  )))
469 469  
559 +[[image:1651745210205-512.png||height="130" width="621"]]
560 +
561 +
470 470  (((
471 - sudo systemctl stop draginofwd
563 +(((
564 +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.
472 472  )))
566 +)))
473 473  
568 +
569 +
570 +==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ====
571 +
572 +
573 +[[image:image-20230329164417-5.png]]
574 +
575 +
576 +
577 +==== **c). Download the gateway API keys, and then upload them to the gateway.** ====
578 +
579 +
580 +[[image:image-20230329164704-6.png]]
581 +
582 +
583 +==== **d). The status Shows disconnect.** ====
584 +
585 +
586 +[[image:image-20230329165619-7.png||height="568" width="948"]]
587 +
588 +
589 +==== **e.) Uploda API keys into the gateway** ====
590 +
591 +
592 +The user can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/:**
593 +
594 +//**directory tree:**//
595 +
596 +/etc/station/
597 +└── station.conf  ~-~--> station configuration file
598 +
599 +
600 +**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))**
601 +
602 +eg:
603 +
604 +/etc/station/.
605 +├── cups.key
606 +├── cups.trust
607 +├── cups.uri
608 +├── lns.key
609 +└── station.conf
610 +
611 +
612 +**lns.key and cups.key are generated by the preceding steps**
613 +
614 +
615 +**Download cups.trust**
616 +
617 +(% class="box infomessage" %)
474 474  (((
475 - sudo systemctl start draginofwd
619 +wget [[dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/cups.trust>>url:https://www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/cups.trust]]
476 476  )))
477 477  
622 +
623 +**Manually create and edit the cups.uri file**
624 +
625 +(% class="box infomessage" %)
478 478  (((
479 - debug check the ruing status of fwd:
627 +touch cups.uri
628 +
629 +nano cups.uri
480 480  )))
481 481  
632 +Then enter the URI address of the server, for example: **https:~/~/eu1.cloud.thethings.network:443**
633 +
634 +
635 +
636 +==== **f). Configure Gateway EUI** ====
637 +
638 +[[image:image-20240622094409-1.png]]
639 +
640 +
641 +
642 +
643 +==== **g). **Start the station service ====
644 +
645 +After configuring the GWEUI and uploading the certificate, you can start the station service via the below command:
646 +
647 +(% class="box infomessage" %)
482 482  (((
483 - sudo systemctl status draginofwd
649 +ln -sf /usr/bin/station_sx1302 /usr/bin/station
650 +
651 +systemctl start draginostation
484 484  )))
485 485  
486 -(% style="text-align:center" %)
487 -[[image:1651746045057-414.png]]
488 488  
655 +systemctl start draginostation  ~-~- start draginostation service
489 489  
490 - The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
657 +systemctl stop draginostation  ~-~- Stodraginostation service
491 491  
492 -(% style="text-align:center" %)
493 -[[image:1651746078253-168.png||height="372" width="621"]]
659 +systemctl enable draginostation ~-~- enable boot auto start draginostation service
494 494  
661 +systemctl disable  draginostation  ~-~- disable boot auto start draginostation service
495 495  
496 -We can check dragino_fwd running states in RPi by running:
497 497  
664 +
665 +Tree Directory:
666 +
667 +/etc/station/
668 +
669 +├── cups-bak.done
670 +├── cups-bak.key
671 +├── cups-bak.trust
672 +├── cups-bak.uri
673 +├── cups.key
674 +├── cups.trust
675 +├── cups.uri
676 +├── lns.key
677 +├── station.conf
678 +├── tc-bak.crt
679 +├── tc-bak.done
680 +├── tc-bak.key
681 +├── tc-bak.trust
682 +├── tc-bak.uri
683 +├── tc.crt
684 +├── tc.key
685 +├── tc.trust
686 +└── tc.uri
687 +
688 +
689 +
690 +==== **h). Check station running log** ====
691 +
692 +
693 +tail -f /var/log/station.log
694 +
695 +[[image:image-20230329201624-11.png]]
696 +
697 +
698 +
699 += 6. Add GPS support in PG1302 =
700 +
701 +The PG1302 supports GPS:
702 +
703 +[[image:image-20240118160132-1.png||height="270" width="338"]]
704 +
705 +
706 +* **The users can find the GPS device in Raspberry: /dev/ttyS0 or /dev/ttyAMA0**
707 +
708 + [[image:image-20240118160407-2.png||height="71" width="458"]]
709 +
710 +
711 +* **Check the GPS output: cat /dev/ttyS0**
712 +
713 + [[image:image-20240118160454-3.png]]
714 +
715 +
716 +* **Add the GPS to the Semtech UDP package forwarder configuration.**
717 +
718 + [[image:image-20240118160928-4.png||height="426" width="464"]]
719 +
720 +
721 +* **Test GPS function**
722 +
723 +**~ 1.) Stop IoT service: systemctl stop draginofwd**
724 +
725 +
726 +**~ 2.) Run the fwd command and check the output**
727 +
728 +
729 + [[image:image-20240118161109-5.png]]
730 +
731 +
732 +**~ 3.) Trouble Shooting:**
733 +
734 + If you get many WARNING outputs, which should be the GPS location is invalid, you need to adjust the GPS location, it is recommended to put it outdoors
735 +
736 +
737 + [[image:image-20240118161333-6.png]]
738 +
739 +
740 + The user can check the PG1302 board GPS LED status to check the location,
741 +
742 + GPS location is valid  ~-~--> GPS LED will light up
743 +
744 + GPS location is invalid ~-~--> GPS LED will light down
745 +
746 +
747 + [[image:image-20240118162033-7.png]]
748 +
749 +
750 +
751 += 7. Trouble Shooting =
752 +
753 +(% class="wikigeneratedid" %)
754 +7.1 Failed to start the concentrator how to debug
755 +
756 +
757 +--When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled,--
758 +
759 +--Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct.--
760 +
498 498  (% class="box infomessage" %)
499 499  (((
500 - **// sudo journalctl -u draginofwd -f//**
763 +--**i2cdetect -y 1**--
501 501  )))
502 502  
503 -[[image:1651746111963-838.png]]
766 +**Note: This method has been removed because the i2c had been removed on the latest PG1302.**
504 504  
505 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
506 506  
507 507  
508 -[[image:1651746139304-966.png||height="326" width="621"]]
770 +Check whether the SPI path of the configuration file is correct,
509 509  
772 +(% class="box infomessage" %)
773 +(((
774 +**cat /etc/lora/global_conf.json **
775 +)))
510 510  
511 -===== 5.2.4 Commands to handle service =====
777 +(% class="wikigeneratedid" %)
778 +[[image:image-20230518092732-2.png||height="378" width="691"]]
512 512  
513 -* **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
514 -* **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
515 -* **Start** dragino_fwd : sudo systemctl start draginofwd
516 -* **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
517 -* **Show status** of dragino_fwd:  sudo systemctl status draginofwd
518 518  
519 -=== 6. Order Info ===
520 520  
521 - Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
782 += 8. Order Info =
522 522  
523 -**~ XX:**
524 524  
525 -* 868 (For Bands: EU868,IN865)
526 -* 915 (For Bands: US915,AU915,AS923,KR920)
527 -* 470 (For Band: CN470)
785 +Part Number: (% style="color:#0000ff" %)**PG1302-XX**   (%%) Or  Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX   **(%%)(Include RPi converter board for RPI 3/4)
528 528  
529 -=== 7. Packing Info ===
787 +**~ (% style="color:#0000ff" %)XX:(%%)**
530 530  
789 +* (% style="color:red" %)**868** (%%)(For Bands: EU868,IN865)
790 +* (% style="color:red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)
791 +* (% style="color:red" %)**470** (%%)(For Band: CN470)
792 +
793 += 9. Packing Info =
794 +
795 +
531 531  (((
532 -**~ PG1302 Package Includes**:
797 +**PG1302 Package Includes**:
533 533  )))
534 534  
535 -* (((
536 -PG1302 x 1
800 +(((
801 +* PG1302 x 1
802 +* LoRa Antenna x 1
537 537  )))
538 -* (((
539 -LoRa Antenna x 1
804 +
805 +
806 +
807 +(((
808 +**PG1302-PI Package Includes**:
540 540  )))
541 541  
811 +* PG1302 x 1
812 +* LoRa Antenna x 1
813 +* RPi3/4 converter PCB
814 +* Screws to hole converter PCB on RPI.
815 +
816 +**PG1302-PI Dimension and weight: **
817 +
818 +* Device Size: 18 x 8 x 4 cm
819 +* Weight: 150g
820 +
821 += 10. Support =
822 +
823 +
542 542  (((
543 -**~ PG1302-PI Package Includes**:
825 +If you are experiencing issues and can't solve, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].
544 544  )))
545 545  
546 -* (((
547 -PG1302 x 1
828 +(((
829 +With your question as detail as possible. We will reply and help you in the shortest.
548 548  )))
549 -* (((
550 -LoRa Antenna x 1
551 -)))
552 -* (((
553 -RPi3/4 converter PCB
554 -)))
555 -* (((
556 -Screws to hole converter PCB on RPI.
557 -)))
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
image-20231115174839-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +80.3 KB
Content
image-20231115180410-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +78.7 KB
Content
image-20240118160132-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +37.2 KB
Content
image-20240118160407-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +7.9 KB
Content
image-20240118160454-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +42.0 KB
Content
image-20240118160928-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +83.8 KB
Content
image-20240118161109-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +178.1 KB
Content
image-20240118161333-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +120.0 KB
Content
image-20240118162033-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +724.0 KB
Content
image-20240122140551-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +334.9 KB
Content
image-20240506170501-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +104.7 KB
Content
image-20240506170559-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +154.3 KB
Content
image-20240506170941-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +357.5 KB
Content
image-20240622094409-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +134.7 KB
Content