Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.7 by Xiaoling on 2022/07/28 14:26

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