Tedee

此集成通过 HTTP 与 Tedee 桥进行通信,从而与您的 Tedee 锁进行交互。该集成将与您的锁进行本地通信。

先决条件

  • 您需要桥以使用此集成添加锁。
  • 您需要启用 本地 API加密令牌
  • 桥的固件版本必须至少为 2.2.18086,以便推送更新不出现错误。

如果您不拥有桥,则仍可以通过 HomeKit 设备集成 将锁添加到 Home Assistant(仅适用于 PRO 模型)。在这种情况中,通信将通过蓝牙进行,功能将受到限制。

Note

该集成将尝试配置 Webhooks,以接收来自桥的锁状态更改的近实时推送更新。为了使其正常工作,桥必须能够访问您的 Home Assistant 实例。它将优先使用配置的 internal_url,因此确保此地址在您的网络上可以从桥访问。如果通过 Webhooks 进行通信不可行,则集成将每 30 秒查询一次更新。

配置

要将 Tedee integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

主机

桥的 IP 地址。您可以在路由器中或在 Tedee 应用的 桥设置 -> 本地 API 中找到它。

本地访问令牌

您桥的本地访问令牌。您可以在 Tedee 应用的 桥设置 -> 本地 API 中找到它。

支持的设备

此集成支持

  • Tedee PRO
  • Tedee GO

二进制传感器

  • 充电中: 指示电池当前是否正在充电。
  • 拉簧启用: 指示拉簧设置是否已启用。
  • 半锁定: 指示锁处于“半锁定”位置。“半锁定”表示锁已手动转动,并处于正常结束位置之间。锁在此位置将不可用。
  • 锁未校准(默认禁用): 当锁处于“未校准状态”时显示。

传感器

该集成当前提供两个传感器:一个 电池 传感器,指示您的锁的电量,以及一个 “拉簧持续时间” 传感器,指示在拉动操作后(如果支持)您的门闩将保持拉动状态的时间(以秒为单位)。

可能的使用案例

  • 根据存在情况自动锁定/解锁门
  • 从智能家居面板控制您的锁
  • 当电池电量低时获取警报

自动化

通过以下自动化示例快速入门。

当最后一个人离家时自动锁门

示例 YAML 配置
alias: 最后一个人离开时锁门
description: 当最后一个人离开家时锁门
mode: single
triggers:
  - trigger: state
    entity_id:
      - zone.home
    to: "0"
conditions: []
actions:
  - action: lock.lock
    metadata: {}
    data: {}
    target:
      entity_id: lock.lock_a1b2

已知限制

此集成仅支持本地可用的功能。这意味着以下元素不受支持:

  • 活动日志
  • 更新
  • 按键盘

移除集成

此集成遵循标准的集成移除流程。无需额外步骤。

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中,选择要删除的集成实例。
  3. 在条目旁边,选择三个点 菜单。然后,选择 删除

故障排除

锁状态未实时更新

确保您的桥可以访问您的 Home Assistant 实例。这意味着如果您使用不同的 VLAN,需要相应地配置您的防火墙。此外,如果您为内部 URL 配置了启用 SSL 的端点(设置 > 系统 > 网络> Home Assistant URL),请尝试将其重置为实例的 IP 地址(或非 HTTPS URL),因为 HTTPS 有时会导致推送更新出现问题。

尝试使用集成时身份验证失败
  • 此集成仅适用于 本地 令牌,云令牌无效
  • 桥设置 中,必须启用 加密令牌
  • 用于与锁通信的令牌是时间限制的。有时,当 Home Assistant 主机的时钟稍微不同步时会出现问题,因此请尝试同步主机的时钟。