This is a custom integration for Home Assistant that connects to a Homevolt Energy Management System (EMS) locally and provides comprehensive sensor data for monitoring your energy system.
- Real-time Monitoring: Track your Homevolt system status in real-time
- Battery Monitoring: Monitor battery levels with dynamic icons
- Energy Flow: Track energy consumption, production, and storage
- Multi-Device Support: Support for multiple EMS devices and sensors
- Schedule Management: View and manage charging/discharging schedules
- Error Detection: Display error and warning information when available
- Local Polling: All communication is local, no cloud dependency
- Easy Configuration: Configurable through the Home Assistant UI
The integration provides various sensor types including:
- Battery state and level
- Power consumption and generation
- Energy management system status
- Inverter information
- Battery management system data
- Voltage and current readings
- Temperature monitoring
- Schedule information
- Make sure HACS is installed in your Home Assistant instance
- Add this repository as a custom repository in HACS:
- Go to HACS > Integrations
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add the URL of this repository and select "Integration" as the category
- Click "Install" on the Homevolt Local integration
- Restart Home Assistant
- Copy the
custom_components/homevolt_localdirectory to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- Go to Settings > Devices & Services
- Click "Add Integration"
- Search for "Homevolt Local"
- Follow the configuration steps:
- Enter the IP address or hostname of your first Homevolt system
- Enter your username and password
- Configure optional settings (SSL verification, scan interval, timeout)
- Add additional IP addresses for linked systems (optional)
- Select which system should be considered the main system (if you added multiple)
- Confirm the configuration
If your Homevolt system has multiple IP addresses (for example, if you have multiple controllers that are linked together), you can now add all IP addresses during the initial setup process. This creates a single integration instance that manages all your linked systems.
Benefits of this approach:
- All systems are managed by a single integration instance
- Data from all systems is merged automatically
- Duplicate devices and sensors are automatically detected and prevented
- You can designate one system as the "main system" which will be used as the primary data source
During setup, you'll be guided through:
- Adding your first system (IP/hostname, credentials, and settings)
- Adding additional systems one by one (with an option to add more after each)
- Selecting which system should be considered the main system
- Confirming the final configuration
The integration uses unique identifiers for each device based on their internal IDs, ensuring that the same physical device is represented only once in Home Assistant, regardless of which IP address it's accessed through.
This integration detects and creates separate devices for each Energy Management System (EMS) unit and sensor found in your Homevolt Local system. Each device has its own set of sensors, and there are also aggregated sensors that show combined data from all devices.
These sensors show combined data from all EMS units:
- Homevolt Status: Shows the current state of the EMS with a dynamic icon that changes based on the battery level
- Homevolt Error: Shows error information when available
- Homevolt Total SoC: Shows the total state of charge as a percentage
- Homevolt Power: Shows the current power in watts
- Homevolt Energy Produced: Shows the energy produced in kilowatt-hours
- Homevolt Energy Consumed: Shows the energy consumed in kilowatt-hours
Each EMS device will have the following sensors:
- Homevolt battery SoC: Shows the state of charge for the battery as a percentage
- Status: Shows the current state of the specific EMS device
- Power: Shows the power of the specific EMS device in watts
- Energy Produced: Shows the energy produced by the specific EMS device in kilowatts
- Energy Consumed: Shows the energy consumed by the specific EMS device in kilowatts
- Error: Shows error information specific to the device when available
The integration also creates separate devices for each sensor in the system:
The Grid sensor device provides information about the power flow to and from the grid:
- Power: Shows the current power flow in watts (positive for import, negative for export)
- Energy Imported: Shows the total energy imported from the grid in kilowatt-hours
- Energy Exported: Shows the total energy exported to the grid in kilowatt-hours
The Solar sensor device provides information about your solar production:
- Power: Shows the current solar power production in watts
- Energy Imported: Shows the total energy imported from the solar system in kilowatt-hours
- Energy Exported: Shows the total energy exported to the solar system in kilowatt-hours
The Load sensor device provides information about your household consumption:
- Power: Shows the current power consumption in watts
- Energy Imported: Shows the total energy imported by the loads in kilowatt-hours
- Energy Exported: Shows the total energy exported by the loads in kilowatt-hours
Here is an example dashboard configuration that you can use to display your Homevolt sensors. You can add this to your Home Assistant Dashboards by choosing "Raw configuration editor" and pasting the code below.
Note: You will likely need to replace some of the placeholder entity IDs (e.g., sensor.REPLACE_WITH_YOUR_GRID_POWER_SENSOR) with the actual entity IDs from your Home Assistant instance. You can find the entity IDs in Home Assistant under Settings -> Devices & Services -> Entities.
The aggregated sensors (e.g., sensor.homevolt_total_soc) should have stable entity IDs. However, sensors for Grid, Solar, Load, and individual EMS units may have entity IDs that vary depending on your setup (e.g., sensor.power_2, sensor.power_3). Please verify all entity IDs before using this dashboard.
#
# Note: You will need to replace some of the placeholder entity IDs below with the
# actual entity IDs from your Home Assistant instance. You can find the entity IDs
# in Home Assistant under Settings -> Devices & Services -> Entities.
#
# The aggregated sensors (e.g., sensor.homevolt_total_soc) should have stable names.
# However, sensors for Grid, Solar, Load, and individual EMS units may have
# entity IDs that vary (e.g., sensor.power_2, sensor.power_3). Please verify all
# entity IDs before using this dashboard.
#
title: Homevolt Energy Dashboard
views:
- path: default_view
title: Home
icon: mdi:home
cards:
- type: markdown
content: >
# Homevolt - Overview
- type: grid
columns: 2
square: false
cards:
- type: gauge
entity: sensor.homevolt_total_soc
name: Total Battery SoC
min: 0
max: 100
segments:
- from: 0
color: '#db4437'
- from: 20
color: '#ffa600'
- from: 60
color: '#43a047'
- type: entity
entity: sensor.homevolt_status
name: System Status
- type: entity
entity: sensor.homevolt_power
name: Battery Power Flow
- type: entity
entity: sensor.homevolt_current_schedule
name: Current Schedule
- type: markdown
content: >
## Energy Flow (Current Power)
- type: grid
columns: 3
square: false
cards:
- type: sensor
entity: sensor.REPLACE_WITH_YOUR_GRID_POWER_SENSOR
name: Grid
graph: line
- type: sensor
entity: sensor.REPLACE_WITH_YOUR_SOLAR_POWER_SENSOR
name: Solar
graph: line
- type: sensor
entity: sensor.REPLACE_WITH_YOUR_LOAD_POWER_SENSOR
name: House
graph: line
- type: markdown
content: >
## Energy Totals (Lifetime)
- type: entities
show_header_toggle: false
entities:
- entity: sensor.homevolt_energy_produced
name: Battery - Energy Produced
- entity: sensor.homevolt_energy_consumed
name: Battery - Energy Consumed
- entity: sensor.REPLACE_WITH_YOUR_GRID_ENERGY_IMPORTED_SENSOR
name: Grid - Energy Imported
- entity: sensor.REPLACE_WITH_YOUR_GRID_ENERGY_EXPORTED_SENSOR
name: Grid - Energy Exported
- entity: sensor.REPLACE_WITH_YOUR_SOLAR_ENERGY_EXPORTED_SENSOR
name: Solar - Energy Produced
- entity: sensor.REPLACE_WITH_YOUR_LOAD_ENERGY_IMPORTED_SENSOR
name: House - Energy Consumed
- type: markdown
content: >
## EMS Devices
*Note: If you have multiple EMS devices, you can duplicate the card below for each one.*
- type: entities
title: "EMS Device 1"
show_header_toggle: false
entities:
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_STATUS_SENSOR
name: Status
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_BATTERY_SOC_SENSOR
name: Battery SoC
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_POWER_SENSOR
name: Power
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_ENERGY_PRODUCED_SENSOR
name: Energy Produced
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_ENERGY_CONSUMED_SENSOR
name: Energy Consumed
- entity: sensor.REPLACE_WITH_YOUR_EMS_1_ERROR_SENSOR
name: Error- Connection Timeout: Ensure your Homevolt system is accessible from Home Assistant
- Authentication Failed: Verify username and password if required
- No Data: Check that the EMS resource path is correct
- SSL Errors: Try disabling SSL verification if using self-signed certificates
Enable debug from the dot menu.
Or to enable debug logging, add this to your configuration.yaml:
logger:
default: warning
logs:
custom_components.homevolt_local: debug- Check the Issues page for known problems
- Create a new issue with detailed information about your problem
- Include relevant log entries and configuration details
Contributions are welcome! Please feel free to submit a Pull Request. Make sure to:
- Follow the existing code style
- Add tests for new functionality
- Update documentation as needed
- Test your changes thoroughly
This project is licensed under the MIT License - see the LICENSE file for details.
If you find this integration useful, consider supporting the development.
- Thanks to the Home Assistant community for their support and feedback
- Original inspiration from various energy management integrations
This project includes a development container configuration that provides a consistent development environment with all the necessary tools and dependencies pre-installed. The development container supports both VS Code and PyCharm.
For more information on how to use the development container, see the .devcontainer/README.md file.