Clean up wxz (#7025)

Titles
Trailing spaces
Boolean capitalization
This commit is contained in:
Jorim Tielemans 2018-10-23 11:08:53 +02:00 committed by Fabian Affolter
parent 4504576383
commit c0d8b1fbf0
25 changed files with 108 additions and 98 deletions

View File

@ -37,7 +37,6 @@ Send a _magic packet_ to wake up a device with 'Wake-On-LAN' capabilities.
| `mac` | no | MAC address of the device to wake up. | | `mac` | no | MAC address of the device to wake up. |
| `broadcast_address` | yes | Optional broadcast IP where to send the magic packet. | | `broadcast_address` | yes | Optional broadcast IP where to send the magic packet. |
Sample service data: Sample service data:
```json ```json
@ -45,4 +44,3 @@ Sample service data:
"mac":"00:40:13:ed:f1:32" "mac":"00:40:13:ed:f1:32"
} }
``` ```

View File

@ -53,10 +53,8 @@ unit:
type: string type: string
{% endconfiguration %} {% endconfiguration %}
#### {% linkable_title Limitations %} #### {% linkable_title Limitations %}
The WebSocket interface used by this module requires active polling, otherwise the server side shuts down the connection. By default, this polling is happening every 10 seconds. All sensors are updated during every polling cycle. The WebSocket interface used by this module requires active polling, otherwise the server side shuts down the connection. By default, this polling is happening every 10 seconds. All sensors are updated during every polling cycle.
While this is communicating with a thermostat, geothermal systems operate most efficiently when setbacks are not used, and the home is kept at a constant temperature. It remains useful to collect the data from the system to understand its performance, but a full climate interface won't be implemented. While this is communicating with a thermostat, geothermal systems operate most efficiently when setbacks are not used, and the home is kept at a constant temperature. It remains useful to collect the data from the system to understand its performance, but a full climate interface won't be implemented.

View File

@ -83,7 +83,6 @@ include:
type: list type: list
{% endconfiguration %} {% endconfiguration %}
## {% linkable_title Examples %} ## {% linkable_title Examples %}
### {% linkable_title Full configuration %} ### {% linkable_title Full configuration %}

View File

@ -33,8 +33,8 @@ name:
station: station:
description: "The station ID string. See the [`sensor.bom` docs](/components/sensor.bom/) for details on how to find the ID of a station." description: "The station ID string. See the [`sensor.bom` docs](/components/sensor.bom/) for details on how to find the ID of a station."
required: optional required: optional
default: The closest station
type: string type: string
default: The closest station
{% endconfiguration %} {% endconfiguration %}
<p class='note'> <p class='note'>

View File

@ -41,12 +41,14 @@ longitude:
required: false required: false
type: float type: float
forecast: forecast:
description: "'True' to add a temperature forecast, 'False' to suppress it." description: "`true` to add a temperature forecast, `false` to suppress it."
required: false required: false
default: true
type: boolean type: boolean
default: true
{% endconfiguration %} {% endconfiguration %}
### {% linkable_title Full configuration %}
A full configuration example: A full configuration example:
```yaml ```yaml

View File

@ -29,16 +29,16 @@ weather:
name: name:
description: The name you would like to give to the weather station. description: The name you would like to give to the weather station.
required: false required: false
default: The name of the used station
type: string type: string
default: The name of the used station
latitude: latitude:
description: Latitude of the location for which you want weather information. description: Latitude of the location for which you want weather information.
required: false required: false
default: Home Assistant global latitude configuration
type: string type: string
default: Home Assistant global latitude configuration
longitude: longitude:
description: Longitude of the location for which you want weather information. description: Longitude of the location for which you want weather information.
required: false required: false
default: Home Assistant global longitude configuration
type: string type: string
default: Home Assistant global longitude configuration
{% endconfiguration %} {% endconfiguration %}

View File

@ -32,4 +32,3 @@ The `weather` platform only knows the below listed conditions. The reason for th
- 'windy' - 'windy'
- 'windy-variant' - 'windy-variant'
- 'exceptional': - 'exceptional':

View File

@ -24,7 +24,6 @@ weather:
- platform: met - platform: met
``` ```
{% configuration %} {% configuration %}
latitude: latitude:
description: Manually specify latitude. By default the value will be taken from the Home Assistant configuration. description: Manually specify latitude. By default the value will be taken from the Home Assistant configuration.

View File

