firmware

meshtasticGPL-3.0活跃维护

Meshtastic 官方固件,让 ESP32、nRF52 等低成本 LoRa 开发板组成无需基站的离网 Mesh 通信网络,适合徒步和野外场景。

The official firmware for Meshtastic, an open-source, off-grid mesh communication system.

v2.8.2.d5f1619发布于 2026-11-04 00:09 UTC8,555star +7 / 7 天2,903fork同步于 2026-11-10 11:31 UTC

怎么上手

由 README 提炼,执行前请确认
README 未给出本地编译或烧录命令,仅链接到官方构建与烧录文档:https://meshtastic.org/docs/development/firmware/build
硬件要求按 README 说明

README 未说明具体硬件规格;仅列出支持的平台为 ESP32、nRF52、RP2040/RP2350 和基于 Linux 的设备。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

Meshtastic 官方设备固件,让 LoRa 设备组成无需联网的远距离低功耗通信网状网

Meshtastic 官方固件,让 ESP32、nRF52 等低成本 LoRa 开发板组成无需基站的离网 Mesh 通信网络,适合徒步和野外场景。

核心能力

  • 在去中心化 LoRa 网状网中传输文本消息
  • 支持位置共享与遥测数据上报
  • 覆盖 ESP32、nRF52、RP2040/RP2350 及 Linux 设备
  • 不依赖互联网或蜂窝基础设施即可通信

容易踩的坑

