From ba15619a7d1a126f42fb7460125ad2f5549be034 Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Mon, 25 Oct 2021 14:53:37 +0200 Subject: [PATCH 1/6] Fix markdownlint / spelling issues --- source/_integrations/broadlink.markdown | 3 +-- .../_integrations/brottsplatskartan.markdown | 1 - source/_integrations/browser.markdown | 7 ++++-- source/_integrations/buienradar.markdown | 18 +++++++-------- source/_integrations/calendar.google.markdown | 19 +++++++--------- source/_integrations/camera.markdown | 1 - source/_integrations/cast.markdown | 21 +++++++++++------- source/_integrations/channels.markdown | 3 ++- .../_integrations/cisco_webex_teams.markdown | 22 ++++++++++--------- source/_integrations/citybikes.markdown | 1 - source/_integrations/climate.mqtt.markdown | 8 +++---- source/_integrations/cloudflare.markdown | 1 + source/_integrations/command_line.markdown | 2 +- source/_integrations/control4.markdown | 1 + source/_integrations/conversation.markdown | 2 +- 15 files changed, 58 insertions(+), 52 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 7cbfe6f0e784..089482ebd1e7 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -29,7 +29,7 @@ The Broadlink integration allows you to control and monitor Broadlink universal {% include integrations/config_flow.md %} -### Entities and subdomains +## Entities and subdomains There is no more need to set up platforms, except for custom IR/RF switches. Once the device is configured, all entities will be created automatically. @@ -49,7 +49,6 @@ The `remote` entities allow you to learn and send codes with universal remotes. Use `remote.learn_command` to learn IR and RF codes. These codes are grouped by device and stored as commands in the [storage folder](#Learned%20codes%20storage%20location). They can be sent with the `remote.send_command` service later. - | Service data attribute | Optional | Description | | ---------------------- | -------- | ------------------------------------- | | `entity_id` | no | ID of the remote. | diff --git a/source/_integrations/brottsplatskartan.markdown b/source/_integrations/brottsplatskartan.markdown index 4432823668a4..a3a15aeb7640 100644 --- a/source/_integrations/brottsplatskartan.markdown +++ b/source/_integrations/brottsplatskartan.markdown @@ -43,7 +43,6 @@ longitude: default: Your home zone longitude defined in your configuration. {% endconfiguration %} - ## Notes ### Area diff --git a/source/_integrations/browser.markdown b/source/_integrations/browser.markdown index ed7a1d7ed90d..28c525f5b441 100644 --- a/source/_integrations/browser.markdown +++ b/source/_integrations/browser.markdown @@ -20,13 +20,16 @@ To load this component, add the following lines to your `configuration.yaml`: browser: ``` -#### Service `browser/browse_url` +### Services + +Once loaded, the `browser` platform will expose services that can be called to perform various actions. + +Available services: `browser/browse_url`. | Service data attribute | Optional | Description | | ---------------------- | -------- | ----------- | | `url` | no | The URL to open. - ### Usage To use this service, choose **Call Service** from the **Developer Tools**. Choose the service *browser/browse_url* from the list of **Available services:** and enter the URL into the **Service Data** field and hit **CALL SERVICE**. diff --git a/source/_integrations/buienradar.markdown b/source/_integrations/buienradar.markdown index f3b37f55e408..ac8481fa2e91 100644 --- a/source/_integrations/buienradar.markdown +++ b/source/_integrations/buienradar.markdown @@ -45,7 +45,7 @@ The Buienradar integration will set up separate sensor entities with more detail The following entities will be created: - **Station name**: The name of the selected meteo-station. -- **Barometer forecast**: A numeric barametric forecast (1 to 7) +- **Barometer forecast**: A numeric barometric forecast (1 to 7) - **Barometer forecast name**: "A textual representation of the barometer forecast (eg: Thunderstorms, Stable, etc.)." - **Condition code**: "A symbol and a unique code identifying the current weather condition ([a..z])." - **Condition**: A symbol and the current weather condition (`clear`, `cloudy`, `fog`, `rainy`, `snowy` or `lightning`). @@ -63,23 +63,23 @@ The following entities will be created: - **Pressure**: "The sea-level air pressure in [hPa](https://en.wikipedia.org/wiki/Hectopascal)." - **Visibility**: "Visibility in meters ([m](https://en.wikipedia.org/wiki/Metre))." - **Wind gust**: "The wind speed of wind gusts ([km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour))." -- **Precipation**: The amount of precipitation/rain in mm/h. -- **Precipation forecast average**: The average expected precipitation/rain in mm/h within the given time-frame. -- **Precipation forecast total**: The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. +- **Precipitation**: The amount of precipitation/rain in mm/h. +- **Precipitation forecast average**: The average expected precipitation/rain in mm/h within the given time-frame. +- **Precipitation forecast total**: The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. - **Irradiance**: "Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2))." - **Rain last 24h**: The rain over the last 24 hours (in mm). -- **Rain last hour**: The rain over the last hour (in mm). +- **Rain last hour**: The rain over the last hour (in mm). - **Temperature n days ahead**: "The forecasted temperature n days ahead (in [C](https://en.wikipedia.org/wiki/Celsius))." - **Minimum temperature n days ahead**: "The forecasted minimum temperature n days ahead (in [C](https://en.wikipedia.org/wiki/Celsius))." - **Rain chance n days ahead**: The forecasted chance for rain n days ahead (%). - **Sun chance n days ahead**: The forecasted chance for sun n days ahead (%). -- **Rain n days ahead**: "The forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead; the average of minrain_1d and maxrain_1d." +- **Rain n days ahead**: "The forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead; the average of minimum_rain_1d and maximum_rain_1d." - **Minimum rain n days ahead**: "The minimum forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead." - **Maximum rain n days ahead**: "The maximum forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead." -- **Wind azimuth n days ahead**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead. (derived from winddirection_1d) +- **Wind azimuth n days ahead**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead. (derived from wind_direction_1d) - **Wind direction n days ahead**: "Where the wind will be coming from n days ahead: N (North), Z (south), NO (North-East), etc." -- **Wind force n days ahead**: "The expected windforce in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale) n days ahead." -- **Wind speed n days ahead**: "The expected windspeed in [m/s](https://en.wikipedia.org/wiki/M/s) n days ahead (derived from windforce_1d)." +- **Wind force n days ahead**: "The expected wind force in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale) n days ahead." +- **Wind speed n days ahead**: "The expected wind speed in [m/s](https://en.wikipedia.org/wiki/M/s) n days ahead (derived from wind force_1d)." - **Condition code n days ahead**: Symbol and condition code of the expected condition n days ahead. - **Condition n days ahead**: Symbol and expected condition n days ahead. - **Detailed condition n days ahead**: Symbol and detailed expected condition n days ahead. diff --git a/source/_integrations/calendar.google.markdown b/source/_integrations/calendar.google.markdown index c77ae6ff9441..9318be436bdf 100644 --- a/source/_integrations/calendar.google.markdown +++ b/source/_integrations/calendar.google.markdown @@ -34,10 +34,9 @@ Generate a Client ID and Client Secret on 1. You will then be automatically taken to the OAuth consent screen, you do not need to add any scopes here so click `SAVE AND CONTINUE` to move to the `Test users` page. You will need to add the Gmail address you will be using with this integration as a test user before you will be allowed to use the API. Once you have added your email address under `Test users` click `SAVE AND CONTINUE` which will take to the 'Summary' page (you do not need to do anything here). 1. Click Credentials in the menu on the left hand side of the screen, then click `+ Create credentials` (at the top of the screen), then select `OAuth client ID`. 1. Set the Application type to `TV and Limited Input` and give this credential set a name (like "Home Assistant Credentials") then click 'Create'. -1. You will then be presented with a pop-up saying 'OAuth client created' showing `Your Client ID` and `Your Client Secret`. Make a note of these (for example, copy and paste them into a text editor) as you will need to put these in your `configuration.yaml` file shortly. Once you have noted these strings, click `OK`. If you need to find these credentials again at any point then simply nagivate to `APIs & Services` > `Credentials` and you will see `Home Assistant Credentials` (or whatever you named them in the previous step) under `OAuth 2.0 Clident IDs`. To view both the `Client ID` and `Client secret`, click on the pencil icon, this will take you to the settings page for these credentials and the information will be on the right hand side of the page. +1. You will then be presented with a pop-up saying 'OAuth client created' showing `Your Client ID` and `Your Client Secret`. Make a note of these (for example, copy and paste them into a text editor) as you will need to put these in your `configuration.yaml` file shortly. Once you have noted these strings, click `OK`. If you need to find these credentials again at any point then simply navigate to `APIs & Services` > `Credentials` and you will see `Home Assistant Credentials` (or whatever you named them in the previous step) under `OAuth 2.0 Clident IDs`. To view both the `Client ID` and `Client secret`, click on the pencil icon, this will take you to the settings page for these credentials and the information will be on the right hand side of the page. 1. We need to double check that the "Google Calendar API" has been automatically enabled. To do this, select `Library` from the menu, then search for "Google Calendar API". If it is enabled you will see `API Enabled` with a green tick next to it. If it is not enabled, then enable it. - If you will later be adding more scopes than just the "Google Calendar API" to the OAuth for this application, you will need to delete your token file under your Home Assistant Profile. You will lose your refresh token due to the re-authenticating to add more API access. It's recommended to use different authorizations for different pieces of Google. ## Troubleshooting @@ -173,17 +172,15 @@ entities: default: true {% endconfiguration %} - - ### Sensor attributes - - **offset_reached**: If set in the event title and parsed out will be `on`/`off` once the offset in the title in minutes is reached. So the title `Very important meeting #Important !!-10` would trigger this attribute to be `on` 10 minutes before the event starts. - - **all_day**: `true`/`false` if this is an all day event. Will be `false` if there is no event found. - - **message**: The event title with the `search` and `offset` values extracted. So in the above example for **offset_reached** the **message** would be set to `Very important meeting` - - **description**: The event description. - - **location**: The event Location. - - **start_time**: Start time of event. - - **end_time**: End time of event. +- **offset_reached**: If set in the event title and parsed out will be `on`/`off` once the offset in the title in minutes is reached. So the title `Very important meeting #Important !!-10` would trigger this attribute to be `on` 10 minutes before the event starts. +- **all_day**: `true`/`false` if this is an all day event. Will be `false` if there is no event found. +- **message**: The event title with the `search` and `offset` values extracted. So in the above example for **offset_reached** the **message** would be set to `Very important meeting` +- **description**: The event description. +- **location**: The event Location. +- **start_time**: Start time of event. +- **end_time**: End time of event. ### Service `google.add_event` diff --git a/source/_integrations/camera.markdown b/source/_integrations/camera.markdown index d1beb3acfb35..6a5e5d1185fe 100644 --- a/source/_integrations/camera.markdown +++ b/source/_integrations/camera.markdown @@ -21,7 +21,6 @@ The `Preload stream` option will start the camera feed on Home Assistant startup Example showing the Preload Stream option in the camera dialog.

