本文檔詳述了網關Web 管理平臺UI界面的各項配置及管理功能， 例如：WAN接口配置、LoRa? Packet Forwarder、網關MQTT橋接、系統監控，固件更新、重啟設備等。

您可以從這里了解使用網關內置LoRa?服務器的相關信息。Web管理平臺基于OpenWRT，適用于RAK72XX系列網關產品。

說明

本文假定您已經完成的快速入門指南中的相關操作。例如：網關上電、登錄網關、連接網關到網絡。

• 登錄Web管理平臺
• Status - 狀態
• Network - 網絡
• Channel Plan - 頻譜設置
• LoRa? Network - 網絡服務器
• Services - 服務
• System - 系統

#登錄Web管理平臺

網關產品支持Wi-Fi AP模式、WAN接口DHCP IP地址、WAN接口直接登錄三種方式登錄到網關Web管理平臺。

Wi-Fi AP模式

1、網關默認工作在AP（Wireless Access Point，無線接入點）模式，即網關作為無線局域網的中心節點，可以使用裝有無線網卡的PC連接到網關。

操作步驟

在PC的Wi-Fi列表中查找類似"RAK72XX_XXXX"的SSID名稱（Service Set Identifier，服務集標識）并連接。

說明:

• RAK72XX_XXXX：“RAK72XX”為網關設備的型號，例如：RAK7258。后四位“XXXX”為網關MAC地址的后四位。
• 連接網關的熱點無需密碼。

2、在瀏覽器地址欄中輸入192.168.230.1，并按"Enter"。

3、在打開的登錄頁面中輸入用戶名及密碼后，單擊"Login"，即可登錄到Web管理平臺。

用戶名：root

密碼：root

說明:

• 建議使用Chrome瀏覽器。
• 如果后續需要修改密碼，請參考Administraton - 管理權。

Figure 1: 網關登錄界面

#WAN接口DHCP IP地址

將網關連接到路由器，使用路由DHCP給網關分配的IP地址登錄網關Web管理平臺。

操作步驟

1、將網關與路由器相連。

• 使用PoE電源適配器

a. 以太網線一端插入網關“ETH”接口，另一端插入PoE電源適配器的“PoE”接口。

b.將PoE電源適配器的"LAN"接口連接到路由器。

說明：

RAK7249隨箱標配PoE電源適配器。

• 不使用PoE電源適配器

以太網線一端插入網關 “ETH”接口，另一端插入路由器。

2、登錄路由器查詢DHCP給網關設備分配的IP地址。

3、在瀏覽器地址欄中輸入路由器的DHCP給網關設備分配的IP地址，并按"Enter"。

4、在打開的登錄頁面中輸入用戶名及密碼后，單擊"Login"，即可登錄到Web管理平臺。

• 用戶名：root
• 密碼：root

#WAN接口直接登錄

將網關直接用以太網線連接到PC，設置PC與網關默認IP地址為同一網段，使用網關默認IP地址登錄網關Web管理平臺。

操作步驟

1、將網關與PC相連。

• 使用PoE電源適配器

a. 以太網線一端插入網關“ETH”接口，另一端插入PoE電源適配器的“PoE”接口。

b. 將PoE電源適配器的"LAN"接口連接到PC。

• 不使用PoE電源適配器

a.以太網線一端插入網關 “ETH”接口，另一端插入PC。

2、準備網關IP地址

網關的IP地址默認為169.254.X.X。"X.X"可通過網關標簽上的MAC地址后四位獲取。

例如：MAC地址后四位為：0F:01，則網關的IP地址為169.254.15.1，即將16進制的MAC地址轉換為10進制。

3、修改PC的IP地址與網關為同一網段。

例如網關IP地址為169.254.15.1，則修改PC的IP地址為"169.254.15.100"

4、在瀏覽器地址欄中輸入上一步中查詢到的IP地址，并按"Enter"。

5、在打開的登錄頁面中輸入用戶名及密碼后，單擊"Login"，即可登錄到Web管理平臺。

• 用戶名：root
• 密碼：root

#Status - 狀態

通過Status頁面可實時監控網關、內置NS（LoRaWAN? Network Server，LoRaWAN? 網絡服務器）、系統內存等各項統計信息，例如：網關收發的報文總數、內置NS上添加節點、當前可用內存等。

#Overview - 概覽

登錄網關Web管理平臺后的概覽頁面如下圖所示，各項圖表數據釋義見圖下。

Figure 2: Overview

數據釋義：

• Received：網關接收到的LoRa?報文總數。
• Transmitted: 網關發送的LoRa?報文總數。
• Active Nodes：網關覆蓋范圍內活躍的LoRa?節點數（10分鐘內發送過報文的節點） 。
• Busy Nodes：網關覆蓋范圍內繁忙的節點數（發送報文平均間隔小于60s的節點）。
• Duty Cycle of the LoRa Channel：12小時內所有信道的“占空比”隨時間變化的熱力圖。
  • 縱軸：時間，最小間隔為60s。
  • 橫軸：信道頻率。每個數值代表了該信道在60s內的占空比平均值（取值范圍0%~100%），綠色代表低占空比，紅色代表高占空比。
• RSSI & SNR：RSSI/SNR值在指定范圍內的數量。
• Uplink Traffic：上行2小時內各SF（Spreading Factor，擴頻因子）的報文收發速率（packet/min）。
  • 縱軸：報文收發速率，單位為packet/min，六種顏色分別代表6個SF，總的高度代表所有報文收發速率之和。
  • 橫軸：時間。
