SystemAIR Home Assistant Integration v1.2.0
🎉 SystemAIR Home Assistant Integration v1.2.0
🎛️ Major New Feature: Base Operation Configuration
Dual Configuration Interface - Configure your SystemAIR ventilation unit's default operation settings through multiple intuitive methods:
✨ Configuration Entities (Quick Access)
Located in your device's Configuration section:
- 🔧 Default Operation Mode - Select from Auto, Manual, Crowded, Refresh, Fireplace, Away, Holiday
- 💨 Default Airflow Level - Choose Low (25%), Normal (50%), High (75%) for manual mode
- ⏱️ Duration Settings - All existing timed mode durations with proper units
🔄 Options Flow (Guided Setup)
Access via the Configure button in Settings → Devices & Services:
- Step-by-step configuration wizard
- Built-in validation and help text
- Same comprehensive settings as configuration entities
🆕 What's New
- Real-time Configuration Updates - Changes apply immediately
- Persistent Storage - Settings saved to Home Assistant configuration
- Visual Feedback - Proper icons and descriptions for all settings
- Dual Access Methods - Quick entity changes OR guided setup flow
- Enhanced User Experience - Intuitive interface design
🔧 Configuration Entities Added
| Entity | Type | Options | Description |
|---|---|---|---|
| Default Operation Mode | Select | Auto, Manual, Crowded, Refresh, Fireplace, Away, Holiday | Base ventilation mode |
| Default Airflow Level | Select | Low, Normal, High | Airflow level for manual mode |
| Holiday Mode Duration | Number | 1-30 days | Duration for holiday mode |
| Away Mode Duration | Number | 1-24 hours | Duration for away mode |
| Fireplace Mode Duration | Number | 1-120 minutes | Duration for fireplace mode |
| Refresh Mode Duration | Number | 1-120 minutes | Duration for refresh mode |
| Crowded Mode Duration | Number | 1-12 hours | Duration for crowded mode |
📋 Installation & Upgrade
- HACS Users: Update automatically to v1.2.0
- Manual Installation: Copy updated files to
custom_components/systemair/ - Existing Users: Configuration entities appear automatically after restart
🔄 Upgrade Notes
- Existing integrations get new configuration entities automatically
- No data migration required - existing settings preserved
- New installations include full configuration setup flow
🎯 Benefits
- Streamlined Setup - Configure everything in one place
- Flexible Control - Choose your preferred configuration method
- Better Organization - Settings grouped logically in device interface
- Enhanced Usability - Clear descriptions and validation
🛠️ Technical Details
- Configuration entities use proper EntityCategory.CONFIG
- Options flow supports multi-step configuration
- Real-time validation with user-friendly error messages
- Automatic config entry updates for persistence
📊 Complete Entity Overview
Your SystemAIR device now includes:
- Climate Control - Temperature and mode management
- Sensors - Temperatures, air quality, remaining time
- Controls - Operation mode and airflow selects
- 🆕 Configuration - Base operation settings and durations
- Services - Advanced control options
🔗 Requirements
- Home Assistant 2023.1 or later
- SystemAIR Home Solutions account
- SystemAIR ventilation unit connected to cloud service