Chapter 15
Troubleshooting
The things people actually trip over, sorted by what you see. Each one says what causes it and what helps.
No entity is created
Every reading arrives, yet no device in Home Assistant
By far the most common case. The announcement line is missing from the bridge file, or the device ID in it is misspelled:topic homeassistant/+/<NODE>/# in 0Check the spelling against the Device ID in the CampMatic app and restart the Mosquitto add-on afterwards. Saving alone will not do — the file is only read at startup.
The line is right and still nothing
Your CampMatic announces its entities when it connects. Disconnect the box from power briefly; on its next start it announces everything again. Sensors stay empty
Several sensors permanently read "unavailable"
First check whether the word mqtt: appears more than once in your campmatic.yaml. YAML allows each key only once — with several blocks only the last one counts and every sensor listed before it disappears.The nasty part: the configuration check reports no error, the entities stay visible, and when you listen in you can see the values arriving. People then search for a long time in the wrong place.
Correct is: one
mqtt:, one template:, everything else as a list beneath them. Shortly after a restart
Right after restarting the add-on or Home Assistant the Bluetooth values are missing for a few minutes. They are not buffered and only arrive when the sensor next transmits. This sorts itself out — unlike the case above. After adding new sensors
New MQTT sensors only appear after a genuine restart of Home Assistant. Reload the configuration instead and you will see them listed, but permanently without a value. A single sensor without a value
Then the slot number is usually wrong. Read it again with campmatic/<GERAETE_ID>/+/config — it can change when a sensor is paired afresh. The gas scale shows no level
If Gas Scale Level reads "unknown", Gas Scale State tells you why — zeroing needed or battery flat, for instance. You fix both at the scale or in the Senso4s app.If instead every sensor of the scale reads "unavailable", it is not transmitting. First check whether the Senso4s app is still connected to it — as long as it is, your CampMatic hears nothing. Close the app; the readings return within a few minutes. More in the chapter Gas scale (Senso4s).
The Victron charger delivers no readings
If every sensor of the charger reads "unavailable", check what the Solar Charger Reception sensor says — or listen to campmatic/<GERAETE_ID>/victron/status and read the value behind st for your slot number:key — the key does not match. Copy it again in VictronConnect and enter it afresh in the CampMatic app.off — Instant Readout is switched off in the charger. Switch it back on in VictronConnect under Product info.If both are fine and still nothing arrives, check whether VictronConnect is still connected to the charger. Close the app and wait a few minutes. More in the chapter Solar charger (Victron).
The heating cards are empty
Truma Heizung and Truma Wasser read "unavailable"
This is known and not your doing. While the heating is off the box sends nan as the setpoint, which Home Assistant cannot handle. The fix is the replacement sensors from chapter 6. After that you use the Hot Water selector instead of the automatically created card. Hot water cannot be set to 80 degrees
Quite right — for hot water the Truma only knows off, 40 and 60 degrees. That the automatically created card offers 80 is a display fault. The selector from chapter 6 offers only the three real options. Vario Heat: which heat levels actually exist
A Vario Heat has exactly two levels. Home Assistant labels them Eco and High, the heater itself calls them Night and Auto — same thing, different wording.There is no Boost on a Vario Heat. Up to firmware 1.30 the level could still be selected; the heater then refused it and the control panel was left showing „APP". Since firmware 1.34, Boost has been removed for all heaters.
Also fixed: up to firmware 1.29 the automatically created Truma Heizung card showed the fan mode permanently as „off", even while heating. From 1.30 on it shows the correct value.
The control panel shows „APP" and nothing responds any more
The panel is waiting for data from the CampMatic. This happens when the heater refused a command — for instance a level your model does not have. The CampMatic then re-registers on its own, and from firmware 1.31 that takes only seconds.If it stays that way, restarting the CampMatic does not help — the state sits in the panel, not in the box. Disconnect the CP Plus from power for ten seconds; both sides then start over cleanly.
Entities were briefly „unavailable" without you doing anything
That may have been a restart from our side. A watchdog on our server restarts the CampMatic when its link to the heater gets stuck. It takes roughly 20 to 30 seconds, then everything is back; your settings and schedules are kept.A command sent at exactly that moment can get lost — just send it again.
Careful with the MQTT broker fields
Home Assistant also creates text fields for your CampMatic such as MQTT Broker Host, MQTT Username and MQTT Password. They are writable, and whatever you put there survives a restart.Change them by accident and the box no longer reaches our server: app, alerts and schedules stop working. You can undo it through the box's own web interface. Best disable those entities in Home Assistant if you do not need them — likewise the fields that show passwords in clear text.
Small things
The log keeps showing "Protocol error from ::1"
Harmless. That is the watchdog checking whether the broker responds. It appears in the log for as long as the add-on runs. Setpoint temperatures read "unknown"
Normal while heating and boiler are off. There simply is no setpoint then. The add-on will not start any more
If you have just switched on customize: the folder /share/mosquitto must exist beforehand. Without it the add-on quits immediately and only shows stopped. The log then says Unable to open include_dir. An entity is named differently than expected
Home Assistant strips diacritics: ü becomes u, ä becomes a. Since your device reports its entity names in German, "Truma Lüftermodus" ends up as select.<ENTITY>_truma_luftermodus. Copy entity names from Developer tools → States rather than typing them. "Yield Today" still shows yesterday's value after midnight
Quite right. The Victron charger only resets today's yield at the next sunrise, not at midnight. The energy dashboard still counts correctly. Values only arrive now and then
The Bluetooth sensors transmit at intervals from seconds to minutes depending on type. On top of that it depends on the radio path — with the vehicle far away or metal in between, readings come in less often. You can display the signal strength of each sensor as a diagnostic value.
Still stuck?
- Get in touch through the contact form on the help page — ideally telling us which chapter you are stuck on and what the Mosquitto add-on log says.