This repository contains a comprehensive Home Assistant integration for De'Longhi Comfort air conditioning and dehumidification devices. The integration provides full control and monitoring capabilities through Home Assistant's user interface.
IMPORTANT: This integration is provided "as-is" without any warranty or guarantee. The author takes no responsibility for any damage, data loss, or issues that may arise from using this integration. Use at your own risk.
AI-Assisted Development: Much of the work converting this to a Home Assistant integration was done using GitHub Copilot and other AI assistance tools. This README was also created with the help of an LLM model. While every effort has been made to ensure accuracy and functionality, please thoroughly test before deploying in production environments.
This integration is based on the excellent work of:
- rtfpessoa/delonghi-comfort-client - Thank you for the initial client implementation
- duckwc/ECAMpy - Thanks for the authentication and token conversion code
- HVAC Modes: Cool, Heat, Dry (dehumidify), Fan Only, Off
- Temperature Control: Set target temperature with precise control
- Fan Speed Control: Multiple fan speed settings
- Real-time Status: Live updates of device status and settings
- Room Temperature: Current ambient temperature
- Target Temperature: Current temperature setpoint
- Room Humidity: Current humidity levels
- Device Status: Operating status (on/off/standby)
- Device Mode: Current operating mode
- Fan Speed: Current fan speed setting
- Power Switch: Turn device on/off
- Temperature Controls: Precise temperature adjustment
- Mode Selection: Easy switching between operating modes
- Fan Speed Selection: Control fan speed levels
- Configuration Flow: Easy setup through Home Assistant UI
- Device Discovery: Automatic detection of De'Longhi devices
- Coordinator Pattern: Efficient data updates with minimal API calls
- Cloud Polling: Regular status updates from De'Longhi cloud services
- Home Assistant 2023.1.0 or newer
- De'Longhi Comfort account with registered devices
- Internet connection for cloud API access
- Open HACS in Home Assistant
- Go to "Integrations"
- Click the three dots menu and select "Custom repositories"
- Add this repository URL and select "Integration" as the category
- Find "De'Longhi Comfort" in the list and install it
- Restart Home Assistant
-
Download the integration:
git clone https://github.com/philm5/delonghi-comfort-integration.git
-
Copy to custom_components: Copy the
custom_components/delonghi_comfortfolder to your Home Assistantcustom_componentsdirectory:config/ └── custom_components/ └── delonghi_comfort/ ├── __init__.py ├── api.py ├── climate.py ├── config_flow.py ├── const.py ├── coordinator.py ├── manifest.json ├── number.py ├── select.py ├── sensor.py ├── switch.py └── translations/ └── en.json -
Restart Home Assistant
- Navigate to Settings → Devices & Services in Home Assistant
- Click Add Integration
- Search for De'Longhi Comfort
- Enter your De'Longhi Comfort account credentials:
- Username: Your De'Longhi account email
- Password: Your De'Longhi account password
- Language: Select your preferred language/region
- Scan Interval: Update frequency (default: 60 seconds)
- Scan Interval: How often to poll the API for updates (30-300 seconds)
- Device Selection: Choose which devices to integrate
Once configured, you'll have access to various entities:
climate.delonghi_comfort_[device_id]- Full climate control with temperature, mode, and fan speed
sensor.delonghi_comfort_[device_id]_room_temperaturesensor.delonghi_comfort_[device_id]_room_humiditysensor.delonghi_comfort_[device_id]_target_temperaturesensor.delonghi_comfort_[device_id]_device_status
switch.delonghi_comfort_[device_id]_powernumber.delonghi_comfort_[device_id]_temperatureselect.delonghi_comfort_[device_id]_modeselect.delonghi_comfort_[device_id]_fan_speed
- Authentication Errors: Verify your De'Longhi account credentials
- No Devices Found: Ensure devices are registered in the De'Longhi app
- Connection Timeouts: Check internet connection and API status
- Slow Updates: Adjust scan interval in configuration
Add to your configuration.yaml:
logger:
default: warning
logs:
custom_components.delonghi_comfort: debugContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
This repository includes GitHub Actions for quality assurance and release management:
- Triggers: Runs on every push to main/master and on pull requests
- Validates:
- Python syntax and compilation
- Home Assistant manifest.json structure
- HACS compatibility requirements
- File structure integrity
- Basic code quality checks
- Triggers: Runs when tags are pushed (e.g.,
v1.0.0) or manually triggered - Creates:
delonghi_comfort.zip- Integration files only (for HACS/manual install)delonghi-comfort-integration-[version].zip- Complete package with documentation- GitHub release with auto-generated release notes
- Updates: Automatically updates version in manifest.json to match the tag
To create a new release:
git tag v1.0.0
git push origin v1.0.0This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
This project incorporates code from the following Apache 2.0 licensed projects:
- rtfpessoa/delonghi-comfort-client - Licensed under Apache 2.0
- duckwc/ECAMpy - Authentication and token conversion code
All modifications and additions to the original code are also licensed under Apache 2.0. See the NOTICE file for detailed attribution information.
- rtfpessoa for the original delonghi-comfort-client
- duckwc for the authentication code from ECAMpy
- The Home Assistant community for guidance and best practices
- Create an issue on GitHub for bug reports
- Check existing issues before creating new ones
- Provide logs and device information when reporting issues