MIOT

#zsdl.lock.v38

zsdl.lock.v38

urn:miot-spec-v2:device:lock:0000A038:zsdl-v38:1

下载米家插件

语言

Service tree

门锁

#2 · lock

属性 6动作 1事件 2

Properties

标签	格式	值
操作位置 #1 · operation-position	uint8	1门内 2门外 3无法区分门内外
操作方式 #2 · operation-method	uint8	1手机 2指纹 3密码 4NFC 5人脸 7一次性密码 8周期性密码 9胁迫 10双重验证 11手动 12自动 13掌静脉
锁动作 #3 · lock-action	uint8	1上锁 2开锁 3开启离家模式
异常情况 #4 · abnormal-condition	uint8	1频繁开锁失败 9门锁被撬 10门虚掩 11门未关（门超时未关） 12离家后门内开锁 13门锁电量低
操作ID #5 · operation-id	uint16	0 ~ 65535，步长 1
当前时间（unix timestamp） #6 · current-time	uint32	0 ~ 4294967295，步长 1

操作位置

#1 · operation-position

格式: uint8
读写
值: 1门内
2门外
3无法区分门内外

操作方式

#2 · operation-method

格式: uint8
读写
值: 1手机
2指纹
3密码
4NFC
5人脸
7一次性密码
8周期性密码
9胁迫
10双重验证
11手动
12自动
13掌静脉

锁动作

#3 · lock-action

格式: uint8
读写
值: 1上锁
2开锁
3开启离家模式

异常情况

#4 · abnormal-condition

格式: uint8
读写
值: 1频繁开锁失败
9门锁被撬
10门虚掩
11门未关（门超时未关）
12离家后门内开锁
13门锁电量低

操作ID

#5 · operation-id

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

当前时间（unix timestamp）

#6 · current-time

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

Actions

蓝牙开锁

#1 · ble-unlock

Events

发生异常

#1007 · exception-occurred

触发参数

#4异常情况uint8#6当前时间（unix timestamp）uint32

锁事件

#1020 · lock-event

触发参数

#1操作位置uint8#2操作方式uint8#3锁动作uint8#5操作IDuint16#6当前时间（unix timestamp）uint32

门

#3 · door

属性 1

Properties

标签	格式	读写	值
门状态 #1021 · door-state	uint8	N / R	1已上锁 2已开锁 3门未关 4门虚掩 5已关门

门状态

#1021 · door-state

格式: uint8
读写: N / R
值: 1已上锁
2已开锁
3门未关
4门虚掩
5已关门

门锁管理

#4 · lock-manage

属性 10动作 7事件 9

Properties

标签	格式	值
用户id #1 · user-ids	uint16	0 ~ 65535，步长 1
用户类型 #2 · user-type	uint8	0拥有者 1管理者 2普通用户 3常客 4所有用户
操作方式 #3 · operation-method	uint8	1手机 2指纹 3密码 4NFC 5人脸 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参数重复
凭据状态 #8 · credential-state	uint8	0成功 1失败
当前要添加的凭据序号 #9 · credential-step-current	uint8	0 ~ 255，步长 1
总凭据数量 #10 · credential-step-all	uint8	0 ~ 255，步长 1

用户id

#1 · user-ids

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

用户类型

#2 · user-type

格式: uint8
读写
值: 0拥有者
1管理者
2普通用户
3常客
4所有用户

操作方式

#3 · operation-method

格式: uint8
读写
值: 1手机
2指纹
3密码
4NFC
5人脸
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参数重复

凭据状态

#8 · credential-state

格式: uint8
读写
值: 0成功
1失败

当前要添加的凭据序号

#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

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凭据状态uint8#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

标签	格式	值
锁事件历史数据上报 #1 · lock-history-string	string	—
异常事件历史数据上报 #2 · abnormal-data-string	string	—
门状态历史数据上报 #3 · door-data-string	string	—
门铃事件历史数据上报 #4 · doorbell-data-string	string	—
历史数据时间戳 #5 · history-time	uint32	0 ~ 4294967295，步长 1
历史数据最新时间戳 #6 · last-history-time	uint32	0 ~ 4294967295，步长 1
用户添加 #7 · user-add-string	string	—
用户删除 #8 · user-delete-string	string	—
钥匙添加 #9 · user-key-add-string	string	—
钥匙删除 #10 · user-key-delete-string	string	—

锁事件历史数据上报

#1 · lock-history-string

格式: string
读写
值: —

异常事件历史数据上报

#2 · abnormal-data-string

格式: string
读写
值: —

门状态历史数据上报

#3 · door-data-string

格式: string
读写
值: —

门铃事件历史数据上报

