jontofront/ecoNET-300-Home-Assistant-Integration v1.2.3

on GitHub

What's New in v1.2.3

This is a major update with new entity types, a custom entity builder, alarm monitoring, schedule sensors, and stability improvements.

Custom Entity Selector

Create your own sensors and binary sensors from any parameter on your device — directly from the Home Assistant UI:

1. Go to Settings > Devices & Services > ecoNET300 > Configure
2. Choose Custom Entities
3. Pick parameters from regParams or regParamsData
4. Set name, unit, device class, and precision
5. Entities appear immediately — no restart needed

Alarm Monitoring

Your boiler's alarms are now visible in Home Assistant:

• Last Alarm sensor — most recent alarm with full details in attributes
• Alarm Count sensor — total number of alarms
• Alarm Active binary sensor — turns ON when an alarm is active
• Boiler Alarm event entity — use in automations for push notifications

See the Alarms & Events Guide for automation examples.

Schedule Sensors

View your device's configured heating schedules directly in Home Assistant:

• Auto-created for each schedule on your device (boiler, water heater, mixers, thermostats, etc.)
• Shows today's active hours as the sensor value (e.g. 06:00-12:00, 20:00-00:00)
• Full weekly schedule in attributes — perfect for Markdown dashboard cards
• New econet300.get_schedule service for reading schedules in automations

See the Schedules Guide for dashboard examples.

ecoMAX360i Sensors

New sensors for ecoMAX360i users:

• Flap valve states, heat demanded, water pump running
• Axen heat pump temperatures (outdoor, outgoing, return, compressor frequency)
• Circuit comfort/eco temperature setpoints (circuits 1–7)

Stability Improvements

• API throttling — max 3 parallel requests to prevent overloading the ecoNET module (#210)
• Smarter timeouts — first startup gets 120s (cold cache), subsequent updates 30s
• Ghost device cleanup — orphaned devices are automatically removed
• System Health — integration status visible in Settings > System > Repairs > System Health

Bug Fixes

• Fuel consumption sensor — fixed race condition and unique ID mismatch that prevented creation
• Duplicate entities — dynamic entities no longer collide with static number entities
• Custom entity values — entities from regParamsData now correctly resolve their values
• Startup crash — safely handle missing regParams data during initialization

New Device Fixtures

• ecoMAX920P1-T
• ecoMAX860D3-HB

How to Update

1. Update via HACS or manually copy the custom_components/econet300 folder
2. Restart Home Assistant
3. New entities appear automatically — no reconfiguration needed
4. Check Settings > Devices > ecoNET300 for new alarm and schedule entities
5. Optional: go to Configure to add custom entities from your device