Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.12 by Xiaoling on 2022/07/28 14:39

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications