Skip to content

0.4.11

Choose a tag to compare

@bbr111 bbr111 released this 25 Oct 16:51
c763275

🔋 Release v0.4.11 — Module Aggregation & Enhanced Options

This release brings module-based aggregation, extended configuration control, and improved device handling for the BYD HVS/HMS/LVS Home Assistant integration.


🚀 New Features

  • 🧩 Module Aggregation

    • Introduces an optional Aggregate Modules mode.
    • Each BYD module is now represented as one entity instead of multiple per-cell entities.
    • The entity’s main value is the total module voltage (sum of all cell voltages in mV).
    • Each entity also provides detailed attributes:
      • cell_voltages, cell_temperatures
      • max_voltage, min_voltage, avg_voltage
      • max_temperature, min_temperature, avg_temperature
    • Reduces the total number of entities while keeping diagnostic details.
  • 🏗️ Tower Visibility Control

    • Added new Show Towers option to toggle tower-level diagnostic entities.
  • 🔧 Unified Device Information

    • All entities (towers, modules, cells) are now properly linked to the same BYD Battery device in Home Assistant.

⚙️ Updated Configuration Options

Option Description Default
Scan Interval (seconds) Defines how often the integration polls the BYD system for data (min. 10 seconds). 10
Show Cell Voltages Enables individual cell voltage sensors. Disable for cleaner setup. True
Show Cell Temperatures Enables individual cell temperature sensors. True
Show Modules Adds module numbers to cell entity names. False
Reset Cell Counter per Module Resets cell numbering after each module. False
Show Towers Displays tower-level diagnostic sensors. True
Aggregate Modules Creates one summarized entity per module including cell voltage and temperature attributes. False

🪛 Improvements

  • Refactored sensor creation for better performance and maintainability.
  • Improved error handling and stability for missing or malformed tower data.
  • Unified device_info across all entity types.
  • Enhanced debug logging for connection and data issues.

🧩 Debug Logging

You can now enable detailed debug logs for troubleshooting:

logger:
  default: warning
  logs:
    custom_components.byd_hvs: debug
    bydhvs: debug