From 7d312a66b2f5d9a06243f3dd38fbab07235d0003 Mon Sep 17 00:00:00 2001
From: Maikel Punie <maikel.punie@gmail.com>
Date: Wed, 26 Oct 2022 16:49:02 +0200
Subject: [PATCH] Add the velbus cache service (#24487)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
---
 source/_integrations/velbus.markdown | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/source/_integrations/velbus.markdown b/source/_integrations/velbus.markdown
index 9e5924940f4..ef325f26821 100644
--- a/source/_integrations/velbus.markdown
+++ b/source/_integrations/velbus.markdown
@@ -7,6 +7,7 @@ ha_category:
   - Hub
   - Light
   - Sensor
+  - Button
   - Switch
 ha_iot_class: Local Push
 ha_release: '0.50'
@@ -53,6 +54,7 @@ The port string used in the user interface or the configuration file can have 2
 - `velbus.sync clock`: Synchronize Velbus time to local clock.
 - `velbus.scan`: Scan the bus for new devices.
 - `velbus.set_memo_text`: Show memo text on Velbus display modules.
+- `velbus.clear_cache`: Clear the full velbuscache or the cache for one module only.
 
 ### Service `velbus.sync_clock`
 
@@ -95,6 +97,16 @@ script:
       service: velbus.set_memo_text
 ```
 
+### Service `velbus.clear_cache`
+
+You can use the service `velbus.clear_cache` to clear the cache of one module or the full cache. Once the clear happens, the integration will start a new scan.
+Use this service when you make changes to your configuration via velbuslink.
+
+| Service data attribute | Optional | Description                              |
+| ---------------------- | -------- | ---------------------------------------- |
+| `interface`            | no       | The port used to connect to the bus (the same one used during configuration). |
+| `address`              | no       | The module address in decimal format, which is displayed on the device list on the integration page, if provided the service will only clear the cache for this model, without an address, the full velbuscache will be cleared. |
+
 ## Example automation
 
 The Velbus integration allows you to link a Velbus button (i.e., a button of a [VMBGPOD](https://www.velbus.eu/products/view/?id=416302&lang=en) module) to a controllable entity of Home Assistant.