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.

* Gen 1 odometer only updates every 500 miles

* Not supported by all vehicles

Device tracker, lock, and services all require a STARLINK Security Plus subscription:

* 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.

Stop flashing the lights of the vehicle. The vehicle is identified by the vin.

Sound the horn and flash the lights of the vehicle. The vehicle is identified by the vin.

Stop sounding the horn and flash the lights of the vehicle. The vehicle is identified by the vin.

Sends request to vehicle to update data. The vehicle is identified by the vin.

Refreshes data (does not request update from vehicle). The vehicle is identified by the vin.

Start the engine and climate control of the vehicle. Uses the climate control settings saved. The vehicle is identified by the vin.

Stop the engine and climate control of the vehicle. The vehicle is identified by the vin.

Starts EV charging. This cannot be stopped remotely. The vehicle is identified by the vin.