-
-
Notifications
You must be signed in to change notification settings - Fork 3
Configuration Walkthrough
This walkthrough is for a normal Home Assistant install where Humidity Intelligence is already installed and you are setting it up through the integration UI.
The exact form labels can change between releases. Treat this page as the practical manual, not the config-flow source of truth. If this page and the current README or integration UI disagree, trust the current release and open a documentation issue.
Have these ready:
- humidity sensors
- temperature sensors
- optional air-quality sensors
- optional presence, alarm, time, or manual gate entities
- optional fan, purifier, humidifier, ventilation, or alert-light outputs
- a rough idea of which rooms belong to each level or zone
Use stable, readable room labels. The labels are not just decoration; they help the reason panel, diagnostics, and generated dashboards stay understandable.
Humidity Intelligence setup is deliberately staged:
- frontend dependency awareness
- global gates
- telemetry inputs
- temperature slope
- zones
- humidifiers
- air quality
- alerts
- dashboard and post-configuration workflow
Essentials stay visible first. Expert controls sit in advanced sections so a normal setup does not become a wall of tuning fields.
This step helps you understand which optional Lovelace cards Home Assistant can see.
Optional frontend cards can improve presentation, but they must not block the backend control engine. If Home Assistant cannot inspect Lovelace resources, treat that as a UI support signal, not as proof that runtime control is broken.
Global gates decide whether Humidity Intelligence is allowed to act.
Common examples:
- time windows
- presence or alarm state
- manual pause
- outside action behavior
- target profile mode
Start with recommended defaults unless you already know the home needs a different control window or target profile.
Important: gates are visible runtime truth. If a gate blocks control, the reason panel and generated dashboard should say so.
Telemetry is where HI learns what the home is doing.
At minimum, configure humidity and temperature sensors for active levels. Add air-quality telemetry only where you have suitable Home Assistant entities.
For each sensor, keep these stable:
- entity
- type
- level
- room label
Assign every sensor to a level and room, even if you mostly care about whole-house averages. That gives HI better context for diagnostics, generated cards, and alert source explanation.
Temperature slope helps HI understand direction, not just a static reading.
Most users should let HI calculate slope from configured temperature sensors. Use provided slope sensors only when those entities are already stable and trusted in Home Assistant.
The optional temperature chip row is a display choice. It should show backend comfort and slope truth; it should not invent thresholds in the dashboard.
Zones connect environmental problems to output behavior.
A useful zone has:
- a readable label
- a level
- assigned rooms
- trigger context
- configured outputs
- normal and boost output stages where relevant
Boost should normally be stronger than the normal zone stage. Normal correction handles routine imbalance. Boost is for higher-priority escalation such as condensation, mould-risk, or humidity danger.
Enable humidifier lanes only where you have real humidifier hardware.
Humidifier behavior is independent from the selected ventilation lane. That separation is intentional. Ventilation and humidification should not fight each other through hidden dashboard logic.
Enable air quality only where you have suitable telemetry and outputs.
Supported AQ telemetry can include indoor air quality, PM2.5, VOC, CO2, and CO, depending on what the current release and your configured Home Assistant entities provide.
AQ is below emergency and moisture-risk lanes in the priority order. If a higher priority issue is active, normal AQ response may wait.
Alerts are not free-form automation triggers. Humidity, mould, condensation, and carbon-monoxide behavior is derived from HI telemetry and risk logic.
Where an alert can be resolved to a room and zone, HI can use the configured zone boost path. If the source cannot be mapped safely, HI should explain the degraded state rather than boosting blindly.
After setup:
- confirm the integration loads in Settings -> Devices & services
- check the main HI entities
- open the generated dashboard
- run the supported card export or refresh flow if needed
- download diagnostics if anything looks off
For UI-specific symptoms, see Troubleshooting Generated UI.
For support reports, see Getting Help.