lorawan...

LoRaWAN 商业网关WisDevice 系列 RAK724x/RAK7258

WEB 配置指南版本 1.6 | 2019 年 7 月

www.RAKwireless.com请访问网站文档下载中心以获取本手册的最新副本。

2

目录

1 概述....................................................................................................................................................... 3

2 登录网关............................................................................................................................................... 3

3 WEB 管理配置......................................................................................................................................5

3.1 Status - 运行状态.....................................................................................................................5

3.1.1 Overvie - 总览............................................................................................................... 5

3.1.2 LoRa Packet Logger - LoRa 报文记录器...................................................................6

3.1.3 System Log - 系统日志................................................................................................8

3.1.4 Firewall - 防火墙........................................................................................................... 8

3.2 Network - 网络配置..................................................................................................................9

3.2.1 WAN Interface - WAN 接口..........................................................................................9

3.2.2 Wi-Fi 网络......................................................................................................................9

3.2.3 Cellular Interface - LTE 蜂窝网络............................................................................. 10

3.2.4 Diagnostics - 网络诊断.............................................................................................. 11

3.2.5 Ping Watchdog.............................................................................................................11

3.3 LoRa Gateway........................................................................................................................13

3.3.1 LoRa Packet Forwarder – LoRa 报文转发器.........................................................13

3.3.2 LoRa Gateway MQTT Bridge....................................................................................21

3.4 LoRa Network Server 网络服务器...................................................................................... 22

3.4.1 General - 基本配置.....................................................................................................23

3.4.2 Gateway – 网关管理..................................................................................................23

3.4.3 Application – 应用...................................................................................................... 25

3.4.4 Global Integration - 全局集成接口...........................................................................28

3.5 System - 系统.........................................................................................................................29

3.5.1 System - 系统设置..................................................................................................... 29

3.5.2 Administrator - 管理权............................................................................................... 30

3.5.3 Backup / Flash Firmware 备份和升级......................................................................30

3.5.4 Reboot - 重新启动......................................................................................................31

4 附录 1 LoRa Network Server 全局集成接口 API topic 定义及消息格式.................................. 31

5 联系方式.............................................................................................................................................35

6 修订历史.............................................................................................................................................36

7 文档概要.............................................................................................................................................36

3

1 概述

本文档适用于我司室外 LoRaWAN 网关 RAK7249 和室内 LoRaWAN 网关 RAK7258 产品，主要

介绍了网关 WEB 平台的配置使用，内置 LoRa Server 的使用，还包括网关的升级、恢复出厂设

置等。

2 登录网关

通过浏览器直接访问网页，需要通过 IP 地址来直接访问。

1. 网关在上电之后会自动创建 AP 热点，您可以直接电脑搜索链接对应的 AP 热点，AP 热点以

产品型号开头，后缀是设备 MAC 地址后四位。AP 热点默认不加密，直接链接之后，通过浏览

器访问 http://192.168.230.1/。

2. 您还可以通过网线直接连接路由器，之后登陆路由器查询当前网关的 IP 地址。通过该 IP 地

址也可以直接访问网关的网页。

通过以上方法打开网页。

http://192.168.230.1/

4

注意：网关 WEB 管理平台采用 HTTPS 协议，浏览器会进行证书安全提示，直接继续访问即可。

通过浏览器打开页面之后，需要输入用户名和密码。用户名和密码默认都是 root 。

5

3 WEB 管理配置

3.1 Status - 运行状态

3.1.1 Overvie - 总览

Recevied：显示 LoRa 网关接收到的 LoRa 报文总数

Transmittd：显示 LoRa 网关发送的 LoRa 报文总数

Active Nodes：显示 LoRa 网关覆盖范围内活跃的 LoRa 节点数（10 分钟内发送过报文的节点）

Busy Nodes：显示 LoRa 网关覆盖范围内繁忙的节点数（发送报文平均间隔小于 60s 的节点）

Dutycycle Of LoRa Channel：图表展示了 12 个小时内所有信道的“占空比”随时间变化的热