#4 · doorbell-data-string

格式: string
读写
值: —

历史数据时间戳

#5 · history-time

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

历史数据最新时间戳

#6 · last-history-time

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

用户添加

#7 · user-add-string

格式: string
读写
值: —

用户删除

#8 · user-delete-string

格式: string
读写
值: —

钥匙添加

#9 · user-key-add-string

格式: string
读写
值: —

钥匙删除

#10 · user-key-delete-string

格式: string
读写
值: —

Actions

触发历史记录上报操作

#1 · history-notify-action

入参

#6历史数据最新时间戳uint32

Events

历史记录上报完成

#1 · history-notify-complete

触发参数

#6历史数据最新时间戳uint32

电池

#6 · battery

属性 1

Properties

标签	格式	读写	值
电池电量 #1003 · battery-level	uint8	N / R	0 ~ 100，步长 1

电池电量

#1003 · battery-level

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

门铃

#7 · doorbell

属性 1事件 1

Properties

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

当前时间（unix timestamp）

#1 · current-time

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

Events

门铃响了

#1006 · doorbell-ring

时间管理

#9 · time-management

属性 2动作 1

Properties

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

时区偏移量

#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

门锁音量管理

#10 · lock-volume-management

属性 1

Properties

标签	格式	读写	值
门锁操作提示音 #1 · door-operation-volume	uint8		1低 2中 3高

门锁操作提示音

#1 · door-operation-volume

格式: uint8
读写
值: 1低
2中
3高

门锁详细版本

#11 · lock-version

属性 4

Properties

标签	格式	值
前面板版本 #1 · front-panel-version	string	—
Wi-Fi版本 #2 · wifi-version	string	—
摄像头版本 #3 · camera-version	string	—
后面板版本 #5 · rear-panel-version	string	—

前面板版本

#1 · front-panel-version

格式: string
读写
值: —

Wi-Fi版本

#2 · wifi-version

格式: string
读写
值: —

摄像头版本

#3 · camera-version

格式: string
读写
值: —

后面板版本

#5 · rear-panel-version

格式: string
读写
值: —

可视门铃

#12 · video-doorbell

属性 4动作 1事件 2

Properties

标签	格式	读写	值
ECO节能模式 #6 · eco	bool	R / W / N	—
云存视频id #9 · cloud-video-id	string		—
当前时间（unix timestamp） #10 · current-time	uint32		0 ~ 4294967295，步长 1
实时视频流 #14 · live-video-streaming	bool	R / N / W	—

ECO节能模式

#6 · eco

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

云存视频id

#9 · cloud-video-id

格式: string
读写
值: —

当前时间（unix timestamp）

#10 · current-time

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

实时视频流

#14 · live-video-streaming

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

Actions

唤醒

#3 · wake-up

Events

门锁被强行拆除

#2 · doorbell-forcibly-removed

有人停留

#4 · someone-at-the-door

自定义设置

#16 · manual-setting

属性 8

Properties

标签	格式	读写	值
开锁方式 #1 · unlocking-method	uint8	R / W / N	1单一验证 2双重验证
逗留时间设置 #3 · stay-time-setting	uint8	R / W / N	1010秒 3030秒 6060秒
人体感应设置 #4 · radar-distance	uint8	R / W / N	0关闭 2打开
自动上锁 #8 · auto-lock	bool	R / W / N	—
防误开时间设置 #9 · anti-unlock	uint8	R / W / N	0关闭 55秒 1010秒 1515秒 2020秒 2525秒 3030秒
童锁 #10 · child-lock	bool	R / W / N	—
电子反锁 #11 · e-anti-lock	bool	R / W / N	—
门未关超时设置 #12 · not-close-timeout	uint8	R / W / N	0关闭 1010秒 2020秒 3030秒 4040秒 5050秒 6060秒

开锁方式

#1 · unlocking-method

格式: uint8
读写: R / W / N
值: 1单一验证
2双重验证

逗留时间设置

#3 · stay-time-setting

格式: uint8
读写: R / W / N
值: 1010秒
3030秒
6060秒

人体感应设置

#4 · radar-distance

格式: uint8
读写: R / W / N
值: 0关闭
2打开

自动上锁

#8 · auto-lock

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

防误开时间设置

#9 · anti-unlock

格式: uint8
读写: R / W / N
值: 0关闭
55秒
1010秒
1515秒
2020秒
2525秒
3030秒

童锁

#10 · child-lock

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

电子反锁

#11 · e-anti-lock

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

门未关超时设置

#12 · not-close-timeout

格式: uint8
读写: R / W / N
值: 0关闭
1010秒
2020秒
3030秒
4040秒
5050秒
6060秒