0.4.11
🔋 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 Modulesmode. - 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_temperaturesmax_voltage,min_voltage,avg_voltagemax_temperature,min_temperature,avg_temperature
- Reduces the total number of entities while keeping diagnostic details.
- Introduces an optional
-
🏗️ Tower Visibility Control
- Added new
Show Towersoption to toggle tower-level diagnostic entities.
- Added new
-
🔧 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_infoacross 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