力图。纵轴为时间，最小间隔为 60s。横轴为信道频率。每个数值代表了该信道在 60s 内的占空

比平均值（取值范围 0%~100%），绿色代表低占空比，红色代表高占空比。

LoRa Traffic：图表展示了 2 个小时内各个 spread factor 的 LoRa 报文收发速率（packet/min）。

纵轴代表报文收发速率，单位为 packet/min，六种颜色分别代表 6 个 spread factor，总的高度

代表所有报文收发速率之和。

6

3.1.2 LoRa Packet Logger - LoRa 报文记录器

7

LoRaWAN Packet Logger 实时记录和解析 LoRa 网关收发的报文，可以根据报文类型和节点地

址进行过滤。

Type：根据报文类型过滤。选择 ALL 为不过滤，展示所有报文。

DevAddr：根据节点地址过滤报文。

Hide CRC_ERR packet：选中后将不展示 CRC 校验错误的报文。

Pause/Play：暂停/开始报文的记录。

Clear：清空当前的记录

Download：将当前的记录以 CSV 格式保存到本地。

8

3.1.3 System Log - 系统日志

通过此页面可实时查看网关的系统日志。

3.1.4 Firewall - 防火墙

通过此页面可查看网关防火墙的运行状态。

9

3.2 Network - 网络配置

3.2.1 WAN Interface - WAN 接口

在本页面，用户可以观察设备 WAN 接口的运行状态，或修改 WAN 接口的接口协议。

WAN 接口支持 DHCP/PPPoE/静态 IP 三种协议。

注意：为了保持互联网通信的稳定性，强烈建议您通过 WAN 口使用网线连接路由器入网。

3.2.2 Wi-Fi 网络

点击 “禁用”/“启用”按钮以关闭或开启 Wi-Fi 网络。

Wi-Fi 网络支持两种工作模式。

无线接入点（AP – Access Point）:

网关默认工作在 AP 模式。AP 模式下用户可使用 Wi-Fi 终端（手机/PC 等）连接到设备。默认

SSID 为 RAK7258_XXXX，无加密。通过 Wi-Fi 访问时，设备的 IP 地址为 192.168.230.1。

10

无线客户端（Client）：

客户端模式时，设备可作为无线客户端连接到 Wi-Fi 网络中。此时 Wi-Fi 接口可作为设备的上行

网络接口。用户需要手动填写无线网络 SSID/加密方式/无线密码等信息。

3.2.3 Cellular Interface - LTE 蜂窝网络

注：此功能只针对支持 LTE 功能的网关设备。

进入 Network –> Cellular Network 页面，如下图所示。

在此页面可对 LTE 蜂窝网络(WWAN)进行配置。

请根据网络运营商提供的信息正确填写 APN/User/Password。

11

3.2.4 Diagnostics - 网络诊断

此页面可使用设备内置的网络诊断工具 ping/traceroute/nslookup 对设备的网络连接进行诊断。

诊断结果将自动显示在下方。

3.2.5 Ping Watchdog

Ping Watchdog 通过不断在指定的上行网络接口上 ping 指定的 IP 地址或域名，对网络链路的

通信质量进行监控。当发现网络链路存在故障时，自动采取预定的措施，如<重新启动接口>/<

降低此上行网络接口的优先级>/<重启设备>等。

注意：

只有在 LoRa 网关同时使用了以太网上行链路和 LTE 蜂窝网络上行链路时，降低某一个上行接

口的优先级的操作才会起作用。

WAN 接口代表以太网上行接口，WWAN 代表 LTE 蜂窝网络上行接口。如果同时在两个上行网

络接口上打开 ping watchdog，并将 action 设置为 Increase Gatway Metric，两个上行链路形成

相互备份链路，并在其中一条链路发生故障时自动切换到另一台链路。两个链路的优先级由各自

的网络接口的默认网关跃点数（gatway metric）决定。可以分别在 Network ->WAN Network

和 Network-> Cellular Network 中设置各自的默认网关跃点数。网关跃点数越低，链路的优先级

越高。

12

Ping Watchdog 参数设置

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：网关重新启动

13

3.3 LoRa Gateway

