
Mocktastic:在Arduino上实现Meshtastic兼容LoRa客户端
来源标题:Mocktastic: A Meshtastic Node on Arduino
Mocktastic 是一个面向 ESP32 开发板、基于 Arduino IDE 的 Meshtastic 兼容 LoRa 客户端,可在配置信道和私信中收发并解码文本消息。它包含 DHT22 温湿度传感器示例,目标硬件为 LilyGO T3 LoRa32 V1.6.1。该项目为教学实验性质,并非官方 Meshtastic 固件的分支。
以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Mocktastic 是一个小型、可定制的 Meshtastic 兼容 LoRa 客户端,面向使用 ArduinoIDE 环境的 ESP32 开发板。它是一个教学与实验性质的实现,并非官方 Meshtastic 固件的分支。该项目演示了如何用 C++ 构建和解码 Meshtastic 数据包,并包含一个可用的环境传感器示例。DECODER 提供一个交互式串口 shell,用于在配置好的 Meshtastic 频道和私聊中接收、解码和发送文本消息。SENSOR 则把开发板变成一个 DHT22 温湿度传感器,它可以发送测量数据,并在配置好的私有频道上响应 /dht 消息。
该实现面向 LilyGO T3 LoRa32 V1.6.1(ESP32-PICO 和 SX1276),并设计为可适配其他兼容的 ESP32/LoRa 硬件。项目在测试阶段使用 MBDTLS 处理加密部分,并使用 Nano-Protobuf 作为轻量级 protobuf 编码器。测试使用 Doctest 的轻量级 C++ 测试框架编写。仓库根目录包含 meshtastic_decoder/,其中存放固件和主机端测试:
meshtastic_decoder/meshtastic_decoder.ino Arduino 入口点、开发板集成、无线电设置以及编译期模式选择。
meshtastic_decoder/functions.h、functions.cpp 通用的数据包、字节和字符串辅助函数。
客户端使用的加密操作,包括 AES 和 X25519。
meshtastic_decoder/meshtastic.h、meshtastic.cpp 更高层的 Meshtastic 数据包处理、加密和 Protobuf 载荷。
meshtastic_decoder/lora_shell.h、lora_shell.cpp Shell 命令解析和高层消息操作;扩展客户端时这是一个很好的起点。
Nanopb 运行时和生成的 Meshtastic Protobuf 定义。
主机端测试使用的随附 mbedTLS 源码。
基于 Doctest 的单元测试,针对与平台无关的逻辑。
我以 Python 的 unittest 方式为模型,来测试单个、可预测的逻辑单元。项目将协议和工具逻辑与硬件效果分离,以便可以在开发机上运行。测试本身使用轻量级 doctest 框架编写,并与随附的测试依赖一起编译。
cd meshtastic_decoder make test
Makefile 将构建和运行测试合为一步。测试覆盖与平台无关的函数、加密、Meshtastic 数据包处理和 shell 解析;对无线电或传感器行为的更改还应在目标硬件上检查。要构建 API 文档,请安装 Doxygen 和 Graphviz,然后在 meshtastic_decoder/ 下运行 make doxygen;生成的文档会写入 meshtastic_decoder/docs/html/。
要求 你需要一块 ESP32 开发板和一款 Semtech SX1276 系列 LoRa 无线电。SENSOR 变体还需要一个 DHT22。经过测试的开发板是 LilyGO T3 LoRa32 V1.6.1,它集成了 ESP32 和 LoRa 无线电。
安装 Arduino IDE,下载或克隆此仓库,然后打开 meshtastic_decoder/meshtastic_decoder.ino。通过 Arduino 库管理器安装以下库:
打开 build_opt.h,填入你硬编码的文件路径。结果应类似这样:"Hard/coded/path/…/Mocktastic/meshtastic_decoder/nanopb_meshtastic/src"
=== LoRa 引脚 查阅开发板规格以确定对应引脚。以下映射适用于 LilyGO T3 V1.6.1:
在 meshtastic_decoder/meshtastic_decoder.ino 的 LoRa 引脚定义中填入你开发板的引脚:
#define LORA_SCK 5 #define LORA_MISO 19 #define LORA_MOSI 27 #define LORA_SS 18 #define LORA_RST 23 #define LORA_DIO0 26
区域无线电预设 以下表作为 Meshtastic 无线电预设的参考。请确认你选择的预设和频率在你所在地区受支持。
该 sketch 的默认设置为 EU Medium Fast,配置如下:
LoRa.begin(869525024); LoRa.setSpreadingFactor(9); LoRa.setSignalBandwidth(250E3); LoRa.setCodingRate4(5); LoRa.setSyncWord(0x2B); LoRa.setPreambleLength(16); LoRa.enableCrc();
发射前务必核实当地无线电法规。在 Meshtastic 文档的 Overview 页面中,使用 Radio Settings 及其 Frequency Slot Calculator 选择频道和时隙,并确定对应频率。在 sketch 中使用该频率,并确保它与其他节点匹配。
编译前,在 meshtastic_decoder/keys.h 中配置 PublicChannel、PrivateChannel、Admn 和 Device:
对于 PublicChannel,填入所选频率下使用的公共频道名称和密钥。频道名称对应无线电预设(例如 MediumFast)。
对于 PrivateChannel,填入用于消息的私有频道名称和密钥。
对于 Admn,填入你将从中读取消息的主节点的名称或节点 ID 以及公钥。不要在此条目中放入私钥。
对于 Device,填入本节点的名称、公钥和私钥。
使用连接到相关节点的 Meshtastic 软件读取频道配置和节点详情。Channel 结构包含 name 和 key;Friend 包含 name 和 publicKey;User 按此顺序包含 name、publicKey 和 privateKey。密钥必须是十六进制字符串。Meshtastic 可能以 Base64 提供它们;在将其加入配置前,先用 b64StrToHexStr() 转换为十六进制。
使用你自己的凭据,并对私钥和频道密钥保密。不要将它们发布到公共仓库中。
该 sketch 在编译期选择模式。在 meshtastic_decoder/meshtastic_decoder.ino 顶部附近,保留 DECODER 定义以使用串口 shell,或将其替换为 SENSOR 以使用 DHT22 传感器变体:
#define DECODER
对于传感器构建,将该行替换为:
#define SENSOR
使用 Arduino IDE 为你选择的 ESP32 开发板构建并上传 sketch。DECODER 变体通过串口连接操作。以 115200 波特率打开串口监视器。其命令如下:
在公共频道上发送一个 Meshtastic 数据包。
在私有频道上发送一个 Meshtastic 数据包。
通过发送本节点的公钥来启动私聊。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。