karlg100 / homebridge-smartstart

Viper/Directed Remote SmartStart Integration for Homebridge, HomeKit and Siri
4 stars 3 forks source link

Smartstart Plugin

Example config.json:

One vehicle

    "accessories": [
        {
            "accessory": "SmartStart",
            "name": "Civic",
            "username": "[username]",
            "password": "[password]",
            "delay": 900000
        },
        {
            "accessory": "SmartStartLock",
            "name": "Civic",
            "username": "[username]",
            "password": "[password]",
        }
    ]

Or multiple vehicles

    "accessories": [
        {
            "accessory": "SmartStart",
            "name": "Odyssey",
            "username": "[username]",
            "password": "[password]",
            "deviceIndex": 0,
            "delay": 900000
        },
        {
            "accessory": "SmartStartLock",
            "name": "Odyssey",
            "username": "[username]",
            "password": "[password]",
            "deviceIndex": 0,
        },
        {
            "accessory": "SmartStart",
            "name": "Ridgeline",
            "username": "[username]",
            "password": "[password]",
            "deviceIndex": 1,
            "delay": 900000
        },
        {
            "accessory": "SmartStartLock",
            "name": "Ridgeline",
            "username": "[username]",
            "password": "[password]",
            "deviceIndex": 1,
        }
    ]

What does this do?

This plugin enables your SmartStart remote starter to remote start, stop, lock/arm and unlock/disarm your vehicle to be controlled by HomeKit (and Siri) via homebridge. Install using the standard homebridge instructions, and add this plugin.

This is a as simple as it gets implementation

Using the SmartStart npm module, this will just send a "remote" action to your vehicle. There is no state information at this time that's accessible. (somehow the app is able to retrieve the status of the vehicle, but it costs an "action" which accounts are limited to a number per year, and the API is not strait forward)

Locking/unlocking is also not implemented.

How to install

sudo npm install -g homebridge-smartstart

Pro-tip

If you have multiple vehicles, and once they are all working and tested via HomeKit, create a room called Vehicles. (or cars, or whatever you'd like to call the group) You can then tell Siri "start vehicles" or "unlock vehicles" and it will kick a smartstart action to all of them at the same time. If you have HomeKit sharing setup, your other family members will be able to also see if the vehicles have been started.

Todo

Credits

This plugin was forked from and inspired by homebridge-delay-switch, homebridge-simple-switch-example and the alexa-smartstart and smartstart npm by @dale3h. Without these last two modules, this homebridge module wouldn't exist.