Note: This repository is a fork of the original pblxptr/ecoNET-300-Home-Assistant-Integration. Most of the work was done by @pblxpt, and we are very grateful for their efforts. Additionally, I maintained and supported this code up to version v0.3.3.

Home Assistant	ecoNET300	device

The ecoNET300 Home Assistant Integration allows local control and monitoring of ecoNET300 devices directly from Home Assistant. It communicates over your local network via the ecoNET-300's native REST API, avoiding any external cloud services.

• Local Operation: No dependency on econet24.com cloud services
• Easy Configuration: Integrate directly via Home Assistant UI
• Boiler Control: Turn your boiler ON/OFF directly from Home Assistant
• Real-time Monitoring: Monitor temperatures, fuel levels, and system status
• Comprehensive API Access: Access to 48 different API endpoints
• Multiple Entity Types: Sensors, Binary Sensors, Switches, and Number entities
• Diagnostics Support: Download comprehensive diagnostics for troubleshooting

The integration supports 6 languages with comprehensive translations:

• ecoMAX810P-L TOUCH controller from Plum Sp. z o.o.
• ecoMAX850R2-X pellet boiler controller
• ecoMAX360 boiler controller
• ecoMAX860P2-N boiler controller
• ecoMAX860P3-V boiler controller
• ecoSOL500 solar collector system controller
• ecosol301
• ecoSOL solar thermal controller
• SControl MK1 control module
• Other ecoNET300 compatible devices

1. Installation
2. Configuration
3. Entities
4. Contributing
5. Acknowledgments

1. Install and configure HACS.
2. Add this repository as a custom repository using:

https://github.com/jontofront/ecoNET-300-Home-Assistant-Integration

3. In HACS, search for "ecoNET300", install the integration.
4. Restart Home Assistant.

1. Download or clone this repository.
2. Copy custom_components/econet300 into your <config_directory>/custom_components/.

<config directory>/
|-- custom_components/
|   |-- econet300/
|       |-- [...]

3. Restart Home Assistant.

Integrate ecoNET300 via the user interface:

The integration provides a boiler control switch that allows you to turn the boiler ON and OFF directly from Home Assistant.

Features:

• Direct Control: Turn boiler ON/OFF with a simple switch
• State Synchronization: Switch state reflects actual boiler operation mode
• API Integration: Uses the ecoNET-300's native BOILER_CONTROL parameter
• Real-time Updates: Switch state updates based on current boiler mode

The integration provides a heater mode selector that allows you to control the boiler operation mode directly from Home Assistant.

Features:

• Winter Mode: Full heating operation for cold weather
• Summer Mode: Hot water only operation for warm weather
• Auto Mode: Automatic mode selection based on conditions
• Real-time Sync: Mode selection reflects actual boiler operation
• API Integration: Uses ecoNET-300's native parameter 55

These sensors are retrieved from the ../econet/regParams and ../econet/sysParams endpoints.

The integration includes comprehensive diagnostics support to help troubleshoot issues. Download detailed system information including entity states, API data, and configuration details.

📖 Complete Diagnostics Documentation

1. Go to Settings > Devices & Services in Home Assistant
2. Find your ecoNET300 integration
3. Click the Download diagnostics button
4. Share the redacted diagnostics file for support

Features:

• ✅ Automatic sensitive data redaction
• ✅ Complete API endpoint data
• ✅ Entity states and attributes
• ✅ System configuration details

ecoNET-300-Home-Assistant-Integration/
├── custom_components/econet300/     # Home Assistant integration
├── docs/                            # Complete documentation
├── scripts/                         # Development and utility scripts
├── tests/                           # Integration tests
└── [standard project files]

• test_api_endpoints.py - Test all API endpoints and validate responses
• check_translations.py - Validate translation files for consistency
• language_finder.py - Find and analyze language-specific content
• README.md - Scripts documentation and usage instructions

• DIAGNOSTICS.md - Complete diagnostics documentation and troubleshooting guide
• API_V1_DOCUMENTATION.md - Complete API documentation (consolidated)
• BOILER_CONTROL_README.md - Boiler control documentation and setup
• CLOUD_TRANSLATIONS.md - Cloud translations documentation and usage
• ecoSOL_DISCOVERY_SUMMARY.md - ecoSOL device discovery and analysis
• ecoMAX810P-L_PARAMETER_NAMES_ANALYSIS.md - Parameter analysis for ecoMAX810P-L
• ecoMAX850R2-X_DOCUMENTATION.md - Complete ecoMAX850R2-X documentation
• NEW_API_ENDPOINTS_DISCOVERED.md - Newly discovered API endpoints
• devices/ - Device-specific documentation and parameters
• cloud_translations/ - Cloud translation data and references

For detailed version information and changelog, see CHANGELOG.md.

• Diagnostics Support: Comprehensive diagnostics for troubleshooting issues
• Boiler Control: Turn boiler ON/OFF directly from Home Assistant
• Temperature Setpoints: Full control over heating and hot water temperatures
• Mixer Support: Smart entity creation for up to 6 mixer temperature setpoints
• ecoSTER Integration: Support for 8 room thermostats
• ecoSOL 500 Support: Solar collector system integration
• Multi-language: 6 language support (English, Polish, Czech, French, Ukrainian)

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Use the provided scripts in the scripts/ directory to test API endpoints and validate translations.

• @jontofront - Current maintainer and developer
• @pblxpt - Original developer and maintainer up to v0.3.3
• @KirilKurkianec - Contributor and supporter
• ecoNET300 Community - For testing, feedback, and support
• Plum Sp. z o.o. - For creating the ecoNET300 system

This integration is not officially affiliated with or endorsed by Plum Sp. z o.o. Use at your own risk. The developers are not responsible for any damage to your equipment or system.

If you encounter any issues or have questions:

1. Check the API Documentation
2. Search existing Issues
3. Create a new issue with detailed information about your problem

This README was last updated on 2025-07-18 after completing the comprehensive API discovery process.