Skip to content

Updating formatting and layout #5785

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fabaff merged 2 commits into from
Jul 13, 2018
Merged

Updating formatting and layout #5785

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c31c880
Updating formatting and layout
DubhAd Jul 13, 2018
e13741e
Canna type
DubhAd Jul 13, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 27 additions & 13 deletions source/_components/discovery.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,18 @@ discovery:
- homekit
```

Configuration variables:

- **ignore** (*Optional*): A list of platforms that never will be automatically configured by `discovery`.
{% linkable_title Configuration variables: %}

{% configuration discovery %}
ignore:
description: A list of platforms that never will be automatically configured by `discovery`.
required: false
type: string
enable:
description: A list of platforms not enabled by default that `discovery` should discover.
required: false
type: string
{% endconfiguration %}

Valid values for ignore are:

Expand Down Expand Up @@ -92,29 +101,34 @@ Valid values for ignore are:
* `yeelight`: Yeelight Sunflower bulb
* `xiaomi_gw`: Xiaomi Aqara gateway

- **enable** (*Optional*): A list of platforms not enabled by default that `discovery` should discover.

Valid values for enable are:

* `homekit`: HomeKit accessories

<p class='note'>
## {% linkable_title Troubleshooting %}

### {% linkable_title UPnP %}

Home Assistant must be on the same network as the devices for uPnP discovery to work.
If running Home Assistant in a [Docker container](/docs/installation/docker/) use switch `--net=host` to put it on the host's network.
</p>

<p class='note warning'>
### {% linkable_title Windows %}

#### {% linkable_title 64-bit Python %}
There is currently a <a href='https://bitbucket.org/al45tair/netifaces/issues/17/dll-fails-to-load-windows-81-64bit'>known issue</a> with running this component on a 64-bit version of Python and Windows.
</p>

<p class='note'>
#### {% linkable_title Python 3.5 %}

If you are on Windows and you're using Python 3.5, download the [Netifaces](http://www.lfd.uci.edu/~gohlke/pythonlibs/#netifaces) dependency.
</p>

<p class='note'>
### {% linkable_title could not install dependency netdisco %}

If you see `Not initializing discovery because could not install dependency netdisco==0.6.1` in the logs, you will need to install the `python3-dev` or `python3-devel` package on your system manually (eg. `sudo apt-get install python3-dev` or `sudo dnf -y install python3-devel`). On the next restart of Home Assistant, the discovery should work. If you still get an error, check if you have a compiler (`gcc`) available on your system.

### {% linkable_title DSM and Synology %}

For DSM/Synology, install via debian-chroot [see this forum post](https://community.home-assistant.io/t/error-starting-home-assistant-on-synology-for-first-time/917/15).
</p>

## {% linkable_title New platforms %}

If you are developing a new platform, please read [how to make your platform discoverable](/developers/component_discovery/) for further details.