Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.18 by Xiaoling on 2022/08/10 11:49

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications

Navigation