Home Assistant integration for HAVEN IAQ

The HAVEN Room Air Monitor can now publish indoor air quality data directly to Home Assistant over your local network. Once connected, you’ll see seven sensors (CO2, PM2.5, PM10, NOx Index, VOC Index, temperature, humidity) that update once per minute and can be charted, automated, and combined with the rest of your smart-home setup.

This guide walks through the full setup.

Before you start

You’ll need:

• A Room Air Monitor that’s powered on and already set up in the HAVEN app.
• The HAVEN app on version 5.12.7 or later (App Store / Google Play).
• A running Home Assistant instance you can sign in to.
• The Mosquitto broker app installed in Home Assistant.

The Home Assistant connection requires Room Monitor firmware V16 or later. V16 is already rolled out to all online devices, so most users have nothing to do. If you’re setting up an older Room Monitor that hasn’t been online before, the HAVEN app will check the firmware version when you open the Home Assistant settings and will wait for the device to update to V16 before letting you continue. No action needed on your end — just let it finish.

Install the Mosquitto broker in Home Assistant

Install the official Mosquitto broker app (LocalMQTT broker):

1. In Home Assistant, go to Settings → Apps → Install App.
2. Search for Mosquitto broker and select it.
3. Click Install, then Start. Toggle Start on boot on.

Create a Home Assistant user for the Room Monitor

Best practice is to create a dedicated user that the Room Monitor will use to talk to the broker.

1. Go to Settings → People → Users → Add User.
2. Name it something like haven-monitor.
3. Set a strong password and save it — you’ll enter it in the HAVEN app in the next step.

Open the Room Monitor settings in the HAVEN app

1. Open the HAVEN app on your phone.
2. Make sure Bluetooth is on, the app connects to the Room Monitor directly over Bluetooth for this step.
3. Tap your Room Air Monitor, then open its settings.
4. Find the Home Assistant section.

Enter your Home Assistant connection details

In the Home Assistant section, fill in:

• Toggle — tap the toggle button to enabled (it is disabled by default).
• Host — the local IP address or hostname of your Home Assistant instance (for example, 192.168.1.42 or homeassistant.local). This is the URL you use to log in to HA.
• Port —  this defaults to 1883 and can be changed in the Mosquitto broker app in HA.
• Username — the user you created above (e.g. haven-monitor).
• Password — the password you set for that user.

Confirm the device appears in Home Assistant

1. In Home Assistant, go to Settings → Devices & Services.
2. Open the MQTT integration. You should see the Room Air Monitor listed as a discovered device.
3. Click into it to see the seven sensors.

What you’ll see

Once connected, these entities will appear in Home Assistant:

• HAVEN CO2 (ppm)
• HAVEN Humidity (%)
• HAVEN NOx Index
• HAVEN PM2.5 Mass (µg/m³)
• HAVEN PM10 Mass (µg/m³)
• HAVEN Temperature (°C)
• HAVEN VOC Index

Each updates once per minute. Home Assistant will record history locally on whatever hardware hosts your instance (Raspberry Pi, NUC, etc.). From there you can build dashboards, combine HAVEN data with other devices, and trigger automations on air quality changes.

Troubleshooting

• Nothing shows up in Home Assistant. Confirm the Mosquitto broker app is running, the username and password in the app match the user you created, and the host and port are reachable from the Room Monitor’s network.
• The app config won't save. Make sure all four fields (host, port, username, password) are filled in.
• Bluetooth won’t connect to the monitor. Stay within a few feet of the monitor, force-quit and reopen the HAVEN app, and try again.