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