Back to overview Guide

Adding a BM2 battery monitor to Home Assistant: your motorhome battery from anywhere

Reading time: 6 min
CampMatic

This article is also available in: Deutsch · Français · Español · Italiano · Polski · Čeština · Svenska · Nederlands

Adding a BM2 battery monitor to Home Assistant: your motorhome battery from anywhere

A BM2 battery monitor clamps onto the terminals of your leisure battery and reports voltage and state of charge over Bluetooth. That is fine while you are next to the motorhome. With the van in winter storage and Home Assistant at home, the display stays empty.

This article shows how the BM2 readings still get into your Home Assistant and which entities you end up with. The individual steps are in our Home Assistant guide.

The essentials

  • The route: a CampMatic box in the vehicle reads the BM2 over Bluetooth and sends the readings over WiFi or 4G via MQTT to your Home Assistant, wherever it runs.
  • What arrives: voltage and state of charge, plus signal strength if you want it.
  • Several batteries: up to four BM2 per box, for example for leisure and starter battery.
  • Cost: no subscription. App and server are free.

Why not straight over Bluetooth?

Home Assistant can only read Bluetooth sensors within radio range of its own Bluetooth hardware. If the motorhome or campervan is somewhere else, in winter storage, on a pitch or on the road, something in the vehicle has to read the monitor and pass the readings on.

That is the CampMatic box's job. It reads the BM2 in the vehicle and delivers the readings via MQTT to your Home Assistant. You also see them in the CampMatic app and on Telegram, even when Home Assistant is down.

What you need

  • A CampMatic box in the vehicle. Every box reads the BM2: CampMatic Guard (sensors only, for any camper, powered via USB), CampMatic for Truma CP Plus and CampMatic for Truma iNet X. Each box takes up to eight Bluetooth sensors, of which up to four battery monitors (Help).
  • A BM2 battery monitor for 12 V batteries (lead-acid, AGM, gel, LiFePO4). It is not included.
  • Home Assistant with admin access and the Mosquitto broker add-on.
  • Internet in the vehicle: WiFi for the WiFi variant, your own SIM card for the 4G variant (not included, IoT SIM from about €2 a month).

Getting the BM2 into Home Assistant

  1. Pair the BM2. Set the monitor up once with the manufacturer's BM2 app. Then, in the CampMatic app, go to Settings → Devices → Add device, choose the BM2 battery monitor and tap it in the list. Pairing happens in the CampMatic app, not in Home Assistant.
  2. Get your credentials. The Status page of the CampMatic app has the card “MQTT Bridge (Home Assistant)”; the Device Status block shows the Device ID (chapter 2).
  3. Set up Mosquitto. Install the add-on, create the folder /share/mosquitto and only then switch on customize (chapter 3).
  4. Create the bridge. The file /share/mosquitto/campmatic.conf connects your broker to ours. Restart the add-on; the log must show “Connecting bridge”. If you never want to switch anything from Home Assistant, use in instead of both (chapter 4).
  5. Read your slot number. In the MQTT integration, listen to campmatic/<GERAETE_ID>/+/config. In the bm2/config line, the number after slot belongs to your monitor. Slots run across all sensor types (chapter 8).
  6. Add the sensors. The ready-made BM2 sensors go into /config/packages/campmatic.yaml under mqtt: sensor:. Replace <GERAETE_ID> and <SLOT_BM2>, check the configuration, restart Home Assistant (chapter 10). You switch on the packages folder once, as described in chapter 6.

The guide puts the full run-through at about half an hour. All files are available there as a single download.

Which readings arrive

The topics follow the pattern campmatic/<GERAETE_ID>/bm2/monitor_<SLOT_BM2>/…. The names on the right come from our template:

ReadingTopic ends inSensor in the template
Voltage (V)voltageHouse Battery Voltage
State of charge (%)chargeHouse Battery Charge
Signal strengthrssiHouse Battery Signal (in the download package)

The state of charge is an estimate. A battery monitor measures voltage, not the energy actually stored. The percentage is derived from it and moves with the load: it drops under load and recovers after a few minutes of rest. For tracking over days, the voltage is the more honest figure. In the expected range it sits at roughly 12 to 14 V.

Readings usually arrive only every 6 minutes and are not buffered. If nothing arrives for 45 minutes, the templates show the sensor as “unavailable” instead of holding on to the last value.

Two values that are already there

You may spot two entries in Home Assistant that you never created. They keep their German names: Bordspannung (onboard voltage) and Bordbatterie Ladezustand (onboard battery charge). The box reports them through the automatic announcement, but only for the battery monitor with the lowest slot number.

  • One BM2: you can use these two values and skip your own sensors.
  • Several BM2: the two always show only the first one. Then create separate sensors for each monitor, once per slot number, for example “Starter Battery Voltage” next to “House Battery Voltage”.

Automation ideas

  • Battery running low: if the voltage stays below your threshold for a quarter of an hour, Home Assistant sends a message. Use the voltage, not the percentage, and a hold time so that short load peaks do not trigger an alarm. The threshold depends on the battery, for example 12.0 V for lead-acid and AGM, 12.8 V for LiFePO4.
  • Winter storage: the voltage history over days shows whether the battery is slowly draining.
  • Combine with interior climate: together with a RuuviTag you see battery and temperature on the same dashboard.

For a simple alert you do not need Home Assistant: the CampMatic app reports low onboard voltage via Telegram or email. Home Assistant pays off for your own rules and for linking the van to the rest of your home.

Dashboard and troubleshooting

The ready-made dashboard from chapter 14 has a “House Battery” group with voltage, state of charge and a history graph, with no extra cards.

If a value stays empty, one of these usually helps (chapter 15):

  • Empty reply on +/config: no sensor is paired. That happens in the CampMatic app.
  • A single sensor without a value: usually the wrong slot number. It can change after re-pairing.
  • Several sensors permanently “unavailable”: check whether mqtt: appears more than once in your package file.
  • New sensors without a value: do a genuine restart of Home Assistant. Reloading the configuration is not enough.

Frequently asked questions

BM2 or Victron SmartShunt?
The BM2 measures voltage. If you also want current and consumed amp-hours, use a Victron SmartShunt or BMV-712 Smart. CampMatic reads those too; for Home Assistant there is chapter 13.

I do not have a Truma heater.
Then CampMatic Guard is the right box: it monitors gas, leisure battery and interior climate but does not control a heater.

And the interior climate?
A RuuviTag gets into Home Assistant the same way: Adding a RuuviTag to Home Assistant.

→ CampMatic Guard · WiFi — €89

→ CampMatic Guard · 4G — €129

Further reading: