Changes for page PG1302 -- LoRaWAN Concentrator User Manual

Last modified by Kilight Cao on 2024/06/22 10:43

From version < 145.2 >

edited by Xiaoye
on 2024/02/26 16:24

To version < 116.1 >

edited by Xiaoye
on 2023/03/29 15:33

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 19 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--PG1302 -- LoRaWAN Concentrator User Manual
++PG1302 - LoRaWAN Concentrator User Manual

Content

@@ -4,7 +4,7 @@
--**Table of Contents:**
++**Table of Contents：**
  {{toc/}}
@@ -20,7 +20,7 @@
  (((
--The PG1302 is a (% style="color:blue" %)**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.
++The PG1302 is a (% style="color:green" %)**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.
  )))
  (((
@@ -28,7 +28,7 @@
  )))
  (((
--PG1302 is fully compatible with (% style="color:blue" %)**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.
++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.
  )))
@@ -42,6 +42,7 @@
  * Mini-PCIe Interface
  * Converter board to support Raspberry Pi
++
  == 1.3 General Interfaces for PG1302 ==
@@ -50,10 +50,11 @@
  * 1 x I-PEX for LoRa
  * Working Temperature: -40 ℃ ~~ 80℃
++
  == 1.4 Pin Mapping ==
--[[image:image-20240122140551-1.png]]
++     [[image:1651743282627-547.png||height="402" width="425"]]
  == 1.5 LEDs ==
@@ -61,7 +61,7 @@
  (((
  TX: Blink when transmit a packet
--RX: Blink when receiving a packet
++RX: Blink when receive a packet
  Config: Always ON
  )))
@@ -74,22 +74,9 @@
  Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
--== 1.7 Antenna Installation ==
++== 1.7 Applications ==
--Left:      **GPS antenna**
--
--Right:   **LoRa Antenna**
--
--[[image:https://www.thethingsnetwork.org/forum/uploads/default/original/3X/6/2/624619afa8d75a2c21bfd1e3687afaa75ad61cbc.jpeg||alt="PG1302_70"]]
--
--
--
--
--
--== 1.8 Applications ==
--
--
  * Smart Buildings & Home Automation
  * Logistics and Supply Chain Management
  * Smart Metering
@@ -117,7 +117,7 @@
  (% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
--[[image:image-20220621104746-1.png||height="351" width="415"]]
++[[image:image-20220621104746-1.png||height="381" width="451"]]
  = 3. Install the software? =
@@ -136,6 +136,7 @@
  * Install [[Dragino-FWD>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/PG1302/#H5.2.2.A0Selecttheappropriatedeviceversiontodownload:]] in the existing OS.
++
  = 4. Flash with pre-build image =
  == 4.1 Download the dragino image for RPI ==
@@ -272,6 +272,7 @@
  Show system log.
++
  [[image:1651745003470-264.png||height="477" width="621"]]
@@ -280,6 +280,7 @@
  **Record the system log.**
++
  [[image:1651745069814-662.png||height="144" width="621"]]
@@ -320,7 +320,7 @@
  (% class="box" %)
  (((
--**~        pi@raspberrypi:~~$ cat /etc/os-release
++        pi@raspberrypi:~~$ cat /etc/os-release
          PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
          NAME="Raspbian GNU/Linux"
          VERSION_ID="8"
@@ -329,31 +329,18 @@
          ID_LIKE=debian
          HOME_URL="http:~/~/www.raspbian.org/"
          SUPPORT_URL="http:~/~/www.raspbian.org/RaspbianForums"
--        BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"**
++        BUG_REPORT_URL="http:~/~/www.raspbian.org/RaspbianBugs"
  )))
--== 5.2 Select the mode of connection to the server ==
++5.2 Select the mode of connection to the server
--The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode.
++== 5.2 Get Gateway ID in Raspberry and input this in TTN v3 ==
--The User can choose one of the methods as the connection mode.
--
--**~1. Semtech UDP Mode  ~-~-> 5.2.1**
--
--**2. Basic Station Mode   ~-~-> 5.2.2**
--
--
--=== 5.2.1 Semtech UDP Mode ===
--
--
--==== **a). Get a gateway EUI from the device ETH MAC.** ====
--
--
  In RPI, run the below command to get a Gateway ID
  (% class="box infomessage" %)
@@ -368,10 +368,6 @@
  (((
  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.
--
--
--==== **b). Input this Gateway EUI to the TTN-Stack** ====
--
  )))
  )))
