一个离线 mesh 固件
模块划分
firmware/
├── src/
│ ├── mesh/
│ │ ├── FloodingRouter.cpp 洪泛路由:收、判重、转发 ← 主角
│ │ ├── Router.cpp 基类:包的封装、加密
│ │ ├── NodeDB.cpp 节点表(谁在线、谁在哪)
│ │ └── MeshService.cpp 消息队列、发送调度
│ ├── modules/ 各功能模块(位置、遥测、文本)
│ └── gps/ radio/ power/ ...
└── protobufs/ 消息定义(.proto)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 这两个字段,是整个路由的全部状态。核心设计一:不路由,只洪泛——但要控制住

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_limithop_start - hop_limit 就知道它跳了几跳。hop_limit--,但 hop_start 不变——这样每个收到的人都能算出"从源到我这儿的距离"。/* 收到时 */
uint8_t hops = p->hop_start - p->hop_limit;
/* 如果是自己发的,两个字段都设成一样 */
p->hop_start = p->hop_limit = HOP_MAX;核心设计三:节点表是"听来的",不是"问来的"
/* 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;
}
}if (numNodes >= MAX_NUM_NODES) {
/* 找一个最久没 heard 的,替换掉 */
}
updateFrom() 只有一个入参 mp,收到的每个包都过一遍:谁发的、信号多好、带了什么载荷。没有探测、没有握手、没有超时重传。LoRa 的物理限制,决定了这一切
| 一次约 1–2 秒 | ||
| 一小时只能发 36 秒 |


五个坑,占空比最容易违规
hop_limit 设太大。 设成 7,一个包在网络里能转 7 圈,占空比直接爆掉,然后被运营商(或者法规)限制。 一般 3 够用,节点特别稀疏才用 5。MESH_PACKET_HISTORY 是几十条。网络里包一多,表转一圈回来就忘了,同一个包被转发两次。 现象是"带宽莫名其妙被吃掉"。洪泛的三道闸
hop_start 这种"记录初始值"的字段,比"记录当前值"信息量大。 一个字段带出"跳了几跳",比单独加一个 hops 字段省。资料
仓库: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

往期精选: