forked from home-assistant/home-assistant.io
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Velbus config parameters (home-assistant#36308)
Co-authored-by: c0ffeeca7 <[email protected]>
- Loading branch information
Showing
1 changed file
with
25 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -31,18 +31,24 @@ ha_integration_type: hub | |
|
||
The **Velbus** {% term integration %} is used to control [Velbus](https://www.velbus.eu/?lang=en) modules. It supports the Velbus USB, Velbus serial and a TCP/IP gateway. | ||
|
||
The pushbutton LEDs of input modules are disabled by default. These can be enabled from the `Devices` panel in the `Configuration` page of the web interface. | ||
|
||
{% include integrations/config_flow.md %} | ||
|
||
The port string used in the user interface or the configuration file can have 2 formats: | ||
### Configuration parameters | ||
|
||
- For a serial device: `/dev/ttyUSB00` | ||
- For a TCP/IP device: `127.0.0.1:3678` | ||
- For the VMBSIG module: `tls://192.168.1.9:27015` | ||
The port string used in the user interface or the configuration file can have different formats depending on the type of connection: | ||
|
||
## Actions | ||
|
||
- For a serial or USB devices: `/dev/ttyUSB00` | ||
- For a TCP/IP devices: `127.0.0.1:3678` | ||
- For Signum devices without authentication: `tls://192.168.1.9:27015` | ||
- For Signum devices with authentication: `tls://[email protected]:27015` | ||
|
||
{% note %} | ||
The pushbutton LEDs of input modules are disabled by default. These can be enabled from the **Devices** panel in the **Configuration** page of the web interface. | ||
{% endnote %} | ||
|
||
## Actions | ||
- `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. | ||
|
@@ -99,8 +105,11 @@ Use this action when you make changes to your configuration via velbuslink. | |
| `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. | | ||
|
||
|
||
## VMB7IN and the Energy dashboard | ||
|
||
The VMB7IN sensor can be integrated with Home Assistant's Energy dashboard to track your utility consumption. | ||
|
||
In some cases, the VMB7IN sensor does not report what the counter is counting. If the counter is related to an energy device, everything will work out of the box. | ||
But if the VMB7IN sensor is a water or gas counter, you will need to specify this in your configuration.yaml file. | ||
|
||
|
@@ -115,6 +124,7 @@ The device_class attribute can have 2 values: | |
- gas: if the counter represents a gas meter | ||
- water: if the counter represents a water meter | ||
|
||
|
||
## Example automation | ||
|
||
The Velbus {% term 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 {% term entity %} of Home Assistant. | ||
|
@@ -165,3 +175,12 @@ The actual linking can be realized by two automation rules. One rule to control | |
entity_id: light.led_push_button_10 | ||
``` | ||
|
||
## Removing the integration | ||
|
||
The Velbus integration and its entities can be removed by following these steps: | ||
|
||
{% include integrations/remove_device_service.md %} | ||
|
||
Note: Removing the integration will delete all Velbus devices and their history from Home Assistant. | ||
|