Wiki source code of PG1302

Version 91.1 by Xiaoling on 2022/05/06 16:26
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 Download PG1302_for_Rpi4_64_with_webui from
198
199 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
200
201
202 ==== 4.2 Flash the image to SD card ====
203
204 Flash the image to SD card:
205
206 (% style="text-align:center" %)
207 [[image:1651744119133-233.png||height="373" width="621"]]
208
209 Note: Download the flash tool following this link
210
211 [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
212
213
214 ==== 4.3 Access the Linux console ====
215
216 (((
217 (((
218 (((
219 Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s
220 )))
221
222 (((
223 management portal, you should be able to find what IP address the router has assigned to the RPI. You can
224 )))
225
226 (((
227 use this IP to connect the WEB UI or SSH access of RPI.
228 )))
229 )))
230
231 (((
232 (((
233 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.
234 )))
235
236 (((
237 Below are screenshots
238 )))
239 )))
240 )))
241
242
243 (% style="text-align:center" %)
244 [[image:1651744193675-591.png||height="450" width="466"]]
245
246
247 The account details for Web Login are:
248
249 **~ User Name: root**
250
251 **~ Password:   dragino**
252
253
254 **~ Backup account**
255
256 **~ Pi/dragino**
257
258
259 After log in, you will be in the Linux console and type command here.
260
261 (% style="text-align:center" %)
262 [[image:1651744358515-107.png||height="366" width="581"]]
263
264
265 ==== 4.4 Access the WebUI of RPi4. ====
266
267 ===== 4.4.1 Home page =====
268
269 Open a browser on the PC and type the RPI ip address
270
271 [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
272
273 You will see the login interface of RPI as shown below.
274
275 The account details for Web Login are:
276
277 **~ User Name: root**
278
279 **~ Password:   dragino**
280
281 (% style="text-align:center" %)
282 [[image:1651744457761-993.png||height="352" width="621"]]
283
284
285 ===== 4.4.2 LoRa Page =====
286
287 (((
288 This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
289 )))
290
291 (((
292 protocol, and user can customize the band* as well.
293 )))
294
295 (% style="text-align:center" %)
296 [[image:1651744554845-970.png||height="328" width="621"]]
297
298 Different PG1302 hardware version can support different frequency range:
299
300 ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
301
302 ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
303
304 After user choose the frequency plan, he can see the actually frequency in used by checking the
305
306 page LogRead ~-~-> LoRa Log
307
308 Note *: See this instruction for how to customize frequency band
309
310 [[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]]
311
312
313 ===== 4.4.3 LoRaWAN Page =====
314
315 ====== 4.4.3.1 Semtech UDP ======
316
317
318 (% style="text-align:center" %)
319 [[image:1651744767914-283.png||height="352" width="621"]]
320
321 Note *: See this instruction for how to configure TTN.
322
323 [[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);"]]
324
325
326 ====== 4.4.3.2 Basic Station ======
327
328 (% style="text-align:center" %)
329 [[image:1651744890629-683.png||height="380" width="621"]]
330
331 Note *: See this instruction for how to configure TTN.
332
333 [[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]]
334
335
336 ===== 4.4.4 LogRead =====
337
338 ====== 4.4.4.1 LoRa Log ======
339
340 (% style="text-align:center" %)
341 [[image:1651744955955-452.png||height="571" width="621"]]
342
343 Show the frequency for LoRa Radio and traffics.
344
345
346 ====== 4.4.4.2 System Log ======
347
348 Show system log.
349
350 (% style="text-align:center" %)
351 [[image:1651745003470-264.png||height="477" width="621"]]
352
353
354
355 ====== 4.4.4.3 Record Log ======
356
357 **~ Record the system log.**
358
359 (% style="text-align:center" %)
360 [[image:1651745069814-662.png||height="144" width="621"]]
361
362
363 === 5. Install stand alone LoRa Packet Forwarder. ===
364
365 ==== 5.1 OS requirement ====
366
367 RPI in this example is RPI model 4B with fresh Raspbian OS install.
368
369 pi@raspberrypi:~~$ cat /etc/os-release
370
371 PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
372
373 NAME="Raspbian GNU/Linux"
374
375 VERSION_ID="8"
376
377 VERSION="8 (jessie)"
378
379 ID=raspbian
380
381 ID_LIKE=debian
382
383 HOME_URL="http:~/~/www.raspbian.org/"
384
385 SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
386
387 BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
388
389
390 ==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
391
392 In RPI, run below command to get a Gateway ID
393
394 (% class="mark" %)ifconfig eth0
395
396 (% style="text-align:center" %)
397 [[image:1651745210205-512.png||height="130" width="621"]]
398
399 (((
400 We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
401 )))
402
403 (((
404 gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
405 )))
406
407 (% style="text-align:center" %)
408 [[image:1651745267862-321.png||height="526" width="621"]]
409
410
411
412 (% style="text-align:center" %)
413 [[image:1651745306744-481.png||height="478" width="621"]]
414
415 After set up, the status should show not connected as below:
416
417 (% style="text-align:center" %)
418 [[image:1651745366987-458.png||height="363" width="621"]]
419
420
421 ===== 5.2.1 Download and install LoRaWAN packet forwarder =====
422
423 Enable SPI and I2C first:
424
425 a)SPI needs to be enabled on the Raspberry Pi
426
427 Run sudo raspi-config to open the config window
428
429 (% style="text-align:center" %)
430 [[image:1651745476754-240.png||height="235" width="631"]]
431
432
433 (% style="text-align:center" %)
434 [[image:image-20220505181135-1.png]]
435
436 (% style="text-align:center" %)
437 [[image:image-20220505181135-2.png]]
438
439
440
441
442 In RPI , Fist: Enter root account:
443
444 (% style="text-align:center" %)
445 [[image:1651745583363-614.png]]
446
447
448 and then run:
449
450 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]]
451
452 chmod +x ./auto_install.sh
453
454 ./auto_install.sh
455
456 (% style="text-align:center" %)
457 [[image:1651745611629-818.png]]
458
459
460 This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
461
462 You can get these output:
463
464 (% style="text-align:center" %)
465 [[image:1651745657252-173.png||height="426" width="621"]]
466
467
468 ===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
469
470 (((
471 After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
472 )))
473
474 (((
475 **~ gateway_ID** in file **local_conf.json**
476 )))
477
478 (((
479 The default LoRaWAN server points to localhost, user need to put the correct server address to the
480 )))
481
482 (((
483 server_address field in file **local_conf.json**, like below.
484 )))
485
486 (% style="text-align:center" %)
487 [[image:1651745709709-887.png||height="820" width="621"]]
488
489
490 User can find the TTN v3 server address from:
491
492 [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
493
494
495 And the default frequency band is US915 in **global_conf.json** file.
496
497 (% style="text-align:center" %)
498 [[image:1651745838008-820.png||height="650" width="621"]]
499
500
501 * 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.**
502
503 1).Chose your need the name of region frequency.
504
505 (% style="text-align:center" %)
506 [[image:1651745867516-322.png]]
507
508
509 2). Use this command to copy it.
510
511 cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
512
513 (% style="text-align:center" %)
514 [[image:1651745984006-868.png]]
515
516
517 * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
518
519 (% class="wikigeneratedid" %)
520 (((
521
522 )))
523
524 ===== 5.2.3 Check result =====
525
526 (((
527 Run below command to restart the dragino_fwd:
528 )))
529
530 (((
531 sudo systemctl stop draginofwd
532 )))
533
534 (((
535 sudo systemctl start draginofwd
536 )))
537
538 (((
539 debug check the ruing status of fwd:
540 )))
541
542 (((
543 sudo systemctl status draginofwd
544 )))
545
546 (% style="text-align:center" %)
547 [[image:1651746045057-414.png]]
548
549
550 The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
551
552 (% style="text-align:center" %)
553 [[image:1651746078253-168.png||height="372" width="621"]]
554
555
556 We can check dragino_fwd running states in RPi by running:
557
558 //**sudo journalctl -u draginofwd -f**//
559
560 (% style="text-align:center" %)
561 [[image:1651746111963-838.png]]
562
563 If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
564
565 (% style="text-align:center" %)
566 [[image:1651746139304-966.png||height="326" width="621"]]
567
568
569 ===== 5.2.4 Commands to handle service =====
570
571 * **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
572 * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
573 * **Start** dragino_fwd : sudo systemctl start draginofwd
574 * **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
575 * **Show status** of dragino_fwd:  sudo systemctl status draginofwd
576
577 === 6. Order Info ===
578
579 Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
580
581 **~ XX:**
582
583 * 868 (For Bands: EU868,IN865)
584 * 915 (For Bands: US915,AU915,AS923,KR920)
585 * 470 (For Band: CN470)
586
587 === 7. Packing Info ===
588
589 (((
590 **~ PG1302 Package Includes**:
591 )))
592
593 * (((
594 PG1302 x 1
595 )))
596 * (((
597 LoRa Antenna x 1
598 )))
599
600 (((
601 **~ PG1302-PI Package Includes**:
602 )))
603
604 * (((
605 PG1302 x 1
606 )))
607 * (((
608 LoRa Antenna x 1
609 )))
610 * (((
611 RPi3/4 converter PCB
612 )))
613 * (((
614 Screws to hole converter PCB on RPI.
615 )))
616
617 === 8. Reference ===
618
619 * Datasheet, User Manual & Software Download:
620
621 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
622
623
624 === 9. Support ===
625
626 * 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.
627 * 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
628
629 [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0