From 845ce95d0977e3534ba52b84623e783a3d920114 Mon Sep 17 00:00:00 2001 From: Robert Svensson Date: Tue, 18 Jun 2019 20:55:45 +0200 Subject: [PATCH] Update discovery and zeroconf documentation (#9506) --- source/_components/discovery.markdown | 14 ++++---------- source/_components/zeroconf.markdown | 14 +++++++++++++- 2 files changed, 17 insertions(+), 11 deletions(-) diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index 90810424ea1..040dd844878 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -17,7 +17,6 @@ ha_release: 0.7 Home Assistant can discover and automatically configure [zeroconf](https://en.wikipedia.org/wiki/Zero-configuration_networking)/[mDNS](https://en.wikipedia.org/wiki/Multicast_DNS) and [uPnP](https://en.wikipedia.org/wiki/Universal_Plug_and_Play) devices on your network. Currently the `discovery` component can detect: * [Apple TV](/components/apple_tv/) - * [Axis Communications security devices](/components/axis/) * [Belkin WeMo switches](/components/wemo/) * [Bluesound speakers](/components/media_player.bluesound/) * [Bose Soundtouch speakers](/components/media_player.soundtouch/) @@ -27,8 +26,6 @@ Home Assistant can discover and automatically configure [zeroconf](https://en.wi * [Enigma2 media player](/components/media_player.enigma2/) * [Frontier Silicon internet radios](/components/media_player.frontier_silicon/) * [Google Cast](/components/media_player.cast/) - * [HomeKit](/components/homekit_controller/) - * [IKEA Trådfri (Tradfri)](/components/tradfri/) * [Linn / Openhome](/components/media_player.openhome/) * [Logitech Harmony Hub](/components/remote.harmony/) * [Logitech media server (Squeezebox)](/components/media_player.squeezebox/) @@ -50,6 +47,10 @@ Home Assistant can discover and automatically configure [zeroconf](https://en.wi It will be able to add Google Chromecasts and Belkin WeMo switches automatically, for Philips Hue it will require some configuration from the user. +

+ Zeroconf discoverable integrations [Axis](/components/axis/)/[ESPHome](/components/esphome/)/[HomeKit](/components/homekit_controller/)/[Tradfri](/components/tradfri/) have been migrated to use [zeroconf](/components/zeroconf) integration to initiate discovery. +

+ To load this component, add the following lines to your `configuration.yaml`: ```yaml @@ -76,7 +77,6 @@ enable: Valid values for ignore are: * `apple_tv`: Apple TV - * `axis`: Axis Communications security devices * `belkin_wemo`: Belkin WeMo switches * `bluesound`: Bluesound speakers * `bose_soundtouch`: Bose Soundtouch speakers @@ -87,7 +87,6 @@ Valid values for ignore are: * `google_cast`: Google Cast * `harmony`: Logitech Harmony Hub * `igd`: Internet Gateway Device - * `ikea_tradfri`: IKEA Trådfri (Tradfri) * `logitech_mediaserver`: Logitech media server (Squeezebox) * `netgear_router`: Netgear routers * `octoprint`: Octoprint @@ -110,7 +109,6 @@ Valid values for ignore are: Valid values for enable are: * `dlna_dmr`: DLNA DMR enabled devices - * `homekit`: HomeKit accessories ## {% linkable_title Troubleshooting %} @@ -135,7 +133,3 @@ If you see `Not initializing discovery because could not install dependency netd ### {% 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). - -## {% 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. diff --git a/source/_components/zeroconf.markdown b/source/_components/zeroconf.markdown index b44c5f60f7d..7d5783c893a 100644 --- a/source/_components/zeroconf.markdown +++ b/source/_components/zeroconf.markdown @@ -10,10 +10,11 @@ footer: true logo: avahi.png ha_category: - Network +ha_qa_scale: internal ha_release: 0.18 --- -The `zeroconf` component exposes your Home Assistant to the local network using [Zeroconf](https://en.wikipedia.org/wiki/Zero-configuration_networking). Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi. +The `zeroconf` integration exposes your Home Assistant to the local network using [Zeroconf](https://en.wikipedia.org/wiki/Zero-configuration_networking). It can also discover and automatically configure devices on your network. Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi. ## {% linkable_title Configuration %} @@ -24,6 +25,17 @@ To integrate this into Home Assistant, add the following section to your `config zeroconf: ``` +### {% linkable_title Discoverable services %} + +Currently the `zeroconf` integration can detect: + + * [Axis Communications security devices](/components/axis/) + * [ESPHome](/components/esphome/) + * [HomeKit](/components/homekit_controller/) + * [IKEA Trådfri (Tradfri)](/components/tradfri/) + +### {% linkable_title Discovering Home Assistant %} + The registration will include meta-data about the Home Assistant instance, including a base URL that can be used to access Home Assistant, the currently running Home Assistant version, and whether an API password is needed to access the instance. The examples below show two ways to retrieve the details for testing. ```bash