Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.6 by Xiaoling on 2022/07/28 14:25

version	line-number	content
36.1	1	(% style="text-align:center" %)
104.3	2	[[image:image-20220616085956-1.jpeg\|\|height="609" width="609"]]
1.1	3
	4
	5
	6
99.12	7	Table of Contents：
1.1	8
73.1	9	{{toc/}}
1.1	10
72.1	11
	12	(% class="wikigeneratedid" id="H" %)
	13	(((
	14
	15	)))
	16
103.1	17	= 1. Introduction =
36.1	18
103.1	19	== 1.1 What is PG1302 LoRaWAN Concentrator? ==
98.16	20
36.1	21
101.1	22	The PG1302 is a (% style="color:green" %)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.
87.1	23
100.1	24	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.
87.1	25
102.1	26	PG1302 is fully compatible with (% style="color:green" %)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.
100.1	27
	28
108.3	29
103.1	30	== 1.2 Features ==
36.1	31
	32	* Base on Semtech SX1302 solution
	33	* Support Raspberry Pi 3B/3B+/4
	34	* Up to -140dBm sensitivity
	35	* Support 3.3v and 5v.
	36	* Mini-PCIe Interface
	37	* Converter board to support Raspberry Pi
	38
108.6	39
	40
	41
	42
106.1	43	== 1.3 General Interfaces for PG1302 ==
104.4	44
36.1	45	* SPI interface for LoRa
	46	* Power Input: 5v, 1A
	47	* 1 x I-PEX for LoRa
	48
108.6	49
	50
	51
	52
103.1	53	== 1.4 Pin Mapping ==
36.1	54
108.3	55
36.1	56	[[image:1651743282627-547.png\|\|height="402" width="425"]]
	57
108.3	58
	59
103.1	60	== 1.5 LEDs ==
36.1	61
108.3	62
86.1	63	TX: Blink when transmit a packet
	64	RX: Blink when receive a packet
	65	Config: Always ON
36.1	66
104.5	67
108.3	68
103.1	69	== 1.6 Power Consumption ==
62.1	70
36.1	71
108.3	72	<300mA @ 3.3v.
	73
106.2	74	Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
104.5	75
106.2	76
108.3	77
103.1	78	== 1.7 Applications ==
62.1	79
36.1	80	* Smart Buildings & Home Automation
	81	* Logistics and Supply Chain Management
	82	* Smart Metering
	83	* Smart Agriculture
	84	* Smart Cities
	85	* Smart Factory
	86
108.6	87
	88
	89
	90
103.1	91	= 2. Example: Set up as LoRaWAN gateway. =
36.1	92
103.1	93	== 2.1 System structure ==
36.1	94
103.1	95
98.3	96	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.
36.1	97
	98	[[image:1651743698677-436.png\|\|height="457" width="686"]]
	99
	100
108.3	101
103.1	102	== 2.2 Hardware Installation ==
	103
108.3	104
98.27	105	(% style="color:red" %)Important Notice: Please power the RPI with 5V,3A cable.
36.1	106
108.1	107	[[image:image-20220621104746-1.png\|\|height="381" width="451"]]
36.1	108
	109
108.3	110
103.1	111	= 3. Install the software? =
36.1	112
103.1	113	There are two ways to install the software in RPi4 to use PG1302.
36.1	114
103.1	115	* Flash SD card with Dragino pre-build image which supports Web UI.
	116	* Install Lora packet forwarder in existing RPi OS.
36.1	117
108.6	118
	119
	120
	121
103.1	122	= 4. Flash with pre-build image =
36.1	123
103.1	124	== 4.1 Download the dragino image for RPI ==
	125
36.1	126
108.6	127	(((
	128	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]]
	129	)))
62.1	130
108.3	131
108.6	132
103.1	133	== 4.2 Flash the image to an SD card ==
36.1	134
108.3	135
103.1	136	Flash the image to the SD card:
	137
36.1	138	[[image:1651744119133-233.png\|\|height="373" width="621"]]
	139
	140