@ -34,8 +34,8 @@ api_key:
name: name:
description: Additional name for the weather component in Home Assistant. description: Additional name for the weather component in Home Assistant.
required: false required: false
default: Met Office
type: string type: string
default: Met Office
latitude: latitude:
description: "Latitude coordinate to monitor weather of (required if **longitude** is specified), defaults to coordinates defined in your `configuration.yaml`." description: "Latitude coordinate to monitor weather of (required if **longitude** is specified), defaults to coordinates defined in your `configuration.yaml`."
required: inclusive required: inclusive
@ -50,4 +50,3 @@ longitude:
This platform is an alternative to the [`metoffice`](/components/sensor.metoffice/) sensor. This platform is an alternative to the [`metoffice`](/components/sensor.metoffice/) sensor.
The weather platform is easier to configure but less customizable. The weather platform is easier to configure but less customizable.
</p> </p>

View File

@ -30,29 +30,29 @@ weather:
{% configuration %} {% configuration %}
api_key: api_key:
required: true
description: Your API key for [OpenWeatherMap](http://openweathermap.org/). description: Your API key for [OpenWeatherMap](http://openweathermap.org/).
required: true
type: string type: string
name: name:
required: false
description: Name to use in the frontend. description: Name to use in the frontend.
required: false
type: string
default: OpenWeatherMap default: OpenWeatherMap
type: string
mode: mode:
required: false
description: "Can specify `hourly` or `daily`. Select `hourly` for a three-hour forecast or `daily` for daily forecast." description: "Can specify `hourly` or `daily`. Select `hourly` for a three-hour forecast or `daily` for daily forecast."
default: "`hourly`" required: false
type: string type: string
default: "`hourly`"
latitude: latitude:
required: false
description: Latitude of the location to display the weather. description: Latitude of the location to display the weather.
default: "The latitude in your `configuration.yaml` file."
type: float
longitude:
required: false required: false
description: Longitude of the location to display the weather.
default: "The longitude in your `configuration.yaml` file."
type: float type: float
default: "The latitude in your `configuration.yaml` file."
longitude:
description: Longitude of the location to display the weather.
required: false
type: float
default: "The longitude in your `configuration.yaml` file."
{% endconfiguration %} {% endconfiguration %}
<p class='note'> <p class='note'>

View File

@ -12,7 +12,6 @@ ha_category: Weather
ha_release: 0.47 ha_release: 0.47
--- ---
The `yweather` platform uses [Yahoo Weather](https://www.yahoo.com/news/weather/) as a source for current meteorological data. This component will show you the condition and temperatures for max. 10 days. The `yweather` platform uses [Yahoo Weather](https://www.yahoo.com/news/weather/) as a source for current meteorological data. This component will show you the condition and temperatures for max. 10 days.
<p class='note warning'> <p class='note warning'>
@ -39,8 +38,8 @@ woeid:
name: name:
description: The name of the sensor. To easily recognize each sensor when adding more than one Yahoo weather sensor, it is recommended to use the name option. description: The name of the sensor. To easily recognize each sensor when adding more than one Yahoo weather sensor, it is recommended to use the name option.
required: false required: false
default: yweather
type: string type: string
default: yweather
{% endconfiguration %} {% endconfiguration %}
<p class='note'> <p class='note'>

View File

@ -29,23 +29,23 @@ weather:
{% configuration %} {% configuration %}
station_id: station_id:
required: false
description: The ID number for a supported ZAMG station. description: The ID number for a supported ZAMG station.
required: false
type: string type: string
name: name:
required: false
description: A name for the weather platform. description: A name for the weather platform.
required: false
type: string type: string
latitude: latitude:
required: false
description: "Latitude coordinate to monitor weather of (required if **longitude** is specified)." description: "Latitude coordinate to monitor weather of (required if **longitude** is specified)."
default: "Defaults to coordinates defined in your `configuration.yaml` file."
type: float
longitude:
required: false required: false
description: "Longitude coordinate to monitor weather of (required if **latitude** is specified)."
default: "Defaults to coordinates defined in your `configuration.yaml` file."
type: float type: float
default: "Defaults to coordinates defined in your `configuration.yaml` file."
longitude:
description: "Longitude coordinate to monitor weather of (required if **latitude** is specified)."
required: false
type: float
default: "Defaults to coordinates defined in your `configuration.yaml` file."
{% endconfiguration %} {% endconfiguration %}
<p class='note'> <p class='note'>

View File

@ -15,6 +15,8 @@ ha_qa_scale: internal
The `weblink` component allows you to display links in the Home Assistant frontend. The `weblink` component allows you to display links in the Home Assistant frontend.
## {% linkable_title Configuration %}
To use this component in your installation, add something like the following to your `configuration.yaml` file: To use this component in your installation, add something like the following to your `configuration.yaml` file:
```yaml ```yaml

View File

@ -18,6 +18,8 @@ The `websocket_api` component set up a WebSocket API and allows one to interact
It is HIGHLY recommended that you set the `api_password`, especially if you are planning to expose your installation to the internet. It is HIGHLY recommended that you set the `api_password`, especially if you are planning to expose your installation to the internet.
</p> </p>
## {% linkable_title Configuration %}
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
websocket_api: websocket_api:

View File

@ -15,6 +15,8 @@ ha_release: pre 0.7
The `wemo` component is the main component to integrate various [Belkin WeMo](http://www.belkin.com/us/Products/home-automation/c/wemo-home-automation/) devices with Home Assistant. The `wemo` component is the main component to integrate various [Belkin WeMo](http://www.belkin.com/us/Products/home-automation/c/wemo-home-automation/) devices with Home Assistant.
## {% linkable_title Configuration %}
Supported devices will be automatically discovered if the discovery component is enabled. Loading the `wemo` component will scan the local network for WeMo devices, even if you are not using the discovery component Supported devices will be automatically discovered if the discovery component is enabled. Loading the `wemo` component will scan the local network for WeMo devices, even if you are not using the discovery component
```yaml ```yaml

View File

@ -78,8 +78,8 @@ client_secret:
local_control: local_control:
description: If set to `true` state changes for lights, locks and switches will be issued to the local hub. description: If set to `true` state changes for lights, locks and switches will be issued to the local hub.
required: false required: false
default: false
type: boolean type: boolean
default: false
{% endconfiguration %} {% endconfiguration %}
Local control: Local control:

View File

@ -15,6 +15,8 @@ ha_release: 0.68
The `wirelesstag` implementation allows you to integrate your [wirelesstag.net](http://wirelesstag.net) sensors tags in Home Assistant. The `wirelesstag` implementation allows you to integrate your [wirelesstag.net](http://wirelesstag.net) sensors tags in Home Assistant.
## {% linkable_title Configuration %}
To enable tags set up with your [wirelesstag.net](http://wirelesstag.net) account, add the following to your `configuration.yaml` file: To enable tags set up with your [wirelesstag.net](http://wirelesstag.net) account, add the following to your `configuration.yaml` file:
```yaml ```yaml
@ -25,14 +27,14 @@ wirelesstag:
``` ```
{% configuration %} {% configuration %}
username: username:
description: Username for your [wirelesstag.net](http://wirelesstag.net) account. description: Username for your wirelesstag.net account.
required: true required: true
type: string type: string
password: password:
description: Password for your [wirelesstag.net](http://wirelesstag.net) account. description: Password for your wirelesstag.net account.
required: true required: true
type: string type: string
{% endconfiguration %} {% endconfiguration %}
Finish your configuration by visiting the [WirelessTag binary sensor](/components/binary_sensor.wirelesstag/), [WirelessTag sensor](/components/sensor.wirelesstag/), or [WirelessTag switch](/components/switch.wirelesstag/) documentation. Finish your configuration by visiting the [WirelessTag binary sensor](/components/binary_sensor.wirelesstag/), [WirelessTag sensor](/components/sensor.wirelesstag/), or [WirelessTag switch](/components/switch.wirelesstag/) documentation.

View File

@ -92,38 +92,38 @@ xiaomi_aqara:
``` ```
{% configuration %} {% configuration %}
gateways: gateways:
description: A list of gateways to set up. description: A list of gateways to set up.
required: true required: true
type: map type: map
keys: keys:
mac: mac:
description: The MAC address of your gateway. *Optional if only using one gateway.* description: The MAC address of your gateway. *Optional if only using one gateway.*
required: false required: false
type: string type: string
key: key:
description: The key of your gateway. *Optional if only using sensors and/or binary sensors.* description: The key of your gateway. *Optional if only using sensors and/or binary sensors.*
required: false required: false
type: string type: string
host: host:
description: The host/IP address of the gateway. If this parameter is used the multicast discovery of the gateway is skipped. description: The host/IP address of the gateway. If this parameter is used the multicast discovery of the gateway is skipped.
required: false required: false
type: string type: string
disable: disable:
description: Disable the gateway. This is only useful if you don't want to integrate a specific gateway. description: Disable the gateway. This is only useful if you don't want to integrate a specific gateway.
required: false required: false
type: boolean type: boolean
default: false default: false
discovery_retry: discovery_retry:
description: Number of times that Home Assistant should try to reconnect to the gateway. description: Number of times that Home Assistant should try to reconnect to the gateway.
required: false required: false
type: integer type: integer
default: 3 default: 3
interface: interface:
description: Which network interface to use. description: Which network interface to use.
required: false required: false
type: string type: string
default: any default: any
{% endconfiguration %} {% endconfiguration %}
### {% linkable_title Services %} ### {% linkable_title Services %}
@ -274,4 +274,3 @@ That means that Home Assistant is not getting any response from your Xiaomi gate
- If you are using Home Assistant in [Docker](/docs/installation/docker/), make sure to use `--net=host`. - If you are using Home Assistant in [Docker](/docs/installation/docker/), make sure to use `--net=host`.
- If you receive an `{"error":"Invalid key"}` in your log while trying to control the gateway light, you should generate the key again using an Android Phone or alternatively an emulator such as [bluestacks](https://www.bluestacks.com). In some instances there is an issue with keys being generated using the iOS application. - If you receive an `{"error":"Invalid key"}` in your log while trying to control the gateway light, you should generate the key again using an Android Phone or alternatively an emulator such as [bluestacks](https://www.bluestacks.com). In some instances there is an issue with keys being generated using the iOS application.
- If the required library "PyXiaomiGateway" cannot be installed you will need to install some missing system dependencies `python3-dev`, `libssl-dev`, `libffi-dev` manually (e.g., `$ sudo apt-get install python3-dev libssl-dev libffi-dev`). - If the required library "PyXiaomiGateway" cannot be installed you will need to install some missing system dependencies `python3-dev`, `libssl-dev`, `libffi-dev` manually (e.g., `$ sudo apt-get install python3-dev libssl-dev libffi-dev`).

View File

@ -34,13 +34,13 @@ host:
path: path:
description: Path to your Zabbix install. description: Path to your Zabbix install.
required: false required: false
default: "`/zabbix/`"
type: string type: string
default: "`/zabbix/`"
ssl: ssl:
description: Set to `True` if your Zabbix installation is using SSL. description: Set to `True` if your Zabbix installation is using SSL.
required: false required: false
default: false
type: boolean type: boolean
default: false
username: username:
description: Your Zabbix username. description: Your Zabbix username.
required: false required: false

View File

@ -14,6 +14,8 @@ ha_release: 0.18
The `zeroconf` component exposes your Home Assistant to the local network using [Zeroconf](https://en.wikipedia.org/wiki/Zero-configuration_networking). Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi. The `zeroconf` component exposes your Home Assistant to the local network using [Zeroconf](https://en.wikipedia.org/wiki/Zero-configuration_networking). Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi.
## {% linkable_title Configuration %}
To integrate this into Home Assistant, add the following section to your `configuration.yaml` file: To integrate this into Home Assistant, add the following section to your `configuration.yaml` file:
```yaml ```yaml

View File

@ -31,6 +31,8 @@ Known working ZigBee radios:
- [Elelabs ZigBee USB Adapter](https://elelabs.com/products/elelabs_usb_adapter.html) - [Elelabs ZigBee USB Adapter](https://elelabs.com/products/elelabs_usb_adapter.html)
- [Elelabs ZigBee Raspberry Pi Shield](https://elelabs.com/products/elelabs_zigbee_shield.html) - [Elelabs ZigBee Raspberry Pi Shield](https://elelabs.com/products/elelabs_zigbee_shield.html)
## {% linkable_title Configuration %}
To configure the component, a `zha` section must be present in the `configuration.yaml`, To configure the component, a `zha` section must be present in the `configuration.yaml`,
and the path to the serial device for the radio and path to the database which will persist your network data is required. and the path to the serial device for the radio and path to the database which will persist your network data is required.
@ -45,8 +47,8 @@ zha:
radio_type: radio_type:
description: One of `ezsp` or `xbee`. description: One of `ezsp` or `xbee`.
required: false required: false
default: ezsp
type: string type: string
default: ezsp
usb_path: usb_path:
description: Path to the serial device for the radio. description: Path to the serial device for the radio.
required: true required: true
@ -54,8 +56,8 @@ usb_path:
baudrate: baudrate:
description: Baud rate of the serial device. description: Baud rate of the serial device.
required: false required: false
default: 57600
type: integer type: integer
default: 57600
database_path: database_path:
description: _Full_ path to the database which will keep persistent network data. description: _Full_ path to the database which will keep persistent network data.
required: true required: true

View File

@ -22,6 +22,8 @@ There is currently support for the following device types within Home Assistant:
- [Light](../light.zigbee) (digital output pins) - [Light](../light.zigbee) (digital output pins)
- [Switch](../switch.zigbee) (digital output pins) - [Switch](../switch.zigbee) (digital output pins)
## {% linkable_title Configuration %}
The local ZigBee device (assuming XBee) must have an up to date Router or Coordinator API firmware installed. The local ZigBee device (assuming XBee) must have an up to date Router or Coordinator API firmware installed.
A `zigbee` section must be present in the `configuration.yaml` file and contain the following options as required: A `zigbee` section must be present in the `configuration.yaml` file and contain the following options as required:
@ -35,13 +37,13 @@ zigbee:
device: device:
description: The serial port to which the local ZigBee device is connected. description: The serial port to which the local ZigBee device is connected.
required: false required: false
default: "/dev/ttyUSB0"
type: string type: string
default: "`/dev/ttyUSB0`"
baud: baud:
description: The baud rate at which to communicate with the local ZigBee device. description: The baud rate at which to communicate with the local ZigBee device.
required: false required: false
default: 9600
type: integer type: integer
default: 9600
{% endconfiguration %} {% endconfiguration %}
To find the possible serial port names of your device, run: To find the possible serial port names of your device, run:

View File

@ -53,8 +53,8 @@ longitude:
radius: radius:
description: The radius of the zone in meters. description: The radius of the zone in meters.
required: false required: false
default: 100
type: integer type: integer
default: 100
icon: icon:
description: The icon to show instead of name. description: The icon to show instead of name.
required: false required: false
@ -62,8 +62,8 @@ icon:
passive: passive:
description: To only use the zone for automation and hide it from the frontend and not use the zone for device tracker name. description: To only use the zone for automation and hide it from the frontend and not use the zone for device tracker name.
required: false required: false
default: false
type: boolean type: boolean
default: false
{% endconfiguration %} {% endconfiguration %}
To find the latitude/longitude of a certain place you can use [Google Maps](https://www.google.com/maps/) or [Bing Maps](https://www.bing.com/maps). Just right click and copy the coordinates from there (Bing) or click on the "What is here?" (Google) To find the latitude/longitude of a certain place you can use [Google Maps](https://www.google.com/maps/) or [Bing Maps](https://www.bing.com/maps). Just right click and copy the coordinates from there (Bing) or click on the "What is here?" (Google)

View File

@ -16,6 +16,8 @@ ha_iot_class: "Local Polling"
The ZoneMinder component sets up the integration with your [ZoneMinder](https://www.zoneminder.com) instance so that [cameras](/components/camera.zoneminder/), [sensors](/components/sensor.zoneminder/), and [switches](/components/switch.zoneminder) can use it. The ZoneMinder component sets up the integration with your [ZoneMinder](https://www.zoneminder.com) instance so that [cameras](/components/camera.zoneminder/), [sensors](/components/sensor.zoneminder/), and [switches](/components/switch.zoneminder) can use it.
## {% linkable_title Configuration %}
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
zoneminder: zoneminder:
@ -30,23 +32,23 @@ host:
path: path:
description: Path to your ZoneMinder install. description: Path to your ZoneMinder install.
required: false required: false
default: "`/zm/`"
type: string type: string
default: "`/zm/`"
path_zms: path_zms:
description: Path to the CGI script for streaming. This should match `PATH_ZMS` in ZM's "Paths" settings. description: Path to the CGI script for streaming. This should match `PATH_ZMS` in ZM's "Paths" settings.
required: false required: false
default: "`/zm/cgi-bin/nph-zms`"
type: string type: string
default: "`/zm/cgi-bin/nph-zms`"
ssl: ssl:
description: Set to `true` if your ZoneMinder installation is using SSL. description: Set to `true` if your ZoneMinder installation is using SSL.
required: false required: false
default: false
type: boolean type: boolean
default: false
verify_ssl: verify_ssl:
description: Verify the certification of the endpoint. description: Verify the certification of the endpoint.
required: false required: false
default: true
type: boolean type: boolean
default: true
username: username:
description: Your ZoneMinder username. description: Your ZoneMinder username.
required: false required: false

View File

@ -15,6 +15,8 @@ ha_iot_class: "Local Push"
The [Z-Wave](http://www.z-wave.com/) integration for Home Assistant allows you to observe and control connected Z-Wave devices. Please see the [Z-Wave getting started section](/docs/z-wave/) for in-depth documentation on how to use and setup the Z-Wave component. The [Z-Wave](http://www.z-wave.com/) integration for Home Assistant allows you to observe and control connected Z-Wave devices. Please see the [Z-Wave getting started section](/docs/z-wave/) for in-depth documentation on how to use and setup the Z-Wave component.
## {% linkable_title Configuration %}
If you have setup the requirements, then add the following entry `configuration.yaml` file: If you have setup the requirements, then add the following entry `configuration.yaml` file:
```yaml ```yaml