Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 115.2 by Xiaoling on 2023/03/27 13:39

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications