Aqara-绿米HomeKit浴霸T1之空调 空调
设备资料
型号
HomeKit浴霸T1之空调
型号说明
以Zigbee3.0接入绿米网关，再通过HomeKit接入主机内置的HA
标牌照片
外观照片
特殊说明
测试时使用绿米网关E1青春版，设备能力与绿米开放的HomeKit能力一致，包含关机（待机）、制热（暖风）、风速、设定温度、环境温度，不包含换气、干燥、吹风，不包含摆风。如果绿米HomeKit开放了更多关于本设备的能力，可联系我司技术支持添加相应能力。
设备参数
| 名称 | 字段 | 取值 | 备注 |
|---|---|---|---|
| 品牌 | brand | ha_homekit | |
| 设备 | device | aircon | |
| 型号 | model | homekit | |
| 实体 | entity | 根据实际填写 | 对应HomeAssistant中的实体ID，可通过主机配置工具直接生成，不需要手动配置 |
设备功能
| 通道 | 字段 | 类型 | 权限 | 取值 | 备注 | 其他 |
|---|---|---|---|---|---|---|
| temperature | 温度 | number | 只读 | 精度 - 1，单位 - °C | ||
| mode | 模式 | enum | 读写 | off - 关闭，heat - 制热，prev - 上一个，next - 下一个 | ||
| fan | 风速 | enum | 读写 | low - 低风，mid - 中风，fan - 送风，prev - 上一个，next - 下一个 | ||
| settemp | 设定温度 | number | 读写 | 16 - 最小值，45 - 最大值，inc5，inc10，dec5，dec10 | 精度 - 1，单位 - °C |
环境要求
- 需要Aqara绿米网关（不是米家网关）
- 支持Zigbee 3.0以接入浴霸T1
- 支持HomeKit以接入HA，进而接入DCS
- Aqara网关升级到最新固件
- 实测E1青春版（本文档中描述的流程，均以E1测试为准），其它型号可以满足上述要求即可
- DCS主机与Aqara网关牌同一个局域网的同一网段
- HA版本号>=2023.12.3
- DCS主机版本号>=2024.0115
HomeKit兼容性
- 使用绿米网关本身的HomeKit能力，接入到主机内置HA的HomeKit设备
- 如果添加到主机内置HA，则需要通过HA的HomeKit桥接功能，再添加其到苹果HomeKit家庭中。注：添加到苹果HomeKit家庭中之后，一定要使用主机配置工具备份HA。
添加流程
- 启动DCS主机内置的HA，登录HA配置网页
- 使用Aqara Home APP添加Aqara网关并入网
- 添加浴霸T1，将其接入Aqara网关（接入前不要在HA网页中添加Aqara网关）
- HA网页自动发现设备，点击配置，输入配对码，即可完成配置.
- 使用仪表盘，测试照明控制、空调控制，是否能正常控制。
- 注：暖风模式耗电量大，请注意用电安全。
- 在主机配置工具中，添加HA HomeKit设备，导出EXCEL，将EXCEL再导入DCS主机。
问题排查
- DCS主机和HA问题排查
- 确认DCS主机版本号、HA版本号满足上文中的环境要求
- HA网页有时可能会自动发现2个AqaraHub设备，只有1个可以添加成功。
- 添加成功后会出现2个可控制设备，即照明和温控。
- 仅在Aqara网关重置且入网后，且HA已经在正常运行，才能自动发现。如果先重置，再启动HA，可能无法自动发现
- 检查HA是否在正常运行。如果内置HA未启动，使用最新版本的主机配置工具（点我下载），点击HA配置，即可启动HA
- Aqara网关问题排查
- Aqara网关升级到最新固件
- 重置Aqara网关。重置步骤：
- 将Aqara网关添加到Aqara Home APP之后，在设备详情页点击移除设备
- 此时，E1网关指示灯立刻变成黄色快闪，进入重置状态。
- 注：一定要在Aqara Home APP中移除设备，
- 如果添加到HA中，或者苹果家庭APP中，也要相应的删除设备。
- 注：直接长按重置，可能导致无法添加到HA和苹果家庭APP。
- 路由器与网络排查
- 需要在同一局域网的同一网段。注：尤其做全宅WiFi时，一定要同一网段，否则可能导致通讯不上无法添加成功
- 使用苹果家庭APP尝试添加，是否可以添加成功（若成功，要在家庭APP中删除该设备，否则无法添加到HA）
- Aqara网关需要连接家中2.4Gwifi使用
- 如果是双频路由器需要先关闭5G频段，入网成功后再打开
- wifi6路由器需要打开wifi5兼容模式
- 更换路由器尝试
对接资料
通讯方式
| 参数 | 值 |
|---|---|
| 通讯方式 | HA_HOMEKIT |
设备配置及联动示例
建议通过主机配置工具生成设备配置，KNX联动部分可参考本示例 主机版本2024-01-15及以上支持备注
无
- 测试485设备时，请务必遵循按以下步骤，以确保对接的设备可以正常工作：
- （1）请导入本文档中的示例，如需要修改设备参数，详见参数说明
- （2）请务必使用本示例，不要将本示例合并至原有EXCEL中测试，测通示例后再加行修改或合并
- （3）使用APP测试，不添加KNX联动，以测试对接是否正常
- （4）导入示例后，不进行任何的控制，查看APP中是否能够读取到设备的状态
- （5）使用APP进行控制，确保各个功能可以正常控制
- （6）控制后，观察60秒后APP是否恢复为控制前的状态（以防受控设备状态回滚）。60秒是个通常意义下的测试值，并非绝对意义下的一定有效的值。
- （7）设备主动改变状态后（例如设备自带面板遥控器等），APP能否正常更新到状态，更新状态有延迟，一般60秒轮询更新，以及打开APP时会更新。
注：协议和示例下载链接(蓝色带下划线)，请确保电脑联网，点击后在浏览器中打开或下载