# 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](https://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](https://github.com/openhop-dev/openhop_repeater), který MQTT do analyzerů umí sám a repeater nechá na pokoji. ## Co je potřeba 1. **Repeater s observer buildem** firmwaru [meshcore-tth](https://git.rfa.cz/tth-pub/meshcore-tth): soubory `*_repeater-observer-*` v [Releases](https://git.rfa.cz/tth-pub/meshcore-tth/releases) (XIAO, SenseCAP Solar, RAK4631, T1000-E, Heltec T114). Nejjednodušší je [webový flasher](https://flasher.meshcore.io) s `.zip` přes **Custom Firmware**, postup je v [návodu k flashování](https://git.rfa.cz/tth-pub/meshcore-tth#flashing-a-release). 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 ```bash 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í). ```bash 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) ```ini # /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/` | 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= 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///packets` a `…/status` ve formátu [meshcoretomqtt](https://github.com/Cisien/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 `), 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 ` — **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.