Climate
AUX Cloud
maeek/ha-aux-cloud · vV2.0.0
HACSCloud push
Home assistant integration for Aux Cloud connected appliances (AC Freedom)
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
climate | Thermostat | |
sensor | Sensor (temperature, humidity, air quality…) | |
water_heater | Water heater (as a thermostat) | |
select | Mode picker (as switches) |
What people report
Cloud-only control of AUX air conditioners and heat pumps; newer heat pump models and cloud outages cause unavailable entities.
- Works5
- Partly works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| AUX Freedom air conditioner | Works Cloud | Listed supported; cloud control onlySaved copySupported devices: AUX Freedom air conditioner, model AUX-12F2H/I; AUX heat pump, model ACHP-HO8/4R3HA-I; Standard air conditioners: c0620000, 2a4e0000, 7faf0000, 82af0000; Half-degree air conditioner: 1f620000; Air conditioners without auto mode and with extended fan levels: 28620000,; Multi-split air conditioner: 45620000 (no auto mode or power-limit controls); VRV air conditioners: 56ac0000, a44e0000 (vertical swing and conservative; Air-conditioner sub-device: c9100100 (limited safe parameter set); Heat pumps: c3aa0000. Limitations: Logging in the App: The login process in the app may … Excerpt saved from the README on 2026-10-23. | README | |
| AUX heat pump ACHP-HO8/4R3HA-I | Works Cloud | Listed supported; cloud control onlySaved copySupported devices: AUX Freedom air conditioner, model AUX-12F2H/I; AUX heat pump, model ACHP-HO8/4R3HA-I; Standard air conditioners: c0620000, 2a4e0000, 7faf0000, 82af0000; Half-degree air conditioner: 1f620000; Air conditioners without auto mode and with extended fan levels: 28620000,; Multi-split air conditioner: 45620000 (no auto mode or power-limit controls); VRV air conditioners: 56ac0000, a44e0000 (vertical swing and conservative; Air-conditioner sub-device: c9100100 (limited safe parameter set); Heat pumps: c3aa0000. Limitations: Logging in the App: The login process in the app may … Excerpt saved from the README on 2026-10-23. | README | |
| AUX multi-split air conditioner (45620000) | Works Cloud | Listed; no auto mode or power-limit controlsSaved copySupported devices: AUX Freedom air conditioner, model AUX-12F2H/I; AUX heat pump, model ACHP-HO8/4R3HA-I; Standard air conditioners: c0620000, 2a4e0000, 7faf0000, 82af0000; Half-degree air conditioner: 1f620000; Air conditioners without auto mode and with extended fan levels: 28620000,; Multi-split air conditioner: 45620000 (no auto mode or power-limit controls); VRV air conditioners: 56ac0000, a44e0000 (vertical swing and conservative; Air-conditioner sub-device: c9100100 (limited safe parameter set); Heat pumps: c3aa0000. Limitations: Logging in the App: The login process in the app may … Excerpt saved from the README on 2026-10-23. | README | |
| AUX standard air conditioner (product c0620000) | Works Cloud | Climate and switch entities tested on this modelSaved copyFixed climate entity - tested all functions and it works on my model (productId = `000000000000000000000000c0620000`) - Tested heat pump related entities - Added switch entities for most if not all available options - Added select entity for heat pump quiet mode - Switched formatting to Black instead of autopep8 - Updated README with current state and future roadmap ideas - Updated consts Air conditioners: Heat pump: <im Excerpt saved from GitHub on 2026-10-23. | PR #10 · 2025-04 | |
| AUX VRV air conditioners (56ac0000, a44e0000) | Works Cloud | Listed; vertical swing and conservative profileSaved copySupported devices: AUX Freedom air conditioner, model AUX-12F2H/I; AUX heat pump, model ACHP-HO8/4R3HA-I; Standard air conditioners: c0620000, 2a4e0000, 7faf0000, 82af0000; Half-degree air conditioner: 1f620000; Air conditioners without auto mode and with extended fan levels: 28620000,; Multi-split air conditioner: 45620000 (no auto mode or power-limit controls); VRV air conditioners: 56ac0000, a44e0000 (vertical swing and conservative; Air-conditioner sub-device: c9100100 (limited safe parameter set); Heat pumps: c3aa0000. Limitations: Logging in the App: The login process in the app may … Excerpt saved from the README on 2026-10-23. | README | |
| AUX air conditioner (cloud dropouts) | Partly works Cloud | AC card repeatedly goes unavailable until integration is reloadedSaved copyHi , I have seen this issue happen too, it seems that it fails to get info from AUX cloud, some logs attached: Today when I saw this happen I went to the integration configuration and removed the affected AC. Then when trying to add it again had 3 failures to connect to the API. Can they be throtling? ``` [31m2025-08-15 10:37:09.094 ERROR (MainThread) [custom_components.aux_cloud] Error fetching AUX Cloud Coordinator data: Error updating AUX Cloud data: 'TypeError' object is not iterable[0m [31m2025-08-15 11:18:56.100 ERROR (MainThread) [custom_components.aux_cloud] Error fetching AUX Cloud … Excerpt saved from GitHub on 2026-10-23. | Issue #41 · 2025-08 | |
| AUX heat pump ACHP-H14/5R2HA-M(NE) (c3aa0000) | Not working Cloud | Data fetch errors, entities unavailable on v1.0.10; owner says newer deviceSaved copyI got AUX Heat pump (ACHP-H14/5R2HA-M(NE) I paired it successfully with AC Freedom app. This is info from AC Freedom: {"Data Cloud":"Europe","MAC":"e8:70:72:40:13:87","DID":"00000000000000000000e87072401387","SDK":"2.17","Software upgrade":" ","Dealer Authorization Code":" ","Firmware Version":"v56011","PID":"000000000000000000000000c3aa0000","Hardware version":"v000000ff00000000"} In home assistant I'm receiving following error while initialising integration: This error originated from a custom integration. Logger: custom_components.aux_cloud.api Source: … Excerpt saved from GitHub on 2026-10-23. | Issue #54 · 2025-12 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud push
Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.
Details
| Installs (analytics) | 894 (0.13%) |
|---|---|
| GitHub stars | 88 |
| Latest version | V2.0.0 (2026-10-20) |
| Set up in the UI | Yes |
| Maintainers | @maeek |
| License | MIT |
Devices listed in its README
- AUX Freedom air conditioner, model AUX-12F2H/I
- AUX heat pump, model ACHP-HO8/4R3HA-I
- Standard air conditioners: c0620000, 2a4e0000, 7faf0000, 82af0000
- Half-degree air conditioner: 1f620000
- Air conditioners without auto mode and with extended fan levels: 28620000,
- Multi-split air conditioner: 45620000 (no auto mode or power-limit controls)
- VRV air conditioners: 56ac0000, a44e0000 (vertical swing and conservative
- Air-conditioner sub-device: c9100100 (limited safe parameter set)
- Heat pumps: c3aa0000
Limitations from the README
- Logging in the App: The login process in the app may invalidate existing sessions (at least on Android). The integration attempts automatic re-login when the cloud reports an expired session. If recovery fails, reload or reconfigure the integration.
- AUX Cloud API unavailable: If an account-wide refresh fails with an HTTP 5xx response, the integration reports entities unavailable, retries automatically, and shows a notification that clears after recovery. It intentionally does not create a Repairs issue because a vendor outage requires no user action.
- Shared device identity: AUX endpoint IDs are used unchanged for device identifiers. A cloud account exposing the same endpoint more than once is deduplicated.
- Offline devices: Audited product profiles keep entity membership stable while a device is offline; its entities report unavailable until live state returns.
- This is cloud control only. Local LAN control is not implemented.
- Device support is profile-based. Unknown product IDs may appear without entities until a profile is added.
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/maeek/ha-aux-cloud
- Source code: https://github.com/maeek/ha-aux-cloud
- Issues: https://github.com/maeek/ha-aux-cloud/issues
- HACS: https://hacs.xyz