• Downlink Traffic：下行2小時內各SF（Spreading Factor，擴頻因子）的LoRa?報文收發速率（packet/min）。
  • 縱軸：報文收發速率，單位為packet/min，六種顏色分別代表6個SF，總的高度代表所有報文收發速率之和。
  • 橫軸：時間。
• System：系統相關信息，包括網關的主機名、型號、固件版本、網關的本地時間、已運行時間等。
• Memory：當前可用內存、空閑內存及緩存。
• LoRa Network Server：內置NS的各項統計數據，包括添加的節點數、上行鏈路流量、下行鏈路流量、接收的入網請求數、拒絕的入網請求數等。
• Network：網絡狀態、類型及地址等信息。
• Cellular：蜂窩網絡的連接狀態，網絡ID以及SIM卡的參數（ICCID、IMEI、IMSI、Phone Number）。
• Wireless：AP（Wireless Access Point，無線接入點）模式及客戶端模式的連接狀態、信號強度及IP地址信息。
• Dynamic DNS：當前的DNS配置信息。如果沒有配置，這里將顯示示例數據。

#LoRaWAN? Packet Logger - LoRa?報文記錄器

LoRaWAN? Packet Logger 實時記錄和解析了LoRa?網關收發的報文數據。報文數據列表下方還展示了節點的連接時間和每個頻段的負荷。

• 篩選需要的報文

可通過以下選項過濾報文：

· Type：根據報文類型過濾。選擇“ALL”為不過濾，展示所有報文。

· DevAddr：根據節點地址過濾報文。

· Hide CRC_ERR packet：選中后將不展示CRC校驗錯誤的報文。

• 查看報文詳情

可通過以下選項過濾報文：

單擊頁面中的某行報文數據，會在當前報文數據下方出現此數據的詳細元數據以及RF參數信息。

• 暫停/開始/清空報文記錄

Pause/Play：將會暫停/開始報文的記錄。

Clear：將會清空報文的記錄。

• 下載當前報文到本地

Download：可將當前的報文記錄以CSV格式保存到本地。

Figure 3: LoRa Packet Logger

#System Log - 系統日志

此頁面展示了網關的日志信息，在需要調試網關的時候可以參考。

可以單擊右上角的“AUTO REFRESH ON”或者“AUTO REFRESH OFF”選擇開啟或關閉自動刷新。

Figure 4: System Log

#Firewall - 防火墻

此頁面以表格形式展示了端口、地址等的流量信息。如果需要配置防火墻的更多信息，可以到瑞科慧聯“Network > Firewall”頁面進行配置。

• Reset Counters：是否重置計數器。
• Restart Firewall：重啟防火墻。

Figure 5: Firewall

#Network - 網絡

#Ethernet Port - 以太網端口

用戶可在本頁面選擇網關以太網的端口類型：WAN或LAN。

Figure 6: Ethernet Port

#WAN Interface - WAN接口

用戶可在本頁面觀察網關WAN接口的運行狀態，或修改WAN接口的接口協議。

說明：為保持互聯網通信的穩定性，建議通過WAN接口使用以太網線連接路由器接入互聯網。

Figure 7: WAN Interface

參數說明：

• Status：WAN接口的運行狀態，包括已運行時間、MAC地址、IP地址等信息。
• Protocol：WAN接口支持DHCP、PPPoE、靜態IP 三種協議。默認是DHCP，如果選擇“None”，WAN接口將被關閉。
• Use DNS servers advertised by peer：是否使用DNS服務器，打開后需輸入DNS服務器地址。
• Use gateway metric：設置WAN接口的連接優先級。數值越大代表優先級越低。
• Override MTU：是否重寫MTU，默認為1500。

#Cellular Interface - 蜂窩網絡

如果設備支持LTE功能，開啟LTE蜂窩網絡后，需根據網絡運營商提供的信息正確填寫APN/User/Password/PIN Code（PIN Code將在SIM卡被鎖定時使用）。

建議在“Use gateway metric”中將Cellular Interface設置為最低優先級（即值最大）以節省流量費用。

Figure 8: Cellular Interface

#Wi-Fi

Wi-Fi網絡支持兩種工作模式：無線接入點（Wireless Access Point）和無線客戶端（Wireless Client）。

Figure 9: Wi-Fi

參數說明：

• Radio
• Wireless network is enabled：單擊 “Disable”/“Enable”按鈕關閉或開啟Wi-Fi網絡。
• Channel：可以手動選擇要開啟或者讓系統自動配置。
• Mode：配置當前Wi-Fi網絡的工作模式，可選擇同時工作在無線接入點模式和無線客戶端模式，或者僅工作在單一模式下。

Wireless Access Point

通過無線接入點用戶可使用Wi-Fi終端（手機/PC等）連接到網關設備。

ESSID/Encryption：網關設備無線接入點的ESSID及加密方式。默認ESSID為 RAK7258_XXXX(XXX為MAC地址后四位)，無加密。通過Wi-Fi訪問網關設備時，IP地址為192.168.230.1。

Hidden：打開“Hidden”按鈕將不再廣播Wi-Fi無線信號。

Wireless Client：

通過無線客戶端接口，網關可作為無線客戶端連接到Wi-Fi網絡中。此時Wi-Fi接口可作為網關的上行網絡接口。

• ESSID：要接入的Wi-Fi網絡的ESSID，可手動填寫或單擊"Scan"按鈕掃描周圍的Wi-Fi網絡。
• Encryption：要接入的Wi-Fi網絡的加密方式。如果使用"Scan"掃描并選擇Wi-Fi網絡，系統會根據掃描到的網絡自動填寫。否則，請手動選擇Wi-Fi網絡加密方式。
• Key：要接入的Wi-Fi網絡的密碼。

