Skip to Content

Wiki source code of PG1302

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