MIOT HomeMIOT Home
MIOT
#xiaomi.lock.4cb

xiaomi.lock.4cb

urn:miot-spec-v2:device:lock:0000A038:xiaomi-4cb:1
下载米家插件
语言
Service tree
门锁
#2 · lock
属性 9动作 1事件 2

Properties

操作位置
#1 · operation-position
格式
uint8
读写
值
1Indoor
2Outdoor
操作方式
#2 · operation-method
格式
uint8
读写
值
1蓝牙开锁
2指纹
3密码
4NFC
5机械钥匙
6一次性密码
7周期性密码
9胁迫
8双重验证
10临时口令
锁动作
#3 · lock-action
格式
uint8
读写
值
1Lock
2开锁
3开启离家模式
4关闭离家模式
5本地添加
6本地删除
异常情况
#4 · abnormal-condition
格式
uint8
读写
值
1多种方式频繁开锁失败
2密码频繁开锁失败
3指纹频繁开锁失败
4NFC频繁开锁失败
25门锁被撬
6门锁被重置
7门锁电量低，请及时更换电池
8门锁电量即将耗尽（一般指低于百分之五）
9门虚掩
10解除门虚掩
11离家期间，有人室内开门
操作ID
#5 · operation-id
格式
uint16
读写
值
0 ~ 65535，步长 1
当前时间（unix timestamp）
#6 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
音效音色选择
#11 · sound-option
格式
uint8
读写
值
1Revitalize
2Classic
离家模式
#12 · away-home-mode
格式
bool
读写
值
—
重置验证开关
#13 · reset-with-verification-required-setting
格式
bool
读写
值
—

Actions

蓝牙开锁
#1 · ble-unlock
入参
#3锁动作uint8

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 · lock-manage
属性 11动作 10事件 9

Properties

用户信息
#1 · lock-user-info-string
格式
string
读写
值
—
用户类型
#2 · user-type
格式
uint8
读写
值
0Owner
1Manager
2Normal User
3Frequent Visitors
操作方式
#3 · operation-method
格式
uint8
读写
值
1手机
2指纹
3密码
4NFC
5机械钥匙
6一次性密码
7周期性密码
8胁迫
9双重验证
10批量删除开锁方式
操作ID
#4 · operation-id
格式
uint16
读写
值
0正常应答
1事件类型
凭据内容
#5 · credential
格式
string
读写
值
—
当前时间（unix timestamp）
#6 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
错误码
#7 · error-code
格式
uint16
读写
值
0 ~ 255，步长 1
凭据状态
#8 · credential-state
格式
uint16
读写
值
0Success
1Fail
当前要添加的凭据序号
#9 · credential-step-current
格式
uint8
读写
值
0 ~ 255，步长 1
总凭据数量
#10 · credential-step-all
格式
uint8
读写
值
0 ~ 255，步长 1
用户id
#11 · user-ids
格式
uint16
读写
值
0 ~ 65535，步长 1

Actions

配置用户 （支持覆盖）
#1 · add-lock-user
删除用户
#2 · delete-lock-user
添加开锁方式
#3 · add-unlock-method
取消添加
#4 · cancel-unlock-method
删除开锁方式
#5 · delete-unlock-method
同步用户信息
#6 · sync-lock-user
同步开锁方式
#7 · sync-unlock-method
分配用户信息
#8 · alloc-lock-user
同步开锁方式
#9 · sync-unlock-method-with-version
同步用户信息
#10 · sync-lock-user-with-version

Events

更新用户组
#1 · update-lock-user
更新开锁方式
#2 · update-unlock-method
添加凭据事件
#3 · add-credential-event
添加用户完成
#4 · add-user-complete
删除用户完成
#5 · delete-user-complete
添加开锁方式完成
#6 · add-user-key-complete
删除开锁方式完成
#7 · delete-user-key-complete
同步开锁方式完成
#8 · sync-user-key-complete
同步用户完成
#9 · sync-user-complete
门锁历史记录
#5 · lock-history
属性 10动作 1事件 1

