Last modified by Kilight Cao on 2024/06/22 10:43
<
From version < 96.1 >
edited by Edwin Chen
on 2022/05/06 20:06
To version < 67.1 >
edited by Xiaoling
on 2022/05/06 11:06
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -11,19 +11,17 @@
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 28  === 1. Introduction ===
29 29  
... ... @@ -30,85 +30,25 @@
30 30  ==== 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,22 +190,18 @@
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 -(((
198 - Download PG1302_for_Rpi4_64_with_webui from
199 -)))
123 + Download PG1302_for_Rpi4_64_with_webui from
200 200  
201 -(((
202 - [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
203 -)))
125 + [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
204 204  
205 205  
206 -==== 4.2 Flash the image to SD card ====
128 +4.2 Flash the image to SD card
207 207  
208 - Flash the image to SD card:
130 + Flash the image to SD card:
209 209  
210 210  (% style="text-align:center" %)
211 211  [[image:1651744119133-233.png||height="373" width="621"]]
... ... @@ -215,35 +215,12 @@
215 215   [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
216 216  
217 217  
218 -==== 4.3 Access the Linux console ====
140 +4.3 Access the Linux console.
219 219  
220 -(((
221 -(((
222 -(((
223 - Connect the RPI Ethernet port to your router, RPi will obtain an IP address from your router. In the router’s
224 -)))
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.
225 225  
226 -(((
227 - management portal, you should be able to find what IP address the router has assigned to the RPI. You can
228 -)))
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
229 229  
230 -(((
231 - use this IP to connect the WEB UI or SSH access of RPI.
232 -)))
233 -)))
234 -
235 -(((
236 -(((
237 - 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.
238 -)))
239 -
240 -(((
241 - Below are screenshots
242 -)))
243 -)))
244 -)))
245 -
246 -
247 247  (% style="text-align:center" %)
248 248  [[image:1651744193675-591.png||height="450" width="466"]]
249 249  
... ... @@ -266,51 +266,35 @@
266 266  [[image:1651744358515-107.png||height="366" width="581"]]
267 267  
268 268  
269 -==== 4.4 Access the WebUI of RPi4. ====
168 + 4.4 Access the WebUI of RPi4.
270 270  
271 -===== 4.4.1 Home page =====
170 + 4.4.1 Home page
272 272  
273 -(((
274 - Open a browser on the PC and type the RPI ip address
275 -)))
172 + Open a browser on the PC and type the RPI ip address
276 276  
277 -(((
278 - [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
279 -)))
174 + [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router)
280 280  
281 -(((
282 - You will see the login interface of RPI as shown below.
283 -)))
284 284  
285 -(((
286 - The account details for Web Login are:
287 -)))
177 + You will see the login interface of RPI as shown below.
288 288  
289 -(((
179 + The account details for Web Login are:
180 +
290 290  **~ User Name: root**
291 -)))
292 292  
293 -(((
294 294  **~ Password:   dragino**
295 -)))
296 296  
297 297  (% style="text-align:center" %)
298 298  [[image:1651744457761-993.png||height="352" width="621"]]
299 299  
300 300  
301 -===== 4.4.2 LoRa Page =====
189 +4.4.2 LoRa Page
302 302  
303 -(((
304 - This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN
305 -)))
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.
306 306  
307 -(((
308 - protocol, and user can customize the band* as well.
309 -)))
310 -
311 311  (% style="text-align:center" %)
312 312  [[image:1651744554845-970.png||height="328" width="621"]]
313 313  
196 +
314 314   Different PG1302 hardware version can support different frequency range:
315 315  
316 316   ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
... ... @@ -317,6 +317,7 @@
317 317  
318 318   ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
319 319  
203 +
320 320   After user choose the frequency plan, he can see the actually frequency in used by checking the
321 321  
322 322   page LogRead ~-~-> LoRa Log
... ... @@ -326,61 +326,66 @@
326 326   [[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]]
327 327  
328 328  
329 -===== 4.4.3 LoRaWAN Page =====
213 +4.4.3 LoRaWAN Page
330 330  
331 -====== 4.4.3.1 Semtech UDP ======
215 + 4.4.3.1 Semtech UDP
332 332  
333 333  
334 334  (% style="text-align:center" %)
335 335  [[image:1651744767914-283.png||height="352" width="621"]]
336 336  
337 - Note *: See this instruction for how to configure TTN.
338 338  
339 - [[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);"]]
340 340  
223 + Note *: See this instruction for how to configure TTN.
341 341  
342 -====== 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]]
343 343  
227 +
228 +4.4.3.2 Basic Station
229 +
344 344  (% style="text-align:center" %)
345 345  [[image:1651744890629-683.png||height="380" width="621"]]
346 346  
347 - Note *: See this instruction for how to configure TTN.
348 348  
349 - [[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.
350 350  
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]]
351 351  
352 -===== 4.4.4 LogRead =====
353 353  
354 -====== 4.4.4.1 LoRa Log ======
239 +4.4.4 LogRead
355 355  
241 + 4.4.4.1 LoRa Log
242 +
356 356  (% style="text-align:center" %)
357 357  [[image:1651744955955-452.png||height="571" width="621"]]
358 358  
359 - Show the frequency for LoRa Radio and traffics.
360 360  
247 + Show the frequency for LoRa Radio and traffics.
361 361  
362 -====== 4.4.4.2 System Log ======
363 363  
364 - Show system log.
250 +4.4.4.2 System Log
365 365  
252 + Show system log.
253 +
366 366  (% style="text-align:center" %)
367 367  [[image:1651745003470-264.png||height="477" width="621"]]
368 368  
369 369  
370 370  
371 -====== 4.4.4.3 Record Log ======
259 +4.4.4.3 Record Log
372 372  
373 -**~ Record the system log.**
374 374  
262 +**Record the system log.**
263 +
375 375  (% style="text-align:center" %)
376 376  [[image:1651745069814-662.png||height="144" width="621"]]
377 377  
378 378  
379 -=== 5. Install stand alone LoRa Packet Forwarder. ===
268 +5. Install stand alone LoRa Packet Forwarder.
380 380  
381 -==== 5.1 OS requirement ====
270 + 5.1 OS requirement
382 382  
383 - 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.
384 384  
385 385   pi@raspberrypi:~~$ cat /etc/os-release
386 386  
... ... @@ -403,22 +403,17 @@
403 403   BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
404 404  
405 405  
406 -==== 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.
407 407  
408 - In RPI, run below command to get a Gateway ID
297 + In RPI, run below command to get a Gateway ID
409 409  
410 - (% class="mark" %)ifconfig eth0
299 + ifconfig eth0
411 411  
412 412  (% style="text-align:center" %)
413 413  [[image:1651745210205-512.png||height="130" width="621"]]
414 414  
415 -(((
416 - We got the ether (eth0 MAC) address is b8:27:eb:49:62:bc). Add ffff at the end and remove “:” to get the
417 -)))
418 418  
419 -(((
420 - gateway ID: b827ebxxxxbcffff.  Input this to TTN v3. Make sure to select legacy packet forwarder.
421 -)))
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.
422 422  
423 423  (% style="text-align:center" %)
424 424  [[image:1651745267862-321.png||height="526" width="621"]]
... ... @@ -434,8 +434,9 @@
434 434  [[image:1651745366987-458.png||height="363" width="621"]]
435 435  
436 436  
437 -===== 5.2.1 Download and install LoRaWAN packet forwarder =====
438 438  
322 +5.2.1 Download and install LoRaWAN packet forwarder
323 +
439 439   Enable SPI and I2C first:
440 440  
441 441   a)SPI needs to be enabled on the Raspberry Pi
... ... @@ -481,34 +481,22 @@
481 481  [[image:1651745657252-173.png||height="426" width="621"]]
482 482  
483 483  
484 -===== 5.2.2 Config Gateway ID, Frequency Band and Server address =====
369 +5.5.2 Config Gateway ID, Frequency Band and Server address
485 485  
486 -(((
487 - After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the
488 -)))
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**
489 489  
490 -(((
491 -**~ gateway_ID** in file **local_conf.json**
492 -)))
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.
493 493  
494 -(((
495 - The default LoRaWAN server points to localhost, user need to put the correct server address to the
496 -)))
497 -
498 -(((
499 - server_address field in file **local_conf.json**, like below.
500 -)))
501 -
502 502  (% style="text-align:center" %)
503 503  [[image:1651745709709-887.png||height="820" width="621"]]
504 504  
505 505  
506 - User can find the TTN v3 server address from:
379 + User can find the TTN v3 server address from:
507 507  
508 - [[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]]
509 509  
510 510  
511 - 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.
512 512  
513 513  (% style="text-align:center" %)
514 514  [[image:1651745838008-820.png||height="650" width="621"]]
... ... @@ -532,60 +532,47 @@
532 532  
533 533  * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file.
534 534  
535 -(% class="wikigeneratedid" %)
536 -(((
537 -
538 -)))
408 +5.2.3 Check result
539 539  
540 -===== 5.2.3 Check result =====
410 + Run below command to restart the dragino_fwd:
541 541  
542 -(((
543 - Run below command to restart the dragino_fwd:
544 -)))
545 -
546 -(((
547 547   sudo systemctl stop draginofwd
548 -)))
549 549  
550 -(((
551 551   sudo systemctl start draginofwd
552 -)))
553 553  
554 -(((
555 - debug check the ruing status of fwd:
556 -)))
416 + debug check the ruing status of fwd:
557 557  
558 -(((
559 - sudo systemctl status draginofwd
560 -)))
418 + sudo systemctl status draginofwd
561 561  
562 562  (% style="text-align:center" %)
563 563  [[image:1651746045057-414.png]]
564 564  
565 565  
566 - 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:
567 567  
568 568  (% style="text-align:center" %)
569 569  [[image:1651746078253-168.png||height="372" width="621"]]
570 570  
571 571  
572 -We can check dragino_fwd running states in RPi by running:
573 573  
574 -(% class="box infomessage" %)
575 -(((
576 - **// sudo journalctl -u draginofwd -f//**
577 -)))
431 + We can check dragino_fwd running states in RPi by running:
578 578  
433 + //**sudo journalctl -u draginofwd -f**//
434 +
435 +(% style="text-align:center" %)
579 579  [[image:1651746111963-838.png]]
580 580  
581 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
582 582  
583 583  
440 + If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data
441 +
442 +(% style="text-align:center" %)
584 584  [[image:1651746139304-966.png||height="326" width="621"]]
585 585  
586 586  
587 -===== 5.2.4 Commands to handle service =====
588 588  
447 +5.2.4 Commands to handle service
448 +
589 589  * **Stop** dragino_fwd service:  sudo systemctl stop draginofwd
590 590  * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd
591 591  * **Start** dragino_fwd : sudo systemctl start draginofwd
... ... @@ -592,43 +592,40 @@
592 592  * **Auto run** dragino_fwd after boot:  sudo systemctl enable draginofwd
593 593  * **Show status** of dragino_fwd:  sudo systemctl status draginofwd
594 594  
595 -=== 6. Order Info ===
455 +6. Order Info
596 596  
597 - 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)
598 598  
599 -**~ XX:**
459 +**~ XX:**
600 600  
601 601  * 868 (For Bands: EU868,IN865)
602 602  * 915 (For Bands: US915,AU915,AS923,KR920)
603 603  * 470 (For Band: CN470)
604 604  
605 -=== 7. Packing Info ===
465 +7. Packing Info
606 606  
607 -(((
608 -**~ PG1302 Package Includes**:
609 -)))
467 +**~ PG1302 Package Includes**:
610 610  
611 -* (((
612 -PG1302 x 1
613 -)))
614 -* (((
615 -LoRa Antenna x 1
616 -)))
469 +* PG1302 x 1
470 +* LoRa Antenna x 1
617 617  
618 -(((
619 -**~ PG1302-PI Package Includes**:
620 -)))
472 +**~ PG1302-PI Package Includes**:
621 621  
622 -* (((
623 -PG1302 x 1
624 -)))
625 -* (((
626 -LoRa Antenna x 1
627 -)))
628 -* (((
629 -RPi3/4 converter PCB
630 -)))
631 -* (((
632 -Screws to hole converter PCB on RPI.
633 -)))
474 +* PG1302 x 1
475 +* LoRa Antenna x 1
476 +* RPi3/4 converter PCB
477 +* Screws to hole converter PCB on RPI.
634 634  
479 +8. Reference
480 +
481 +* Datasheet, User Manual & Software Download:
482 +
483 + [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
484 +
485 +
486 +9. Support
487 +
488 +* 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.
489 +* 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
490 +
491 + [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]

Applications

Navigation

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