NOTE: The Subaru integration is now part of Home Assistant Core (as of release 2021.3), however not all features have been implemented. Currently, only the sensor platform is available. Additional PRs will be submitted to include all features of this custom component into Home Assistant Core.
Users that desire full functionality should continue to use this custom component until all functionality is merged into the official integration. This custom component will override the HA Core built-in integration.
The Subaru integration retrieves information provided by Subaru connected vehicle services. Before using this integration, you must first register and have login credentials to MySubaru.
This integration requires an active vehicle subscription to the Subaru STARLINK service (available in USA and Canada).
Subaru has deployed two generations of telematics, Gen 1 and Gen 2. Use the tables below to determine which capabilities are available for your vehicle.
Model | Gen 1 | Gen 2 |
---|---|---|
Ascent | 2019+ | |
Crosstrek | 2016-2018 | 2019+ |
Forester | 2016-2018 | 2019+ |
Impreza | 2016-2018 | 2019+ |
Legacy | 2016-2019 | 2020+ |
Outback | 2016-2019 | 2020+ |
WRX | 2017+ |
Sensor | Gen 1 | Gen 2 |
---|---|---|
12V battery voltage | ✓ | |
Average fuel consumption | ✓ | |
Distance to empty | ✓ | |
EV battery level | ✓ | |
EV range | ✓ | |
EV time to full charge | ✓ | |
External temperature | ✓ | |
Odometer | ✓* | ✓ |
Tire pressures | ✓ |
* Gen 1 odometer only updates every 500 miles
Binary Sensor | Gen 1 | Gen 2 |
---|---|---|
Door/Trunk/Hood Status | ✓ | |
Window Status | ✓* | |
Ignition Status | ✓ | |
EV Plug/Charging Status | ✓* |
* Not supported by all vehicles
Device tracker, lock, and services all require a STARLINK Security Plus subscription:
Device Tracker | Gen 1 | Gen 2 |
---|---|---|
Vehicle Location | ✓ | ✓ |
Lock | Gen 1 | Gen 2 |
---|---|---|
Remote lock/unlock | ✓ | ✓ |
Services | Gen 1 | Gen 2 |
---|---|---|
Lock/Unlock | ✓ | ✓ |
Start/Stop Horn/Lights | ✓ | ✓ |
Poll vehicle | ✓ | ✓ |
Refresh data | ✓ | ✓ |
Start/Stop Horn/Lights | ✓ | ✓ |
Start/Stop Engine | ✓* | |
Start EV charging | ✓* |
* Not supported by all vehicles
Add https://github.com/G-Two/homeassistant-subaru
as a custom integration repository and install the Subaru STARLINK integration.
Clone or download this repository, and copy the custom_components/subaru
directory into the config/custom_components
directory of your Home Assistant instance. Restart Home Assistant.
Once installed, the Subaru integration is configured via the Home Assistant UI:
Configuration -> Integrations -> Add -> Subaru (HACS)
NOTE: After installation and HA restart, you may need to clear your browser cache for the new integration to appear.
When prompted, enter the following configuration parameters:
- Email Address: The email address associated with your MySubaru account
- Password: The password associated with your MySubaru account
- Country: The country your MySubaru account is associated with
The initial device registration process may take up to 20 seconds.
After successful authentication, if a supported remote services vehicle with active subscription is found in your account, an additional prompt will appear:
-
PIN: The PIN associated with your MySubaru account
NOTE: If your account includes multiple vehicles, the same PIN will be used for all vehicles. Ensure that you have configured all vehicles in your account to have the same PIN.
If the PIN prompt does not appear, no supported remote services vehicles were found in your account. Limited vehicle data may still appear as sensors.
Subaru integration options are set via:
Configuration -> Integrations -> Subaru (HACS) -> Options.
The options are:
-
Enable vehicle polling [Default: off]: When enabled, vehicle polling will send a remote command to your vehicle every 2 hours to obtain new sensor data. This involves “waking” your vehicle and requesting that it send new data to Subaru servers. Without vehicle polling, new sensor data is only received when the vehicle automatically pushes data (normally after engine shutdown). This option only applies to vehicles with Security Plus subscriptions.
WARNING: Vehicle polling draws power from the 12V battery. Long term use without driving may drain the battery resulting in the inability to start.
NOTE: Subaru lock uses the services provided by the Home Assistant Lock integration
Flash the lights of the vehicle. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Stop flashing the lights of the vehicle. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Sound the horn and flash the lights of the vehicle. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Stop sounding the horn and flash the lights of the vehicle. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Sends request to vehicle to update data. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Refreshes data (does not request update from vehicle). The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Start the engine and climate control of the vehicle. Uses the climate control settings saved. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Stop the engine and climate control of the vehicle. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |
Starts EV charging. This cannot be stopped remotely. The vehicle is identified by the vin
.
Service Data Attribute | Required | Description |
---|---|---|
vin |
yes | The vehicle identification number (VIN) of the vehicle, 17 characters |