Releases: pymitsubishi/homeassistant-mitsubishi
Releases · pymitsubishi/homeassistant-mitsubishi
v0.4.0
Home Assistant Mitsubishi Integration v0.1.8 - Test Coverage & CI Improvements
🎯 Test Coverage & CI Improvements
This release focuses on achieving complete test coverage and improving CI reliability.
✅ Testing Improvements
- 100% Test Coverage: All modules now have complete test coverage (1002/1002 statements)
- 212 Tests Passing: Comprehensive test suite covering all functionality
- Fixed Test Fixtures: Restored missing test fixtures and helper functions
- Improved Mocking: Better async mocking for more reliable tests
🔧 CI/CD Enhancements
- GitHub Actions Verified: All workflows tested and passing
- Pre-commit Hooks: All quality checks passing (ruff, mypy, yaml validation)
- Python 3.12-3.13 Support: Full compatibility across Python versions
📋 Quality Standards
- PROJECT_RULES.md Compliance: Meets all project quality requirements
- Code Quality: PEP 8 compliance, type hints, proper documentation
- Zero Technical Debt: Clean codebase ready for production
🏠 Home Assistant Integration
- Manifest Validation: All integration requirements verified
- Entity Coverage: Complete test coverage for all entity types
- Configuration Flow: Fully tested setup and options flows
This release ensures the integration meets the highest quality standards with complete test coverage and robust CI/CD processes.
Home Assistant Mitsubishi Integration v0.1.7 - Unified Command Execution
🚀 Major Improvements
Centralized Command Execution with Unified Timing
This release fixes the long-standing issue where device commands would cause UI flickering and apparent rejections due to race conditions with stale device state.
Key Changes:
- 🔧 Unified Command Logic: All device commands now use a centralized method in the base class
- ⏱️ Consistent 4-Step Process: Every command follows the same reliable pattern:
- Request change - Send command to device via pymitsubishi
- Sleep 2 seconds - Wait for device to process (based on empirical testing)
- Fetch latest status - Get fresh data from device
- Update internal state - Refresh Home Assistant coordinator state
Fixed Issues:
- ❌ UI Flickering: Temperature changes no longer revert briefly before updating
- ❌ Race Conditions: Eliminated stale state updates immediately after commands
- ❌ Code Duplication: Removed duplicate command execution logic across files
Affected Entities:
- Climate: Temperature, HVAC mode, fan speed, swing mode, power on/off
- Number: Dehumidifier level adjustments
- Select: Vertical vane, horizontal vane, power saving mode
Technical Details:
- Based on timing tests showing Mitsubishi devices need ~1.8 seconds to process commands
- All entities now inherit from for consistent behavior
- Comprehensive logging with emoji indicators for easy debugging
- Automatic debug mode enabled for all pymitsubishi calls
Dependencies:
- Locked pymitsubishi version: Now requires exactly (changed from )
- Ensures consistent behavior with tested library version
📋 Full Changelog:
- Add centralized method to base class
- Update all command-issuing entities to inherit from
- Remove duplicate command execution implementations
- Implement empirically-tested 2-second delay for device processing
- Add comprehensive logging for command execution flow
- Lock pymitsubishi dependency to specific version 0.1.8
- Fix race condition causing UI state reversions
🧪 Testing:
This release has been tested with real Mitsubishi MAC-577IF-2E devices and shows significant improvement in command reliability and UI responsiveness.
📦 Installation: Update through HACS or manually replace the integration files.
🐛 Issues: Report any problems at https://github.com/pymitsubishi/homeassistant-mitsubishi/issues
Home Assistant Mitsubishi v0.1.4 - Reconfiguration Support
Major New Feature: Reconfiguration Support
New Features
- Added Options Flow Integration for post-setup reconfiguration
- Users can now change IP address, encryption key, and other settings via HA UI
- Automatic validation and integration reload after configuration changes
- Consolidated translations into strings.json for better maintainability
Improvements
- Enhanced error handling in options flow
- Better user experience - no need to remove/re-add integration for settings changes
- Comprehensive pytest test coverage for options flow functionality
Bug Fixes
- Fixed Home Assistant deprecation warning for config_entry access
- Updated to use proper private _config_entry attribute
How to Reconfigure
- Go to Settings → Devices & Services
- Find your Mitsubishi Air Conditioner integration
- Click Configure button
- Update settings and submit - integration validates and reloads automatically
This release significantly improves user experience by enabling easy reconfiguration!
Home Assistant Mitsubishi v0.1.3 - Energy Monitoring Support
🔋 Energy Monitoring Support
This release adds comprehensive energy monitoring capabilities to the Mitsubishi Home Assistant integration, powered by pymitsubishi 0.1.7.
✨ New Features
Energy Monitoring Sensors
- Total Energy - Overall energy consumption tracking
- Cooling Energy - Energy used in cooling mode
- Heating Energy - Energy used in heating mode
- Auto Mode Energy - Energy used in auto mode
- Dry Mode Energy - Energy used in dry/dehumidify mode
- Fan Mode Energy - Energy used in fan-only mode
All energy sensors include proper device class, state class, and unit conversion from Wh to kWh.
SwiCago-Inspired Enhanced Sensors
- Compressor Frequency - Real-time compressor frequency in Hz
- Estimated Power - Estimated power consumption in watts
- Mode Raw Value - Raw mode value in hex format for debugging
- Temperature Mode - Temperature parsing mode (Direct/Segment)
Enhanced Binary Sensors
- i-See Sensor Active - Motion detection status
- Operating Status - Real-time operating state
- Wide Vane Adjustment - Vane adjustment activity
🛠️ Code Quality Improvements
Code Optimization
- Created module to reduce code duplication
- Refactored repeated patterns with utility functions
- Improved code maintainability and readability
- Consolidated state checking logic
Testing Excellence
- 193 total tests (18 new tests for utils module)
- 100% test coverage across all modules
- Enhanced test suite for SwiCago and energy sensors
- Mandatory coverage enforcement in CI/CD
Quality Assurance
- Fixed all linting issues with ruff
- Improved type annotations
- Updated PROJECT_RULES.md with coverage requirements
- Clean code architecture following DRY principles
🧪 Testing & Validation
- ✅ All unit tests passing with 100% coverage
- ✅ Integration tested on real Home Assistant instance
- ✅ All entities creating and updating properly
- ✅ Data coordinator working flawlessly (30-second intervals)
- ✅ No errors or warnings in HA logs
📦 Dependencies
- Requires for energy monitoring support
- Compatible with Home Assistant 2025.1.0+
🔄 Upgrade Instructions
- Update the integration files in your directory
- Restart Home Assistant
- New energy and enhanced sensors will appear automatically
- Check Developer Tools → States to verify all entities are working
📊 Technical Details
- 18 total sensors now created per device
- 5 binary sensors including enhanced SwiCago sensors
- Energy sensors use state class for HA Energy dashboard
- Diagnostic sensors properly categorized with
- State attributes include comprehensive device information
This release represents a major enhancement to the integration, providing detailed energy monitoring and advanced diagnostic capabilities while maintaining code quality and reliability.
Home Assistant Mitsubishi v0.1.2 - Energy Monitoring Support
🆕 New Features
- Energy Monitoring Sensors: Added compressor frequency and estimated power consumption sensors
- Enhanced Diagnostic Sensors: Added i-See sensor status, mode raw value, and temperature mode sensors
- SwiCago Integration: Leverages advanced parsing from SwiCago heat pump project for detailed diagnostics
🔧 Improvements
- Backward Compatibility: Gracefully handles both pymitsubishi 0.1.6 and 0.1.7+ versions
- Robust Error Handling: Fixed coordinator to handle missing device capabilities gracefully
- Consistent Data Access: All sensors now use coordinator data for improved reliability
- Enhanced Device Info: Better device identification and capability detection
🐛 Bug Fixes
- Fixed 'ParsedDeviceState object has no attribute energy' error
- Fixed sensor availability issues when device capabilities are missing
- Improved sensor data consistency and error handling
📋 Requirements
- pymitsubishi >= 0.1.7 (for full energy monitoring features)
- Home Assistant >= 2025.1.0
🏠 Available Entities
New Energy Monitoring:
- Compressor Frequency (Hz) - Shows actual compressor operation
- Estimated Power Consumption (W) - Real-time power usage estimate
- Operating Status (binary) - Active heating/cooling indicator
Enhanced Diagnostics:
- i-See Sensor Active (binary) - Motion detection status
- Mode Raw Value (sensor) - Debug information for troubleshooting
- Temperature Mode (sensor) - Direct vs segment parsing mode
- Wide Vane Adjustment (binary) - Advanced vane control status
Existing Features:
- Full climate control (temperature, mode, fan speed)
- Temperature sensors (room, outdoor)
- Vane direction controls (vertical left/right, horizontal)
- Dehumidifier level control
- Power saving mode
- Unit diagnostic information (firmware, WiFi, device info)
🔧 Installation
- Download and extract to
- Restart Home Assistant
- Go to Settings → Devices & Services → Add Integration
- Search for "Mitsubishi Air Conditioner" and configure with your device IP
The energy monitoring features provide valuable insights into your air conditioner's operation and power consumption, perfect for energy management and troubleshooting.
Release v0.1.1
What's Changed
- Improved test coverage to 100%
- Enhanced CI/CD pipeline with Python 3.12 and 3.13 support
- Added comprehensive linting and type checking
- Updated GitHub Actions workflows
- Migrated default branch from master to main
- Cleaned up repository by removing system files and build artifacts
- Fixed manifest validation and pre-commit hooks
Technical Improvements
- Complete test coverage across all modules
- Robust error handling and edge case testing
- Modern Python version support (3.12+)
- Clean repository structure with proper .gitignore
- Automated quality checks in CI/CD
This is a maintenance release focused on code quality, testing, and development workflow improvements.
Home Assistant Mitsubishi v0.1.0 - Initial Release with Full Diagnostics
🎉 Initial Release - Home Assistant Mitsubishi Integration v0.1.0
✨ Features
- Complete Home Assistant Integration for Mitsubishi MAC-577IF-2E WiFi adapters
- Climate Control with full HVAC functionality (heating, cooling, fan, dry modes)
- Temperature Sensors for room and outdoor temperature monitoring
- Advanced Controls including vane direction, fan speeds, and dehumidifier settings
- Error Monitoring with comprehensive error status reporting
🔍 Comprehensive Diagnostics
- Unit Information - Complete device details and specifications
- Firmware Version - App, release, flash, boot, and platform versions
- Unit Type - Device type with manufacturing information
- WiFi Information - Signal strength, channel, and communication status
- All diagnostic sensors properly categorized in Home Assistant
🎨 User Experience
- Official Mitsubishi Electric Logo for professional appearance
- GUI Configuration via Home Assistant config flow
- Device Registry Integration with comprehensive device information
- Entity Categories properly organized (diagnostic, config, etc.)
🔧 Technical Features
- 100% Test Coverage with comprehensive test suite
- DataUpdateCoordinator for efficient polling and state management
- Error Handling with graceful degradation and recovery
- Admin Credentials Support for accessing protected device endpoints
📋 Supported Entities
- Climate: Main thermostat control
- Sensors: Temperature, humidity, error status, unit diagnostics
- Binary Sensors: Power state, error conditions
- Selects: Mode, fan speed, vane directions
- Numbers: Temperature setpoints, dehumidifier levels
🔗 Dependencies
- pymitsubishi >= 0.1.6 for latest unit info and diagnostic features
- Home Assistant 2025.1.0+ for modern integration standards
🚀 Installation
Install via HACS or manually copy to custom_components/mitsubishi/
This release provides a complete, production-ready Home Assistant integration with comprehensive diagnostic capabilities.