ha-evcc：实践指南

面对实际交付，我看ha-evcc的重点不在星标，而在这项能力：evcc☀的家庭助理集成 - 优化电动汽车充电，将您的 EV 充电器与 PV 系统连接，请注意，此集成不是官方的，并且不受 evcc 开发人员支持。团队若要把它用于软件开发，应先处理依赖、接口和异常处理往往比主路径更影响采用，否则试用结果很容易失真。落地前可以在隔离分支完成一个可回滚的小任务，用安装步骤、接口契约、测试结果和错误信息判断它是否真的省事。如果团队属于需要可检查开发流程而非单次演示的工程师，它有继续测试的理由；否则先看替代方案会更省时间。

家庭助理集成： evcc☀-太阳能充电 （非官方）

令我惊讶的是，似乎不存在针对非常流行的 evcc 的简单家庭助理集成。因此，在我的第一个 EV 在我的车道上生成之前，我想贡献一个非常简单和基本的集成，使您可以通过默认的 HA gui 控制 evcc 对象，并在自动化中使用传感器和开关。

请注意，此 Home Assistant 集成不是官方的，并且不受 evcc 开发人员支持。我不以任何方式隶属于 evcc。此集成基于 evcc API 和 evcc API 文档。

![hacs_badge][hacsbadge] ![hainstall][hainstallbadge] ![Wero][werobadge] ![wise][wisebadge] ![Revolut][revolutbadge] [![PayPal][paypalbadge]][paypal] [![github][ghsbadge]][ghs] [![BuyMeCoffee][buymecoffeebadge]][buymecoffee]

Disclaimer

请注意，我们会在现有认知范围内尽力开发此集成，但无法作出保证，因此请自行承担使用风险。

Requirements

• A running & configured evcc instance in your network
• A Home Assistant instance that can reach your evcc instance

Main features

• 支持全部 evcc API 的 POST 与 DELETE 请求（POST /api/settings/telemetry/<status> 除外），用于调整 evcc 设置、充电点及对应车辆
  • Loadpoint mode [Off, Solar, Min+Solar, Fast]
  • Phases to use [Auto, 1p, 3p]
  • Assign vehicles to loadpoints
  • Configure min & max charging currents
  • Configure cost limits (€ or CO₂)
  • Adjust home-battery settings
  • Adjust/create vehicle & loadpoint charging plan via HA-Services http://[YOUR-HA-INSTANCE]:8123/developer-tools/service
  • Enable/eisable 每辆车重复充电计划#2-#10（有关计划的详细信息可以在开关实体的属性中找到）
• 支持通过 API 提供的大多数其他负载点和车辆数据 - 如果您错过了一些数据，请告诉我 - 可能它只是在测试过程中被我忽视了。

~~evcc-配置对象 不支持 ~~

~~随着 0.3.x 的发布，evcc 现在可以通过图形用户界面 (GUI) 进行完全配置。由于能够访问 evcc 配置 GUI 部分需要用户授权（出于充分的理由），THIS INTEGRATION DOES NOT OFFER ANY ENTITIES OF THE CONFIGURATION SECTION of EVCC! 请不要要求我将它们添加到 this 集成中。 未来__没有计划支持 evcc 配置 GUI 实体。这需要将 evcc 用户凭据存储在集成配置中，并且可能的对象种类太多了。~~

~~如果您通过家庭助理 want/need 调整 evcc 配置，__利用 HA-REST 集成__并自己创建所需的 API 调用。在本自述文件中，您将找到需要完成的操作的示例。~~

仪表板示例

看一下这个示例仪表板（显示来自一个负载点的传感器）：

使用 evcc 自定义卡（外部存储库）

@mkshb 已创建多个自定义卡，可以通过 HACS （或手动）安装 将是对这种整合的巨大增强。您可以在@ https://github.com/mkshb/hass-evcc-card 找到所有详细信息。 确保您在 mkshb 的存储库中也留下了 GitHub 星星！

安装

在开始之前——有两个“小”要求！

1. 您必须已在网络中安装并配置了 evcc 实例。 这可以是独立安装（通过 Docker 的 e.g），也可以作为 HASS-IO-AddOn[^1]。此 AddOn 可通过 官方 evcc hassio-addon 存储库 获得。
2. 您必须知道 URL，您的 HA-Instance 可以通过该 HA- 到达您的 evcc 实例。
   • 这通常是 evcc 服务器的 IP 地址以及 evcc 服务器运行的端口（默认为 7070）。
   • 如果您使用反向代理，则需要知道 URL 实例可用于访问 evcc 实例。
   • 当您使用docker（或docker-compose）时，必须确保容器之间可以通信。这意味着网络和端口必须正确配置和公开。您可以通过浏览器访问您的 evcc 实例还不够 - 您的 HA 容器也必须能够访问它！

[^1]: There 是使用 HASS-IO 时的一个已知问题 - 无论出于何种原因，据报告容器（不同安装的 AddOns）的启动顺序_可能不符合此集成的要求_：您的 evcc 服务器__必须启动并运行，然后才能在 HA 中初始化集成__。这是因为在集成的初始启动期间，将评估您的 evcc 配置（活动负载点和配置的车辆），以便创建相应的 HA entities.

So，当您重新启动 HASS-IO 服务器时，可能会发生 HA 在集成之前已经开始初始化此集成。 HASS-OS 已启动 evcc-instance。 这将导致集成未正确启动的情况。

I 很抱歉，我的 HA 开发人员技能不足以找到适用于这种情况的解决方案 - 我也没有找到具有类似挑战的其他集成（寻找灵感）。如果您知道其中之一（正在积极维护），请告诉我。当然，我也欢迎任何 PR 为在不同场景中工作的 AddOn 用户解决此问题（deactivating/activating 集成，支持 WebSocket 或不支持）。

