Tedee
此集成通过 HTTP 与 Tedee 桥进行通信,从而与您的 Tedee
先决条件
- 您需要桥以使用此集成添加锁。
- 您需要启用 本地 API 和 加密令牌。
- 桥的固件版本必须至少为
2.2.18086
,以便推送更新不出现错误。
如果您不拥有桥,则仍可以通过 HomeKit 设备集成 将锁添加到 Home Assistant(仅适用于 PRO 模型)。在这种情况中,通信将通过蓝牙进行,功能将受到限制。
该集成将尝试配置 Webhooks,以接收来自桥的锁状态更改的近实时推送更新。为了使其正常工作,桥必须能够访问您的 Home Assistant 实例。它将优先使用配置的 internal_url
,因此确保此地址在您的网络上可以从桥访问。如果通过 Webhooks 进行通信不可行,则集成将每 30 秒查询一次更新。
配置
要将 Tedee integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:
手动配置步骤
如果上述 My 按钮不起作用,您也可以手动执行以下步骤:
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角,选择
Add Integration 按钮。 -
从列表中选择 Tedee。
-
按照屏幕上的说明完成设置。
支持的设备
此集成支持
- 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中移除集成实例
- 前往 设置 > 设备与服务 并选择集成卡片。
- 从设备列表中,选择要删除的集成实例。
- 在条目旁边,选择三个点
菜单。然后,选择 删除。
故障排除
锁状态未实时更新
确保您的桥可以访问您的 Home Assistant 实例。这意味着如果您使用不同的 VLAN,需要相应地配置您的防火墙。此外,如果您为内部 URL 配置了启用 SSL 的端点(设置 > 系统 > 网络> Home Assistant URL),请尝试将其重置为实例的 IP 地址(或非 HTTPS URL),因为 HTTPS 有时会导致推送更新出现问题。
尝试使用集成时身份验证失败
- 此集成仅适用于 本地 令牌,云令牌无效
- 在 桥设置
中,必须启用 加密令牌 - 用于与锁通信的令牌是时间限制的。有时,当 Home Assistant 主机的时钟稍微不同步时会出现问题,因此请尝试同步主机的时钟。