Healthbox 3 Integration for Home Assistant
Integration to integrate with healthbox.
DISCLAIMER
This is still a work in progress. If time permits, I'll try to push this to HACS or Home Assistant Core.
Known Issues
- Missing Branding
Installation
HACS
HACS (Manual)
- Launch HACS
- Navigate to the Integrations section
- Click the three dots at the top right
- Custom Repositories
- Enter the Repository URL: https://github.com/rmassch/healthbox-hacs
- Select Category -> Integration
- Click Add
- Close the modal
- The integration should show up as a new repository, if not, search "Renson Healthbox" in "Explore & Download Repositories"
- Click the integration & Download
- Restart Home Assistant
Home Assistant
- Go to Settings -> Devices & Services
- Click on the "+ Add Integration" button at the bottom-right
- Search for the "Renson Healthbox" integration
- Select the Renson Healthbox integration
- Enter the Host IP & API Key (if applicable)
- Submit
Configuration
Options
This integration can only be configured through the UI, and the options below can be configured when the integration is added.
| key | default | required | description |
|---|---|---|---|
| host | none | yes | The IP of the Healthbox 3 device |
| api_key | none | no | The API key if you want advanced API features and sensors enabled |
API Key
The API key can be requested through the Renson support. They will give you the key if you send an e-mail to service@renson.be and mention your device serial number.
(See: https://community.home-assistant.io/t/renson-healthbox-3-0/52983/57)
Sensors
By default:
- Global Air Quality Index
- Serial Number
- Warranty Number
- Boost Level per room
- Boost Time Remaining and Status
- Airflow Ventilation Rate
- Device Fan Power measurements
- Profile
If the API key is provided this integration will enabled the advanced API features which will expose the following sensors per room (if available):
- Temperature
- Humidity
- Air Quality Index
- CO2 Concentration
- Volatile Organic Compounds
Services
Start Room Boost
| parameter | type | required | description |
|---|---|---|---|
| device_id | str | yes | The Healthbox 3 Room Device |
| boost_level | int | yes | The level you want to boost to. Between 10% and 200% |
| boost_timeout | int | yes | The boost duration in minutes |
Stop Room Boost
| parameter | type | required | description |
|---|---|---|---|
| device_id | str | yes | The Healthbox 3 Room Device |