mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Update config variable description (#6981)
This commit is contained in:
parent
5f13e0d4ad
commit
0b28e90730
@ -20,99 +20,98 @@ The `openuv` component displays UV and Ozone data from [openuv.io](http://openuv
|
||||
To generate an API key, [simply log in to the OpenUV website](https://www.openuv.io/auth/google).
|
||||
|
||||
<p class='note warning'>
|
||||
The "Limited" plan (which is what new users are given by default) is limited to 500 API requests per day. In order to leave a buffer, the `openuv` component queries the API every 30 minutes by default. This value can be modifed (via the `scan_interval` key), but please note that over-running the API will require
|
||||
you to upgrade to a paid plan (and may disable your access in the meantime).
|
||||
The "Limited" plan (which is what new users are given by default) is limited to 500 API requests per day. In order to leave a buffer, the `openuv` component queries the API every 30 minutes by default. This value can be modifed (via the `scan_interval` key), but please note that over-running the API will require you to upgrade to a paid plan (and may disable your access in the meantime).
|
||||
</p>
|
||||
|
||||
## {% linkable_title Base Configuration %}
|
||||
## {% linkable_title Configuration %}
|
||||
|
||||
To retrieve data from OpenUV, add the following to your `configuration.yaml`
|
||||
file:
|
||||
To retrieve data from OpenUV, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
openuv:
|
||||
api_key: YOUR_OPENUV_API_KEY
|
||||
```
|
||||
|
||||
To configure additional functionality, add configuration options beneath a `binary_sensor` and/or `sensor` key within the `openuv` section of `configuration.yaml` as below:
|
||||
{% configuration %}
|
||||
api_key:
|
||||
description: The OpenUV API key.
|
||||
required: true
|
||||
type: string
|
||||
scan_interval:
|
||||
description: the frequency (in seconds) between data updates.
|
||||
required: false
|
||||
type: integer
|
||||
default: 1800
|
||||
binary_sensors:
|
||||
description: The binary sensor-related configuration options.
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
monitored_conditions:
|
||||
description: The conditions to create sensors from.
|
||||
required: false
|
||||
type: list
|
||||
default: all
|
||||
keys:
|
||||
uv_protection_window:
|
||||
description: Displays if UV protection (sunscreen, etc.) is recommended at the current date and time.
|
||||
sensors:
|
||||
description: The sensor-related configuration options.
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
monitored_conditions:
|
||||
description: The conditions to create sensors from.
|
||||
required: false
|
||||
type: list
|
||||
default: all
|
||||
keys:
|
||||
current_ozone_level:
|
||||
description: The current ozone level in du (Dobson Units).
|
||||
current_uv_index:
|
||||
description: The current UV index.
|
||||
current_uv_level:
|
||||
description: "The level of current UV index, which is calculated based on [UV Index Levels & Colors](https://www.openuv.io/kb/uv-index-levels-colors)."
|
||||
max_uv_index:
|
||||
description: The maximum UV index that will be encountered that day (at solar noon).
|
||||
safe_exposure_time_type_1:
|
||||
description: The approximate exposure time for skin type I.
|
||||
safe_exposure_time_type_2:
|
||||
description: The approximate exposure time for skin type II.
|
||||
safe_exposure_time_type_3:
|
||||
description: The approximate exposure time for skin type III.
|
||||
safe_exposure_time_type_4:
|
||||
description: The approximate exposure time for skin type IV.
|
||||
safe_exposure_time_type_5:
|
||||
description: The approximate exposure time for skin type V.
|
||||
safe_exposure_time_type_6:
|
||||
description: The approximate exposure time for skin type VI.
|
||||
{% endconfiguration %}
|
||||
|
||||
The approximate number of minutes of a particular skin type can be exposed to the sun before burning/tanning starts is based on the [Fitzpatrick scale](https://en.wikipedia.org/wiki/Fitzpatrick_scale).
|
||||
|
||||
## {% linkable_title Full example %}
|
||||
|
||||
To configure additional functionality, add configuration options beneath a `binary_sensor` and/or `sensor` key within the `openuv` section of the `configuration.yaml` file as below:
|
||||
|
||||
```yaml
|
||||
openuv:
|
||||
api_key: YOUR_OPENUV_API_KEY
|
||||
binary_sensors:
|
||||
# binary sensor configuration options...
|
||||
- uv_protection_window
|
||||
sensors:
|
||||
# sensor configuration options...
|
||||
- current_ozone_level
|
||||
- current_uv_index
|
||||
- current_uv_level
|
||||
- max_uv_index
|
||||
- safe_exposure_time_type_1
|
||||
- safe_exposure_time_type_2
|
||||
- safe_exposure_time_type_3
|
||||
- safe_exposure_time_type_4
|
||||
- safe_exposure_time_type_5
|
||||
- safe_exposure_time_type_6
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
api_key:
|
||||
description: your OpenUV API key
|
||||
required: true
|
||||
type: string
|
||||
scan_interval:
|
||||
description: the frequency (in seconds) between data updates
|
||||
required: false
|
||||
type: integer
|
||||
default: 1800
|
||||
binary_sensors:
|
||||
description: binary sensor-related configuration options
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
monitored_conditions:
|
||||
description: the conditions to create sensors from
|
||||
required: false
|
||||
type: list
|
||||
default: all (`uv_protection_window`)
|
||||
sensors:
|
||||
description: sensor-related configuration options
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
monitored_conditions:
|
||||
description: the conditions to create sensors from
|
||||
required: false
|
||||
type: list
|
||||
default: all ( `current_ozone_level`, `current_uv_index`, `current_uv_level`, `max_uv_index`, `safe_exposure_time_type_1`, `safe_exposure_time_type_2`, `safe_exposure_time_type_3`, `safe_exposure_time_type_4`, `safe_exposure_time_type_5`, `safe_exposure_time_type_6` )
|
||||
{% endconfiguration %}
|
||||
|
||||
## {% linkable_title Binary Sensor Types %}
|
||||
|
||||
### {% linkable_title `uv_protection_window` %}
|
||||
|
||||
This sensor displays `true` if UV protection (sunscreen, etc.) is recommended at the current date and time; displays `false` otherwise.
|
||||
|
||||
## {% linkable_title Sensor Types %}
|
||||
|
||||
### {% linkable_title `current_ozone_level` %}
|
||||
|
||||
This sensor displays the current ozone level in du (Dobson Units).
|
||||
|
||||
### {% linkable_title `current_uv_index` %}
|
||||
|
||||
This sensor displays the current UV index.
|
||||
|
||||
### {% linkable_title `current_uv_level` %}
|
||||
|
||||
This sensor displays the level of current UV index, which is calculated based on [UV Index Levels & Colors](https://www.openuv.io/kb/uv-index-levels-colors).
|
||||
|
||||
### {% linkable_title `max_uv_index` %}
|
||||
|
||||
This sensor displays the maximum UV index that will be encountered that day (at solar noon).
|
||||
|
||||
### {% linkable_title `safe_exposure_time_type_X` %}
|
||||
|
||||
These sensors display the approximate number of minutes a particular skin type can be exposed to the sun before burning/tanning starts. Each sensor depicts a skin type based on the
|
||||
[Fitzpatrick scale](https://en.wikipedia.org/wiki/Fitzpatrick_scale):
|
||||
|
||||
* Skin Type I
|
||||
* Skin Type II
|
||||
* Skin Type III
|
||||
* Skin Type IV
|
||||
* Skin Type V
|
||||
* Skin Type VI
|
||||
|
||||
<p class='note warning'>
|
||||
The above guidelines constitute estimates and are intended to help informed decision making. They should not replace analysis, advice, or diagnosis from a trained medical professional.
|
||||
The above guidelines constitute estimates and are intended to help informed decision making. They should not replace analysis, advice or diagnosis from a trained medical professional.
|
||||
</p>
|
||||
|
Loading…
x
Reference in New Issue
Block a user