Last modified by Kilight Cao on 2024/06/22 10:43
<
From version < 91.1 >
edited by Xiaoling
on 2022/05/06 16:26
To version < 66.1 >
edited by Xiaoling
on 2022/05/06 11:03
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -11,104 +11,42 @@
11 11  
12 12  **PG1302 LoRaWAN Concentrator User Manual**
13 13  
14 +[[image:1651796979665-130.png]]
14 14  
16 +Document Version: 1.0.0
15 15  
18 +Image Version: v1.0
16 16  
17 17  
18 -{{toc/}}
19 19  
20 20  
21 -----
23 +{{toc/}}
22 22  
23 -(% class="wikigeneratedid" id="H" %)
24 -(((
25 -
26 -)))
27 27  
28 -=== 1. Introduction ===
26 += 1. Introduction =
29 29  
30 -==== 1.1 What is PG1302 LoRaWAN Concentrator? ====
28 +== 1.1 What is PG1302 LoRaWAN Concentrator? ==
31 31  
32 32  (((
33 -(((
34 -(((
35 -(((
36 - The PG1302 is a multi-channel high performance transmitter/receiver designed to simultaneously receive several
31 +The PG1302 is a 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.
37 37  )))
38 -)))
39 39  
40 40  (((
41 -(((
42 - LoRa packets using random spreading factors on random channels. Its goal is to enable robust connection
35 +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 interfered environment.
43 43  )))
44 44  
45 45  (((
46 - between a central wireless data concentrator and a massive amount of wireless end-points spread over
39 +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 in the exist OS.
47 47  )))
48 48  
49 49  (((
50 - a very wide range of distances.
51 -)))
52 -)))
53 -)))
54 -
55 55  (((
56 -(((
57 -(((
58 58  
59 59  )))
60 60  )))
61 -)))
62 -)))
63 63  
64 -(((
65 -(((
66 -(((
67 -(((
68 - The PG1302 is design to use with Raspberry Pi to build smart metering fixed networks and Internet of Things
69 -)))
70 -)))
48 +1.2 Features
71 71  
72 -(((
73 -(((
74 - applications with up to 5000 nodes per km2 in moderately interfered environment.
75 -)))
76 -)))
77 -)))
78 -
79 -(((
80 -(((
81 -(((
82 -
83 -)))
84 -)))
85 -)))
86 -)))
87 -
88 -(((
89 -(((
90 -(((
91 -(((
92 - PG1302 is fully compatible with RPi3/4, users can use the pre-build OS from Dragino to set up and easy to use the
93 -)))
94 -)))
95 -
96 -(((
97 -(((
98 - module by Web UI. Or install the raw lorawan driver in the exist OS.
99 -)))
100 -)))
101 -)))
102 -)))
103 -
104 -(((
105 -(((
106 -
107 -)))
108 -)))
109 -
110 -==== 1.2 Features ====
111 -
112 112  * Base on Semtech SX1302 solution
113 113  * Support Raspberry Pi 3B/3B+/4
114 114  * Up to -140dBm sensitivity
... ... @@ -116,39 +116,33 @@
116 116  * Mini-PCIe Interface
117 117  * Converter board to support Raspberry Pi
118 118  
119 -==== 1.3 General Interfaces ====
57 +1.3 General Interfaces
120 120  
121 121  * SPI interface for LoRa
122 122  * Power Input: 5v, 1A
123 123  * 1 x I-PEX for LoRa
124 124  
125 -==== 1.4 Pin Mapping ====
63 +1.4 Pin Mapping
126 126  
127 127   [[image:1651743282627-547.png||height="402" width="425"]]
128 128  
129 129  
130 130  
131 -==== 1.5 LEDs ====
69 +1.5 LEDs
132 132  
133 -(((
134 - TX: Blink when transmit a packet
135 -)))
71 + TX: Blink when transmit a packet
136 136  
137 -(((
138 - RX: Blink when receive a packet
139 -)))
73 + RX: Blink when receive a packet
140 140  
141 -(((
142 - Config: Always ON
143 -)))
75 + Config: Always ON
144 144  
145 145  
146 -==== 1.6 Power Consumption ====
78 +1.6 Power Consumption
147 147  
148 - TBD
80 + TBD
149 149  
150 150  
151 -==== 1.7 Applications ====
83 +1.7 Applications
152 152  
153 153  * Smart Buildings & Home Automation
154 154  * Logistics and Supply Chain Management
... ... @@ -157,24 +157,18 @@
157 157  * Smart Cities
158 158  * Smart Factory
159 159  
160 -=== 2. Example: Set up as LoRaWAN gateway. ===
92 +2. Example: Set up as LoRaWAN gateway.
161 161  
162 -==== 2.1 System structure ====
94 + 2.1 System structure
163 163  
164 -(((
165 - This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with
166 -)))
96 + This example is an example to show how to set up the PG1302 + RPi as a LoRaWAN gateway to use with [[TheThingsNetwork>>http://www.thethingsnetwork.org/]](TTN) LoRaWAN server.. Set up method for other  server are similar。
167 167  
168 -(((
169 - [[TheThingsNetwork>>url:http://www.thethingsnetwork.org/]](TTN) LoRaWAN server. Set up method for other server are similar.
170 -)))
171 -
172 172  (% style="text-align:center" %)
173 173  [[image:1651743698677-436.png||height="457" width="686"]]
174 174  
175 175  
176 176  
177 -==== 2.2 Hardware Installation ====
103 +2.2 Hardware Installation
178 178  
179 179  **~ Important Notice: **Please power the RPI with 5V,3A cable.
180 180  
... ... @@ -183,7 +183,7 @@
183 183  
184 184  
185 185  
186 -=== 3. Install the software? ===
112 +3. Install the software?
187 187  
188 188   There are two ways to install software in RPi4 to use PG1302.
189 189  
... ... @@ -190,9 +190,9 @@
190 190  * Flash SD card with Dragino pre-build image which support Web UI.
191 191  * Install lora packet forwarder in existing RPi OS.
192 192  
193 -=== 4. Flash with pre-build image ===
119 +4. Flash with pre-build image
194 194  
195 -==== 4.1 Download the dragino image for RPI ====
121 + 4.1 Download the dragino image for RPI
196 196  
197 197   Download PG1302_for_Rpi4_64_with_webui from
198 198  
... ... @@ -199,9 +199,9 @@
199 199   [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
200 200  
201 201  
202 -==== 4.2 Flash the image to SD card ====
128 +4.2 Flash the image to SD card
203 203  
204 - Flash the image to SD card:
130 + Flash the image to SD card:
205 205  
206 206  (% style="text-align:center" %)
207 207  [[image:1651744119133-233.png||height="373" width="621"]]
... ... @@ -211,35 +211,12 @@
211 211   [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
212 212  
213 213  
214 -==== 4.3 Access the Linux console ====
140 +4.3 Access the Linux console.
215 215  
216 -(((
217 -(((
218 -(((
219 - Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s
220 -)))
142 + 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.
221 221  
222 -(((
223 - management portal, you should be able to find what IP address the router has assigned to the RPI. You can
224 -)))
144 + 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
225 225  
226 -(((
227 - use this IP to connect the WEB UI or SSH access of RPI.
228 -)))
229 -)))
230 -
231 -(((
232 -(((
233 - 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.
234 -)))
235 -
236 -(((
237 - Below are screenshots
238 -)))
239 -)))
240 -)))
241 -
242 -
243 243  (% style="text-align:center" %)
244 244  [[image:1651744193675-591.png||height="450" width="466"]]
245 245  
... ... @@ -262,18 +262,19 @@
262 262  [[image:1651744358515-107.png||height="366" width="581"]]
263 263  
264 264  
265 -==== 4.4 Access the WebUI of RPi4. ====
168 + 4.4 Access the WebUI of RPi4.
266 266  
267 -===== 4.4.1 Home page =====
170 + 4.4.1 Home page
268 268  
269 - Open a browser on the PC and type the RPI ip address
172 + Open a browser on the PC and type the RPI ip address
270 270  
271 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
174 + [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
272 272  
273 - You will see the login interface of RPI as shown below.
274 274  
275 - The account details for Web Login are:
177 + You will see the login interface of RPI as shown below.
276 276  
179 + The account details for Web Login are:
180 +
277 277  **~ User Name: root**
278 278  
279 279  **~ Password:   dragino**
... ... @@ -282,19 +282,14 @@
282 282  [[image:1651744457761-993.png||height="352" width="621"]]
283 283  
284 284  
285 -===== 4.4.2 LoRa Page =====
189 +4.4.2 LoRa Page
286 286  
287 -(((
288 - This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
289 -)))
191 + 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.
290 290  
291 -(((
292 - protocol, and user can customize the band* as well.
293 -)))
294 -
295 295  (% style="text-align:center" %)
296 296  [[image:1651744554845-970.png||height="328" width="621"]]
297 297  
196 +
298 298   Different PG1302 hardware version can support different frequency range:
299 299  
300 300   ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
... ... @@ -301,6 +301,7 @@
301 301  
302 302   ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
303 303  
203 +
304 304   After user choose the frequency plan, he can see the actually frequency in used by checking the
305 305  
306 306   page LogRead ~-~-> LoRa Log
... ... @@ -310,61 +310,66 @@
310 310   [[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]]
311 311  
312 312  
313 -===== 4.4.3 LoRaWAN Page =====
213 +4.4.3 LoRaWAN Page
314 314  
315 -====== 4.4.3.1 Semtech UDP ======
215 + 4.4.3.1 Semtech UDP
316 316  
317 317  
318 318  (% style="text-align:center" %)
319 319  [[image:1651744767914-283.png||height="352" width="621"]]
320 320  
321 - Note *: See this instruction for how to configure TTN.
322 322  
323 - [[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);"]]
324 324  
223 + Note *: See this instruction for how to configure TTN.
325 325  
326 -====== 4.4.3.2 Basic Station ======
225 + [[https:~~/~~/wiki.dragino.com/index.php?title=Notes_for_TTN>>url:https://wiki.dragino.com/index.php?title=Notes_for_TTN]]
327 327  
227 +
228 +4.4.3.2 Basic Station
229 +
328 328  (% style="text-align:center" %)
329 329  [[image:1651744890629-683.png||height="380" width="621"]]
330 330  
331 - Note *: See this instruction for how to configure TTN.
332 332  
333 - [[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]]
234 + Note *: See this instruction for how to configure TTN.
334 334  
236 + [[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]]
335 335  
336 -===== 4.4.4 LogRead =====
337 337  
338 -====== 4.4.4.1 LoRa Log ======
239 +4.4.4 LogRead
339 339  
241 + 4.4.4.1 LoRa Log
242 +
340 340  (% style="text-align:center" %)
341 341  [[image:1651744955955-452.png||height="571" width="621"]]
342 342  
343 - Show the frequency for LoRa Radio and traffics.
344 344  
247 + Show the frequency for LoRa Radio and traffics.
345 345  
346 -====== 4.4.4.2 System Log ======
347 347  
348 - Show system log.
250 +4.4.4.2 System Log
349 349  
252 + Show system log.
253 +
350 350  (% style="text-align:center" %)
351 351  [[image:1651745003470-264.png||height="477" width="621"]]
352 352  
353 353  
354 354  
355 -====== 4.4.4.3 Record Log ======
259 +4.4.4.3 Record Log
356 356  
357 -**~ Record the system log.**
358 358  
262 +**Record the system log.**
263 +
359 359  (% style="text-align:center" %)
360 360  [[image:1651745069814-662.png||height="144" width="621"]]
361 361  
362 362  
363 -=== 5. Install stand alone LoRa Packet Forwarder. ===
268 +5. Install stand alone LoRa Packet Forwarder.
364 364  
365 -==== 5.1 OS requirement ====
270 + 5.1 OS requirement
366 366  
367 - RPI in this example is RPI model 4B with fresh Raspbian OS install.
272 + RPI in this example is RPI model 4B with fresh Raspbian OS install.
368 368  
369 369   pi@raspberrypi:~~$ cat /etc/os-release
370 370  
... ... @@ -387,22 +387,17 @@
387 387   BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
388 388  
389 389  
390 -==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ====
295 +5.2 Get Gateway ID in Raspberry and input this in TTN v3.
391 391  
392 - In RPI, run below command to get a Gateway ID
297 + In RPI, run below command to get a Gateway ID
393 393  
394 - (% class="mark" %)ifconfig eth0
299 + ifconfig eth0
395 395  
396 396  (% style="text-align:center" %)
397 397  [[image:1651745210205-512.png||height="130" width="621"]]
398 398  
399 -(((
400 - We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
401 -)))
402 402  
403 -(((
404 - gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
405 -)))
305 + 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.
406 406  
407 407  (% style="text-align:center" %)
408 408  [[image:1651745267862-321.png||height="526" width="621"]]
... ... @@ -418,8 +418,9 @@
418 418  [[image:1651745366987-458.png||height="363" width="621"]]
419 419  
420 420  
421 -===== 5.2.1 Download and install LoRaWAN packet forwarder =====
422 422  
322 +5.2.1 Download and install LoRaWAN packet forwarder
323 +
423 423   Enable SPI and I2C first:
424 424  
425 425   a)SPI needs to be enabled on the Raspberry Pi
... ... @@ -465,34 +465,22 @@
465 465  [[image:1651745657252-173.png||height="426" width="621"]]
466 466  
467 467  
468 -===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
369 +5.5.2 Config Gateway ID, Frequency Band and Server address
469 469  
470 -(((
471 - After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
472 -)))
371 + 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**
473 473  
474 -(((
475 -**~ gateway_ID** in file **local_conf.json**
476 -)))
373 + 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.
477 477  
478 -(((
479 - The default LoRaWAN server points to localhost, user need to put the correct server address to the
480 -)))
481 -
482 -(((
483 - server_address field in file **local_conf.json**, like below.
484 -)))
485 -
486 486  (% style="text-align:center" %)
487 487  [[image:1651745709709-887.png||height="820" width="621"]]
488 488  
489 489  
490 - User can find the TTN v3 server address from:
379 + User can find the TTN v3 server address from:
491 491  
492 - [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
381 + [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
493 493  
494 494  
495 - And the default frequency band is US915 in **global_conf.json** file.
384 + And the default frequency band is US915 in **global_conf.json** file.
496 496  
497 497  (% style="text-align:center" %)
498 498  [[image:1651745838008-820.png||height="650" width="621"]]
... ... @@ -516,58 +516,47 @@
516 516  
517 517  * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
518 518  
519 -(% class="wikigeneratedid" %)
520 -(((
521 -
522 -)))
408 +5.2.3 Check result
523 523  
524 -===== 5.2.3 Check result =====
410 + Run below command to restart the dragino_fwd:
525 525  
526 -(((
527 - Run below command to restart the dragino_fwd:
528 -)))
529 -
530 -(((
531 531   sudo systemctl stop draginofwd
532 -)))
533 533  
534 -(((
535 535   sudo systemctl start draginofwd
536 -)))
537 537  
538 -(((
539 - debug check the ruing status of fwd:
540 -)))
416 + debug check the ruing status of fwd:
541 541  
542 -(((
543 - sudo systemctl status draginofwd
544 -)))
418 + sudo systemctl status draginofwd
545 545  
546 546  (% style="text-align:center" %)
547 547  [[image:1651746045057-414.png]]
548 548  
549 549  
550 - The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
424 + The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
551 551  
552 552  (% style="text-align:center" %)
553 553  [[image:1651746078253-168.png||height="372" width="621"]]
554 554  
555 555  
556 - We can check dragino_fwd running states in RPi by running:
557 557  
558 - //**sudo journalctl -u draginofwd -f**//
431 + We can check dragino_fwd running states in RPi by running:
559 559  
433 + //**sudo journalctl -u draginofwd -f**//
434 +
560 560  (% style="text-align:center" %)
561 561  [[image:1651746111963-838.png]]
562 562  
563 - If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
564 564  
439 +
440 + If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
441 +
565 565  (% style="text-align:center" %)
566 566  [[image:1651746139304-966.png||height="326" width="621"]]
567 567  
568 568  
569 -===== 5.2.4 Commands to handle service =====
570 570  
447 +5.2.4 Commands to handle service
448 +
571 571  * **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
572 572  * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
573 573  * **Start** dragino_fwd : sudo systemctl start draginofwd
... ... @@ -574,47 +574,31 @@
574 574  * **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
575 575  * **Show status** of dragino_fwd:  sudo systemctl status draginofwd
576 576  
577 -=== 6. Order Info ===
455 +6. Order Info
578 578  
579 - Part Number: **PG1302-XX**  Or  Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
457 + Part Number: **PG1302-XX**  Or Part Number: **PG1302-PI-XX   **(Include RPi converter board for RPI 3/4)
580 580  
581 -**~ XX:**
459 +**~ XX:**
582 582  
583 583  * 868 (For Bands: EU868,IN865)
584 584  * 915 (For Bands: US915,AU915,AS923,KR920)
585 585  * 470 (For Band: CN470)
586 586  
587 -=== 7. Packing Info ===
465 +7. Packing Info
588 588  
589 -(((
590 -**~ PG1302 Package Includes**:
591 -)))
467 +**~ PG1302 Package Includes**:
592 592  
593 -* (((
594 -PG1302 x 1
595 -)))
596 -* (((
597 -LoRa Antenna x 1
598 -)))
469 +* PG1302 x 1
470 +* LoRa Antenna x 1
599 599  
600 -(((
601 -**~ PG1302-PI Package Includes**:
602 -)))
472 +**~ PG1302-PI Package Includes**:
603 603  
604 -* (((
605 -PG1302 x 1
606 -)))
607 -* (((
608 -LoRa Antenna x 1
609 -)))
610 -* (((
611 -RPi3/4 converter PCB
612 -)))
613 -* (((
614 -Screws to hole converter PCB on RPI.
615 -)))
474 +* PG1302 x 1
475 +* LoRa Antenna x 1
476 +* RPi3/4 converter PCB
477 +* Screws to hole converter PCB on RPI.
616 616  
617 -=== 8. Reference ===
479 +8. Reference
618 618  
619 619  * Datasheet, User Manual & Software Download:
620 620  
... ... @@ -621,7 +621,7 @@
621 621   [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
622 622  
623 623  
624 -=== 9. Support ===
486 +9. Support
625 625  
626 626  * 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.
627 627  * 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

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0