HVV Departures


The hvv_departures sensor will display the departures of busses, trains and ferries in Hamburg.

Configuration

Menu: Configuration > Integrations

Press on HVV Departures and configure the integration:

  • You can keep the default host (only change it if you know what you are doing)
  • Enter your API credentials (see How to get the API credentials)
  • Enter your station. You can also enter your address or a point of interest.
  • Select the station/address/poi you want

After that, you will get a sensor showing the time until the next departure.

Options

Menu: Configuration > Integrations > Select your new integration > Press the cog in the upper left corner

  • select lines: filter the departures on the station to only show departures for the selected lines.
  • offset: set this if you want to list the departures some minutes in the future, for example, if you live ten minutes away from the station.
  • use realtime data: enable this to include delay and cancellation information.

Elevator sensors

If the selected station has elevators, binary sensors will be available.

States

  • OK (off): The elevator is working.
  • Problem (on): The elevator is out of order. See the cause attribute for more information.

Attributes

Attribute Description
cabin_width Width of the elevator cabin
cabin_length Length of the elevator cabin
door_width Width of the elevator doors
elevator_type Type of the elevator
button_type Type of the elevator buttons, can be one of the following:
  • BRAILLE
  • ACUSTIC
  • COMBI
  • UNKNOWN
cause If the state of the sensor is on (“Problem”), the cause attribute may contain further information about the cause
lines List of lines that can be reached using this elevator

How to get the API credentials

You have to apply for credentials via the HVV website. You can see their official guide here (the page is only available in German).

In your mail, tell them you are using your API credentials for use within Home Assistant. They will send you a contract you will have to sign and send back. After about a week, you will receive your API credentials.

Data

Data is provided by HVV.