Properties

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

Actions

触发历史记录上报操作
#1 · history-notify-action

Events

历史记录上报完成
#1 · history-notify-complete
触发参数
#1历史数据时间戳uint32
门铃
#7 · doorbell
属性 4事件 1

Properties

铃声类型
#1 · ringtone
格式
uint8
读写
值
1 ~ 5，步长 1
音量
#2 · volume
格式
uint8
读写
值
0静音
1低
2中
3高
当前时间（unix timestamp）
#3 · current-time
格式
uint32
读写
值
0 ~ 4294967295，步长 1
开关
#4 · on
格式
bool
读写
值
—

Events

门铃响了
#1006 · doorbell-ring
触发参数
#3当前时间（unix timestamp）uint32
勿扰
#8 · no-disturb
属性 2

Properties

启用时间段(格式为：00:00:00-00:00:00)
#1 · enable-time-period
格式
string
读写
值
—
勿扰
#2 · no-disturb
格式
bool
读写
值
—
时间管理
#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
门锁音量管理
#10 · lock-volume-management
属性 6

Properties

门锁操作提示音
#1 · door-operation-volume
格式
uint8
读写
值
0Silent
1Low
2Middle
3High
语言
#2 · language
格式
uint8
读写
值
0Chinese
1English
门虚掩告警音量
#3 · door-ajar-reminder-volume
格式
uint8
读写
值
0Silent
1Low
2Middle
3High
门虚掩提示时间
#4 · door-ajar-reminder-time
格式
uint8
读写
值
0No Reminder
15 Seconds
210 Seconds
320 Seconds
430 Seconds
5120 Seconds
6180 Seconds
低电量提示音开关
#5 · low-battery-reminder-switch
格式
bool
读写
值
—
门锁被破坏告警音量
#6 · door-lock-broken-reminder-volume
格式
uint8
读写
值
0Silent
1Low
2Middle
3High
门锁详细版本
#11 · lock-version
属性 5

Properties

前面板版本
#1 · front-panel-version
格式
string
读写
值
—
后面板版本
#2 · rear-panel-version
格式
string
读写
值
—
指纹板版本
#3 · fingerprint-board-version
格式
string
读写
值
—
语音版本
#4 · voice-version
格式
string
读写
值
—
硬件版本
#5 · hardware-version
格式
string
读写
值
—
BLE专用自定义服务(ble专用，事件参数总长度不能超过9字节)
#12 · customized-service-for-ble
属性 3事件 1

Properties

工作时间
#1 · customized-argument-1
格式
uint32
读写
值
0 ~ 4294967295，步长 1
唤醒次数
#2 · customized-argument-2
格式
uint32
读写
值
0 ~ 4294967295，步长 1
插件前后台切换
#3 · customized-argument-5
格式
uint8
读写
值
1进入后台
2回到前台

Events

自定义事件1(ble专用，参数长度不能超过9字节)
#1022 · customized-event-1
触发参数
#1工作时间uint32#2唤醒次数uint32
干电池
#13 · battery
属性 1

Properties

电池电量
#1003 · battery-level
格式
uint8
读写
N / R
值
0 ~ 100，步长 1
自检服务
#14 · self-check
属性 4动作 2

Properties

自检结果
#1 · self-check-results
格式
uint16
读写
值
0Success
1Fail
21前锁MCU通讯异常
23指纹模组通讯异常
24密码模块通讯异常
27NFC通讯异常
当前自检项
#2 · self-check-current
格式
uint8
读写
值
0 ~ 255，步长 1
丢包率
#3 · packet-loss-rate
格式
uint8
读写
值
0 ~ 255，步长 1
信号强度
#4 · rssi
格式
int8
读写
值
-100 ~ 0，步长 1

Actions

开始自检
#1 · start-check
入参
#2当前自检项uint8
出参
#1自检结果uint16
终止自检
#2 · stop-check