108.3	141	(% style="color:red" %)Note: Download the flash tool following this link：[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
36.1	142
62.1	143
108.3	144
103.1	145	== 4.3 Access the Linux console ==
	146
98.1	147
108.3	148	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
	149
36.1	150	[[image:1651744193675-591.png\|\|height="450" width="466"]]
	151
98.11	152	The account details for Web Login are:
36.1	153
98.28	154	(((
	155	~ (% style="color:#0000ff" %)User Name: root(%%)
	156	)))
36.1	157
98.28	158	(((
	159	~ (% style="color:#0000ff" %)Password: dragino(%%)
	160	)))
36.1	161
98.28	162	(((
	163
	164	)))
36.1	165
98.28	166	(((
	167	~ (% style="color:#0000ff" %)Backup account(%%)
	168	)))
36.1	169
98.28	170	(((
	171	~ (% style="color:#0000ff" %)Pi/dragino(%%)
103.1	172
	173
98.28	174	)))
36.1	175
103.1	176	After logging in, you will be in the Linux console and type the command here.
36.1	177
	178	[[image:1651744358515-107.png\|\|height="366" width="581"]]
	179
	180
108.3	181
103.1	182	== 4.4 Access the WebUI of RPi4. ==
62.1	183
103.1	184	=== 4.4.1 Home page ===
	185
108.3	186
	187	Open a browser on the PC and type the RPI ip address [[http:~~/~~/IP_ADDRESS >>url:http://192.168.1.xx/]] (If the IP is assigned by the uplink router)
98.5	188	You will see the login interface of RPI as shown below.
	189	The account details for Web Login are:
36.1	190
98.22	191	(((
98.29	192	~ (% style="color:#0000ff" %)User Name: root(%%)
	193	(% style="color:#0000ff" %) Password: dragino
108.3	194
	195
98.22	196	)))
36.1	197
	198	[[image:1651744457761-993.png\|\|height="352" width="621"]]
	199
	200
108.3	201
103.1	202	=== 4.4.2 LoRa Page ===
	203
108.3	204
98.7	205	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.
36.1	206
	207	[[image:1651744554845-970.png\|\|height="328" width="621"]]
	208
98.7	209	Different PG1302 hardware version can support different frequency range:
36.1	210
108.3	211	➢ (% style="color:red" %)868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.(%%)
36.1	212
108.3	213	➢ (% style="color:red" %)915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
36.1	214
108.3	215	After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:blue" %)page LogRead ~-~-> LoRa Log
36.1	216
108.3	217	(% style="color:red" %)*Note : [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
36.1	218
	219
	220
103.1	221	=== 4.4.3 LoRaWAN Page ===
36.1	222
103.1	223	==== 4.4.3.1 Semtech UDP ====
36.1	224
108.3	225
36.1	226	[[image:1651744767914-283.png\|\|height="352" width="621"]]
	227
108.3	228	(% style="color:red" %)*Note : [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].**
36.1	229
	230
108.3	231
103.1	232	==== 4.4.3.2 Basic Station ====
36.1	233
108.3	234
36.1	235	[[image:1651744890629-683.png\|\|height="380" width="621"]]
	236
	237
108.3	238	(% style="color:red" %)*Note : [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**
36.1	239
108.3	240
	241
103.1	242	=== 4.4.4 LogRead ===
36.1	243
103.1	244	==== 4.4.4.1 LoRa Log ====
36.1	245
108.3	246
36.1	247	[[image:1651744955955-452.png\|\|height="571" width="621"]]
	248
98.7	249	Show the frequency for LoRa Radio and traffics.
36.1	250
	251
108.3	252
103.1	253	==== 4.4.4.2 System Log ====
	254
108.3	255
98.7	256	Show system log.
36.1	257
	258	[[image:1651745003470-264.png\|\|height="477" width="621"]]
	259
	260
108.3	261
103.1	262	==== 4.4.4.3 Record Log ====
	263
108.3	264
98.7	265	Record the system log.
36.1	266
	267	[[image:1651745069814-662.png\|\|height="144" width="621"]]
	268
	269
108.3	270
103.1	271	= 5. Install stand-alone LoRa Packet Forwarder. =
36.1	272
103.1	273	== 5.1 OS requirement ==
	274
108.3	275
98.7	276	RPI in this example is RPI model 4B with fresh Raspbian OS install.
36.1	277
98.30	278	(% class="box" %)
	279	(((
	280	pi@raspberrypi:~~$ cat /etc/os-release
36.1	281	PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
	282	NAME="Raspbian GNU/Linux"
	283	VERSION_ID="8"
	284	VERSION="8 (jessie)"
	285	ID=raspbian
	286	ID_LIKE=debian
	287	HOME_URL="http:~/~/www.raspbian.org/"
	288	SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
	289	BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
103.1	290
	291
98.30	292	)))
36.1	293
	294
108.3	295
	296	== 5.2 Get Gateway ID in Raspberry and input this in TTN v3 ==
	297
	298
103.1	299	In RPI, run the below command to get a Gateway ID
36.1	300
98.11	301	(% class="box infomessage" %)
	302	(((
108.3	303	~ ifconfig eth0
98.11	304	)))
36.1	305
	306	[[image:1651745210205-512.png\|\|height="130" width="621"]]
	307
108.3	308
91.1	309	(((
99.2	310	(((
98.7	311	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.
108.3	312
	313
91.1	314	)))
99.2	315	)))
36.1	316
	317	[[image:1651745267862-321.png\|\|height="526" width="621"]]
	318
	319	[[image:1651745306744-481.png\|\|height="478" width="621"]]
	320
108.3	321
62.1	322	After set up, the status should show not connected as below:
	323
36.1	324	[[image:1651745366987-458.png\|\|height="363" width="621"]]
	325
	326
108.3	327
	328	=== 5.2.1 Download and install LoRaWAN packet forwarder ===
	329
	330
98.8	331	Enable SPI and I2C first:
36.1	332
108.3	333	a) SPI needs to be enabled on the Raspberry Pi
36.1	334
108.3	335	Run (% style="background-color:yellow" %) sudo raspi-config(%%) to open the config window
36.1	336
98.24	337	[[image:1651745476754-240.png\|\|height="234" width="629"]]
36.1	338
	339	[[image:image-20220505181135-1.png]]
	340
98.24	341	[[image:image-20220505181135-2.png\|\|height="229" width="622"]]
36.1	342
108.3	343
	344
103.1	345	In RPI, Fist: Enter the root account:
36.1	346
99.2	347	(((
98.24	348	[[image:1651745583363-614.png\|\|height="151" width="732"]]
108.3	349
	350
99.2	351	)))
36.1	352
98.8	353	and then run:
36.1	354
98.31	355	(% style="background-color:#dcdcdc" %)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]]
36.1	356
98.31	357	(% style="background-color:#dcdcdc" %)chmod +x ./auto_install.sh
36.1	358
98.31	359	(% style="background-color:#dcdcdc" %)./auto_install.sh
36.1	360
99.2	361	(((
98.24	362	[[image:1651745611629-818.png\|\|height="225" width="729"]]
99.2	363	)))
36.1	364
98.8	365	This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
36.1	366
98.8	367	You can get these output:
36.1	368
99.2	369	(((
36.1	370	[[image:1651745657252-173.png\|\|height="426" width="621"]]
108.3	371
	372
	373
99.2	374	)))
36.1	375
108.3	376	=== 5.2.2 Config Gateway ID, Frequency Band and Server address ===
36.1	377
108.3	378
88.1	379	(((
98.32	380	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.
88.1	381	)))
36.1	382
88.1	383	(((
98.32	384	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.
108.4	385
	386
88.1	387	)))
36.1	388
	389	[[image:1651745709709-887.png\|\|height="820" width="621"]]
	390
	391
108.4	392	User 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]]
36.1	393
98.33	394	And the default frequency band is US915 in (% style="color:#0000ff" %)global_conf.json(%%) file.
36.1	395
	396	[[image:1651745838008-820.png\|\|height="650" width="621"]]
	397
