德斯曼智能锁homeassistant集成

将德施曼智能锁接入 Home Assistant。集成通过德施曼云端接口获取门锁状态、开门记录及设备信息，并提供动态密码和数字密码管理服务。

实体

类型	实体
门锁	门锁状态、最近开门用户及开门记录等属性
传感器	门锁电量、猫眼电量、电池状态、最近开门用户、开门方式、开门时间、开门日志、告警日志、操作日志、网络信号
诊断传感器	Wi-Fi、网络模式、软件版本、指纹、人脸及门铃音量等信息

部分实体是否有值取决于门锁型号、硬件能力和云端返回的数据。

Note

门锁实体可在 Home Assistant 主机能发现门锁蓝牙信号时执行开锁。官方 App 未提供主动上锁指令，上锁仍依赖门锁自身的自动上锁机制；调用上锁会直接返回错误。

安装

通过 HACS 安装（推荐）

1. 确保 Home Assistant 已安装 HACS。
2. 打开 HACS，进入 集成。
3. 打开右上角菜单，选择 自定义存储库。
4. 添加存储库地址 https://github.com/chliny/ha-desmanlock，类别选择 集成。
5. 搜索并安装 Desman Lock。
6. 重启 Home Assistant。

后续版本可直接通过 HACS 更新。

手动安装

1. 下载本项目的最新 Release，或克隆本仓库。

2. 将 custom_components/desmanlock 目录复制到 Home Assistant 配置目录下的 custom_components：

   <config>/custom_components/desmanlock/
   

3. 确认目录中包含 manifest.json、config_flow.py 等文件。

4. 重启 Home Assistant。

配置

1. 进入 设置 → 设备与服务。
2. 点击 添加集成。
3. 搜索 Desman Lock 或 德施曼智能锁。
4. 输入德施曼账号手机号、密码和区域 ID。中国大陆账号通常保持默认区域 ID 1。
5. 如果账号绑定了多把门锁，选择需要接入的门锁。再次添加集成并选择其他门锁，即可将同一账号下的多把门锁全部接入。

已知限制

• 依赖德施曼云端和网络连接，无法离线工作。
• 门锁状态根据最近一条开门/自动上锁记录推断，可能与门锁实时物理状态存在延迟或差异。
• 蓝牙开锁要求 Home Assistant 主机（或支持主动连接的蓝牙代理）位于门锁通信范围内。
• 成功建立 GATT 连接后，集成会保持并复用该连接，直到门锁主动断开或集成卸载。
• 集成会读取门锁协议配置，并按 App 规则选择标准或 DH 密钥参数；ID2 安全芯片协议依赖厂商原生认证库，目前会明确返回不支持错误。
• App 协议只提供主动开锁；调用上锁会直接返回不支持错误。

故障排查

• 添加集成失败时，先确认手机号、密码、区域 ID 正确，并确认德施曼 App 可正常登录。
• 实体暂时不可用时，检查 Home Assistant 是否可以访问 nyuwa.dsmxp.com。
• 如需提交问题，请附上 Home Assistant 版本、集成版本、门锁型号和已脱敏的相关日志。请勿公开账号、密码、动态密码、数字密码、Token 或门锁 ID。

开启 Debug 日志

在 Home Assistant 中进入“设置 → 设备与服务 → 集成”，打开“德施曼智能锁”集成页面，在右上角菜单中选择“启用调试日志记录”。重新操作以复现问题后，再次打开菜单并选择“禁用调试日志记录”，Home Assistant 会自动下载调试日志文件。

也可以在 configuration.yaml 中添加以下配置并重启 Home Assistant：

logger:
  logs:
    custom_components.desmanlock: debug

问题排查结束后，建议删除以上配置或将日志级别恢复为 info，避免产生过多日志。

免责声明

使用本集成产生的风险由使用者自行承担。请妥善保护 Home Assistant 实例及德施曼账号，尤其是在使用密码管理服务时。