鹿客V5Max通过xiaomigateway3插件接入homeassistant

cwt0490

前提：需要有个xiaomigateway3支持的小米多模网关，我是小米多模网关1代，安装好ha插件xiaomigateway3项目地址：https://github.com/AlexxIT/XiaomiGateway3

步骤：
在ha的config目录下新建[backcolor=rgba(175, 184, 193, 0.2)]xiaomi_gateway3.py

导入以下代码：

from custom_components.xiaomi_gateway3.core.devices import *

DEVICES = [{
    9877: ["Loock", "Loock Smart Lock V5 Max", "FCL201"],
    "spec": [
        BaseConv("action", "sensor"),
        BaseConv("key_id", mi="2.e.1020.p.4"),
        MapConv("method", "sensor", mi="2.e.1020.p.2", map={
            1: "mobile", 2: "fingerprint", 3: "password", 4: "nfc", 5: "face", 6: "Finger Vein", 
            7: "Palm Print", 8: "key", 9: "one_time_password", 10: "periodic_password", 
            11: "Homekit", 12: "coerce", 13: "Two Step Verification", 14: "Turntable", 
            15: "manual", 16: "auto"
        }),
        MapConv("lock_action", "sensor", mi="2.e.1020.p.3", map={
            1: "lock", 2: "unlock", 3: "lock_outside", 4: "lock_inside",
            5: "unlock_inside", 6: "enable_child_lock", 7: "disable_child_lock",
            8: "enable_away", 9: "disable_away"
        }),
        MapConv("door_state", "sensor", mi="3.p.1021", map={
            16: 'Locked',
            20: 'Locked',
            24: 'Locked',
            28: 'Locked',
            32: 'Unlocked',
            36: 'Unlocked',
            40: 'Unlocked',
            44: 'Unlocked',
            48: 'Leaving The Door Open Timed Out',
            52: 'Leaving The Door Open Timed Out',
            56: 'Leaving The Door Open Timed Out',
            60: 'Leaving The Door Open Timed Out',
            64: 'Door Was Ajar',
            68: 'Door Was Ajar',
            72: 'Door Was Ajar',
            76: 'Door Was Ajar'
        }),
        MapConv("abnormal_type", "sensor", mi="2.e.1020.p.6", map={
            1: "Frequent Unlocking Failed By Multiple Methods", 
            2: "Frequent Unlocking Failed By Password", 
            3: "Frequent Unlocking Failed By Fingerprint", 
            4: "Frequent Unlocking Failed By NFC", 
            5: "Frequent Unlocking Failed By Face", 
            6: "Frequent Unlocking Failed By Palmprint", 
            7: "Frequent Unlocking Failed By Finger Vein", 
            8: "Frequent Unlocking Failed By Key", 
            9: "Door Lock Was Damaged", 
            10: "Locked Unsuccessfully", 
            11: "Unlock From Inside After Leaving Home", 
            12: "Door Lock Was Reset", 
            13: "Foreign Object Detected In The Keyhole", 
            14: "Key Was Not Removed", 
            15: "Door Lock Fingerprint Sensor Error", 
            16: "Door Lock Mechanical Failure", 
            17: "Door Lock Main Part Failure", 
            18: "The Lithium Battery Temperature Is Too High", 
            19: "Large Batteries Are Low", 
            20: "Small Batteries Are Low", 
            21: "Large And Small Batteries Are Low", 
            22: "Large And Small Deplete", 
            23: "Leaving The Door Open Timed Out", 
            24: "Door Was Ajar", 
            25: "Door Was Opened Forcefully", 
            26: "Small Batteries Are Nearly Depleted", 
            27: "Small Batteries Are Nearly Depleted And Large Batteries Low", 
            28: "Large Batteries Are Nearly Depleted", 
            29: "Large Batteries Are Nearly Depleted And Small Batteries Low", 
            30: "Large Batteries Are Removed", 
            31: "Large Batteries Are Inserted", 
            32: "Small Batteries Are Removed", 
            33: "Small Batteries Are Inserted", 
            34: "Battery Low The Cat Eye Function And The Door Screen Are Suspended", 
            35: "Ultrasonic Sensitivity Decreased"
        }),
        MapConv("position", "sensor", mi="2.e.1020.p.1", map={
            1: "indoor", 2: "outdoor", 3: "not tell indoor or outdoor"
        }),
        BaseConv("lock_timestamp", "sensor", mi="2.e.1020.p.5"),  # lock timestamp
        
        # doorbell
        ConstConv("action", mi="5.e.1006", value="doorbell"),
        BaseConv("doorbell_timestamp", "sensor", mi="5.e.1006.p.1"),  # doorbell timestamp

        # battery sensor
        BaseConv("battery", "sensor", mi="4.p.1003"),
        BaseConv("changing", "sensor", mi="4.p.1034"),
    ],
}] + DEVICES

复制代码

保存后重启ha就可以了。
在集成里添加好xiaomigateway3，增加网关后会自动识别连接到该网关蓝牙的v5max

效果图


类似方法可以尝试自己写代码来支持其他蓝牙锁

方法：
1. 在这里https://home.miot-spec.com/，找到你米家支持的设备
2. 我在网上搜到的设备号9877， 这个具体怎么获得目前不太清楚。
3. 后面是根据miot-spec内的内容修改spec, 同一家厂商的话内容基本上是差不多的。
4. 后面就是不断试错了。

zro22

这个不是本身就支持吗？
miot

gx19970920

前两天刚问，太好了，非诚感谢！

gx19970920

zro22 发表于 2024-5-27 20:38
这个不是本身就支持吗？
miot

miot走的不是本地，响应不太及时

cwt0490

zro22 发表于 2024-5-27 20:38
这个不是本身就支持吗？
miot

miot上的不及时且不太准确。对于需要依赖ha来做联动的来说非常不方便。本地蓝牙目前我还没有完整测试，部分情况下也存在延迟情况，暂不清楚原因。action sensor目前也只识别出doorbell，还有很多需要做。

新生活

学习了，谢谢分享。赞

fhleo

这款锁有两块电池，如何再XMGW3中实现识别两个电池呢？

joyspell

它的监控能接入到ha吗

gx19970920

你好请问这个action里面会有信息么

kkk123

我的鹿客X3-H，要修改哪些东西呢？
之前有个帖子也说接入鹿客，但问了没人回答
在小程序里显示型号YD-D3NF