Warning
本项目为非官方 Home Assistant 集成，未获得华为或相关平台的授权、认可或支持。 项目仅用于学习、交流与技术研究，请勿用于商业用途或其他违反适用法律、平台规则和服务条款的行为。
Huawei SmartHome
项目说明
这是一个 Home Assistant 自定义集成，用于接入华为智慧生活设备。
华为 IoT 产品建模和协议在不同产品间差异较大，本项目不提供覆盖全部产品的通用协议转换器。仅当拥有实际设备的用户完成测试并贡献对应的单品适配器后，集成才会为该产品创建设备实体。
未提供适配器的产品不会创建实体，这是避免错误状态映射和控制命令的设计选择。
当前已接入的产品清单见已接入设备。该清单以仓库中实际存在的 prod_<prodId>.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、日志或其他敏感数据。
- 新增或修改适配器后，同步更新已接入设备清单。
适配器通过 EntitySpec 声明实体及其状态、属性和操作；可参考已接入清单中的 prod_100z.py 实现。
数据与隐私
本集成运行在用户自己的 Home Assistant 环境中。为完成登录和设备同步，Home Assistant 会在本地保存必要的账号会话和集成配置数据。
请妥善保护 Home Assistant 主机、备份、日志、诊断信息和 .storage 目录。排查问题时，请先移除账号、令牌、设备标识和其他敏感信息后再分享内容。
反馈问题
提交 Issue 时请说明产品 ID、Home Assistant 版本、集成版本和可脱敏的报错信息。设备协议问题请尽可能提供已脱敏的字段结构，以及实际设备上的测试结果。
许可证
本项目以 GNU General Public License v3.0 only（GPL-3.0-only）发布。