README 未提供构建命令,需按官方文档安装对应平台工具链;烧录步骤需参考官方 Flashing 文档,不同硬件平台流程不同。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v2.8.2.d5f1619
  1. v2.8.2.d5f1619Meshtastic Firmware 2.8.2.d5f1619 Alphapre-release最新正式版2026-11-04 · 2026-11-04 00:09 UTC

    [!IMPORTANT] XEdDSA signing policy has changed. In Compatible mode, nodes no longer sign packets; AES-CCM now takes precedence, and Strict mode gains exemptions. Review your signing settings after updating. (#12191) Key verification is now refused when licensed (ham) mode is enabled. (#12201)

    [!NOTE] MQTT gateways now uplink PKI direct messages they relay but cannot decrypt. These messages stay end-to-end encrypted. (#12110)

    Re-release of 2.8.2 to fix a stack exhaustion bug in environmental telemetry.

    🌟 Highlights

    📡 Radio performance and reliability

    • Smarter Listen Before Talk: CAD-to-RX handoff, correct symbol timing, and better thresholds (#11137)
    • Received LoRa frames are now read from a dedicated FreeRTOS task (#11983)
    • Fixes for many RX/TX edge cases:
      • Preamble hold sized for the worst-case frame (#12125)
      • Damaged-header CAD handoffs now end cleanly (#12144)
      • A stale RX flag can no longer clobber a live frame (#12153)
      • SX126x re-stages a TX after the modem parameters change (#12101)
    • AGC is reset only when the radio has gone quiet (or once a day), and the RadioLib BUSY wait is bounded (#12072, #12105)

    🔐 Security and PKI

    • Faster encrypted packets with a shared-secret cache (#11979)
    • nRF52840 now runs X25519 and Ed25519 verification on the CC310 hardware crypto engine (#12098)
    • Relays no longer rewrite NodeInfo or NeighborInfo payloads (#12088, #12090)
    • Imported private keys are clamped before the public key is derived (#12095)
    • Further hardening against incoming packets with spoofed own node num (#12270)

    🐧 meshtasticd (Linux / Raspberry Pi)

    • BLE peripheral support via BlueZ: connect the phone apps directly to a Pi node (#11396)
    • DMShell: remote shell over the mesh, with an on-board test client (#11976, #12111)
    • Native mDNS discovery via Avahi and Bonjour (#12032, #12142)
    • Host notifications (#10216)
    • Admin keys in config.yaml, no longer limited to three (#12056)
    • Faster CH341 USB radio handling (#12013, #12016)
    • Adafruit Arcade Bonnet input (#12116)

    🖥️ Displays

    • InkHUD: offline maps from an SD card (#12118), plus an InkHUD port for the ThinkNode M5 (#12097)
    • Ethernet status is now shown on the WiFi screen (#11991)

    🔧 New and improved hardware

    • New boards:
      • Makerfabs Nomad Terminal (#12112)
      • RAK WisMesh Dongle (#12009)
      • Nodara nRF52840 (#12211)
    • RAK2560 WisMesh Hub SensorHub uplink (#11817)
    • T-Beam 1W now supports the LR1121 and LR2021 modules (#12204)
    • GPS updates for ThinkNode M5 and M8, Wio Tracker L2 fixes, and the Meshnology W12 front end (#12113, #12151, #12133, #12238)

    🩹 Notable fixes

    • Fixed an ESP32 light-sleep crash caused by a DIO1 interrupt storm (#12131)
    • Fixed a crash when enabling Store & Forward after a boot with it disabled (#12168)
    • Deferred NodeDB saves are no longer dropped (#11930)
    • ESP32 shutdown and BLE OTA DFU reliability fixes (#12159, #12220)
  2. v2.8.2.4c89b69Meshtastic Firmware 2.8.2.4c89b69 Alpha (Revoked)pre-release2026-11-02 · 2026-11-02 18:26 UTC
    查看更新说明

    [!IMPORTANT] XEdDSA signing policy has changed. In Compatible mode, nodes no longer sign packets; AES-CCM now takes precedence, and Strict mode gains exemptions. Review your signing settings after updating. (#12191) Key verification is now refused when licensed (ham) mode is enabled. (#12201)

    [!NOTE] MQTT gateways now uplink PKI direct messages they relay but cannot decrypt. These messages stay end-to-end encrypted. (#12110)

    🌟 Highlights

    📡 Radio performance and reliability

    • Smarter Listen Before Talk: CAD-to-RX handoff, correct symbol timing, and better thresholds (#11137)
    • Received LoRa frames are now read from a dedicated FreeRTOS task (#11983)
    • Fixes for many RX/TX edge cases:
      • Preamble hold sized for the worst-case frame (#12125)
      • Damaged-header CAD handoffs now end cleanly (#12144)
      • A stale RX flag can no longer clobber a live frame (#12153)
      • SX126x re-stages a TX after the modem parameters change (#12101)
    • AGC is reset only when the radio has gone quiet (or once a day), and the RadioLib BUSY wait is bounded (#12072, #12105)

    🔐 Security and PKI

    • Faster encrypted packets with a shared-secret cache (#11979)
    • nRF52840 now runs X25519 and Ed25519 verification on the CC310 hardware crypto engine (#12098)
    • Relays no longer rewrite NodeInfo or NeighborInfo payloads (#12088, #12090)
    • Imported private keys are clamped before the public key is derived (#12095)
    • Further hardening against incoming packets with spoofed own node num (#12270)

    🐧 meshtasticd (Linux / Raspberry Pi)

    • BLE peripheral support via BlueZ: connect the phone apps directly to a Pi node (#11396)
    • DMShell: remote shell over the mesh, with an on-board test client (#11976, #12111)
    • Native mDNS discovery via Avahi and Bonjour (#12032, #12142)
    • Host notifications (#10216)
    • Admin keys in config.yaml, no longer limited to three (#12056)
    • Faster CH341 USB radio handling (#12013, #12016)
    • Adafruit Arcade Bonnet input (#12116)

    🖥️ Displays

    • InkHUD: offline maps from an SD card (#12118), plus an InkHUD port for the ThinkNode M5 (#12097)
    • Ethernet status is now shown on the WiFi screen (#11991)

    🔧 New and improved hardware

    • New boards:
      • Makerfabs Nomad Terminal (#12112)
      • RAK WisMesh Dongle (#12009)
      • Nodara nRF52840 (#12211)
    • RAK2560 WisMesh Hub SensorHub uplink (#11817)
    • T-Beam 1W now supports the LR1121 and LR2021 modules (#12204)
    • GPS updates for ThinkNode M5 and M8, Wio Tracker L2 fixes, and the Meshnology W12 front end (#12113, #12151, #12133, #12238)

    🩹 Notable fixes

    • Fixed an ESP32 light-sleep crash caused by a DIO1 interrupt storm (#12131)
    • Fixed a crash when enabling Store & Forward after a boot with it disabled (#12168)
    • Deferred NodeDB saves are no longer dropped (#11930)
    • ESP32 shutdown and BLE OTA DFU reliability fixes (#12159, #12220)
  3. v2.8.1.8e6a88dMeshtastic Firmware 2.8.1.8e6a88d Alphapre-release2026-10-01 · 2026-10-01 17:19 UTC
    查看更新说明

    🚀 Big changes

    [!WARNING] New US nodes now default to LongTurbo, not LongFast. Only applies to first-time region selection on the device screen. LongTurbo and LongFast can't hear each other. You will need to switch the preset back to LongFast to join an existing mesh on the prior default. (#11637)

    A problem was found in the 2.8.0 packet signing code. 2.8.0 has been revoked, and 2.8.1 signatures are not compatible with the revoked 2.8.0 firmware.

    [!IMPORTANT] If you hit a bootloop or repeated crashes after upgrading, we recommend a full erase and flash. Export your config first to backup first, if you have any important settings you want to save.

    There are a number of fundamental changes to 2.8 that require a heads-up. Please review some of these higher profile changes so that you are aware of them before installing:

    • Node numbers (ID) are now derived from the public-key identity of the node instead of hardware mac address
    • XEdDSA based packet signing
    • Reduction of long-name to 25 bytes
    • Precise position no longer allowed on known-keys (public mesh. Please use private channels for this)
    • Telemetry and position are off-by-default and must be opted into
    • Ground-up redesigned NodeDB storage and traffic management
    • Completely new allocation of LoRa Regions and presets, including ham specific carve-outs
    • Signing acks with the Ack_proof field

    Other high-impact changes

    Radio & mesh protocol

    • Packet Signing via XEdDSA (#10478) plus a BaseUI signing status UI (#10841), unsigned-packet policy hardening with test coverage (#10858), and runtime-toggleable MESHTASTIC_LOCKDOWN hardening for nRF52 (#10349, opt-in via #10712).
    • Sign the whole Data envelope, in one unambiguous layout by @jp-bennett in https://github.com/meshtastic/firmware/pull/11422
    • Send an ack over PKC when no channel can carry it by @jp-bennett in https://github.com/meshtastic/firmware/pull/11891
    • Traffic Management Module for packet forwarding — dedup, rate limiting, role-aware policing (#9358 base, #10706 dedup/rate-limit expansion, #10745 next-hop cache overflow store, #9921 congestion-aware position interval/hop-exhaustion tuning).
    • Automatic variable hop limits based on live mesh activity and message-size estimation (#10176).
    • Mesh beacon feature and admin controls (#10618 base implementation, #10839 second pass adding beacon admin/config).
    • Noise floor tracking with a sliding-window estimate (#9347).
    • Hash table index for O(1) packet history lookups — improves routing/dedup performance on busy meshes (#9499).
    • New amateur-radio regions: 70cm (#10627), 1.25m/125cm (#10638), 2m/~144MHz (#10623); EU regions merge plus Narrow/Lite region enablement for EU (#10675, #10120); LoRa region preset map for cleaner per-region defaults (#10736).
    • TinyFast and TinySlow modem presets added to config and menu (#10597).
    • LoRa config changes now apply live without a reboot (#9962); LoRa settings expansion and validation improvements (#9878).
    • Position privacy: direct-send position packets are clamped to channel precision (#10383), and public/known-key position precision is clamped similarly (#10665) and honors explicit channel settings to prevent location leaks (#10513).
    • Licensed operators are now prevented from rebroadcasting packets to/from unlicensed users, for regulatory compliance (#9958).
    • Packets with missing/invalid hop_start (pre-hop firmware) are now deprecated/blocked (#9476).
    • Spoof detection added for UDP multicast packets (#9905).
    • Low-bandwidth conversion support added to MeshRadio (#10595).
    • ATAK Plugin V2 implemented (drops legacy unishox2 compression) (#10105), including TAKTALK voice/text chat message and room data structures.
    • Ethernet HTTP/HTTPS API server ported to RP2350 + W5500 boards (#10573), plus Ethernet OTA support for RP2350/W5500 (#10136).
    • Optional LED_LORA indicator to show LoRa TX activity (#10465), and a
  4. v2.8.0.47db0e3Meshtastic Firmware 2.8.0.47db0e3 Alpha (Revoked)pre-release2026-09-01 · 2026-09-01 10:56 UTC
    查看更新说明

    🚀 Big changes

    [!WARNING] New US nodes now default to LongTurbo, not LongFast. Only applies to first-time region selection on the device screen. LongTurbo and LongFast can't hear each other. You will need to switch the preset back to LongFast to join an existing mesh on the prior default. (#11637)

    [!IMPORTANT] If you hit a bootloop or repeated crashes after upgrading, we recommend a full erase and flash. Export your config first to backup first, if you have any important settings you want to save.

    There are a number of fundamental changes to 2.8 that require a heads-up. Please review some of these higher profile changes so that you are aware of them before installing:

    • Node numbers (ID) are now derived from the public-key identity of the node instead of hardware mac address
    • XEdDSA based packet signing
    • Reduction of long-name to 25 bytes
    • Precise position no longer allowed on known-keys (public mesh. Please use private channels for this)
    • Telemetry and position are off-by-default and must be opted into
    • Ground-up redesigned NodeDB storage and traffic management
    • Completely new allocation of LoRa Regions and presets, including ham specific carve-outs

    Other high-impact changes

    Radio & mesh protocol

    • Packet Signing via XEdDSA (#10478) plus a BaseUI signing status UI (#10841), unsigned-packet policy hardening with test coverage (#10858), and runtime-toggleable MESHTASTIC_LOCKDOWN hardening for nRF52 (#10349, opt-in via #10712).
    • Traffic Management Module for packet forwarding — dedup, rate limiting, role-aware policing (#9358 base, #10706 dedup/rate-limit expansion, #10745 next-hop cache overflow store, #9921 congestion-aware position interval/hop-exhaustion tuning).
    • Automatic variable hop limits based on live mesh activity and message-size estimation (#10176).
    • Mesh beacon feature and admin controls (#10618 base implementation, #10839 second pass adding beacon admin/config).
    • Noise floor tracking with a sliding-window estimate (#9347).
    • Hash table index for O(1) packet history lookups — improves routing/dedup performance on busy meshes (#9499).
    • New amateur-radio regions: 70cm (#10627), 1.25m/125cm (#10638), 2m/~144MHz (#10623); EU regions merge plus Narrow/Lite region enablement for EU (#10675, #10120); LoRa region preset map for cleaner per-region defaults (#10736).
    • TinyFast and TinySlow modem presets added to config and menu (#10597).
    • LoRa config changes now apply live without a reboot (#9962); LoRa settings expansion and validation improvements (#9878).
    • Position privacy: direct-send position packets are clamped to channel precision (#10383), and public/known-key position precision is clamped similarly (#10665) and honors explicit channel settings to prevent location leaks (#10513).
    • Licensed operators are now prevented from rebroadcasting packets to/from unlicensed users, for regulatory compliance (#9958).
    • Packets with missing/invalid hop_start (pre-hop firmware) are now deprecated/blocked (#9476).
    • Spoof detection added for UDP multicast packets (#9905).
    • Low-bandwidth conversion support added to MeshRadio (#10595).
    • ATAK Plugin V2 implemented (drops legacy unishox2 compression) (#10105), including TAKTALK voice/text chat message and room data structures.
    • Ethernet HTTP/HTTPS API server ported to RP2350 + W5500 boards (#10573), plus Ethernet OTA support for RP2350/W5500 (#10136).
    • Optional LED_LORA indicator to show LoRa TX activity (#10465), and an LED indicator for LoRa RX (#10674).
    • GPS time sync: device now sets its clock from GPS every 30 minutes (#10737); GPS is skipped at startup if the LoRa region is unset, to save battery (#10386); GPS model/baudrate now cached across reboots to skip a full sweep (#10544).
    • Config: position & telemetry broadcast are now opt-in rather than always-on (#10929).

    UI / display — BaseUI

    *BaseUI is the current default graphical UI (`

  5. v2.8.0.7239fe8Meshtastic Firmware 2.8.0.7239fe8 (Revoked)pre-release2026-08-30 · 2026-08-30 00:52 UTC
    查看更新说明

    [!WARNING] This initial cut of 2.8.0 was revoked due to issues encountered with LR1110 initialization. This became apparent on T1000-E devices after a fresh flash. Please download https://github.com/meshtastic/firmware/releases/tag/v2.8.0.47db0e3 instead.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    GitHub release downloads CI CLA assistant Fiscal Contributors Vercel MemBrowse

    Overview

    This repository contains the official device firmware for Meshtastic, an open-source LoRa mesh networking project designed for long-range, low-power communication without relying on internet or cellular infrastructure. The firmware supports various hardware platforms, including ESP32, nRF52, RP2040/RP2350, and Linux-based devices.

    Meshtastic enables text messaging, location sharing, and telemetry over a decentralized mesh network, making it ideal for outdoor adventures, emergency preparedness, and remote operations.

    Get Started

    Join our community and help improve Meshtastic! 🚀

    Stats

    Alt