#Diagnostics - 網絡診斷

使用網關內置的網絡診斷工具 Ping/Traceroute/Nslookup，即可對網關的網絡連接進行診斷。

在診斷工具對應的文本框內輸入URL或者IP地址，從下拉框選擇網絡協議類型（IPv4或者IPv6），單擊相應診斷工具下的按鈕，診斷結果將自動顯示在頁面下方。

Figure 10: Diagnostics

#Firewall - 防火墻

此頁面可以配置防火墻區域（Zone） 、端口轉發（Port Forwards）和數據規則（Traffic Rules）。還可以自定義規則執行arbritary iptables命令，命令將在每次防火墻重新啟動加載默認規則集之后執行。

Figure 11: Firewall

#Ping Watchdog - 看門狗

Ping Watchdog 通過不斷在指定的上行網絡接口上ping指定的IP地址或域名，對網絡鏈路的通信質量進行監控。當發現網絡鏈路存在故障時，自動采取預定的措施，如重新啟動接口、降低此上行網絡接口的優先級、重啟設備等。

接口定義：

• WAN接口：代表以太網上行鏈路接口。
• WWAN接口：代表LTE蜂窩網絡上行鏈路接口。

說明：

• 只有在LoRa網關同時使用了以太網上行鏈路和LTE 蜂窩網絡上行鏈路時，降低某一個上行網絡接口優先級的操作才會起作用。
• 鏈路的優先級由各自的網絡接口的默認網關躍點數決定?？煞謩e在 "Network ->WAN Interface"和"Network-> Cellular Interface"中設置各自的默認網關躍點數（Use gateway metric）。網關躍點數越低，鏈路的優先級越高。

設置示例：

設置以太網上行鏈路和LTE蜂窩網絡上行鏈路互為備份，即其中一條鏈路發生故障時自動切換到另一條鏈路。

1、分別單擊WAN接口及WWAN后的"Edit"按鈕，配置以下信息。

2、設置"Enabled"為"Yes"，打開看門狗。

3、設置"Action"為"Increase Gateway Metric"，設置網絡鏈路發生故障時的動作。

Figure 12: Ping Watchdog Interface Overview

Figure 13: Ping Watchdog Interface Configuration

參數說明：

• Enable：是否在當前網絡接口中開啟Ping Watchdog。
• Track IPs：跟蹤IP地址。跟蹤IP地址將被持續進行ping探測，以判斷網絡接口的連接狀態。
• Tracking reliability：跟蹤的IP地址中，ping探測成功的個數超過該值時，網絡接口的連接狀態提示為連接正常，否則將提示為連接故障。
• Ping Count：每組ping探測的ping 報文個數。
• Ping Timeout：ping探測響應超時時間。
• Ping Interval：ping探測間隔時間。
• Interface down：ping探測連續提示接口連接故障的次數超過該值時，該接口將被標識為離線狀態。
• Interface up： ping探測連續提示接口連接正常的次數超過該值時，該接口將被標識為連通狀態。
• Action：接口被標識為離線狀態后的動作。支持三種動作：
  • Increase Gateway Metric ：增加該接口的網關躍點數，即降低該接口的優先級。選擇此動作，需要填寫此接口離線后的網關躍點數（Offline metric）。
  • Reconnect Interface：嘗試重新連接。
  • Reboot Device：網關重新啟動。
• Offline metric：接口離線后的網關躍點數。

#Channel Plan -頻譜設置

#Standard Frequency Setup Mode - 標準頻譜設置

Packet Forwarder的頻譜設置模式默認為標準模式，如果當前配置模式為自定義模式（Advanced Mode）,可單擊按鈕“Switch to Standard Mode”切換到標準模式。

Figure 14: Channel Plan – Standard Mode

標準配置模式下，用戶只需要填寫頻譜計劃中的各個信道的頻率即可。其它參數（如發射頻率范圍等）將根據LoRaWAN? 協議的規定自動設置完成。

參數解釋如下，配置完成后單擊“Save & Apply”保存配置。

Region: LoRaWAN? 網絡的工作區域，即工作頻段，LoRaWAN? 協議中規定的Regional Parameter Common name (Channel Plan)。系統會根據網關硬件自動識別可使用的頻段。

LoRaWAN Public：打開表示其它開發者可以查看該網關，并可通過這個網關進行 LoRa? 節點接入。關閉表示則僅用戶自己能查看該網關。

Frequency-Sub Band：添加可用信道。

Multi-SF LoRa Channel：“Frequency-Sub Band”設置為“Custom”時可配置。是指速率為SF7-SF12，帶寬為125K的LoRa信道。此類信道最多可以設置8個（16信道設備最多可以設置16個）。

新增Multi-SF LoRa Channel：在輸入框中填寫需要添加的信道頻率（單位為MHz），單擊“Add”按鈕，新的信道頻率就會出現在 Multi-SF LoRa Channel列表中。

說明：

新增的頻譜必須符合當前區域（Region）的LoRaWAN? Regional Parameter協議規定。且Multi-SF LoRa Channel列表中的最高頻率和最低頻率之差不可以超過1.6MHz。

刪除Multi-SF LoRa Channel：將鼠標放置在Multi-SF LoRa Channel上，單擊該信道上自動出現的紅色叉號，即可刪除此信道。特定工作區域（EU868/IN865/AS923/KR920）中，LoRaWAN 協議規定的默認信道不可以刪除。

