将 Home Assistant 中的设备同步到巴法云。
Bemfa Cloud 会把 HA 里的本地实体映射为巴法云 TCP V2 设备，让用户可以通过巴法云、小爱同学等入口控制 HA 设备。
简体中文 | English
- 两种认证方式：支持直接输入巴法云私钥，也支持 OAuth 登录
- 按需创建主题：选择需要同步的 HA 实体后，创建为巴法云 TCP V2 主题
- 批量创建：多个设备会优先使用批量接口创建
- TCP 长连接：使用巴法云 TCP JSON V2 长连接订阅控制消息
- 状态同步：HA 状态变化会同步到巴法云云端缓存
- 昵称和房间同步：HA 中修改实体昵称、区域或区域名称后，会同步到巴法云设备昵称和房间
- 同步关系更稳定：修改实体昵称或房间后，通常不会重复创建巴法云设备
- 来源过滤：自动跳过 BeHome 生成的 HA 实体，避免把巴法云设备再次同步回巴法云
| 巴法云后缀 | 设备类型 | HA 默认映射 |
|---|---|---|
001 |
插座 | switch 且 device_class=outlet |
002 |
灯泡 | light |
003 |
风扇 | 普通 fan |
004 |
传感器 | sensor、binary_sensor |
005 |
空调 | 支持制冷/制热的 climate |
006 |
开关 | switch、input_boolean、script、automation、remote，以及其他支持 turn_on/turn_off 的实体 |
009 |
窗帘 | cover |
010 |
温控器 | 非空调类 climate |
011 |
热水器 | water_heater |
012 |
电视 | media_player |
013 |
空气净化器 | fan 且 device_class=air_purifier |
- 在 Home Assistant 中打开 HACS
- 进入 集成
- 点击 浏览和下载存储库
- 搜索 Bemfa Cloud
- 下载并重启 Home Assistant
如果 HACS 商店暂未收录，或者需要测试开发版本：
- 在 HACS 的右上角菜单中选择 自定义存储库
- 填写存储库地址：
https://github.com/bemfa/bemfa_cloud_ha - 类型选择 集成
- 添加后搜索 Bemfa Cloud 并下载
- 重启 Home Assistant
- 打开 Home Assistant 配置目录，也就是包含
configuration.yaml的目录 - 如果没有
custom_components目录，请创建一个 - 将本仓库的
custom_components/bemfa_cloud复制到 HA 的custom_components目录中 - 重启 Home Assistant
如需同步到多个巴法云账号，可以重复添加 Bemfa Cloud 中枢。每个中枢绑定一个账号，并可单独选择要同步的 HA 实体。
- 进入 设置 -> 设备与服务 -> 添加集成
- 搜索 Bemfa Cloud
- 选择 私钥
- 输入巴法云用户私钥
uid - 保存后，进入 Bemfa Cloud 的配置页面，选择需要同步的 HA 实体。批量添加默认只展示空调、窗帘、灯、开关等主设备；状态和诊断类实体可通过“添加单个同步”手动添加。
大多数用户建议使用私钥方式。OAuth 登录复用 BeHome 的认证方式，主要用于需要 BeHome 授权流程的场景；仅使用 OAuth 登录的用户需要先配置应用程序凭据。
- 进入 设置 -> 设备与服务 -> 助手 -> 应用程序凭据
- 创建新的应用程序凭据：
- 名称：
Bemfa Cloud - 域：
bemfa_cloud - 客户端 ID：
88ac425b4558463aa813aed1690db730 - 客户端密钥：可填写任意安全字符串
- 名称：
- 回到 集成 页面添加 Bemfa Cloud
- 选择 OAuth 并完成授权
如果授权后跳转到 homeassistant.local 并提示无法访问，请在 Home Assistant 的 设置 -> 系统 -> 网络 中配置正确的 Home Assistant URL。Docker 本机测试可使用 http://localhost:8123，局域网访问可使用 http://HA主机IP:8123。
- 本集成方向是 HA -> 巴法云
- BeHome 集成方向是 巴法云 -> HA
- 两个集成可以同时安装，但 Bemfa Cloud 会跳过 BeHome 生成的实体，避免重复同步或控制回环
- 同一个 HA 实体可以分别添加到不同 Bemfa Cloud 中枢，每个中枢的同步配置互相独立
- 集成会尽量使用 HA 的稳定实体标识生成巴法云 topic；没有稳定标识的实体会退回使用
entity_id，修改entity_id后可能创建新的巴法云主题 - 从旧版本升级后，如果巴法云里出现重复设备，可在巴法云控制台手动删除旧设备
请检查巴法云私钥是否正确、Home Assistant 是否可以访问外网，并查看 Home Assistant 日志中的 Bemfa Cloud 错误信息。
不会。它只会停止本集成继续同步该实体，巴法云云端主题需要在巴法云控制台手动删除。
没有稳定标识的实体修改 entity_id 后，可能会在巴法云创建新的设备。
fan=0 表示自动风速，fan=1 到 fan=5 表示一档到五档风速，fan=7/8/9 分别表示低风、中风、高风。不同空调实体支持的风速名称不同，可在“编辑同步配置”里调整映射。
- 集成读取 HA 中支持的实体
- 排除 BeHome 和 Bemfa Cloud 自身生成的实体
- 根据实体类型生成巴法云设备 topic
- 使用 NoSecret 接口创建主题，固定
type=7、region=cn-03 - 通过 TCP V2 长连接批量订阅所有 topic
- 收到巴法云控制消息后调用 HA 服务控制实体
- HA 实体状态变化后，同步状态到巴法云
感谢 larry-wong/bemfa 项目提供的参考和启发。
本项目使用 MIT 许可证 - 查看 LICENSE 文件了解详情。