An RF-accurate MeshCore simulator. It runs real firmware against a sample-accurate
LoRa channel, so a result tells you what arrived at the antenna and why.
Apple silicon, macOS 12+. Includes the emulators, so an emulated board boots on
first run.
Or install with one command
curl -fsSL https://meshbench.github.io/install.sh | sh
Showing the bundled build
Everything included. Nothing to fetch on first run.
Which build do you want?
Both are the same application. The difference is whether the emulators travel with it,
and that only matters if you intend to run the firmware images people actually flash.
Bundled
about 118 MB
You want an emulated board to boot the moment it lands, with nothing to fetch and
nothing to explain. This is the right answer for a one-off download.
MeshBench itself
QEMU and Renode, our forks
The SX1262 chip model
Renode's platform descriptions
Compact
about 26 MB
You already have the forks built, you are scripting a container, or you care about
coverage, link budgets and native firmware and may never point it at an emulated
board. It completes itself from Configuration > Setup.
MeshBench itself
The SX1262 chip model
No emulators - fetched on demand
About 105 MB when you do
Bundled
Compact
Coverage, link budgets, planning
Yes
Yes
Native firmware nodes
Yes
Yes downloads MeshCore on first use either way
Emulated boards, straight away
Yes
After Setup fetches the emulators
Download
~118 MB
~26 MB
Needs the network on first run
For terrain and firmware only
Also for the emulators
What a package manager gives you
meshbench-bundled
meshbench
Every platform
Choose an operating system. The build shown follows the switch above.
One command
Recommended
Works out your distribution, adds our repository or tap, and installs
through it. The same line on macOS and Linux, and on macOS it installs
through Homebrew, so the quarantine flag is handled for you.
curl -fsSL https://meshbench.github.io/install.sh | sh -s -- --bundled
It is a shell script from the internet, so
read it first
if you would rather. Everything it does is spelled out below.
Homebrew, by hand
Handles the quarantine flag for you. We are not notarised, so a
disk image otherwise needs a right-click and Open on first launch.
The compact macOS build cannot finish itself yet.
Setup has no Renode package for macOS, so emulated nRF52 boards need the fork built
by hand. QEMU is published and untested there. A distribution's own QEMU will not
do: it has no SX1262 in it, and a stock Renode sleeps for ever on a wake condition
that is already true.
One command
Recommended
Works out your distribution, adds our repository or tap, and installs
through it. The same line on macOS and Linux, and on macOS it installs
through Homebrew, so the quarantine flag is handled for you.
curl -fsSL https://meshbench.github.io/install.sh | sh -s -- --bundled
It is a shell script from the internet, so
read it first
if you would rather. Everything it does is spelled out below.
For a memory stick, a build agent, or anywhere an installer is unwanted.
Download
Setup cannot fetch the emulators on Windows yet
The compact Windows build cannot finish itself yet.
Emulated boards do run on Windows, but Setup cannot download the emulators there.
Take the bundled build, or build the forks yourself and point
MESHBENCH_QEMU and
MESHBENCH_RENODE at them.
Verifying, and older versions
Every asset is listed in SHA256SUMS, published beside them.
sha256sum -c SHA256SUMS --ignore-missing
This page always offers the current release. A run is meant to be reproducible, so if
you need the build somebody else used, every previous release is on the
releases page.