- ### Services Once loaded, the `camera` platform will expose services that can be called to perform various actions. diff --git a/source/_integrations/cast.markdown b/source/_integrations/cast.markdown index d9179ee1e378..a393f487d6e6 100644 --- a/source/_integrations/cast.markdown +++ b/source/_integrations/cast.markdown @@ -44,6 +44,7 @@ cast_downstairs_on_kitchen: view_path: downstairs service: cast.show_lovelace_view ``` +
Home Assistant Cast requires your Home Assistant installation to be accessible via `https://`. If you're using Home Assistant Cloud, you don't need to do anything. Otherwise you must make sure that you have configured the `external_url` in your [configuration](/docs/configuration/basic). @@ -145,7 +146,7 @@ Optional: - `media_type`: Media type, e.g. `video/mp4`, `audio/mp3`, `image/jpeg`, defaults to `video/mp4`. -#### Example: +#### Example ```yaml 'cast_bubbleupnp_to_my_chromecast': @@ -178,7 +179,7 @@ Optional: - `enqueue`: Enqueue only - `playlist_id`: Play video with `media_id` from this playlist -#### Example: +#### Example ```yaml 'cast_youtube_to_my_chromecast': @@ -201,16 +202,18 @@ Optional: #### Media parameters Mandatory: + - `app_name`: `supla` - `media_id`: Supla item ID - Optional: + - `is_live`: Item is a livestream -#### Example: +#### Example Example values to cast the item at + ```yaml 'cast_supla_to_my_chromecast': alias: "Cast supla to My Chromecast" @@ -258,7 +261,7 @@ Optional: - `is_live`: Item is a live stream -#### Example: +#### Example Example values to cast [BBC Radio 1](https://www.bbc.co.uk/sounds/play/live:bbc_radio_one) @@ -290,8 +293,10 @@ This app doesn't retrieve its own metadata, so if you want the cast interface or Note: Media ID is NOT the 8 digit alphanumeric in the URL, it can be found by right-clicking the playing video. E.g., [this episode](https://www.bbc.co.uk/iplayer/episode/b09w7fd9/bitz-bob-series-1-1-castle-makeover) shows: - 2908kbps | dash (mf_cloudfront_dash_https) - b09w70r2 | 960x540 +| | | +| --- | --- | +| 2908kbps | dash (mf_cloudfront_dash_https) | +| b09w70r2 | 960x540 | With b09w70r2 being the `media_id` @@ -306,7 +311,7 @@ Optional: - `is_live`: Item is a live stream -#### Example: +#### Example Example values to cast [this episode](https://www.bbc.co.uk/iplayer/episode/b09w7fd9/bitz-bob-series-1-1-castle-makeover) diff --git a/source/_integrations/channels.markdown b/source/_integrations/channels.markdown index 026fd6dcfeca..40265c4065bf 100644 --- a/source/_integrations/channels.markdown +++ b/source/_integrations/channels.markdown @@ -14,6 +14,8 @@ The Channels platform allows you to control [Channels](https://getchannels.com/) Your favorite channels will appear as sources in the Source List in Home Assistant. +## Configuration + To add Channels to your installation, add the following to your `configuration.yaml` file: ```yaml @@ -49,7 +51,6 @@ Seek forward by the number of seconds currently set in settings on the instance | ---------------------- | -------- | ----------- | | `entity_id` | no | String that points at `entity_id` of Channels app. - ### Service `seek_backward` Seek backward by the number of seconds currently set in settings on the instance of Channels. diff --git a/source/_integrations/cisco_webex_teams.markdown b/source/_integrations/cisco_webex_teams.markdown index 672e2f473817..eb946f72f5cc 100644 --- a/source/_integrations/cisco_webex_teams.markdown +++ b/source/_integrations/cisco_webex_teams.markdown @@ -14,17 +14,19 @@ ha_platforms: The `cisco_webex_teams` notification platform allows you to deliver rich notifications from Home Assistant to [Cisco Webex Teams](https://www.webex.com/team-collaboration.html) (formerly known as Cisco Spark). -To use this notification platform you will need an app (bot) token. To obtain a token visit [Cisco Webex for Developers](https://developer.webex.com/). +To use this notification platform you will need an app (bot) token. To obtain a token visit [Cisco Webex for Developers](https://developer.webex.com/). + * Detailed instructions can be found in the section titled **Creating a Webex Teams Bot** on the [Webex Teams bot documentation](https://developer.webex.com/docs/bots). You also need to specify the `room_id` that you wish to post messages into. The `room_id` can be found in one of two ways: -1. Logging in at [Cisco Webex for Developers](https://developer.webex.com/) and navigate to `Documentation`>`API Reference`>`Messages` and select List Messages, or -2. Log into the web client at [teams.webex.com](https://teams.webex.com/), - * select the room (or create a new room), - * then copying the room ID from the URL. - -**Note:** you must add the bot email (in the format `mybot@webex.bot`) as a participant to the room specified above. +1. Logging in at [Cisco Webex for Developers](https://developer.webex.com/) and navigate to `Documentation`>`API Reference`>`Messages` and select List Messages, or +2. Log into the web client at [teams.webex.com](https://teams.webex.com/), + +* select the room (or create a new room), +* then copying the room ID from the URL. + +**Note: you must add the bot email (in the format `mybot@webex.bot`) as a participant to the room specified above.** To enable this platform in your installation, add the following to your `configuration.yaml` file: @@ -39,7 +41,7 @@ notify: ## Rich Text Formatting -Webex Teams clients can render rich text via a whitelisted set of html tags. +Webex Teams clients can render rich text via a whitelisted set of html tags. For example, you could configure automations to display details in an easy to read fashion like so: @@ -113,8 +115,8 @@ Here are the automations for the above screenshot: The following is a list of the allowed html tags and attributes: Tag | More Info ---- | --- -`<@personEmail:email@examplecompany.com>` | Used to tag another Webex Team user by email address. +--- | --- +`<@personEmail:email@examplecompany.com>` | Used to tag another Webex Team user by email address. `` | Defines a hyperlink. Allows attribute `href`. `
` | Defines a section that is quoted from another source. Allows attribute `class` with allowed values `danger`, `warning`, `info`, `primary`, `secondary`. `` | Defines bold text. diff --git a/source/_integrations/citybikes.markdown b/source/_integrations/citybikes.markdown index c26b4f413a10..01f22a3de4f2 100644 --- a/source/_integrations/citybikes.markdown +++ b/source/_integrations/citybikes.markdown @@ -52,7 +52,6 @@ stations: type: list {% endconfiguration %} - ## Example Additional configuration samples: diff --git a/source/_integrations/climate.mqtt.markdown b/source/_integrations/climate.mqtt.markdown index abb5cc6f07d1..d7af81076d26 100644 --- a/source/_integrations/climate.mqtt.markdown +++ b/source/_integrations/climate.mqtt.markdown @@ -357,11 +357,11 @@ value_template: required: false {% endconfiguration %} -#### Optimistic mode +## Optimistic mode If a property works in *optimistic mode* (when the corresponding state topic is not set), Home Assistant will assume that any state changes published to the command topics did work and change the internal state of the entity immediately after publishing to the command topic. If it does not work in optimistic mode, the internal state of the entity is only updated when the requested update is confirmed by the device through the state topic. -#### Using Templates +## Using Templates For all `*_state_topic`s, a template can be specified that will be used to render the incoming payloads on these topics. Also, a default template that applies to all state topics can be specified as `value_template`. This can be useful if you received payloads are e.g., in JSON format. Since in JSON, a quoted string (e.g., `"foo"`) is just a string, this can also be used for unquoting. @@ -386,9 +386,9 @@ climate: This will parse the incoming `"auto"` as JSON, resulting in `auto`. Obviously, in this case you could also just set `value_template: {% raw %}"{{ value_json }}"{% endraw %}`. -Similarly for `*_command_topic`s, a template can be specified to render the outgoing payloads on these topics. +Similarly for `*_command_topic`s, a template can be specified to render the outgoing payloads on these topics. -### Example +## Example A full configuration example looks like the one below. diff --git a/source/_integrations/cloudflare.markdown b/source/_integrations/cloudflare.markdown index d3901f617fda..0530a80146cd 100644 --- a/source/_integrations/cloudflare.markdown +++ b/source/_integrations/cloudflare.markdown @@ -55,6 +55,7 @@ This platform uses the API from [ipify.org](https://www.ipify.org/) to set the p ### Home Assistant Companion App If you would like to use [iOS App](https://companion.home-assistant.io/) via Cloudflare set **Minimum TLS version as 1.2**, in order to do that, do the following: + 1. Login to your [Cloudflare](https://dash.cloudflare.com/) account. 2. Choose your domain. 3. Click on the `SSL/TLS` icon. diff --git a/source/_integrations/command_line.markdown b/source/_integrations/command_line.markdown index 233d9a26c07b..97e73861dc55 100644 --- a/source/_integrations/command_line.markdown +++ b/source/_integrations/command_line.markdown @@ -119,7 +119,7 @@ binary_sensor: payload_off: "fail" ``` -Consider to use the [`ping` sensor ](/integrations/ping#binary-sensor) as an alternative to the samples above. +Consider to use the [ping sensor](/integrations/ping#binary-sensor) as an alternative to the samples above. ### Check if a system service is running diff --git a/source/_integrations/control4.markdown b/source/_integrations/control4.markdown index 07a469d9b7b4..a919eb2ebb41 100644 --- a/source/_integrations/control4.markdown +++ b/source/_integrations/control4.markdown @@ -20,6 +20,7 @@ The Control4 integration allows you to control and monitor lights from your loca Before setting up, you should assign a static IP address/DHCP reservation on your router to your Control4 controller. Home Assistant must be able to communicate with the controller over the local network; 4Sight remote access is not supported. {% include integrations/config_flow.md %} + ## Options The Control4 integration offers additional options in **Configuration** -> **Integrations** -> **Control4** -> **Options**: diff --git a/source/_integrations/conversation.markdown b/source/_integrations/conversation.markdown index 0c94100e1dc1..ed7d8354ef4d 100644 --- a/source/_integrations/conversation.markdown +++ b/source/_integrations/conversation.markdown @@ -94,7 +94,7 @@ intent_script: {% endraw %} -#### Service `conversation.process` +## Service `conversation.process` | Service data attribute | Optional | Description | |------------------------|----------|--------------------------------------------------| From d7655559571ceea5bdf1964eb5dbe61a5c5f7117 Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Mon, 25 Oct 2021 17:10:39 +0200 Subject: [PATCH 2/6] Fix indentation of nested list --- source/_integrations/cisco_webex_teams.markdown | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/_integrations/cisco_webex_teams.markdown b/source/_integrations/cisco_webex_teams.markdown index eb946f72f5cc..be9c0ab29bfb 100644 --- a/source/_integrations/cisco_webex_teams.markdown +++ b/source/_integrations/cisco_webex_teams.markdown @@ -22,9 +22,8 @@ You also need to specify the `room_id` that you wish to post messages into. The 1. Logging in at [Cisco Webex for Developers](https://developer.webex.com/) and navigate to `Documentation`>`API Reference`>`Messages` and select List Messages, or 2. Log into the web client at [teams.webex.com](https://teams.webex.com/), - -* select the room (or create a new room), -* then copying the room ID from the URL. + * select the room (or create a new room), + * then copying the room ID from the URL. **Note: you must add the bot email (in the format `mybot@webex.bot`) as a participant to the room specified above.** From 4f8743c2e0220766d1a9cc569a550bb4992987c3 Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Mon, 25 Oct 2021 17:18:24 +0200 Subject: [PATCH 3/6] Changed note into an actual note as per documentation --- source/_integrations/cisco_webex_teams.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_integrations/cisco_webex_teams.markdown b/source/_integrations/cisco_webex_teams.markdown index be9c0ab29bfb..282730760575 100644 --- a/source/_integrations/cisco_webex_teams.markdown +++ b/source/_integrations/cisco_webex_teams.markdown @@ -25,7 +25,11 @@ You also need to specify the `room_id` that you wish to post messages into. The * select the room (or create a new room), * then copying the room ID from the URL. -**Note: you must add the bot email (in the format `mybot@webex.bot`) as a participant to the room specified above.** +
+ +You must add the bot email (in the format `mybot@webex.bot`) as a participant to the room specified above. + +
To enable this platform in your installation, add the following to your `configuration.yaml` file: From 17c97ca231263baa66ce7d1b0e9ccdd18470a8cc Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Tue, 26 Oct 2021 11:19:08 +0200 Subject: [PATCH 4/6] =?UTF-8?q?Created=20a=20table=20for=20the=20different?= =?UTF-8?q?=20sensors.=20This=20increases=20readability.=20Also:=20-=20Cha?= =?UTF-8?q?nged=20C=20into=20=C2=B0C=20-=20Updated=20other=20units=20-=20F?= =?UTF-8?q?eel=20temperature=20is=20not=20correct=20English.=20Changed=20t?= =?UTF-8?q?o=20wind=20chill=20factor.=20-=20Do=20not=20refer=20to=20entity?= =?UTF-8?q?Ids,=20use=20the=20human-readable=20name=20instead.=20-=20Add?= =?UTF-8?q?=20a=20proper=20'Note'=20in=20the=20bottom=20of=20the=20page.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/_integrations/buienradar.markdown | 92 +++++++++++++----------- 1 file changed, 49 insertions(+), 43 deletions(-) diff --git a/source/_integrations/buienradar.markdown b/source/_integrations/buienradar.markdown index ac8481fa2e91..6cea6f39dd81 100644 --- a/source/_integrations/buienradar.markdown +++ b/source/_integrations/buienradar.markdown @@ -44,47 +44,49 @@ The Buienradar integration will set up separate sensor entities with more detail The following entities will be created: -- **Station name**: The name of the selected meteo-station. -- **Barometer forecast**: A numeric barometric forecast (1 to 7) -- **Barometer forecast name**: "A textual representation of the barometer forecast (eg: Thunderstorms, Stable, etc.)." -- **Condition code**: "A symbol and a unique code identifying the current weather condition ([a..z])." -- **Condition**: A symbol and the current weather condition (`clear`, `cloudy`, `fog`, `rainy`, `snowy` or `lightning`). -- **Condition detailed**: A symbol and detailed current weather condition (`clear`, `partlycloudy`, `cloudy`, `partlycloudy-fog`, `partlycloudy-light-rain`, `partlycloudy-rain`, `light-rain`, `rainy`, `snowy-rainy`, `partlycloudy-light-snow`, `partlycloudy-snow`, `light-snow`, `snowy`, `partlycloudy-lightning` or `lightning`). -- **Condition exact**: A symbol with the full current weather condition (in English). -- **Symbol**: A symbol for the current weather with the full current condition (in Dutch). -- **Feel temperature**: "The current feel temperature (in [C](https://en.wikipedia.org/wiki/Celsius))." -- **Humidity**: The relative humidity (%). -- **Temperature**: "The current temperature (in [C](https://en.wikipedia.org/wiki/Celsius))." -- **Ground temperature**: "The current ground temperature (in [C](https://en.wikipedia.org/wiki/Celsius))." -- **Wind speed**: "The wind speed in [km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)." -- **Wind force**: "The wind speed/force in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)." -- **Wind direction**: "Where the wind is coming from: N (North), Z (south), NO (North-East), etc." -- **Wind azimuth**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise. -- **Pressure**: "The sea-level air pressure in [hPa](https://en.wikipedia.org/wiki/Hectopascal)." -- **Visibility**: "Visibility in meters ([m](https://en.wikipedia.org/wiki/Metre))." -- **Wind gust**: "The wind speed of wind gusts ([km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour))." -- **Precipitation**: The amount of precipitation/rain in mm/h. -- **Precipitation forecast average**: The average expected precipitation/rain in mm/h within the given time-frame. -- **Precipitation forecast total**: The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. -- **Irradiance**: "Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2))." -- **Rain last 24h**: The rain over the last 24 hours (in mm). -- **Rain last hour**: The rain over the last hour (in mm). -- **Temperature n days ahead**: "The forecasted temperature n days ahead (in [C](https://en.wikipedia.org/wiki/Celsius))." -- **Minimum temperature n days ahead**: "The forecasted minimum temperature n days ahead (in [C](https://en.wikipedia.org/wiki/Celsius))." -- **Rain chance n days ahead**: The forecasted chance for rain n days ahead (%). -- **Sun chance n days ahead**: The forecasted chance for sun n days ahead (%). -- **Rain n days ahead**: "The forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead; the average of minimum_rain_1d and maximum_rain_1d." -- **Minimum rain n days ahead**: "The minimum forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead." -- **Maximum rain n days ahead**: "The maximum forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimeter) n days ahead." -- **Wind azimuth n days ahead**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead. (derived from wind_direction_1d) -- **Wind direction n days ahead**: "Where the wind will be coming from n days ahead: N (North), Z (south), NO (North-East), etc." -- **Wind force n days ahead**: "The expected wind force in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale) n days ahead." -- **Wind speed n days ahead**: "The expected wind speed in [m/s](https://en.wikipedia.org/wiki/M/s) n days ahead (derived from wind force_1d)." -- **Condition code n days ahead**: Symbol and condition code of the expected condition n days ahead. -- **Condition n days ahead**: Symbol and expected condition n days ahead. -- **Detailed condition n days ahead**: Symbol and detailed expected condition n days ahead. -- **Full condition (english) n days ahead**: Symbol and full expected condition n days ahead (in English). -- **Full condition (dutch) n days ahead**: Symbol and full expected condition n days ahead (in Dutch). +| Entity | Description | +| ------------------------------------- | ----------- | +| Station name | The name of the selected meteo-station | +| Barometer forecast | A numeric barometric forecast (1 to 7) | +| Barometer forecast name | A textual representation of the barometer forecast (eg: Thunderstorms, Stable, etc.) | +| Condition code | A symbol and a unique code identifying the current weather condition (`[a..z]`) | +| Condition | A symbol and the current weather condition (`clear`, `cloudy`, `fog`, `rainy`, `snowy` or `lightning`) | +| Condition detailed | A symbol and detailed current weather condition (`clear`, `partlycloudy`, `cloudy`, `partlycloudy-fog`, `partlycloudy-light-rain`, `partlycloudy-rain`, `light-rain`, `rainy`, `snowy-rainy`, `partlycloudy-light-snow`, `partlycloudy-snow`, `light-snow`, `snowy`, `partlycloudy-lightning` or `lightning`) | +| Condition exact | A symbol with the full current weather condition (in English) | +| Symbol | A symbol for the current weather with the full current condition (in Dutch) | +| Feel temperature | The current wind chill factor (in [°C](https://en.wikipedia.org/wiki/Celsius)) | +| Humidity | The relative humidity (in %) | +| Temperature | The current temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) | +| Ground temperature | The current ground temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) | +| Wind speed | The wind speed (in [km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) | +| Wind force | The wind speed/force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) | +| Wind direction | Where the wind is coming from: N (North), Z (south), NO (North-East), etc. | +| Wind azimuth | Where the wind is coming from in degrees, with true north at 0° and progressing clockwise | +| Pressure | The sea-level air pressure (in [hPa](https://en.wikipedia.org/wiki/Hectopascal)) | +| Visibility | Visibility (in [m](https://en.wikipedia.org/wiki/Metre)) | +| Wind gust | The wind speed of wind gusts ([km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) | +| Precipitation | The amount of precipitation/rain (in mm/h) | +| Precipitation forecast average | The average expected precipitation/rain within the given time-frame (in mm/h) | +| Precipitation forecast total | The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. | +| Irradiance | Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2)) | +| Rain last 24h | The rain over the last 24 hours (in [mm](https://en.wikipedia.org/wiki/Millimeter)) | +| Rain last hour | The rain over the last hour (in [mm](https://en.wikipedia.org/wiki/Millimeter)) | +| Temperature n days ahead | The forecasted temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) | +| Minimum temperature n days ahead | The forecasted minimum temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) | +| Rain chance n days ahead | The forecasted chance for rain n days ahead (in %) | +| Sun chance n days ahead | The forecasted chance for sun n days ahead (in %) | +| Rain n days ahead | The forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead; the average of `Minimum rain n days ahead` and `Maximum rain n days ahead` | +| Minimum rain n days ahead | The minimum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead | +| Maximum rain n days ahead | The maximum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead | +| Wind azimuth n days ahead | Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead (derived from `Wind direction n days ahead`) | +| Wind direction n days ahead | Where the wind will be coming from n days ahead: N (North), Z (south), NO (North-East), etc. | +| Wind force n days ahead | The expected wind force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) n days ahead | +| Wind speed n days ahead | The expected wind speed (in [m/s](https://en.wikipedia.org/wiki/M/s)) n days ahead (derived from `Wind force n days ahead`) | +| Condition code n days ahead | Symbol and condition code of the expected condition n days ahead | +| Condition n days ahead | Symbol and expected condition n days ahead | +| Detailed condition n days ahead | Symbol and detailed expected condition n days ahead | +| Full condition (english) n days ahead | Symbol and full expected condition n days ahead (in English) | +| Full condition (dutch) n days ahead | Symbol and full expected condition n days ahead (in Dutch) | {% include integrations/option_flow.md %} @@ -98,5 +100,9 @@ timeframe: description: Minutes to look ahead for precipitation forecast sensors (minimum 5, maximum 120). {% endconfiguration_basic %} -_[Usage statement:](https://www.buienradar.nl/overbuienradar/gratis-weerdata) -Buienradar makes free weather data available for use by individuals and businesses (website/intranet). The use of the weather data is allowed for **non-commercial purposes**. Please refer to the full usage statement linked above to confirm your use or to request permission._ +
+ +**Usage statement** +Buienradar makes free weather data available for use by individuals and businesses (website/intranet). The use of the weather data is allowed for **non-commercial purposes**. Please refer to the [full usage statement](https://www.buienradar.nl/overbuienradar/gratis-weerdata) to confirm your use or to request permission. + +
From 6abc4123bee9f5f572335111ed7b1977cb191d49 Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Wed, 27 Oct 2021 09:54:22 +0200 Subject: [PATCH 5/6] Renamed calendar.google.markdown file to (hopefully) resolve a merge conflict. --- .../_integrations/{calendar.google.markdown => google.markdown} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename source/_integrations/{calendar.google.markdown => google.markdown} (100%) diff --git a/source/_integrations/calendar.google.markdown b/source/_integrations/google.markdown similarity index 100% rename from source/_integrations/calendar.google.markdown rename to source/_integrations/google.markdown From b45708c11832d25641a2b7ead554125c82c7ecd4 Mon Sep 17 00:00:00 2001 From: Stefan Roelofs Date: Wed, 27 Oct 2021 10:55:37 +0200 Subject: [PATCH 6/6] Removed markdown table. --- source/_integrations/buienradar.markdown | 84 ++++++++++++------------ 1 file changed, 41 insertions(+), 43 deletions(-) diff --git a/source/_integrations/buienradar.markdown b/source/_integrations/buienradar.markdown index 6cea6f39dd81..e320f57ac7ea 100644 --- a/source/_integrations/buienradar.markdown +++ b/source/_integrations/buienradar.markdown @@ -44,49 +44,47 @@ The Buienradar integration will set up separate sensor entities with more detail The following entities will be created: -| Entity | Description | -| ------------------------------------- | ----------- | -| Station name | The name of the selected meteo-station | -| Barometer forecast | A numeric barometric forecast (1 to 7) | -| Barometer forecast name | A textual representation of the barometer forecast (eg: Thunderstorms, Stable, etc.) | -| Condition code | A symbol and a unique code identifying the current weather condition (`[a..z]`) | -| Condition | A symbol and the current weather condition (`clear`, `cloudy`, `fog`, `rainy`, `snowy` or `lightning`) | -| Condition detailed | A symbol and detailed current weather condition (`clear`, `partlycloudy`, `cloudy`, `partlycloudy-fog`, `partlycloudy-light-rain`, `partlycloudy-rain`, `light-rain`, `rainy`, `snowy-rainy`, `partlycloudy-light-snow`, `partlycloudy-snow`, `light-snow`, `snowy`, `partlycloudy-lightning` or `lightning`) | -| Condition exact | A symbol with the full current weather condition (in English) | -| Symbol | A symbol for the current weather with the full current condition (in Dutch) | -| Feel temperature | The current wind chill factor (in [°C](https://en.wikipedia.org/wiki/Celsius)) | -| Humidity | The relative humidity (in %) | -| Temperature | The current temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) | -| Ground temperature | The current ground temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) | -| Wind speed | The wind speed (in [km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) | -| Wind force | The wind speed/force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) | -| Wind direction | Where the wind is coming from: N (North), Z (south), NO (North-East), etc. | -| Wind azimuth | Where the wind is coming from in degrees, with true north at 0° and progressing clockwise | -| Pressure | The sea-level air pressure (in [hPa](https://en.wikipedia.org/wiki/Hectopascal)) | -| Visibility | Visibility (in [m](https://en.wikipedia.org/wiki/Metre)) | -| Wind gust | The wind speed of wind gusts ([km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) | -| Precipitation | The amount of precipitation/rain (in mm/h) | -| Precipitation forecast average | The average expected precipitation/rain within the given time-frame (in mm/h) | -| Precipitation forecast total | The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. | -| Irradiance | Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2)) | -| Rain last 24h | The rain over the last 24 hours (in [mm](https://en.wikipedia.org/wiki/Millimeter)) | -| Rain last hour | The rain over the last hour (in [mm](https://en.wikipedia.org/wiki/Millimeter)) | -| Temperature n days ahead | The forecasted temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) | -| Minimum temperature n days ahead | The forecasted minimum temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) | -| Rain chance n days ahead | The forecasted chance for rain n days ahead (in %) | -| Sun chance n days ahead | The forecasted chance for sun n days ahead (in %) | -| Rain n days ahead | The forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead; the average of `Minimum rain n days ahead` and `Maximum rain n days ahead` | -| Minimum rain n days ahead | The minimum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead | -| Maximum rain n days ahead | The maximum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead | -| Wind azimuth n days ahead | Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead (derived from `Wind direction n days ahead`) | -| Wind direction n days ahead | Where the wind will be coming from n days ahead: N (North), Z (south), NO (North-East), etc. | -| Wind force n days ahead | The expected wind force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) n days ahead | -| Wind speed n days ahead | The expected wind speed (in [m/s](https://en.wikipedia.org/wiki/M/s)) n days ahead (derived from `Wind force n days ahead`) | -| Condition code n days ahead | Symbol and condition code of the expected condition n days ahead | -| Condition n days ahead | Symbol and expected condition n days ahead | -| Detailed condition n days ahead | Symbol and detailed expected condition n days ahead | -| Full condition (english) n days ahead | Symbol and full expected condition n days ahead (in English) | -| Full condition (dutch) n days ahead | Symbol and full expected condition n days ahead (in Dutch) | +- **Station name**: The name of the selected meteo-station +- **Barometer forecast**: A numeric barometric forecast (1 to 7) +- **Barometer forecast name**: A textual representation of the barometer forecast (eg: Thunderstorms, Stable, etc.) +- **Condition code**: A symbol and a unique code identifying the current weather condition (`[a..z]`) +- **Condition**: A symbol and the current weather condition (`clear`, `cloudy`, `fog`, `rainy`, `snowy` or `lightning`) +- **Condition detailed**: A symbol and detailed current weather condition (`clear`, `partlycloudy`, `cloudy`, `partlycloudy-fog`, `partlycloudy-light-rain`, `partlycloudy-rain`, `light-rain`, `rainy`, `snowy-rainy`, `partlycloudy-light-snow`, `partlycloudy-snow`, `light-snow`, `snowy`, `partlycloudy-lightning` or `lightning`) +- **Condition exact**: A symbol with the full current weather condition (in English) +- **Symbol**: A symbol for the current weather with the full current condition (in Dutch) +- **Feel temperature**: The current wind chill factor (in [°C](https://en.wikipedia.org/wiki/Celsius)) +- **Humidity**: The relative humidity (in %) +- **Temperature**: The current temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) +- **Ground temperature**: The current ground temperature (in [°C](https://en.wikipedia.org/wiki/Celsius)) +- **Wind speed**: The wind speed (in [km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) +- **Wind force**: The wind speed/force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) +- **Wind direction**: Where the wind is coming from: N (North), Z (south), NO (North-East), etc. +- **Wind azimuth**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise +- **Pressure**: The sea-level air pressure (in [hPa](https://en.wikipedia.org/wiki/Hectopascal)) +- **Visibility**: Visibility (in [m](https://en.wikipedia.org/wiki/Metre)) +- **Wind gust**: The wind speed of wind gusts ([km/h](https://en.wikipedia.org/wiki/Kilometres_per_hour)) +- **Precipitation**: The amount of precipitation/rain (in mm/h) +- **Precipitation forecast average**: The average expected precipitation/rain within the given time-frame (in mm/h) +- **Precipitation forecast total**: The total expected precipitation/rain in mm within the given time-frame. The total expected rain in the configured time-frame will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with time-frame configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If time-frame is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. +- **Irradiance**: Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2)) +- **Rain last 24h**: The rain over the last 24 hours (in [mm](https://en.wikipedia.org/wiki/Millimeter)) +- **Rain last hour**: The rain over the last hour (in [mm](https://en.wikipedia.org/wiki/Millimeter)) +- **Temperature n days ahead**: The forecasted temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) +- **Minimum temperature n days ahead**: The forecasted minimum temperature n days ahead (in [°C](https://en.wikipedia.org/wiki/Celsius)) +- **Rain chance n days ahead**: The forecasted chance for rain n days ahead (in %) +- **Sun chance n days ahead**: The forecasted chance for sun n days ahead (in %) +- **Rain n days ahead**: The forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead; the average of `Minimum rain n days ahead` and `Maximum rain n days ahead` +- **Minimum rain n days ahead**: The minimum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead +- **Maximum rain n days ahead**: The maximum forecasted amount of rain (in [mm](https://en.wikipedia.org/wiki/Millimeter)) n days ahead +- **Wind azimuth n days ahead**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise for n days ahead (derived from `Wind direction n days ahead`) +- **Wind direction n days ahead**: Where the wind will be coming from n days ahead: N (North), Z (south), NO (North-East), etc. +- **Wind force n days ahead**: The expected wind force (in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale)) n days ahead +- **Wind speed n days ahead**: The expected wind speed (in [m/s](https://en.wikipedia.org/wiki/M/s)) n days ahead (derived from `Wind force n days ahead`) +- **Condition code n days ahead**: Symbol and condition code of the expected condition n days ahead +- **Condition n days ahead**: Symbol and expected condition n days ahead +- **Detailed condition n days ahead**: Symbol and detailed expected condition n days ahead +- **Full condition (english) n days ahead**: Symbol and full expected condition n days ahead (in English) +- **Full condition (dutch) n days ahead**: Symbol and full expected condition n days ahead (in Dutch) {% include integrations/option_flow.md %}