一个能把小设备连成网的嵌入式开源项目——Meshtastic

21ic电子网 2026-11-19 11:36
去年一个山区的林业项目,要在 20 平方公里的林场里做"人员定位 + 短消息"。
没有手机信号,没有 WiFi,只有山。
试过 LoRa 点对点:一台基站覆盖不了整个林场。 LoRa 在山区视距能到 5km,但有山挡住就剩 800m。林场里有三条沟,基站放在哪都有盲区。
后来用 Meshtastic:每个护林员身上一个节点,节点之间自己转发。
一台设备发出去的消息,被旁边的设备收到、延迟一下、再转发出去。三跳之后覆盖整个林场。 代价是延迟从 1 秒变成 6 秒,但对"报个位置、发条消息"够用。
这篇讲 Meshtastic 的路由。它没有路由表,没有邻居发现,没有链路状态算法——它就是一个"受控的洪泛"。

一个离线 mesh 固件

GPL-3.0 许可,语言是 C++(Arduino 框架);版本方面,本文按 2026 年的 2.5 固件讲。仓库在 https://github.com/meshtastic/firmware。
它解决的问题很具体: 一群人在没有基础设施的地方,要互相发消息、看位置。
它的技术选择很克制: 不做路由,只做洪泛。因为在一个几十个节点、低带宽(LoRa 一次传输几十字节)、移动的网络里,路由协议的收敛速度还不如洪泛。

模块划分

firmware/
├── src/
│   ├── mesh/
│   │   ├── FloodingRouter.cpp     洪泛路由:收、判重、转发     ← 主角
│   │   ├── Router.cpp             基类:包的封装、加密
│   │   ├── NodeDB.cpp             节点表(谁在线、谁在哪)
│   │   └── MeshService.cpp        消息队列、发送调度
│   ├── modules/                   各功能模块(位置、遥测、文本)
│   └── gps/ radio/ power/ ...
└── protobufs/                     消息定义(.proto)
所有消息都是 protobuf 定义的 MeshPacket:
message MeshPacket {
    uint32 from = 1;          // 源节点
    uint32 to = 2;            // 目的节点,0xFFFFFFFF = 广播
    uint32 id = 3;            // 包 ID(去重用)
    uint32 hop_limit = 4;     // 还能转发几次
    uint32 hop_start = 5;     // 出发时的 hop_limit
    bytes  encrypted = 6;     // 加密后的 payload
    ...
}
hop_limit 和 hop_start 这两个字段,是整个路由的全部状态。

核心设计一:不路由,只洪泛——但要控制住

最简单的洪泛是"收到就转发",问题是广播风暴:一个包在 50 个节点之间会指数级复制。
Meshtastic 用四个机制把它压住:
一个能把小设备连成网的嵌入式开源项目——Meshtastic图1
① 跳数上限。 默认 hop_limit = 3。每转发一次减一,减到 0 就不再转。
if (p->hop_limit == 0) {
    /* 不再转发 */
    return;
}
p->hop_limit--;
② 去重。 这是最关键的。每个节点维护一个"最近见过的包"的表:
/* FloodingRouter.cpp,简化 */
bool FloodingRouter::wasSeenRecently(const MeshPacket *p, bool withUpdate)
{
    /* 用 from + id 作为唯一键 */
    uint32_t hash = (p->from * 31) ^ p->id;

    for (int i = 0; i < MESH_PACKET_HISTORY; i++) {
        if (recentPackets[i].hash == hash &&
            recentPackets[i].timestamp + DUPLICATE_TIMEOUT_MS > millis()) {
            return true;      /* 见过,丢弃 */
        }
    }
    /* 记下来 */
    recentPackets[nextIdx].hash = hash;
    recentPackets[nextIdx].timestamp = millis();
    nextIdx = (nextIdx + 1) % MESH_PACKET_HISTORY;
    return false;
}
这个表是一个环形数组,MESH_PACKET_HISTORY 默认几十条。 没有哈希表、没有动态分配——在 MCU 上,线性扫描几十条比哈希表更快,也更省内存。
③ 随机延迟转发。 如果所有节点同时收到、同时转发,会撞在一起。
/* 转发前等一个随机时间 */
uint32_t delay = random(0, rebroadcastDelayMs);
这个延迟还有个隐藏作用: 如果在这段延迟里,你听到了别人转发了同一个包,就可以取消自己的转发(因为已经有人替你干了)。这就是"抑制"机制,能省掉大部分重复传输。
④ 优先级。MeshPacket 有个 priority 字段,路由器的发送队列按优先级排序。位置包的优先级低于文本消息——因为位置可以等,人说的话不能等。

