ingmarstein/mielesolar

Mielesolar

镜像概述和主要用途

Mielesolar是一款用于在SolarEdge逆变器产生过剩电力时自动启动Miele@Home智能家电的工具。通过直接与本地网络中的SolarEdge逆变器通信获取实时电力数据，并利用Miele API控制支持SmartStart功能的家电，实现太阳能过剩电力的高效利用。

核心功能和特性

• 极小资源占用：Docker镜像压缩后大小约4MB，运行时内存占用约10MB，对硬件要求低。
• 易于上手：无需学习复杂概念（如"事物"、"连接器"、"绑定"等），只需提供逆变器IP地址和Miele账户凭据即可使用。
• 无需额外网关：通过Miele API直接连接WiFi使能的Miele设备，无需XGW3000网关。
• 实时数据采集：不依赖限制严格的SolarEdge Monitoring API（每日300次请求限制，15分钟数据分辨率），而是通过本地网络直接与逆变器通信，提供实时电力数据。

使用场景和适用范围

适用于拥有SolarEdge逆变器和Miele智能家电（如洗碗机、洗衣机、烘干机等）的用户，希望通过太阳能过剩电力自动启动家电，优化能源使用，降低电网电力消耗。特别适合家庭、小型住宅或需要简单高效太阳能-家电联动方案的场景。

详细使用方法和配置说明

1. 在逆变器上启用MODBUS over TCP

无需打开逆变器即可完成配置，具体操作参见SolarEdge SunSpec实现技术文档。

2. 获取Miele API凭据

该工具通过Miele 3rd Party API与家电通信，需先获取API凭据。可通过Miele API注册页面申请访问权限。获取凭据后，通过以下环境变量传递给mielesolar：

• MIELE_USERNAME：Miele@Home账户用户名
• MIELE_PASSWORD：Miele@Home账户密码
• MIELE_CLIENT_ID：Miele API客户端ID
• MIELE_CLIENT_SECRET：Miele API客户端密钥

3. 运行mielesolar

支持在多种设备上运行（如树莓派、常见NAS设备）。需设置vg参数指定Miele@Home账户注册地区（如de-DE或de-CH）。

原生运行

bash
go get github.com/IngmarStein/mielesolar
MIELE_USERNAME=xxx MIELE_PASSWORD=xxx MIELE_CLIENT_ID=xxx MIELE_CLIENT_SECRET=xxx mielesolar -inverter $IP -port 502 -vg de-DE -auto 500

Docker容器运行

bash
docker run --env MIELE_USERNAME=xxx --env MIELE_PASSWORD=xxx --env MIELE_CLIENT_ID=xxx --env MIELE_CLIENT_SECRET=xxx ingmarstein/mielesolar -inverter $IP -port 502 -vg de-DE -auto 500

如需使用Docker Compose，可参考项目中提供的docker-compose.yml文件作为模板。

4. 启动Miele家电

启动洗碗机、洗衣机、烘干机等家电时，使用"SmartStart"选项（该选项会延迟程序启动，直到有足够太阳能或达到指定时间，以先到者为准）。如无此选项，启用"SmartGrid"选项。mielesolar会检测处于PROGRAMMED_WAITING_TO_START状态的设备，并在SolarEdge逆变器输出足够电力时自动启动。

高级配置

可通过配置文件定义家电启动优先级和自定义功耗。使用配置文件时，需移除-auto参数（该参数为所有设备设置通用功耗值），改用-config $file指定配置文件路径。

配置文件格式

json
[
  {
    "id": "000xxxxxxxxx",
    "power": 200
  },
  {
    "id": "000yyyyyyyyy",
    "power": 500
  }
]

配置说明

• 设备优先级：配置文件中设备的顺序即为启动优先级。逆变器产生过剩电力时，将按顺序启动设备。
• 功耗设置：power字段为设备启动所需的最小过剩电力（单位：W），值无需精确，但应足够大以避免过早启动。
• 设备ID：即设备的"序列号"或"fabnumber"，可在Miele@Home应用中查看（需包含前导零）。

示例：若配置如上，当逆变器提供600W过剩电力时，将启动第一个功耗200W的设备，剩余400W不足以启动第二个500W的设备。