About
Haier hOn - addhOn is a Marketplace integration that connects Haier, Candy and Hoover appliances from the hOn app to Home Assistant. It discovers the appliances paired to an hOn account and exposes them through the vendor's cloud, with sign-in handled in the UI, including two-factor verification and a password-only prompt when the session expires. Entities cover climate, fans, water heaters, sensors, switches, selects, numbers, buttons, dates and times, with controls such as start and stop program, target temperatures and spin speed. An option adds experimental entities based on incomplete evidence, and the heat-pump water heater only gets its water heater entity and boost switch when it is on. Actions allow a forced cloud refresh, log level changes for diagnostics, and writing eco schedules on supported heat-pump water heaters. Polling runs at a fixed interval of 60 seconds, and a diagnostics download and repair notices are available.
Automatic summary of the README and code of tis24dev/addhOn. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Climate
- Water heaters
- Fans
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Sign in with your hOn account
- Password
- Collect sign-in diagnosticsIf sign-in fails, record detailed sanitized technical information in the Home Assistant log. Credentials, tokens, and personal data are not included.
Two-factor verification
- Verification code
- Resend code
Re-authenticate your hOn account
- Password
- Collect sign-in diagnosticsIf sign-in fails, record detailed sanitized technical information in the Home Assistant log. Credentials, tokens, and personal data are not included.
After setup
- Enable debug loggingRaise this integration's log level to DEBUG (sign in, device discovery, polling, commands). Turn off to return to Home Assistant's configured level. MQTT realtime noise stays suppressed unless its own toggle is on.
- Enable MQTT realtime debugMake the MQTT realtime channel very verbose. Normally keep this off; it only covers this integration's MQTT logger, not the underlying AWS IoT libraries (use Home Assistant's logger config for those).
- Enable experimental entitiesAdd entities whose meaning is based on incomplete evidence: they may be wrong, may be renamed, and may disappear again. They stay unavailable for any reading that has not been confirmed. Changing this reloads the integration.
Texts from the code of tis24dev/addhOn.
Entities
- Binary sensorsDoor, Door locked, Paused, Automatic detergent dosing, Automatic softener dosing, Child lock, Compressor heating, Electric heating, Boost, and 71 more
- ButtonsStart program, Stop program, Apply daily use, Apply extra cold, Apply extra cold (water), Apply extra ice, Apply high efficiency, Apply special food, Refresh now, and 2 more
- DatesVacation start, Vacation end
- FansPurifier, Hood
- NumbersZone 1 target temperature, Zone 2 target temperature, Zone 3 target temperature, Zone 4 target temperature, Upper zone target temperature, Lower zone target temperature, Target temperature, Oven temperature, Delayed start, and 6 more
- SelectsProgram, Aroma, Panel light, My Zone mode, Spin speed, Temperature, Dry level, Temperature level, Soil level, and 7 more
- SensorsStatus, Remaining time, Total cycles, Total water used, Total energy used, Current energy use, Current water use, Program, Phase, and 112 more
- SwitchesBoost, Scheduled sterilization, Sleep mode, Mute, Eco, Rapid, Health, Self-clean, Self-clean 56°C, and 41 more
- TimesSterilization time
- Water heatersWater heater
Actions
- Refresh nowForce an immediate cloud poll for all configured hOn accounts. The automation-callable equivalent of the per-device "Refresh now" button: it asks every loaded coordinator to fetch fresh data right away, instead of waiting for the next scheduled poll. Takes no options and applies to the whole integration.
- Set diagnostic log levelChange the log level of the Haier hOn integration and the native hOn client loggers used to diagnose login, device discovery, reauth and polling. Use "debug" when devices do not appear, then return to "warning" to reduce noise. Does not enable MQTT realtime noise: for that use the dedicated set_mqtt_log_level service.Fields: Level
- Set MQTT log levelChange the log level of the hOn MQTT realtime channel. By default the reconnect-attempt noise is silenced (warning). Set "debug" to diagnose realtime push problems, then "warning" to silence it again. Not persistent: it returns to silenced after a Home Assistant restart.Fields: Level
- Set eco scheduleHeat-pump water heater: write the eco windows the way the hOn app does (the scheme, then the days, then the windows; an unchanged scheme or unchanged days are not sent again), one step at a time, each confirmed by the appliance before the next one, about 15 seconds per step. Only in Eco mode, with the experimental option on, on the m7 and m8 series.Fields: Scheme, Days, Windows, Other windows
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:The fridge program dropdown has been replaced
From the README
- Automatic device discovery — discovers all paired Haier devices in your account
- Multiple device support — AC units, washing machines, and other hOn-compatible appliances
- Real-time status — monitors device state, temperature, modes, and cycle progress
- Command execution — control HVAC modes, set temperatures, start/stop programs, and more
- Asyncio optimization — dedicated background loop for reliable API communication
- Smart attribute mapping — device-specific attribute keys extracted from real diagnostics
- Full Lovelace support — integrates seamlessly with Home Assistant UI and automations
- Two-factor authentication (2FA) — Two-factor authentication during the login process is supported
- Multilingual integration — Currently available in Italian and English, with additional languages available upon request.
Shows in Vulpo
Quick Toggle card, Climate card, Fan card, Button card, Apple Watch, Control Center, Climate Live Activity.Information
- Installs
- 271 sharing analytics
- GitHub stars
- 41
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v5.28.0,
- Category
- Appliances and cleaning
- Kind
- Marketplace integration
- Brand
- Haier
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
addhon- Issues
- Report an issue
