1833c32a2c
* Sets front matter defaults * Removes default front matter from section templates/pages * Removes default front matter from addon pages * Removes default front matter from integration pages * Removes default front matter from posts * Removes default front matter from docs pages * Removes default front matter from other pages * Fixes blog category pages
2.3 KiB
title, description, logo, ha_category, ha_qa_scale, ha_release
| title | description | logo | ha_category | ha_qa_scale | ha_release | |
|---|---|---|---|---|---|---|
| Sun | Instructions on how to track the sun within Home Assistant. | home-assistant.png |
|
internal | pre 0.7 |
The sun integration will use your current location to track if the sun is above or below the horizon. The sun can be used within automation as a trigger with an optional offset to simulate dawn/dusk or as a condition with an optional offset to test if the sun has already set or risen.
Configuration
# Example configuration.yaml entry
sun:
{% configuration %}
elevation:
description: "The (physical) elevation of your location, in meters above sea level. Defaults to the elevation in configuration.yaml, which is retrieved from Google Maps if not set."
required: false
type: integer
{% endconfiguration %}
Implementation Details
The sun's event listener will call the service when the sun rises or sets with an offset.
The sun event need to have the type 'sun', which service to call, which event (sunset or sunrise) and the offset.
{
"type": "sun",
"service": "switch.turn_on",
"event": "sunset",
"offset": "-01:00:00"
}
Maintains entity sun.sun
| Possible state | Description |
|---|---|
above_horizon |
When the sun is above the horizon. |
below_horizon |
When the sun is below the horizon. |
| State Attributes | Description |
|---|---|
next_rising |
Date and time of the next sun rising (in UTC). |
next_setting |
Date and time of the next sun setting (in UTC). |
next_dawn |
Date and time of the next dawn (in UTC). |
next_dusk |
Date and time of the next dusk (in UTC). |
next_noon |
Date and time of the next solar noon (in UTC). |
next_midnight |
Date and time of the next solar midnight (in UTC). |
elevation |
Solar elevation. This is the angle between the sun and the horizon. Negative values mean the sun is below the horizon. |
azimuth |
Solar azimuth. The angle is shown clockwise from north. |
rising |
True if the Sun is currently rising, after solar midnight and before solar noon. |