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