MIOT HomeMIOT Home
小米智能门锁 4 Pro
#xiaomi.lock.s1

小米智能门锁 4 Pro

urn:miot-spec-v2:device:lock:0000A038:xiaomi-s1:1
版本 v3 v2 v1
← 返回产品详情下载米家插件
语言
Service tree
门锁
#2 · lock
属性 17动作 2事件 2

Properties

操作位置
#1 · operation-position
格式
uint8
读写
值
1门内
2门外
3无法区分门内外
操作方式
#2 · operation-method
格式
uint8
读写
值
1手机
2指纹
3密码
4NFC
5人脸
6机械钥匙/应急旋钮
7一次性密码
8周期性密码
9胁迫指纹
10双重验证
11手动
12自动
13掌静脉
14门内按钮开锁
15远程开锁
锁动作
#3 · lock-action
格式
uint8
读写
值
1关门
2开锁
3开启反锁
4关闭反锁
5开启童锁
6关闭童锁
7开启离家模式
8关闭离家模式
异常情况
#4 · abnormal-condition
格式
uint8
读写
值
2密码频繁开锁失败
3指纹频繁开锁失败
4NFC频繁开锁失败
5人脸频繁开锁失败
6掌纹频繁开锁失败
9门锁可能被撬，请及时回家查看
10开锁异常，请重新开门
11离家期间室内开锁或钥匙开锁
12门锁被重置
15指纹传感器异常
18锂电池温度过高，请检查电池
195号电池电量低，请及时更换电池
205号电池电量低，请及时更换电池
21锂电池电量低，请及时充电
22锂电池电量即将耗尽，人脸、掌静脉开锁及摄像头功能不可用
23检测到门锁超时未关，请注意查看
24门虚掩，请及时关门
25门锁可能被撬，请及时回家查看
265号电池被取下
27锂电池被取下，人脸、掌静脉开锁及摄像头功能不可用
28应急供电中
29门锁传感器频繁触发，请将摄像头工作模式调整为省电模式或联系客服处理
30室内充电中
1多次开锁验证失败
31锂电池已充满，电量低于85%后再充电有利于电池寿命
操作ID
#5 · operation-id
格式
uint16
读写
值
0 ~ 65535，步长 1
当前时间（unix timestamp）
#6 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
反锁
#7 · anti-lock
格式
bool
读写
值
—
童锁
#8 · child-lock
格式
bool
读写
值
—
配置物理按键功能
#9 · button-function
格式
uint8
读写
值
0反锁
1童锁
门锁本地设置开关
#12 · door-lock-local-settings
格式
bool
读写
值
—
灵敏度
#13 · face-unlock-sensitivity
格式
uint8
读写
值
0低（识别距离近，约0.5米）
1中（识别距离适中，约0.8米）
2高（识别距离远，约1米）
防误开时长
#14 · face-unlock-sleep-time
格式
uint8
读写
值
00秒
15秒
215秒
330秒
460秒
管理员开反锁开关
#15 · turn-on-the-anti-lock-setting
格式
bool
读写
值
—
重置验证
#16 · reset-with-verification-required-setting
格式
bool
读写
值
—
人脸识别开锁
#17 · face-recognition-unlocking-switch
格式
bool
读写
值
—
掌静脉识别开锁
#18 · palm-vein-recognition-unlocking-switch
格式
bool
读写
值
—
触发方式
#19 · triggering-method
格式
uint8
读写
值
0手动
1自动

Actions

蓝牙开锁
#1 · ble-unlock
蓝牙唤醒设备
#2 · ble-awake-dev

Events

锁事件
#1020 · lock-event
触发参数
#1操作位置uint8#2操作方式uint8#3锁动作uint8#5操作IDuint16#6当前时间（unix timestamp）uint32
发生异常
#1007 · exception-occurred
触发参数
#4异常情况uint8#6当前时间（unix timestamp）uint32
门
#3 · door
属性 1

