mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
Merge branch 'current' into rc
This commit is contained in:
Franck Nijhof
commit
e3effc0249
@ -88,7 +88,7 @@ GEM
|
||||
prism (0.30.0)
|
||||
public_suffix (6.0.0)
|
||||
racc (1.8.0)
|
||||
rack (3.1.4)
|
||||
rack (3.1.6)
|
||||
rack-protection (4.0.0)
|
||||
base64 (>= 0.1.0)
|
||||
rack (>= 3.0.0, < 4)
|
||||
@ -130,9 +130,8 @@ GEM
|
||||
ruby2_keywords (0.0.5)
|
||||
safe_yaml (1.0.5)
|
||||
sass (3.4.25)
|
||||
sass-embedded (1.77.5)
|
||||
sass-embedded (1.77.5-x86_64-linux-gnu)
|
||||
google-protobuf (>= 3.25, < 5.0)
|
||||
rake (>= 13)
|
||||
sass-globbing (1.1.5)
|
||||
sass (>= 3.1)
|
||||
sassc (2.1.0-x86_64-linux)
|
||||
@ -143,7 +142,7 @@ GEM
|
||||
rack-protection (= 4.0.0)
|
||||
rack-session (>= 2.0.0, < 3)
|
||||
tilt (~> 2.0)
|
||||
sorbet-runtime (0.5.11460)
|
||||
sorbet-runtime (0.5.11466)
|
||||
stringex (2.8.6)
|
||||
strscan (3.1.0)
|
||||
terminal-table (3.0.2)
|
||||
|
||||
@ -286,6 +286,7 @@ header .breadcrumbs {
|
||||
.links {
|
||||
margin-top: 12px;
|
||||
margin-right: -8px;
|
||||
margin-bottom: -8px;
|
||||
font-size: .9rem;
|
||||
text-align: right;
|
||||
|
||||
@ -401,7 +402,13 @@ a.material-card:hover {
|
||||
}
|
||||
}
|
||||
|
||||
/* not contained inside frontpage class */
|
||||
.hero {
|
||||
display: flex;
|
||||
}
|
||||
|
||||
.frontpage {
|
||||
|
||||
.material-card {
|
||||
margin-bottom: 24px;
|
||||
}
|
||||
@ -483,11 +490,11 @@ a.material-card:hover {
|
||||
border: none;
|
||||
|
||||
.caption {
|
||||
padding: 16px 12px 12px;
|
||||
padding: 8px 12px 12px;
|
||||
background-color: rgba(0, 0, 0, 0.54);
|
||||
color: white;
|
||||
border-bottom-left-radius: 8px;
|
||||
border-bottom-right-radius: 8px;
|
||||
border-bottom-left-radius: 16px;
|
||||
border-bottom-right-radius: 16px;
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
@ -495,9 +502,12 @@ a.material-card:hover {
|
||||
.title {
|
||||
font-size: 20px;
|
||||
font-weight: 400;
|
||||
line-height: 1.2em;
|
||||
}
|
||||
|
||||
.subtitle {
|
||||
margin-top: 4px;
|
||||
line-height: 1.4em;
|
||||
font-size: 12px;
|
||||
font-weight: initial;
|
||||
}
|
||||
@ -532,26 +542,37 @@ a.material-card:hover {
|
||||
margin-top: 24px;
|
||||
}
|
||||
|
||||
.sponsored-by {
|
||||
img {
|
||||
border: 0;
|
||||
border-radius: 0;
|
||||
box-shadow: none;
|
||||
margin: 15px;
|
||||
max-width: 40%;
|
||||
max-height: 80px;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
.seen-press {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
|
||||
column-gap: 24px;
|
||||
row-gap: 24px;
|
||||
margin: 48px 0;
|
||||
|
||||
h2 {
|
||||
grid-column: 1/-1;
|
||||
margin: 0;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
a {
|
||||
aspect-ratio: 1;
|
||||
}
|
||||
|
||||
img {
|
||||
border: 0;
|
||||
box-shadow: none;
|
||||
margin: 15px;
|
||||
max-width: 40%;
|
||||
max-height: 70px;
|
||||
margin: 24px;
|
||||
width: calc(100% - 48px);
|
||||
max-height: 128px;
|
||||
border-radius: 0;
|
||||
}
|
||||
|
||||
.material-card {
|
||||
height: 100%;
|
||||
align-content: center;
|
||||
text-align: center;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.square {
|
||||
@ -562,6 +583,18 @@ a.material-card:hover {
|
||||
border-radius: 50%;
|
||||
}
|
||||
}
|
||||
|
||||
.sponsored-by {
|
||||
text-align: center;
|
||||
|
||||
img {
|
||||
border: 0;
|
||||
border-radius: 0;
|
||||
box-shadow: none;
|
||||
margin: 24px;
|
||||
max-height: 160px;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@media screen and (max-width: 700px) {
|
||||
@ -620,7 +653,6 @@ article.page,
|
||||
article.listing {
|
||||
font-size: 1.125em;
|
||||
line-height: 1.6;
|
||||
overflow: hidden;
|
||||
|
||||
img,
|
||||
table {
|
||||
@ -681,6 +713,7 @@ article.listing {
|
||||
overflow-wrap: break-word;
|
||||
|
||||
&.btn {
|
||||
font-size: 1.1em;
|
||||
text-decoration: none;
|
||||
transition: box-shadow .33;
|
||||
|
||||
|
||||
@ -44,6 +44,8 @@
|
||||
|
||||
@media only screen and (max-width: $lap-end) {
|
||||
#sidebar {
|
||||
max-height: fit-content;
|
||||
|
||||
.grid {
|
||||
position: initial;
|
||||
width: 100%;
|
||||
|
||||
@ -26,11 +26,11 @@
|
||||
}
|
||||
|
||||
.card-content {
|
||||
padding-left: 24px;
|
||||
padding-bottom: 24px;
|
||||
|
||||
p:last-of-type,
|
||||
ul {
|
||||
margin-bottom: 12px;
|
||||
margin-bottom: 32px;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@ -62,7 +62,7 @@
|
||||
background-color: $link-color;
|
||||
font-size: 2rem;
|
||||
font-weight: 700;
|
||||
padding: 8px 24px;
|
||||
padding: 8px 20px 8px 28px;
|
||||
margin-bottom: 16px;
|
||||
}
|
||||
}
|
||||
@ -123,8 +123,11 @@
|
||||
}
|
||||
}
|
||||
|
||||
@media only screen and (max-width: $palm-end) {
|
||||
@media only screen and (max-width: 760px) {
|
||||
.hero {
|
||||
.flex {
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
#HAdemo {
|
||||
display: none;
|
||||
@ -133,5 +136,6 @@
|
||||
#HAdemoScreenshot {
|
||||
display: block;
|
||||
}
|
||||
|
||||
}
|
||||
}
|
||||
@ -126,19 +126,32 @@
|
||||
|
||||
.button {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
padding-right: 20px;
|
||||
border-radius: 32px;
|
||||
|
||||
&:not(:first-child) {
|
||||
margin-top: 12px;
|
||||
}
|
||||
|
||||
&.accent {
|
||||
background-color: #34b155;
|
||||
iconify-icon.external-link {
|
||||
padding-top: 4px;
|
||||
}
|
||||
|
||||
svg {
|
||||
fill: white;
|
||||
fill: $link-color;
|
||||
height: 24px;
|
||||
min-width: 24px;
|
||||
}
|
||||
|
||||
&.accent {
|
||||
background-color: #34b155;
|
||||
color: white;
|
||||
|
||||
svg {
|
||||
fill: white;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@ -11,6 +11,13 @@ $ha__primary_color: #03a9f4;
|
||||
}
|
||||
}
|
||||
|
||||
footer {
|
||||
.grid-wrapper {
|
||||
max-width: 1100px !important;
|
||||
padding: 0 25px !important;
|
||||
}
|
||||
}
|
||||
|
||||
.grid-wrapper {
|
||||
max-width: 1500px;
|
||||
padding: 0;
|
||||
|
||||
@ -5,7 +5,7 @@ description: "Details about the database used by Home Assistant."
|
||||
|
||||
Home Assistant uses databases to store {% term events %} and parameters for history and tracking. The default database used is [SQLite](https://www.sqlite.org/).
|
||||
|
||||
The database file is stored in your [configuration directory](/getting-started/configuration/) (e.g., `<path to config dir>/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration.
|
||||
The database file is stored in your [configuration directory](/docs/configuration/#to-find-the-configuration-directory) (e.g., `<path to config dir>/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration.
|
||||
|
||||
To work with SQLite database manually from the command-line, you will need an [installation](https://www.sqlitetutorial.net/download-install-sqlite/) of `sqlite3`. Alternatively [DB Browser for SQLite](https://sqlitebrowser.org/) provides a viewer for exploring the database data and an editor for executing SQL commands.
|
||||
First load your database with `sqlite3`:
|
||||
|
||||
@ -70,6 +70,12 @@ To set up file access, follow the steps for your [installation method](/installa
|
||||
- {% term "Home Assistant Core" %}: the `configuration.yaml` is in the config folder passed to the `hass` command (default is `~/.homeassistant`).
|
||||
3. Once you located the config folder, you can edit your `configuration.yaml` file.
|
||||
|
||||
{% note %}
|
||||
|
||||
If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. Refer to the [default config integration](/integrations/default_config/) for more information on what's included in that line.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Validating the configuration
|
||||
|
||||
After changing configuration or automation files, you can check if the configuration is valid. A configuration check is also applied automatically when you reload the configuration or when you restart Home Assistant.
|
||||
|
||||
@ -1,8 +0,0 @@
|
||||
---
|
||||
title: "Python 2"
|
||||
description: "Support for Python 2"
|
||||
ha_category: Common
|
||||
---
|
||||
|
||||
|
||||
There will be no support for Python 2.x. Python 2 will be EOL in [2020](https://www.python.org/dev/peps/pep-0373/#id2) and it doesn't make any sense to support a release which was planned to be retired in 2015.
|
||||
@ -1,5 +1,5 @@
|
||||
<section class="aside-module grid__item one-whole lap-one-half">
|
||||
<h1 class="title epsilon">About Home Assistant</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:about-circle-outline"></iconify-icon> About Home Assistant</h1>
|
||||
<ul class="divided">
|
||||
<li>
|
||||
{{ site.description }}
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
<section class="aside-module grid__item one-whole lap-one-half">
|
||||
<h1 class="title epsilon">Categories</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:category"></iconify-icon> Categories</h1>
|
||||
<ul class="divided">
|
||||
{% assign categories = site.categories | sort %}
|
||||
{% for category in categories %}
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
{% assign elements = site.dashboards | sort_natural: 'title' %}
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Dashboards</h1>
|
||||
<h1 class="title epsilon"><iconify-icon icon="mdi:view-dashboard"></iconify-icon> Dashboards</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /dashboards/ Introduction %}</li>
|
||||
<li>
|
||||
@ -21,7 +21,7 @@
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">View types</h1>
|
||||
<h1 class="title epsilon"><iconify-icon icon="mdi:about-circle-outline"></iconify-icon> View types</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
{% for element in elements %}
|
||||
{% if element.type == "view" %}
|
||||
@ -32,7 +32,7 @@
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Card types</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:card-multiple-outline"></iconify-icon> Card types</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
{% for element in elements %}
|
||||
{% if element.type == "card" %}
|
||||
@ -43,7 +43,7 @@
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Advanced</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:cog"></iconify-icon> Advanced</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /dashboards/features/ Features %}</li>
|
||||
<li>{% active_link /dashboards/header-footer/ Headers & footers %}</li>
|
||||
|
||||
@ -17,7 +17,7 @@
|
||||
%}
|
||||
</li>
|
||||
<li>
|
||||
{% active_link /getting-started/configuration/ Advanced configuration %}
|
||||
{% active_link /getting-started/configuration/ Next steps %}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
<section id="recent-posts" class="aside-module grid__item one-whole lap-one-half">
|
||||
<h1 class="title epsilon">Recent Posts</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:newspaper-variant-multiple"></iconify-icon> Recent Posts</h1>
|
||||
<ul class="divided">
|
||||
{% for post in site.posts limit: site.recent_posts %}
|
||||
{% if post.url != page.url %}
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
{% assign elements = site.dashboards | sort_natural: 'title' %}
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Devices</h1>
|
||||
<h1 class="title epsilon"><iconify-icon icon="mdi:devices"></iconify-icon> Devices</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /voice_control/android/ Assist for Android %}</li>
|
||||
<li>{% active_link /voice_control/apple/ Assist for Apple %}</li>
|
||||
@ -11,7 +11,7 @@
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">{% active_link /voice_control/ Voice assistants %}</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:comment-processing-outline"></iconify-icon> {% active_link /voice_control/ Voice assistants %}</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /voice_control/voice_remote_local_assistant/ Configuring a local assistant %}</li>
|
||||
<li>{% active_link /voice_control/voice_remote_cloud_assistant/ Configuring a cloud assistant %}</li>
|
||||
@ -27,7 +27,7 @@
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Projects</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:checkbox-marked"></iconify-icon> Projects</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /voice_control/s3_box_voice_assistant/ Tutorial: ESP32-S3-BOX voice assistant %}</li>
|
||||
<li>{% active_link /voice_control/s3-box-customize/ Tutorial: Customize the S3-BOX %}</li>
|
||||
@ -38,7 +38,7 @@
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section">
|
||||
<h1 class="title epsilon">Troubleshooting</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:account-help"></iconify-icon> Troubleshooting</h1>
|
||||
<ul class="divided sidebar-menu">
|
||||
<li>{% active_link /voice_control/troubleshooting/ Troubleshooting Assist %}</li>
|
||||
<li>{% active_link /voice_control/troubleshooting_the_s3_box/ Troubleshooting the ESP32-S3-BOX %}</li>
|
||||
|
||||
@ -1,3 +1,7 @@
|
||||
<section class="grid features">
|
||||
<div class="grid__item one-whole">
|
||||
<h2 class="sub-title">Features</h2>
|
||||
|
||||
<div class="feature-cards">
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
@ -17,6 +21,7 @@
|
||||
<a class="button" href="/integrations">EXPLORE INTEGRATIONS</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
<iconify-icon inline icon="mdi:robot-happy-outline"></iconify-icon>
|
||||
@ -95,6 +100,7 @@
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
<iconify-icon inline icon="mdi:solar-power-variant"></iconify-icon>
|
||||
@ -117,3 +123,6 @@
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</section>
|
||||
@ -23,7 +23,7 @@ document.querySelector('.site-title').addEventListener('contextmenu', function(e
|
||||
const changeNavColor = () => {
|
||||
const scrollPosition = document.documentElement.scrollTop;
|
||||
const nav = document.querySelector("header");
|
||||
if (scrollPosition <= 10) {
|
||||
if (scrollPosition <= 1) {
|
||||
nav.classList.add("dark");
|
||||
} else {
|
||||
nav.classList.remove("dark");
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
<section class="sharing aside-module grid__item one-whole lap-one-half">
|
||||
<h1 class="title epsilon">Share this post</h1>
|
||||
<h1 class="title epsilon"><iconify-icon inline icon="mdi:ios-share"></iconify-icon> Share this post</h1>
|
||||
<ul class="divided">
|
||||
{% if site.twitter_tweet_button %}
|
||||
<li>
|
||||
|
||||
@ -33,6 +33,7 @@
|
||||
<a class="external-link" href="https://community.home-assistant.io">Community Forum <iconify-icon inline icon="tabler:external-link"></iconify-icon></a>
|
||||
</li>
|
||||
<li><a href="/help/reporting_issues/">Reporting issues</a></li>
|
||||
<li><a href="https://home-assistant-store.creator-spring.com/">Community Merch Store</a></li>
|
||||
</ul>
|
||||
<h4>System status</h4>
|
||||
<ul>
|
||||
@ -47,6 +48,12 @@
|
||||
</div>
|
||||
|
||||
<div class="grid__item one-quarter lap-one-half palm-one-whole">
|
||||
<h4>Companion apps</h4>
|
||||
<ul>
|
||||
<li><a class="external-link" href="https://apps.apple.com/us/app/home-assistant/id1099568401">iOS and Apple devices</a></li>
|
||||
<li><a class="external-link" href="https://play.google.com/store/apps/details?id=io.homeassistant.companion.android">Android and Wear OS</a></li>
|
||||
<li><a class="external-link" href="https://companion.home-assistant.io/">...and more!</a></li>
|
||||
</ul>
|
||||
<h4>Governance</h4>
|
||||
<ul>
|
||||
<li><a href="/privacy/">Privacy Notices</a></li>
|
||||
|
||||
@ -1,12 +1,12 @@
|
||||
<div class="hero">
|
||||
<div class="grid-wrapper">
|
||||
<div class="grid flex">
|
||||
<div class="grid__item flex__item three-fifths lap-one-half palm-one-whole">
|
||||
<div class="grid__item flex__item three-fifths lap-one-whole palm-one-whole">
|
||||
{% include custom/welcome.html %}
|
||||
</div>
|
||||
<div class="grid__item flex__item two-fifths lap-one-half palm-one-whole">
|
||||
<div class="grid__item flex__item two-fifths lap-one-whole palm-one-whole">
|
||||
<iframe id="HAdemo" title="Home Assistant Demo"
|
||||
src="https://demo.home-assistant.io/">
|
||||
src="https://demo.home-assistant.io/?frontpage">
|
||||
</iframe>
|
||||
|
||||
<a id="HAdemoScreenshot" href='https://demo.home-assistant.io/' target='_blank'>
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Aprilaire
|
||||
description: Instructions on how to integrate Aprilaire devices into Home Assistant.
|
||||
title: AprilAire
|
||||
description: Instructions on how to integrate AprilAire devices into Home Assistant.
|
||||
ha_category:
|
||||
- Climate
|
||||
ha_iot_class: Local Push
|
||||
@ -16,11 +16,11 @@ ha_platforms:
|
||||
ha_integration_type: device
|
||||
---
|
||||
|
||||
The Aprilaire integration allows you to control an Aprilaire thermostat.
|
||||
The AprilAire integration allows you to control an AprilAire thermostat.
|
||||
|
||||
## Supported Models
|
||||
|
||||
This integration supports Aprilaire [8800-series Home Automation Wi-Fi Thermostats](https://www.aprilaire.com/whole-house-products/thermostats/home-automation) and [6000-series Wi-Fi Zone Control devices](https://www.aprilaire.com/whole-house-products/zone-control) which support setting the thermostat to automation mode. It is known that there are some models which are marketed as home automation capable that do not support automation mode, and are therefore not supported.
|
||||
This integration supports AprilAire [8800-series Home Automation Wi-Fi Thermostats](https://www.aprilaire.com/whole-house-products/thermostats/home-automation) and [6000-series Wi-Fi Zone Control devices](https://www.aprilaire.com/whole-house-products/zone-control) which support setting the thermostat to automation mode. It is known that there are some models which are marketed as home automation capable that do not support automation mode, and are therefore not supported.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
@ -30,4 +30,4 @@ In order to connect to the thermostat, you will need to enable automation mode.
|
||||
|
||||
## Caution regarding device limitations
|
||||
|
||||
Due to limitations of the thermostats, only one automation connection to a device is permitted at one time (the Aprilaire app is not included in this limitation as it uses a separate protocol). Attempting to connect multiple times to the same thermostat simultaneously can cause various issues, including the thermostat becoming unresponsive and shutting down. If this does occur, power cycling the thermostat should restore functionality.
|
||||
Due to limitations of the thermostats, only one automation connection to a device is permitted at one time (the AprilAire app is not included in this limitation as it uses a separate protocol). Attempting to connect multiple times to the same thermostat simultaneously can cause various issues, including the thermostat becoming unresponsive and shutting down. If this does occur, power cycling the thermostat should restore functionality.
|
||||
|
||||
@ -29,7 +29,11 @@ related:
|
||||
title: Configuration file
|
||||
---
|
||||
|
||||
The **Broadlink** {% term integration %} allows you to control and monitor Broadlink universal remotes, smart plugs, power strips, switches and sensors. The following devices are supported:
|
||||
The **Broadlink** {% term integration %} allows you to control and monitor Broadlink universal remotes, smart plugs, power strips, switches and sensors.
|
||||
|
||||
The manufacturer's app is required in order to connect new devices to the network.
|
||||
|
||||
The following devices are supported:
|
||||
|
||||
- Thermostats: `Hysen HY02B05H` and `Floureon HY03WE`
|
||||
- Power Strips: `MP1-1K3S2U` and `MP1-1K4S`
|
||||
|
||||
@ -8,7 +8,6 @@ ha_category:
|
||||
ha_iot_class: Cloud Push
|
||||
ha_release: 0.77
|
||||
ha_codeowners:
|
||||
- '@OverloadUT'
|
||||
- '@mib1185'
|
||||
- '@edenhaus'
|
||||
- '@Augar'
|
||||
|
||||
@ -22,7 +22,7 @@ The `glances` integration allows you to monitor the system information provided
|
||||
Support for Glances api version 2 is deprecated. It is recommended to upgrade your Glances server to version 3. Once upgraded, reload the integration to connect again.
|
||||
{% endimportant %}
|
||||
|
||||
These sensors needs a running instance of `glances` on the host. The minimal supported version of `glances` is 2.3.
|
||||
These sensors needs a running instance of `glances` in [Web Server Mode](https://glances.readthedocs.io/en/latest/quickstart.html#web-server-mode) on the host. The minimal supported version of `glances` is 2.3.
|
||||
|
||||
For details about auto-starting `glances`, please refer to [Start Glances through Systemd](https://github.com/nicolargo/glances/wiki/Start-Glances-through-Systemd).
|
||||
|
||||
|
||||
@ -14,7 +14,7 @@ related:
|
||||
title: Configuration file
|
||||
---
|
||||
|
||||
The `marytts` text-to-speech {% term integration %} uses [MaryTTS](http://mary.dfki.de/) text-to-speech engine to read a text with natural sounding voices.
|
||||
The `marytts` text-to-speech {% term integration %} uses [MaryTTS](https://marytts.github.io/) text-to-speech engine to read a text with natural sounding voices.
|
||||
|
||||
## Configuration
|
||||
|
||||
@ -59,7 +59,7 @@ effect:
|
||||
type: map
|
||||
{% endconfiguration %}
|
||||
|
||||
See [documentation](http://mary.dfki.de/documentation/index.html) for details.
|
||||
See [documentation](https://marytts.github.io/documentation/index.html) for details.
|
||||
|
||||
## Speech effects
|
||||
|
||||
|
||||
@ -301,6 +301,7 @@ Battery-powered Reolink cameras can be used with Home Assistant with the help of
|
||||
|
||||
The following battery-powered models have been tested and confirmed to work through the Reolink Home Hub:
|
||||
|
||||
- [Argus 4 Pro](https://reolink.com/product/argus-4-pro/)
|
||||
- [Argus Eco Ultra](https://reolink.com/product/argus-eco-ultra/)
|
||||
- [Argus Track](https://reolink.com/product/argus-track/)
|
||||
- [Reolink Doorbell Battery](https://reolink.com/roadmap/)
|
||||
|
||||
@ -50,4 +50,6 @@ The {% term integration %} adds the following sensors:
|
||||
|
||||
The {% term integration %} adds the following switch:
|
||||
|
||||
- Auto-charge mode
|
||||
| Name | Description |
|
||||
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Auto-charge mode | When enabled, vehicles will start charging automatically when plugged in. When turned off, charging will need to be manually started each time a vehicle is plugged in. Note: Disabling auto-charge mode does not interrupt an ongoing charging session. |
|
||||
|
||||
@ -1,59 +1,48 @@
|
||||
---
|
||||
title: "Advanced Configuration"
|
||||
description: "Instructions to get Home Assistant configured."
|
||||
title: "Next steps"
|
||||
description: "Next steps in configuring your Home Assistant"
|
||||
related:
|
||||
- docs: configuration/basic/
|
||||
title: Changing basic settings
|
||||
- docs: /docs/configuration/
|
||||
title: configuration.yaml file
|
||||
- docs: /common-tasks/os/#network-storage
|
||||
title: Network storage
|
||||
- docs: /common-tasks/os/#backups
|
||||
title: Backups
|
||||
- docs: /voice_control/
|
||||
title: Voice control
|
||||
- url: https://companion.home-assistant.io/
|
||||
title: Home Assistant on Android and iOS
|
||||
---
|
||||
|
||||
The onboarding process takes care of the initial setup for Home Assistant, such as naming your home and selecting your location. After initial onboarding, these options can be changed in the user interface by clicking on Configuration in the sidebar and clicking on General, or by manually editing them in the Home Assistant configuration file called `configuration.yaml`. This section will explain how to do the latter.
|
||||
The onboarding process takes you through the initial setup for Home Assistant, such as getting the system up and running, naming your home and selecting your location. This section points you to further documentation helping you with the next steps.
|
||||
|
||||
{% note %}
|
||||
The steps below do not apply to Home Assistant Core & Container installations, for those types of installations, [see here](/docs/configuration/).
|
||||
{% endnote %}
|
||||
## Changing the basic settings
|
||||
|
||||
We are going to help you make your first changes to `configuration.yaml`. To do this, we are going to install an add-on from the Home Assistant add-on store: the File editor. To get to the add-on store, go to {% my supervisor title="Settings > Add-ons" %}. On the new page, open the add-on store tab.
|
||||
To change basic settings such as location, unit system and language, refer to [Changing basic settings](/docs/configuration/basic/).
|
||||
|
||||
|
||||
## Creating a backup
|
||||
|
||||
Under the **Official add-ons** section, you will find the **File editor** add-on.
|
||||
You can back up your Home Assistant, add-on data, and configuration. Backups are used to restore a system or parts of it if a rollback is needed, or to migrate your Home Assistant to new hardware. It is good practice to create a backup before updating.
|
||||
|
||||
- Click on **File editor** and click on **Install**. When the installation is complete, the UI will go to the add-on details page for the file editor.
|
||||
- Now start the add-on by clicking on **Start**.
|
||||
- Open the user interface by clicking on **Open Web UI**.
|
||||
To learn how to create a backup of your Home Assistant installation, refer to the following topics:
|
||||
|
||||
Now let's make a change using the file editor: we are going to change the name, location, unit system, and time zone of your Home Assistant installation.
|
||||
- {% term "Home Assistant Operating System" %}: [Creating a backup from OS](/common-tasks/os/#backups)
|
||||
- {% term "Home Assistant Supervised" %}: [Creating a backup from Supervised](/common-tasks/supervised/#backups)
|
||||
|
||||
- Click the folder icon in the top left of the file editor window to open the file browser sidebar.
|
||||
- Click the `configuration.yaml` file (in the `/config/` folder) to load it into the main file editor window.
|
||||
- Add the following to this file (preferably at the very top, but it ultimately doesn't matter):
|
||||
```yaml
|
||||
homeassistant:
|
||||
name: Home
|
||||
latitude: xx.xxxx
|
||||
longitude: xx.xxxx
|
||||
unit_system: us_customary
|
||||
time_zone: America/Chicago
|
||||
```
|
||||
{% note %}
|
||||
## Editing the configuration.yaml and configuring file access
|
||||
|
||||
Valid options for `unit_system` are `us_customary` or `metric`. See [here](https://timezonedb.com/time-zones) for a list of valid time zones. Enter the appropriate option found under the Time Zone column at that page.
|
||||
While you can configure most of Home Assistant from the user interface, for some integrations, you will need to [edit the `configuration.yaml` file](/docs/configuration/). This file contains integrations to be loaded along with their configurations. Throughout the documentation, you will find snippets that you can add to your configuration file to enable specific functionality. For starters, there is no need to edit the `configuration.yaml` file. You will be pointed to the documentation when this is needed.
|
||||
|
||||
{% endnote %}
|
||||
## Setting up network storage
|
||||
|
||||
- Click the save icon in the top right to commit changes.
|
||||
- Most changes in `configuration.yaml` require Home Assistant to be restarted to see the changes. You can verify that your changes are acceptable by running a configuration check. Do this by navigating to {% my server_controls title="Developer Tools > YAML" %} and then clicking on the **Check configuration** button. When it's valid, it will show the text "Configuration valid!". In order for the **Check Configuration**" button to be visible, you must enable **Advanced Mode** on your user profile.
|
||||
- Now restart Home Assistant. You can do so by either using the **Restart** option in the ⚙ menu of the File Editor UI or by navigating to {% my system_dashboard title="Settings > System" %} and then clicking on the **Restart** button on the top right of the page.
|
||||
If you need more space to store data, you can configure a [network storage](/common-tasks/os/#network-storage), for example to store backups or to access media.
|
||||
|
||||
|
||||
## Getting started with voice assistant
|
||||
|
||||
{% note %}
|
||||
If you want to get started with a voice assistant, refer to the documentation on [Assist](/voice_control/).
|
||||
|
||||
If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. [See here](/integrations/default_config/) for more information on what's included in that line.
|
||||
## Apps for Android and iOS
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Editing configuration via Samba/Windows Networking
|
||||
|
||||
Maybe you are not a big fan of our web editor and want to use a text editor on your computer instead. This is possible by sharing the configuration over the network using the Samba add-on, which can also be installed from the Home Assistant add-on store. This will make your configuration accessible via the network tab on your computer.
|
||||
|
||||
Go to the add-on store and look for Samba in the core section. After you have installed the add-on, click on **Start**. Home Assistant should now be available in the networking tab on your computer.
|
||||
|
||||
We suggest that to edit `configuration.yaml`, you use the free text editor [Visual Studio Code](https://code.visualstudio.com/) in combination with the [Home Assistant Configuration Helper extension](https://marketplace.visualstudio.com/items?itemName=keesschollaart.vscode-home-assistant).
|
||||
If you are looking for information on Home Assistant for Android or iOS, refer to the [documentation for the Companion Apps](https://companion.home-assistant.io/).
|
||||
|
||||
@ -15,4 +15,4 @@ show_title: true
|
||||
{% include getting-started/next_step.html step="Automation" link="/getting-started/automation/" icon="mdi:robot-happy" %}
|
||||
{% include getting-started/next_step.html step="Presence detection" link="/getting-started/presence-detection/" icon="mdi:motion-detector" %}
|
||||
{% include getting-started/next_step.html step="Join the community" link="/getting-started/join-the-community/" icon="mdi:people-group-outline" %}
|
||||
{% include getting-started/next_step.html step="Advanced Configuration" link="/getting-started/configuration/" icon="mdi:cog" %}
|
||||
{% include getting-started/next_step.html step="Next steps" link="/getting-started/configuration/" icon="mdi:cog" %}
|
||||
|
||||
@ -7,7 +7,7 @@ You made it here? Good job! You've been able to install Home Assistant and get a
|
||||
|
||||
Now that you've got that going, let's see what is next:
|
||||
|
||||
- Learn about [advanced configuration](/getting-started/configuration/) using `configuration.yaml` in our bonus step of the getting started guide.
|
||||
- Learn about [next steps](/getting-started/configuration/) of the getting started guide, such as creating a backup or configuring network storage.
|
||||
- Join the community in [our forums] or [our chat].
|
||||
- Check out [video tutorials] on a wide range of Home Assistant related topics
|
||||
|
||||
|
||||
@ -75,11 +75,9 @@ article.page h3 {
|
||||
text-transform: unset;
|
||||
}
|
||||
|
||||
@media only screen and (max-width: 480px) {
|
||||
#landingpage .page-content {
|
||||
padding-top: 68px;
|
||||
}
|
||||
}
|
||||
|
||||
.exploded-view-animation {
|
||||
position: relative;
|
||||
|
||||
@ -7,10 +7,10 @@ regenerate: true
|
||||
feedback: false
|
||||
---
|
||||
|
||||
{% assign recent_release_post = site.categories['Core'].first %}
|
||||
|
||||
<div class="frontpage">
|
||||
<div class="grid">
|
||||
|
||||
<!-- Left sidebar begins -->
|
||||
<div class="grid__item one-third lap-one-third palm-one-whole">
|
||||
|
||||
<div class="recent-posts material-card text">
|
||||
@ -75,8 +75,10 @@ feedback: false
|
||||
style="background-image: url(/images/frontpage/cast-frontpage.png)"
|
||||
>
|
||||
<div class="caption">
|
||||
<div>
|
||||
<div class="title">
|
||||
Take over all the screens
|
||||
</div>
|
||||
<div class="subtitle">
|
||||
Home Assistant Cast makes every TV a display.
|
||||
</div>
|
||||
@ -89,6 +91,9 @@ feedback: false
|
||||
</div>
|
||||
</a>
|
||||
</div>
|
||||
<!-- Left sidebar ends -->
|
||||
|
||||
<!-- Right content begins -->
|
||||
<div class="grid__item two-thirds lap-two-thirds palm-one-whole">
|
||||
<!-- State of the Open Home -->
|
||||
<a
|
||||
@ -111,8 +116,10 @@ feedback: false
|
||||
"
|
||||
>
|
||||
<div class="caption">
|
||||
<div>
|
||||
<div class="title">
|
||||
Control your home with Assist
|
||||
</div>
|
||||
<div class="subtitle">
|
||||
Our private, insanely fast, voice assistant running on affordable
|
||||
hardware. Now supporting wake words.
|
||||
@ -139,8 +146,10 @@ feedback: false
|
||||
"
|
||||
>
|
||||
<div class="caption">
|
||||
<div>
|
||||
<div class="title">
|
||||
{{page.title}}
|
||||
</div>
|
||||
<div class="subtitle">{{page.description}}</div>
|
||||
</div>
|
||||
<svg viewBox="0 0 24 24">
|
||||
@ -170,8 +179,10 @@ feedback: false
|
||||
"
|
||||
>
|
||||
<div class="caption">
|
||||
<div>
|
||||
<div class="title">
|
||||
Home Assistant Tags
|
||||
</div>
|
||||
<div class="subtitle">
|
||||
Use NFC to bring music to your life or automate the mundane.
|
||||
</div>
|
||||
@ -190,8 +201,10 @@ feedback: false
|
||||
style="background-image: url(/images/merchandise/shirt-frontpage.png)"
|
||||
>
|
||||
<div class="caption">
|
||||
<div>
|
||||
<div class="title">
|
||||
Join the Home Assistant t-shirt revolution!
|
||||
</div>
|
||||
<div class="subtitle">
|
||||
Look sharp in blue, black or gray. Wearing a HA t-shirt is okay.
|
||||
</div>
|
||||
@ -204,117 +217,126 @@ feedback: false
|
||||
</div>
|
||||
</a>
|
||||
</div>
|
||||
<!-- Right content ends -->
|
||||
|
||||
<div class="sub-title">Features</div>
|
||||
|
||||
<!-- Features section -->
|
||||
{% include custom/features.html %}
|
||||
<div class="grid sponsors-and-press">
|
||||
<div class="sponsored-by grid__item one-half lap-one-half palm-one-whole">
|
||||
<div class="material-card text">
|
||||
<h1>Home Assistant is sponsored by</h1>
|
||||
|
||||
<a href="https://www.nabucasa.com"
|
||||
><img alt="Nabu Casa logo" src="/images/sponsors/nabu_casa.svg"
|
||||
/></a>
|
||||
</div>
|
||||
</div>
|
||||
<div class="seen-press grid__item one-half lap-one-half palm-one-whole">
|
||||
<div class="material-card text">
|
||||
<h1>Home Assistant in the press</h1>
|
||||
|
||||
<!-- Press section -->
|
||||
<section class="grid sponsors-and-press">
|
||||
<div class="seen-press grid__item one-whole">
|
||||
<h2>Home Assistant in the press</h2>
|
||||
|
||||
<a
|
||||
href="https://www.theverge.com/2021/9/16/22678088/home-assistant-amber-smart-home-hub-specs-release-date-price"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img alt="The Verge logo" src="/images/press/theverge.svg"
|
||||
/></a>
|
||||
><div class="material-card"><img alt="The Verge logo" src="/images/press/theverge.svg"
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://arstechnica.com/information-technology/2021/03/how-to-achieve-smart-home-nirvana-or-home-automation-without-subscription/"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="ArsTechnica.com logo"
|
||||
src="/images/press/arstechnica.svg"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://tweakers.net/reviews/8704/paulus-schoutsen-home-assistant-concurreert-met-alles-wat-via-de-cloud-gaat.html"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img alt="Tweakers.net logo" src="/images/press/tweakers.png"
|
||||
/></a>
|
||||
><div class="material-card"><img alt="Tweakers.net logo" src="/images/press/tweakers.png"
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.youtube.com/watch?v=x7pSkVarixU"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="Linus Tech Tips logo"
|
||||
class="square"
|
||||
src="/images/press/ltt.svg"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.troyhunt.com/iot-unravelled-part-1-its-a-mess-but-then-theres-home-assistant/"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
class="square round"
|
||||
alt="Troy Hunt logo"
|
||||
src="/images/press/troyhunt.jpg"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.tomshardware.com/news/raspberry-pi-home-assistant-amber"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="Tom's Hardware logo"
|
||||
src="/images/press/tomshardware.svg"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.producthunt.com/posts/home-assistant"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="ProductHunt.com logo"
|
||||
src="/images/press/producthunt.com.png"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.linux.com/news/home-assistant-python-approach-home-automation-video"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img alt="Linux.com logo" src="/images/press/linux.com.png"
|
||||
/></a>
|
||||
><div class="material-card"><img alt="Linux.com logo" src="/images/press/linux.com.png"
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://opensource.com/article/17/7/home-automation-primer"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="OpenSource.com logo"
|
||||
src="/images/press/opensource.com.svg"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="http://www.linux-magazine.com/Issues/2017/203/Home-Assistant"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img
|
||||
><div class="material-card"><img
|
||||
alt="Linux Magazine logo"
|
||||
src="/images/press/LinuxMagazine.png"
|
||||
/></a>
|
||||
/></div></a>
|
||||
|
||||
<a
|
||||
href="https://www.heise.de/select/ct/2017/26/1513910625909214"
|
||||
target="_blank"
|
||||
rel="noopener"
|
||||
><img alt="Ct logo" src="/images/press/ct.png"
|
||||
><div class="material-card"><img alt="Ct logo" src="/images/press/ct.png"
|
||||
/></div></a>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
|
||||
<!-- Sponsor section -->
|
||||
|
||||
<section class="sponsor">
|
||||
<div class="sponsored-by grid__item one-whole">
|
||||
<h2>The Home Assistant project is sponsored by</h2>
|
||||
<div class="material-card text">
|
||||
<a href="https://www.nabucasa.com"
|
||||
><img alt="Nabu Casa logo" src="/images/sponsors/nabu_casa.svg"
|
||||
/></a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@ -30,8 +30,8 @@ This tutorial will guide you to turn an ESP32-S3-BOX, ESP32-S3-BOX-3, or an ESP3
|
||||
- The password to your 2.4 GHz Wi-Fi network
|
||||
- Chrome or Edge browser on a desktop (not Android/iOS)
|
||||
- One of the three Espressif ESP32-S3-BOX variants:
|
||||
- [ESP32-S3-BOX-3](https://www.aliexpress.us/item/1005005920207976.html?gatewayAdapt=4itemAdapt)
|
||||
- ESP32-S3-BOX or ESP32-S3-BOX-Lite (not currently on the market)
|
||||
- ESP32-S3-BOX-3B
|
||||
- ESP32-S3-BOX-3, ESP32-S3-BOX, or ESP32-S3-BOX-Lite (not currently on the market)
|
||||
- USB-C cable to connect the ESP32-S3-BOX
|
||||
|
||||
## Installing the software onto the ESP32-S3-BOX
|
||||
@ -77,12 +77,12 @@ Before you can use this device with Home Assistant, you need to install a bit of
|
||||
|
||||
- Your ESP32-S3-BOX is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply.
|
||||
|
||||
- title: Using the ESP32-S3-BOX-3
|
||||
- title: Using the ESP32-S3-BOX-3(B)
|
||||
content: |
|
||||
|
||||
1. Make sure this page is opened in a Chromium-based browser on a **desktop**. The software installation does not work with a tablet or phone.
|
||||
1. These steps apply both to the ESP32-S3-BOX-3 and the ESP32-S3-BOX-3B. Make sure this page is opened in a Chromium-based browser on a **desktop**. The software installation does not work with a tablet or phone.
|
||||
|
||||
- Select the **Connect** button below to display a list of available USB devices. Do not connect the ESP32-S3-BOX-3 yet. We want to see the list of available USB devices first, so that it is easier to recognize the ESP device afterwards.
|
||||
- Select the **Connect** button below to display a list of available USB devices. Do not connect the ESP32-S3-BOX-3 yet. We want to see the list of available USB devices first, so that it is easier to recognize the ESP device afterward.
|
||||
- If your browser does not support web serial, you will see a warning message indicating this instead of a button.
|
||||
|
||||
<script type="module" src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"></script>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user