Standard LoRa Channel：指帶寬為250KHz/500KHz的單一速率信道。信道的帶寬和速率會根據工作區域（Region）自動選擇。

新增Standard LoRa Channel：在輸入框輸入Standard LoRa Channel頻率，單擊輸入框后面的“Add”按鈕，即可將該信道添加到Standard LoRa Channel 列表中。最多可以設置一個Standard LoRa Channel（16信道可以設置兩個Standard LoRa Channel）。

說明：

特定的工作區域（Region）不支持Standard LoRa Channel設置。

FSK Channel：FSK的速率會根據所選工作區域（Region）自動選擇。

新增FSK信道時，在輸入框中輸入要增加的FSK信道頻率，單擊輸入框后面的”Add“按鈕，即可將該FSK信道添加到FSK信道列表中。最多可以設置1個FSK信道（16信道網關可以設置2個FSK信道）。

說明：

特定的工作區域（Region）不支持FSK Channel設置。

#Advanced Frequency Setup Mode - 自定義頻譜設置

如果當前配置模式為標準模式，可單擊按鈕“Switch to Advanced Mode”切換到自定義模式。

Figure 15: Channel Plan – Advanced Mode

相關概念：

• LoRa Concentrator：LoRa?網關的基本單元，網關在實際的應用中會根據實際的使用場景選擇一個或者多個LoRa Concentrator，常見的是1個或者2個。每個LoRa Concentrator可以同時監聽8個多速率LoRa 信道（MultiSF Channel,DR0~DR5）,1個標準LoRa信道（LoRa Standard Channel）和 1個 FSK信道，共計10個信道。
• Radio：LoRa? Concentrator包含2個Radio單元，分別為Radio 0 和Raido 1。Radio0可用于接收和發送射頻信號，Radio1僅用于接收射頻信號。每個Radio最多可以監聽5個信道（包括MultiSF channel，LoRa Std channel, FSK channel）。用戶可根據實際需求將信道分配到兩個Radio單元。

參數解釋如下，配置完成后單擊“Save & Apply”保存配置。

Radio 參數設置：

參數	說明
Radio 0 Center Frequency	LoRa Concentrator Radio 0接收中心頻率。
Radio 1 Center Frequency	LoRa Concentrator Radio 1接收中心頻率。
Minimum Tx Frequency	LoRa Concentrator的最低發射頻率。
Maximum Tx Frequency	LoRa Concentrator 的最高發射頻率。

說明：

16信道的網關 LoRa Concentrator 1發射頻率范圍需與 LoRa Concentrator 0的發射頻率范圍保持一致，且不允許修改。

· 信道參數設置

信道設置界面采用表格形式。表格的每一列代表一個信道。每個LoRa Concentrator支持8個多速率信道（MultiSF），一個標準LoRa信道（ LoRa std ）和一個 FSK信道。通過設置Radio0 或者1 的中心頻點，之后選擇對應的頻率偏移量，即可選定某一個頻率值 Freq. 。

參數	說明
Chan. ID	LoRa Concentrator的信道ID。
Enable	使能或者禁用信道。
Radio	LoRa Concentrator的Radio0或者Radio1。
If	相對于Radio0或者Radio1中心頻率的偏移量。該參數和其所在Radio的中心頻率共同決定了決定了當前信道的頻率。
Freq.	當前信道的中心頻率，由Raido和If參數設定。
Bandwidth	信道帶寬。MultiSF LoRa信道為固定值 125KHz，不可修改。LoRa Std channel和 FSK channel由用戶自行設定。
Datarate	信道速率。MultiSF LoRa信道為多速率信道，同時監聽SF7~SF12 速率，不可修改。LoRa Std 信道和FSK信道由用戶自行設定。

信道設置示例：

此處以某個470頻段的頻譜規劃為例，如下所示：

Uplink:

1、486.3- SF7BW125 to SF12BW125

2、486.5- SF7BW125 to SF12BW125

3、486.7- SF7BW125 to SF12BW125

4、486.9- SF7BW125 to SF12BW125

5、487.1- SF7BW125 to SF12BW125

6、487.3- SF7BW125 to SF12BW125

7、487.5- SF7BW125 to SF12BW125

8、487.7- SF7BW125 to SF12BW125

Downlink:

1、506.7- SF7BW125 to SF12BW125

2、506.9- SF7BW125 to SF12BW125

3、507.1- SF7BW125 to SF12BW125

4、507.3- SF7BW125 to SF12BW125

5、507.5- SF7BW125 to SF12BW125

6、507.7- SF7BW125 to SF12BW125

7、507.9- SF7BW125 to SF12BW125

8、508.1- SF7BW125 to SF12BW125

9、505.3- SF12BW125 (RX2 downlink only)

#LoRa Network - 網絡服務器

Network Settings

LoRa? 網絡服務器的相關配置，需要根據選擇的網絡服務器工作模式，配置相應的信息。

· LoRaWAN Network Setting

Figure 16: LoRaWAN Network Settings

· Gateway EUI：網關的Gateway EUI。

· Mode：LoRa? 網絡服務器的工作模式，支持Packet Forwarder、Basic Station、Network Server三種網絡模式。

· Log Level：日志的等級。通過使用日志級別，可以控制應用程序中相應級別日志信息的輸出。如果將Log Level設置在某一個級別上，那么將打印出等于或高于此優先級別的日志信息。優先級別從高到低如下所示：

ERROR：錯誤信息，可能仍然允許應用程序繼續運行
WARNING：可能影響系統功能，需要提醒用戶的重要事件
NOTICE：不影響正常功能，需要注意的消息
INFO：一般用在粗粒度級別上，強調應用程序的運行全程
DEBUG：一般用于細粒度級別上，應用程序調試信息

