公牛设备接入教程
公牛（Bull）智能设备可以通过第三方集成「Bull iot」接入 Home Assistant。本教程演示如何借助 HACS 安装 MosHome，再添加 Bull iot 集成，使用公牛智家账号将公牛智能设备纳入 Home Assistant 统一管理。
在开始之前，请确认以下条件，并参考下方的版本信息表：
- 你的 Home Assistant 已经正常运行，并能正常访问后台。
- 你的 Home Assistant 已经安装好 HACS（如未安装，请先查看《HACS 使用方法》）。
- 你拥有一个 公牛智家 App 账号，并已在公牛智家 App 中绑定好对应的公牛智能设备。
| 名称 | OS | Core | Bull iot |
|---|---|---|---|
| 版本 | 17.0 | 2026.2.2 | — |
提示：请先查看《HACS 使用方法》后，再进行本教程。
第 1 步：在 HACS 中搜索并下载 MosHome
Section titled “第 1 步：在 HACS 中搜索并下载 MosHome”打开 HACS，在 HACS 中搜索 MosHome，找到后下载安装。
第 2 步：重启 Home Assistant
Section titled “第 2 步：重启 Home Assistant”依次点击 设置 > 开发者工具 > 重启（restart），重启 Home Assistant，使刚刚下载的集成生效。
第 3 步：添加 Bull iot 集成
Section titled “第 3 步：添加 Bull iot 集成”重启完成后，依次点击 设置 > 设备与服务 > 集成 > 添加集成，在搜索框中输入 bull iot，点击搜索结果进行添加。
第 4 步：输入公牛智家账号登录
Section titled “第 4 步：输入公牛智家账号登录”在弹出的登录表单中，输入你的 公牛智家账号和密码，然后点击 提交，即可完成公牛设备的接入。
| 问题 | 解决办法 |
|---|---|
| HACS 中搜不到 MosHome | 确认 HACS 已正确安装并能正常打开；尝试刷新 HACS 列表或重启一次 Home Assistant 后再搜。 |
| 下载 MosHome 后搜不到 Bull iot 集成 | 必须先按第 2 步重启 Home Assistant，集成才会出现在「添加集成」列表中。 |
| 登录提示账号或密码错误 | 核对公牛智家 App 的账号与密码是否正确，确保使用的是公牛智家（而非其它）App 的账号。 |
| 登录成功但看不到设备 | 确认这些设备已在公牛智家 App 中绑定成功并在线。 |
公牛设备接入的核心流程是：HACS 下载 MosHome → 重启 Home Assistant → 添加 Bull iot 集成 → 输入公牛智家账号密码登录，完成后即可在 Home Assistant 中管理你的公牛智能设备。