A complete fix for the Home Assistant MELCloud integration that provides perfect swing/vane control for Mitsubishi air conditioners.
🎯 Features
✅ ALL vertical swing positions working (auto, 1-5, swing)
✅ ALL horizontal swing positions working
✅ Perfect vane position control with real device values
✅ Complete original MELCloud functionality preserved
✅ Smart fallback system for devices without position feedback
✅ Reverse-engineered device compatibility for accurate control
🚀 Installation
- Via HACS (Recommended)
- Open HACS in Home Assistant
- Go to Integrations
- Click menu (⋮) → Custom repositories
- Add: https://github.com/brouwerict/ha-melcloud-swing-fix
- Category: Integration
- Click Add
- Search for "MELCloud with Swing Fix"
- Install the integration
- Restart Home Assistant
- Remove original MELCloud integration if present
- Add MELCloud Fixed integration in Settings → Integrations
- Manual Installation
- Copy the custom_components/melcloud_fixed folder to your Home Assistant config/custom_components/ directory and restart.
⚙️ Configuration
Use the same MELCloud credentials as the official integration. No additional configuration needed!
🎉 What You Get
- Perfect swing control - All positions work flawlessly
- Reliable operation - No more "invalid position" errors
- Future-proof - Based on actual device values, not guesswork
- Drop-in replacement - Same interface as official integration
🔍 Technical Details
This fix was achieved through:
- Reverse engineering MELCloud device communication
- Real device testing to discover actual position strings
- Proper fallback mapping for devices without API position feedback
- Extensive validation of all swing positions