3.3.1 LoRa Packet Forwarder – LoRa 报文转发器

LoRa Packet Forwarder 通过基于 IP/UDP 的 GWMP 协议，将 LoRa Concentrator 接收到的

LoRa报文转发到 LoRa Network Server。并通过LoRa Concentrator发出由LoRa Network Servr

发送的 LoRa 报文。

General Setup - 基本设置

Gateway EUI：网关的 EUI，请保持默认值不要修改

Protocol：有三种协议可选。

Semtech UDP GWMP Protocol ：LoRa Packet Forwarder将以基于 IP/UDP的GWMP

协议连接到 LoRa Network Server。

LoRa Gateway MQTT Bridge ： LoRa Packet Forwarder 将连接到本机的 LoRa

Gateway Bridge 进程，LoRa Gateway Bridge 将使用 MQTT 协议代理 LoRa Packet

Forwardr 与 LoRa Network Server 之间的连接。

Build-in LoRa Server ：LoRa Packet Forwarder 将连接到本机的 LoRa Network

Server

Push Timeout (ms)：上传到服务器报文的超时时间

Statistic Interval (s)：上报统计信息的间隔

Keepalive Interval (s)：发送 Keepalive 保活报文的间隔

Automatic data recovery：数据自动恢复。开启后，当LoRa Packet forwarder与LoRa Network

Server 的通信中断（连续三个 keepalive 请求没有得到响应）,LoRa Packet forwarder 将收到的

上行数据报文存储到本机的存储卡中，并在与 LoRa Network Server 的通信恢复后，自动发送

14

到 LoRa Network Server

Auto-restart Threshold：自动重启阈值。当 Keepalive 请求连续失败的次数超过该值，LoRa

Packet Forwarder 将自动重启。设置为 0 时关闭此功能。打开 Automatic data recovery 后，

此功能不生效。

Import Frequency Plan Template：导入预置的频谱计划模板。

Standard Frquency Setup Mode - 标准频谱设置

Packet Forwarder 的频谱设置模式默认为标准模式。

如果当前配置模式为自定义模式（Advanced Mode）,可点击按钮<Switch to Standard Mode>

切换到标准模式。

标准配置模式下，用户只需要填写频谱计划中的各个信道的频率即可。其它参数（如发射频率范

围等）将根据 LoRaWAN 协议的规定自动设置完成。

标准模式下频谱设置步骤如下：

步骤一、选择工作频段（Region）。工作频段是指 LoRaWAN 协议中规定的 Regional Parameter

Comman name (Channel Plan) ，可选值为：

EU868/IN865/US915/AU915/AS923/KR920/CN470/EU433。

步骤二、配置 Multi-SF LoRa Channel。Multi-SF LoRa Channel 是指速率为 SF7-SF12，带宽

为 125K 的 LoRa 信道。此类信道最多可以设置 8 个（16 信道设备最多可以设置 16 个）。新增

时在图中所示的输入框中填写需要添加的信道频率（单位为 MHz），点击<Add>按钮，新的信

道频率就会出现在 Multi-SF LoRa Channel 列表中。

注意：

15

新增的频谱必须符合当前区域（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。Standard LoRa Channel 是指带宽为 250KHz/500KHz

的单一速率信道。信道的带宽和速率会根据工作区域（Region）自动选择。

新增 Standard LoRa Channel 时，在下图中所示的输入框输入要增加的 Standard LoRa Channel

频率，点击输入框后面的<Add>按钮，即可将该信道添加到 Standard LoRa Channel 列表中。

最多可以设置 1 个 Standard LoRa Channel（16 信道可以设置两个 Standard LoRa Channel）。

说明：

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

16

步骤四、设置 FSK 信道。FSK 的速率会根据所选工作区域（Region）自动选择。新增 FSK 信

道时，在下图所示的输入框中输入要增加的 FSK 信道频率，点击输入框后面的<Add>按钮，即

可将该 FSK 信道添加到 FSK 信道列表中。最多可以设置 1 个 FSK 信道（16 信道设备可以设置

2 个 FSK 信道）。

说明：

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

