RRouterOS 中文手册
容器/Pair Claire with Home Assistant on hAP be³ Media

Pair Claire with Home Assistant on hAP be³ Media

中文英文原文
官方原文约 8 分钟阅读

在 hAP be³ Media 上安装支持 Thread 的 Home Assistant 应用，并使用 Home Assistant Companion 应用配对你的 Claire 空气质量传感器。

在 hAP be³ Media 上将 Claire 或 Claire Lite 空气质量传感器与 Home Assistant 配对，即可在手机或浏览器中查看传感器读数，并在自动化与告警中使用它们。

Claire 通过 Matter over Thread 连接。路由器内置的 Thread 无线电提供无线连接，homeassistant-thread 应用包含 Home Assistant、OpenThread Border Router 与 Matter 服务器。

说明

在较早的 RouterOS 版本中，该应用名为 ha-otbr-matter。请选择路由器应用目录中可用的支持 Thread 的应用。

开始之前

开箱状态下，hAP be³ Media 已配置 Apps、安装所需软件包，并在 device-mode 中启用容器支持。你可以直接进入 Home Assistant 应用安装步骤。

请准备以下内容：

  • 一台可访问互联网的 hAP be³ Media。
  • 一个连接到路由器的 USB 磁盘，用于应用存储。如果该磁盘尚未在 RouterOS 中准备好，请按照磁盘设置说明操作。
  • 一台已通电且位于路由器范围内的 Claire 或 Claire Lite。
  • 一部已安装 Home Assistant Companion 应用、启用蓝牙并能访问路由器 Wi-Fi 网络的手机。

将计算机与手机连接到路由器的本地网络，以便进行设置与配对。

如果你重新安装了 RouterOS 或重置了设备，请检查已安装 container 软件包，并在 device-mode 中启用了容器支持。必要时恢复这些设置。确认 device-mode 变更需要物理接触路由器。如果应用配置缺失，请运行 Apps 设置向导。

安装 Home Assistant 应用

  1. 使用 WinBox 或 WebFig 连接 hAP be³ Media，打开 App 菜单。

  2. 如果尚未配置应用存储与网络，请选择 Setup。选择 USB 磁盘、LAN 网桥与路由器的 LAN IP 地址。详情请参阅 Apps 设置向导。

    WinBox App 设置向导，已选择 usb1 作为 Apps 磁盘

  3. 选择 homeassistant-thread（较早的 RouterOS 版本中为 ha-otbr-matter），然后选择 Enable。

    WinBox 应用目录显示 homeassistant-thread，包含 Home Assistant、OpenThread Border Router 与 Matter 服务器

  4. 等待应用下载、解压并启动。该应用包含多个容器镜像，安装可能需要几分钟。

  5. 打开应用的 UI URL 链接以访问 Home Assistant。

Apps 系统会自动配置容器及其网络。

在手机上设置 Home Assistant

  1. 在 Home Assistant 欢迎页面创建管理员账户并完成初始设置。
  2. 在手机上打开 Home Assistant Companion 应用。
  3. 选择你的 Home Assistant 实例。如果未自动发现，请输入与 UI URL 相同的地址。
  4. 使用你在 Home Assistant 中创建的用户名与密码登录。
  5. 允许配对所需的权限，包括蓝牙与相机访问权限。

使用手机上的 Companion 应用配对 Claire。配对后，你可以在 Companion 应用或 Home Assistant Web 界面中查看其读数。

配对 Claire

  1. 在 Home Assistant Companion 应用中打开 Settings → Devices & services，选择 Matter。
  2. 选择 Add device。如果询问设备是否已在使用中，对于尚未配对的 Claire 请选择 No, it's new。按提示打开二维码扫描器。
  3. 在 Claire 上按住侧边按钮 3 秒，打开设置菜单。
  4. 使用短按在选项中高亮 Pairing code。
  5. 按住按钮 1 秒 以显示 Matter 配对二维码。
  6. 使用 Companion 应用扫描 Claire 屏幕上的二维码，等待配对完成。设置期间请让手机靠近 Claire。
  7. 为设备命名并分配到区域，例如 Living room。

如果 30 秒内没有按钮输入，Claire 会返回主屏幕。如果二维码在扫描前消失，请再次打开 Pairing code。

查看传感器读数

在 Home Assistant 中打开 Settings → Devices & services → Matter，选择 Claire。其设备页面会显示可用的传感器读数。显示的传感器取决于你的 Claire 型号。

你可以将读数添加到仪表板，或创建自动化，例如当 CO₂ 超过你设定的阈值时发送通知。请保持 Claire 通电并处于 Thread 覆盖范围内，以便 Home Assistant 接收更新。

配对未能完成时

手机与二维码

  • 请使用手机上的 Home Assistant Companion 应用进行配对。配对完成后可改用 Web 界面查看读数。
  • 启用蓝牙，并在应用请求时允许相机、蓝牙或附近设备以及本地网络权限。配对期间请让手机靠近 Claire。
  • 如果 iPhone 反复拒绝配对，请重启 iPhone，重新打开 Companion 应用后重试。
  • 如果二维码消失，请再次在 Claire 上打开 Pairing code。如果 30 秒内没有按钮输入，其屏幕会返回主视图。

Home Assistant 与 Thread

  • 确认 homeassistant-thread 应用（较早的 RouterOS 版本中为 ha-otbr-matter）已完成启动，且其 UI URL 可以打开。
  • 让手机保持在路由器的本地 Wi-Fi 网络。启用客户端隔离的访客网络或手机上的 VPN 可能会阻止本地发现与通信，即使 Home Assistant 网页可以打开。请断开手机 VPN，并使用主 LAN 进行配对。
  • Matter 使用本地 IPv6 与组播发现。如果你自定义了路由器网络或防火墙配置，请检查已允许 IPv6，以及 Home Assistant、手机与 Thread 边界路由器之间所需的本地通信。
  • 在 Home Assistant 的 Settings → Devices & services 中检查 Matter、Thread 与 OpenThread Border Router 集成。重试前先解决任何报告的设置错误。
  • 如果手机提示需要 Thread 边界路由器，请检查 Thread 集成并确认 hAP be³ Media 的 Thread 网络可用。如果你有多个 Thread 网络，请检查优先使用的是哪一个。重试前请完成 Home Assistant 与 Companion 应用中的所有 Thread 凭据传输或同步提示。
  • 设置期间将 Claire 移近 hAP be³ Media。配对后请让它保持在 Thread 覆盖范围内，以便持续提供读数。

已有配对与传感器更新

  • 如果 Claire 已与另一个家庭配对，而你想替换该配对，请先在 Claire 的设置菜单中使用 Unpairing，然后重复上述步骤。这会移除其现有配对。
  • 通电后请留出最多 10 分钟让 Claire 的传感器稳定。读数更新间隔不同：CO₂ 每 30 秒更新一次，颗粒物每 5 分钟更新一次。读数短时间内保持不变并不一定表示连接有问题。

按钮控制与取消配对说明请参阅 Claire 硬件手册。