Changes for page PG1302 -- LoRaWAN Concentrator User Manual

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

From version < 116.1 >

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

To version < 145.1 >

edited by Xiaoye
on 2024/02/26 15:48

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 19 added, 0 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: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.
++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.
  )))
  (((
@@ -28,7 +28,7 @@
  )))
  (((
--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.
++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.
  )))
@@ -42,7 +42,6 @@
  * Mini-PCIe Interface
  * Converter board to support Raspberry Pi
--
  == 1.3 General Interfaces for PG1302 ==
@@ -51,11 +51,10 @@
  * 1 x I-PEX for LoRa
  * Working Temperature: -40 ℃ ~~ 80℃
--
  == 1.4 Pin Mapping ==
--     [[image:1651743282627-547.png||height="402" width="425"]]
++[[image:image-20240122140551-1.png]]
  == 1.5 LEDs ==
@@ -63,7 +63,7 @@
  (((
  TX: Blink when transmit a packet
--RX: Blink when receive a packet
++RX: Blink when receiving a packet
  Config: Always ON
  )))
@@ -76,9 +76,22 @@
  Detail Test Report see [[this link>>https://www.dropbox.com/sh/89virm4y0b02c7i/AAA-cgQEsSc8gNGFYAB0qZ_Za?dl=0]]
--== 1.7 Applications ==
++== 1.7 Antenna Installation ==
++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
@@ -87,6 +87,7 @@
  * Smart Factory
++
  = 2. Example: Set up as LoRaWAN gateway =
  == 2.1 System structure ==
@@ -106,7 +106,7 @@
  (% style="color:red" %)**Important Notice: Please power the RPI with 5V,3A cable.**
--[[image:image-20220621104746-1.png||height="381" width="451"]]
++[[image:image-20220621104746-1.png||height="351" width="415"]]
  = 3. Install the software? =
@@ -125,7 +125,6 @@
  * 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 ==
@@ -262,7 +262,6 @@
  Show system log.
--
  [[image:1651745003470-264.png||height="477" width="621"]]
@@ -271,7 +271,6 @@
  **Record the system log.**
--
  [[image:1651745069814-662.png||height="144" width="621"]]
@@ -312,7 +312,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"
@@ -321,18 +321,31 @@
          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 ==
--== 5.2 Get Gateway ID in Raspberry and input this in TTN v3 ==
++The Dragino LoRa Packet Forware supports the Semtech UDP and Basic Station mode.
++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" %)
@@ -347,6 +347,10 @@
  (((
  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** ====
++
  )))
  )))
@@ -356,18 +356,20 @@
  [[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:
--a)  SPI needs to be enabled on the Raspberry Pi
++**the below example is using Raspberry 4B.**
++
  Run  (% style="background-color:yellow" %) **sudo raspi-config**(%%) to open the config window
  [[image:1651745476754-240.png||height="234" width="629"]]
@@ -380,35 +380,38 @@
--In RPI, Fist: Enter the root account:
++==== **e). Access 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.
--=== 5.2.3 Config Gateway ID, Frequency Band and Server address ===
++/etc/lora/
++├── cfg-302                   ~-~--> global configuration file
++├── devskey                  ~-~--> Database
++├── global_conf.json     ~-~--> Frequency plan for current applications
++└── local_conf.json        ~-~--> Local fwd configuration
++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.**
--)))
--(((
--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.
++===== **1.) Configure gateway EUI and server address, port for fwd** =====
  )))
@@ -416,24 +416,30 @@
  [[image:1651745709709-887.png||height="820" width="621"]]
--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]]
++**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]]**
--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 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(%%).**
++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(%%).**
--**~     1). Chose your need the name of region frequency.**
++**//eg: cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json //**
--[[image:1651745867516-322.png||height="83" width="740"]]
++====== **Selecting the appropriate frequency plan for your region in cfg-302.** ======
++[[image:1651745867516-322.png||height="83" width="740"]]
--**~  2). Use this command to copy it.**
++====== **Override the global_conf.json** ======
++
  (% class="box infomessage" %)
  (((
  **cp /etc/lora/cfg-302/EU-global_conf.json /etc/lora/global_conf.json**
@@ -442,29 +442,20 @@
  [[image:1651745984006-868.png||height="87" width="745"]]
--* If user wants to change to other LoRaWAN server, modify the (% style="color:#0000ff" %)**global_conf.json**(%%) file.
++==== (% style="color:inherit; font-family:inherit; font-size:23px" %)**g). Running the Fwd Server**(%%) ====
--=== 5.2.4 Check result ===
--
--
  (((
--Run below command to restart the dragino_fwd:
++Run the 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:
  )))
@@ -479,15 +479,13 @@
  [[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"]]
--We can check dragino_fwd running states in RPi by running:
++Get the draginofwd real-time running log:
  (% class="box infomessage" %)
  (((
@@ -503,9 +503,8 @@
  [[image:1651746139304-966.png||height="326" width="621"]]
--=== 5.2.5 Commands to handle service ===
++==== **h). 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
@@ -512,10 +512,195 @@
  * (% 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:(%%)**
@@ -524,25 +524,21 @@
  * (% 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**:
  )))
@@ -556,23 +556,13 @@
  * 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
++If you are experiencing issues and can't solve, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].
  )))
  (((
--[[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,0 +1,1 @@
	1	+XWiki.Xiaoye

Size

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

Content

image-20230329164704-6.png

Author

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

Size

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

Content

image-20230329165619-7.png

Author

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

Size

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

Content

image-20230329195416-8.png

Author

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

Size

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

Content

image-20230329195442-9.png

Author

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

Size

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

Content

image-20230329195650-10.png

Author

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

Size

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

Content

image-20230329201624-11.png

Author

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

Size

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

Content

image-20230518091900-1.png

Author

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

Size

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

Content

image-20230518092732-2.png

Author

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

Size

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

Content

image-20231115174839-1.png

Author

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

Size

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

Content

image-20231115180410-2.png

Author

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

Size

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

Content

image-20240118160132-1.png

Author

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

Size

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

Content

image-20240118160407-2.png

Author

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

Size

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

Content

image-20240118160454-3.png

Author

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

Size

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

Content

image-20240118160928-4.png

Author

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

Size

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

Content

image-20240118161109-5.png

Author

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

Size

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

Content

image-20240118161333-6.png

Author

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

Size

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

Content

image-20240118162033-7.png

Author

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

Size

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

Content

image-20240122140551-1.png

Author

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

Size

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

Content

Changes for page PG1302 -- LoRaWAN Concentrator User Manual

Summary

Details

Applications

Navigation