核心设计二:hop_start 不只是给上限,是给"距离"

hop_start 这个字段有意思。
它是出发时的 hop_limit。所以:
距离 = hop_start - hop_limit
收到一个包,用 hop_start - hop_limit 就知道它跳了几跳。
有什么用?
① 显示"信号几格"。 Meshtastic 的界面上那个信号强度,不是 RSSI,是跳数——0 跳(直连)显示满格,3 跳显示一格。
② 避免"回程不可达"。 一个 3 跳才到你这儿的节点,你发给它,它可能收不到(因为链路不对称)。Meshtastic 用跳数做"可达性"的粗估。
③ 转发时保留原值。 转发的时候 hop_limit--,但 hop_start 不变——这样每个收到的人都能算出"从源到我这儿的距离"。
/* 收到时 */
uint8_t hops = p->hop_start - p->hop_limit;

/* 如果是自己发的,两个字段都设成一样 */
p->hop_start = p->hop_limit = HOP_MAX;

核心设计三:节点表是"听来的",不是"问来的"

Meshtastic 没有邻居发现协议。
每个节点从收到的包里,被动地学习"网络里有哪些节点":
/* NodeDB.cpp,简化 */
void NodeDB::updateFrom(const MeshPacket &mp)
{
    NodeInfo *node = getOrCreateNode(mp.from);

    node->last_heard = millis();
    node->snr = mp.rx_snr;          /* 顺带记下信号质量 */

    if (mp.which_payload_variant == MeshPacket_user_tag) {
        /* 包里带了用户信息(名字、ID),更新 */
        node->user = mp.payload_variant.user;
    }
}
这个表存在 RAM 里,也存一份在 Flash(重启不丢)。
关键设计:节点表有上限(默认 100 个),超了就淘汰"最久没听到的"。
if (numNodes >= MAX_NUM_NODES) {
    /* 找一个最久没 heard 的,替换掉 */
}
这套"被动学习"的好处是零开销——不发探测包、不占带宽。坏处是"新节点要等别人发消息才能被发现"。
在林业那个项目里,这个特性正好合适:护林员每隔几分钟上报一次位置,节点表自然就建起来了。
一个能把小设备连成网的嵌入式开源项目——Meshtastic图2
"被动学习"这个词听起来很聪明,实现起来其实很朴素。updateFrom() 只有一个入参 mp,收到的每个包都过一遍:谁发的、信号多好、带了什么载荷。没有探测、没有握手、没有超时重传。

LoRa 的物理限制,决定了这一切

为什么是洪泛而不是路由?因为 LoRa 的物理层太慢了。
参数
典型值
后果
带宽
125 kHz

扩频因子
SF11
速率约 250 bps
一次传输
几十字节
一次约 1–2 秒
占空比限制
1%(欧洲)
一小时只能发 36 秒
250 bps 意味着一次路由表交换(哪怕只有 20 个节点、每个 10 字节)就要好几秒,还会撞上占空比限制。
而洪泛,一个包 1.5 秒,三跳覆盖全网。 在"几十个节点、消息不频繁"的场景下,洪泛的总开销反而更低。
这就是"协议要匹配物理层"的典型例子。 同样的洪泛策略,用在 WiFi 上就是灾难;同样的路由算法,用在 LoRa 上根本跑不起来。
一个能把小设备连成网的嵌入式开源项目——Meshtastic图3
这张图我建议你算一遍再设计协议。 32 字节、SF11、1% 占空比——三个数字一乘,你每小时能发的东西就定死了。任何"先探测再发"的协议在这个配额下面都活不下去。

一个能把小设备连成网的嵌入式开源项目——Meshtastic图4
有人说「我的节点一小时只能发 22 条」,以为是 bug。算一下就知道了:1.6 秒空中时间 × 22 ≈ 36 秒,正好卡在 EU 的 1% 上。这是法规,不是限制。

五个坑,占空比最容易违规

