使用RAK_common容器镜像,让设备秒变LoRaWAN®网关

描述

近年来,手机、平板等移动平台市场飞速扩展,但让人惊讶的是,SBC(单板计算机)的市场却并没有被“移动平台”蚕食。相反,随着物联网、边缘计算等应用需求的增长,市面上出现越来越多定位于不同应用场景的 SBC,树莓派正是其中的佼佼者之一。

 

 

 

由于树莓派开源社区十分成熟,基于树莓派的开发往往事半功倍,因此不少企业都推出了基于树莓派的产品。我们今天要介绍的 RAK_common_for_gateway(以下简称 rak_common)和其容器化镜像就是其中的一款典型。

 

RAK_common 是瑞科慧联(RAK)基于开源社区资源开发的一套 LoRaWAN® 软件栈。它可以让用户在极短时间内,在树莓派上部署好 LoRaWAN® 网关,方便进一步开发或直接将其用于生产环境。

背景介绍

RAK_common 软件栈的原始仓库中提供了非常详细的使用指南,包括:如何下载源码、如何使用树莓派内置的 raspi-config 工具来配置相关接口、如何使用一键安装脚本、以及如何使用一个简单的 GUI 来配置网关等相关内容信息。在可支持的硬件平台上,RAK_common 软件栈内的一键安装脚本就可以自动识别树莓派的基础型号,例如树莓派 0、树莓派 3、树莓派 4、树莓派 cm3、以及树莓派 cm4,并自动修改对应的配置文件;在  LoRa® 集中器方面,RAK-common 软件栈可以支持 SX1301、SX1302,以及 SX1303 集中器。

 

LoRa

 

瑞科慧联非常贴心地为每种集中器都提供了 USB 和 SPI  规格接口,以及可选的 GPS 和 LTE 模块,所以用户可以根据自身实际需求来购买具有“对应接口和对应功能”的集中器,并且在一键安装脚本中,手动选择对应的型号来部署相关代码和配置。RAK-common 软件栈可以支持的集中器型号如下所示:

 

RAK831(Choose RAK2245)

RAK2245

RAK7243/RAK7244 no LTE

RAK7243/RAK7244 with LTE

RAK833(USB)(Choose RAK2247 USB)

RAK2247(USB)

RAK833(SPI)(Choose RAK2247 SPI)

RAK2247(SPI)

RAK2246

RAK7248 no LTE (RAK2287 + raspberry pi)

RAK7248 with LTE (RAK2287 + LTE + raspberry pi)

RAK2287(USB)

RAK7271(Choose RAK2287 USB)

RAK5146(USB)

RAK7371(Choose RAK5146 USB)

RAK5146(SPI)

RAK5146(SPI) with LTE

 

随着云原生时代的到来,容器技术凭借其可移植性高、部署方便、运维成本低等特点,迅速成为“在边缘计算设备上部署服务”的首选方式。而瑞科慧联的 LoRaWAN® UDP Packet Forwarder Protocol for Docker  这一项目恰好就是针对 RAK-common 软件栈进行了代码结构的优化和打包。这样,即使用户不在树莓派硬件平台上,也能快速部署 LoRaWAN® UDP packet forwarder。如果用户在设备上已经安装了 docker,使用瑞科慧联提供的容器镜像就更简单,只需要在 docker-compose.yml 中修改对应的配置选项,然后需要输入一条命令 ‘docker-compose up‘,就可以在几秒钟内部署好一个 LoRaWAN® packet forwarder ,将设备变为一台 LoRaWAN® 网关。

 

该项目的特性如下所示:

 

  • 支持多平台、多架构,如 AMD64(x86_64), ARMv8, ARMv7 and ARMv6 架构支持基于 SX1301, SX1302, SX1303 and SX1308 的 LoRa® 集中器
  • 支持使用 SPI 和 USB 接口的集中器
  • 兼容使用 The Things Stack(community edition/TTNv3)或者是 Chirpstack LNS 等 LoRa®  网络服务器
  • 一键部署,同时可配置度高
  • 支持使用 Balena 部署,方便集群管理

