Skip to content

BeHome Home Assistant 集成

GitHub ReleaseGitHub Activity

hacsCommunity Forum

BeHome(巴法云)智能家居设备的 Home Assistant 集成。

此集成通过 Home Assistant 提供基于云端的 BeHome/巴法云物联网设备控制功能。

功能特性

  • OAuth2 身份验证:与 BeHome 云端的安全身份验证
  • 多平台设备支持:自动同步巴法云设备到Home Assistant,支持控制各种设备类型,包括:
    • 开关和插座
    • 支持调光的灯具
    • 可变速风扇
    • 气候设备(空调)
    • 窗帘/百叶窗
    • 热水器
    • 媒体播放器(电视)
    • 空气净化器
    • 传感器
  • 实时状态更新:每分钟轮询设备状态
  • 区域集成:自动映射到 Home Assistant 区域

安装方法

HACS 安装(推荐)

  1. 在 Home Assistant 中打开 HACS
  2. 进入"集成"页面
  3. 点击"浏览和下载存储库"
  4. 搜索 "BeHome"
  5. 下载并重启 Home Assistant

手动安装

  1. 使用您选择的工具打开 Home Assistant 配置目录(包含 configuration.yaml 的目录)
  2. 如果没有 custom_components 目录,请创建一个
  3. custom_components 目录中创建名为 behome 的新文件夹
  4. 从此存储库的 custom_components/behome/ 目录中下载所有文件
  5. 将下载的文件放置在您创建的新目录中
  6. 重启 Home Assistant

配置说明

仅采用OAuth2登录方式的用户需要配置,使用用户私钥登录的用户无需配置。

步骤 1:设置 OAuth2 应用程序凭据

在添加集成之前,您需要在 Home Assistant 中配置 OAuth2 凭据:

  1. 进入 设置设备与服务助手 选项卡
  2. 点击 "创建助手""应用程序凭据"
  3. 填写以下信息:
    • 名称BeHome(或您自定义的名称)
    • behome
    • 客户端 ID88ac425b4558463aa813aed1690db730
    • 客户端密钥:输入您的自定义密钥(可以使用任何安全字符串)
  4. 点击 "创建"

步骤 2:添加集成

  1. 进入 设置设备与服务集成
  2. 点击 "+ 添加集成" 并搜索 "BeHome"
  3. 选择 BeHome 集成
  4. 选择您在步骤 1 中创建的应用程序凭据
  5. 按照 OAuth2 身份验证流程授权 Home Assistant
  6. 您的 BeHome 设备将被自动发现并添加

步骤 3:设备配置

身份验证完成后,您的所有 BeHome 设备将自动导入并配置。集成将:

  • 根据设备类型为每个设备创建实体
  • 将设备映射到相应的 Home Assistant 区域(如果区域名称匹配)
  • 设置每分钟自动状态轮询

设备类型

集成会自动将 BeHome 设备类型映射到相应的 Home Assistant 平台:

BeHome 类型Home Assistant 平台描述
outletswitch智能插座和开关
lightlight支持调光的智能灯具
fanfan可变速风扇
airconditionclimate空调设备
curtaincover窗帘和百叶窗
waterheaterwater_heater热水器
televisionmedia_player电视和媒体设备
airpurifierair_purifier空气净化器
sensorsensor各种传感器

支持与反馈

贡献

欢迎贡献!请阅读我们的贡献指南并提交拉取请求以帮助改进此集成。


常见问题

Q: 设备不显示或无法控制怎么办?

A: 请检查:

  1. 巴法云 云端账户是否正常
  2. 设备在 巴法云 应用中是否在线
  3. OAuth2 凭据配置是否正确
  4. Home Assistant 日志中是否有错误信息

Q: 支持哪些 巴法云 设备?

A: 集成支持所有通过 巴法云 云端 API 提供的设备类型,包括开关、灯具、风扇、空调、窗帘、热水器、电视、空气净化器和传感器等。

Q: 设备状态更新频率是多少?

A: 集成每分钟轮询一次设备状态,确保状态信息的及时性。


巴法开放联盟