Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.8 by Xiaoling on 2022/07/28 14:27

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications