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