samrum
homebridge-onstar (OnStar Accessory)
Homebridge support for OnStar!
Use at your own risk. This is an unofficial plugin.
Configuration
Basic Config (Climate)
{
"accessories": [
{
"accessory": "OnStar",
"name": "Car",
"deviceId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"vin": "1G2ZF58B774109863",
"username": "foo@bar.com",
"password": "p@ssw0rd",
"onStarPin": "1234"
}
]
}Use a random version 4 uuid as a deviceId. Generator avaiable here.
With this config, a climate control (remote start) switch will be available in the Home app.
Siri Command: "Turn on the Car climate"
Additional Config Options
Lock/Unlock Doors Switch
"enableDoors": trueEnables locking/unlocking the vehicle doors.
Querying the current state of locks through OnStar is slow, so the switch will always reset to a locked state.
Siri command: "Unlock the Car"
Reset Doors Switch to an Unlocked State
"doorsDefaultToUnlocked": trueDefault the doors switch to an unlocked state.
Charger Switch
"enableCharger": trueEnable a switch that will set the vehicle charge mode to immediate (for EV/PHEV). Turning the switch off does nothing.
Siri command: "Turn on the Car charger"
Alert Switch
"enableAlert": trueEnable a switch that triggers an alert for the vehicle (horn + lights flashing).
Siri command: "Turn on the Car alert"
Notes
- Toggling switches off is possible using Siri/Shortcuts/Scenes
- When secret keys are rotated by MyChevrolet/OnStar, the plugin may stop working until the keys are updated.
- homebridge-onstar will return success once requests are considered In Progress. As such, OnStar request failures after the initial request are made won't be handled.
Credits
OnStarJS (Shoutout to mikenemat and gm-onstar-probe)
homebridge-tesla for being a great reference to refer to on how to set up various homebridge services.