大金Onecta

使用大金Onecta API的大金设备的Home Assistant集成，需要Home Assistant 2024.1.0作为最低HA版本。

[!重要] 从v4.0.0版本开始，云API已更改为大金提供的官方API。要使用这个新API，您需要在大金开发者门户网站https://developer.cloud.daikineurope.com/login创建一个账户。大金云的状态可以在线查看：https://daikincloudsolutions.statuspage.io。

[!警告] 根据大金开发者使用条款，严格禁止共享、出售或分发访问和刷新令牌。共享它们可能会给您作为用户带来严重问题！

安装

当使用HACS时，将daikin_onecta添加为自定义仓库，选择HACS，选择集成，点击右上角的三个点，选择自定义仓库，并添加https://github.com/jwillemsen/daikin_onecta作为新仓库。然后按照[使用配置流程](https://github.com/jwillemsen/daikin_onecta/blob/master/readme.md#using-config-flow)中描述的方式继续安装。

您可以通过将daikin_onecta文件夹及其所有内容复制到Home Assistant的custom_components文件夹中来手动安装代码。这通常位于您的/config文件夹内。如果您正在运行Hass.io，请使用SAMBA复制文件夹。如果您正在运行Home Assistant Supervised，custom_components文件夹可能位于/usr/share/hassio/homeassistant。可能您的custom_components文件夹不存在。如果是这种情况，请在适当的位置创建该文件夹，然后将daikin_onecta文件夹及其所有内容复制到新创建的custom_components文件夹中。然后您必须重启Home Assistant以正确加载组件。

先决条件

访问 https://developer.cloud.daikineurope.com 并注册一个开发者账户。使用与 Onecta 应用相同的登录方式和电子邮件地址。使用不同的登录方式和/或电子邮件地址将导致 Home Assistant 中不显示任何设备。

使用配置流程

首先在 https://developer.cloud.daikineurope.com 创建一个账户，然后在 Daikin 开发者网站上创建一个应用程序，更多信息请参阅 Daikin 开发者门户的入门页面。作为"重定向 URI"，请始终首先使用 https://my.home-assistant.io/redirect/oauth。复制并保存提供的客户端 ID 和密钥，您需要在下一步中输入这些信息。

现在在 Home Assistant 中，转到"设置 - 设备和服务"，点击"添加集成"按钮创建一个新的集成，在下拉菜单中选择"Daikin Onecta"。在"添加凭据"表单中输入一个用户定义的名称（例如 daikin_onecta），并输入从 Daikin 网站获得的"OAuth 客户端 ID"和"OAuth 客户端密钥"，最后点击"添加"按钮完成。

您现在将被重定向到 Daikin 网站，在那里您需要授权该应用程序。当您同意授予应用程序权限后，您将被重定向回您在 Daikin 网站上作为应用程序一部分提供的"重定向 URI"，在那里您需要通过点击"链接账户"按钮来链接 Home Assistant。如果提供的实例 URL 不正确，您可以通过点击 URL 后面的铅笔图标来编辑它。当您点击"链接账户"后，集成将被添加，连接到您的 Daikin 云账户的 Daikin 设备现在应该在 Home Assistant 中可见。

只有当重定向回您的 Home Assistant 不起作用时，首先尝试安装/启用 My Home Assistant。如果这也不起作用，您可以尝试使用 <HOME_ASSISTANT_URL>/auth/external/callback 作为重定向 URI。<HOME_ASSISTANT_URL> 必须与配置/认证过程中使用的相同。内部示例：http://192.168.0.2:8123/auth/external/callback，http://homeassistant.local:8123/auth/external/callback。

此集成支持以下配置设置，以减少对 Daikin 的轮询次数：

• 高频期更新间隔（分钟）
• 低频期更新间隔（分钟）
• 高频期开始时间
• 低频期开始时间
• 命令后忽略数据刷新的秒数

重新安装

当您尝试重新安装此集成时，请检查 Home Assistant 中是否没有配置旧的客户端 ID 和密钥，更多信息请参阅 应用程序凭据。

设置日志级别

如果您想查看更详细的日志，以调查通信或用于其他调试目的，您可以在 Home Assistant 配置中设置日志级别。可以添加以下行来设置组件和该集成使用的 oauth2 助手的整体日志级别：

logger:
  logs:
    custom_components.daikin_onecta: debug
    homeassistant.helpers.config_entry_oauth2_flow: debug

如果您只想在每个模块的基础上更改日志级别，您也可以这样做，例如，如果您只想要气候的调试日志：

logger:
  logs:
    custom_components.daikin_onecta.climate: debug

致谢：

本代码基于 @rospogrigio 和 @speleolontra 的工作，而他们的工作又基于 @Apollon77 的成果。