Subaru


This integration retrieves vehicle information and actuates remote services provided by Subaru STARLINK (currently only available in USA and Canada).

This integration requires a telematics equipped Subaru and an active vehicle subscription to the Subaru STARLINK service. Before using this integration, you must first register and have login credentials to MySubaru.

Subaru has deployed two generations of telematics, Gen 1 and Gen 2. The latter offers more vehicle sensor information and additional remote capabilities. Use the table below to determine your vehicle’s telematics generation and capabilities.

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+

In addition to the telematics generational differences, there are two levels of STARLINK subscriptions, “Safety Plus” and “Security Plus”. All remote services (such as locks and location tracking) require a “Security Plus” level subscription.

Configuration

To add the Subaru integration to your Home Assistant instance, use this My button:

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.

Sensors

Available sensors will vary by model, year, and subscription type. The integration will add all supported sensors for your vehicle. Sensor data is usually only updated when the vehicle is turned off unless the polling option is enabled.

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

Lock

This integration supports remote locking and unlocking of vehicle doors.

The current lock status is always unknown due to the fact that the Subaru API does not report this data.

Device Tracker

Tracks the most recently reported location of the vehicle. The vehicle reports its location when it is turned off.

Options

Subaru integration options are set via:

Settings -> Devices & Services -> Subaru -> Options.

  • 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 Gen 2 vehicles with Security Plus subscriptions because it uses a “locate” command to request the data.

Vehicle polling draws power from the 12V battery. Long term use without driving may drain the battery resulting in the inability to start.

FAQ - Troubleshooting

Q: I have a Subaru STARLINK Security Plus subscription. How do I use the locator, and remote light/horn features in Home Assistant?

A: Those features are supported by the underlying subarulink Python package, and will be integrated into Home Assistant soon. Both Gen 1 and Gen 2 will be supported.


Q: Will remote start ever be supported?

A: Yes, Gen 2 remote start and climate settings are supported by the underlying subarulink Python package, and will be integrated into Home Assistant soon.


Q: Why do I need to enter my PIN during configuration?

A: The PIN is saved to your configuration to support vehicle polling, since a remote update command is being sent to your vehicle. In addition, the PIN is used to support the lock platform and will be used for the remote start, locator, and lights/horn functions in the future.


Q: Why wasn’t I asked to enter my PIN during configuration?

A: A PIN is only required to send a remote command. If you do not have a STARLINK Security Plus subscription, you will not be prompted for a PIN.


Q: Why don’t my sensor readings appear to change in “real-time”?

A: Gen 2 telematics vehicles will send updated data when the vehicle is shutdown. After about 5 minutes, the data should be reflected in Home Assistant. In addition, some data, such as tire pressures, are only measured while the vehicle is in motion. The pressures reported are the last reading when the vehicle is shutdown.


Q: Should I enable the vehicle polling option?

A: Probably not. One use case is if you have a PHEV and want to monitor your charging progress. Another use case is if you want to use your vehicle as a temperature sensor. Otherwise, the data isn’t going to change much after you’ve shutdown your vehicle. A future revision will expose vehicle polling as a service to enable incorporation into automations.