将“好太太智联”账号中的设备接入 Home Assistant。
- 通过 Home Assistant 界面完成账号配置；
- 自动发现账号直接绑定的设备，并递归发现网关子设备；
- 支持晾衣架、窗帘、插座、墙壁开关、灯带、环境与安防传感器等设备；
- 轮询中发现新设备或新能力时，无需重载集成即可补充实体；
- 为每台设备创建“连接”和“状态”诊断实体；
- 支持查询设备信息、设备状态、场景、历史记录、OTA 信息、家庭和控制组等数据；
- 支持通过动作设置设备属性或调用设备功能；
不同型号提供的属性和功能可能不同。请以对应设备在“状态”实体中显示的属性， 以及好太太智联 App 中实际提供的功能为准。
- 打开 HACS，进入“集成”。
- 在右上角菜单中选择“自定义存储库”。
- 添加
https://github.com/chliny/ha-hotata，类别选择“集成”。 - 搜索并下载“好太太智联”。
- 重启 Home Assistant。
将本仓库中的 custom_components/hotata 目录复制到 Home Assistant
配置目录的 custom_components 下，然后重启 Home Assistant。
- 打开“设置 → 设备与服务”。
- 选择“添加集成”并搜索“好太太智联”。
- 输入好太太智联 App 使用的手机号或账号及密码。
配置完成后，账号中已绑定的设备会自动添加到 Home Assistant。
集成只为 APK 已确认且设备 TSL/实际上报支持的能力创建实体：
| 设备类型 | Home Assistant 实体 |
|---|---|
| 普通/高级晾衣架 | 衣杆、A/B 杆 cover；主灯、杆灯、夜灯；电源、消毒、风干、烘干、负离子及高级功能开关；位置、剩余时间、版本和故障传感器 |
| 窗帘 v1/v2 | 开、关、停止、位置设置与位置反馈 |
| 插座/墙壁开关 | 电源、分路开关、童锁、指示灯和断电保护 |
| 白光/彩色灯带 | 开关、亮度、色温或 HSV 颜色 |
| 移动、门磁、烟雾、燃气、水浸 | 对应二进制传感器、电量和信号强度 |
| 空气质量 | 温度、湿度、PM2.5、甲醛和电量 |
| 室内报警器 | 报警状态和关闭报警按钮 |
| 场景面板/紧急按钮 | event 实体 |
| 毛巾架 | 当前温度、状态、剩余时间，以及柔烘、暖烘、烘干、除菌、自定义、暂停和继续按钮 |
| 衣物护理机 | 模式/衣物类型、工作时间、故障状态，以及开始和停止按钮 |
| 智能种植设备 | 植物灯、温度、水位、pH 和氮磷钾等传感器 |
| 音乐设备 | 播放/暂停、上一首/下一首、音量、歌曲信息 |
| 广播设备 | 门铃/语音消息开关、布防和声音属性、音量 |
| 网关 | 在线状态，并递归挂载其子设备 |
| 智能锁 | 电量、锁体/反锁/模式/版本等只读传感器；固件上报时提供事件 |
| 摄像头 | 清晰度与移动侦测属性、上下左右 PTZ 按钮 |
每台设备还会创建“连接”和“状态”诊断实体。“状态”的 properties
属性保留云端返回的完整属性包，便于核对新型号。
例如，型号代码 2 代表“照明、消毒”机型，集成不会为它创建无效的风干
或烘干控制。枚举选择和数值控制还必须由 TSL 明确声明为可写，避免把只读
状态误做成控制实体。
摄像头直播使用 App 内置的阿里云 LinkVisual 专有播放器，当前没有确认可供
Home Assistant 使用的标准流地址，因此本集成暂不支持 camera 直播
实体。纯蓝牙、未通过好太太云端绑定的设备同样无法由本云端集成发现。
以下动作风险较高。执行前请确保已明确了解动作的用途、参数及可能产生的影响，并确认自己清楚正在执行的操作。
action: hotata.set_property
data:
iot_id: your_iot_id
property: PowerSwitch
value: 1action: hotata.invoke_service
data:
iot_id: your_iot_id
identifier: your_service_identifier
args:
example: 1查询动作支持 Home Assistant 响应变量：
action: hotata.query
data:
query: ota_info
iot_id: your_iot_id
response_variable: ota可用查询类型会显示在动作编辑器中。部分查询需要在 params 中提供场景 ID、
分页或时间范围等附加参数。
- 设置属性或调用设备功能前，请确认目标设备支持对应标识和值；
- 本集成不提供设备配网、解绑、重置、开锁、临时密码或门锁凭据管理功能；
- 如果账号密码发生变化，请按 Home Assistant 提示完成重新认证。