Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 116.1 by Xiaoye on 2023/03/29 15:33

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications

Navigation