Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.16 by Xiaoling on 2022/08/10 11:44

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications