Xiaomi Home Integration for Home Assistant设备支持清单：看看你的设备是否兼容-优快云博客

Xiaomi Home Integration for Home Assistant设备支持清单：看看你的设备是否兼容

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/gh_mirrors/ha/ha_xiaomi_home

你还在为智能家居设备与Home Assistant的兼容性发愁吗？是否曾购买了小米生态链产品却发现无法接入家庭自动化系统？本文将为你提供最全面的Xiaomi Home Integration设备支持清单，帮助你快速判断设备是否兼容，轻松打造智能联动家居系统。

读完本文你将获得：

完整的设备类型与支持状态对照表
各类设备的功能实现细节与限制说明
设备接入失败的排查流程与解决方案
未来设备支持计划与社区贡献指南

设备支持概览

Xiaomi Home Integration for Home Assistant通过MIoT（Xiaomi IoT）协议实现设备接入，支持本地局域网控制与云端控制两种模式。目前已实现对15大类、超过500款小米生态链设备的支持，涵盖了家庭生活的方方面面。

mermaid

设备接入流程

设备接入Home Assistant的流程如下：

mermaid

详细设备支持清单

1. 照明设备

设备类型	支持状态	核心功能	示例型号
智能灯泡	✅ 完全支持	开关、亮度、色温、RGB调色	yeelink.light.color1、philips.light.bulb
智能吸顶灯	✅ 完全支持	开关、亮度、色温、情景模式	yeelink.light.ceiling1、philips.light.zyceiling
智能灯带	✅ 完全支持	开关、亮度、RGB调色、动态效果	yeelink.light.strip1、miot.light.plato2
智能筒灯	✅ 部分支持	开关、亮度、色温	yeelink.light.downlight、philips.light.lnblight1
智能台灯	✅ 完全支持	开关、亮度、色温、阅读模式	philips.light.sread1、yeelink.light.lamp1

功能实现细节

智能灯泡通过light.py实现控制，支持的核心属性包括：

开关状态（on属性）
亮度调节（brightness属性，范围1-100）
色温调节（color-temperature属性，范围2700K-6500K）
RGB颜色控制（color属性，RGB值）

# 灯泡控制示例代码片段
class Light(MIoTServiceEntity, LightEntity):
    def __init__(self, miot_device: MIoTDevice, entity_data: MIoTEntityData) -> None:
        super().__init__(miot_device=miot_device, entity_data=entity_data)
        # 初始化亮度控制
        if prop.name == 'brightness':
            self._brightness_scale = (prop.value_range.min_, prop.value_range.max_)
            self._attr_supported_color_modes.add(ColorMode.BRIGHTNESS)
        # 初始化色温控制
        if prop.name == 'color-temperature':
            self._attr_min_color_temp_kelvin = prop.value_range.min_
            self._attr_max_color_temp_kelvin = prop.value_range.max_
            self._attr_supported_color_modes.add(ColorMode.COLOR_TEMP)

2. 环境控制设备

设备类型	支持状态	核心功能	示例型号
空调	✅ 完全支持	开关、模式、温度、风速、摆风	xiaomi.aircondition.ma1、viomi.aircondition.v10
智能风扇	✅ 完全支持	开关、风速、摇头、模式	dmaker.fan.p5、yeelink.ven_fan.vf1
空气净化器	✅ 完全支持	开关、模式、风速、滤芯状态	zhimi.airpurifier.m1、airdog.airpurifier.x5
加湿器	✅ 部分支持	开关、湿度调节、雾量	deerma.humidifier.jsq1、shuii.humidifier.jsq002
除湿机	⚠️ 有限支持	开关、湿度监测	midea.dehumidifier.mh1

空调控制实现

空调控制通过climate.py实现，支持多种模式切换：

class AirConditioner(FeatureOnOff, FeatureTargetTemperature, FeatureFanMode):
    def __init__(self, miot_device: MIoTDevice, entity_data: MIoTEntityData) -> None:
        super().__init__(miot_device=miot_device, entity_data=entity_data)
        self._attr_hvac_modes = [HVACMode.AUTO, HVACMode.COOL, HVACMode.HEAT, 
                                HVACMode.DRY, HVACMode.FAN_ONLY, HVACMode.OFF]
    
    @property
    def hvac_mode(self) -> Optional[HVACMode]:
        return (HVACMode.COOL if self.get_prop_value(prop=self._prop_mode) == 1 
                else HVACMode.HEAT if self.get_prop_value(prop=self._prop_mode) == 2 
                else HVACMode.OFF)

3. 安防设备

设备类型	支持状态	核心功能	示例型号
智能门锁	✅ 完全支持	开关状态、电量、开锁记录	loock.lock.s30、lumi.lock.acn02
门窗传感器	✅ 完全支持	开关状态、低电量报警	cgllc.magnet.hodor、lumi.sensor_magnet.aq2
人体传感器	✅ 完全支持	motion detection、光照度	cgllc.motion.cgpr1、lumi.sensor_motion.aq2
烟雾报警器	✅ 部分支持	报警状态、自检	lumi.sensor_smoke.v1、fbs.airmonitor.pth02
摄像头	⚠️ 有限支持	实时监控、移动侦测	chuangmi.camera.ipc010、xiaovv.camera.lamp

4. 清洁设备

设备类型	支持状态	核心功能	示例型号
扫地机器人	✅ 完全支持	清扫、暂停、回充、吸力调节	roborock.vacuum.s5、viomi.vacuum.v10
擦地机器人	✅ 部分支持	清扫、回充、水量调节	roborock.vacuum.m1s、viomi.vacuum.v7
空气净化器	✅ 完全支持	开关、模式切换、滤芯状态	zhimi.airpurifier.ma2、dmaker.airfresh.a1

扫地机器人控制

扫地机器人通过vacuum.py实现控制，支持多种清扫模式：

class Vacuum(MIoTServiceEntity, StateVacuumEntity):
    def __init__(self, miot_device: MIoTDevice, entity_data: MIoTEntityData) -> None:
        super().__init__(miot_device=miot_device, entity_data=entity_data)
        self._attr_supported_features = VacuumEntityFeature.START | \
                                        VacuumEntityFeature.STOP | \
                                        VacuumEntityFeature.RETURN_HOME | \
                                        VacuumEntityFeature.FAN_SPEED | \
                                        VacuumEntityFeature.LOCATE
    
    async def async_start(self) -> None:
        """开始清扫"""
        await self.action_async(action=self._action_start_sweep)
    
    async def async_return_to_base(self, **kwargs: Any) -> None:
        """返回充电座"""
        await self.action_async(action=self._action_stop_and_gocharge)

5. 厨房电器

设备类型	支持状态	核心功能	示例型号
智能电饭煲	✅ 部分支持	开关、烹饪模式	chunmi.cooker.eh1、viomi.cooker.v1
智能微波炉	⚠️ 有限支持	开关、火力调节	chunmi.microwave.n20l01
智能烤箱	⚠️ 有限支持	开关、温度控制	chunmi.oven.steam30lv1
油烟机	❌ 暂不支持	-	viomi.hood.a10、fotile.hood.emd1tmi
洗碗机	✅ 部分支持	运行状态、剩余时间	viomi.dishwasher.m01、minij.washer.v1

6. 生活家电

设备类型	支持状态	核心功能	示例型号
智能窗帘	✅ 完全支持	开关、位置调节	lumi.curtain.aq2、090615.curtain.mt800w
智能插座	✅ 完全支持	开关、功率监测	chuangmi.plug.v1、lumi.plug.v1
电热毛巾架	✅ 完全支持	开关、温度调节	ows.towel_w.mj1x0、viomi.waterheater.e1
智能马桶盖	✅ 部分支持	开关、水温调节	xjx.toilet.pro、tinymu.toiletlid.v1
加湿器	✅ 完全支持	开关、湿度控制、雾量调节	deerma.humidifier.mjjsq、shuii.humidifier.jsq001

设备支持状态说明

支持等级定义

✅ 完全支持：所有核心功能可用，包括状态反馈和控制
⚠️ 有限支持：部分功能可用，可能缺少高级功能
❌ 暂不支持：设备无法接入或无法控制

常见不支持原因

协议不兼容：部分旧设备使用非MIoT协议
权限限制：某些设备需要特殊权限才能通过API控制
功能未实现：部分设备功能尚未开发对应组件

设备支持查询方法

如果你想查询特定设备是否支持，可以通过以下方法：

查看custom_components/xiaomi_home/miot/lan/profile_models.yaml文件，搜索设备型号
检查设备是否在上述支持清单中
在集成配置页面使用"设备检测"功能

故障排除与解决方案

设备无法发现

mermaid

设备控制延迟

本地控制模式下设备响应延迟可能由以下原因导致：

网络拥堵 - 尝试优化路由器设置
设备固件过旧 - 更新设备固件
集成版本过旧 - 更新Xiaomi Home Integration到最新版本

功能缺失

如果发现设备支持的功能不完整，可以：

检查是否有新版本集成可用
在GitHub上提交issue，提供设备型号和功能描述
参与社区贡献，提交功能实现代码

未来支持计划

根据社区反馈和开发计划，以下设备类型将在未来版本中重点支持：

智能冰箱：完善温度控制和食品管理功能
洗衣机：增加洗衣程序选择和进度监控
智能电视：实现更丰富的媒体控制功能
新风系统：完善风量调节和滤网状态监测

如何贡献

如果你是开发者，欢迎通过以下方式贡献设备支持：

Fork项目仓库：https://gitcode.com/gh_mirrors/ha/ha_xiaomi_home
实现新设备的组件代码
添加设备型号到支持列表
提交Pull Request

总结

Xiaomi Home Integration for Home Assistant支持大部分小米生态链智能设备，涵盖照明、环境控制、安防、清洁等多个品类。通过本文提供的设备支持清单，你可以快速判断自己的设备是否兼容，并了解其支持的功能范围。

随着集成的不断更新，支持的设备和功能将持续增加。如果你在使用过程中遇到问题，欢迎通过社区渠道反馈，共同完善这个集成。

提示：定期更新集成可以获得最新的设备支持和功能改进

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/gh_mirrors/ha/ha_xiaomi_home

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考