步骤五、配置完成后，点击 <Save & Apply> 保存并应用配置。

Advanced Frquency Setup Mode - 自定义频谱设置

如果当前配置模式为标准模式，可点击按钮<切换到自定义模式>切换到自定义模式。

自定义模式下需要对每个 LoRa Concentrator 的详细运行参数进行设定。

LoRa Concentrator 是 LoRa 网关的基本单元，网关在实际的应用中会根据实际的使用场景选择

一个或者多个 LoRa Concentrator，常见的是 1 个或者 2 个。

每个 LoRa Concentrator 可以同时监听 8 个多速率 LoRa 信道（MultiSF Channel,DR0~DR5）,1

17

个标准 LoRa 信道（LoRa Standard Channel）和 1 个 FSK 信道，共计 10 个信道。同时 LoRa

Concentrator 包含 2 个 Radio 单元，分别为 Radio 0 和 Raido 1。Radio0 可用于接收和发送射

频信号，Radio1 仅用于接收射频信号。

每个 Radio 最多可以监听 5 个信道（包括 MultiSF channel，LoRa Std channel, FSK channel）。

用户可根据实际需求将信道分配到两个 Radio 单元。

1. 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 的发射频

率范围保持一致，且不允许修改。

2. 信道参数设置

信道设置界面采用表格形式。表格的每一列代表一个信道。每个 LoRa Concentrator 支持 8 个多

速率信道（MultiSF），一个标准 LoRa 信道（ LoRa std ）和一个 FSK 信道。通过设置 Radio0

或者 1 的中心频点，之后选择对应的频率偏移量，即可选定某一个频率值 Freq. 。

18

参数说明

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 信道由用户自行设定。

3. 信道设置示例

此处以某个 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

19

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)

a. 设置 Radio 中心频段

每个 Radio 分配 8 个多速率 LoRa 信道， 1~4 属于 Radio0，中心频率为 486600000 Hz。 5~8

属于 Radio1，中心频率为 487400000

b. 设置发射频率

需保证下行信道的所有频点都包含在发 Radio 段中，因此 Radio 0 Tx Min 设置为 506000000，

Radio 1 Tx Max 设置为 508600000，建议设置频率的最小值要小于使用频率中有效最小值（例

如 506700000）500KHz 以上, 同时最大值要大于使用频率中有效最大值（例如 508100000）

500KHz 以上。

c. 设置信道

MultiSF 0 ~ 3 Radio 设置为 Radio0 ， If 频率偏移分别设置为 -300000/-100000/

100000/300000。

MultiSF 4 ~ 7 Radio 设置为 Radio1，If 频率偏移分别设置为-300000/-100000/ 100000/300000。

LoRa Std 和 FSK 信道关闭

d. 设置完成，点击 Save&Apply

Beacon Setup – Class B Beacon 报文设置

Beacon Period：Beacon 发射周期

Beacon Frequency (Hz)：Beacon 发射频率

20

Beacon Channel Number：Beacon 信道个数

Beacon Frequency Step：Beacon 信道频率间隔

Beacon Datarate：Beacon 报文速率

Beacon Bandwidth：Beacon 报文带宽

Beacon Tx Power：Beacon 报文发射功率

Beacon information descriptor：Beacon 信息描述

Packet Filter – LoRa 报文过滤

支持两种过滤模式，两种过滤模式可同时开启

White List Mode - 白名单模式，开启后仅转发符合白名单列表规则的报文，其它报文

将被丢弃

Auto Filter - OTAA 报文自动过滤，根据指定规则，过滤 OTAA 入网请求报文，防止非

法节点频繁发送 OTAA 请求

Enable White List Mode：开启白名单模式

OUI List：OUI 白名单列表。OUI 为 LoRa 节点 Device EUI 的前六个字节，为厂商标识。开启

白名单模式后，只有在 OUI 列表中厂商的 LoRa 节点的 OTAA 入网请求报文会被转发，其它

OTAA 入网请求将被丢弃。

Network ID List：网络 ID 列表，网络 ID 为 LoRa 节点 Device Address 的前 7bit。开启白名单

