Measured on a XIAO observer build: with the USB console open (DTR high) the repeater kept advertising and a laptop scan saw it. What hid it was another central holding the one link (`ble` shows `connected`). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
meshcore-repeater-observer
Udělá z MeshCore repeateru observer: přes jeho konzoli (Bluetooth nebo USB) průběžně čte, co repeater slyší, a posílá to do MQTT — do komunitního analyzeru (analyzer.meshcore.cz), do vlastního CoreScope, nebo obojí. Žádné druhé rádio vedle repeateru není potřeba.
repeater ── BLE / USB ── meshcore-repeater-observer ──┬── MQTT ── komunitní analyzer
(observer build) └── MQTT ── vlastní broker / CoreScope
English: turns a MeshCore repeater into an observer by reading its console
(pktlog, rxlog, nodes) over BLE or USB and publishing to MQTT in the
meshcoretomqtt format. Docs below are Czech; --help is English.
Kdy to dává smysl
- Repeater už stojí (stožár, střecha) a vedle něj nejde nebo nechcete dát další rádio. Počítač s Bluetooth v dosahu, nebo USB kabel, stačí.
- Jinak je jednodušší samostatný observer na openHopu, který MQTT do analyzerů umí sám a repeater nechá na pokoji.
Co je potřeba
- Repeater s observer buildem firmwaru meshcore-tth:
soubory
*_repeater-observer-*v Releases (XIAO, SenseCAP Solar, RAK4631, T1000-E, Heltec T114). Nejjednodušší je webový flasher s.zippřes Custom Firmware, postup je v návodu k flashování. Běžný MeshCore firmware příkazypktlog/rxlognemá; observer pak feed tiše vynechá. - Linux s Pythonem 3.10+ (Raspberry Pi stačí), u BLE s BlueZ.
- Pro komunitní analyzer: repeater na českém nastavení (869,432 MHz / 62,5 kHz / SF7 / CR5) — komunita chce jen uzly na CZ presetu.
Instalace
pipx install git+https://git.rfa.cz/tth-pub/meshcore-repeater-observer
meshcore-repeater-observer --help
USB (doporučeno)
Repeater na USB kabelu; port najdete v ls -l /dev/serial/by-id/ (trvalé
jméno, /dev/ttyACM0 se po přepojení mění).
MC_SERIAL_PORT=/dev/serial/by-id/usb-…-if00 \
MC_OBS_ENABLE=1 MC_OBS_IATA=PRG \
meshcore-repeater-observer
USB se s rádiem repeateru nepere a čte se nepřetržitě.
Bluetooth
BLE konzole repeateru nemá vlastní přihlášení, chrání ji jen PIN. Ve
veřejném buildu je výchozí PIN 123456, který zná každý, takže nejdřív
vlastní PIN:
-
V USB konzoli
ble pin <6 číslic>(uloží se, přežije reboot i nový flash a zruší všechna dosavadní spárování), pakble on. S výchozím PINem firmwareble onodmítne.bleukážePIN own, samotný PIN nikdy. Releasy dotth-654d53f3včetněble pinnemají: tam Bluetooth nezapínejte a použijte USB. Advertising běží dál, i když je zapojené USB, ale připojit se může jen jeden — kdo drží spojení (telefon, jiný počítač), tohobleukáže jako(connected)a ostatním se repeater neukáže. -
Jednou spárujte (zadáte svůj PIN):
bluetoothctl agent KeyboardOnly default-agent scan on # počkejte na MAC repeateru pair AA:BB:CC:DD:EE:FF trust AA:BB:CC:DD:EE:FF quit -
Spusťte s
MC_BLE_ADDR=AA:BB:CC:DD:EE:FFmístoMC_SERIAL_PORT.
Observer se po každém vyčtení odpojí a MC_BLE_OFF_INTERVAL sekund (výchozí
120) počká: starší firmware s připojeným BLE klientem zahazoval přímé
(DIRECT) pakety, které měl přeposlat. V meshcore-tth je to opravené, interval
jde zkrátit; pokud log hlásí pktlog DROP, ring se během pauzy přepsal.
Jako služba (systemd)
# /etc/systemd/system/meshcore-repeater-observer.service
[Unit]
Description=MeshCore repeater observer
Wants=network-online.target bluetooth.target
After=network-online.target bluetooth.target
[Service]
EnvironmentFile=/etc/meshcore-repeater-observer.env
ExecStart=/opt/meshcore-repeater-observer/bin/meshcore-repeater-observer
StateDirectory=meshcore-repeater-observer
Restart=on-failure
RestartSec=30
[Install]
WantedBy=multi-user.target
V /etc/meshcore-repeater-observer.env řádky MC_…=… z tabulky níž.
StateDirectory drží pozici v ringu repeateru, takže restart nic neztratí.
Nastavení (proměnné prostředí)
| proměnná | výchozí | |
|---|---|---|
MC_SERIAL_PORT |
— | USB konzole repeateru (/dev/serial/by-id/…) |
MC_BLE_ADDR / MC_BLE_NAME |
— | BLE: MAC, nebo jméno, které repeater advertuje |
MC_NODE |
repeater |
jméno v lokálních MQTT tématech |
MC_OBS_ENABLE |
vypnuto | 1 = observer feed z pktlog |
MC_OBS_IATA |
— | povinné s feedem: kód letiště regionu (PRG, BRQ, OSR, …) |
MC_OBS_MQTT_HOST |
mqtt1.meshcore.cz |
broker feedu |
MC_OBS_MQTT_PORT / MC_OBS_TRANSPORT / MC_OBS_TLS |
443 / websockets / 1 |
|
MC_OBS_AUTH |
token |
token = JWT podepsaný klíčem uzlu; none = vlastní broker bez hesla |
MC_OBS_AUDIENCE |
= MC_OBS_MQTT_HOST |
audience v JWT; komunitní brokery chtějí svůj hostname |
MC_OBS_OWNER / MC_OBS_EMAIL / MC_OBS_MODEL |
— / — / MeshCore repeater |
volitelné údaje do tokenu a statusu |
MC_MQTT_HOST |
— | lokální MQTT (volitelné): stats, nodes, rxlog, kopie paketů |
MC_MQTT_PORT / MC_MQTT_TLS / MC_MQTT_USER / MC_MQTT_PASS |
1883 / — |
|
MC_MQTT_TOPIC |
repeater-observer/<MC_NODE> |
kořen lokálních témat |
MC_INTERVAL |
300 |
s mezi plným čtením (stats, senzory, sousedé) |
MC_NODES_INTERVAL / MC_RXLOG_INTERVAL |
60 / 5 |
registr nodes / vyčítání rxlog+pktlog |
MC_BLE_OFF_INTERVAL |
120 |
BLE: pauza bez spojení mezi vyčteními |
MC_CURSOR_FILE |
$STATE_DIRECTORY/cursors.json |
pozice v ringu repeateru |
Komunitní brokery: mqtt1.meshcore.cz, mqtt2.meshcore.website,
mqtt.meshcore-analyzer.eu (všechny WSS :443, JWT). Audience musí být
hostname brokeru — s jinou broker odpoví not authorised.
Vlastní CoreScope: MC_OBS_MQTT_HOST=<broker> MC_OBS_MQTT_PORT=1883 MC_OBS_TRANSPORT=tcp MC_OBS_TLS=0 MC_OBS_AUTH=none.
Klíč uzlu
Pro komunitní feed se observer přihlašuje tokenem podepsaným klíčem
repeateru, takže si při spojení přečte z konzole get prv.key. Klíč drží jen
v paměti procesu, nikam ho nezapisuje ani neloguje, a před použitím ověří, že
k němu patří veřejný klíč uzlu. S MC_OBS_AUTH=none se klíč nečte vůbec.
Co se publikuje
- Feed (
MC_OBS_ENABLE=1):meshcore/<IATA>/<PUBKEY>/packetsa…/statusve formátu meshcoretomqtt. - Lokálně (
MC_MQTT_HOST), podMC_MQTT_TOPIC:neighbours,stats,sensors,nodes(retained),rxlog,packets,ble/serialstav.
Observer navíc srovnává hodiny repeateru bez GPS (time <epoch>), když jsou
pozadu: starý čas v advertech by ostatní uzly zahazovaly jako replay.
Když to nejde
| příznak | příčina |
|---|---|
config: … a konec |
chybí transport (MC_SERIAL_PORT/MC_BLE_ADDR), IATA, nebo není kam publikovat |
BLE … nenalezen ve scanu |
repeater má BLE vypnuté (ble on), je k němu připojený někdo jiný (ble ukáže connected; shodí to ble off + ble on), nebo BlueZ visí na starém spojení: bluetoothctl disconnect <MAC> — nikdy remove, to zruší spárování |
FW nezná pktlog |
repeater nemá observer build |
broker odmítl spojení rc=5 |
špatná audience, nebo uzel není na CZ presetu |
pktlog DROP |
ring repeateru se přepsal dřív, než se vyčetl: kratší MC_BLE_OFF_INTERVAL, nebo USB |
Licence
MIT.