github jontofront/ecoNET-300-Home-Assistant-Integration v1.1.1

latest releases: v1.1.13, v1.1.13adiagnostic, v1.1.12...
2 months ago

🎉 New in v1.1.1 Release

Major New Feature: Boiler Control Switch

🔥 Direct Boiler Control

  • Added a new boiler_control switch entity that allows you to turn your boiler ON/OFF directly from Home Assistant
  • Smart State Detection: The switch automatically shows the correct state based on your boiler's actual operation mode
  • Native API Integration: Uses the ecoNET-300's built-in BOILER_CONTROL parameter for reliable control
  • Real-time Updates: Switch state updates automatically when boiler mode changes

��️ How It Works

  • Turn ON: Sets BOILER_CONTROL=1 to start the boiler
  • Turn OFF: Sets BOILER_CONTROL=0 to stop the boiler
  • State Reading: Uses mode parameter from coordinator data for state detection
  • Smart Logic: Switch shows OFF when mode=0, ON when mode=1-25 (any working state)

🔧 Technical Improvements

Enhanced API

  • Updated to use the proper /econet/newParam endpoint for parameter control
  • Better error handling with user-friendly messages
  • Improved API failure handling

Code Quality

  • Follows Home Assistant coding standards
  • Passes all Ruff linting checks
  • Proper type hints and annotations

🌍 User Experience

Multi-language Support

  • ✅ English translations for "Boiler On/Off"
  • ✅ Polish translations for "Boiler On/Off"

Intuitive Control

  • Simple ON/OFF switch that works like any other Home Assistant switch
  • Reliable state synchronization ensures the switch always shows the correct boiler status
  • Seamless integration with Home Assistant automations and scripts

📚 Documentation Updates

User Documentation

  • Updated README with complete boiler control feature documentation
  • Step-by-step setup instructions
  • Usage examples and best practices

Developer Documentation

  • Detailed API documentation in tests/fixtures/API_DOCUMENTATION.md
  • Feature-specific documentation in tests/fixtures/BOILER_CONTROL_README.md
  • Testing guide for the new functionality

🚀 Getting Started

  1. Update to v1.1.1
  2. Restart Home Assistant
  3. Find the new "Boiler On/Off" switch in your devices
  4. Control your boiler directly from Home Assistant!

**This release brings the most requested feature - direct boiler control -

Don't miss a new ecoNET-300-Home-Assistant-Integration release

NewReleases is sending notifications on new releases.