2024.11.0
Home ▸ Integrations ▸

StarLine

The starline integration lets you retrieve data of your StarLine security system from the StarLine portal. You will need a working StarLine account.

This integration provides the following platforms:

  • Binary sensors: Hand brake, hood, trunk, alarm status, doors lock state, handsfree, neutral and moving ban status.
  • Device tracker: The location of your car.
  • Lock: Control the lock of your car.
  • Sensors: Battery level, SIM card balance, GSM signal level, GPS satellites count, fuel volume, mileage, OBD errors, interior temperature and engine temperature.
  • Switches: Start/stop engine, heater (webasto), additional channel, and service mode.
  • Buttons: Sound the horn.
  • Actions: Update the state, set update frequency. More details can be found here.

Prerequisites

Create a new application in the StarLine developer profile.

Note

The integration makes API calls to StarLine servers to retrieve data. It gets only the latest set of values that are valid for the moment of the API call. This means that the integration does not retrieve or store values, StarLine events, or parameters between the API calls. You can make up to 1000 API calls per day, which means you could make one approximately every 86 seconds. By default, the state of integration will be updated every 3 minutes and OBD information will be updated every 3 hours, making 488 calls per day. It is not recommended to set an update interval of less than 90 seconds.

Configuration

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

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select StarLine.

  • Follow the instructions on screen to complete the setup.

Actions

Update the state

The starline.update_state action fetches the last state of the device from the StarLine server.

This action does not require any attributes.

Set scan interval

The starline.set_scan_interval action sets update frequency for entities.

Data attribute Optional Description
scan_interval no Update frequency in seconds.

Set scan OBD interval

The starline.set_scan_obd_interval action sets update frequency for OBD information.

Data attribute Optional Description
scan_interval no Update frequency in seconds.

Disclaimer

This software is not affiliated with or endorsed by ScPA StarLine Ltd.