Support for Access control?

[robby-d]

Hi, just found this library. I have a A1001 door controller and tested the current state of the HomeAssistant integration. It appears that I can get a few states off of it, but no lock control (e.g. as switch entities) came across. It would be wonderful to be able to both discover and control the door lock state(s) for configured doors (as well as doors configured on additional connected/linked door controllers). Is this a planned feature? If not, I can look into adding it once I have some spare time.

(I also connected to an A8207VE MkII keypad/cam device, which was integrated via VAPIX to the aforementioned door controller -- I can see more information, including PIR state, camera feed and door status, however, I cannot operate the door lock through that as well. Being able to operate the door directly through a connection to the door controller(s) themselves would be optimal.)

[Kane610]

Hi @robby-dermody! I do have plans to add support for this, but I can not promise when that would be. Feel free to open PRs to support these devices functionality.

[robby-d]

Sounds good, thank you!

[drewclauson]

@Kane610 - Didn't want to open up a new issue, so I'm commenting here. I've been reading through your code and am interested in doing some work and submitting a PR to support A1001, but I'm newer to Python (I'm a .NET turned Java guy) and haven't been able to find good tutorials/documentation related to VAPIX. Do you have any recommended resources on VAPIX or guidance on where to start that would let me create a CLI app that uses this library as a dependency so I can get started to add in lock controls and door lock states? I've gotten as a far as installing PyCharm as I'm a JetBrains fanatic.

Thanks!

[Kane610]

Hey!

Awesome! When I'm adding a new API I usually augment the main function so I can just run everything from the commandline directly, ideally the main function would be a bit more advanced to offer some more CLI friendly controls.

Regarding documentation you have the official API documentation here https://www.axis.com/vapix-library/subjects/t10067552/section/t10068742/display

But in my experience you really need a device to try it out with, that also helps adding tests to improve iterating on it once you've got the basics implemented. Make sure to base your implementation on the latest firmware available, the API documentation typically only reflects the latest released version of the API.

I just wrapped up keypad support for the deCONZ integration a couple of weeks back so I'm also eager to get something similar running with the Axis integration.

Right now I'm finishing up my libraries to make sure dependencies and CI tools are helping out with verification and will also add proper typing before I go back to adding additional functionality.

Don't hesitate to ping me, we can also iterate quicker over discord should you prefer.

Reopening this issue in the mean time.

[drewclauson]

Thanks! I have access to two A1001s and I'm hoping to spend some time looking into it this weekend.

[Kane610]

Awesome! I will look into the different access control APIs as well

[drewclauson]

So, I've got the code connecting to my A1001 and -D is showing me params, but I'm getting a 404 when it tries to

POST http://<mydeviceip>/axis-cgi/apidiscovery.cgi

I haven't gotten too far, but I'm guessing that's a pretty integral part of the process, being able to discover what APIs are supported? It doesn't seem to exist when looking through the device's cgi scripts, but I can get params.cgi.

[Kane610]

404s are expected to exist when talking to different devices with different feature sets. Older devices don't support API Discovery so its completely fine.

axis/axis/errors.py

Line 39 in f3e8b93

ERRORS = {401: Unauthorized, 404: PathNotFound, 405: MethodNotAllowed}

axis/axis/vapix.py

Line 132 in f3e8b93

except PathNotFound: # Device doesn't support API discovery

[drewclauson]

Great, thanks. I've been able to do some figuring out of how to perform actions through VAPIX to get the basics of what I'm after (unlocking a door via button and getting door lock/unlock status). There's more than that available, but I at least have a good idea on how to make the right requests via Postman. Just need to figure out how to bring those actions into this code.

I see how you're capturing events through VAPIX. I don't see anything where the library issues actions through VAPIX. Does that sound accurate?

[Kane610]

Awesome! Exciting to see what you come up with!

There are loads of examples controlling different parts of the device through Vapix

Enable MQTT service in device

axis/axis/mqtt.py

Line 108 in f3e8b93

async def activate(self) -> None:

Activate a specific light

axis/axis/light_control.py

Line 55 in f3e8b93

async def activate_light(self, light_id: str) -> None:

Set state of port (new API)

axis/axis/port_management.py

Line 163 in f3e8b93

async def set_state(self, set_port: SetPort) -> None:

Set state of port (old API)

axis/axis/port_cgi.py

Line 92 in f3e8b93

async def action(self, action: str) -> None:

I'm up for general suggestions on how to improve the library as a whole. I'm trying to reflect changes in a way so my libraries for both deCONZ and UniFi are similar. I've done a lot of refactorings and improvements over the year where I've learned something with one of the libraries and then try to reflect the same changes in the other ones.

[drewclauson]

Thanks - sorry to be the newbie on this code, but it's my foray into a real Python library. 🤦‍♂️

I only thought that it wasn't using VAPIX because this URL was calling a cgi script where the A1001 would be calling /vapix/doorcontrol I'll have more time later this week to look through it more.

axis/axis/light_control.py

Line 11 in f3e8b93

URL = "/axis-cgi/lightcontrol.cgi"

I'm not the best person from an architecture perspective, but I'll make any suggestions if I come up with some. (I've been working as a DBA for the past 3 years, which has left a bunch of coding experience more stagnant than I'd like)

[Kane610]

No worries, I'm excited to have you just experimenting :)

Everything is Vapix, it's the branding of the APIs of Axis devices.

[drewclauson]

I made some progress on putting together the basics for defining API calls that I think will be useful and also associated tests.

If you have a minute, take a look at progress so far, I'm not sure of exact next steps, but I think I need to understand how to help HA discover the available services.

master...drewclauson:add-door-control