Skip to content

v1.3.1 MELCloud with Swing Fix

Choose a tag to compare

@brouwerict brouwerict released this 11 Aug 16:08
· 24 commits to main since this release

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