For a single USB/BLE companion also used from a phone, without openHop.
Tested over a TCP backend (exporter read a repeater while a second client
polled the same proxy for 90 s without an error); not with a USB radio yet.
Not for openHop companions: the proxy reconnects aggressively and evicts the
other client there.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- `meshcore-exporter --list-ports` lists the USB serial ports on Linux,
macOS and Windows with description, USB ID and serial number (and the
/dev/serial/by-id/ name on Linux), so the companion can be found without
knowing where a given OS puts it.
- README: which way to go per OS. Docker Desktop on macOS and Windows does
not pass USB devices into containers, so the Docker stack with a USB board
is Linux only (WSL2 with usbipd-win); macOS and Windows run the exporter
with pipx. AGENTS.md: find the OS first, ports via --list-ports.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Prometheus exporter for MeshCore repeaters, read over the mesh: a companion
(USB, BLE, or a companion identity in openHop over TCP) logs in to each
repeater, asks for status and telemetry with direct packets and serves
battery, temperature/humidity, noise floor, RSSI/SNR, packet counters,
airtime and uptime on :9200/metrics.
- meshcore_exporter.py: command line, MC_* environment or a TOML file with
a password per repeater; --check reads every repeater once and exits;
interval 1 h (min 15 min); a failed repeater is retried once after 3 min;
contacts fetched once per round.
- dashboards/: the Grafana dashboard, generated from generate.py
(datasource, job and the rate window are variables; TX drawn above zero,
RX below).
- stack/: Docker Compose with Prometheus and Grafana provisioned, for a USB
companion, or on the host network for openHop on the same machine.
- systemd/: running without Docker.
- README.md (Czech) and AGENTS.md for setting it up with an AI agent.
- CI: lint and tests, gitleaks; PR check builds the image; single-platform
images per architecture behind a Trivy gate (latest-<arch>, and X.Y.Z-<arch>
with a release on tag vX.Y.Z); dependencies by Renovate.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>