2025.3.4
首页 ▸ Integrations ▸

宜家 TRÅDFRI

宜家 TRÅDFRI 集成允许你将宜家 Trådfri 网关连接到 Home Assistant。该网关可以控制与其连接的兼容 Zigbee 灯光（认证的 Zigbee 灯光链接产品）。

配置

要将 宜家 TRÅDFRI integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

宜家 TRÅDFRI 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

你将被提示通过 Home Assistant 界面配置网关。配置过程非常简单：在提示时，输入印在宜家 Trådfri 网关底部标签上的安全密钥，然后点击 配置。

Tip

如果你看到“无法连接”的消息，请重启网关并重试。不要忘记在路由器或 DHCP 服务器上为你的宜家 TrådfRI 网关分配一个永久的 IP 地址。

Note

目前没有专门为 2022 年 10 月发布的 Dirigera 集线器提供核心集成。

然而，Dirigera 集线器可以直接通过 HomeKit 设备 集成或 Matter 集成进行集成。从 Hub 版本 2.615.8（2024 年 9 月）开始，支持以下设备类型通过 Matter Bridge：灯光（包括驱动器）、智能插头/插座、连接的百叶窗、遥控器、运动传感器、开关传感器、空气净化器和空气质量传感器。

故障排除

安全密钥错误

致命 DTLS 错误：代码 20 可能表示缺少或错误的安全密钥。请特别注意，例如，“I”和“l”很容易混淆。

固件更新

在更新宜家 Trådfri 网关的固件后，可能需要重复配置过程。固件更新后可能出现的一个错误是 致命 DTLS 错误：代码 115。如果你遇到问题：

  • 当使用集成配置时：通过设置 > 集成 > Tradfri > 删除（垃圾桶图标）来移除集成。

然后重启 Home Assistant。当提示时，输入安全密钥并点击 配置，与初始设置时一样。

编译问题

Note

这不适用于在 Docker 容器中运行的 Home Assistant，包括默认的 Home Assistant 安装。

如果你想使用此集成，请确保安装了 autoconf（$ sudo apt-get install autoconf）。此外，在慢速设备上安装某些依赖项可能需要相当长的时间（超过一个小时）。

已知限制

  • TRÅDFRI 快捷按钮、遥控器和运动传感器仅向 Home Assistant 发送其电池状态的信息，没有事件，因此无法用于自动化。如果你想与这些设备进行自动化，你需要使用类似 ZHA 的东西，或者上述提到的 HomeKit 设备 集成。
  • 你在应用中找到的组不会导入到 Home Assistant，因为已知会导致稳定性问题。我们建议你使用原生的 灯光组。