Current Situation

• Installed latest beta to test api based events; homebridge-august v0.1.0-beta.18
• Plugin appeared to authenticate as 2FA code was received and added to plugin config.
• August WiFi Smart Lock (Gen 4) does not appear in accessories within Homebridge.
• Attempted both directly connected to WiFi, and connected via August Bridge (preferred to save battery life.)
• Lock does not appear in either WiFi setup method. (Works via August app and other Homebridge August plugins.)

Logs

[10/6/2022, 9:31:08 PM] [August] Total August Locks Found: undefined
[10/6/2022, 9:31:08 PM] [August] TypeError: deviceLists.map is not a function

Configuration

{
            "name": "August",
            "credentials": {
                "augustId": "[email protected]",
                "password": "xxxxxxxxx",
                "validateCode": "xxxxxxx",
                "notice": "Keep your tokens a secret!"
            },
            "options": {
                "logging": "standard"
            },
            "platform": "August"
        },

Environment

• OS: Ubuntu Focal Fossa (20.04.4 LTS)
• Software: https://github.com/oznu/docker-homebridge
• Node: v16.17.1
• npm: 8.5.0

Additional Context

No response

Describe The Bug

Home.aLog reports error reading properties, Home.app then sends notification lock "was jammed"pp reports lock "was jammed" despite lock not being jammed. August app and other plugins do not report jam.

To Reproduce

Error is random with no seeming correlation to time since lock or unlock.

Expected behavior

No error, no Home.app notification.

Relevant log output

[10/8/2022, 6:26:09 PM] [August] TypeError: Cannot read properties of undefined (reading 'retryCount')
[10/8/2022, 6:26:09 PM] [August] Lock: Front Door failed lockStatus (refreshStatus), Error Message: "Cannot read properties of undefined (reading 'retryCount')"

Config for homebridge-august

"name": "August",
            "credentials": {
                "augustId": "[email protected]",
                "password": "xxxxxx",
                "validateCode": "xxxxx",
                "notice": "Keep your tokens a secret!"
            },
            "options": {
                "logging": "standard"
            },
            "platform": "August"

Screenshots

Device & Model

AugusAugust WiFi Smart Lock

Node.js Version

16.17.1

NPM Version

8.5.0

Homebridge Version

oznu/homebridge:latest

Homebridge August Plugin Version

4.50.1

Homebridge Config UI X Plugin Version

1.0.4

Operating System

Docker

Problem

