MaxSmart (Revogi) Integration v2025.8.1
🚀 MaxSmart Integration v2025.8.1
User Experience focused release with manual IP configuration, automatic IP change detection, and enhanced multilingual support. This version prioritizes user-friendly features while maintaining rock-solid reliability.
✨ What's New in v2025.8.1
🎯 Major User Experience Improvements
- 🌐 Manual IP Configuration - Add IP field in device settings with real-time connection validation
- 🔄 Automatic IP Change Detection - Seamless reconfiguration when device IP changes (i.e. DHCP lease renewal)
- 📝 Clearer Log Messages - Simplified, actionable messages with clean 3-message cycle format
- 🌍 Enhanced Language Support - Added Spanish and Italian translations (5 languages total: EN, FR, DE, ES, IT)
🔧 Technical Improvements
- 📱 Improved Device Information - Cleaner device details display with essential info (IP, Serial Number, MAC address)
- 🛡️ Enhanced Error Handling - Better error management with network cascade detection to reduce log noise
- ⚡ Silent Migration - Seamless upgrade from existing devices with zero user intervention required
- 🔧 Simplified Configuration - Streamlined config entries and cleaned up configuration forms
🐛 Bug Fixes
- Fixed device name placeholder in IP change confirmation dialogs (all languages)
- Removed unnecessary "ID Method" field from device configuration forms
- Improved migration compatibility between versions
- Enhanced MAC address handling for better device identification
🚀 MaxSmart Integration v2025.7.1
Major overhaul release with complete architecture refactoring, Home Assistant native name management, and enhanced hardware identification. This version completely rebuilds the integration while preserving all your existing configurations.
✨ What's New in v2025.7.1
🎯 Major User Experience Improvements
- 🏷️ Home Assistant Name Management - Device and port names managed entirely in HA, editable on-the-fly
- ⚡ Near Real-time Consumption - Live power monitoring every 5 seconds for responsive automation
- 🔄 In-place Migration - Seamless upgrade from older versions with zero downtime
🔧 Technical Improvements
- 🛡️ Enhanced Hardware Identification - CPU ID, MAC address, and serial number tracking for rock-solid device identification
- 📊 Improved Discovery System - Automatic hardware ID retrieval and device fingerprinting
- 🏗️ Modular Architecture - Separated coordinator, entity factory, and migration systems for better maintainability
- ⚡ Adaptive Polling System - Smart polling that mimics official app behavior with burst mode after commands
⚡ Enhanced Power Monitoring
- Real-Time Data - Live power consumption updates every 5 seconds
- Auto-Format Detection - Supports different firmware watt formats automatically
- Improved Accuracy - Better data conversion and validation
- Smart Icons - Dynamic icons based on power consumption levels
🛡️ Enterprise-Grade Reliability Revolution
The previous error handling was catastrophic - we've completely rebuilt it from the ground up!
- Intelligent Error Detection - Comprehensive error classification and handling
- Smart Retry Logic - Exponential backoff with network-aware recovery
- Clear Error Messages - User-friendly messages instead of cryptic technical errors
- Automatic Recovery - Self-healing connections and automatic reconnection
- Bulletproof Validation - All inputs validated with proper security controls
- Zero-Crash Design - Isolated error boundaries prevent integration failures
- Diagnostic Tools - Built-in health monitoring and connectivity diagnostics
🎨 Better User Experience
- Simplified Setup - Streamlined configuration flow
- Clear Entity Names - Consistent, readable entity naming
- Easy Customization - Improved device and port renaming interface
- Enhanced Discovery - More reliable device detection on network
🔧 What's Fixed
🚨 Critical Error Handling Overhaul
Previous versions had catastrophic error handling - we've completely rebuilt the entire system!
- Log Pollution Eliminated - Smart error filtering stops unnecessary warnings
- Clear Error Messages - User-friendly messages replace cryptic technical errors
- Network Resilience - Robust retry logic with exponential backoff
- Connection Recovery - Automatic reconnection and session management
- Input Validation - Comprehensive security controls prevent crashes
🐛 Legacy Bug Fixes
- Entity Duplication - Fixed duplicate entities on upgrades
- Master Switch Issues - Removed incorrect master entities on 1-port devices
- Discovery Failures - Multiple fallback methods for reliable device detection
- Memory Leaks - Proper resource cleanup and session management
- State Inconsistencies - Real-time state synchronization and validation
🔄 Migration Improvements
- Preserved unique_id - Prevents device duplication during upgrades
- Smart Device Matching - Multiple identification methods for reliable migration
- Graceful Fallbacks - Handles offline devices during migration
- Clean Entity Registry - Removes obsolete entities automatically
📊 Data & Performance
- Faster Polling - Optimized data fetching intervals
- Memory Efficiency - Reduced resource usage with connection pooling
- Better Error Recovery - Automatic reconnection on network issues
- Consistent Data Format - Unified power measurement handling
🏗️ Technical Improvements
🎯 Architecture Overhaul
- Modular Design - Clean separation of concerns with mixins
- Entity Factory Pattern - Centralized entity creation logic
- Enhanced Coordinator - Improved data coordination and error handling
- Modern Python - Full async/await architecture throughout
🔒 Security & Stability
- Input Validation - Comprehensive parameter validation
- Session Management - Proper HTTP session cleanup
- Error Boundaries - Isolated error handling prevents crashes
- Resource Cleanup - Automatic resource management
📝 Code Quality
- Type Hints - Full typing support for better development experience
- Documentation - Comprehensive inline documentation
- Testing - Enhanced error handling with built-in diagnostics
- Maintainability - Cleaner, more modular codebase
🆙 Upgrading
From v1.x
Your existing setup will be automatically migrated:
- Install Update - Use HACS or manual installation
- Restart Home Assistant - Triggers automatic migration
- Check Notification - Confirm migration success
- Verify Entities - All your devices should work as before
What Happens During Upgrade
- ✅ Preserves all settings - Device names, port names, configurations
- ✅ Maintains automations - All existing automations continue working
- ✅ Cleans up entities - Removes incorrect entities for 1-port devices
- ✅ Enhances reliability - Better error handling and connectivity
- ✅ Shows notification - Confirms successful migration
Rollback (if needed)
If you encounter issues:
- Remove the integration from Settings → Devices & Services
- Install previous version
- Restart Home Assistant
- Re-add integration
📋 Requirements
System Requirements
- Home Assistant 2023.6.2 or newer
- Python 3.7+ (automatically managed)
- Network Same network as MaxSmart devices
Supported Devices
| Device | Firmware | Support Level | Test Status |
|---|---|---|---|
| MaxSmart Power Station (6-port) | v1.30 |  |
 |
