当前位置：首页 > news >正文

小米智能门锁临时密码终极指南：hass-xiaomi-miot实战配置全解析

news 2026/4/26 14:11:31

小米智能门锁临时密码终极指南：hass-xiaomi-miot实战配置全解析

【免费下载链接】hass-xiaomi-miotAutomatic integrate all Xiaomi devices to HomeAssistant via miot-spec, support Wi-Fi, BLE, ZigBee devices. 小米米家智能家居设备接入Hass集成项目地址: https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot

想要为你的小米智能门锁创建临时密码，让访客、保洁或维修人员安全进出吗？hass-xiaomi-miot作为HomeAssistant中功能最全面的小米设备集成，提供了完整的临时密码管理方案。本文将通过实战演示，带你深度掌握如何利用number组件与服务调用实现智能门锁的临时密码管理。

🚀 快速入门：准备工作与环境配置

在开始配置临时密码前，你需要确保hass-xiaomi-miot已正确安装并运行。如果你还没有安装，可以通过以下命令快速获取：

git clone https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot

安装完成后，在HomeAssistant的集成页面搜索"Xiaomi Miot Auto"进行配置。成功添加设备后，你将在设备列表中看到你的小米智能门锁实体。

🔧 核心组件解析：number.py如何驱动临时密码

hass-xiaomi-miot的number组件位于custom_components/xiaomi_miot/number.py，它继承自HomeAssistant的RestoreNumber类，支持自动模式适配。对于智能门锁，number组件主要管理以下关键参数：

密码有效期：设置临时密码的可用时间范围
使用次数限制：控制密码的最大使用次数
密码相关数值参数：如密码ID、权限级别等

组件通过NumberEntity类与设备进行通信，自动从MIoT协议中获取属性的数值范围、步长和单位信息。当用户通过UI调整数值时，组件会自动调用async_set_native_value方法将新值写入设备。

图片说明：hass-xiaomi-miot项目的小米品牌标识，展示与小米智能家居生态的紧密集成

📋 实战操作：创建你的第一个临时密码

步骤1：确认设备支持

首先检查你的门锁设备是否支持临时密码功能。在HomeAssistant开发者工具中，查看设备属性，寻找类似以下字段：

number_properties: - temp_password_valid_time - use_count_limit - password_id

如果看到这些属性，说明你的设备完全支持临时密码管理功能。

步骤2：通过UI配置临时密码

进入HomeAssistant的实体页面，搜索以"number.xiaomi_"开头的实体
找到与密码有效期相关的实体（通常名为"临时密码有效期"或类似）
点击实体，在弹出的界面中设置有效期（单位通常为分钟）
同样方法设置使用次数限制
保存配置后，系统会自动生成临时密码

步骤3：服务调用高级配置

对于需要自动化或更精细控制的场景，可以使用服务调用方式。在HomeAssistant的开发者工具中，选择"调用服务"：

service: xiaomi_miot.set_property data: entity_id: lock.xiaomi_smart_lock field: temp_password_valid_time value: 1440 # 24小时，单位分钟

🔍 深入理解：服务调用与自动化

hass-xiaomi-miot提供了丰富的服务接口，位于custom_components/xiaomi_miot/services.yaml。对于临时密码管理，最常用的服务包括：

set_property服务

用于设置设备属性值，支持所有数值型参数：

service: xiaomi_miot.set_property data: entity_id: lock.xiaomi_smart_lock field: temp_password_valid_time value: 720 # 12小时有效期

set_miot_property服务

通过MIoT协议的siid/piid直接设置属性，提供更底层的控制：

service: xiaomi_miot.set_miot_property data: entity_id: lock.xiaomi_smart_lock siid: 8 # 锁服务ID piid: 1 # 临时密码有效期属性ID value: 1440 # 24小时

自动化示例：创建定时临时密码

结合HomeAssistant的自动化功能，你可以实现复杂的临时密码策略：

automation: - alias: "创建周末访客临时密码" trigger: platform: time at: "18:00:00" condition: condition: time weekday: - sat - sun action: - service: xiaomi_miot.set_property data: entity_id: lock.xiaomi_smart_lock field: temp_password_valid_time value: 2880 # 48小时 - service: xiaomi_miot.set_property data: entity_id: lock.xiaomi_smart_lock field: use_count_limit value: 10 # 最多使用10次

⚡ 高级技巧：设备自定义配置

如果你需要对特定型号的门锁进行深度定制，可以修改custom_components/xiaomi_miot/core/device_customizes.py文件。这里可以定义设备的特殊属性和行为：

# 示例：为特定门锁型号添加自定义配置 DEVICE_CUSTOMIZES = { "lumi.lock.acn03": { "number_properties": [ "temp_password_valid_time", "use_count_limit", "password_id" ], "number_custom": { "temp_password_valid_time": { "min": 10, # 最短10分钟 "max": 10080, # 最长7天 "step": 10 # 步长10分钟 } } } }