I have to tell you, this plugin is fantastic. It pulls DoorSense, battery status, everything. I love it. The ONE THING (isn't there always one thing?) that would be amazingly useful in an August plugin is the ability to trigger a reboot of the Doorbell Cam. It's do-able in the August Home app by drilling down to the doorbell settings and selecting the "reboot doorbell" option -- and the DC needs rebooting fairly often, especially when pulling RTSP streams into things like Scrypted or homebridge-camera-ffmpeg. It's not in the reverse-engineered API list, as hufftheweevil didn't have a Doorbell Cam for testing.

Solution

I have a (used, clean) Doorbell Cam Pro ready to use for API scraping. I can work with someone, or send this Doorbell Cam to them.

Alternatives

The only alternative is to use the August Home app to manually trigger a reboot, which is very...manual.

Additional context

Discussed in https://github.com/donavanbecker/homebridge-august/discussions/24

Describe Your Problem

Hello, I am trying to an August WiFi lock via Homebridge, and have installed your August Plugin and after trying various Node.js versions (14.18.0 suggested didn't work but the Homebridge Logs stated than I needed 14.20.1 which got me closer. Now I have one remaining Error message:

Relevant log output

[August] Discover Devices: TypeError: Cannot convert undefined or null to object

Config for homebridge-august

{
    "name": "August",
    "credentials": {
        "augustId": "****.***@icloud.com",
        "password": "***@*********",
        "validateCode": "******",
        "notice": "Keep your tokens a secret!"
    },
    "platform": "August"
}

Screenshots

No response

Device & Model

August WiFi Lock

Node.js Version

v14.20.1

NPM Version

V6.14.17

Homebridge Version

v1.5.1

Homebridge August Plugin Version

v1.0.5

Homebridge Config UI X Plugin Version

No response

Operating System

macOS Ventura

Parse validateCode as an integer. We could make the UI take in an integer, but then the user is presented with a number selector which isn't ideal. Easiest to keep it as a string in the UI and just parse it as an int on the backend.

:recycle: Current situation

The Homebridge UI puts the verification code in the config as a string which causes an authentication error on august's servers. Changing it to an int works, but then you have to manually update the config.

:bulb: Proposed solution

Add parseInt before the code is sent to the server. This way both integer and string verification codes will work right with august's servers.

:gear: Release Notes

Plugin now works correctly with string-based verification code configs.

Testing

N/A

Parse validateCode as an integer. We could make the UI take in an integer, but then the user is presented with a number selector which isn't ideal. Easiest to keep it as a string in the UI and just parse it as an int on the backend.

:recycle: Current situation

The Homebridge UI puts the verification code in the config as a string which causes an authentication error on august's servers. Changing it to an int works, but then you have to manually update the config.

:bulb: Proposed solution

Add parseInt before the code is sent to the server. This way both integer and string verification codes will work right with august's servers.

:gear: Release Notes

Plugin now works correctly with string-based verification code configs.

Testing

N/A

Problem

I have access to several locks in different homes in my August app. I would like to be able to hide all locks except those that are mine in the Home app.

Solution

Option to expose only certain locks to HomeKit.

Alternatives

No response

Additional context

No response

Bumps npm-check-updates from 16.3.8 to 16.3.11.

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Bumps eslint from 8.24.0 to 8.25.0.

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Version 1.1.0 (2022-12-07)

What's Changes

• Added option to hide_lock and only display Door Sense (Contact Sensor). #26
• Fixed issue when DoorSense is not configured/in use. #21
• Fixed TypeError: Cannot convert undefined or null to object. Thanks @evantobin
• Housekeeping and updated dependencies.

Full Changelog: https://github.com/donavanbecker/homebridge-august/compare/v1.0.5...v1.1.0

Problem

Get push notifications on doorbell pushes

Solution

As i can read in the august api theres a way to Get doorbell status.

Alternatives

No response

Additional context

No response

Describe The Bug

The device cannot be added to the plugin with the error [August] Discover Devices: TypeError: Cannot convert undefined or null to object

To Reproduce

install homebridge on pi4, install the plugin. input username/password, restart homebridge,input verification code sent from August, restart homebridge.

Expected behavior

Device discovered, controllable through HomeKit

Relevant log output

17/12/2022, 19:55:14] [AugustLocks] [August] getting locks ...
[17/12/2022, 19:55:14] [AugustLocks] [August] Could not communicate with August API: Config errors found:
Missing config.installID or AUGUST_INSTALLID env var

Config for homebridge-august

{
            "name": "August",
            "credentials": {
                "augustId": "********@me.com",
                "password": "*********",
                "installId": "********,
                "notice": "Keep your tokens a secret!",
                "isValidated": true
            },
            "platform": "August"
        }

Screenshots

No response

Device & Model

August lock 3rd gen with August Connect

Node.js Version

V18.12.1

NPM Version

V8.19.2

Homebridge Version

V1.6.0

Homebridge August Plugin Version

V1.1.0

Homebridge Config UI X Plugin Version

v4.50.2

Operating System

Raspbian bullseye (11)

Describe The Bug

The device cannot be added to the plugin with the error [August] Discover Devices: TypeError: Cannot convert undefined or null to object

To Reproduce

install home bridge on mac, install the plugin. Add the device with serial number, restart home bridge

Expected behavior

The device is found and i can control it with home bridge.

Relevant log output

FetchError: Status 401 (undefined): undefined
[August] Discover Devices: TypeError: Cannot convert undefined or null to object

Config for homebridge-august

{
    "bridge": {
        "name": "Homebridge 3926",
        "username": "********",
        "port": 51934,
        "pin": "841-**-***",
        "advertiser": "bonjour-hap"
    },
    "accessories": [],
    "platforms": [
        {
            "name": "Config",
            "port": 8581,
            "platform": "config"
        },
        {
            "devices": [
                {
                    "type": "bot",
                    "name": "Hallway Light",
                    "address": "***********",
                    "autoTurnOffInPressMode": false
                }
            ],
            "name": "SwitchbotBluetoothPlatform",
            "_bridge": {
                "username": "**********",
                "port": 41029
            },
            "platform": "SwitchbotBluetoothPlatform"
        },
        {
            "name": "August",
            "credentials": {
                "augustId": "[email protected]",
                "password": "mypassword",
                "installId": "1",
                "validateCode": "******",
                "isValidated": true,
                "notice": "Keep your tokens a secret!"
            },
            "options": {
                "devices": [
                    {
                        "lockId": "**********",
                        "configLockName": "Door",
                        "logging": "debug"
                    }
                ],
                "logging": "debug"
            },
            "platform": "August"
        }
    ]
}

Screenshots

No response

Device & Model

4th Gen Lock

Node.js Version

v19.3.0

NPM Version

9.2.0

Homebridge Version

v1.6.0

Homebridge August Plugin Version

v1.1.0

Homebridge Config UI X Plugin Version

No response

Operating System

macOS

Describe The Bug

After inputting email and password, hitting save, and receiving the MFA Auth key via email, going back to the config page to enter it works, but when I hit save, it just sends me another code, thereby invalidating the previous one.

To Reproduce

Followed instructions in readme

Expected behavior

it should have accepted the code and then brought up my lock when I scan the QR

Relevant log output

n/a

Config for homebridge-august

it was the standard initial json, with the addition of my credentials, nothing else

Screenshots

No response

Device & Model

RPI4

Node.js Version

latest

NPM Version

latest

Homebridge Version

latest

Homebridge August Plugin Version

latest

Homebridge Config UI X Plugin Version

latest

Operating System

Raspbian

Problem

Push button rather than a switch for unlock state

Solution

Push button or single click button maybe?

Alternatives

Hello, Great plugin, it works with the YALE Keyless Connect, but as this auto-locks after 10 seconds when you unlock it its a fixed switch in either the locked or unlocked position, this then throws an error that re occurs in HomeKit. Thanks!

Additional context

[03/11/2022, 22:38:57] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:38:58] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:01] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:03] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:05] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:07] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:17] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:21] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:23] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:25] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:26] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:29] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:33] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:36] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:37] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:42] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:46] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:49] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:53] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:39:55] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:02] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:07] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:13] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:15] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:20] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:22] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:23] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:25] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:27] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:30] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:32] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:34] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:36] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:38] [August] Lock: Side Gate doorState: init, closed: false, open: false [03/11/2022, 22:40:43] [August] Lock: Side Gate doorState: init, closed: false, open: false