| MaxSmart Smart Plug (1-port) | v1.30 | |
|
| MaxSmart Devices | v2.11+ |  |
|
| Other Compatible Models | Various |  |
 |
🤝 Expand Our Device Support!
If you have MaxSmart devices with different firmware versions, please contact us to help test and ensure full compatibility. We're actively seeking testers for expanded device support!
🆕 New Dependencies
Updated Dependencies
- maxsmart >= 2.0.3 (Python library with enhanced features)
- aiohttp (for efficient async HTTP communication)
All dependencies are automatically managed by Home Assistant.
🔮 What's Next
Planned for v2025.8.x
- Historical Statistics - Long-term power consumption tracking
- Advanced Automation - Enhanced triggers and conditions
- Energy Dashboard - Integration with HA Energy features
- Device Groups - Logical grouping of multiple devices
Community Requests
- Schedule Management - Built-in scheduling features
- Power Limits - Configurable consumption thresholds
- Export Features - Data export capabilities
📞 Support & Feedback
Getting Help
- 📖 Documentation - Updated comprehensive guide
- 🐛 Bug Reports - GitHub Issues
- 💬 Discussions - GitHub Discussions
- 📧 Direct Contact - For urgent issues
Contributing
We welcome community contributions:
- 🧪 Testing - Help test new features
- 📝 Documentation - Improve user guides
- 🔧 Code - Submit bug fixes and features
- 🌍 Translation - Add language support
🙏 Acknowledgments
Special thanks to:
- Community testers who provided valuable feedback
- @altery for original protocol reverse engineering
- MaxSmart library contributors for the enhanced Python module
- Home Assistant team for the excellent platform
📥 Installation Links
- HACS: Search for "MaxSmart" in HACS integrations
- Manual: Download Latest Release
- Documentation: Full Setup Guide
Happy automating! 🏠⚡