CampMatic — Home Assistant
==========================

Dieses Paket enthält alle Dateien aus der Anleitung unter
https://campmatic.de/ha_tutorial/

Geprüft am 22.09.2026 mit:
  Home Assistant OS        18.2
  Home Assistant Core      2026.9.2
  Supervisor               2026.09.2
  Add-on Mosquitto broker  7.1.1  (Mosquitto 2.1.2)
  CampMatic-Firmware       1.28

Jeder Schritt der Anleitung wurde an einer frisch aufgesetzten Installation
durchgespielt. Was in der Anleitung steht, haben wir selbst gesehen.


INHALT
------

campmatic.conf
    Bridge-Konfiguration für das Mosquitto-Add-on.
    Kommt nach /share/mosquitto/campmatic.conf
    -> Anleitung Kapitel 4

campmatic-package.yaml
    Alle Sensoren: Truma-Ersatzsensoren, Gasflasche (Mopeka),
    Innenklima (Ruuvi), Bordbatterie (BM2), Truma LevelControl,
    sowie die Warmwasser-Auswahl.
    Kommt nach /config/packages/campmatic.yaml
    -> Anleitung Kapitel 6 bis 11

campmatic-dashboard.yaml
    Fertiges Dashboard. Wird im Rohen Konfigurationseditor eingefügt.
    Benutzt nur mitgelieferte Karten, kein HACS nötig.
    -> Anleitung Kapitel 12


VOR DEM EINSPIELEN ERSETZEN
---------------------------

In allen Dateien stehen Platzhalter in spitzen Klammern. Die spitzen
Klammern fallen beim Ersetzen weg.

  <GERAETE_ID>       deine dreistellige Gerätenummer
                     -> CampMatic-App, Status-Seite

  <NODE>             die Geräte-ID
                     -> CampMatic-App, Status-Seite, Block "Gerätestatus"
                     Nicht die Gerätenummer und nicht der Anzeigename!

  <MQTT_USER>        Benutzername  -> CampMatic-App, Status-Seite
  <MQTT_PASSWORT>    Passwort      -> CampMatic-App, Status-Seite

  <ENTITY>           Namensteil, den Home Assistant vergibt
                     -> Entwicklerwerkzeuge > Zustände, nach "truma" suchen

  <SLOT_MOPEKA>      Platznummern deiner Bluetooth-Sensoren
  <SLOT_BM2>         -> Anleitung Kapitel 7 erklärt, wie du sie ausliest
  <SLOT_RUUVI>
  <SLOT_TRUMALC>


DIE WICHTIGSTEN STOLPERSTEINE
-----------------------------

1. Der Ordner /share/mosquitto muss existieren, BEVOR du im Add-on die
   Option customize einschaltest. Sonst startet das Add-on nicht mehr.

2. In campmatic-package.yaml darf "mqtt:" nur EINMAL vorkommen, ebenso
   "template:". Stehen sie mehrfach da, gilt nur der letzte Block und alle
   anderen Sensoren verschwinden lautlos — ohne Fehlermeldung.

3. Ohne die Zeile "topic homeassistant/+/<NODE>/# in 0" in campmatic.conf
   entsteht KEINE EINZIGE Entität, obwohl alle Werte ankommen.

4. Neue Sensoren erscheinen erst nach einem echten Neustart von Home
   Assistant. Konfiguration neu laden genügt nicht.

5. Die Platznummern der Bluetooth-Sensoren laufen fortlaufend über alle
   Sensortypen hinweg, nicht je Typ. Sie lassen sich nicht erraten.


Fragen? https://campmatic.de/hilfe