应用示例

下面我会以频段为 US915 的 RAK5146 集中器的 SPI 版本为例子,向大家展示如何使用 docker-compose,实现一键部署 LoRaWAN® UDP packet forwarder。

前期准备

硬件准备:

  • RAK5146 集中器
  • 树莓派3/4/CM3/CM4(CM3 或者 CM4 需要对应的载板)或者任意其他有 PCIe/GPIO 的 arm 平台或者 x86 平台
  • 如果你的 host 设备上没有 PCIe 接口,需要使用一个额外的 RAK2287 Pi HAT 板载 PCle 连接器

 

软件准备:

 

  • 在本地预安装了 docker 和 docker-compose,以及相关的依赖(docker 和 docker-compose 的安装十分简单,请参照官方文档。

具体步骤如下所示:

  • 新建一个文件夹,并在文件夹中新建一个名叫 docker-compose.yml 的文件:

 

mkdir example
cd example
nano docker-compose.yml

 

  • 接着将下列内容粘贴进该文件并保存:

 

version: '3.7'

services:

   udp-packet-forwarder:
     image: rakwireless/udp-packet-forwarder:latest
     container_name: udp-packet-forwarder
     restart: unless-stopped
     devices:
        -/dev/spidev0.0
    volumes:
       -/sys:/sys
    environment:
#	     MODEL: "RAK5146"	              #该镜像可根据Rakwireless集中器型号自动配置接口等
       CONCENTRATOR: "SX1303"	    #第三方集中器需要依次定义CONCENTRATOR、INTERFACE等变量,例如RAK5146是基于SX1303芯片
       INTERFACE: "SPI"
       RADIO_DEV: "/dev/spidev0.0"
       BAND: "us_902_928"            #此处以US915为例,根据集中器支持频段修改即可
       TTN_REGION: "eu1"	            #如使用TTS作为ns,默认使用eu1服务器,可按需修改
#     	  SERVER_HOST: "10.2.21.27" #如果不使用TTS,则修改为您自己ns的地址
#	      SERVER_PORT: "1700"         #同上

 

  • 保存后,在终端同一个目录下中执行如下命令:

 

pi@rasperry:docker-compose up
#如果安装了新版docker compose,请运行如下命令
docker compose up

 

如果配置正确的话,你将看到如下的 log,其中包含了网关的 EUI,以及后续 TTS 的 ns 地址。

 

LoRa

 

网关的 EUI 可以通过在终端运行以下命令获取:

 

docker exec -it udp-packet-forwarder ./get_eui.sh

 

光在网关上部署 udp-packet-forwarder 可不够,你还需要配置网络服务器(ns),此处我们以 The Things Stack (TTS) 为例:

 

复制上述红色高亮的地址 eu1.cloud.thethings.network,使用你的浏览器访问该地址,注册账号后,你将看到 TTS 的网关和应用配置页面:

 

LoRa

 

接下来你需要按照页面上的操作提示,依次进行以下操作:

 

  1. 点击 Go to Gateway
  2. 点击 Add Gateway
  3. 依次填入网关的信息,例如 ID,名字,EUI,以及频段
  4. 点击页面下方的 Create Gateway 来完成网关的创建

 

完成以上步骤后,请等待片刻,稍后网关将自动连上 TTS 网络服务器。连接成功后,网关会有如下 log:

 

LoRa

 

而在 TTS 网络服务器侧,则可以看到网关入网的提示:

 

LoRa

 

以上就是最基础、也最常见的一种部署 LoRaWAN® 网关的方式。此外,瑞科慧联还提供了基于该镜像的多种应用案例,包括双频段网关、接入 influxdb 数据库和 Grafana 图形化面板、接入 TagoCore 的案例等等,具体可以参考其 Github 代码仓库

 

大家可以参考代码仓库中的开源应用案例,只需要稍加修改、就能打造出属于你自己的解决方案。

打开APP阅读更多精彩内容
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

×
20
完善资料,
赚取积分