A Home Assistant custom component for Philips heaters (CX3120, CX5120) that uses CoAP for direct local control. It communicates with the heater on your LAN and does not require the Philips cloud service or mobile app. Internet access is not required.
This integration focuses only on Philips heaters. It came about after debugging and patching an ocillation control issues with philips-airpurifier-coap by @kongo09, which is an broarder implementation for Philips CoAP devices.
Credit: Thanks to @kongo09 for the comprehensive multi-device implementation and to previous contributors in the lineage of Philips CoAP projects.
- 🌡️ Climate entity support - Home Assistant climate integration with multiple HVAC modes
- 🎯 Preset modes - Low, High, Auto, Fan, and Auto+ with configurable temperature offset
- 🔧 Default heat preset option - Choose the preset used when switching to heat mode (useful for Matterbridge and other integrations that only support basic HVAC modes)
- 💫 Oscillation control - Swing mode support
- 🔥 Heating status sensors - Heating intensity, temperatures, and operating mode tracking
- ⚡ CoAP observe updates - Push updates when device state changes
- 🔌 Automatic reconnection with exponential backoff
- Philips CX3120 Series 3000i Heater
- Philips CX5120 Series 5000i Heater
Find "Philips Heater" in HACS Integrations and install it. Or use the button below to open this repository directly in HACS.
- Download the latest release from the releases page
- Extract the files and copy the
custom_components/philips_heater_coapfolder to your Home Assistantconfig/custom_components/directory - Restart Home Assistant
- Go to Settings → Devices & Services
- Click Add Integration
- Search for "Philips Heater"
- Enter your heater's IP address
- Click Submit
The integration will automatically discover and configure your heater.
After adding the integration, configure settings via the configuration entities on the device page:
- Go to Settings → Devices & Services
- Find your Philips heater device
- Click on the device to see all entities, including configuration entities:
- Default Heat Preset: Choose which preset to use when switching to heat mode (low, high, auto, auto+, or fan)
- Auto+ Temperature Offset: Set the temperature offset (1-10°C) above current temperature for Auto+ preset
Default Heat Preset: Controls which preset is activated when switching to heat mode. This is useful with Matterbridge or other integrations that only support basic HVAC modes (heat/off). When they switch to "heat", the integration applies your configured preset (low, high, auto, auto+, or fan).
Auto+ Preset: Auto+ uses a configurable offset above the current room temperature. For example, with a 2°C offset and a current temperature of 18°C, the heater targets 20°C in auto mode.
- Home Assistant 2024.1.0 or newer
- Philips CX3120 or CX5120 heater on your local network
- Network access to the heater on CoAP port (5683/UDP)
The integration provides these entities:
- HVAC Modes: Off, Heat, Auto, Fan Only
- Preset Modes: Low, High, Auto, Auto+, Fan
- Target Temperature: Set when in Auto or Auto+ mode
- Oscillation: Enable/disable swing mode
- Current Temperature: Real-time room temperature
- Temperature: Current room temperature
- Heating Intensity: Shows current heating level (Not Heating, Low, High, Medium)
- Heating Mode: Current operating mode (Off, Low, High, Auto, Fan)
- Target Temperature: Configured target temperature (when applicable)
- Default Heat Preset: Control preset used when switching to heat mode
- Auto+ Temperature Offset: Set offset for Auto+ preset
- Verify the heater is on the same network as Home Assistant
- Check that UDP port 5683 is not blocked by your firewall
- Ensure the IP address is correct and the heater is powered on
- Try pinging the heater from the Home Assistant host
Enable debug logging via the integration page.
This project is licensed under the MIT License - see the LICENSE file for details.
- @kongo09 - Ongoing philips-airpurifier-coap maintenance and development
- Previous contributors - Earlier work on Philips CoAP integrations
- philips-airpurifier-coap - The full-featured integration supporting air purifiers, humidifiers, and heaters
- aioairctrl - Python library for Philips air control devices
Note: This is an unofficial integration and is not affiliated with or endorsed by Philips.
