Writing a driver for August Home: how to start?

Hi there,

So, I am moving from ST to Hubitat, the first thing I would like to do is to create a driver for my August Home Lock + Connect. A door-sense (basically a magnet) helps tell if the door is open, closed, or badly closed.

This lock does not emit on the Z-Wave network hence it is connected to it's app via wifi. They do have an API which they do not release publicly but someone did a bit of reverse engineering on ité

I do not think I can connect to the "connect" plug directly, but instead I have to do as ST and IFTT does and connect to the app remotely.

So my question is: where should I start ? On a positive note, I work with groovy everyday so this will not be a hard move.

Let's say that, as a first step, I'd like to simply retrieve the houses and locks associated to my account, does it sounds feasible or not ?

If it's already been done on ST, I'd start by importing the driver from there and making whatever minor chances you need to make it work with HE and you'll be done. No need to re-invent the wheel when all the heavy lifting has already been done for you on ST.

How can I do that ?
I mean, import the driver

@zangdaarr.mortpartou welcome to the community!

Here's a porting guide:

One thing to consider is if the API for the lock is in the cloud you will still be dependent on your internet connection. If you can find a local way of doing it, it will be nicer, but that is not always possible, just as you say.

Developer Documentation is here:
https://docs.hubitat.com/index.php?title=Developer_Documentation

And this is how you install custom drivers:
https://docs.hubitat.com/index.php?title=How_to_Install_Custom_Drivers

EDIT: A quick search gave me this:
https://medium.com/@nolanbrown/august-lock-rest-apis-the-basics-7ec7f31e7874

https://medium.com/@nolanbrown/the-process-of-reverse-engineering-the-august-lock-api-9dbd12ab65cb

The above together with the DTH from ST you should have no problem getting it to work. Polling frequently for status from HE is something that should be avoided, search the forum and you'll find plenty on that subject.

EDIT2: For a 100% offline solution, this could be used:

1 Like

Have you been able to get it to work? Also having one of those (August WiFi lock) and interested in ideas for integration with HE

I just published an early alpha using the python library for inspiration.

1 Like

This topic was automatically closed 365 days after the last reply. New replies are no longer allowed.