mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 17:27:19 +00:00
Put in recomendations for some clarifications.
This commit is contained in:
parent
5f84b4ad66
commit
fe5562286d
@ -89,9 +89,15 @@ Entities are things that you want to observe within Home Assistant. Support for
|
|||||||
</tr>
|
</tr>
|
||||||
|
|
||||||
<tr>
|
<tr>
|
||||||
<td><a href='/components/isy994.html'><img src='/images/supported_brands/universal_devices.png' class='brand overview' /></a></td>
|
<td><a href='/components/isy994.html'><img src='/images/supported_brands/insteon.png' class='brand overview' /></a></td>
|
||||||
<td><a href='/components/isy994.html'>Insteon and X10 Devices</a></td>
|
<td><a href='/components/isy994.html'>Insteon Devices</a></td>
|
||||||
<td>ISY994 controller for Insteon and X10 devices as well as create custom switches and sensors.</td>
|
<td>Insteon devices can be controlled with the ISY994 controller.</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><a href='/components/isy994.html'><img src='/images/supported_brands/x10.gif' class='brand overview' /></a></td>
|
||||||
|
<td><a href='/components/isy994.html'>X10 Devices</a></td>
|
||||||
|
<td>X10 devices can be controlled with the ISY994 controller.</td>
|
||||||
</tr>
|
</tr>
|
||||||
|
|
||||||
</table>
|
</table>
|
||||||
@ -115,6 +121,7 @@ Home Assistant integrates with a variety of third party Home Automation hubs and
|
|||||||
[<img src='/images/supported_brands/telldus_tellstick.png' class='brand' />](/components/tellstick.html)
|
[<img src='/images/supported_brands/telldus_tellstick.png' class='brand' />](/components/tellstick.html)
|
||||||
[<img src='/images/supported_brands/vera.png' class='brand' />](/components/vera.html)
|
[<img src='/images/supported_brands/vera.png' class='brand' />](/components/vera.html)
|
||||||
[<img src='/images/supported_brands/wink.png' class='brand' />](/components/wink.html)
|
[<img src='/images/supported_brands/wink.png' class='brand' />](/components/wink.html)
|
||||||
|
[<img src='/images/supported_brands/universal_devices.png' class='brand' />](/components/isy994.html)
|
||||||
|
|
||||||
<p class='note'>
|
<p class='note'>
|
||||||
Support for these devices is provided by the Home Assistant community and not
|
Support for these devices is provided by the Home Assistant community and not
|
||||||
@ -173,6 +180,11 @@ the manufacturers of these devices.
|
|||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
|
||||||
|
<p class='note'>
|
||||||
|
Support for these services is provided by the Home Assistant community and not
|
||||||
|
the service providers.
|
||||||
|
</p>
|
||||||
|
|
||||||
## {% linkable_title Automation %}
|
## {% linkable_title Automation %}
|
||||||
|
|
||||||
| Type | Description
|
| Type | Description
|
||||||
|
@ -43,9 +43,9 @@ The ISY_USERNAME and ISY_PASSWORD are the configured username and password used
|
|||||||
to access the ISY interface.
|
to access the ISY interface.
|
||||||
|
|
||||||
The SENSOR_STRING is a string that is used to identify which devices are to be
|
The SENSOR_STRING is a string that is used to identify which devices are to be
|
||||||
treated as sensors instead of lights of switches. By default, this string is
|
assumed to be sensors instead of lights of switches. By default, this string is
|
||||||
'Sensor'. If this string is found in the device name, Home Assistant will
|
'Sensor'. If this string is found in the device name, Home Assistant will
|
||||||
assume treat is as a sensor.
|
assume it is as a sensor.
|
||||||
|
|
||||||
The HIDDEN_STRING is a string that is used to identify which devices are to be
|
The HIDDEN_STRING is a string that is used to identify which devices are to be
|
||||||
hidden on Home Assistant's front page. This string will be stripped from the
|
hidden on Home Assistant's front page. This string will be stripped from the
|
||||||
|
@ -65,14 +65,13 @@ This option is currently limited to built-in components.
|
|||||||
### {% linkable_title Creating Entities %}
|
### {% linkable_title Creating Entities %}
|
||||||
|
|
||||||
Home Assistant will call a function with the following signature to initialize
|
Home Assistant will call a function with the following signature to initialize
|
||||||
your new component. This function must exist in the component module you
|
your new platform. This function must exist in the platform module you create.
|
||||||
create.
|
|
||||||
|
|
||||||
```python
|
```python
|
||||||
def setup_platform(hass, config, add_devices, discovery_info=None)
|
def setup_platform(hass, config, add_devices, discovery_info=None)
|
||||||
```
|
```
|
||||||
|
|
||||||
In this function, your component should create the appropriate entities and
|
In this function, your platform should create the appropriate entities and
|
||||||
register them with the Home Assistant core. Entities are Home Assistant's
|
register them with the Home Assistant core. Entities are Home Assistant's
|
||||||
representation of lights, switches, sensors, etc. It is best practice for all
|
representation of lights, switches, sensors, etc. It is best practice for all
|
||||||
new entities to inherit the
|
new entities to inherit the
|
||||||
|
@ -67,29 +67,31 @@ Not all devices can be discovered, so if you have any of the following devices o
|
|||||||
|
|
||||||
See the [components overview page](/components/) for a complete list of supported devices.
|
See the [components overview page](/components/) for a complete list of supported devices.
|
||||||
|
|
||||||
### {% linkable_title Hiding devices and services %}
|
### {% linkable_title Customizing devices and services %}
|
||||||
|
|
||||||
By default, most of your devices will be visible on the Home Assistant Sates
|
By default, most of your devices will be visible on the Home Assistant States
|
||||||
page. You may find it desireable to hide some of these devices from the default
|
page and have a default icon determined by their domain. You may find it
|
||||||
view. Some components may also hide some entities by default. You also have the
|
desireable to customize the look and feel of your front page by altering some
|
||||||
ability to show these previously hidden entities.
|
of these parameters.
|
||||||
|
|
||||||
Most enties on the homepage may be hidden or shown in the configuration file by
|
By adding the following parameters to the *homeassistant* section of your
|
||||||
adding the following lines to the homeassistant section:
|
*configuration.yaml* file, you can customize the attributes of any state on
|
||||||
|
your front page.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
homeassistant:
|
homeassistant:
|
||||||
|
|
||||||
# Add this to your existing configuration
|
# Add this to your existing configuration
|
||||||
|
|
||||||
visibility:
|
customize:
|
||||||
entity_id: hide
|
SOME_ENTITY_ID:
|
||||||
entity_id: show
|
hidden: true
|
||||||
|
entity_picture: http://URL.TO/PICTURE
|
||||||
|
friendly_name: SOME CUSTOM NAME
|
||||||
```
|
```
|
||||||
|
|
||||||
Replace entity_id with the ID for the entity that you would like to either show
|
Entity IDs can be retrieved from the web interface by using the Set State page
|
||||||
or hide. Entity IDs can be retrieved from the web interface by using the Set
|
in the Developer Tools.
|
||||||
State page in the Developer Tools.
|
|
||||||
|
|
||||||
### {% linkable_title Setting up Home Automation %}
|
### {% linkable_title Setting up Home Automation %}
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user