MeshTNC

MeshTNC

MeshTNC 是一个用于在消费级无线电之间传输 LoRa 数据的工具。

• 代码 - github.com/datapartyjs/MeshTNC
• 发布版 - github.com/datapartyjs/MeshTNC/releases
• 支持 - ko-fi/dataparty

功能特性

• 固件内置简单的串行 CLI
• 通过串行 CLI 在 LoRa 上传输原始字节（十六进制）
• 将 LoRa 数据包记录到串行（十六进制）
• BLE 数据包嗅探
• KISS-TNC 模式

编译

使用 Visual Studio Code 的 PlatformIO 插件

• 在 Visual Studio Code 中安装 PlatformIO。
• 克隆并在 Visual Studio Code 中打开 MeshTNC 仓库。
• 查看您可以修改和运行的示例应用程序：
  • 简单中继器

使用命令行

• 安装 PlatformIO Core CLI
• 克隆并在您选择的 shell 中打开 MeshTNC 仓库
• 从 'variants' 目录下的 'platform.ini' 文件中找到您设备的环境名称
  • 或者通过 pio project config | grep '^env:' 输出找到设备
• 构建单独的固件 export FIRMWARE_VERSION="localbuild" ; ./build firmware <设备环境名称>
• 在 'out' 目录中找到固件镜像

刷写

下载预编译的固件发布版 - github.com/datapartyjs/MeshTNC/releases

我们尚未构建刷写工具。您可以使用 meshcore 刷写器、OEM 提供的刷写工具，或者按照开发者说明使用 VS Code 进行刷写。

• 使用您平台的 OEM 刷写工具进行刷写
• 使用 meshcore 刷写器 - http://flasher.meshcore.co.uk/

硬件兼容性

MeshTNC 设计用于 MeshCore 支持的设备，因此请查看 MeshCore Flasher 中的支持列表。我们支持大部分相同的硬件，请参阅 variants。

串行 CLI

MeshTNC 固件初始启动时处于人类可读的串行模式。您可以使用串行终端应用程序连接到串行控制台。您可能需要配置波特率，默认值为 115200。以下命令使用 minicom 连接到串行端口，请将 /dev/ttyACM0 替换为正确的设备节点：

minicom -b 115200 -D /dev/ttyACM0

在 Linux 系统上，运行以下命令设置与串行端口交互时的默认波特率可能会有所帮助：

stty -F /dev/ttyACM0 115200

连接后，MeshTNC 设备具有一个简单的 CLI。该 CLI 与 MeshCore 大致相似，只有一些值得注意的补充。

CLI 补充命令

• txraw <hex...> - 传输一个数据包
• get syncword <word> - 读取同步字设置
• set kiss port <port> - 设置 KISS 设备端口
• set radio <freq>,<bw>,<sf>,<coding-rate>,<syncword> - 配置无线电
• serial mode kiss - 切换到 KISS 模式
• rxlog on - 启用 LoRa 数据包记录
  • 输出格式： [timestamp],[type=RXLOG],[rssi],[snr],[hex...]\n
• rxlog off - 禁用 LoRa 数据包记录
• rxlog ble on - 启用 BLE 数据包记录
  • 输出格式： [timestamp],[type=RXBLE],[rssi],[snr],[MAC - 6 octets][hex...]\n
• rxlog ble off - 禁用 BLE 数据包记录
• get ble - 转储 BLE 设置
• set ble <active_scan>,<filter_dups>,<max_results>,<scantime>
  • active_scan - on / off - 是否使用主动扫描。默认值为 off
  • filter_dups - on / off - 是否过滤重复项。默认值为 on
  • max_results - 每次扫描的最大结果数
  • scantime - 扫描的毫秒数
• set/get txpower - MeshCore 的 set/get tx 已相应重命名

现有命令

• reboot
• clock sync
• start ota
• clock
• time
• tempradio
• clear stats
• get af
• get agc.reset.interval
• get name
• get lat
• get lon
• get radio
• get rxdelay
• get txdelay
• get freq
• set af
• set int.thresh
• set agc.reset.interval
• set name
• set radio
• set lat
• set lon
• set rxdelay
• set txdelay
• set freq
• erase
• ver
• log start
• log stop
• rxlog on
• rxlog off

KISS 模式

KISS 模式允许将 LoRa 无线电作为 KISS 调制解调器操作，使其与许多现有的无线电软件兼容，包括 APRS 软件和 Linux 内核。

启用 KISS 模式

• 打开串行控制台并连接到 MeshTNC 设备
• serial mode kiss

退出 KISS 模式

• 要退出 KISS 模式并返回 CLI 模式，您可以发送如下 KISS 退出序列：echo -ne '\xC0\xFF\xC0' > /dev/ttyUSBx
  • 要使此操作生效，请确保使用 stty 正确设置了串行端口的设置和波特率

基于 LoRa 的 APRS

您可以将喜爱的 APRS 工具与 MeshTNC 配合使用。只需选择一个频率，将无线电置于 kiss 模式，然后作为 KISS TNC 设备连接到您的 APRS 工具即可。

• minicom -D /dev/ttyACM0
  • set radio 918.25,500.0,7,5,0x16
  • serial mode kiss

APRS 软件

MeshTNC 应与许多 APRS 客户端兼容，我们已在以下客户端上进行了测试：

• xastir
• APRSisce32

基于 LoRa 的 AX.25

此处有大量知识和示例：https://linux-ax25.in-berlin.de/wiki/AX.25

有许多非常有趣的事情可以直接通过 AX.25 完成，无需涉及 IP，但以下示例将演示如何为 AX.25 接口分配 IP 地址。这可以在两台不同的机器上使用两个 MeshTNC 完成，只要两个 MeshTNC 上的无线电设置相匹配、每台系统上分配的 IP 地址位于同一子网且彼此不同，并且每台系统上的呼号（或至少 SSID）不同，您就应该能够通过无线电在它们之间进行 ping 操作。如果配置正确，IP 路由也将正常工作！

AX.25 快速入门

• 将 MeshTNC 连接到 Linux 系统。
• 在 MeshTNC CLI 上分配正确的无线电设置
• 在 MeshTNC CLI 上进入 KISS 模式
  • 进入 KISS 模式后，请退出您的终端程序以释放串行端口。
• 在所连接的 Linux 系统上，编辑 /etc/ax25/axports：
  • 添加以下行：
    • 0 AL1CE-1 115200 220 2 AX25 test
    • 将 AL1CE-1 替换为您的呼号和 SSID
• 使用以下命令将 MeshTNC 连接到 AX.25 端口：kissattach /dev/ttyACM0 0
  • 运行此命令后，检查它创建了哪个接口：sudo dmesg | grep mkiss
    • [88447.885556] mkiss: ax0: crc mode is auto.
• 您可以通过运行以下命令分配 IP 地址：ip addr add 10.10.10.10/24 dev ax0

基于 LoRa 的以太网

在两台或更多计算机上执行以下操作，每台计算机都连接一个 MeshTNC 设备，以创建基于 LoRa 的以太网网络。

• 安装 tncattach
  • git clone https://github.com/markqvist/tncattach.git
  • cd tncattach
  • make
  • sudo make install
• minicom -D /dev/ttyACM0
  • set radio 916.75,500.0,5,5,0x16
  • serial mode kiss

在第一台机器上

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.10/24 /dev/ttyACM0 115200

在第二台机器上

• sudo tncattach --mtu=230 -e -noipv6 --ipv4=10.10.10.11/24 /dev/ttyACM0 115200