Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.5 by Xiaoling on 2022/07/28 14:24

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications