diff --git a/source/_integrations/keba.markdown b/source/_integrations/keba.markdown index b38d6351a42..6f7c9b1f17c 100644 --- a/source/_integrations/keba.markdown +++ b/source/_integrations/keba.markdown @@ -5,6 +5,7 @@ ha_category: - Binary Sensor - Lock - Sensor + - Notifications ha_release: 0.98 ha_codeowners: - '@dannerph' @@ -18,7 +19,8 @@ This component 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. -- Services: authorize, deauthorize, set energy target, set maximum allowed current and manually update the states. More details can be found [here](/integrations/keba/#services). +- Services: authorize, deauthorize, set energy target, set the maximum allowed current and manually update the states. More details can be found [here](/integrations/keba/#services). +- Notify: Show a text on chargers with a built-in LED display. ## Configuration @@ -120,6 +122,42 @@ The service `keba.set_failsafe` sets the failsafe mode of the charging station. } ``` +## Notifications + +Some Keba chargers are equipped with a LED text display. The notification platform may be used to display text on this display. To enable this, add the following to your `configuration.yaml` file: + +### Configuration + +```yaml +# Example configuration.yaml entry +notify: + - name: NOTIFIER_NAME + platform: keba +``` + +{% configuration %} +name: + description: Setting the optional parameter `name` allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`. + required: false + default: "`notify`" + type: string +{% endconfiguration %} + +### Usage + +The use of the notify service is [described here](/integrations/notify/). + +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. + +```yaml +message: "Welcome home" +data: + min_time: 4 + max_time: 10 +``` + ## Disclaimer This software is not affiliated with or endorsed by Keba.