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) require a “Security Plus” level subscription.
Configuration
To add the Subaru integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the Add Integration button.
-
From the list, select Subaru.
-
Follow the instructions on screen to complete the setup.
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.
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.