Skip to Content

Wiki source code of PG1302

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