· Network Server Setting

根據在"Mode"中選擇的網絡服務器工作模式，需要配置不同的信息，單擊以下折疊可查看需要配置服務器信息。

• “Mode”選擇為“Network Server”“Mode”選擇為“Basic Station”“Mode”選擇為“Packet Forwarder”

說明：

• 當LoRaWAN Network Setting中的“Mode”選擇為“Packet Forwarder”或“Basics Station“時，僅需配置”Network Settings“中的配置項。
• 當LoRaWAN Network Setting中的“Mode”選擇為"Network Server”時，才會顯示“Network Server Status”服務器狀態查看和“Gateway”、"Application"、“Global Integration”、“Multicast Group”配置選項。

#Network Server Status - 服務器狀態

以圖表形式展現了內置服務器當前各項運行狀態，圖下附各狀態釋義。

Figure 26: Network Server Status

1. Basic Information

• Uptime: 服務器已運行的時間
• Devices: 當前服務器連接的節點設備總數
• Gateways: 當前服務器連接的網關設備總數
• Total Uplink: 上行流量總數
• Total Downlink: 下行流量總數
• Data Downlink: 下行數據統計
• Total OTAA Requests: 節點OTAA連接成功總數
• Rejected OTAA Request: 節點 OTAA連接失敗總數

2. RSSI Distribution: 根據RSSI級別（增量為20dBM，從-120dBM到-40dBM）對接收到的數據包進行統計

3. SNR Distribution: 根據SNR級別（增量為5dB增量，從-15dB到5dB）對接收到的數據包進行統計

4. DataRate Distribution: 根據數據傳輸速率級別對接收到的數據包進行統計

5. Traffic History: 流量隨時間變化的統計圖，有助于您評估網絡繁忙時段以便采取相應措施

#Gateway - 網關

在此頁面可添加其它LoRa網關，其它的LoRa網關可以通過LoRa Gateway MQTT Bridge連接到內置服務器。

說明：您不需要在這里添加當前網關，內置服務器默認已添加了當前網關，即使它沒有在網關列表里展示。

Figure 27: Gateway Settings

#Gateway

在輸入框中輸入Gateway EUI后，單擊“Add”即可將網關添加到內置服務器。

#Gateway Backend Configuration

· General Setup

設置用于連接其它網關的MQTT客戶端。相關參數如下：

MQTT Broker Address：MQTT服務器的IP地址或域名

MQTT Broker Port：MQTT服務器的端口號

MQTT Protocol Version: MQTT協議版本，支持MQTT V3.1 和MQTT V3.1.1

Client ID：客戶端ID

Clean Session：連接時是否打開全新的會話

Will Retain: 打開后最后一條信息將會被保留

QoS：設置服務質量的級別

Keepalive: 發送心跳包的時間間隔，定期通過網關發送數據，以確保服務器識別到網關處于聯機狀態。

Enable User Authentication：是否開啟了用戶驗證。如果開啟，需要填寫 Username 和 Password

SSL/TLS Mode：SSL/TLS模式設置。支持四種模式：

• Disable：禁用SSL/TLS
• CA Signed server certificate：由CA機構簽名的服務器認證
• Self-signed server certificate：自簽名的服務器認證自簽名服務器認證需要填寫PEM格式的自簽名CA證書
• Self-signed server & client certificate：自簽名的服務器&客戶端雙向認證。自簽名的雙向認證需要填寫PEM格式的自簽名CA證書（CA Certificate），客戶端證書（Client Certificate）和客戶端密鑰（Client Key）。 如果客戶端密鑰文件是加密的，需要填寫客戶端密鑰密碼（Client Key Passphrase）

· MQTT Topic

MQTT Topic模板信息：Downlink MQTT Topic, Downlink acknowledge MQTT Topic, Gateway Statistic MQTT Topic。

Figure 28: Gateway Settings

#Application - 應用

Application是LoRa Network Server中的管理LoRa節點的基本單元，您需要把節點添加到內置服務器的應用中。

在“Please input application name”輸入框中輸入應用名稱，選擇設備認證模式（Type1 Unified Application Key或Type2 Separate Application Key）后，單擊"Add"，您將需要配置下圖三個頁簽的信息，后面章節將分別詳述。

• Unified Application Key：同一Application中，所有節點設備使用相同的Application Key。不需要單獨為設備設置Application Key。支持通過OTAA自動添加設備。
• Separate Application Key：允許在同一個Application中節點設備使用不同的Application Key。需要為每個設備設置一個單獨的Application Key。不支持通過OTAA自動添加設備。

Figure 13: Application

#Application Configuration

Figure 30: Application Configuration

參數說明

· Device Authentication Mode: 創建應用時您選擇的認證模式（Type1 Unified Application Key或Type2 Separate Application Key）。創建之后將不可更改。

· Name: 輸入應用的名稱。

· Auto Add LoRa Device：是否開啟自動添加設備。開啟后，如果設備的Application Key與Application EUI通過身份驗證，設備將被自動添加到服務器上。

· Application EUI：標識唯一的應用提供者，選擇開啟自動添加設備后需要填寫。需與節點設備三元組信息中的“AppEUI”保持一致。支持手動輸入和系統自動生成單擊可自動生成）。您可以使用串口工具連接節點通過at+set_config=lora:apps_eui:xxx(xxx為系統自動生成的Application EUI)或at+get_config=lora:status命令設置或查詢節點的AppEUI。

