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

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