Add UV protection window docs for OpenUV (#18911)

This commit is contained in:
Aaron Bach 2021-08-24 16:03:01 -06:00 committed by GitHub
parent 4b74a61cb2
commit 3581aa71bb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -18,6 +18,12 @@ ha_platforms:
The `openuv` integration displays UV and Ozone data from [openuv.io](https://www.openuv.io/). The `openuv` integration displays UV and Ozone data from [openuv.io](https://www.openuv.io/).
<div class='note warning'>
The guidelines within this documentation constitute estimates and are intended to help
informed decision making. They should not replace analysis, advice or diagnosis from a
trained medical professional.
</div>
## Generating an API Key ## Generating an API Key
To generate an API key, To generate an API key,
@ -47,7 +53,17 @@ the `update_protection_data` services).
| Current UV Index | Sensor | UV Index (numerical value) | | Current UV Index | Sensor | UV Index (numerical value) |
| Current UV Level | Sensor | UV Level (as literal) | | Current UV Level | Sensor | UV Level (as literal) |
| Max UV Index | Sensor | max UV Index for the day (at solar noon) | | Max UV Index | Sensor | max UV Index for the day (at solar noon) |
| Protection Window | Binary Sensor | 'On' when protection window is needed | | Protection Window | Binary Sensor | whether sunblock protection should be used |
### Protection Window
The Protection Window binary sensor will be `on` when sunblock protection should be used.
By default, this occurs anytime the UV index is above 3.5. This behavior can be
configured via the config entry options within the UI. Two parameters are given:
* `Starting UV index for the protection window`: the UV index that, when passed, indicates protection should be utilized
* `Ending UV index for the protection window`: the UV index that, when passed, indicates protection is no longer required
### The Fitzpatrick Scale ### The Fitzpatrick Scale
@ -55,12 +71,6 @@ The approximate number of minutes of a particular skin type can be exposed to
the sun before burning/tanning starts is based on the the sun before burning/tanning starts is based on the
[Fitzpatrick scale](https://en.wikipedia.org/wiki/Fitzpatrick_scale). [Fitzpatrick scale](https://en.wikipedia.org/wiki/Fitzpatrick_scale).
<div 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.
</div>
OpenUV integration provide sensors for safe exposure time (in minutes) based on skin type: OpenUV integration provide sensors for safe exposure time (in minutes) based on skin type:
- Skin Type 1 Safe Exposure Time - Skin Type 1 Safe Exposure Time