Properties

门状态
#1021 · door-state
格式
uint8
读写
N / R
值
1已上锁
2已开锁
3门未关
4门虚掩
5开启童锁
6开启反锁
门锁管理
#4 · lock-manage
属性 10动作 8事件 9

Properties

用户id
#1 · user-ids
格式
uint16
读写
值
0 ~ 65535，步长 1
用户类型
#2 · user-type
格式
uint8
读写
值
0我
1管理员
2普通用户
3常访客
4所有用户
5所有普通用户
操作方式
#3 · operation-method
格式
uint8
读写
值
1手机
2指纹
3密码
4NFC
5人脸
6机械钥匙
7一次性密码
8周期性密码
9胁迫指纹
10双重验证
11手动
12自动
13掌静脉
操作ID
#4 · operation-id
格式
uint16
读写
值
0 ~ 65535，步长 1
凭据内容
#5 · credential
格式
string
读写
值
—
当前时间（unix timestamp）
#6 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
错误码
#7 · error-code
格式
uint16
读写
值
0成功
1接收指令成功，执行中
2内部错误
3未找到
4内存已满
5参数错误
6超时
7设备忙
8参数重复
9密码重复
凭据状态
#8 · credential-state
格式
uint16
读写
值
0成功
1失败
1000指纹区域重复
1001指纹质量低
1002指纹面积小
1003按压位置偏
1004指纹湿
1005请抬起手指
2000未检测到人脸
2001人脸太靠近上边沿
2002人脸太靠近下边沿
2003人脸太靠近左边沿
2004人脸太靠近右边沿
2005人脸距离太远
2006人脸距离太近
2007脸部遮挡
2008录入人脸方向错误
2009人脸活体检测失败
3000未检测到手掌
3001手掌太靠近上边沿
3002手掌太靠近下边沿
3003手掌太靠近左边沿
3004手掌太靠近右边沿
3005手掌距离太远
3006手掌距离太近
3007手掌活体检测失败
3008手掌被遮挡
当前要添加的凭据序号
#9 · credential-step-current
格式
uint8
读写
值
0 ~ 255，步长 1
总凭据数量
#10 · credential-step-all
格式
uint8
读写
值
0 ~ 255，步长 1

Actions

配置用户 （支持覆盖）
#1 · add-lock-user
入参
#1用户iduint16#2用户类型uint8
出参
#7错误码uint16#1用户iduint16#2用户类型uint8#6当前时间（unix timestamp）uint32
删除用户
#2 · delete-lock-user
入参
#1用户iduint16#2用户类型uint8
出参
#7错误码uint16
添加开锁方式
#3 · add-unlock-method
入参
#1用户iduint16#3操作方式uint8#4操作IDuint16#5凭据内容string
出参
#7错误码uint16#1用户iduint16#3操作方式uint8#4操作IDuint16#6当前时间（unix timestamp）uint32
取消添加
#4 · cancel-unlock-method
出参
#7错误码uint16
删除开锁方式
#5 · delete-unlock-method
入参
#1用户iduint16#4操作IDuint16
出参
#7错误码uint16
同步用户信息
#6 · sync-lock-user
出参
#7错误码uint16
同步开锁方式
#7 · sync-unlock-method
出参
#7错误码uint16
分配用户信息
#8 · alloc-lock-user
入参
#1用户iduint16#4操作IDuint16#3操作方式uint8
出参
#7错误码uint16

Events

更新用户组
#1 · update-lock-user
触发参数
#7错误码uint16#1用户iduint16#2用户类型uint8#6当前时间（unix timestamp）uint32
更新开锁方式
#2 · update-unlock-method
触发参数
#7错误码uint16#1用户iduint16#3操作方式uint8#4操作IDuint16#6当前时间（unix timestamp）uint32
添加凭据事件
#3 · add-credential-event
触发参数
#8凭据状态uint16#9当前要添加的凭据序号uint8#10总凭据数量uint8
添加用户完成
#4 · add-user-complete
触发参数
#1用户iduint16#2用户类型uint8#6当前时间（unix timestamp）uint32
删除用户完成
#5 · delete-user-complete
触发参数
#1用户iduint16#2用户类型uint8#6当前时间（unix timestamp）uint32
添加开锁方式完成
#6 · add-user-key-complete
触发参数
#1用户iduint16#4操作IDuint16#3操作方式uint8#6当前时间（unix timestamp）uint32
删除开锁方式完成
#7 · delete-user-key-complete
触发参数
#1用户iduint16#4操作IDuint16#3操作方式uint8#6当前时间（unix timestamp）uint32
同步开锁方式完成
#8 · sync-user-key-complete
同步用户完成
#9 · sync-user-complete
门锁历史记录
#5 · lock-history
属性 10动作 1事件 1

Properties

历史数据时间戳
#5 · history-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
历史数据最新时间戳
#6 · last-history-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
门铃事件历史数据上报
#11 · doorbell-data-string
格式
string
读写
值
—
异常事件历史数据上报
#12 · abnormal-data-string
格式
string
读写
值
—
门状态历史数据上报
#13 · door-data-string
格式
string
读写
值
—
用户删除
#14 · user-delete-string
格式
string
读写
值
—
用户添加
#15 · user-add-string
格式
string
读写
值
—
钥匙添加
#16 · user-key-add-string
格式
string
读写
值
—
钥匙删除
#17 · user-key-delete-string
格式
string
读写
值
—
锁事件历史数据上报
#18 · lock-history-string
格式
string
读写
值
—

Actions

触发历史记录上报操作
#1 · history-notify-action
入参
#5历史数据时间戳uint32

Events

历史记录上报完成
#1 · history-notify-complete
触发参数
#6历史数据最新时间戳uint32
干电池
#6 · battery
属性 2

Properties

电池电量
#1003 · battery-level
格式
uint8
读写
N / R
值
0 ~ 100，步长 1
工作状态
#1004 · status
格式
uint8
读写
N / R
值
1已安装
2已拆卸
门铃
#7 · doorbell
属性 1事件 1

Properties

当前时间（unix timestamp）
#1 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1

Events

有人按门铃
#1006 · doorbell-ring
触发参数
#1当前时间（unix timestamp）uint32
时间管理
#9 · time-management
属性 2动作 1

Properties

时区偏移量
#1 · time-zone-offset
格式
float
读写
值
-20 ~ 20，步长 0.25
当前时间（unix timestamp）
#2 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1

Actions

时间校准（校时）
#1 · time-correction
入参
#1时区偏移量float#2当前时间（unix timestamp）uint32
门锁详细版本
#11 · lock-version
属性 8

Properties

前面板版本
#1 · front-panel-version
格式
string
读写
值
—
后面板版本
#2 · rear-panel-version
格式
string
读写
值
—
指纹板版本
#3 · fingerprint-board-version
格式
string
读写
值
—
硬件版本
#4 · hardware-version
格式
string
读写
值
—
语音版本
#5 · voice-version
格式
string
读写
值
—
Wi-Fi版本
#6 · wifi-version
格式
string
读写
值
—
摄像头版本
#7 · camera-version
格式
string
读写
值
—
人脸掌静脉版本
#8 · face-palm-vein-version
格式
string
读写
值
—
锂电池
#13 · battery
属性 4

Properties

电池电量
#1 · battery-level
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
电池充电状态
#2 · charging-state
格式
uint8
读写
R / N
值
1门锁充电中
2未在充电
3无法充电
工作状态
#3 · status
格式
uint8
读写
R / N
值
1已安装
2已拆卸
当前时间（unix timestamp）
#4 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
门锁猫眼
#17 · door-lock-camera
属性 19动作 2事件 2

Properties

