Toon MQTT

Lokale MQTT-koppeling voor een geroot Eneco/Quby Toon 2. De app toont een tegel op Toon, publiceert de beschikbare thermostaat-, klimaat-, ketel- en energiegegevens en accepteert bedienings- en meterwaarden via MQTT.

Versie 1.2.3 is bedoeld voor installatie via de TSC Store. Na installatie plaatst de app zelf de achtergrondservice en opstartkoppeling; er zijn op Toon geen handmatige SSH-commando's nodig.

Mogelijkheden

• Instellen vanaf de tegel: broker, poort, gebruikersnaam, wachtwoord, basistopic en publicatie-interval. Een nieuwe installatie begint met gewone MQTT, zonder afhankelijkheid van een domoticasysteem.
• Keuze uit Standaard MQTT, Home Assistant, Domoticz en openHAB. Automatische discovery-instellingen verschijnen alleen bij Home Assistant; de andere profielen gebruiken het gedocumenteerde standaard MQTT-contract.
• Home Assistant MQTT Discovery voor sensoren, een echte climate-thermostaat, schakelaars, instellingen en energie-injectie.
• Publicatie van onder meer temperatuur, luchtvochtigheid, TVOC/eCO2, thermostaatstatus, setpoint, ketelmodulatie, beschikbare OpenTherm-data en energiegegevens.
• Bediening van setpoint, preset, weekprogramma, tapwater- en cv-instellingen.
• Injectie van actueel verbruik, teruglevering, kWh-tellerstanden en de gasmeterstand in Toons normale interne meterketen.
• Veilige grenscontroles, een monotone-tellerbeveiliging en automatische nulstelling van verouderde live vermogenswaarden.

Een Toon 2 meet geen fijnstof met de standaard binnenklimaatsensor. Indien aanwezig worden TVOC en de geschatte CO2-waarde gepubliceerd.

Installatie

Wanneer de app in de TSC Store is opgenomen:

1. Open de TSC Store op Toon en installeer Toon MQTT.
2. Voeg de tegel toe.
3. Open de tegel, vul de brokergegevens in en druk op Opslaan.
4. Gebruik Test verbinding om broker en aanmelding te controleren.

De MQTT-configuratie wordt op Toon bewaard in /mnt/data/tsc/toon-mqtt.json. Het wachtwoord staat daar leesbaar in en moet daarom een afzonderlijk lokaal MQTT-account met beperkte rechten zijn.

Updates en verwijderen

Een normale update via de ToonStore bewaart de bestaande MQTT-configuratie, inloggegevens, integratiekeuze en energiestatus. De installer maakt alleen een nieuwe standaardconfiguratie wanneer nog geen configuratiebestand bestaat.

Verwijderen via de ToonStore is bewust anders: dit stopt de daemon en wist alle door Toon MQTT beheerde servicekoppelingen, runtimebestanden, configuratie en inloggegevens. Een latere herinstallatie begint daardoor weer met de neutrale standaardinstellingen voor gewone MQTT.

Reeds door Toon opgeslagen meetgeschiedenis wordt niet gewist. Alleen de actuele geïnjecteerde verbruiks- en productiewaarden worden bij verwijderen op nul gezet.

Energie vanuit Home Assistant

De app ontvangt live vermogen in W en tellerstanden in kWh of m³. Voor Home Assistant is een instelbare blueprint meegeleverd; voor andere systemen staan generieke voorbeelden in docs/ENERGY_INJECTION.md.

De belangrijkste topics zijn:

toon/voorbeeld/inject/power_w
toon/voorbeeld/inject/production_w
toon/voorbeeld/inject/import_low_kwh
toon/voorbeeld/inject/import_high_kwh
toon/voorbeeld/inject/export_low_kwh
toon/voorbeeld/inject/export_high_kwh
toon/voorbeeld/inject/gas_total_m3

Zie docs/TOPICS.md voor alle state-, set- en injectietopics.

Documentatie

• docs/HOME_ASSISTANT.md
• docs/ENERGY_INJECTION.md
• docs/SENSORS_AND_CONTROL.md
• docs/TOPICS.md
• docs/ARCHITECTURE.md
• docs/TSC_STORE.md

Ontwikkelen

De QML-bestanden staan in de repositoryroot. De achtergrondservice staat in daemon/ en wordt als statische ARMv7-binary meegeleverd:

./scripts/build.sh

Voor een release moeten version.txt, toonstore.cfg, de Go-constante version, Changelog.txt en het TSC-catalogusfragment dezelfde versie hebben.

Licentie en logo

De broncode valt onder de MIT-licentie. drawables/MqttLogo.svg is het MQTT woord-/beeldmerk van OASIS; zie de opmerkingen in dat bestand en gebruik het in overeenstemming met het merkbeleid van OASIS.