Xiaomi Self-Install Smart Lock

#xiaomi.lock.d100j

Xiaomi Self-Install Smart Lock

urn:miot-spec-v2:device:lock:0000A038:xiaomi-d100j:2

版本 v2 v1

← 返回产品详情下载米家插件

语言

Service tree

开关锁

#18 · lock-unlock

属性 4动作 8

Properties

标签	格式	读写	值
携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等） #2 · secret	string		—
执行结果（0：失败，1：成功，2：语音开锁功能已关闭） #3 · res	uint8		0Fail 1Success 2VoiceClose
执行原因 #4 · msg	string		—
锁舌伸出时间（默认3s） #5 · lock-tongue-time	uint8	R / N / W	3 ~ 10，步长 1

携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）

#2 · secret

格式: string
读写
值: —

执行结果（0：失败，1：成功，2：语音开锁功能已关闭）

#3 · res

格式: uint8
读写
值: 0Fail
1Success
2VoiceClose

执行原因

#4 · msg

格式: string
读写
值: —

锁舌伸出时间（默认3s）

#5 · lock-tongue-time

格式: uint8
读写: R / N / W
值: 3 ~ 10，步长 1

Actions

远程开锁（wifi）

#1 · remote-unlock-e

入参

#2携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）string

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

远程关锁（wifi）

#3 · remote-lock

入参

#2携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）string

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

紧急开锁（执行正/反转解锁，直到锁打开，执行成功或超15秒返回结果）（蓝牙）

#4 · emergency-unlock

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

语音开锁

#5 · voice-unlock

入参

#2携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）string

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

语音关锁

#6 · voice-lock

入参

#2携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）string

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

远程关锁（蓝牙）

#8 · ble-lock

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

远程开锁（蓝牙）

#9 · ble-unlock

出参

#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

获取LockMsg

#10 · get-lockmsg

出参

#2携带密文(密文中包含开锁人信息，开锁时间及开锁秘钥等）string#3执行结果（0：失败，1：成功，2：语音开锁功能已关闭）uint8#4执行原因string

门锁信息

#19 · lock-information

属性 14动作 4事件 3

Properties