Describe The Bug

When a lock is manually unlocked, it shows in HomeKit as "Unlocking" until I hit the unlock button, at which point it immediately changes to "Unlocked." The same thing happens when the lock is manually locked, but it shows "Locking" until I hit the button, and it changes to "Locked."

To Reproduce

Setup the plugin, get the lock into HomeKit, manually unlock or lock the lock.

Expected behavior

The status in HomeKit should reflect actual current status of the lock.

Relevant log output

I don't see any standard log output for this condition, but I can enable debug & see what happens, if that is needed.

Config for homebridge-august

{
    "platform": "August",
    "name": "August",
    "credentials": {
        "augustId": "xxxx",
        "password": "xxxx",
        "validateCode": "xxxx"
    },
    "options": {
        "devices": [
            {
                "lockId": "xxxxxxxxxxxxxxxxxxx",
                "hide_device": true
            }
        ]
    }
}

Screenshots

No response

Device & Model

We have six AUG-SL04-M01-S04 locks, and one Gen 4 WiFi lock (hidden since it's HomeKit native)

Node.js Version

v16.18.0

NPM Version

v8.19.2

Homebridge Version

1.5.0

Homebridge August Plugin Version

v1.0.5

Homebridge Config UI X Plugin Version

HOOBS 4.2.8

Operating System

Linux hoobs 5.10.103-v7l+ #1529 SMP Tue Mar 8 12:24:00 GMT 2022 armv7l GNU/Linux