108.4	398
98.35	399	* If user want to change to other frequency bands, 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(%%).
36.1	400
108.4	401	~ 1). Chose your need the name of region frequency.
36.1	402
98.24	403	[[image:1651745867516-322.png\|\|height="83" width="740"]]
36.1	404
	405
108.4	406	*
	407	** 2). Use this command to copy it.
	408
36.1	409	cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
	410
98.24	411	[[image:1651745984006-868.png\|\|height="87" width="745"]]
36.1	412
98.34	413	* If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)global_conf.json(%%) file.
36.1	414
	415
108.4	416
	417	=== 5.2.3 Check result ===
	418
	419
91.1	420	(((
98.8	421	Run below command to restart the dragino_fwd:
91.1	422	)))
36.1	423
91.1	424	(((
98.8	425	(% class="box infomessage" %)
	426	(((
108.4	427	sudo systemctl stop draginofwd
91.1	428	)))
36.1	429
98.8	430	(% class="box infomessage" %)
91.1	431	(((
108.4	432	sudo systemctl start draginofwd
91.1	433	)))
98.8	434	)))
36.1	435
108.4	436
91.1	437	(((
98.8	438	debug check the ruing status of fwd:
91.1	439	)))
36.1	440
91.1	441	(((
98.8	442	(% class="box infomessage" %)
	443	(((
108.4	444	sudo systemctl status draginofwd
91.1	445	)))
98.8	446	)))
36.1	447
98.24	448	[[image:1651746045057-414.png\|\|height="193" width="729"]]
36.1	449
108.4	450
	451
