muexx/batcontrol

muexx/batcontrol镜像说明

镜像概述

本镜像用于通过定时充电策略优化光伏电池系统的用电成本，需配合Fronius Gen24系列逆变器及Tibber/Awattar的小时电价合约使用，支持在本地设备（如树莓派、Synology NAS）部署。

核心功能

• 根据小时电价动态调整电池充电计划，降低用电成本
• 支持Fronius Gen24逆变器与BYD等品牌电池的集成
• 兼容Tibber（需API密钥）、Awattar（奥地利/德国）两种电价服务
• 可自定义光伏安装参数及用电负荷曲线，提升预测准确性

使用场景

• 拥有Fronius Gen24光伏系统及配套电池的家庭用户
• 采用Tibber/Awattar小时电价合约的用户
• 希望通过智能充电降低电费支出的用户

配置说明

1. 前提条件

   • Fronius Gen24逆变器（如Symo GEN24 8.0）及配套电池
   • Tibber/Awattar小时电价合约
   • 可访问逆变器与互联网的本地设备（如RPi 4B、Synology DS220+）

2. 准备步骤

   • 获取Tibber API密钥（仅Tibber用户需此步骤：Tibber开发者平台）
   • 确认Fronius逆变器的本地IP、用户名及密码
   • 创建配置目录并准备batcontrol_config.yaml文件（示例如下）：

     yaml
     general:
       timezone: Europe/Berlin
     battery_control:
       min_price_difference: 0.05
       always_allow_discharge_limit: 0.90
       max_charging_from_grid_limit: 0.90
     inverter:
       type: fronius_gen24
       address: 192.168.0.12
       user: customer
       password: YOUR-PASSWORD
     utility:
       type: tibber # 可选awattar_at/awattar_de
       apikey: Zz-YOUR-API-KEY # Tibber用户必填
       vat: 0.20 # Awattar用户必填
       fees: 0.015 # Awattar用户必填
       markup: 0.03 # Awattar用户必填
     pvinstallations:
       - name: Ostdach
         lat: '49.765460'
         lon: '8.230482'
         declination: '32'
         azimuth: '-93'
         kWp: '4.354'
       - name: Westdach
         lat: '49.765460'
         lon: '8.230482'
         declination: '32'
         azimuth: '87'
         kWp: '5.030'
     consumption_forecast: 
       annual_consumption: 4500
       # load_profile: load_profile.csv # 可选，自定义负荷曲线
     

   • （可选）准备load_profile.csv文件（2016行，覆盖12个月×7天×24小时的用电数据）

Docker部署示例

1. 拉取镜像

   bash
   docker pull muexx/batcontrol
   

2. 运行容器（替换/PATH/TO/config为实际配置目录路径）

   bash
   docker run -d -v /PATH/TO/config:/batcontrol/config muexx/batcontrol