Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 111.1 by Edwin Chen on 2023/01/06 15:04

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications

Navigation