WEB管理平台

本文档详述了网关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 蜂窝网络上行链路时，降低某一个上行网络接口优先级的操作才会起作用。
• 链路的优先级由各自的网络接口的默认网关跃点数决定。可分别在 "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

第三方服务器集成选项，通过修改应用下的第三方服务器集成选项，可以修改此应用下的节点的报文发往第三方服务器的格式。可以设置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：系统日志缓冲区大小（单位Kbyte）

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