Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:Main.User Manual for All Gateway models.WebHome@pg1302.jpg]]
5
6
7
8
9
10
11
12 **PG1302 LoRaWAN Concentrator User Manual**
13
14
15
16
17
18 {{toc/}}
19
20
21 ----
22
23 (% class="wikigeneratedid" id="H" %)
24 (((
25
26 )))
27
28 === 1. Introduction ===
29
30 ==== 1.1 What is PG1302 LoRaWAN Concentrator? ====
31
32 (((
33 (((
34 The PG1302 is a multi-channel high performance transmitter/receiver designed to simultaneously receive several LoRa packets using random spreading factors on
35 )))
36
37 (((
38 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
39 )))
40
41 (((
42 very wide range of distances.
43 )))
44
45 (((
46
47 )))
48 )))
49
50 (((
51 (((
52 The PG1302 is design to use with Raspberry Pi to build smart metering fixed networks and Internet of Things applications with up to 5000 nodes per km2 in moderately
53 )))
54
55 (((
56 interfered environment.
57 )))
58
59 (((
60
61 )))
62 )))
63
64 (((
65 (((
66 PG1302 is fully compatible with RPi3/4, 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
67 )))
68
69 (((
70 in the exist OS.
71 )))
72 )))
73
74 (((
75 (((
76
77 )))
78 )))
79
80 ==== 1.2 Features ====
81
82 * Base on Semtech SX1302 solution
83 * Support Raspberry Pi 3B/3B+/4
84 * Up to -140dBm sensitivity
85 * Support 3.3v and 5v.
86 * Mini-PCIe Interface
87 * Converter board to support Raspberry Pi
88
89 ==== 1.3 General Interfaces ====
90
91 * SPI interface for LoRa
92 * Power Input: 5v, 1A
93 * 1 x I-PEX for LoRa
94
95 ==== 1.4 Pin Mapping ====
96
97 [[image:1651743282627-547.png||height="402" width="425"]]
98
99
100
101 ==== 1.5 LEDs ====
102
103 TX: Blink when transmit a packet
104
105 RX: Blink when receive a packet
106
107 Config: Always ON
108
109
110 ==== 1.6 Power Consumption ====
111
112 TBD
113
114
115 ==== 1.7 Applications ====
116
117 * Smart Buildings & Home Automation
118 * Logistics and Supply Chain Management
119 * Smart Metering
120 * Smart Agriculture
121 * Smart Cities
122 * Smart Factory
123
124 === 2. Example: Set up as LoRaWAN gateway. ===
125
126 ==== 2.1 System structure ====
127
128 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.
129
130 Set up method for other server are similar.
131
132 (% style="text-align:center" %)
133 [[image:1651743698677-436.png||height="457" width="686"]]
134
135
136
137 ==== 2.2 Hardware Installation ====
138
139 **~ Important Notice: **Please power the RPI with 5V,3A cable.
140
141 (% style="text-align:center" %)
142 [[image:1651743803032-803.png]]
143
144
145
146 === 3. Install the software? ===
147
148 There are two ways to install software in RPi4 to use PG1302.
149
150 * Flash SD card with Dragino pre-build image which support Web UI.
151 * Install lora packet forwarder in existing RPi OS.
152
153 === 4. Flash with pre-build image ===
154
155 ==== 4.1 Download the dragino image for RPI ====
156
157 Download PG1302_for_Rpi4_64_with_webui from
158
159 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
160
161
162 ==== 4.2 Flash the image to SD card ====
163
164 Flash the image to SD card:
165
166 (% style="text-align:center" %)
167 [[image:1651744119133-233.png||height="373" width="621"]]
168
169 Note: Download the flash tool following this link
170
171 [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
172
173
174 ==== 4.3 Access the Linux console ====
175
176 (((
177 (((
178 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
179 )))
180
181 (((
182 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.
183 )))
184
185 (((
186 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
187 )))
188 )))
189
190
191 (% style="text-align:center" %)
192 [[image:1651744193675-591.png||height="450" width="466"]]
193
194
195 The account details for Web Login are:
196
197 **~ User Name: root**
198
199 **~ Password:   dragino**
200
201
202 **~ Backup account**
203
204 **~ Pi/dragino**
205
206
207 After log in, you will be in the Linux console and type command here.
208
209 (% style="text-align:center" %)
210 [[image:1651744358515-107.png||height="366" width="581"]]
211
212
213 ==== 4.4 Access the WebUI of RPi4. ====
214
215 ===== 4.4.1 Home page =====
216
217 Open a browser on the PC and type the RPI ip address
218
219 [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
220
221 You will see the login interface of RPI as shown below.
222
223 The account details for Web Login are:
224
225 **~ User Name: root**
226
227 **~ Password:   dragino**
228
229 (% style="text-align:center" %)
230 [[image:1651744457761-993.png||height="352" width="621"]]
231
232
233 ===== 4.4.2 LoRa Page =====
234
235 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.
236
237 (% style="text-align:center" %)
238 [[image:1651744554845-970.png||height="328" width="621"]]
239
240
241 Different PG1302 hardware version can support different frequency range:
242
243 ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
244
245 ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
246
247
248 After user choose the frequency plan, he can see the actually frequency in used by checking the
249
250 page LogRead ~-~-> LoRa Log
251
252 Note *: See this instruction for how to customize frequency band
253
254 [[http:~~/~~/wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway>>url:http://wiki.dragino.com/index.php?title=Customized_Frequency_Band_for_Gateway]]
255
256
257 ===== 4.4.3 LoRaWAN Page =====
258
259 ====== 4.4.3.1 Semtech UDP ======
260
261
262 (% style="text-align:center" %)
263 [[image:1651744767914-283.png||height="352" width="621"]]
264
265 Note *: See this instruction for how to configure TTN.
266
267 [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_TTN>>url:https://wiki.dragino.com/index.php?title=Notes_for_TTN||style="background-color: rgb(255, 255, 255);"]]
268
269
270 ====== 4.4.3.2 Basic Station ======
271
272 (% style="text-align:center" %)
273 [[image:1651744890629-683.png||height="380" width="621"]]
274
275 Note *: See this instruction for how to configure TTN.
276
277 [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core>>url:https://wiki.dragino.com/index.php?title=Notes_for_AWS-IoT-Core]]
278
279
280 ===== 4.4.4 LogRead =====
281
282 ====== 4.4.4.1 LoRa Log ======
283
284 (% style="text-align:center" %)
285 [[image:1651744955955-452.png||height="571" width="621"]]
286
287 Show the frequency for LoRa Radio and traffics.
288
289
290 ====== 4.4.4.2 System Log ======
291
292 Show system log.
293
294 (% style="text-align:center" %)
295 [[image:1651745003470-264.png||height="477" width="621"]]
296
297
298
299 ====== 4.4.4.3 Record Log ======
300
301 **~ Record the system log.**
302
303 (% style="text-align:center" %)
304 [[image:1651745069814-662.png||height="144" width="621"]]
305
306
307 === 5. Install stand alone LoRa Packet Forwarder. ===
308
309 ==== 5.1 OS requirement ====
310
311 RPI in this example is RPI model 4B with fresh Raspbian OS install.
312
313 pi@raspberrypi:~~$ cat /etc/os-release
314
315 PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
316
317 NAME="Raspbian GNU/Linux"
318
319 VERSION_ID="8"
320
321 VERSION="8 (jessie)"
322
323 ID=raspbian
324
325 ID_LIKE=debian
326
327 HOME_URL="http:~/~/www.raspbian.org/"
328
329 SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
330
331 BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
332
333
334 ==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
335
336 In RPI, run below command to get a Gateway ID
337
338 (% class="mark" %)ifconfig eth0
339
340 (% style="text-align:center" %)
341 [[image:1651745210205-512.png||height="130" width="621"]]
342
343
344 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.
345
346 Make sure to select legacy packet forwarder.
347
348 (% style="text-align:center" %)
349 [[image:1651745267862-321.png||height="526" width="621"]]
350
351
352
353 (% style="text-align:center" %)
354 [[image:1651745306744-481.png||height="478" width="621"]]
355
356 After set up, the status should show not connected as below:
357
358 (% style="text-align:center" %)
359 [[image:1651745366987-458.png||height="363" width="621"]]
360
361
362 ===== 5.2.1 Download and install LoRaWAN packet forwarder =====
363
364 Enable SPI and I2C first:
365
366 a)SPI needs to be enabled on the Raspberry Pi
367
368 Run sudo raspi-config to open the config window
369
370 (% style="text-align:center" %)
371 [[image:1651745476754-240.png||height="235" width="631"]]
372
373
374 (% style="text-align:center" %)
375 [[image:image-20220505181135-1.png]]
376
377 (% style="text-align:center" %)
378 [[image:image-20220505181135-2.png]]
379
380
381
382
383 In RPI , Fist: Enter root account:
384
385 (% style="text-align:center" %)
386 [[image:1651745583363-614.png]]
387
388
389 and then run:
390
391 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]]
392
393 chmod +x ./auto_install.sh
394
395 ./auto_install.sh
396
397 (% style="text-align:center" %)
398 [[image:1651745611629-818.png]]
399
400
401 This will download the packet forwarder package from Dragino Server to RPI, and start install the package.
402
403 You can get these output:
404
405 (% style="text-align:center" %)
406 [[image:1651745657252-173.png||height="426" width="621"]]
407
408
409 ===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
410
411 After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the **gateway_ID** in file **local_conf.json**
412
413 The default LoRaWAN server points to localhost, user need to put the correct server address to the server_address field in file **local_conf.json**, like below.
414
415 (% style="text-align:center" %)
416 [[image:1651745709709-887.png||height="820" width="621"]]
417
418
419 User can find the TTN v3 server address from:
420
421 [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
422
423
424 And the default frequency band is US915 in **global_conf.json** file.
425
426 (% style="text-align:center" %)
427 [[image:1651745838008-820.png||height="650" width="621"]]
428
429
430 * If user want to change to other frequency bands, User can copy the file from **/etc/lora/cfg-302 **and put it into** /etc/lora/global_conf.json.**
431
432 1).Chose your need the name of region frequency.
433
434 (% style="text-align:center" %)
435 [[image:1651745867516-322.png]]
436
437
438 2). Use this command to copy it.
439
440 cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
441
442 (% style="text-align:center" %)
443 [[image:1651745984006-868.png]]
444
445
446 * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
447
448 (% class="wikigeneratedid" %)
449 (((
450
451 )))
452
453 ===== 5.2.3 Check result =====
454
455 Run below command to restart the dragino_fwd:
456
457 sudo systemctl stop draginofwd
458
459 sudo systemctl start draginofwd
460
461 debug check the ruing status of fwd:
462
463 sudo systemctl status draginofwd
464
465 (% style="text-align:center" %)
466 [[image:1651746045057-414.png]]
467
468
469 The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
470
471 (% style="text-align:center" %)
472 [[image:1651746078253-168.png||height="372" width="621"]]
473
474
475 We can check dragino_fwd running states in RPi by running:
476
477 //**sudo journalctl -u draginofwd -f**//
478
479 (% style="text-align:center" %)
480 [[image:1651746111963-838.png]]
481
482 If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
483
484 (% style="text-align:center" %)
485 [[image:1651746139304-966.png||height="326" width="621"]]
486
487
488 ===== 5.2.4 Commands to handle service =====
489
490 * **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
491 * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
492 * **Start** dragino_fwd : sudo systemctl start draginofwd
493 * **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
494 * **Show status** of dragino_fwd:  sudo systemctl status draginofwd
495
496 === 6. Order Info ===
497
498 Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
499
500 **~ XX:**
501
502 * 868 (For Bands: EU868,IN865)
503 * 915 (For Bands: US915,AU915,AS923,KR920)
504 * 470 (For Band: CN470)
505
506 === 7. Packing Info ===
507
508 **~ PG1302 Package Includes**:
509
510 * PG1302 x 1
511 * LoRa Antenna x 1
512
513 **~ PG1302-PI Package Includes**:
514
515 * PG1302 x 1
516 * LoRa Antenna x 1
517 * RPi3/4 converter PCB
518 * Screws to hole converter PCB on RPI.
519
520 === 8. Reference ===
521
522 * Datasheet, User Manual & Software Download:
523
524 [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
525
526
527 === 9. Support ===
528
529 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
530 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to
531
532 [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0