第一个,hop_limit 设太大。 设成 7,一个包在网络里能转 7 圈,占空比直接爆掉,然后被运营商(或者法规)限制。 一般 3 够用,节点特别稀疏才用 5。
第二个,去重表太小。MESH_PACKET_HISTORY 是几十条。网络里包一多,表转一圈回来就忘了,同一个包被转发两次。 现象是"带宽莫名其妙被吃掉"。
第三个,节点位置包发太勤。 默认 15 分钟一次。改成 1 分钟,20 个节点就把信道占满了。 位置更新的频率要按"人能走多快"算,不是按"我想多准"。
第四个,天线。 LoRa 的 433/868/915MHz 天线必须谐振在对应频点。用 2.4G 的天线,或者用错频点的天线,通信距离掉到十分之一,而且看不出明显错误。
第五个,加密密钥不一致。 Meshtastic 用一个共享的 PSK。密钥不同,收到的包解不开,表现为"能看到节点但收不到消息"。 这个坑我第一次调了三个小时。

洪泛的三道闸

第一,"洪泛 + 去重 + 跳数上限 + 随机延迟"是四件套,缺一不可。 前三个控制"转不转",第四个控制"什么时候转"。只做前三个,一定会撞包。
第二,去重表用环形数组 + 线性扫描,在几十条的规模下比哈希表更优。 这是 MCU 上的常态:小规模下,简单结构的常数因子比复杂度更重要。
第三,hop_start 这种"记录初始值"的字段,比"记录当前值"信息量大。 一个字段带出"跳了几跳",比单独加一个 hops 字段省。
第四,节点表靠"听"而不是靠"问",是被低带宽逼出来的设计。 带宽够的时候,主动探测更简单;带宽不够的时候,被动学习是唯一选择。
第五,协议必须匹配物理层。 250bps 的信道和 100Mbps 的信道,该用的算法完全不同。别把 TCP/IP 那套直觉带过来。

资料

  • 仓库:https://github.com/meshtastic/firmware
  • 文档:https://meshtastic.org/docs/ ,Mesh Algorithm 那一页讲清了洪泛和去重
  • 最该读的文件:src/mesh/FloodingRouter.cpp(几百行,全篇值得读)、src/mesh/NodeDB.cpp(节点表与淘汰)
  • 协议:protobufs/meshtastic/mesh.proto,MeshPacket 的定义
  • 硬件:常见的是 Heltec V3(ESP32 + SX1262,约 100 元)、T-Beam(带 GPS)
  • LoRa 基础:Semtech 的《LoRa Modem Design Guide》,讲清了 SF、BW、占空比的关系
  • 对照读:libcanard(同样是"低带宽总线上的协议",但它是点对点)、paho MQTT(有基础设施时的做法)
  • 法规:433/868/915MHz 的占空比和发射功率,各国不同,做产品前查清楚

END


一个能把小设备连成网的嵌入式开源项目——Meshtastic图5



最后提一句,21ic论坛(bbs.21ic.com)正在招募原创作者,单篇文章奖励最高500元,欢迎广大网友踊跃投稿!一个能把小设备连成网的嵌入式开源项目——Meshtastic图6 

往期精选:




您的👍对我们很重要
可以点击最下面的💗给小编加鸡腿

关于科技区角:国内科技展会垂直内容策划服务商,提供从论坛内容全案策划、会展市场化IP打造到精准专业观众一站式邀约服务,以产业内容吸引高质量B端人群,打通展会从议题设计、演讲嘉宾邀约、宣传预热、精准邀观到供需对接全链路。
声明:内容取材于网络,仅代表作者观点,如有内容违规问题,请联系处理。
IC 嵌入式 开源
more
邀请:AMD 嵌入式峰会深圳站
使用反汇编调试嵌入式应用
J-link支持 AI 辅助调试,未来嵌入式开发方式正在变化
体验首款原生内置agent的嵌入式IDE,全程不写一行代码,几分钟实现了想要的效果
PCB嵌入式功率模块,进展如何?
AMD 嵌入式峰会・深圳站|FPGA、嵌入式 AI等|技术盛宴,报名开启!
海光1000正式发布,国产CPU进军嵌入式
TI 扩展 Zephyr RTOS 支持,统一嵌入式开发体验
国产芯片巨头入局嵌入式,海光用技术和生态破局
巅峰之上·新品预告 | 长飞先进PCB嵌入式车规模块即将发布
Copyright © 2025-成都区角科技有限公司
蜀ICP备2025143415号-1
  
川公网安备51015602001305号