August Home Release Announcement

Posted on
Tue Apr 03, 2018 7:09 am
vtmikel offline
Posts: 628
Joined: Aug 31, 2012
Location: Boston, MA

August Home Release Announcement

This is the announcement forum for the August Home plugin. This plugin supports both the August Doorbell and August Smart Lock.

If you have a August Pro, please see more information here: http://forums.indigodomo.com/viewtopic.php?f=275&t=20465

For the August Lock, you will either need a August Connect (untested, as I don't have one) or a August Doorbell in order for the plugin to work. Without one of these items, the August servers don't know the status of your lock and cannot control it remotely.

Find the release here: http://www.indigodomo.com/pluginstore/103/
Or on Github: https://github.com/mlamoure/Indigo-August-Home/releases

The plugin is based on an undocumented set of API's from August, however, it has been working reliably since July 2017. This does not guarantee a future without issues, though if August were to change their API's.

Features
  • Supports the Indigo lock device type with the typical states - Lock, Unlock, Status Requests, and even Battery Level. The intent is to give you the tools to delegate the "Auto Lock" functionality of the August to Indigo. This way, you can tweak the behavior of the auto lock (such as not locking the door every 3 minutes) to instead base this behavior on a combination of other data - such as house presence.
  • Uses the August cloud API's to control your lock, rather than bluetooth. The bluetooth control is very hard to set up and control.
  • Supports the use of the August doorbell as a bridge. Once a lock that is using the doorbell as a bridge is set up, you will also receive doorbell events (motion, missed calls) in Indigo and can configure triggers. You do not need to set up the doorbell in Indigo as a separate device for this to happen.
  • Supports "via XXXX" to see how the lock state was changed from outside of Indigo (August App, August App Remote, HomeKit, Manually). Triggers can exclude remote methods from the trigger event.
  • Automatically creates device states and variable folder / variables for tracking the time since the last lock and unlock for each lock. Useful in creating Auto Lock feature based on variable values.
  • Automatically creates house variables for tracking the last time since a motion event has occurred.
  • Supports the August keypad including triggers for invalid entry.
  • Automatic update notifications

Install Notes
  • The plugin will guide you thorough it. You will have to get a verification code from August, sent to your email or phone, for the plugin to work. August verifies based on a per device basis, not once per account. The plugin must verify a unique ID associated with your August account in order for the plugin to work.

Triggers
  • Lock and Unlock events by known people
  • Lock and Unlock events by unknown people (typically manual use of the lock)
  • Doorbell events - Missed call, Motion detected
  • Keypad events - Invalid code entry

Limitations
  • The plugin works based on polling the August servers for updates to the lock status and your house activity feed. The plugin supports 10, 15, 30, 45, 60, 90 second polling intervals. At this time there does not seem to be any better way to receive updates as they happen. The house feed provides more information, but sometimes is lagged because of the way the August devices work. Therefore, the plugin will prefer the house activity feed but periodically check the status API for sanity. Given that the activity feed is the only source for doorbell events, such as motion detected, missed calls, etc., there can be a lag for these events to be discovered by the plugin. Because of this, I've added maximum latency fields to the event triggers.
  • Sending lock and unlock commands from Indigo can have a lag, sometimes up to 20 seconds. I've seen this happen while manually triggering the API's, so it has nothing to do with the plugin. The plugin has a long timeout period, but sometimes failures do happen. I'm guessing it has to do with August's servers connecting to the bridge which connects to the lock, the round trip can take time. I recommend creating sanity triggers or schedules to ensure that a lock takes place successfully.

Untested but supported. If you've tested any of these configurations, please let us know so that I can mark it off the list.
  • Doorbell without a lock (Release v1.0.10 makes improvements to make it highly likely that this configuration will work fine. Please report any issues)
  • Multiple locks
  • Multiple houses
  • August connect as a bridge
  • August Pro

Posted on
Tue Apr 03, 2018 7:10 am
vtmikel offline
Posts: 628
Joined: Aug 31, 2012
Location: Boston, MA

Re: August Home Release Announcement

Release v1.0.10 was submitted today with improvements to those with a Doorbell but not a Lock.

Posted on
Mon Jan 06, 2020 6:03 pm
vtmikel offline
Posts: 628
Joined: Aug 31, 2012
Location: Boston, MA

Re: August Home Release Announcement

v1.0.18 was posted today with a fix for the "PIN (ignored)" message that was displaying incorrectly.

Page 1 of 1

Who is online

Users browsing this forum: No registered users and 2 guests