录像
#1 · on
格式
bool
读写
R / W / N
值
—
自动红外夜视
#2 · night-shot
格式
uint8
读写
R / W / N
值
0一直关闭
1一直开启
2自动切换
铃声类型
#6 · ringtone
格式
uint8
读写
R / W / N
值
1 ~ 5，步长 1
画面畸变矫正
#7 · image-distortion-correction
格式
bool
读写
R / W / N
值
—
当前时间（unix timestamp）
#8 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
自动亮屏
#9 · auto-screen-on
格式
bool
读写
R / W / N
值
—
有效时间
#11 · live-video-valid-time
格式
uint8
读写
R / W / N
值
11分钟
22分钟
33分钟
44分钟
55分钟
开启时段
#12 · live-video-enable-time-period
格式
string
读写
R / W / N
值
—
灵敏度
#13 · detection-sensitivity
格式
uint8
读写
R / W / N
值
0低
1中
2高
自动亮屏时间
#14 · auto-screen-on-time
格式
uint8
读写
R / W / N
值
010秒
115秒
220秒
微光全彩
#15 · glimmer-full-color
格式
bool
读写
R / W / N
值
—
摄像头工作模式
#16 · mode
格式
uint8
读写
R / W / N
值
0实时监控模式
1标准模式
2省电模式
3自定义模式
有人停留
#18 · someone-staying-activated-switch
格式
bool
读写
R / W / N
值
—
停留时长
#19 · staying-time
格式
uint8
读写
R / W / N
值
06秒
110秒
215秒
320秒
430秒
人脸标记
#20 · face-marking-switch
格式
bool
读写
R / W / N
值
—
录像时段
#22 · video-recording-time-period
格式
string
读写
R / W / N
值
—
实时画面
#23 · live-video-streaming
格式
bool
读写
R / N / W
值
—
微信音视频信息
#24 · wechat-info
格式
string
读写
R / W / N
值
—
门内开锁录像
#25 · inside-unlock-recording
格式
bool
读写
R / W / N
值
—

Actions

唤醒
#3 · wake-up
视频录制
#4 · video-recording

Events

有人在门前长时间停留
#2 · someone-at-the-door
触发参数
#8当前时间（unix timestamp）uint32
微信未授权通知
#3 · wechat-unauth-notify
触发参数
#8当前时间（unix timestamp）uint32
WIFI门锁
#18 · lock
属性 3

Properties

离家场景
#10 · away-home-mode
格式
bool
读写
R / W / N
值
—
门锁本地设置状态
#11 · door-lock-local-setting-status
格式
bool
读写
R / W / N
值
—
低功耗设备Wi-Fi状态
#12 · low-power-device-wifi-status
格式
uint8
读写
R / N
值
0Unknown
1Online
2Sleep
3Offline
门锁音量管理
#19 · lock-volume-management
属性 10

Properties

提示时间
#1 · door-open-reminder-time
格式
uint8
读写
R / W / N
值
0不提示
15秒后
210秒后
320秒后
430秒后
5120秒后
6180秒后
告警音量
#2 · door-open-reminder-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
提示时间
#3 · door-ajar-reminder-time
格式
uint8
读写
R / W / N
值
73秒后
告警音量
#4 · door-ajar-reminder-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
提示时间
#5 · door-lock-broken-reminder-time
格式
uint8
读写
R / W / N
值
0立即
15秒后
210秒后
320秒后
告警音量
#6 · door-lock-broken-reminder-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
语言选择
#7 · language
格式
uint8
读写
R / W / N
值
0中文
1英文
门锁操作提示音
#8 · door-operation-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
告警音量
#9 · reminder-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
关门提示音
#10 · door-closing-reminder-volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
勿扰
#20 · no-disturb
属性 3

Properties

勿扰
#1 · no-disturb
格式
bool
读写
R / W / N
值
—
启用时间段(格式为：00:00:00-00:00:00)
#2 · enable-time-period
格式
string
读写
R / W / N
值
—
当前勿扰状态
#3 · current-no-disturb
格式
bool
读写
R / N
值
—
门铃
#21 · doorbell
属性 5事件 1