标签	格式	读写	值
门锁校准状态（0：未校准，1：已校准） #3 · lock-calibration	uint8	R / N	0Uncalibrated 1Calibrated
门锁样式(仅欧规-0:钥匙型门锁，1:把手型门锁） #4 · lock-type	uint8	R / N / W	0Lock-Key 1Lock-Handle
门锁校准步骤（0：上锁，1：解锁，2：进入校准，3：退出校准，4：门磁校准，5：退出门磁校准，6：门锁类型-欧规） #5 · calibration-step	int8		0上锁 1开锁 2LockCalibration 3Exit-LockCalibration 4DoorSensorCalibration 5Exit-DoorSensorCalibration 6LockType-E
执行结果 #6 · result	bool		—
执行原因 #7 · msg	string		—
门锁信息（硬件版本，SN码，蓝牙Mac地址） #9 · lock-data	string	R / N	—
门锁wifi信息（wifi名称，ipc地址，mac版本） #11 · wifi-data	string	R / N	—
锁状态(0:关锁（锁闩伸出）;1:锁闩锁舌都缩回（开锁）2:锁闩缩回锁舌伸出，3:锁异常（已弃用，为兼容旧版本暂不删除）) #12 · lock-state	uint8	R / N	0上锁 1开锁 2LockTongueProtruding 3Abnormal
时区（-12到+12，西到东） #13 · time-zone	int16		-12 ~ 12，步长 1
时间戳 #14 · timestamp	uint32		0 ~ 4294967295，步长 1
wifi状态（true：已连接，false：未连接） #15 · wifi-status	bool	R / N	—
心跳间隔（仅蓝牙，默认5秒，离开插件控制页面改为180秒） #16 · heartbeat-time	uint16		0 ~ 65535，步长 1
门锁异常状态（正常，电机故障，锁体异常，锁堵转，锁未知） #17 · lock-abnormal-status	uint8	R / N	0Normal 1MotorFault 2LockAbnorma 3LockStalled 4LockUnknown
开锁自动化（钥匙类型开锁触发自动化） #18 · unlock-automation	uint8	R / N	0开锁 1上锁

门锁校准状态（0：未校准，1：已校准）

#3 · lock-calibration

格式: uint8
读写: R / N
值: 0Uncalibrated
1Calibrated

门锁样式(仅欧规-0:钥匙型门锁，1:把手型门锁）

#4 · lock-type

格式: uint8
读写: R / N / W
值: 0Lock-Key
1Lock-Handle

门锁校准步骤（0：上锁，1：解锁，2：进入校准，3：退出校准，4：门磁校准，5：退出门磁校准，6：门锁类型-欧规）

#5 · calibration-step

格式: int8
读写
值: 0上锁
1开锁
2LockCalibration
3Exit-LockCalibration
4DoorSensorCalibration
5Exit-DoorSensorCalibration
6LockType-E

执行结果

#6 · result

格式: bool
读写
值: —

执行原因

#7 · msg

格式: string
读写
值: —

门锁信息（硬件版本，SN码，蓝牙Mac地址）

#9 · lock-data

格式: string
读写: R / N
值: —

门锁wifi信息（wifi名称，ipc地址，mac版本）

#11 · wifi-data

格式: string
读写: R / N
值: —

锁状态(0:关锁（锁闩伸出）;1:锁闩锁舌都缩回（开锁）2:锁闩缩回锁舌伸出，3:锁异常（已弃用，为兼容旧版本暂不删除）)

#12 · lock-state

格式: uint8
读写: R / N
值: 0上锁
1开锁
2LockTongueProtruding
3Abnormal

时区（-12到+12，西到东）

#13 · time-zone

格式: int16
读写
值: -12 ~ 12，步长 1

时间戳

#14 · timestamp

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

wifi状态（true：已连接，false：未连接）

#15 · wifi-status

格式: bool
读写: R / N
值: —

心跳间隔（仅蓝牙，默认5秒，离开插件控制页面改为180秒）

#16 · heartbeat-time

格式: uint16
读写
值: 0 ~ 65535，步长 1

门锁异常状态（正常，电机故障，锁体异常，锁堵转，锁未知）

#17 · lock-abnormal-status

格式: uint8
读写: R / N
值: 0Normal
1MotorFault
2LockAbnorma
3LockStalled
4LockUnknown

开锁自动化（钥匙类型开锁触发自动化）

#18 · unlock-automation

格式: uint8
读写: R / N
值: 0开锁
1上锁

Actions

门锁校准（仅蓝牙）

#1 · lock-calibration

入参

#5门锁校准步骤（0：上锁，1：解锁，2：进入校准，3：退出校准，4：门磁校准，5：退出门磁校准，6：门锁类型-欧规）int8

出参

#6执行结果bool#7执行原因string

同步网络时间

#2 · synchronize-time

入参

#13时区（-12到+12，西到东）int16#14时间戳uint32

出参

#6执行结果bool#7执行原因string

记录完全上锁（门锁校准2-7）

#4 · record-lock

出参

#6执行结果bool#7执行原因string

记录完全开锁（门锁校准欧4/7日3/6）

#5 · record-unlock

出参

#6执行结果bool#7执行原因string

Events

已上锁（仅蓝牙上报，门锁校准步骤2）

#1 · lock

触发参数

#6执行结果bool#7执行原因string

已开锁（仅蓝牙上报，门锁校准步骤欧规4日规3）

#2 · unlock

触发参数

#6执行结果bool#7执行原因string

门磁校准（仅蓝牙上报）

#3 · door-calibration

触发参数

#6执行结果bool#7执行原因string

门（门磁）

#20 · door

属性 3事件 1

Properties

标签	格式	读写	值
门状态（0：门未关闭，1：门已关闭，2：未检测到门磁） #1 · door-state	uint8	R / N	0Open 1Close 2NotDetected
门状态变更时间戳 #3 · current-time	uint32	R / N	0 ~ 4294967295，步长 1
门磁校准状态 #4 · calibration-state	bool	R / N	—

门状态（0：门未关闭，1：门已关闭，2：未检测到门磁）

#1 · door-state

格式: uint8
读写: R / N
值: 0Open
1Close
2NotDetected

门状态变更时间戳

#3 · current-time

格式: uint32
读写: R / N
值: 0 ~ 4294967295，步长 1

门磁校准状态

#4 · calibration-state

格式: bool
读写: R / N
值: —

Events

门已关/已开

#1 · close-door

触发参数

#1门状态（0：门未关闭，1：门已关闭，2：未检测到门磁）uint8#3门状态变更时间戳uint32

电池（门锁/键盘）

#21 · battery

属性 8动作 2事件 5

Properties

标签	格式	读写	值
门锁电量 #1 · lock-mah	uint8	R / N	0 ~ 100，步长 1
键盘电量 #2 · keypad-mah	uint8	R / N	0 ~ 100，步长 1
门锁电量更新时间 #3 · lock-mah-update	uint32	R / N	0 ~ 4294967295，步长 1
键盘电量更新时间 #4 · keypad-mah-update	uint32	R / N	0 ~ 4294967295，步长 1
门锁电池安装时间 #5 · lock-battery-install	uint32	R / N	0 ~ 4294967295，步长 1
键盘电池安装时间 #6 · keypad-battery-i	uint32	R / N	0 ~ 4294967295，步长 1
当前时间 #7 · current-time	uint32		0 ~ 4294967295，步长 1
执行结果 #8 · result	bool		—

门锁电量

#1 · lock-mah

格式: uint8
读写: R / N
值: 0 ~ 100，步长 1

键盘电量

#2 · keypad-mah

格式: uint8
读写: R / N
值: 0 ~ 100，步长 1

门锁电量更新时间

#3 · lock-mah-update

格式: uint32
读写: R / N
值: 0 ~ 4294967295，步长 1

键盘电量更新时间

#4 · keypad-mah-update

格式: uint32
读写: R / N
值: 0 ~ 4294967295，步长 1

门锁电池安装时间

#5 · lock-battery-install

格式: uint32
读写: R / N
值: 0 ~ 4294967295，步长 1

键盘电池安装时间

#6 · keypad-battery-i

格式: uint32
读写: R / N
值: 0 ~ 4294967295，步长 1

当前时间

#7 · current-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

执行结果

#8 · result

格式: bool
读写
值: —

Actions

查询门锁电量

#1 · check-lock-mah

出参

#1门锁电量uint8#3门锁电量更新时间uint32#8执行结果bool

查询键盘电量

#2 · check-keypad-mah

出参

#2键盘电量uint8#4键盘电量更新时间uint32#8执行结果bool

Events

门锁电量低于10%（消息推送，低于10% 只推送一次）

#1 · lock-mah-low

触发参数

#1门锁电量uint8#7当前时间uint32

键盘电量低于10%（消息推送，低于10%，5%时各只推送一次）

#2 · keypad-mah-low

触发参数

#2键盘电量uint8#7当前时间uint32

更新电量（锁帖，键盘）

#3 · update-mah

触发参数

#1门锁电量uint8#2键盘电量uint8#7当前时间uint32

门锁电量低5%（消息推送，低于5%时只推送一次）

#4 · lock-mah-below-five

触发参数

#1门锁电量uint8#7当前时间uint32

键盘电量低5%（消息推送，5%时各只推送一次）

#5 · keypad-mah-belowfive

触发参数

#2键盘电量uint8#7当前时间uint32

日志

#22 · log

属性 6事件 2

Properties

标签	格式	读写	值
操作日志类型 #1 · operation-log-type	uint8		0MatterUnlock 1MatterLock 2PhysicsClose 3AppClose 4OneClickUnlock 5OneClickLock 6任意永久密码开锁 7任意指纹开锁 8PhysicsOpen 9手机APP开锁 10OTPOpen 11PeriodicCipherOpen 12AddFingerprint 13DeleteFingerprint 14AddPassword 15DeletePassword 16EmergencyUnlock 17KeyboardOneKeyLock 18AutoLock 19DoorClose 20UnlockFail 21LockFail
告警日志类型（0：多次开锁验证失败，1：劫持告警，2-3：门锁/键盘电量低，4：门未关，5：键盘被撬开） #2 · alarm-log-type	uint8		0Fingerprint-PasswordError 1HijackAlarm 2LockBatteryLow 3KeypadBatteryLow 4LockOpen 5KeyboardPry
执行结果（0：失败，1：成功） #3 · res	uint8		0Fail 1Success
用户/访客ID（用于消息推送获取用户别名） #4 · operation-id	uint32		0 ~ 4294967295，步长 1
消息推送状态（true才进行消息推送，仅密码，指纹，周期性密码开锁生效） #5 · push-status	bool		—
消息推送时间戳 #6 · current-time	uint32		0 ~ 4294967294，步长 1

操作日志类型

#1 · operation-log-type

格式: uint8
读写
值: 0MatterUnlock
1MatterLock
2PhysicsClose
3AppClose
4OneClickUnlock
5OneClickLock
6任意永久密码开锁
7任意指纹开锁
8PhysicsOpen
9手机APP开锁
10OTPOpen
11PeriodicCipherOpen
12AddFingerprint
13DeleteFingerprint
14AddPassword
15DeletePassword
16EmergencyUnlock
17KeyboardOneKeyLock
18AutoLock
19DoorClose
20UnlockFail
21LockFail

告警日志类型（0：多次开锁验证失败，1：劫持告警，2-3：门锁/键盘电量低，4：门未关，5：键盘被撬开）

#2 · alarm-log-type

格式: uint8
读写
值: 0Fingerprint-PasswordError
1HijackAlarm
2LockBatteryLow
3KeypadBatteryLow
4LockOpen
5KeyboardPry

执行结果（0：失败，1：成功）

#3 · res

格式: uint8
读写
值: 0Fail
1Success

用户/访客ID（用于消息推送获取用户别名）

#4 · operation-id

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

消息推送状态（true才进行消息推送，仅密码，指纹，周期性密码开锁生效）

#5 · push-status

格式: bool
读写
值: —

消息推送时间戳

#6 · current-time

格式: uint32
读写
值: 0 ~ 4294967294，步长 1

Events

操作日志

#1 · operation-log

触发参数

#3执行结果（0：失败，1：成功）uint8#1操作日志类型uint8#4用户/访客ID（用于消息推送获取用户别名）uint32#5消息推送状态（true才进行消息推送，仅密码，指纹，周期性密码开锁生效）bool#6消息推送时间戳uint32

告警日志

#2 · alarm-log

触发参数

#3执行结果（0：失败，1：成功）uint8#2告警日志类型（0：多次开锁验证失败，1：劫持告警，2-3：门锁/键盘电量低，4：门未关，5：键盘被撬开）uint8#4用户/访客ID（用于消息推送获取用户别名）uint32#5消息推送状态（true才进行消息推送，仅密码，指纹，周期性密码开锁生效）bool#6消息推送时间戳uint32

键盘

#23 · keyboard

属性 9动作 3事件 2

Properties

标签	格式	读写	值
键盘状态（0：未绑定，1：已绑定，2：键盘被拆除） #1 · keypad-state	uint8	R / N	0NotBound 1Bound 2Demolish
绑定行为（0：解绑，1：绑定） #3 · bound-action	uint8		0NotBound 1Bound
执行原因 #5 · msg	string		—
执行结果（0：失败，1：成功） #9 · result	uint8		0Fail 1Success
已绑定键盘信息（硬件版本，mac地址，SN号码） #10 · bound-keypad-data	string	R / N	—
绑定/解绑键盘执行结果（0：失败，1：成功，2：键盘已绑定） #11 · bound-result	uint8		0Fail 1Success 2Bound
蓝牙连接状态 #12 · ble-state	bool	R / N	—
蓝牙信号强度（0-2：弱，一般，强） #13 · ble-signal	uint8	R / N	0Low 1Middle 2High
键盘绑定码（仅蓝牙传输-6位） #14 · keypad-bind-password	string		—

键盘状态（0：未绑定，1：已绑定，2：键盘被拆除）

#1 · keypad-state

格式: uint8
读写: R / N
值: 0NotBound
1Bound
2Demolish

绑定行为（0：解绑，1：绑定）

#3 · bound-action

格式: uint8
读写
值: 0NotBound
1Bound

执行原因

#5 · msg

格式: string
读写
值: —

执行结果（0：失败，1：成功）

#9 · result

格式: uint8
读写
值: 0Fail
1Success

已绑定键盘信息（硬件版本，mac地址，SN号码）

#10 · bound-keypad-data

格式: string
读写: R / N
值: —

绑定/解绑键盘执行结果（0：失败，1：成功，2：键盘已绑定）

#11 · bound-result

格式: uint8
读写
值: 0Fail
1Success
2Bound

蓝牙连接状态

#12 · ble-state

格式: bool
读写: R / N
值: —

蓝牙信号强度（0-2：弱，一般，强）

#13 · ble-signal

格式: uint8
读写: R / N
值: 0Low
1Middle
2High

键盘绑定码（仅蓝牙传输-6位）

#14 · keypad-bind-password

格式: string
读写
值: —

Actions

绑定/解绑键盘

#1 · bound-keypad

入参

#3绑定行为（0：解绑，1：绑定）uint8

出参

#11绑定/解绑键盘执行结果（0：失败，1：成功，2：键盘已绑定）uint8#5执行原因string

退出配对键盘

#2 · exit-pairing-keypad

出参

#9执行结果（0：失败，1：成功）uint8#5执行原因string

键盘绑定码（仅蓝牙传输）

#3 · keypad-bind-password

入参

#14键盘绑定码（仅蓝牙传输-6位）string

出参

#5执行原因string#9执行结果（0：失败，1：成功）uint8

Events

绑定结果（仅蓝牙上报）

#1 · bind-result-event

触发参数

#11绑定/解绑键盘执行结果（0：失败，1：成功，2：键盘已绑定）uint8#5执行原因string

校验密码（仅蓝牙上报）

#2 · check-password

触发参数

#9执行结果（0：失败，1：成功）uint8#5执行原因string

用户管理

#24 · user-management

属性 21动作 8事件 1

Properties

标签	格式	读写	值
当前要添加的密码（用户/周期性密码） #8 · password-current	string		—
执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数） #11 · result	uint8		0Success 1AsyncSuccess 2Internal 3NotFound 4NoMem 5InvalidParam 6Timeout 7Busy 8DuplicateParam
执行原因 #12 · msg	string		—
当前要编辑的用户id #13 · user-id	uint16		0 ~ 65535，步长 1
当前编辑的访客id #14 · visitor-id	uint16		0 ~ 65535，步长 1
当前编辑的密码id #15 · password-id	uint16		0 ~ 65535，步长 1
当前编辑的指纹id #16 · fingerprint-id	uint16		0 ~ 65535，步长 1
当前编辑的胁迫指纹id #17 · s-fingerprint-id	uint16		0 ~ 65535，步长 1
当前编辑的周期性密码id #18 · periodic-cipher-id	uint16		0 ~ 65535，步长 1
当前编辑的昵称 #20 · nickname-current	string		—
编辑密码类型（0：添加密码，1：重设密码，2：删除密码，3：编辑密码名） #21 · edit-password-type	uint8		0AddPassword 1ResetPassword 2DeletePassword 3EditName
编辑周期性密码类型（0：添加，1：删除，2：编辑） #22 · edit-periodic-type	uint8		0Add 1Delete 2Edit
开始时间（周期性） #23 · periodic-start-time	uint32		0 ~ 4294967295，步长 1
结束时间（周期性） #24 · periodic-end-time	uint32		0 ~ 4294967295，步长 1
重复（周期性密码，0：永不，1：每天，2：每周，3：每两周，4:，每月） #25 · periodic-repeat	uint8		0Never 1Day 2Week 3TwoWeek 4Month
永不结束重复（true：永不，false：有结束时间） #26 · end-repeat-never	bool		—
结束重复时间(4294967295：永不) #27 · end-repeat-time	uint32		0 ~ 4294967295，步长 1
指纹录入步骤（0：开始录入，1-7：录入阶段，8：录入完成，9：指纹重复，10：录入错误，11：录入超时） #28 · finger-input-step	uint8	R / N	0InputStart 1One 2Two 3Three 4Four 5Five 6Six 7Seven 8InputCompleted 9FingerRepeat 10Fail 11Timeout
编辑指纹/胁迫指纹类型（0：添加，1，删除） #29 · edit-finger-type	uint8		0Add 1Delete
指纹录入通知（0：开始录入，1：退出录入） #33 · finger-input-notice	uint8		0StartInput 1ExitInput
用户数据 {包头【用户id，密码id，密码类型（指纹，密码，周期密码，胁迫指纹），状态，四个字节为一组】包尾} #36 · user-data	string		—

当前要添加的密码（用户/周期性密码）

#8 · password-current

格式: string
读写
值: —

执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）

#11 · result

格式: uint8
读写
值: 0Success
1AsyncSuccess
2Internal
3NotFound
4NoMem
5InvalidParam
6Timeout
7Busy
8DuplicateParam

执行原因

#12 · msg

格式: string
读写
值: —

当前要编辑的用户id

#13 · user-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的访客id

#14 · visitor-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的密码id

#15 · password-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的指纹id

#16 · fingerprint-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的胁迫指纹id

#17 · s-fingerprint-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的周期性密码id

#18 · periodic-cipher-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前编辑的昵称

#20 · nickname-current

格式: string
读写
值: —

编辑密码类型（0：添加密码，1：重设密码，2：删除密码，3：编辑密码名）

#21 · edit-password-type

格式: uint8
读写
值: 0AddPassword
1ResetPassword
2DeletePassword
3EditName

编辑周期性密码类型（0：添加，1：删除，2：编辑）

#22 · edit-periodic-type

格式: uint8
读写
值: 0Add
1Delete
2Edit

开始时间（周期性）

#23 · periodic-start-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

结束时间（周期性）

#24 · periodic-end-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

重复（周期性密码，0：永不，1：每天，2：每周，3：每两周，4:，每月）

#25 · periodic-repeat

格式: uint8
读写
值: 0Never
1Day
2Week
3TwoWeek
4Month

永不结束重复（true：永不，false：有结束时间）

#26 · end-repeat-never

格式: bool
读写
值: —

结束重复时间(4294967295：永不)

#27 · end-repeat-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

指纹录入步骤（0：开始录入，1-7：录入阶段，8：录入完成，9：指纹重复，10：录入错误，11：录入超时）

#28 · finger-input-step

格式: uint8
读写: R / N
值: 0InputStart
1One
2Two
3Three
4Four
5Five
6Six
7Seven
8InputCompleted
9FingerRepeat
10Fail
11Timeout

编辑指纹/胁迫指纹类型（0：添加，1，删除）

#29 · edit-finger-type

格式: uint8
读写
值: 0Add
1Delete

指纹录入通知（0：开始录入，1：退出录入）

#33 · finger-input-notice

格式: uint8
读写
值: 0StartInput
1ExitInput

用户数据 {包头【用户id，密码id，密码类型（指纹，密码，周期密码，胁迫指纹），状态，四个字节为一组】包尾}

#36 · user-data

格式: string
读写
值: —

Actions

编辑用户密码（添加，重设，删除密码）

#2 · edit-user-password

入参

#8当前要添加的密码（用户/周期性密码）string#13当前要编辑的用户iduint16#15当前编辑的密码iduint16#21编辑密码类型（0：添加密码，1：重设密码，2：删除密码，3：编辑密码名）uint8

出参

#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string#13当前要编辑的用户iduint16#15当前编辑的密码iduint16

编辑周期性密码（添加，删除，编辑）

#3 · edit-periodic-cipher

入参

#8当前要添加的密码（用户/周期性密码）string#14当前编辑的访客iduint16#18当前编辑的周期性密码iduint16#22编辑周期性密码类型（0：添加，1：删除，2：编辑）uint8#23开始时间（周期性）uint32#24结束时间（周期性）uint32#25重复（周期性密码，0：永不，1：每天，2：每周，3：每两周，4:，每月）uint8#26永不结束重复（true：永不，false：有结束时间）bool#27结束重复时间(4294967295：永不)uint32

出参

#14当前编辑的访客iduint16#18当前编辑的周期性密码iduint16#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

编辑指纹（添加，删除）

#4 · edit-fingerprint

入参

#13当前要编辑的用户iduint16#16当前编辑的指纹iduint16#29编辑指纹/胁迫指纹类型（0：添加，1，删除）uint8

出参

#13当前要编辑的用户iduint16#16当前编辑的指纹iduint16#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

编辑胁迫指纹（添加，删除）

#5 · edit-stress-finger

入参

#13当前要编辑的用户iduint16#17当前编辑的胁迫指纹iduint16#29编辑指纹/胁迫指纹类型（0：添加，1，删除）uint8

出参

#13当前要编辑的用户iduint16#17当前编辑的胁迫指纹iduint16#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

指纹录入通知（通知设备）

#6 · finger-input-notice

入参

#33指纹录入通知（0：开始录入，1：退出录入）uint8

出参

#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

删除用户

#7 · delete-user

入参

#13当前要编辑的用户iduint16

出参

#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

删除访客

#8 · delete-visitor

入参

#14当前编辑的访客iduint16

出参

#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

主动更新用户数据

#9 · update-user-data

出参

#11执行结果（0：成功,1：异步成功，2：内部错误，3：未找到，4：没有内存，5：无效参数，6：超时，7：忙，8：重复参数）uint8#12执行原因string

Events

更新用户数据

#1 · update-user-data

触发参数

#36用户数据 {包头【用户id，密码id，密码类型（指纹，密码，周期密码，胁迫指纹），状态，四个字节为一组】包尾}string

提示音

#25 · alarm

属性 3

Properties

标签	格式	读写	值
提示音（0：静音，1：有声） #1 · warning-tone	uint8	R / N / W	0Mute 1Voiced
告警音（0：静音，1：有声） #2 · alarm-tone	uint8	R / N / W	0Mute 1Voiced
提示时间（0：不提示，1-6:单位秒） #3 · warring-time	uint8	R / N / W	0NoWarning 15 210 320 430 5120 6180

提示音（0：静音，1：有声）

#1 · warning-tone

格式: uint8
读写: R / N / W
值: 0Mute
1Voiced

告警音（0：静音，1：有声）

#2 · alarm-tone

格式: uint8
读写: R / N / W
值: 0Mute
1Voiced

提示时间（0：不提示，1-6:单位秒）

#3 · warring-time

格式: uint8
读写: R / N / W
值: 0NoWarning
15
210
320
430
5120
6180

门锁便捷服务

#26 · convenient-service

属性 7

Properties

标签	格式	读写	值
关门自动上锁 #1 · close-door-lock	bool	R / N / W	—
关门上锁时间（默认5秒，可选范围1秒-59分59秒） #2 · close-door-lock-time	uint16	R / N / W	1 ~ 3599，步长 1
解锁后自动上锁 #3 · unlock-auto-lock	bool	R / N / W	—
解锁后上锁时间（默认5分钟，可选范围1秒-59分59秒） #4 · unlock-autolock-time	uint16	R / N / W	1 ~ 3599，步长 1
语音开锁开关 #5 · voice-unlock	bool	R / N / W	—
Matter数据（二维码url） #6 · matter-data	string	R / N	—
Matter数字编码 #7 · matter-number	string	R / N	—

关门自动上锁

#1 · close-door-lock

格式: bool
读写: R / N / W
值: —

关门上锁时间（默认5秒，可选范围1秒-59分59秒）

#2 · close-door-lock-time

格式: uint16
读写: R / N / W
值: 1 ~ 3599，步长 1

解锁后自动上锁

#3 · unlock-auto-lock

格式: bool
读写: R / N / W
值: —

解锁后上锁时间（默认5分钟，可选范围1秒-59分59秒）

#4 · unlock-autolock-time

格式: uint16
读写: R / N / W
值: 1 ~ 3599，步长 1

语音开锁开关

#5 · voice-unlock

格式: bool
读写: R / N / W
值: —

Matter数据（二维码url）

#6 · matter-data

格式: string
读写: R / N
值: —

Matter数字编码

#7 · matter-number

格式: string
读写: R / N
值: —

门锁智能模式

#27 · intelligent-mode

属性 8动作 4

Properties

标签	格式	读写	值
开始时间（当天日期的小时分钟） #2 · start-time	uint32		0 ~ 4294967295，步长 1
结束时间（如果是次日，用次日日期小时分钟） #3 · end-time	uint32		0 ~ 4294967295，步长 1
重复（永不，每天，自定义：周一到周日组合） #4 · repeat	uint8		0 ~ 255，步长 1
执行结果 #5 · result	uint8		0Fail 1Success
执行原因 #6 · msg	string		—
当前操作id #8 · operation-id	uint8		0 ~ 255，步长 1
当前操作状态 #9 · operation-state	bool		—
当前操作类型（0：勿扰，1：常开，2：省电） #10 · operation-type	uint8		0DoNotDisturb 1NormallyOpen 2PowerSave

开始时间（当天日期的小时分钟）

#2 · start-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

结束时间（如果是次日，用次日日期小时分钟）

#3 · end-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

重复（永不，每天，自定义：周一到周日组合）

#4 · repeat

格式: uint8
读写
值: 0 ~ 255，步长 1

执行结果

#5 · result

格式: uint8
读写
值: 0Fail
1Success

执行原因

#6 · msg

格式: string
读写
值: —

当前操作id

#8 · operation-id

格式: uint8
读写
值: 0 ~ 255，步长 1

当前操作状态

#9 · operation-state

格式: bool
读写
值: —

当前操作类型（0：勿扰，1：常开，2：省电）

#10 · operation-type

格式: uint8
读写
值: 0DoNotDisturb
1NormallyOpen
2PowerSave

Actions

设置生效状态

#1 · set-state

入参

#8当前操作iduint8#9当前操作状态bool#10当前操作类型（0：勿扰，1：常开，2：省电）uint8

出参

#5执行结果uint8#6执行原因string

添加生效时间

#2 · add-time

入参

#2开始时间（当天日期的小时分钟）uint32#3结束时间（如果是次日，用次日日期小时分钟）uint32#10当前操作类型（0：勿扰，1：常开，2：省电）uint8#8当前操作iduint8#4重复（永不，每天，自定义：周一到周日组合）uint8

出参

#5执行结果uint8#6执行原因string

删除生效时间

#3 · del-time

入参

#8当前操作iduint8#10当前操作类型（0：勿扰，1：常开，2：省电）uint8

出参

#5执行结果uint8#6执行原因string

编辑生效时间

#4 · edit-time

入参

#8当前操作iduint8#10当前操作类型（0：勿扰，1：常开，2：省电）uint8#2开始时间（当天日期的小时分钟）uint32#3结束时间（如果是次日，用次日日期小时分钟）uint32#4重复（永不，每天，自定义：周一到周日组合）uint8

出参

#5执行结果uint8#6执行原因string

通知管理

#28 · notice-management

属性 6动作 1事件 1

Properties

标签	格式	读写	值
当前操作用户id #1 · operation-id	uint16		0 ~ 65535，步长 1
当前操作状态 #2 · operation-state	bool		—
执行结果 #3 · res	uint8		0Fail 1Success
执行原因 #4 · msg	string		—
允许通知开关 #5 · allow-notification	bool	R / W / N	—
用户通知状态 {包头【两个字节为一组(用户id，通知状态：生效1/失效0)】包尾} #6 · user-notice-status	string	R / N	—

当前操作用户id

#1 · operation-id

格式: uint16
读写
值: 0 ~ 65535，步长 1

当前操作状态

#2 · operation-state

格式: bool
读写
值: —

执行结果

#3 · res

格式: uint8
读写
值: 0Fail
1Success

执行原因

#4 · msg

格式: string
读写
值: —

允许通知开关

#5 · allow-notification

格式: bool
读写: R / W / N
值: —

用户通知状态 {包头【两个字节为一组(用户id，通知状态：生效1/失效0)】包尾}

#6 · user-notice-status

格式: string
读写: R / N
值: —

Actions

设置用户通知状态（回家开门）

#1 · set-user-notice

入参

#1当前操作用户iduint16#2当前操作状态bool

出参

#3执行结果uint8#4执行原因string

Events

更新用户通知状态

#1 · update-notice-status

触发参数

#6用户通知状态 {包头【两个字节为一组(用户id，通知状态：生效1/失效0)】包尾}string

键盘设置

#29 · keypad-management

属性 6

Properties

标签	格式	读写	值
启用上锁键 #1 · lock-key-state	bool	R / N / W	—
仅关门后启用 #2 · close-door-enable	bool	R / N / W	—
禁用键盘设置状态 #3 · forbidden-keypad-s	bool	R / N / W	—
背光 #4 · backlight	bool	R / N / W	—
提示音 #5 · warning-tone	bool	R / N / W	—
试错提醒（0：不提示，1-4: 5,10,15,20,25次） #6 · error-tip	uint8	R / N / W	0NoWarning 15 210 315 420 525

启用上锁键

#1 · lock-key-state

格式: bool
读写: R / N / W
值: —

仅关门后启用

#2 · close-door-enable

格式: bool
读写: R / N / W
值: —

禁用键盘设置状态

#3 · forbidden-keypad-s

格式: bool
读写: R / N / W
值: —

背光

#4 · backlight

格式: bool
读写: R / N / W
值: —

提示音

#5 · warning-tone

格式: bool
读写: R / N / W
值: —

试错提醒（0：不提示，1-4: 5,10,15,20,25次）

#6 · error-tip

格式: uint8
读写: R / N / W
值: 0NoWarning
15
210
315
420
525