· Application Key：節點OTAA激活的密鑰，與節點設備三元組信息中的“AppKey”保持一致。支持手動輸入和系統自動生成（單擊可自動生成）。您可以使用串口工具連接節點通過at+set_config=lora:apps_key:xxx(xxx為系統自動生成的Application Key)或at+get_config=lora:status命令設置或查詢節點的AppKey。

· Description：可選字段，應用描述信息，用戶自定義。

# Payload Format

設置Payload Formats后該應用下節點的報文將按照預定規則解析，并生成名稱為data_object的json數據，添加到原始報文中。

Figure 31: Application Payload Format

參數說明：

Payload Format:

· None : 無，不進行Payload數據解析

· CayenneLPP : 按照 CayenneLPP 協議解析

Only forward the parsed data object: 打開此選項后，原始數據將被丟棄，僅轉發解析后的data_object

#Integrations

第三方服務器集成選項，通過修改應用下的第三方服務器集成選項，可以修改此應用下的節點的報文發往第三方服務器的格式?？梢栽O置HTTP/HTTPS轉發接口。

Figure 32: Integrations

參數說明：

· Data Encode/Decode Type: 數據Payload的編解碼方式。支持Base64 / HEX string兩種編碼，默認為Base64編碼。

· Report LoRa Radio Information: 發往第三方服務器的數據是否攜帶報文的射頻信息，如接收頻點/SNR/RSSI等。

· HTTP/HTTPS Integration： HTTP接口設置。

· HTTP/HTTPS Headers： 每個應用擁有一個獨立的HTTP客戶端，可以通過POST方式向HTTP服務器發送數據。HTTP客戶端支持多連接并發上報。可以增加自定義的HTTP Header附加信息，比如auth/token等信息。

· Uplink data URL : 上行數據的目的URL。

· Join notification URL: 節點激活成功通知的目的URL。

· ACK notification URL: 節點收到下行報文后上報的ACK通知的目的URL。

· Device-status notification URL: 節點的狀態信息上報的目的URL。

· Maximum number of concurrent connections: 最大并發連接數。

· Maximum length of queue: HTTP客戶端的最大緩存隊列長度。當等待發送的消息個數超過此閾值后，后續的產生消息將被丟棄。

#Devices - Lora節點

本節主要介紹如何在內置服務器上添加Lora節點。

單擊應用名稱后的"Edit"按鈕進入應用詳情頁面，在頁面“please input device EUI”輸入框中輸入節點設備的Device EUI，單擊"Add"按鈕后，您將開始配置節點設備參數。下面將詳細介紹節點設備配置參數。

說明

• Device EUI可通過串口工具連接節點執行at+get_config=lora:status命令查詢。
• 您也可以單擊“Batch Add”選擇批量添加或使用“Import”/"Export"進行導入導出。導入需使用的模板可通過“Export”獲取。

Figure 33: Add Device

#Configuration

Figure 34: Configuration

參數說明：

· Device name：節點名稱。

· Class：節點工作模式，支持Class A /Class B/Class C。

· Join mode：節點激活方式，支持OTAA 及ABP，RAK節點設備默認工作在 OTAA模式下。

如果您選擇OTAA激活方式，且Application類型為"Type1 Unified Application Key"，還需要配置以下參數：

· AppKey：默認為Application的Application Key。

· Device Address：節點地址

· Application Session Key：Application會話密鑰

· Network Session Key：Network會話密鑰

· Frame-counter Width: 報文序號計數器寬度，16bit或32bit。

· LoRaWAN MAC Version：節點的協議版本，V1.0.2或V1.0.3。

· LoRaWAN Regional Parameters Reversion：LoRaWAN區域參數。

· Enable LPTP：開啟LPTP協議。LPTP協議是RAK自定義的LoRa報文分片/重組協議，僅部分RAK節點產品（7421、7431和4203）支持。

· Description：節點描述信息

#Activation

節點設備的活動信息，如果您使用的是OTAA激活方式，此頁面信息會在設備經過身份認證入網后展現。如果您使用的的ABP模式，您手動配置完節點參數保存后此頁面信息即會展現。

Figure 35: Activation

參數說明：

· Device Address：節點地址

· Application Session Key：Application會話密鑰

· Network Session Key：Network會話密鑰

· Uplink frame counter：上行報文計數

· Downlink frame counter：下行報文計數

· Clear frame counter：重置報文計數

#Downlink

您可以在此頁面發送下行數據到節點設備。按頁面提示配置以下信息即可發送下行數據到節點設備。

Confirmed：是否需要確認（ACK）。

FPort：輸入下行數據端口號。

HEX Bytes：下行數據的16進制字符串編碼。

說明：

Class A模式下，需要節點設備發送上行數據后才能收到服務器發送的下行數據。

Figure 36: Downlink

#Live Device Data

您可以在此頁面實時查看節點發送的數據。單擊數據可展開查看數據詳情。

此頁面不會保存節點發送的數據，網頁刷新或關掉之后即會消失。

Figure 37: Live Device Data

#Overview

節點成功入網后，在此頁面可查看節點設備的各項統計信息。例如：RSSI、SNR等。

Figure 38: Overview

#Global Integration - 全局集成接口

LoRa Network Server提供了基于MQTT協議的API接口，用來連接到第三方服務器。通過API接口，LoRa Network Server可以將LoRa 節點的入網狀態，上行數據和節點狀態等信息發送到第三方服務器。也可接收來自第三方的下行數據，并通過LoRa網絡發送到對應的節點。

Figure 39: Global Integration

參數說明：

