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 | 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 | ||
179 | |||
180 | management portal, you should be able to find what IP address the router has assigned to the RPI. You can | ||
181 | |||
182 | 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. | ||
187 | |||
188 | Below are screenshots | ||
189 | ))) | ||
190 | ))) | ||
191 | |||
192 | |||
193 | (% style="text-align:center" %) | ||
194 | [[image:1651744193675-591.png||height="450" width="466"]] | ||
195 | |||
196 | |||
197 | The account details for Web Login are: | ||
198 | |||
199 | **~ User Name: root** | ||
200 | |||
201 | **~ Password: dragino** | ||
202 | |||
203 | |||
204 | **~ Backup account** | ||
205 | |||
206 | **~ Pi/dragino** | ||
207 | |||
208 | |||
209 | After log in, you will be in the Linux console and type command here. | ||
210 | |||
211 | (% style="text-align:center" %) | ||
212 | [[image:1651744358515-107.png||height="366" width="581"]] | ||
213 | |||
214 | |||
215 | ==== 4.4 Access the WebUI of RPi4. ==== | ||
216 | |||
217 | ===== 4.4.1 Home page ===== | ||
218 | |||
219 | Open a browser on the PC and type the RPI ip address | ||
220 | |||
221 | [[http:~~/~~/IP_ADDRESS** **>>url:http://192.168.1.xx/]] (If the IP is assigned by uplink router) | ||
222 | |||
223 | You will see the login interface of RPI as shown below. | ||
224 | |||
225 | The account details for Web Login are: | ||
226 | |||
227 | **~ User Name: root** | ||
228 | |||
229 | **~ Password: dragino** | ||
230 | |||
231 | (% style="text-align:center" %) | ||
232 | [[image:1651744457761-993.png||height="352" width="621"]] | ||
233 | |||
234 | |||
235 | ===== 4.4.2 LoRa Page ===== | ||
236 | |||
237 | This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN | ||
238 | |||
239 | protocol, and user can customize the band* as well. | ||
240 | |||
241 | (% style="text-align:center" %) | ||
242 | [[image:1651744554845-970.png||height="328" width="621"]] | ||
243 | |||
244 | Different PG1302 hardware version can support different frequency range: | ||
245 | |||
246 | ➢ 868: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. | ||
247 | |||
248 | ➢ 915: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920 | ||
249 | |||
250 | After user choose the frequency plan, he can see the actually frequency in used by checking the | ||
251 | |||
252 | page LogRead ~-~-> LoRa Log | ||
253 | |||
254 | Note *: See this instruction for how to customize frequency band | ||
255 | |||
256 | [[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]] | ||
257 | |||
258 | |||
259 | ===== 4.4.3 LoRaWAN Page ===== | ||
260 | |||
261 | ====== 4.4.3.1 Semtech UDP ====== | ||
262 | |||
263 | |||
264 | (% style="text-align:center" %) | ||
265 | [[image:1651744767914-283.png||height="352" width="621"]] | ||
266 | |||
267 | Note *: See this instruction for how to configure TTN. | ||
268 | |||
269 | [[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);"]] | ||
270 | |||
271 | |||
272 | ====== 4.4.3.2 Basic Station ====== | ||
273 | |||
274 | (% style="text-align:center" %) | ||
275 | [[image:1651744890629-683.png||height="380" width="621"]] | ||
276 | |||
277 | Note *: See this instruction for how to configure TTN. | ||
278 | |||
279 | [[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]] | ||
280 | |||
281 | |||
282 | ===== 4.4.4 LogRead ===== | ||
283 | |||
284 | ====== 4.4.4.1 LoRa Log ====== | ||
285 | |||
286 | (% style="text-align:center" %) | ||
287 | [[image:1651744955955-452.png||height="571" width="621"]] | ||
288 | |||
289 | Show the frequency for LoRa Radio and traffics. | ||
290 | |||
291 | |||
292 | ====== 4.4.4.2 System Log ====== | ||
293 | |||
294 | Show system log. | ||
295 | |||
296 | (% style="text-align:center" %) | ||
297 | [[image:1651745003470-264.png||height="477" width="621"]] | ||
298 | |||
299 | |||
300 | |||
301 | ====== 4.4.4.3 Record Log ====== | ||
302 | |||
303 | **~ Record the system log.** | ||
304 | |||
305 | (% style="text-align:center" %) | ||
306 | [[image:1651745069814-662.png||height="144" width="621"]] | ||
307 | |||
308 | |||
309 | === 5. Install stand alone LoRa Packet Forwarder. === | ||
310 | |||
311 | ==== 5.1 OS requirement ==== | ||
312 | |||
313 | RPI in this example is RPI model 4B with fresh Raspbian OS install. | ||
314 | |||
315 | pi@raspberrypi:~~$ cat /etc/os-release | ||
316 | |||
317 | PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)" | ||
318 | |||
319 | NAME="Raspbian GNU/Linux" | ||
320 | |||
321 | VERSION_ID="8" | ||
322 | |||
323 | VERSION="8 (jessie)" | ||
324 | |||
325 | ID=raspbian | ||
326 | |||
327 | ID_LIKE=debian | ||
328 | |||
329 | HOME_URL="http:~/~/www.raspbian.org/" | ||
330 | |||
331 | SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums" | ||
332 | |||
333 | BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs" | ||
334 | |||
335 | |||
336 | ==== 5.2 Get Gateway ID in Raspberry and input this in TTN v3. ==== | ||
337 | |||
338 | In RPI, run below command to get a Gateway ID | ||
339 | |||
340 | (% class="mark" %)ifconfig eth0 | ||
341 | |||
342 | (% style="text-align:center" %) | ||
343 | [[image:1651745210205-512.png||height="130" width="621"]] | ||
344 | |||
345 | 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. | ||
346 | |||
347 | Input this to TTN v3. Make sure to select legacy packet forwarder. | ||
348 | |||
349 | (% style="text-align:center" %) | ||
350 | [[image:1651745267862-321.png||height="526" width="621"]] | ||
351 | |||
352 | |||
353 | |||
354 | (% style="text-align:center" %) | ||
355 | [[image:1651745306744-481.png||height="478" width="621"]] | ||
356 | |||
357 | After set up, the status should show not connected as below: | ||
358 | |||
359 | (% style="text-align:center" %) | ||
360 | [[image:1651745366987-458.png||height="363" width="621"]] | ||
361 | |||
362 | |||
363 | ===== 5.2.1 Download and install LoRaWAN packet forwarder ===== | ||
364 | |||
365 | Enable SPI and I2C first: | ||
366 | |||
367 | a)SPI needs to be enabled on the Raspberry Pi | ||
368 | |||
369 | Run sudo raspi-config to open the config window | ||
370 | |||
371 | (% style="text-align:center" %) | ||
372 | [[image:1651745476754-240.png||height="235" width="631"]] | ||
373 | |||
374 | |||
375 | (% style="text-align:center" %) | ||
376 | [[image:image-20220505181135-1.png]] | ||
377 | |||
378 | (% style="text-align:center" %) | ||
379 | [[image:image-20220505181135-2.png]] | ||
380 | |||
381 | |||
382 | |||
383 | |||
384 | In RPI , Fist: Enter root account: | ||
385 | |||
386 | (% style="text-align:center" %) | ||
387 | [[image:1651745583363-614.png]] | ||
388 | |||
389 | |||
390 | and then run: | ||
391 | |||
392 | 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]] | ||
393 | |||
394 | chmod +x ./auto_install.sh | ||
395 | |||
396 | ./auto_install.sh | ||
397 | |||
398 | (% style="text-align:center" %) | ||
399 | [[image:1651745611629-818.png]] | ||
400 | |||
401 | |||
402 | This will download the packet forwarder package from Dragino Server to RPI, and start install the package. | ||
403 | |||
404 | You can get these output: | ||
405 | |||
406 | (% style="text-align:center" %) | ||
407 | [[image:1651745657252-173.png||height="426" width="621"]] | ||
408 | |||
409 | |||
410 | ===== 5.2.2 Config Gateway ID, Frequency Band and Server address ===== | ||
411 | |||
412 | ((( | ||
413 | After installation, user can find the configuration file in** /etc/lora/ **Replace the gateway ID we got above to the | ||
414 | ))) | ||
415 | |||
416 | ((( | ||
417 | **~ gateway_ID** in file **local_conf.json** | ||
418 | ))) | ||
419 | |||
420 | ((( | ||
421 | The default LoRaWAN server points to localhost, user need to put the correct server address to the | ||
422 | ))) | ||
423 | |||
424 | ((( | ||
425 | server_address field in file **local_conf.json**, like below. | ||
426 | ))) | ||
427 | |||
428 | (% style="text-align:center" %) | ||
429 | [[image:1651745709709-887.png||height="820" width="621"]] | ||
430 | |||
431 | |||
432 | User can find the TTN v3 server address from: | ||
433 | |||
434 | [[Server Addresses ~| The Things Stack for LoRaWAN (thethingsindustries.com)>>url:https://www.thethingsindustries.com/docs/getting-started/server-addresses/#deployments]] | ||
435 | |||
436 | |||
437 | And the default frequency band is US915 in **global_conf.json** file. | ||
438 | |||
439 | (% style="text-align:center" %) | ||
440 | [[image:1651745838008-820.png||height="650" width="621"]] | ||
441 | |||
442 | |||
443 | * 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.** | ||
444 | |||
445 | 1).Chose your need the name of region frequency. | ||
446 | |||
447 | (% style="text-align:center" %) | ||
448 | [[image:1651745867516-322.png]] | ||
449 | |||
450 | |||
451 | 2). Use this command to copy it. | ||
452 | |||
453 | cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json | ||
454 | |||
455 | (% style="text-align:center" %) | ||
456 | [[image:1651745984006-868.png]] | ||
457 | |||
458 | |||
459 | * If user wants to change to other LoRaWAN server, modify the **global_conf.json** file. | ||
460 | |||
461 | (% class="wikigeneratedid" %) | ||
462 | ((( | ||
463 | |||
464 | ))) | ||
465 | |||
466 | ===== 5.2.3 Check result ===== | ||
467 | |||
468 | Run below command to restart the dragino_fwd: | ||
469 | |||
470 | sudo systemctl stop draginofwd | ||
471 | |||
472 | sudo systemctl start draginofwd | ||
473 | |||
474 | debug check the ruing status of fwd: | ||
475 | |||
476 | sudo systemctl status draginofwd | ||
477 | |||
478 | (% style="text-align:center" %) | ||
479 | [[image:1651746045057-414.png]] | ||
480 | |||
481 | |||
482 | The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok: | ||
483 | |||
484 | (% style="text-align:center" %) | ||
485 | [[image:1651746078253-168.png||height="372" width="621"]] | ||
486 | |||
487 | |||
488 | We can check dragino_fwd running states in RPi by running: | ||
489 | |||
490 | //**sudo journalctl -u draginofwd -f**// | ||
491 | |||
492 | (% style="text-align:center" %) | ||
493 | [[image:1651746111963-838.png]] | ||
494 | |||
495 | If there are LoRaWAN nodes transmits nearby, we can see the traffic in TTN v3 –> Gateway ~-~-> Live data | ||
496 | |||
497 | (% style="text-align:center" %) | ||
498 | [[image:1651746139304-966.png||height="326" width="621"]] | ||
499 | |||
500 | |||
501 | ===== 5.2.4 Commands to handle service ===== | ||
502 | |||
503 | * **Stop** dragino_fwd service: sudo systemctl stop draginofwd | ||
504 | * **Disable** dragino_fwd auto run after boot: sudo systemctl disable draginofwd | ||
505 | * **Start** dragino_fwd : sudo systemctl start draginofwd | ||
506 | * **Auto run** dragino_fwd after boot: sudo systemctl enable draginofwd | ||
507 | * **Show status** of dragino_fwd: sudo systemctl status draginofwd | ||
508 | |||
509 | === 6. Order Info === | ||
510 | |||
511 | Part Number: **PG1302-XX** Or Part Number: **PG1302-PI-XX **(Include RPi converter board for RPI 3/4) | ||
512 | |||
513 | **~ XX:** | ||
514 | |||
515 | * 868 (For Bands: EU868,IN865) | ||
516 | * 915 (For Bands: US915,AU915,AS923,KR920) | ||
517 | * 470 (For Band: CN470) | ||
518 | |||
519 | === 7. Packing Info === | ||
520 | |||
521 | **~ PG1302 Package Includes**: | ||
522 | |||
523 | * PG1302 x 1 | ||
524 | * LoRa Antenna x 1 | ||
525 | |||
526 | **~ PG1302-PI Package Includes**: | ||
527 | |||
528 | * PG1302 x 1 | ||
529 | * LoRa Antenna x 1 | ||
530 | * RPi3/4 converter PCB | ||
531 | * Screws to hole converter PCB on RPI. | ||
532 | |||
533 | === 8. Reference === | ||
534 | |||
535 | * Datasheet, User Manual & Software Download: | ||
536 | |||
537 | [[https:~~/~~/www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0>>url:https://www.dropbox.com/sh/f6nbldh1qbspya5/AACgL6pDkwdBQO1BQqq_Nubwa?dl=0]] | ||
538 | |||
539 | |||
540 | === 9. Support === | ||
541 | |||
542 | * 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. | ||
543 | * 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 | ||
544 | |||
545 | [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] |