-
Notifications
You must be signed in to change notification settings - Fork 11
Home
Matthias Strubel edited this page Oct 4, 2025
·
2 revisions
Batcontrol is an intelligent battery management system that optimizes your home battery usage based on dynamic electricity pricing, solar forecasts, and consumption patterns. This documentation will guide you through setup, configuration, and integration with your home energy system.
- How Batcontrol Works - Understand the system architecture and logic
- Main Configuration - Basic system settings and logging
- Start with the Main Configuration for basic system settings
- Configure your Inverter (Fronius GEN24 supported)
- Set up Dynamic Tariff Provider for pricing data
- Configure Solar Forecast for PV predictions
- Set up Consumption Forecast for load predictions
| Component | Description | Documentation |
|---|---|---|
| Inverter | Connect to your battery inverter | Inverter Configuration |
| Dynamic Tariff | Get real-time electricity prices | Dynamic Tariff Provider |
| Solar Forecast | Predict solar energy production | Solar Forecast |
| Consumption Forecast | Predict energy consumption | [Consumption-forecast) |
| Feature | Description | Documentation |
|---|---|---|
| Basic Control | Simple price-based charging/discharging | Main Configuration |
| Expert Mode | Advanced control with custom logic | Battery Control Expert |
| Price Calculations | How price differences are calculated | Price Difference Calculation |
| Integration | Purpose | Documentation |
|---|---|---|
| EVCC | Electric vehicle charging coordination | EVCC Connection |
| MQTT/Home Assistant | Home automation integration | MQTT API |
- Inverters: Fronius GEN24 series
- Dynamic Tariff Providers: aWATTar, Tibber, EVCC integration
- Solar Forecast: Forecast.Solar, Solar-Prognose.de, EVCC integration
- Consumption Forecast: CSV-based load profiles
config/
├── batcontrol_config.yaml # Main configuration file
├── load_profile.csv # Consumption patterns (optional)
└── grafana-overview.json # Grafana dashboard (optional)
- Battery Control Expert - Advanced control algorithms
- Price Difference Calculation - Custom pricing logic
- MQTT API - Complete API reference for home automation
- Main Configuration - Logging and debugging options
- MQTT Topics - Real-time monitoring via MQTT
- Start Simple: Begin with basic configuration and add integrations gradually
- Monitor Logs: Enable debug logging during initial setup
- Test Incrementally: Verify each component before adding the next
- Check Compatibility: Ensure your inverter model is supported
- Backup Settings: Keep copies of working configurations
- Check the specific configuration page for your component
- Enable debug logging to troubleshoot issues
- Verify network connectivity for external API services
- Ensure correct timezone settings for accurate time-based operations
📝 Documentation Status: This wiki is actively maintained and updated regularly. If you find outdated information or need additional details, please check the latest version or report issues.
🔗 Project Repository: GitHub - Batcontrol