• Integration Mode：第三方服務器集成。Generic MQTT或 AWS IoT Core
• MQTT Broker Address：MQTT服務器的IP地址或域名
• MQTT Broker Port：MQTT服務器的端口號
• MQTT Protocol Version: MQTT協議版本，支持MQTT V3.1 和MQTT V3.1.1
• Client ID：客戶端ID
• Clean Session：連接時是否打開全新的會話
• Will Retain: 打開后最后一條信息將會被保留
• QoS：設置服務質量的級別
• **Keepalive:**發送心跳包的時間間隔，定期通過網關發送數據，以確保服務器識別到網關處于聯機狀態。
• Enable User Authentication：是否開啟了用戶驗證。如果開啟，需要填寫 Username 和 Password
• SSL/TLS Mode：SSL/TLS模式設置。支持四種模式：
  • Disable：禁用SSL/TLS
  • CA Signed server certificate：由CA機構簽名的服務器認證
  • Self-signed server certificate：自簽名的服務器認證自簽名服務器認證需要填寫PEM格式的自簽名CA證書
  • Self-signed server & client certificate：自簽名的服務器&客戶端雙向認證。自簽名的雙向認證需要填寫PEM格式的自簽名CA證書（CA Certificate），客戶端證書（Client Certificate）和客戶端密鑰（Client Key）。 如果客戶端密鑰文件是加密的，需要填寫客戶端密鑰密碼（Client Key Passphrase）
• TLS Version：TLS協議版本，支持TLSv1 / TLSv1.1 / TLSv1.2
• CA Certificate/Client Certificate/Client Key/Client Key Passphrase：根據選擇的"SSL/TLS Mode"進行設置
• AWS URL ：AWS服務器的IP地址或域名
• AWS Port：AWS服務器的I端口號
• CA Certificate：CA證書
• Vendor Certificate：供應商證書
• Vendor Key：供應商密鑰
• Join Topic：LoRa 節點發生OTAA入網請求時Topic定義
• uplink Topic：LoRa 節點發送上行報文時Topic定義
• Downlink Topic：LoRa Network Server 會訂閱 downlink topic，第三方應用服務器可向該topic發布消息，LoRa Network Server收到該消息后，向LoRa節點推送下行報文時Topic定義
• ack Topic：應用服務器推送的下行報文收到確認報文時Topic定義
• status： LoRa 節點狀態更新時（電池電量/Link margin等信息）
• Multicast Downlink Topic：LoRa Network Server 會訂閱 Multicast downlink topic，第三方應用服務器可向該topic發布消息，LoRa Network Server收到該消息后，向組播組推送下行報文時Topic定義

具體topic及消息payload定義如下：