Properties

门铃
#1 · on
格式
bool
读写
R / W / N
值
—
铃声选择
#4 · ringtone
格式
uint8
读写
R / W / N
值
0铃声01
1铃声02
2铃声03
提示音量
#5 · volume
格式
uint8
读写
R / W / N
值
0静音
1低
2中
3高
当前时间（unix timestamp）
#6 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
门铃灯
#7 · doorbell-light-on
格式
bool
读写
R / W / N
值
—

Events

门铃响了
#1 · doorbell-ring
触发参数
#6当前时间（unix timestamp）uint32
门锁管理
#22 · lock-manage
属性 13动作 8事件 9

Properties

用户id
#1 · user-ids
格式
uint16
读写
值
0 ~ 65535，步长 1
用户类型
#2 · user-type
格式
uint8
读写
值
0Owner
1Manager
2Normal User
3Frequent Visitors
4All Users
5All Normal Users
错误码
#3 · error-code
格式
uint16
读写
值
0Success
1Received Command Successfully Executing
2Internal Error
3Not Found
4Memory Full
5Parameter Error
6Timeout
7Device Busy
8Duplicate Parameter
9Duplicate Credentials
当前时间（unix timestamp）
#4 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
凭据内容
#5 · credential
格式
string
读写
值
—
操作方式
#6 · operation-method
格式
uint8
读写
值
1BLE
操作ID
#7 · operation-id
格式
uint16
读写
值
0 ~ 65535，步长 1
凭据状态
#8 · credential-state
格式
uint8
读写
值
0Success
1Fail
当前要添加的凭据序号
#9 · credential-step-current
格式
uint8
读写
值
0 ~ 255，步长 1
总凭据数量
#10 · credential-step-all
格式
uint8
读写
值
0 ~ 255，步长 1
单独用户开反锁权限设置
#11 · user-deadbolt-permission
格式
string
读写
R / W / N
值
—
开锁方式信息
#12 · unlock-method-info-string
格式
string
读写
值
—
同步版本
#13 · sync-version
格式
uint8
读写
值
1 ~ 10，步长 1

Actions

配置用户 （支持覆盖）
#1 · add-lock-user
删除用户
#2 · delete-lock-user
同步用户信息
#3 · sync-lock-user
添加开锁方式
#4 · add-unlock-method
入参
#1用户iduint16#6操作方式uint8#7操作IDuint16#5凭据内容string
取消添加
#5 · cancel-unlock-method
删除开锁方式
#6 · delete-unlock-method
入参
#1用户iduint16#7操作IDuint16
同步开锁方式
#7 · sync-unlock-method
分配用户信息
#8 · alloc-lock-user

Events

更新用户组
#1 · update-lock-user
更新开锁方式
#2 · update-unlock-method
触发参数
#3错误码uint16#1用户iduint16#6操作方式uint8#7操作IDuint16#4当前时间（unix timestamp）uint32
添加凭据事件
#3 · add-credential-event
触发参数
#8凭据状态uint8#9当前要添加的凭据序号uint8#10总凭据数量uint8
添加用户完成
#4 · add-user-complete
触发参数
#1用户iduint16#4当前时间（unix timestamp）uint32
删除用户完成
#5 · delete-user-complete
触发参数
#1用户iduint16#4当前时间（unix timestamp）uint32
添加开锁方式完成
#6 · add-user-key-complete
触发参数
#1用户iduint16#7操作IDuint16#4当前时间（unix timestamp）uint32
删除开锁方式完成
#7 · delete-user-key-complete
触发参数
#1用户iduint16#7操作IDuint16#4当前时间（unix timestamp）uint32
同步开锁方式完成
#8 · sync-user-key-complete
同步用户完成
#9 · sync-user-complete