@@ -381,20 +381,18 @@
  [[image:1651745306744-481.png||height="478" width="621"]]
++After set up, the status should show not connected as below:
--==== **c). After Register, the status should show not connected as below:** ====
--
--
  [[image:1651745366987-458.png||height="363" width="621"]]
++=== 5.2.1 Download and install LoRaWAN packet forwarder ===
--==== **d). Enable SPI and I2C on your device** ====
++Enable SPI and I2C first:
--**the below example is using Raspberry 4B.**
++a)  SPI needs to be enabled on the Raspberry Pi
--
  Run  (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window
  [[image:1651745476754-240.png||height="234" width="629"]]
@@ -407,38 +407,35 @@
--==== **e). Access the root account:** ====
++In RPI, Fist: Enter the root account:
  (((
  [[image:1651745583363-614.png||height="151" width="732"]]
--
  )))
--==== **f). Modify the configuration of FWD** ====
++=== 5.2.2 Select the appropriate device version to download: ===
--(((
--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.**
--)))
++
  (((
--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.
++
--the User can find the lora configuration directory in (% style="color:#0000ff" %)**/etc/lora/**(%%) there are the cfg-302 directory and the global_conf.json, and local_conf.json files.
++
++)))
--/etc/lora/
--├── cfg-302                   ~-~--> global configuration file
--├── devskey                  ~-~--> Database
--├── global_conf.json     ~-~--> Frequency plan for current applications
--└── local_conf.json        ~-~--> Local fwd configuration
++=== 5.2.3 Config Gateway ID, Frequency Band and Server address ===
--At default, the users need to change two configurations file: global_conf.json and local_conf.json.
++(((
++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.**
++)))
--===== **1.) Configure gateway EUI and server address, port for fwd** =====
++(((
++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.
  )))
@@ -446,30 +446,24 @@
  [[image:1651745709709-887.png||height="820" width="621"]]
--**Note: Users 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]]**
++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]]
++And the default frequency band is US915 in (% style="color:#0000ff" %)**global_conf.json**(%%) file.
--===== **2). Override the global_conf.json file by selecting the appropriate frequency plan for your region in cfg-302** =====
--
--
--the default frequency band is US915 in the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
--
  [[image:1651745838008-820.png||height="650" width="621"]]
--If the user wants to change to other frequency bands, the 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(%%).**
++* 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(%%).**
--**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //**
++**~     1). Chose your need the name of region frequency.**
--
--====== **Selecting the appropriate frequency plan for your region in cfg-302.** ======
--
  [[image:1651745867516-322.png||height="83" width="740"]]
--====== **Override the global_conf.json** ======
++**~  2). Use this command to copy it.**
++
  (% class="box infomessage" %)
  (((
  **cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json**
@@ -478,20 +478,29 @@
  [[image:1651745984006-868.png||height="87" width="745"]]
--==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ====
++* If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
++=== 5.2.4 Check result ===
++
++
  (((
--Run the below command to restart the dragino_fwd:
++Run below command to restart the dragino_fwd:
  )))
  (((
  (% class="box infomessage" %)
  (((
++**sudo systemctl stop draginofwd**
++)))
++
++(% class="box infomessage" %)
++(((
  **sudo systemctl start draginofwd**
  )))
  )))
++
  (((
  debug check the ruing status of fwd:
  )))
@@ -506,13 +506,15 @@
  [[image:1651746045057-414.png||height="193" width="729"]]
--Wait for a few minutes, the gateway will be online/active on the TTN-Stack.
++The dragino_fwd will start with the new gateway ID and TTN v3 should show the connection ok:
++
++
  [[image:1651746078253-168.png||height="372" width="621"]]
--Get the draginofwd real-time running log:
++We can check dragino_fwd running states in RPi by running:
  (% class="box infomessage" %)
  (((
@@ -528,8 +528,9 @@
  [[image:1651746139304-966.png||height="326" width="621"]]
--==== **h). Commands to handle service** ====
++=== 5.2.5 Commands to handle service ===
++
  * (% style="color:#0000ff" %)**Stop** (%%)dragino_fwd service:  sudo systemctl stop draginofwd
  * (% style="color:#0000ff" %)**Disable**(%%) dragino_fwd auto run after boot: sudo systemctl disable draginofwd
  * (% style="color:#0000ff" %)**Start** (%%)dragino_fwd :  sudo systemctl start draginofwd
@@ -536,195 +536,10 @@
  * (% style="color:#0000ff" %)**Auto run**(%%) dragino_fwd after boot:  sudo systemctl enable draginofwd
  * (% style="color:#0000ff" %)**Show status** (%%)of dragino_fwd:  sudo systemctl status draginofwd
--=== 5.2.2 Basic Station Mode. ===
++= 6. Order Info =
--==== **a). Get a gateway EUI from the device ETH MAC.** ====
--
--In RPI, run the below command to get a Gateway EUI
--
--(% class="box infomessage" %)
--(((
--**~   ifconfig eth0**
--)))
--
--[[image:1651745210205-512.png||height="130" width="621"]]
--
--
--(((
--(((
--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.
--)))
--)))
--
--
--
--==== **b). Register the gateway with the Basic Station Mode on the TTN-Stack** ====
--
--
--[[image:image-20230329164417-5.png]]
--
--
--
--==== **c). Download the gateway API keys, and then upload them to the gateway.** ====
--
--
--[[image:image-20230329164704-6.png]]
--
--
--==== **d). The status Shows disconnect.** ====
--
--
--[[image:image-20230329165619-7.png||height="568" width="948"]]
--
--
--==== **e.) Uploda API keys into the gateway** ====
--
--
--the User can find the Basic Station configuration directory in (% style="color:#0000ff" %)**/etc/station/**(%%) there is the station.conf files, and ttnstack directory.
--
--//**directory tree:**//
--
--///etc/station/
--├── station.conf
--└── ttnstack              ~-~--> ** ttnstack configuration file directory**
--    ├── cups.trust       ~-~-->  ttnstack auth file
--    ├── cups.uri          ~-~-->  ttnstack server URI file
--    └── station.conf   ~-~-~-~-> backup configuration file//
--
--
--
--**and then upload the downloaded keys to this directory((% style="color:#0000ff" %)/etc/station/(%%))**
--
--eg:
--
--/etc/station/
--├── cups.key           ~-~--> uploaded by you
--├── lns.key              ~-~--> uploaded by you
--├── station.conf
--
--
--==== **f). Configure gateway EUI and server address** ====
--
--
--[[image:image-20230329195650-10.png]]
--
--
--After the user enters the correct parameters, the server will be run automatically
--
--
--Tree Directory:
--
--/etc/station/
--├── cups.key
--├── cups.trust
--├── cups.uri
--├── lns.key
--├── start-configure.sh
--├── station.conf
--└── ttnstack
--    ├── cups.trust
--    ├── cups.uri
--    └── station.conf
--
--
--==== **g). Check station running log** ====
--
--
--tail -f /var/log/station.log
--
--
--[[image:image-20230329201624-11.png]]
--
--
--
--= 6. Add GPS support in PG1302 =
--
--The PG1302 supports GPS:
--
--[[image:image-20240118160132-1.png||height="270" width="338"]]
--
--
--* **The users can find the GPS device in Raspberry: /dev/ttyS0 or /dev/ttyAMA0**
--
--     [[image:image-20240118160407-2.png||height="71" width="458"]]
--
--
--* **Check the GPS output: cat /dev/ttyS0**
--
--     [[image:image-20240118160454-3.png]]
--
--
--* **Add the GPS to the Semtech UDP package forwarder configuration.**
--
--     [[image:image-20240118160928-4.png||height="426" width="464"]]
--
--
--* **Test GPS function**
--
--**~     1.) Stop IoT service: systemctl stop draginofwd**
--
--
--**~      2.) Run the fwd command and check the output**
--
--
--     [[image:image-20240118161109-5.png]]
--
--
--**~      3.) Trouble Shooting:**
--
--      If you get many WARNING outputs, which should be the GPS location is invalid, you need to adjust the GPS location, it is recommended to put it outdoors
--
--
--     [[image:image-20240118161333-6.png]]
--
--
--     The user can check the PG1302 board GPS LED status to check the location,
--
--     GPS location is valid    ~-~--> GPS LED will light up
--
--     GPS location is invalid ~-~--> GPS LED will light down
--
--
--     [[image:image-20240118162033-7.png]]
--
--
--
--= 7. Trouble Shooting =
--
--(% class="wikigeneratedid" %)
--7.1 Failed to start the concentrator how to debug
--
--
----When the problem "failed to start the concentrator" occurs, the user needs to check whether the I2C and SPI are enabled,--
--
----Users can enter the following command to check whether I2C is detected, and the detection of **"60"** is correct.--
--
--(% class="box infomessage" %)
--(((
----**i2cdetect -y 1**--
--)))
--
--**Note: This method has been removed because the i2c had been removed on the latest PG1302.**
--
--
--
--Check whether the SPI path of the configuration file is correct,
--
--(% class="box infomessage" %)
--(((
--**cat /etc/lora/global_conf.json **
--)))
--
--(% class="wikigeneratedid" %)
--[[image:image-20230518092732-2.png||height="378" width="691"]]
--
--
--
--= 8. Order Info =
--
--
  Part Number:  (% style="color:#0000ff" %)**PG1302-XX**   (%%) Or  Part Number:  (% style="color:#0000ff" %)**PG1302-PI-XX   **(%%)(Include RPi converter board for RPI 3/4)
  **~     (% style="color:#0000ff" %)XX:(%%)**
