Pilot Gateway Pro RAK7243 树莓派网关快速使用手册 版本 V1.0 2019 年五月 www.rakwireless.com 请访问网站文档下载中心以获取本手册的最新副本
目录 1. 用户须知...3 2. 准备工作...3 3. 烧写网关镜像到 SD 卡...3 4. 连接到网关设备... 3 5. 通过 SSH 登录到网关设备... 4 6. 配置网关...8 7. 连接到路由器... 15 8. 应用实践 连接到 TTN... 19 9. 应用实践 连接到 LoRaServer... 23 10. 修订历史... 29 11. 文档概要... 29 2
1. 用户须知 本文档适用于我司 RAK2245 及 RAK831 树莓派网关 RAK7243 网关产品 对于该文档的 使用说明有任何疑惑的用户, 可登录我司官网论坛提出具体的问题 RAK 官网论坛链接 :https://forum.rakwireless.com/ 2. 准备工作 1. 一个 RAK2245 Pi HAT+ 树莓派 (3B+), 或者 RAK831+ 树莓派, 或者 RAK7243 网关 ; 2. 一个不小于 16G 的 SD 卡, 一个 SD 卡读卡器 ; 3. 一台 X86 PC 机 ; 4. 在电脑上安装刻录软件, 推荐 Etcher, 下载地址 :https://www.balena.io/etcher/; 5. 在电脑上安装 SSH 工具 如果你的 PC 机是 Linux 或 Mac OS, 则无需安装 SSH 工具, 如果是 Windows, 可以使用 Putty,Putty 的下载地址 : https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html; 6. 在 RAK 官方网站上下载最新的网关镜像 : https://www.rakwireless.com/en/download/lora/rak2245-pi-hat#firmware 3. 烧写网关镜像到 SD 卡 利用前面第 6 步下载的网关镜像, 制作树莓派 SD 卡, 制作步骤详见 : http://docs.rakwireless.com/en/lora/rak2245-pi-hat/tool/how_to_write_lora_gatew ay_image_to_micro_sd.pdf 烧写完成后, 将 SD 卡插入网关设备中, 并重新启动 4. 连接到网关设备 有两种方式可以连接网关设备 : 1. 通过 WiFi 连接 3
当网关设备启动后,WiFi 将会默认工作在 AP 模式下, 这时可以搜索到 SSID 名称为 Rakwireless_XXXX 的无线网络 下图仅为示例 : PC 机连接该无线网络, 默认的 WiFi 密码为 rakwireless,pc 机的 IP 地址将由网关设备通过 DHCP 自动分配 网关设备 WiFi 的默认 IP 地址为 192.168.12.1 2. 通过网线连接通过网线将 PC 机与网关设备直接连接, 网关设备有线口默认的 IP 地址为 192.168.10.10, 注意也要将 PC 机的 IP 地址设置为与网关的有线口 IP 地址同一网段, 例如 192.168.10.12 5. 通过 SSH 登录到网关设备 1 Windows 系统上通过 SSH 登录网关设备 打开 Putty 程序, 并输入网关设备的 IP 地址 ( 注 : 下文中均以 WiFi 连接方式为例, 如果是通过有线方式连接, 则对应的 IP 地址应为 :192.168.10.10) 4
输入用户名和密码, 默认用户名为 pi, 默认密码为 raspberry 成功通过 SSH 登入网关设备 5
2 Linux 系统上通过 SSH 登录网关设备与 Mac 系统登录方式基本一致, 见下文 3 Mac 系统上通过 SSH 登录网关设备打开 Mac OS 上的终端程序 ( 如果不知道怎么打开, 请自行百度 ) 如果不是 root 状态, 则需输入 sudo -i 6
根据提示输入本机的登录密码后, 可以看到已经是 root 状态了 : 然后输入 ssh pi@192.168.12.1 来通过 SSH 登录到网关设备上 ( 如果是通过有线 方式连接的, 则输入的是 ssh pi@192.168.10.10), 默认密码是 raspberry 7
SSH 登录成功, 如下图所示 6. 配置网关 如上步骤成功以 SSH 方式登入网关后, 输入 sudo gateway-config 命令, 打开如下界 面 : 8
如上图所示 : 第 1 项是用来配置网关设备的密码的 ; 第 2 项是用来配置网关中跟 LoRa 相关的频段及 LoRa Server 信息的 ; 第 3 项是用来手动查看和修改 LoRa 配置文件 global_conf.json 的 ; 第 4 项是用来手动重启 LoRa 进程的 ; 第 5 项是用来配置网关设备中的 WiFi 功能的 ; 第 6 项是用来配置有线口的 IP 地址的 注 : 上图中还有一个非常重要的参数,Gateway ID, 该参数将会在连接 LoRa Server 时用到, 如下图所示 : 也可以通过 gateway-version 命令来查看 : 9
详细的使用方法如下 : 使用方向键, 选择 1 Set pi password, 点击回车 : OK 后会要求输入两次新密码 : 10
设置成功! 注意 : 出厂默认的密码是 raspberry, 最好将其修改为自己的私有密码 接下来需要设置网关工作频段和指定对应的 LoRa Server 默认的配置是 EU868 频段, 以及网关内置的 LoRaServer 如果想要使用其它频段或 Server, 请按照如下步骤执行 : 选择第 2 项 Setup RAK831/RAK2245 LoRa concentrator 11
可以看到 Server 的选项 ( 目前只有 TTN 和 LoRaServer 可选 ) 如果选择第 1 项, Server is TTN 后, 配置网关频段, 可选频段如下 : 12
OK 后完成配置 如果选择的 Server 是 LoRaServer 13
可选频段如下 : OK 后, 还需要指定 LoRaServer 的 IP 地址, 默认是 127.0.0.1, 即网关内置的 LoRaServer, 如果有可用的外部 LoRaServer, 也可指定为它的 IP 地址 14
7. 连接到路由器 如果需要将网关连接到路由器, 可以在以下两种方式中任选一种 : 1 通过 WiFi 连接到路由器 ; 2 通过有线连接到路由器 ; 如果想通过 WiFi 连接到路由器, 选择 5 Configure WIFI 可以看到如下界面 : 15
其中, 第 1 项是让网关的 WIFI 工作在 AP 模式 ( 客户端模式自动禁用, 这时只能它做热点让其它设备连接它, 它无法去连接其它 WIFI 热点 ), 第 2 项是让网关的 WIFI 工作在客户端模式 ( 这时 AP 模式自动禁用, 只能它去连接其它 WIFI 热点 ), 第 3 项是编辑作为 AP 模式时的 WIFI 网络 SSID 和密码, 第 4 项是编辑作为客户端模式时想要接入的 WIFI 网络 SSID 和密码 这里我们选择第 2 项, 打开客户端模式 / 关闭 AP 模式, 然后选择第 4 项, 编辑想要接 入的 WIFI 网络的 SSID 和密码 : 16
填入对应的 WIFI 网络 SSID 名称和密码即可, 然后重启网关即可 如果想要通过有线方式连接到路由器上, 按如下操作 : 选择 6 Configure LAN 17
配置有线口的静态 IP 地址 ( 默认是 192.168.10.10): 配置有线口的网关地址为路由器的 IP 地址 ( 图中为示例 ): 18
配置成功 然后重启网关即可 8. 应用实践 连接到 TTN 首先, 按照第六章节中所述的方法, 将网关连接到路由器上 ( 即接入互联网 ), 并按照 第五章中所述方法选择 TTN 作为 Server: 19
及工作频段 : 本文中我们以 EU868 频段为例 然后打开 TTN 网站 https://www.thethingsnetwork.org/ 并登录, 如果没有账号需要先注 册一个, 登录后打开右上角账号下面的 Console 页面 : 20
点击 GATEWAYS : 点击 register gateway 依次填入相应的内容 : 21
注意 : Frequency Plan 是想要 LoRa 网络工作的频段, 注意要与节点 网关的设置保 持一致 Gateway EUI 就是在前面第五章节介绍中的提到的 Gateway ID: 设置完成后, 点击页面右下角的 Register Gateway 按钮完成注册 : 22
然后就可以看到如下界面 : 如果网关配置和接入互联网都没问题, 则 Status 栏目将显示 Connected, 意味 着网关已经成功连接到 TTN 了! 9. 应用实践 连接到 LoRaServer LoRaServer 有两种承载形式可供用户自由选择 : 1) 使用网关内置的 LoRaServer 2) 使用外置的独立的 LoRaServer 23
如果想要使用网关内置的 LoRaServer, 那么恭喜你, 什么也不用干, 加电启动时, 网关会自动完成所有配置 如果想要使用外置独立的 LoRaServer, 只需按照第六章节的方法将网关接入路由器, 并按照第五章节的方法, 选择 LoRaServer 作为 Server: 并在最后一步输入你的外置 LoRaServer 设备的 IP 地址即可 : 什么, 你没有外置的 LoRaServer 设备? 别急, 可以到 RAK 网站上下载 LoRaServer 的系统镜像, 然后找一台 PC 机安装即可 ( 会擦除硬盘, 注意备份你硬盘上的数据 ): https://www.rakwireless.com/en/download/lora/lora-server-os 接下来我们登录到 LoRaServer 上添加该网关 : 首先, 打开 LoRaServer 的 web 界面 ( 浏览器中输入 IP:8080, 其中 IP 为 LoRaServer 所在设备的 IP 地址, 如果是从 LoRaServer 所在的设备直接登录, 则输入 127.0.0.1:8080 即可 ): 24
默认的用户名和密码均为 admin, 登录后可以看到如下界面 : 点击左侧树中的 Gateways : 25
默认的配置中已经有一个了, 忽略它 直接点击右上角的 CREATE 按钮 : 接下来的事情就是按照要求填写或学则对应内容即可 : 26
需要注意的是, 上图中红色方框,Gateway ID 所需要填写的内容是你要添加的网关的 Gateway ID, 是不是似曾相识? 对, 就是第五章节介绍时提到过的 : 如果网关已经按照上述要求配置好了, 并且和 LoRaServer 之间的网络已经连通, 那么 到这一步你应该就可以看到网关已经成功连接到 LoRaServer 上了 : 27
28
10. 修订历史 版本描述日期 1.0 创建文档 2019-05-14 11. 文档概要 准备审核发布 Fomi&Penn Fomi 关于瑞科慧联 : RAK 是一家专注于 IoT 领域以产品为驱动型的公司, 凭借团队深厚的无线通讯技术领域的积累, 采用创新的商业模式高效地为全球中小型的网络运营商 (Network Operator), 系统集成商 (System Integrator) 和服务提供商 (Service Provider) 等提供高性能的 IoT 产品与应用方案 29