事件類型	join Event published when a device joins the network.
topic	application/[applicationID]/device/[devEUI]/join
消息示例	{ "applicationID": "123", "applicationName": "temperature-sensor", "deviceName": "garden-sensor", "devAddr": "06682ea2", // assigned device address "devEUI": "0202020202020202" // device EUI }

事件類型	uplink Contains the data and meta-data for an uplink application payload.
topic	application/[applicationID]/device/[devEUI]/rx
消息示例	{ "applicationID": "123", "applicationName": "temperature-sensor", "deviceName": "garden-sensor", "devEUI": "0202020202020202", "rxInfo": [ { "gatewayID": "0303030303030303", //ID of the receiving gateway "name": "rooftop-gateway", // name of the receiving gateway "time": "2016-11-25T16:24:37.295915988Z", // time when the package was received (GPS time of gateway, only set when available) "rssi": -57, // signal strength (dBm) "loRaSNR": 10, // signal to noise ratio "location": { "latitude": 52.3740364, // latitude of the receiving gateway "longitude": 4.9144401, // longitude of the receiving gateway "altitude": 10.5, // altitude of the receiving gateway } } ], "txInfo": { "frequency": 868100000, // frequency used for transmission "dr": 5 // data-rate used for transmission }, "adr": false, // device ADR status "fCnt": 10, // frame-counter "fPort": 5, // FPort "data": "..." // base64 encoded payload (decrypted) }

事件類型	ack Event published on downlink frame acknowledgements.
topic	application/[applicationID]/device/[devEUI]/ack
消息示例	{ "applicationID": "123", "applicationName": "temperature-sensor", "deviceName": "garden-sensor", "devEUI": "0202020202020202", // device EUI "acknowledged": true, // whether the frame was acknowledged or not (e.g. timeout) "fCnt": 12 // downlink frame-counter }

事件類型	status Event for battery and margin status received from devices.
topic	application/[applicationID]/device/[devEUI]/status
消息示例	{ "applicationID": "123", "applicationName": "temperature-sensor", "deviceName": "garden-sensor", "devEUI": "0202020202020202", "battery": 200, "margin": 6, "externalPowerSource": false, "batteryLevelUnavailable": false, "batteryLevel": 75.5 }

事件類型	downlink Scheduling downlink data by application server
topic	application/[applicationID]/device/[devEUI]/tx
消息示例	{ "confirmed": true, // whether the payload must be sent as confirmed data down or not "fPort": 5, // FPort to use (must be > 0) "data": "...." // base64 encoded data (plaintext, will be encrypted by LoRa Server) }

說明：所有消息的均為json格式。上行和下行消息中的 data字段內容默認為 base64編碼格式。若LoRa節點所屬的Application的Integration中數據格式修改為Hexstring, 則該節點的上行報文的“data”編碼格式為Hexstring。并要求其下行報文的data編碼格式為Hexstring。

#Multicast Group - 組播

創建一個組播組進行組播內數據的傳播。

#Multicast Group List

在輸入框中輸入組播組名稱后，單擊“Add”即可將創建組播組。

Figure 40: Multicast Group

#Multicast Configuration

配置組播組相關參數。

Figure 41: Multicast Configuration

參數說明：

· Multicast-gruop Name：組播組的名稱。

· Multicast-gruop ID：組播組分組的ID號。

· Class：組播的Class類型，Class 范圍為B和C。

· Class-B ping-slot periodicity：范圍為1s，2s，4s，8s，16s，32s，64s和128s，這里可以根據需要選擇。

· Frequency：范圍為所選頻段的下行頻點范圍（例如US915頻段：范圍為923300000Hz到927500000Hz，間隔為600000Hz）。

· Datarate：所選頻段的速率（例如US915頻段：范圍為Dr8到Dr13）。

· Multicast Address：為8個Hex字符用于標識組播的唯一性。

· Multicast Network Session Key：用于組播傳輸數據的加解密和數據完整性校驗。

· Multicast Application Session Key：用于組播傳輸數據的加解密和數據完整性校驗。

說明：Multicast Network Session Key和Multicast Application Session Key建議點擊右側的隨機按鈕隨機生成。

· Description：對所創建的組播組進行說明。

#Services - 服務

#Dynamic DNS (Beta)

動態DNS可以使用一個有著動態IP地址的固定的主機名稱連接到網關。如果想了解更多動態DNS功能，您可以單擊頁面中的"Show more"。

Figure 42: Dynamic DNS

如果需要修改全局設置請單擊頁面中“To change global settings click here”。

如果只是需要修改IPv4和IPv6，需要定義兩條不同的配置。在此頁面輸入框中輸入配置名稱后單擊“Add”按鈕根據頁面提示配置相關參數后保存。

系統默認會生成一條IPv4的配置，可以單擊"Edit"按鈕修改相關配置信息。更多配置信息請參考DDNS/VPN Document。

#OpenVPN Tunnels

由于LoRaWAN 網絡中常用的報文轉發協議GWMP為基于UDP/IP協議的非加密傳輸協議，因此實際網絡部署中的通信鏈路的加密是非常重要的。

LoRaWAN網關在工程部署中，將分散在覆蓋區域的各個角落，使用各種不同的上行鏈路接入互聯網，如何對這些網關進行集中管理和維護也是LoRaWAN網絡部署的一大難題。

RAK 系列網關引用了開源的 Openvpn 協議，支持將 LoRaWAN 網關通過加密的Openvpn-tunnel接入到 OpenVPN 網絡中，同時解決了通信加密和網關維護管理問題。網關支持建立多個OpenVPN實例，建立加密連接隧道。

Figure 43: OpenVPN Tunnels Tab

OpenVPN配置

1、在 輸入欄中輸入OpenVPN實例名稱，選擇“Custom OpenVPN Configuration”，單擊“Add”。

2、在“Configuration”頁簽的輸入框中輸入OpenVPN 配置信息。如果配置信息中包含文件，如CA證書，客戶端證書等，請輸入不包含路徑的文件名。并在“Upload File”頁簽中上傳這些文件，注意上傳的文件名與配置信息中的文件名保持一致。

3、單擊“Save & Apply”保存并返回到OpenVPN Tunnels列表頁面。單擊Enable列的以打開新增OpenVPN。

#System - 系統

#System - 系統設置

Figure 44: System Tab

System Properties - 系統屬性

General Settings

Local Time：網關本地時間。點擊 “Sync with browser”按鈕可同步網關和當前主機的時間

Hostname：網關主機名

Timezone：網關時區

Figure 45: System - General Settings

Logging:

System log buffer size：系統日志緩沖區大?。▎挝籏byte）

External system log server：遠程日志服務器地址

External system log server port：遠程日志服務器端口號

Log output level：日志輸出等級

Cron Log Level：Cron定時任務日志輸出等級

Figure 46: System – Logging

Language: 默認為auto，即English。您也可以設置為其它支持的語言。

··

· Time Synchronization - 時間同步

Enable NTP client：開啟NTP客戶端

Provide NTP server：開啟NTP服務器

NTP Server candidates：NTP 服務器列表

#Administration - 管理權

可以在這里修改登錄網關用戶的密碼。

Figure 48: Administration

#License

此頁面展示了當前的License狀態、支持連接到內置服務器的網關及節點數量。如果購買了License，需要在此頁面輸入您的 License信息并提交。

Figure 49: License

#Backup / Flash Firmware - 備份和升級

在此頁面可進行固件升級，建議在升級固件時備份網關配置信息。

Figure 50: Backup, reset and firmware update

Backup/Restore：

· Generate archive: 備份網關的配置文件并下載到本地

· Perform reset: 將網關恢復到出廠狀態

· Restore: 將備份的網關配置文件恢復到網關

Flash new firmware:

· Keep settings：是否保留配置信息

· Image：選擇升級固件文件。單擊“Flash Image”對固件進行校驗。校驗結束后，請核對固件信息及校驗結果。核對無誤后，單擊 “Proceed”開始升級。

警告：請耐心等待網關升級結束，升級過程中切勿切斷網關電源。升級完成后如果無法自動跳轉到登錄界面，請重新手動登錄。

#Reboot - 重啟

單擊頁面中的“Perform reboot”進行可重新啟動網關。網關Web頁面右上角會提示目前還未保存的修改，請重啟前保存修改，否則這些修改將會丟失。

Figure 51: System reboot

File Browser

可以在此頁面訪問根分區中的文件。

Figure 52: File Browser