A Home Assistant custom component for integrating energy management devices, featuring a modular architecture with support for multiple device types and connection methods.
Comprehensive documentation is available in our GitHub Wiki
The wiki contains detailed guides for:
- Installation - Step-by-step setup instructions
- Configuration - Device setup and configuration
- Supported Integrations - Available devices and features
- Troubleshooting - Common issues and solutions
- Development - Contributing and extending the platform
This major update introduced significant architectural changes that may break existing configurations:
- Complete Rewrite: The entire codebase was restructured with a modular architecture
- Configuration Changes: Setup process and configuration flow have been completely redesigned
- Entity Naming: Sensor and device naming conventions have changed
- Integration Removal: Previous versions are incompatible - complete reinstallation required
This major update introduced a modular architecture with clear separation between connectors, integrations, and core components. The platform now supports easy extension with new device integrations.
Use at Your Own Risk: This integration is for informational and control purposes only. All electrical installations should be performed by a qualified electrician. Ensure all connected devices have proper safety settings configured.
- Modular Architecture: Easy to extend with new integrations
- Multiple Connection Methods: USB-RS485 Serial (✅ tested), Telnet Serial (🧪 untested), HTTP API (✅ tested), Helper Services (✅ tested)
- Comprehensive Monitoring: 167 sensors for Seplos V2 BMS, 18 sensors for GEO IHD, plus charging slot tracking
- Clean Device Organization: Separate devices for operational data and settings
- Helper Services: IOG-Ohme Slots for tracking cheap electricity rate activation
- Seplos V2 BMS (Single pack via USB-RS485): Advanced battery management with 167 sensors (80 BMS + 87 Settings)
- GEO IHD: Energy monitoring via HTTP API with 18 sensors (9 Electricity + 9 Gas)
- IOG-Ohme Slots: Track active charging during cheap electricity slots for Ohme chargers or any power sensor
- Seplos V2 via Telnet Serial: Network-based serial connection (untested)
- Multiple Seplos battery packs: Parallel battery configurations (untested)
- Other connection methods: Additional protocols and devices (see roadmap)
- Install via HACS (recommended) or manual installation
- Add integration in Home Assistant Settings > Devices & Services
- Configure your devices following the setup wizard
- Restart Home Assistant to complete installation
For detailed instructions, see the Installation Guide.
- Home Assistant 2023.12.0 or later
- Python 3.9 or later
- Required Python libraries (automatically installed): pymodbus, aiohttp
- Wiki Documentation: Comprehensive guides and troubleshooting
- Discord Community: Join our Discord for support
- GitHub Issues: Report bugs and request features
- Related Projects: Complementary integrations that work well with Home Energy Hub
We welcome contributions! Please see our:
- GitHub Sponsors - Support ongoing development
- Discord Community - Get help and discuss features
GPL-3.0 License - see LICENSE file for details.