This project is a simple integration of the amazing work absalom-muc has done with his project MHI-AC-Ctrl.
It's supposed to simplify the Home Assistant setup, while giving you OTA and auto-discovery with virtually zero effort and no MQTT needed, powered by ESPHome.
MHI-AC-Ctrl-core.* files were forked directly, with no modification, whereas your WiFi credentials should go into the *.yaml file, and mhi_ac_ctrl.h is the core of the integration.
Create a new device within ESPHome and combine the yaml with example.yaml, rename example_ac and example-ac and install!
Most newer MHI units (the ones supporting the WF-RAC WiFi module) support fine grained vane control for Left/Right and Up/Down.
When your log is flooded with mhi_ac_ctrl_core.loop error: -2 errors after updating to the newer code, please change your yaml file to include the legacy file instead of the large_framesize.yaml.
Currently the MHI code allows for more fine grained fan direction than esphome climate supports. for that, additional template parts are added.
There are 8 modes for Left/Right: Left, Left/Center, Center, Center/Right, Right, Wide, Spot and Swing
There are 5 modes for Up/Down: Up, Up/Center, Center/Down, Down and Swing
Setting swing from the esphome climate now fully works. It will store the oldvanes mode, and configure swing. after disabling swing (either vertically, horizontally or off), the old settings will be restored. Manually changing modes for Left/Right or Up/Down will update the climate state as well.
Climate Quiet was added to ESPhome, so QUIET was added. ordering still needs work (ginkage#22 (comment)) Added the solution for the auto mode from: ginkage#22 (comment): CLIMATE_FAN_DIFFUSE in fan speed and status sections and reshuffle the numbers and add CLIMATE_FAN_DIFFUSE to the traits.set_supported_fan_modes
Has now 5 different fan modes but I'm not sure if the auto mode works proper, keep testing.
v3.0 (2024-08)
- Breaking change: moved all files to component and allow for easy install, thanks to @XMaarten and https://github.com/hberntsen/mhi-ac-ctrl-esp32-c3
- When you are upgrading from v2.1 or older, and experience compile errors, please see ginkage#100 (comment) for manual cleanup steps
- Manually downloading the files to your Home Assistant setup is no longer needed
- Legacy or Large framesize files are merged again
v2.1 (2024-03)
- Breaking change: Cleaned up conf files
- Add restart button
- Update Home Assistant naming convention
- Enable energy dashboard usage
v2.0 (2024-01)
- Based on absalom-muc v2.8 (September 2023)
- Breaking change in YAML configuration (need to set frame_size in globals)
- Added legacy support configurable from YAML (removing 3d auto and vanes LR control)
[W][component:237]: Component MhiAcCtrl took a long time for an operation (52 ms).
[W][component:238]: Components should block for at most 30 ms.
This is because esphome now alerts for slow components, to ignore this warning you can configure logging for components to ERROR, this will suppress the WARNING
# Enable logging
logger:
level: INFO
baud_rate: 0
logs:
component: ERRORSee ginkage#61 for more information
You probably have an older version of the Airco unit which doesn't support the newer, larger framesize.
You can to change the frame_size in the yaml to 20 to disable newer functionality.
when framsize is set to 20, 3D auto, and vane Left / Right doesn't work, vane Up / Down works limited.
All other features should work fine.
This project is licensed under the MIT License - see the LICENSE file for details.
(TL;DR: Do whatever you want with the code, no warranty given, give credit where it's due.)