evcc 开源项目教程

1. 项目介绍

evcc 是一个可扩展的电动汽车充电控制器和家庭能源管理系统。它具有简单而干净的用户界面，支持广泛的充电器类型，包括 ABL eMH1、Alfen (Eve)、Bender (CC612/613)、cFos (PowerBrain) 等。此外，evcc 还支持多种智能电表和集成系统，如 SMA Sunny Home Manager 和 Energy Meter、KOSTAL Smart Energy Meter (KSEM, EMxx) 等。

evcc 还提供了车辆集成功能，可以获取车辆的状态（如电池状态、远程充电状态等），并支持多种服务和插件，如 Modbus、HTTP、MQTT、Javascript、WebSockets 和 shell 脚本。

2. 项目快速启动

2.1 安装依赖

在开始之前，确保你的系统已经安装了以下依赖：

• Go (版本 >= 1.16)
• Node.js (版本 >= 14.x)
• Docker (可选，用于容器化部署)

2.2 克隆项目

首先，克隆 evcc 项目到本地：

git clone https://github.com/evcc-io/evcc.git
cd evcc

2.3 构建项目

使用以下命令构建项目：

make build

2.4 配置文件

在 evcc 目录下创建一个配置文件 evcc.yaml，并根据你的需求进行配置。以下是一个简单的配置示例：

meters:
  grid:
    type: modbus
    uri: 192.168.1.10:502
    id: 1
    model: sdm
chargers:
  wallbox:
    type: go-e
    uri: http://192.168.1.20
vehicles:
  tesla:
    type: tesla
    title: Tesla Model 3
    capacity: 75
    user: your-tesla-email
    password: your-tesla-password

2.5 启动 evcc

使用以下命令启动 evcc：

./evcc

3. 应用案例和最佳实践

3.1 家庭能源管理

evcc 可以与家庭能源管理系统集成，通过控制电动汽车的充电时间，优化家庭能源使用。例如，当太阳能发电量充足时，evcc 可以自动启动电动汽车的充电，从而减少对电网的依赖。

3.2 商业充电站管理

在商业环境中，evcc 可以用于管理多个充电站，确保充电过程的高效和安全。通过与智能电表和能源管理系统的集成，evcc 可以实时监控充电站的能源使用情况，并根据需求进行调整。

4. 典型生态项目

4.1 Home Assistant

Home Assistant 是一个开源的家庭自动化平台，evcc 提供了与 Home Assistant 的集成插件，使得用户可以通过 Home Assistant 的界面管理和监控 evcc 的运行状态。

4.2 OpenHAB

OpenHAB 是另一个流行的开源家庭自动化平台，evcc 也提供了与 OpenHAB 的集成插件，用户可以通过 OpenHAB 的规则引擎来控制 evcc 的行为。

4.3 Grafana

Grafana 是一个开源的数据可视化工具，evcc 支持将日志数据发送到 InfluxDB，并通过 Grafana 进行可视化展示，帮助用户更好地理解和管理能源使用情况。

通过以上教程，你可以快速上手 evcc 项目，并了解其在不同场景下的应用和最佳实践。