@@ -733,21 +733,25 @@
  * (% style="color:red" %)**915** (%%)(For Bands: US915,AU915,AS923,KR920)
  * (% style="color:red" %)**470** (%%)(For Band: CN470)
--= 9. Packing Info =
++= 7. Packing Info =
  (((
++
++
  **PG1302 Package Includes**:
  )))
  (((
++(((
  * PG1302 x 1
  * LoRa Antenna x 1
  )))
++)))
--
--
  (((
++
++
  **PG1302-PI Package Includes**:
  )))
@@ -761,13 +761,23 @@
  * Device Size: 18 x 8 x 4 cm
  * Weight: 150g
--= 10. Support =
++(((
++= 8. Support =
++
  (((
--If you are experiencing issues and can't solve, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].
++If you are experiencing issues and can't solve, you can send mail to
  )))
  (((
++[[support@dragino.com>>mailto:support@dragino.com]]
++)))
++
++(((
  With your question as detail as possible. We will reply and help you in the shortest.
++
++
++
  )))
++)))

image-20230329164417-5.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-46.4 KB

Content

image-20230329164704-6.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-16.6 KB

Content

image-20230329165619-7.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-106.9 KB

Content

image-20230329195416-8.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-9.3 KB

Content

image-20230329195442-9.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-9.9 KB

Content

image-20230329195650-10.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-27.7 KB

Content

image-20230329201624-11.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-20.1 KB

Content

image-20230518091900-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Kilight

Size

...	...	@@ -1,1 +1,0 @@
1		-6.8 KB

Content

image-20230518092732-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Kilight

Size

...	...	@@ -1,1 +1,0 @@
1		-35.1 KB

Content

image-20231115174839-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-80.3 KB

Content

image-20231115180410-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-78.7 KB

Content

image-20240118160132-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-37.2 KB

Content

image-20240118160407-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-7.9 KB

Content

image-20240118160454-3.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-42.0 KB

Content

image-20240118160928-4.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-83.8 KB

Content

image-20240118161109-5.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-178.1 KB

Content

image-20240118161333-6.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-120.0 KB

Content

image-20240118162033-7.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoye

Size

...	...	@@ -1,1 +1,0 @@
1		-724.0 KB

Content

image-20240122140551-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoling

Size

...	...	@@ -1,1 +1,0 @@
1		-334.9 KB

Content

Changes for page PG1302 -- LoRaWAN Concentrator User Manual

Summary

Details

Applications

Navigation