mibato-signalk-plugin

Beta. Deze plugin werkt tegen de beta-omgeving van Mibato (https://beta.mibato.app). Functioneel compleet en stabiel, maar nog geen productie-release. Pairing-codes, opgeslagen data en API-contracten kunnen tijdens de testfase nog wijzigen. Een productie-release volgt zodra mibato.app live is.

Mibato-plugin voor SignalK. Slaat lokaal vaartuigdata op en synct die naar je Mibato-account op beta.mibato.app.

Installeren

In de SignalK-admin UI:

1. Server → Appstore → Available — zoek op Mibato en klik Install.
2. Server → Restart.

Of handmatig vanaf de commandline op je SignalK-server:

cd ~/.signalk
npm install mibato-signalk-plugin

Daarna SignalK herstarten.

Koppelen

1. Server → Plugin Config → Mibato → Active aanzetten → Submit.
2. Open http://<jouw-signalk-host>:3000/plugins/mibato-signalk-plugin/pair. Hier verschijnt een koppelcode in de vorm MIB-XXXXXXXX.
3. Open de Mibato-app, ga naar de boot en kies SignalK koppelen. Voer de code in. Status flipt automatisch naar Gekoppeld in beide schermen.

Tokens worden langlevend opgeslagen in de plugin-data-dir van SignalK. Loskoppelen kan via de pairing-pagina of via Loskoppelen in de app.

Privacy & data

• Welke SignalK-paden worden gelogd: positie, SOG, COG, heading (true en magnetisch), STW (speed through water), depth, wind (apparent en true), en watertemperatuur.
• Naar waar gaat de data: https://beta.mibato.app/api/ingest over HTTPS.
• Geen inbound: de plugin opent geen poorten en accepteert geen verbindingen van buitenaf. Alle communicatie is uitgaand en door de plugin geïnitieerd.
• Lokale buffer: een SQLite-bestand in de plugin-data-dir bewaart samples ~14 dagen na bevestigde sync, zodat een offline-passage geen data verliest.
• Device-token: een langlevend access-token wordt na koppeling lokaal opgeslagen. Het is alleen geldig voor ingest van jouw boot en server-side intrekbaar.
• Geen PII: samples bevatten alleen vaartuigwaarden, geen identificerende gegevens. Het device-fingerprint dat bij koppeling wordt gestuurd is een hash van hostname + willekeurige bytes en niet teruggeleid naar persoonlijke identiteit.

Troubleshooting

• Plugin niet zichtbaar na install — Server → Restart.
• NODE_MODULE_VERSION-mismatch bij start — Node-versie van SignalK verschilt van die waaronder better-sqlite3 gebouwd is. Fix: cd ~/.signalk && npm rebuild better-sqlite3 onder dezelfde Node als SignalK gebruikt.
• Status blijft op "Niet gekoppeld" — controleer of https://beta.mibato.app bereikbaar is en of de plugin-config het juiste server-veld heeft staan.
• Koppelcode niet zichtbaar — ververs de pairing-pagina. Codes verlopen na 10 minuten en worden automatisch vernieuwd.
• Geen sync (status toont 0 posities) — wacht de push-interval af of kijk in het SignalK-server-log op regels die met mibato sync: beginnen.

Voor ontwikkelaars

git clone https://github.com/barhee77/mibato-signalk-plugin
cd mibato-signalk-plugin
npm install
npm test         # unit-tests
npm run harness  # synthetische zeildag door de downsample-pijplijn

Lokaal tegen je eigen SignalK-server testen:

cd ~/.signalk
npm install /pad/naar/mibato-signalk-plugin

Daarna SignalK herstarten — wijzigingen in de plugin-source worden bij elke restart opgepikt (symlink-install).

better-sqlite3 compileert native. Bij build-fouten: sudo apt install build-essential python3.