Support for Aqara door lock

[kerwin612]

Description:

• Support new device model.

Pull request in home-assistant.github.io with documentation (if applicable): home-assistant/home-assistant.io#5329

Checklist:

• The code change is tested and works locally.
• Local tests pass with tox. Your PR cannot be merged unless tests pass

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated in home-assistant.github.io

If the code communicates with devices, web services, or third-party tools:

• New dependencies have been added to the REQUIREMENTS variable (example).
• New dependencies are only imported inside functions that use them (example).
• New dependencies have been added to requirements_all.txt by running script/gen_requirements_all.py.
• New files were added to .coveragerc.

If the code does not interact with devices:

• Tests have been added to verify that the new code works.

[syssi]

What's this and why it's called motion?

[syssi]

Do you really want to skip the heartbeat? This was/is a workaround for motion sensors.

[syssi]

Could you provide some example responses of the lock?

[kerwin612]

@syssi when error:{"cmd":"report","model":"lock.aq1","sid":"112316","data":"{\"verified_wrong\":"3"}" }
when fing:{"cmd":"report","model":"lock.aq1","sid":"112316","data":"{\"fing_verified\":"257"}" }
when card:{"cmd":"report","model":"lock.aq1","sid":"112316","data":"{\"card_verified\":"257"}" }
when pwd:{"cmd":"report","model":"lock.aq1","sid":"112316","data":"{\"psw_verified\":"257"}" }

verified_wrongvalue is count error.
fing_verified,card_verified,psw_verifiedvalue is uid.

[syssi]

Do you know/are there API calls for some user management?

[kerwin612]

configuration like this:

# aqara
xiaomi_aqara:
  gateways:
    - mac: xxxxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxxxx
  lockuids:
    - uid: 65536
    - uid: 65537
    - uid: 196608

The user ID contains the ID type. The integer value obtained by dividing the user ID by 65536 is the ID type. The ID type value is: 1 fingerprint, 2 password, 3 proximity card, 5 check-in password.
uid can find in mihome app,so , can be configured through the user ID list in the mihome app.

[syssi]

@ileler Could you tell me the product number of your acpartner.v3? It's KTBL11LM, correct?

[kerwin612]

@syssi yes,you are right.

[syssi]

The implementation looks like a WIP. There are a lot of motion sensor docstrings and copied code with misleading log messages.

[kerwin612]

@Danielhiversen @syssi I have already answered before, this is not a WIP.

It may be right to say that it is an imperfect implementation, but I guarantee it is a complete and available implementation. I have already given you a look at the response entity of the lock. Do you know if there is a good component type that matches this type of message? The door lock does not support writing messages. Only the unlock operation report message, so I only use the action sensor to achieve, I pro-test can complete the analysis of all reported messages, such as unsuccessful unlocking, fingerprint unlocking success, door card unlocking success, etc. The accurate analysis can provide a good basis for the playability of the door lock in ha.

[Danielhiversen]

Is it not possible to control the door lock? Only read the state of the lock?

[kerwin612]

yes，The official will not open the written interface for security

[syssi]

@ileler What do you need to improve your implementation? I left some comments.

[kerwin612]

@syssi No, no need. Take a look at our dialogue. Do you think there are other deficiencies in my implementation?

[Danielhiversen]

Please answer the comments from @syssi .
The code looks unfinished, and it looks like copy and paste of the motion sensor.
You also need to update the documentation.

[kerwin612]

Yes, it may be necessary to supplement the documentation on the configuration section

[Danielhiversen]

Why motion_status?

[Danielhiversen]

Why motion?

[Danielhiversen]

There should not be any "motion" in the lock sensor

[syssi]

I hope you agree with this solution: #14419