Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 108.21 by Xiaoling on 2022/08/22 17:32

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications

Navigation