Last modified by Kilight Cao on 2024/06/22 10:43
<
From version < 104.1 >
edited by Xiaoling
on 2022/06/16 08:59
To version < 108.7 >
edited by Xiaoling
on 2022/07/28 14:26
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -PG1302 LoRaWAN Concentrator
1 +PG1302 - LoRaWAN Concentrator User Manual
Content
... ... @@ -1,11 +1,9 @@
1 1  (% style="text-align:center" %)
2 -[[image:Main.User Manual for All Gateway models.WebHome@pg1302.jpg||height="391" width="549"]]
2 +[[image:image-20220616085956-1.jpeg||height="609" width="609"]]
3 3  
4 4  
5 5  
6 -**PG1302 LoRaWAN Concentrator User Manual**
7 7  
8 -
9 9  **Table of Contents：**
10 10  
11 11  {{toc/}}
... ... @@ -28,6 +28,7 @@
28 28  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.
29 29  
30 30  
29 +
31 31  == **1.2 Features** ==
32 32  
33 33  * Base on Semtech SX1302 solution
... ... @@ -37,26 +37,45 @@
37 37  * Mini-PCIe Interface
38 38  * Converter board to support Raspberry Pi
39 39  
40 -== **1.3 General Interfaces** ==
41 41  
40 +
41 +
42 +
43 +== **1.3 General Interfaces for PG1302** ==
44 +
42 42  * SPI interface for LoRa
43 43  * Power Input: 5v, 1A
44 44  * 1 x I-PEX for LoRa
45 45  
49 +
50 +
51 +
52 +
46 46  == **1.4 Pin Mapping** ==
47 47  
55 +
48 48   [[image:1651743282627-547.png||height="402" width="425"]]
49 49  
58 +
59 +
50 50  == **1.5 LEDs** ==
51 51  
62 +
52 52   TX: Blink when transmit a packet
53 53   RX: Blink when receive a packet
54 54   Config: Always ON
55 55  
67 +
68 +
56 56  == **1.6 Power Consumption** ==
57 57  
58 - TBD
59 59  
72 +<300mA @ 3.3v.
73 +
74 +Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
75 +
76 +
77 +
60 60  == **1.7 Applications** ==
61 61  
62 62  * Smart Buildings & Home Automation
... ... @@ -66,6 +66,10 @@
66 66  * Smart Cities
67 67  * Smart Factory
68 68  
87 +
88 +
89 +
90 +
69 69  = **2. Example: Set up as LoRaWAN gateway.** =
70 70  
71 71  == **2.1 System structure** ==
... ... @@ -76,13 +76,16 @@
76 76  [[image:1651743698677-436.png||height="457" width="686"]]
77 77  
78 78  
101 +
79 79  == **2.2 Hardware Installation** ==
80 80  
104 +
81 81  (% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
82 82  
83 -[[image:1651743803032-803.png]]
107 +[[image:image-20220621104746-1.png||height="381" width="451"]]
84 84  
85 85  
110 +
86 86  = **3. Install the software?** =
87 87  
88 88  There are two ways to install the software in RPi4 to use PG1302.
... ... @@ -90,29 +90,39 @@
90 90  * Flash SD card with Dragino pre-build image which supports Web UI.
91 91  * Install Lora packet forwarder in existing RPi OS.
92 92  
118 +
119 +
120 +
121 +
93 93  = **4. Flash with pre-build image** =
94 94  
95 95  == **4.1 Download the dragino image for RPI** ==
96 96  
97 -Download PG1302_for_Rpi4_64_with_webui from
98 -[[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]]
99 99  
127 +(((
128 +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]]
129 +)))
100 100  
131 +
132 +
101 101  == **4.2 Flash the image to an SD card** ==
102 102  
135 +
103 103  Flash the image to the SD card:
104 104  
105 105  [[image:1651744119133-233.png||height="373" width="621"]]
106 106  
107 - Note: Download the flash tool following this link
108 108  
109 - [[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
141 +(% style="color:red" %)**Note: Download the flash tool following this link：**[[https:~~/~~/www.balena.io/etcher/>>https://www.balena.io/etcher/]]
110 110  
111 111  
144 +
112 112  == **4.3 Access the Linux console** ==
113 113  
114 -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
115 115  
148 +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
149 +
150 +
116 116  [[image:1651744193675-591.png||height="450" width="466"]]
117 117  
118 118  The account details for Web Login are:
... ... @@ -144,11 +144,13 @@
144 144  [[image:1651744358515-107.png||height="366" width="581"]]
145 145  
146 146  
182 +
147 147  == **4.4 Access the WebUI of RPi4.** ==
148 148  
149 149  === **4.4.1 Home page** ===
150 150  
151 -Open a browser on the PC and type the RPI ip address[[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by the uplink router)
187 +
188 +Open a browser on the PC and type the RPI ip address [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by the uplink router)
152 152  You will see the login interface of RPI as shown below.
153 153  The account details for Web Login are:
154 154  
... ... @@ -155,13 +155,17 @@
155 155  (((
156 156  **~ (% style="color:#0000ff" %)User Name: root(%%)**
157 157  (% style="color:#0000ff" %)** Password:   dragino**
195 +
196 +
158 158  )))
159 159  
160 160  [[image:1651744457761-993.png||height="352" width="621"]]
161 161  
162 162  
202 +
163 163  === **4.4.2 LoRa Page** ===
164 164  
205 +
165 165  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.
166 166  
167 167  [[image:1651744554845-970.png||height="328" width="621"]]
... ... @@ -168,15 +168,14 @@
168 168  
169 169  Different PG1302 hardware version can support different frequency range:
170 170  
171 -➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
212 +➢** (% style="color:red" %)868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.(%%)**
172 172  
173 -➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
214 +➢ (% style="color:red" %)**915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920**
174 174  
175 -After user choose the frequency plan, he can see the actually frequency in used by checking the
216 +After user choose the frequency plan, he can see the actually frequency in used by checking the (% style="color:blue" %)**page LogRead ~-~-> LoRa Log**
176 176  
177 -page LogRead ~-~-> LoRa Log
218 +(% style="color:red" %)**Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
178 178  
179 -Note *: [[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]
180 180  
181 181  
182 182  === **4.4.3 LoRaWAN Page** ===
... ... @@ -183,45 +183,57 @@
183 183  
184 184  ==== **4.4.3.1 Semtech UDP** ====
185 185  
226 +
186 186  [[image:1651744767914-283.png||height="352" width="621"]]
187 187  
188 -Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].
229 +(% style="color:red" %)**Note *: [[See this instruction for how to configure TTN>>doc:Main.Notes for TTN.WebHome]].**
189 189  
190 190  
232 +
191 191  ==== **4.4.3.2 Basic Station** ====
192 192  
235 +
193 193  [[image:1651744890629-683.png||height="380" width="621"]]
194 194  
195 -Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].
196 196  
239 +(% style="color:red" %)**Note *: [[See this instruction for how to configure AWS-loT-Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**
197 197  
241 +
242 +
198 198  === **4.4.4 LogRead** ===
199 199  
200 200  ==== **4.4.4.1 LoRa Log** ====
201 201  
247 +
202 202  [[image:1651744955955-452.png||height="571" width="621"]]
203 203  
204 204  Show the frequency for LoRa Radio and traffics.
205 205  
206 206  
253 +
207 207  ==== **4.4.4.2 System Log** ====
208 208  
256 +
209 209  Show system log.
210 210  
211 211  [[image:1651745003470-264.png||height="477" width="621"]]
212 212  
213 213  
262 +
214 214  ==== **4.4.4.3 Record Log** ====
215 215  
265 +
216 216  **Record the system log.**
217 217  
218 218  [[image:1651745069814-662.png||height="144" width="621"]]
219 219  
220 220  
271 +
221 221  = **5. Install stand-alone LoRa Packet Forwarder.** =
222 222  
223 223  == **5.1 OS requirement** ==
224 224  
276 +
225 225  RPI in this example is RPI model 4B with fresh Raspbian OS install.
226 226  
227 227  (% class="box" %)
... ... @@ -240,20 +240,26 @@
240 240  
241 241  )))
242 242  
243 -== **5.2 Get Gateway ID in Raspberry and input this in TTN v3.** ==
244 244  
296 +
297 +== **5.2 Get Gateway ID in Raspberry and input this in TTN v3** ==
298 +
299 +
245 245  In RPI, run the below command to get a Gateway ID
246 246  
247 247  (% class="box infomessage" %)
248 248  (((
249 - ifconfig eth0
304 +**~ ifconfig eth0**
250 250  )))
251 251  
252 252  [[image:1651745210205-512.png||height="130" width="621"]]
253 253  
309 +
254 254  (((
255 255  (((
256 256  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.
313 +
314 +
257 257  )))
258 258  )))
259 259  
... ... @@ -261,17 +261,21 @@
261 261  
262 262  [[image:1651745306744-481.png||height="478" width="621"]]
263 263  
322 +
264 264  After set up, the status should show not connected as below:
265 265  
266 266  [[image:1651745366987-458.png||height="363" width="621"]]
267 267  
268 -=== 5.2.1 Download and install LoRaWAN packet forwarder ===
269 269  
328 +
329 +=== **5.2.1 Download and install LoRaWAN packet forwarder** ===
330 +
331 +
270 270  Enable SPI and I2C first:
271 271  
272 -a)SPI needs to be enabled on the Raspberry Pi
334 +a)  SPI needs to be enabled on the Raspberry Pi
273 273  
274 -Run (% style="background-color:#dcdcdc" %)**sudo raspi-config**(%%) to open the config window
336 +Run (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window
275 275  
276 276  [[image:1651745476754-240.png||height="234" width="629"]]
277 277  
... ... @@ -279,10 +279,14 @@
279 279  
280 280  [[image:image-20220505181135-2.png||height="229" width="622"]]
281 281  
344 +
345 +
282 282  In RPI, Fist: Enter the root account:
283 283  
284 284  (((
285 285  [[image:1651745583363-614.png||height="151" width="732"]]
350 +
351 +
286 286  )))
287 287  
288 288  and then run:
... ... @@ -303,10 +303,14 @@
303 303  
304 304  (((
305 305  [[image:1651745657252-173.png||height="426" width="621"]]
372 +
373 +
374 +
306 306  )))
307 307  
308 -=== 5.2.2 Config Gateway ID, Frequency Band and Server address ===
377 +=== **5.2.2 Config Gateway ID, Frequency Band and Server address** ===
309 309  
379 +
310 310  (((
311 311  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.**
312 312  )))
... ... @@ -313,26 +313,30 @@
313 313  
314 314  (((
315 315  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.
386 +
387 +
316 316  )))
317 317  
318 318  [[image:1651745709709-887.png||height="820" width="621"]]
319 319  
320 -User can find the TTN v3 server address from:
321 321  
322 -[[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]]
393 +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]]
323 323  
324 324  And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file.
325 325  
326 326  [[image:1651745838008-820.png||height="650" width="621"]]
327 327  
399 +
328 328  * 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(%%).**
329 329  
330 - 1).Chose your need the name of region frequency.
402 +**~ 1). Chose your need the name of region frequency.**
331 331  
332 332  [[image:1651745867516-322.png||height="83" width="740"]]
333 333  
334 - 2). Use this command to copy it.
335 335  
407 +*
408 +** 2). Use this command to copy it.
409 +
336 336   cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json
337 337  
338 338  [[image:1651745984006-868.png||height="87" width="745"]]
... ... @@ -339,8 +339,11 @@
339 339  
340 340  * If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
341 341  
342 -=== 5.2.3 Check result ===
343 343  
417 +
418 +=== **5.2.3 Check result** ===
419 +
420 +
344 344  (((
345 345  Run below command to restart the dragino_fwd:
346 346  )))
... ... @@ -348,15 +348,16 @@
348 348  (((
349 349  (% class="box infomessage" %)
350 350  (((
351 -sudo systemctl stop draginofwd
428 +**sudo systemctl stop draginofwd**
352 352  )))
353 353  
354 354  (% class="box infomessage" %)
355 355  (((
356 -sudo systemctl start draginofwd
433 +**sudo systemctl start draginofwd**
357 357  )))
358 358  )))
359 359  
437 +
360 360  (((
361 361  debug check the ruing status of fwd:
362 362  )))
... ... @@ -364,32 +364,40 @@
364 364  (((
365 365  (% class="box infomessage" %)
366 366  (((
367 -sudo systemctl status draginofwd
445 +**sudo systemctl status draginofwd**
368 368  )))
369 369  )))
370 370  
371 371  [[image:1651746045057-414.png||height="193" width="729"]]
372 372  
451 +
452 +
373 373  The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
374 374  
455 +
375 375  [[image:1651746078253-168.png||height="372" width="621"]]
376 376  
377 377  
459 +
378 378  We can check dragino_fwd running states in RPi by running:
379 379  
380 380  (% class="box infomessage" %)
381 381  (((
382 - sudo journalctl -u draginofwd -f
464 +**~ sudo journalctl -u draginofwd -f**
383 383  )))
384 384  
385 385  [[image:1651746111963-838.png||height="184" width="730"]]
386 386  
387 - If there are LoRaWAN nodes transmitting nearby, we can see the traffic in **TTN v3 –> Gateway ~-~-> Live data**
388 388  
470 + If there are LoRaWAN nodes transmitting nearby, we can see the traffic in (% style="color:#037691" %)**TTN v3 –> Gateway ~-~-> Live data**
471 +
389 389  [[image:1651746139304-966.png||height="326" width="621"]]
390 390  
391 -=== 5.2.4 Commands to handle service ===
392 392  
475 +
476 +=== **5.2.4 Commands to handle service** ===
477 +
478 +
393 393  * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service:  sudo systemctl stop draginofwd
394 394  * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
395 395  * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd : sudo systemctl start draginofwd
... ... @@ -396,19 +396,29 @@
396 396  * (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot:  sudo systemctl enable draginofwd
397 397  * (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd:  sudo systemctl status draginofwd
398 398  
399 -= 6. Order Info =
400 400  
486 +
487 +
488 += **6. Order Info** =
489 +
490 +
401 401  Part Number: (% style="color:#0000ff" %)**PG1302-XX**   (%%) Or  Part Number: (% style="color:#0000ff" %)**PG1302-PI-XX   **(%%)(Include RPi converter board for RPI 3/4)
402 402  
403 403  **~ (% style="color:#0000ff" %)XX:(%%)**
404 404  
405 -* (% style="color:#0000ff" %)**868** (%%)(For Bands: EU868,IN865)
406 -* (% style="color:#0000ff" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)
407 -* (% style="color:#0000ff" %)**470** (%%)(For Band: CN470)
495 +* (% style="color:red" %)**868** (%%)(For Bands: EU868,IN865)
496 +* (% style="color:red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)
497 +* (% style="color:red" %)**470** (%%)(For Band: CN470)
408 408  
409 -= 7. Packing Info =
410 410  
500 +
501 +
502 +
503 += **7. Packing Info** =
504 +
411 411  (((
506 +
507 +
412 412  **PG1302 Package Includes**:
413 413  )))
414 414  
... ... @@ -420,6 +420,9 @@
420 420  )))
421 421  
422 422  (((
519 +
520 +
521 +
423 423  **PG1302-PI Package Includes**:
424 424  )))
425 425  
... ... @@ -428,11 +428,21 @@
428 428  * RPi3/4 converter PCB
429 429  * Screws to hole converter PCB on RPI.
430 430  
530 +**PG1302-PI Dimension and weight: **
531 +
532 +* Device Size: 18 x 8 x 4 cm
533 +* Weight: 150g
534 +
535 +
536 +
537 +
538 +
431 431  (((
432 -= 8. Support =
540 += **8. Support** =
433 433  
542 +
434 434  (((
435 -If you are experiencing issues and can’t solve, you can send mail to
544 +If you are experiencing issues and can't solve, you can send mail to
436 436  )))
437 437  
438 438  (((
image-20220621104746-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +861.7 KB
Content

Applications

Navigation

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