Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Version 110.2 by Xiaoling on 2022/12/21 09:40

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

Wiki source code of PG1302 - LoRaWAN Concentrator User Manual

Applications