🎉 Philips Air Purifier Integration v0.27.0
This release introduces comprehensive custom services support and adds an official MIT license to the project, significantly expanding the functionality and automation capabilities of the integration.
✨ What's New
🔧 Custom Services Framework
This release introduces 7 powerful custom services that provide advanced control and automation capabilities:
🔄 Filter Management
filter_reset: Reset filter life counters and maintenance schedules- Support for multiple filter types (pre-filter, HEPA, carbon, NanoProtect)
- Automatic maintenance schedule reset
- Perfect for post-filter replacement workflows
🎯 Sensor Calibration
calibrate_sensors: Calibrate air quality sensors for accurate readings- Support for PM2.5, allergen index, gas, and TVOC sensors
- Multiple calibration modes (auto, manual, factory reset)
- Manual calibration with reference values
💡 Display Control
set_display_brightness: Advanced display brightness management- Brightness control (0-100%)
- Auto-dimming based on ambient light
- Night mode with configurable time schedules
- Perfect for bedroom and quiet environments
📅 Maintenance Scheduling
schedule_maintenance: Automated maintenance reminder system- Multiple maintenance types (filter replacement, sensor calibration, deep cleaning)
- Configurable reminder intervals (1-365 days)
- Advanced notification system with customizable advance warnings
- Maintenance notes and documentation
🔒 Child Safety
set_child_lock: Enhanced child lock management- Programmatic control of child lock settings
- Integration with automation systems
⏰ Timer Control
set_timer: Advanced timer functionality- Flexible duration settings (0.5-24 hours)
- Multiple post-timer actions (turn off, sleep mode, auto mode)
- Energy-saving automation capabilities
🔄 Device Reset
reset_device: Comprehensive device reset options- Soft reset, factory reset, and network reset modes
- Safety confirmation requirements
- Troubleshooting and maintenance support
📜 Enhanced Documentation
- Comprehensive Service Schemas: Detailed YAML definitions for all services
- Rich Field Descriptions: Clear explanations and examples for all service parameters
- UI Integration: Full Home Assistant UI support with selectors and validation
- Service Documentation: Complete
services.yamlwith 290+ lines of detailed specifications
🏆 Quality Improvements
- Silver Quality Scale: Added official Home Assistant quality scale assessment
- Quality Scale Documentation: Comprehensive 200+ line quality assessment file
- Enhanced Manifest: Updated with quality scale and improved metadata
📜 Legal & Licensing
- MIT License: Added official MIT license for open-source compliance
- Clear Licensing Terms: 201-line comprehensive license file
- Commercial and Personal Use: Permissive licensing for all use cases
🛠️ Technical Enhancements
📊 Service Architecture
- 571 Lines of Service Code: Comprehensive service implementation
- Robust Error Handling: Enhanced error management and validation
- Service Registration: Automatic service registration and cleanup
- Integration Lifecycle: Proper service management during setup/teardown
📝 Configuration & Strings
- Enhanced Strings: 128 lines of localization strings for service UI
- Service Schemas: Complete YAML schemas for all custom services
- UI Integration: Full Home Assistant frontend integration
📱 Service Usage Examples
Automation Examples
# Reset filter after replacement
service: philips_airpurifier_coap.filter_reset
target:
entity_id: fan.bedroom_air_purifier
data:
filter_type: "hepa_filter"
reset_maintenance_schedule: true
# Set night mode display
service: philips_airpurifier_coap.set_display_brightness
target:
entity_id: fan.bedroom_air_purifier
data:
brightness_level: 10
night_mode: true
night_mode_start: "22:00"
night_mode_end: "07:00"
# Schedule maintenance reminder
service: philips_airpurifier_coap.schedule_maintenance
target:
entity_id: fan.living_room_air_purifier
data:
maintenance_type: "filter_replacement"
reminder_interval: 90
enable_notifications: true
notification_advance_days: 7🔗 Important Links
- 📖 Documentation: DeepWiki Docs
- 🏠 HACS: Install via HACS
- 💬 Community: Home Assistant Community Forum
- 🐛 Issues: Report Issues
- 📜 License: MIT License
⚠️ Important Notes
- Service Availability: Custom services are automatically registered when the integration loads
- Entity Targeting: Services can target fan, sensor, switch, and light entities as appropriate
- UI Integration: All services include full Home Assistant UI support with proper selectors
- Safety Features: Critical services like device reset include confirmation requirements
- Home Assistant: Requires Home Assistant 2025.1.0 or newer
- Dependencies: Uses aioairctrl==0.2.5 and getmac==0.9.4
🔄 Upgrade Notes
From v0.26.0
- New Services: 7 new custom services are automatically available after upgrade
- No Breaking Changes: All existing functionality remains unchanged
- Enhanced Capabilities: Significant expansion of automation and control options
- Quality Scale: Integration now meets Home Assistant Silver quality standards
🙏 Credits
This integration continues to build upon excellent work by:
- @rgerganov - Original reverse engineering
- @betaboon - Initial integration
- @Denaun - Major rework
- @mhetzi - Timer functionality
- @Kraineff - Contributions and testing
- @shexbeer - Device support
- @thomasloven - Custom icons
📦 Installation
HACS (Recommended)
- Add this repository to HACS
- Search for "Philips AirPurifier" and install
- Restart Home Assistant
- Configure via UI
- New: Custom services are automatically available!
Manual Installation
- Download the latest release
- Extract to
custom_components/philips_airpurifier - Restart Home Assistant
- Configure via UI
- New: Custom services are automatically available!
Full Changelog: v0.26.0...v0.27.0