今天，我們要介紹的是瑞科慧聯（RAK）打包并發布的一款容器。該容器無需進行復雜的配置，即可快速部署一個LoRa Basics? Station，方便開發人員直接用于生產環境或進一步開發。本文將著重介紹使用該容器將網關連接到 The Things Stack（TTS）的過程。

關于LoRa Basic?Station

LoRaBasics?Station 協議簡化了大規模 LoRaWAN? 網絡的管理，是將網關連接到 TTS的首選方式。相對于傳統的 UDPpacketforwarder，LoRa Basics? Station的優勢是：

• 支持集中更新和配置管理
• 支持 TLS和基于 token的身份驗證
• 支持集中式渠道計劃管理
• 不依賴本地時間保持

需要注意的是，在LoRa Basics? Station的部署中，最重要的是在 TTS上能生成對應的 APIkey。

該鏡像的原始倉庫中提供了非常詳細的使用指南，包括支持平臺、前置準備、進階配置指南、權限配置和其他注意事項。該鏡像支持的LoRa?集中器型號包括SX1301，SX1302，以及SX1303。RAK在每種集中器都提供了USB 和SPI 規格的接口，以及可選的GPS 和LTE 模塊，所以用戶可以根據實際需求來購買具有對應接口和功能的集中器，并且通過修改 docker-compose或者Portainer應用模板中的對應配置來啟動服務。

RAK提供的LoRa Basics? Station鏡像支持的集中器包括如下：

• SX1301 (only SPI)
  • RAK831 Concentrator
  • RAK833 Concentrator
  • RAK2245 Pi Hat
  • RAK2247 Concentrator
  • IMST iC880a
  • Dragino PG1301
• SX1302 (SPI or USB)
  • RAK2287 Concentrator
  • Seeed WM1302
• SX1303 (SPI or USB)
  • RAK5146 Concentrator
• SX1308 (SPI or USB)
  • RAK2246 Concentrator
  • RAK2247-1308 Concentrator

容器的特性

• 支持 AMD64 (x86_64)、ARMv8和ARMv7架構。
• 支持 SX1301 SPI 集中器。
• 支持 SX1302 和SX1303 SPI和USB (CoreCell)集中器
• 支持 SX1308 SPI 和SX1308 USB (PicoCell)集中器
• 支持同一設備上的多個集中器（使用一個basicstation服務）
• 與 TTS（社區版/TTNv3）或Chirpstack LNS等兼容
• 支持 CUPS 和LNS協議配置
• TTS 服務器（TTI或TTN）的網關自動配置
• 幾乎一鍵部署，同時高度可配置

應用示例

下面我將以US915 頻段的RAK2287 集中器的SPI 版本為例，展示如何使用docker-compose，實現一鍵部署LoRa Basics? Station，并將其連接到 TTSV3。

硬件準備：

• RAK2287 集中器
• 樹莓派3/4/CM3/CM4（CM3 或者CM4 需要對應的載板），或者任意其他有PCIe/GPIO 的ARM平臺或者x86 平臺
• 如果你的host 設備上沒有PCIe 接口，需要使用一個額外的 RAK2287 Pi HAT 板載PCle 連接器

軟件準備：

在本地預安裝了docker 和docker-compose，以及相關的依賴（docker和docker-compose 的安裝請參照代碼倉庫中的介紹或者直接查看 docker的官方文檔）。

具體步驟：

1.你需要首先配置網絡服務器（ns），此處我們以TTS為例： 復制該地址eu1.cloud.thethings.network到你的瀏覽器并注冊賬號。進入控制臺后即可看到TTS 的網關和應用配置頁面：

2.創建一個 Gateway并且生成對應的 apikey，用于在docke-compose中啟用該容器：

• 點擊Goto gateways
• 點擊頁面右上角的 Registergateway來創建新的網關
• 依次填入網關的信息，例如ID，名字，EUI，以及頻段.其中，EUI往往是根據網口的 MAC地址來的，可以在終端中使用以下命令來獲取默認的 EUI：docker run -it --network host --rm xoseperez/basicstation:latest ./get_eui.sh

當然你也可以自定義一個EUI，但是需要確保該DeviceEUI沒有被別的用戶在 TTS上使用過。

接著輸入別的信息，例如網關名字和具體頻段。此處因為我們的集中器是 US915頻段，因此我們在此填入的頻段為 “UnitedStates902-928 MHz，FSB2（usedbyTTN）”。

• 點擊左下方 RegisterGateway來完成網關的創建
• 在網關的控制臺頁面點擊左側邊欄中的鑰匙圖案，進入APIkeys的生成頁面

• 點擊頁面右上角的 AddAPIkey按鈕，填入名字并勾選以下權限：“link as Gateway to a Gateway Server for traffic exchange, i.e. write uplink and read downlink“

• 接著會彈出 APIkey的窗口供用戶復制，請務必在這一步中將 APIkey復制并保存到安全的位置。在關閉了該窗口后，將無法返回該界面獲取該 APIkey，只能重復上面的步驟重新生成一個新的APIkey。

3.接下來你需要使用 docker-compose來啟動你的 LoRa?集中器，此處我們以使用SPI接口的 RAK2287集中器為例，其頻段為 US915。而 host設備是一臺樹莓派 4。

• 首先我們需要新建一個文件夾，并在文件夾中新建一個名叫docker-compose.yml 的文件：

mkdir example cd
example
nano docker-compose.yml

• 接著將下列內容粘貼進該文件并保存：

version: '2.0'

services:

  basicstation:
    image: xoseperez/basicstation:latest
    container_name: basicstation 
    restart: unless-stopped devices:
       -/dev/spidev0.0 
       -/dev/gpiochip0
   environment:	
       MODEL: "RAK2287"          
       INTERFACE: "SPI"
       TTS_REGION: "eu1"
       GATEWAY_EUI: "E45F01FFFF222233"                              #可以自由指定，需要保證在TTS上不進
       TTS_FREQUENCY_PLAN_IDBAND: "US_902_928_FSB_2"	 #此處以US915為例，根據集中器支持頻段修改即可
       TC_KEY: "NNSXS.VRUYFHQ7J5NWWNB3KSW2VWFRGBZF……”#該api key是先在在TTS上生成，然后填入再啟動容器

• 保存后，在終端同一個目錄下中執行以下命令：

pi@rasperry:docker-compose up
#如果安裝了新版docker compose，請運行如下命令
docker compose up

4.完成以上步驟后，請稍等片刻，網關將自動連上TTS 網絡服務器。Basicstation的容器會打印如下log，包含對應的配置選項，例如集中器型號，deviceEUI等：

然后你會看到網關成功入網的log：

而此時在TTS 網絡服務器側，則可以看到網關入網的提示：

以上就是目前 TTN官方主推的一種部署LoRa?packerforwarder的方式。RAK 還提供多個基于容器技術的一鍵部署復雜服務的方式，包括雙頻段網關，接入influxdb 數據庫和Grafana 圖形化面板，接入TagoCore 的案例，具體可以參考其Github 代碼倉庫。

大家可以參考代碼倉庫中的開源應用案例，只需要稍加修改，就能打造出屬于你自己的解決方案。