🎉 Philips Air Purifier Integration v0.26.0
This is the first official release of the Philips Air Purifier Home Assistant integration under the domalab organization. This release represents a complete overhaul and enhancement of the integration with significant improvements to documentation, functionality, and user experience.
✨ What's New
🔧 Core Integration Features
- Complete Home Assistant Integration: Full support for Philips air purifiers and humidifiers using encrypted CoAP protocol
- Auto-Discovery: Automatic detection of compatible devices on your network
- Comprehensive Entity Support: Fan, humidifier, sensors, switches, lights, climate controls, and more
- Real-time Monitoring: Air quality sensors (PM2.5, IAI), filter status, and device diagnostics
- Multi-language Support: Available in English, German, Dutch, Bulgarian, Romanian, and Slovak
- Custom Icons: Beautiful Philips-branded icons for the Home Assistant frontend
🩺 Diagnostics & Repair Support
- Enhanced Diagnostics: Added comprehensive diagnostic capabilities for better troubleshooting
- Repair Support: Integrated repair functionality to help resolve common device issues
- Improved Error Handling: Better error reporting and recovery mechanisms
📚 Documentation Overhaul
- Complete README Redesign: Professional, comprehensive documentation with clear sections
- DeepWiki Integration: Added DeepWiki documentation badge and integration for enhanced docs
- Badge Standardization: Unified badge styling across all project badges
- Installation Guides: Detailed HACS and manual installation instructions
- Troubleshooting Section: Comprehensive troubleshooting guide with common issues and solutions
- Contributing Guidelines: Clear guidelines for community contributions
🎨 Visual Improvements
- Professional Badges: Clean, consistent badge styling matching DeepWiki design
- Icon Showcase: Visual preview of all available custom icons
- Organized Device Support: Categorized tables showing all supported device models
- Enhanced Formatting: Improved markdown structure with emojis and clear hierarchy
📱 Supported Devices
This release supports a wide range of Philips devices including:
- Air Purifiers: AC0850, AC0950, AC1214, AC1715, AC2729, AC2889, AC2936, AC3033, AC3055, AC3210, AC3259, AC3420, AC3737, AC3829, AC3854, AC3858, AC4220, AC4550, AC5659 series
- Humidifiers: CX3120, CX3550, CX5120, HU1509, HU5710 series
- 2-in-1 Combos: AMF765, AMF870 series
🔗 Important Links
- 📖 Documentation: DeepWiki Docs
- 🏠 HACS: Install via HACS
- 💬 Community: Home Assistant Community Forum
- 🐛 Issues: Report Issues
⚠️ Important Notes
- Firmware Compatibility: Some newer firmware versions may disable local CoAP communication
- Stability: Due to device firmware limitations, occasional reconnections may be required
- Home Assistant: Requires Home Assistant 2025.1.0 or newer
- Dependencies: Uses aioairctrl==0.2.5 and getmac==0.9.4
🙏 Credits
This integration builds 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
Manual Installation
- Download the latest release
- Extract to
custom_components/philips_airpurifier - Restart Home Assistant
- Configure via UI
Full Changelog: https://github.com/domalab/ha-philips-airpurifier/commits/v0.26.0