98.8	452	The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
36.1	453
108.4	454
36.1	455	[[image:1651746078253-168.png\|\|height="372" width="621"]]
	456
	457
108.4	458
95.1	459	We can check dragino_fwd running states in RPi by running:
36.1	460
95.1	461	(% class="box infomessage" %)
	462	(((
108.4	463	~ sudo journalctl -u draginofwd -f
95.1	464	)))
36.1	465
98.37	466	[[image:1651746111963-838.png\|\|height="184" width="730"]]
36.1	467
93.1	468
108.4	469	If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)TTN v3 –> Gateway ~-~-> Live data
	470
94.1	471	[[image:1651746139304-966.png\|\|height="326" width="621"]]
93.1	472
108.2	473
93.1	474
108.4	475	=== 5.2.4 Commands to handle service ===
	476
	477
98.37	478	* (% style="color:#0000ff" %)Stop (%%)dragino_fwd service: sudo systemctl stop draginofwd
	479	* (% style="color:#0000ff" %)Disable(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
	480	* (% style="color:#0000ff" %)Start (%%)dragino_fwd : sudo systemctl start draginofwd
	481	* (% style="color:#0000ff" %)Auto run(%%) dragino_fwd after boot: sudo systemctl enable draginofwd
	482	* (% style="color:#0000ff" %)Show status (%%)of dragino_fwd: sudo systemctl status draginofwd
36.1	483
108.4	484
	485
	486
108.5	487	= 6. Order Info =
36.1	488
108.4	489
98.37	490	Part Number: (% style="color:#0000ff" %)PG1302-XX (%%) Or Part Number: (% style="color:#0000ff" %)PG1302-PI-XX (%%)(Include RPi converter board for RPI 3/4)
36.1	491
98.37	492	~ (% style="color:#0000ff" %)XX:(%%)
36.1	493
108.4	494	* (% style="color:red" %)868 (%%)(For Bands: EU868,IN865)
	495	* (% style="color:red" %)915 (%%)(For Bands: US915,AU915,AS923,KR920)
	496	* (% style="color:red" %)470 (%%)(For Band: CN470)
36.1	497
108.4	498
	499
	500
	501
108.5	502	= 7. Packing Info =
36.1	503
91.1	504	(((
108.2	505
	506
98.9	507	PG1302 Package Includes:
91.1	508	)))
36.1	509
98.9	510	(((
99.5	511	(((
	512	* PG1302 x 1
	513	* LoRa Antenna x 1
91.1	514	)))
98.39	515	)))
98.9	516
	517	(((
108.2	518
	519
	520
98.9	521	PG1302-PI Package Includes:
91.1	522	)))
36.1	523
99.5	524	* PG1302 x 1
	525	* LoRa Antenna x 1
	526	* RPi3/4 converter PCB
	527	* Screws to hole converter PCB on RPI.
98.25	528
108.2	529	PG1302-PI Dimension and weight:
	530
	531	* Device Size: 18 x 8 x 4 cm
	532	* Weight: 150g
	533
108.4	534
	535
	536
	537
98.25	538	(((
108.5	539	= 8. Support =
98.25	540
108.4	541
98.38	542	(((
108.4	543	If you are experiencing issues and can't solve, you can send mail to
98.38	544	)))
98.25	545
98.38	546	(((
98.25	547	[[support@dragino.com>>mailto:support@dragino.com]]
98.38	548	)))
98.25	549
98.38	550	(((
98.25	551	With your question as detail as possible. We will reply and help you in the shortest.
91.1	552	)))
98.38	553	)))

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications