[!WARNING]

本项目为非官方 Home Assistant 集成，未获得华为或相关平台的授权、认可或支持。

项目仅用于学习、交流与技术研究，请勿用于商业用途或其他违反适用法律、平台规则和服务条款的行为。

Huawei SmartHome

项目说明

这是一个 Home Assistant 自定义集成，用于接入华为智慧生活设备。

华为 IoT 产品建模和协议在不同产品间差异较大，本项目不提供覆盖全部产品的通用协议转换器。仅当拥有实际设备的用户完成测试并贡献对应的单品适配器后，集成才会为该产品创建设备实体。

未提供适配器的产品不会创建实体，这是避免错误状态映射和控制命令的设计选择。

当前已接入的产品清单见已接入设备。该清单以仓库中实际存在的 prod_.py 适配器为准。

已接入设备

设备名称、厂商和设备类型来自华为全量 IoT 资料目录。查看当前已接入的产品列表，请参阅已接入设备清单。

快速上手

1. 安装

通过 HACS 安装

在 HACS 中进入：

HACS -> 右上角菜单 -> 自定义仓库

添加仓库地址：

https://github.com/xiasi0/ha-huawei-smarthome

仓库类型选择“集成（Integration）”。添加后，搜索并下载 Huawei SmartHome，然后重启 Home Assistant。

手动安装

将 custom_components/huawei_smarthome 复制到 Home Assistant 配置目录：

/config/custom_components/huawei_smarthome

复制完成后，重启 Home Assistant。

2. 添加集成

在 Home Assistant 中进入：

设置 -> 设备与服务 -> 添加集成 -> Huawei SmartHome

如果列表中没有看到 Huawei SmartHome，请确认：

• 目录路径为 /config/custom_components/huawei_smarthome。
• Home Assistant 已重启。
• manifest.json 位于 huawei_smarthome 目录中。

3. 完成登录、验证与家庭选择

按照页面提示输入华为账号和密码。如果华为要求额外验证，集成会显示可用的验证方式：

• 短信验证码：选择绑定手机号，集成会请求华为发送验证码；收到后输入验证码完成验证。
• 设备挑战码：选择已登录的华为设备推送，在该设备上查看挑战码后输入。

验证成功后，选择需要接入的华为家庭。

4. 查看实体

配置完成后，在 Huawei SmartHome 设备页面查看已创建的实体。实体由设备的产品适配器决定；没有适配器的产品不会显示实体。当前支持范围请以已接入设备清单为准。

产品适配器贡献

欢迎拥有实际设备的用户贡献适配器。提交前请先检查已接入设备清单，确认该 prodId 尚未接入。每个产品的适配器位于：

custom_components/huawei_smarthome/device_adapters/prod_<产品ID>.py

贡献前请确保：

• 使用实际设备验证状态读取和每个控制命令。
• 根据该设备 Profile 中的字段范围、枚举值和单位进行转换，不要复用未经验证的其他产品规则。
• 不要提交账号、令牌、设备序列号、完整 Profile、日志或其他敏感数据。
• 新增或修改适配器后，同步更新已接入设备清单。

数据与隐私

本集成运行在用户自己的 Home Assistant 环境中。为完成登录和设备同步，Home Assistant 会在本地保存必要的账号会话和集成配置数据。

请妥善保护 Home Assistant 主机、备份、日志、诊断信息和 .storage 目录。排查问题时，请先移除账号、令牌、设备标识和其他敏感信息后再分享内容。

反馈问题

提交 Issue 时请说明产品 ID、Home Assistant 版本、集成版本和可脱敏的报错信息。设备协议问题请尽可能提供已脱敏的字段结构，以及实际设备上的测试结果。

许可证

本项目以 GNU General Public License v3.0 only（GPL-3.0-only）发布。