tthandClaude Opus 5.5 439d9e450a
ci / test (push) Successful in 1m49s
README: ble pin also over the mesh as admin
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 01:47:28 +01:00
2026-11-03 00:20:03 +01:00
2026-11-03 00:20:03 +01:00
2026-11-03 00:20:03 +01:00
2026-11-03 00:20:03 +01:00
2026-11-03 00:20:03 +01:00

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

  1. 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 .zip přes Custom Firmware, postup je v návodu k flashování. Běžný MeshCore firmware příkazy pktlog/rxlog nemá; observer pak feed tiše vynechá.
  2. Linux s Pythonem 3.10+ (Raspberry Pi stačí), u BLE s BlueZ.
  3. 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:

  1. V konzoli ble pin <6 číslic> — po USB, nebo přes rádio z aplikace, pokud jste na repeateru admin (remote CLI). PIN se uloží, přežije reboot i nový flash a zruší všechna dosavadní spárování. Pak ble on. S výchozím PINem firmware ble on odmítne. ble ukáže PIN own, samotný PIN nikdy. Releasy do tth-654d53f3 včetně ble pin nemají: 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č), toho ble ukáže jako (connected) a ostatním se repeater neukáže.

  2. 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
    
  3. Spusťte s MC_BLE_ADDR=AA:BB:CC:DD:EE:FF místo MC_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>/packets a …/status ve formátu meshcoretomqtt.
  • Lokálně (MC_MQTT_HOST), pod MC_MQTT_TOPIC: neighbours, stats, sensors, nodes (retained), rxlog, packets, ble/serial stav.

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.

S
Description
Observer feed and stats from a MeshCore repeater console over BLE or USB
Readme MIT
92 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 100%