Keba Charging Station
The Keba Charging Station integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] integrates your Keba P30/P20 charging station/BMW Wallbox into your Home Assistant instance using the UDP Smart Home Interface (manual). Keba P40 charging stations are not yet supported as they use a different protocol. The fetching interval to the charging station is set to 5 seconds, same as in the official mobile app. To use the integration, enable the UDP Smart Home Interface by adjusting the DIP switches within the charging station according to the installation manual.
This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following platforms:
- Binary sensors: Online state, plug state, charging state and failsafe mode state.
- Lock: Authorization (like with the RFID card).
- Sensors: current set by the user, target energy set by the user, charging power, charged energy of the current session and total energy charged.
- Actions: authorize, deauthorize, set energy target, set the maximum allowed current and manually update the states. More details can be found in the actions section.
- Notify: Show a text on chargers with a built-in LED display.
Configuration
To enable this integration in your installation, add at least the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file.
After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.
# Example configuration.yaml entry
keba:
host: KEBA_HOST
Configuration Variables
configuration
Timeout of the failsafe mode in seconds. Allowed values are between 10 seconds and 600 seconds (this parameter is only used if failsafe mode is enabled). Make sure to call the keba.set_curr action regularly within this timeout period!
Fallback current of the failsafe mode in A. Allowed values are between 6 Ampere and 63 Ampere. 0 Ampere disables the running charging process completely (this parameter is only used if failsafe mode is enabled).
Saving the failsafe configuration to internal EEPROM of the Keba charging station. 1 means save it, 0 means do only keep this configuration until the next restart of the charging station (this parameter is only used if failsafe mode is enabled).
List of actions
The Keba Charging Station integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.
-
Authorize (
keba.authorize) Authorizes a charging process on a Keba charging station. -
Deauthorize (
keba.deauthorize) Deauthorizes the running charging process on a Keba charging station. -
Disable (
keba.disable) Stops the charging process on an authorized Keba charging station. -
Enable (
keba.enable) Starts a charging process on an authorized Keba charging station. -
Request data (
keba.request_data) Requests new data from a Keba charging station. -
Set current (
keba.set_current) Sets the maximum charging current on a Keba charging station. -
Set energy (
keba.set_energy) Sets the target energy for the current charging session on a Keba charging station. -
Set failsafe (
keba.set_failsafe) Configures the failsafe mode of a Keba charging station.
For an overview of every action across all integrations, see the actions reference.
Using these actions changes the state of your charging station. Use them with care.
Notifications
Some Keba chargers are equipped with an LED text display. The notification platform may be used to display text on this display. To enable this, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file:
Configuration
# Example configuration.yaml entry
notify:
- name: NOTIFIER_NAME
platform: keba
Usage
The use of the notify action is described here.
The message part of the event payload is shown on the display. Scrolling is performed if needed. A maximum of 23 characters can be shown.
The optional data part may contain specifications of the message duration. min_time is the minimum time in seconds the text will be shown if another message is requested. max_time is the maximum time to display the message when nothing else is requested. By default, the message is shown a minimum of 2 seconds and a maximum of 10 seconds.
message: "Welcome home"
data:
min_time: 4
max_time: 10
Disclaimer
This software is not affiliated with or endorsed by Keba.