As 对此的个人说明：IMHO 重新启动HA 服务器应该只在观察下发生，并且不应该以任何形式自动化 - 但我可能只有我的意见。

第一步：安装集成

选项 1：通过 HACS

1. 使用搜索栏并输入 evcc☀- Solar Charging
2. 使用列表条目右侧的 3 个点（而不是顶部栏！）来 download/install 自定义集成 — 自动选择最新发布版本。仅当您有特定原因时才选择不同的版本。
3. 按下载并完成该过程后，您必须__重新启动 Home Assistant__ 以安装所有依赖项
4. 按照如下所述设置 evcc 自定义集成（请参阅_步骤 II：添加或启用集成_）

选项 2：手动步骤

1. 使用选择的工具，打开 HA 配置的目录（文件夹）（您可以在其中找到 configuration.yaml）。
2. 如果那里没有 custom_components 目录（文件夹），则需要创建它。
3. 在custom_components目录（文件夹）中创建一个名为evcc_intg的新文件夹。
4. 从此存储库中的 custom_components/evcc_intg/ 目录（文件夹）下载_所有_文件。
5. 将您下载的文件放入您创建的新目录（文件夹）中。
6. 重启家庭助理
7. 按照如下所述设置 evcc 自定义集成（请参阅_步骤 II：添加或启用集成_）

步骤 II：添加或启用集成

您必须已经安装了集成（手动或之前通过 HACS）！

选项 1：我的家庭助理（2021.3+）

只需点击以下按钮即可自动开始配置（其余参见_选项2：手动逐步配置_）：

选项 2：手动 — 逐步

通过使用 Web 界面添加自定义集成，按照以下步骤进行手动配置，并按照屏幕上的说明进行操作：

• 前往 Configuration -> Integrations 并添加“evcc☀-太阳能充电”集成

常见的进一步步骤

• 为集成创建的集成安装提供唯一的名称（将在每个传感器entity_id中使用）
• 提供 evcc Web 服务器 的 URL（包括端口）— e.g。 http://your-evcc-server-ip:7070
• [可选] 提供 evcc 安装所在的区域

添加集成后，您可以使用“配置”按钮来调整您的设置，您还可以修改更新间隔

请注意，默认情况下，某些可用传感器未启用。

将 evcc 与 Home Assistant 结合使用

使用 Home Assistant 传感器数据作为 evcc 的输入

请参阅单独的文档，您可以在其中找到示例 如何为您的 evcc 实例提供 HA 传感器数据。

使用 evcc 控制您的任何 Home Assistant 设备

这是 IMHO evcc 的一个非常强大的功能，但很多用户还不知道。您可以使用 evcc 来控制您的家庭助理设备或自动化 e.g.，以在您实际向电网供电时切换 on/off 任何您喜欢的设备。

使用太阳能电池板的最大电量为 EV 充电固然很棒，但如果您有更多可用电量，或者您的 EV 已充满电怎么办？我已经面对这个挑战很长一段时间了，并使用了几个助手和蓝图来控制能耗较大的家庭设备。

您可以使用 evcc 控制任何已实现 turn_on 和 turn_off 服务的 Home Assistant 实体。这意味着您可以控制智能插头等设备，甚至家庭助理自动化（这是 IMHO 通往 PV 剩余处理天堂的大门）。

由于此 evcc 功能的设置和配置可能并不简单，因此我创建了一个单独的文档，您可以在其中找到示例 Master PV 使用 evcc 和 Home Assistant 进行剩余处理。

我使用此功能来控制 Waterkotte 热泵的热水温度。

您是 go-eCharger V3（或更高版本）用户吗？

您知道吗，作为 go-eCharger (V3+) 的车主，无需使用 evcc 进行太阳能剩余充电？即使没有任何额外的硬件！ Home Assistant 和 go-eCharger APIv2 Connect 集成就是您所需要的。从 https://github.com/marq24/ha-goecharger-api2 获取所有详细信息。

想要报告问题吗？

请使用 GitHub 问题 报告您在此集成中遇到的任何问题。请在创建新问题之前保持友善，如果您的问题已被报告（并已解决），请检查已关闭的问题。

为了加快支持流程，您可能需要准备并提供 DEBUG 日志输出。如果出现技术问题，我需要此 DEBUG 日志输出才能解决 help/fix 问题。这里有一个简短的tutorial/guide“如何提供DEBUG日志”——请花点时间快速浏览一下。

对于此集成，您需要添加：

logger:
  default: warning
  logs:
    custom_components.evcc_intg: debug

广告 / Werbung - 支持我的另一种方式

切换到蒂伯！

明智地切换到 Tibber - 这就是我在 2023 年 10 月所做的。如果您想加入 Tibber（成为客户），您可能需要使用我的个人邀请链接。当您使用此链接时，Tibber 将授予您和我每人 50 欧元的奖金。然后，该奖金可以在 Tibber 商店中使用（不用于支付电费）——e.g。购买蒂伯桥。如果您已经是 Tibber 客户并且尚未使用邀请链接，您也可以随后在 Tibber 应用程序中输入邀请链接（最多 14 天）。 [参见 Tibber 官方支持文章]

请考虑使用我的个人 Tibber 邀请链接 今天加入 Tibber 或随后在 Tibber 应用程序中输入以下代码：6o0kqvzf（六、奥斯卡、零、千、魁北克、维克多、祖鲁、狐步） - TIA！

参考

• https://github.com/evcc-io/evcc
• https://docs.evcc.io/docs/reference/api