模式后，只有 Device Address 的 Network ID 在 Network ID 列表中的 LoRa 节点发送的数据报

文会被转发，其它报文将被丢弃。

Enable Auto Filter：开启 OTAA 入网请求自动过滤。当某个 LoRa 节点的 OTAA 入网请求过于

频繁，超过了预设的阈值，一定时间内，该节点发送的 OTAA 入网请求报文将被丢弃。

Discard Period：禁止转发 OTAA 入网报文的时长。单位为秒

21

Join Period：统计某个节点 OTAA 入网请求次数的周期。单位为秒

Join Interval：同一个节点两次 OTAA 入网请求的最小间隔（秒）

Join Count1：同一个节点连续以小于 Join Interval 的间隔发送 OTAA 入网请求次数超过该值，

将禁止转发该节点的 OTAA 入网请求。禁止时长为 Discard Period。

Join Count2：同一个 LoRa 节点在 Join Period 周期内发送的 OTAA 入网请求次数超过该值，

将禁止转发该节点的 OTAA 入网请求。禁止时长为 Discard Period.

GPS Information – 网关 GPS 位置信息

Fake GPS：开启后，网关的位置信息将强制使用此处填写的值，而不是 GPS 定位得到的信息。

3.3.2 LoRa Gateway MQTT Bridge

LoRa Gateway MQTT Bridge 可连接本机的 LoRa Packet Forwarder ，将 LoRa Packet

Forwarder 基于 UDP 连接 GWMP 协议报文转换为 MQTT 协议连接到 LoRa Network Server，

可增强 LoRa 网络的连接可靠性和保密性。

MQTT 客户端设置

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

22

MQTT Broker Port：MQTT 服务器的端口号

Client ID：客户端 ID

Clean Session：连接时是否打开全新的会话

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 证书（CACertificate），客户端证书（Client

Certificate）和客户端密钥（Client Key）。如果客户端密钥文件是加密的，需要填

写客户端密钥密码（Client Key Passphrase）

TLS Version：TLS 协议版本，支持 TLSv1 / TLSv1.1 / TLSv1.2

3.4 LoRa Network Server 网络服务器

LoRa Gateway 支持 Build-in LoRa Network Server 。 Build-in LoRa Network Server 遵循

LoRaWAN 1.0.2 协议。支持以下特性：

LoRaWAN Class A / Class C 模式

OTAA/ABP 激活模式

ADR 动态速率调整

Regional Parameters：EU863-870 / US902-928 / AU915-928 / CN470-510 / AS923 /

KR920-923 / IN865-867

定时更新 LoRa 节点状态（最后更新时间/电池电量/Link Margin）

批量配置 LoRa 节点，CSV 格式文件批量导入/导出 LoRa 节点

实时业务报文监控

LoRa Network Server 提供了基于 MQTT 协议的 Application Server API。第三方应用服务器可

通过该 API 与 Build-in LoRa Network Server 集成，获取的 LoRa 网络中解密后的上行数据，也

可通过该 API 将下行数据推送到 LoRa 节点。

23

3.4.1 General - 基本配置

Enable：点击以开启或关闭 LoRa Network Server。

Region：选择 LoRaWAN 网络的工作区域，即工作频段。

Enable ADR：点击以开启或关闭 ADR 功能

Minimum allowed data-rate：ADR 功能支持的最低速率

Maximum allowed data-rate：ADR 功能支持的最高速率

Network ID：LoRaWAN 网络的 ID

Downlink Tx Power：设置下行报文的发射功率，单位 dBm

Device-status request interval：LoRa Network Server向 LoRa节点请求电池电量/Link Margin

状态信息的间隔。设置为 0 关闭此功能。

3.4.2 Gateway – 网关管理

设备允许其它的 LoRa 网关设备通过 LoRa Gateway MQTT Bridge 连接到内置的 LoRa Network

Server。

24

Gateway

可以添加或删除网关，管理接入到 LoRa Network Server 的网关设备。

Gateway Backend

设置用于连接其它网关设备的 MQTT 客户端。






Password




