homebridge-uconnect
v1.0.1
Published
A plugin to expose Uconnect Car controls to lock/unlock car and start/stop engine
Downloads
34
Maintainers
Readme
Homebridge Uconnect
Uconnect car lock/unlock and engine start/stop support for Homebridge.
homebridge-uconnect
is a Homebridge plugin that makes Uconnect-enabled cars (which include an active SiriusXM Guardian subscritpion) available to Apple's HomeKit smart home platform.
Uconnect remote commands are available on several models of Chrysler, Didge, Jeep, Ram and Fiat. Though I have only tested this module with my own car (2022 Chrysler Pacifica Hybrid). Please feel free to buy me more cars for testing :).
NOTE: Make sure you can submit remote commands to your car via the Uconnect app or Mopar website to ensure this plugin will work with your car as well.
Why use this plugin for Uconnect support in HomeKit?
My motivation in creating this plugin was to enable Siri control over the basic remote car functions (lock/unlock doors, start/stop engine), as well as allow adding the functions to HomeKit automations (e.g. lock doors ar night when person is at home etc.). The plugin will discover all Uconnect supported cars associated with your Mopar account after providing your account credentials in the configuration. Since there is no indication of the doors lock state or engine state, unfortunately the functions cannot be implemented as a "true" lock/switch accessory. The solution used resembles the one in the Uconnect app where there is a separate control for each function - lock door/unlock door/start engine/stop engine. I have tested these functionalities with my car and they work reasonable well (with some delay as with the regular Uconnect app) and allow Siri automation and use in shortcuts and scenes. However I have done very limited testing, please feel free to let me know if this works (or not) for your case, I will try to resolve any issues I can but it is not my day job, I welcome contributions and Pull Requests.
Features
Easy configuration - all you need is your Mopar username email, password and Uconnect 3 digit PIN to get started..
Automatic detection and configuration of all supported cars. By default - all of your supported cars are made available in HomeKit.
Documentation
- Installation: installing this plugin, including system requirements.
- Plugin Configuration: how to quickly get up and running.
- Additional Notes: some things you should be aware of, including myQ-specific quirks.
- Changelog: changes and release history of this plugin.
Installation
If you are new to Homebridge, please first read the Homebridge documentation and installation instructions before proceeding.
If you have installed the Homebridge Config UI, you can intall this plugin by going to the Plugins
tab and searching for homebridge-uconnect
and installing it.
If you prefer to install homebridge-uconnect
from the command line, you can do so by executing:
sudo npm install -g homebridge-uconnect
Things To Be Aware Of
- As mentioned above the plugin will add an accessory tile for each supported car associated with your Mopar account
- Each accessory will contain 4 elements:
Car Lock
- A lock in the UNSECURE position to enable remote locking. After locking it will automatically revert to the UNSECURE position after 3 seconds.Car Unlock
- A lock in the SECURE position to enable remote unlocking. After unlocking it will automatically revert to the SECURE position after 3 seconds.Car Start Engine
- A switch in the OFF position to enable remote engine start. After starting it will automatically revert to the OFF position after 3 seconds.Car Stop Engine
- A switch in the ON position to enable remote engine stop. After stopping it will automatically revert to the ON position after 3 seconds.
- You can separate these controls into separate tiles in the Home App accessory settings if you prefer.
Plugin Configuration
If you choose to configure this plugin directly instead of using the Homebridge Configuration web UI, you'll need to add the platform to your config.json
in your home directory inside .homebridge
.
"platforms": [{
"platform": "uconnect",
"email": "[email protected]",
"password": "password",
"pin": "1234",
"timeout": 30
}]
For most people, I recommend using Homebridge Configuration web UI to configure this plugin rather than doing so directly. It's easier to use for most users, especially newer users, and less prone to typos, leading to other problems.