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

This package holds every file from the guide at
https://campmatic.de/en/ha_tutorial/

Verified on 22 Sept 2026 with:
  Home Assistant OS        18.2
  Home Assistant Core      2026.9.2
  Supervisor               2026.09.2
  "Mosquitto broker" add-on 7.1.1  (Mosquitto 2.1.2)
  CampMatic firmware       1.28

Every step of the guide was carried out on a freshly installed system.
Nothing in it is written from memory.


CONTENTS
--------

campmatic.conf
    Bridge configuration for the Mosquitto add-on.
    Goes to /share/mosquitto/campmatic.conf
    -> guide chapter 4

campmatic-package-en.yaml
    All sensors: Truma replacement sensors, gas bottle (Mopeka),
    indoor climate (Ruuvi), house battery (BM2), Truma LevelControl,
    plus the hot water selector.
    Goes to /config/packages/campmatic.yaml
    -> guide chapters 6 to 11

campmatic-dashboard-en.yaml
    Ready-made dashboard, pasted into the raw configuration editor.
    Built-in cards only, no HACS needed.
    -> guide chapter 12


REPLACE BEFORE USE
------------------

All files contain placeholders in angle brackets. The brackets go away
when you replace them.

  <GERAETE_ID>       your three-digit device number
                     -> CampMatic app, Status page

  <NODE>             the device ID
                     -> CampMatic app, Status page, "Device Status" block
                     Not the device number and not the display name!

  <MQTT_USER>        username  -> CampMatic app, Status page
  <MQTT_PASSWORT>    password  -> CampMatic app, Status page

  <ENTITY>           the name fragment Home Assistant assigns
                     -> Developer tools > States, search for "truma"

  <SLOT_MOPEKA>      slot numbers of your Bluetooth sensors
  <SLOT_BM2>         -> chapter 7 explains how to read them
  <SLOT_RUUVI>
  <SLOT_TRUMALC>


THE FIVE THINGS THAT TRIP PEOPLE UP
-----------------------------------

1. The folder /share/mosquitto must exist BEFORE you switch on the
   add-on's customize option. Otherwise the add-on refuses to start.

2. In campmatic-package-en.yaml, "mqtt:" may appear only ONCE, and so
   may "template:". With several blocks only the last one counts and all
   other sensors vanish silently — with no error message.

3. Without the line "topic homeassistant/+/<NODE>/# in 0" in
   campmatic.conf, NOT A SINGLE entity is created, even though every
   value arrives.

4. New sensors only show up after a real restart of Home Assistant.
   Reloading the configuration is not enough.

5. Slot numbers for the Bluetooth sensors run consecutively across all
   sensor types, not per type. They cannot be guessed.


Questions? https://campmatic.de/en/help