Self-signed server certificate：自签名的服务器认证

自签名服务器认证需要填写 PEM 格式的自签名 CA 证书。Self-signed server & client

certificate：自签名的服务器&客户端双向认证自签名的双向认证需要填写 PEM 格式

的自签名 CA 证书（CACertificate），客户端证书（Client Certificate）和客户端密钥

（Client Key）。如果客户端密钥文件是加密的，需要填写客户端密钥密码（Client

Key Passphrase）

25


3.4.3 Application – 应用

“Application”是 LoRa Network Server 中的管理 LoRa 节点的基本单元。

Application

在 Application Overview 列表下方的输入框中输入 Application Name，点击 <Add>按钮，进入

Application 编辑页面。

Application EUI：LoRa 节点 OTAA 激活参数

Application Key：LoRa 节点 OTAA 激活的密钥

Auto Add LoRa Device：开启后，收到未知的 LoRa 节点在 OTAA 报文时，如果 Application EUI

和 Application Key 和此 Application 的设置一致，该 LoRa 节点将被自动添加到此 Application

的 LoRa 节点列表中。关闭后，未知 LoRa 节点无法 OTAA 激活。

Description：Application 的描述信息

26

LoRa 节点

在 Application Overview 页面点击 Application 列表右侧的<Edit>按钮，打开 Application 详情页，

进入节点列表。

增加节点：

在 Application 详情页 Device 列表下方输入 LoRa 节点的 Device EUI，点击<Add>按钮

批量增加节点：

点击<Batch Add>，可批量添加节点。

导出节点：

点击<Export>，可将节点列表导出到 csv 文件中，并下载到本地。

导入节点：

点击<Import>，可将通过<Export>导出的 csv 格式节点列表导入到设备中

点击节点列表中的 Device name 或 Device EUI，进入到节点详情页。

Configuration - 节点配置：

27

Device name：节点名称

Class：节点工作模式（Class A / Class C）

Join mode：节点激活方式（OTAA / ABP）

Application Key：默认为 Application 的 Application Key - OTAA

Device Address：节点地址 – ABP

Application Session Key：Application 会话密钥 – ABP

Network Session Key：Network 会话密钥 – ABP

Enable frame-counter Validation：开启报文序号检查

Description：节点描述信息

Activation - 节点活动信息：

Device Address：节点地址

Application Session Key：Application 会话密钥

Network Session Key：Network 会话密钥

Uplink frame counter：上行报文计数

Downlink frame couter：下行报文计数

Clear frame couter：点击按钮重置报文计数

Downlink – 发送下行数据

通过此页面可以向 LoRa 节点发送下行数据

Confirmed：是否需要确认（ACK）

28

FPort：下行数据端口

Hex Bytes：待下发下行数据的 16 进制字符串编码

Send：点击 Send 按钮发送数据

Live Data Frame – 实时报文

在本页面可实时查看节点的报文。点击报文可展开查看报文详情

3.4.4 Global Integration - 全局集成接口

LoRa Network Server 提供了基于 MQTT 协议的 API 接口，用来连接到第三方服务器。通过 API

接口，LoRa Network Server 可以将 LoRa 节点的入网状态，上行数据和节点状态等信息发送到

第三方服务器。也可接收来自第三方的下行数据，并通过 LoRa 网络发送到对应的节点。

MQTT 客户端设置





29


Password




Self-signed server certificate：自签名的服务器认证。自签名服务器认证需要填写 PEM

格式的自签名 CA 证书

Self-signed server & client certificate：自签名的服务器&客户端双向认证。自签名的

双向认证需要填写 PEM 格式的自签名 CA 证书（CACertificate），客户端证书（Client

Certificate）和客户端密钥（Client Key）。如果客户端密钥文件是加密的，需要填

写客户端密钥密码（Client Key Passphrase）


MQTT Topic Template

LoRa Network Server 发布和订阅消息的主题。

具体 Topic 定义及消息格式的定义请参阅附录 1 LoRa Network Server 全局集成接口 API topic

定义及消息格式

3.5 System - 系统

3.5.1 System - 系统设置

General Settings - 基本设置

Local Time：网关本地时间。点击 <Sync with browser>按钮可同步设备和当前主机的时间。

Hostname：网关主机名

Timezone：网关时区

Logging- 系统日志

System log buffer size：系统日志缓冲区大小（单位 Kbyte）

External system log server：远程日志服务器地址

30

External system log server port：远程日志服务器端口号

Log output level：日志输出等级

Cron Log Level：Cron 定时任务日志输出等级

Language - 语言设置

Language：设置网关 WEB 管理的平台的语言

Time Synchronization – 时间同步

Enable NTP client：开启 NTP 客户端

Provide NTP server：开启 NTP 服务器

NTP Server candidates：NTP 服务器列表

3.5.2 Administrator - 管理权

修改网关登录密码

3.5.3 Backup / Flash Firmware 备份和升级

配置备份与恢复

Download backup：备份网关的配置文件并下载到本地

Reset to defaults：将网关恢复到出厂状态

Restore backup：将备份的网关配置文件恢复到网关

固件升级

Keep settings：是否保留配置信息

Image：选择升级固件文件。点击<Flash Image>对固件进行校验

31

请核对固件信息及校验和。核对无误后，点击 <Proceed> 开始升级。

注意：

升级过程中请耐心等待，切勿切断设备电源。升级完成后如果无法自动跳转到登录界

面，请重新手动登录。

3.5.4 Reboot - 重新启动

重新启动网关

4 附录 1 LoRa Network Server 全局集成接口 API

topic 定义及消息格式

内置 LoRa Network Server 目前支持通过 MQTT 协议集成到客户的应用服务器。

LoRa Network Server 在下面几种事件发生时会自动发布 MQTT 消息：

join - LoRa 节点发生 OTAA 入网请求时

uplink – LoRa 节点发送上行报文时

ack – 应用服务器推送的下行报文收到确认报文时

status – LoRa 节点状态更新时（电池电量/Link margin 等信息）

LoRa Network Server 会订阅 downlink topic，第三方应用服务器可向该 topic 发布消息，LoRa

Network Server 收到该消息后，向 LoRa 节点推送下行报文。

32

具体 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

消息示例

{




"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

33

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

消息示例

{




"devEUI": "0202020202020202", // device EUI

"acknowledged": true, // whether the frame was acknowledged or not

(e.g. timeout)

"fCnt": 12 // downlink frame-counter

}

34

事件类型status

Event for battery and margin status received from devices.

topic application/[applicationID]/device/[devEUI]/status

消息示例

{




"devEUI": "0202020202020202",

"battery": 200,

"margin": 6,

"externalPowerSource": false,

"batteryLevelUnavailable": false,

"batteryLevel": 75.5

}

当第三方服务器需要向某个 LoRa 节点发送下行消息时，按照下面的格式向 downlink topic 发布

消息

事件类型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 编码格式。

35

5 联系方式

如果您有任何疑问请访问 RAK 官方论坛获取帮助，或者您也可以通过以下邮箱联系我们。

RAK 论坛：https://forum.rakwireless.com/

邮箱：[email protected]

https://forum.rakwireless.com/

mailto:[email protected]

36

6 修订历史

版本描述日期

1.0 创建文档 2018-12-20

1.1 更新描述和图片 2019-01-10

1.2 更新 WEB 配置指导章节 2019-03-11

1.3 添加 LED 状态指示说明 2019-03-13

1.4 更新 WEB 配置指南 2019-05-28

1.5 添加内置 ChirpStack 接入外部网关章节 2019-06-28

1.6 更新 WEB 配置指南章节，添加附录 2019-08-02

7 文档概要

准备审核发布

Penn, yutao Terry

关于瑞科慧联：

RAK 是一家专注于 IoT 领域以产品为驱动型的公司，凭借团队深厚的无线通讯技术领域的积累，采

用创新的商业模式高效地为全球中小型的网络运营商(Network Operator)，系统集成商(System

Integrator)和服务提供商(Service Provider)等提供高性能的 IoT 产品与应用方案。

lorawan...

Documents