From 1d7c8dce6325dba02418389c64e85e9c61eb3131 Mon Sep 17 00:00:00 2001 From: Marco Date: Fri, 5 Jan 2018 17:33:35 +0100 Subject: [PATCH] readability and notes (#4335) * Update media_player.yamaha_musiccast.markdown https://community.home-assistant.io/t/support-for-new-yamaha-receivers-and-musiccast-devices/17001/22 * moved section 'authentication' guide should be right below the 'scanning' guide. it's one workflow * easier searchable variable 'login_id' * added a hint to enable home sharing * fixed wrong syntax in config example * added note for use over https see https://github.com/home-assistant/home-assistant/issues/1258 --- source/_components/apple_tv.markdown | 43 ++++++++++--------- .../_components/device_tracker.luci.markdown | 4 ++ .../media_player.yamaha_musiccast.markdown | 4 +- source/_docs/configuration/devices.markdown | 8 ++-- 4 files changed, 33 insertions(+), 26 deletions(-) diff --git a/source/_components/apple_tv.markdown b/source/_components/apple_tv.markdown index 5709958530d..bba7b7ac785 100644 --- a/source/_components/apple_tv.markdown +++ b/source/_components/apple_tv.markdown @@ -56,7 +56,9 @@ In order to connect to the device, you need a *login id*. The easiest way to obt ### {% linkable_title Scanning for devices %} -To scan for devices, press the icon in the upper left corner and select the leftmost icon according to the image: +Make sure Home Sharing is enabled on the Apple TV. + +To scan for devices and determine the `login_id`, press the icon in the upper left corner and select the leftmost icon according to the image: @@ -78,26 +80,7 @@ Found Apple TVs: Note: You must use 'pair' with devices that have home sharing disabled ``` -Just copy and paste the login id from the device you want to add. For more details about `atvremote`, see: [this page](http://pyatv.readthedocs.io/en/master/atvremote.html). - -### {% linkable_title My Apple TV turns on when I restart Home Assistant %} - -The Apple TV will automatically turn on if a request is sent to it, e.g., if a button is pressed, something is streamed to it via AirPlay or if current state (currently playing) is accessed. This is how Apple has designed it, and it will cause problems if you are using HDMI CEC. Every time Home Assistant is started, a new request is sent to the device to figure out what is currently playing. When using CEC, this will wake up your TV and other devices you have configured. - -So, if your TV is randomly turning on, this is probably the reason. As stated, this is by design, and there is no real fix for it. There's also no known way to turn off the Apple TV via the protocol used for communication. You have the following options: - -- Do not use this platform -- Disable HDMI CEC on your Apple TV -- Use "fake standby" - -The first two points are quite obvious. Fake standby is a concept implemented in this platform that disables all requests to the device and makes it appear as being "off" in the web interface. This will make sure that the device is not woken up, but it will of course not show any information or allow you to control it. It is however easy to turn it on (or off) in the web interface or to use an automation with `turn_on`. To make it more useful, you can write automations that turn it on or off depending on some other device, like the input source on your receiver. - -To put a device into fake standby when starting Home Assistant, add `start_off: true` to your configuration. - -

-Turning the device on/off in the user interface will *not* turn the physical device on/off according to the description above. -

- +Just copy and paste the `login_id` from the device you want to add. For more details about `atvremote`, see: [this page](http://pyatv.readthedocs.io/en/master/atvremote.html). ### {% linkable_title Setting up device authentication %} @@ -129,6 +112,24 @@ apple_tv: Restart Home Assistant, and you should now be able to use `play_url` as before. +### {% linkable_title My Apple TV turns on when I restart Home Assistant %} + +The Apple TV will automatically turn on if a request is sent to it, e.g., if a button is pressed, something is streamed to it via AirPlay or if current state (currently playing) is accessed. This is how Apple has designed it, and it will cause problems if you are using HDMI CEC. Every time Home Assistant is started, a new request is sent to the device to figure out what is currently playing. When using CEC, this will wake up your TV and other devices you have configured. + +So, if your TV is randomly turning on, this is probably the reason. As stated, this is by design, and there is no real fix for it. There's also no known way to turn off the Apple TV via the protocol used for communication. You have the following options: + +- Do not use this platform +- Disable HDMI CEC on your Apple TV +- Use "fake standby" + +The first two points are quite obvious. Fake standby is a concept implemented in this platform that disables all requests to the device and makes it appear as being "off" in the web interface. This will make sure that the device is not woken up, but it will of course not show any information or allow you to control it. It is however easy to turn it on (or off) in the web interface or to use an automation with `turn_on`. To make it more useful, you can write automations that turn it on or off depending on some other device, like the input source on your receiver. + +To put a device into fake standby when starting Home Assistant, add `start_off: true` to your configuration. + +

+Turning the device on/off in the user interface will *not* turn the physical device on/off according to the description above. +

+ ## {% linkable_title Services %} ### {% linkable_title Service `apple_tv_authenticate` %} diff --git a/source/_components/device_tracker.luci.markdown b/source/_components/device_tracker.luci.markdown index 937193752e5..32d0cde87b8 100644 --- a/source/_components/device_tracker.luci.markdown +++ b/source/_components/device_tracker.luci.markdown @@ -16,6 +16,10 @@ _This is one of the two ways we support OpenWRT. If you encounter problems, try This is a presence detection scanner for OpenWRT using [luci](http://wiki.openwrt.org/doc/techref/luci). +

+This component requires a [workaround](https://github.com/home-assistant/home-assistant/issues/1258#issuecomment-252469880) when using luci with HTTPS and a self-signed certificate. +

+ Before this scanner can be used you have to install the luci RPC package on OpenWRT: ```bash diff --git a/source/_components/media_player.yamaha_musiccast.markdown b/source/_components/media_player.yamaha_musiccast.markdown index 121687b9827..7d98e77102f 100644 --- a/source/_components/media_player.yamaha_musiccast.markdown +++ b/source/_components/media_player.yamaha_musiccast.markdown @@ -16,7 +16,7 @@ The `yamaha_musiccast` platform allows you to control [Yamaha MusicCast Receiver Supported devices are listed on their [German site](https://de.yamaha.com/de/products/contents/audio_visual/musiccast/products.html). -To add a Yamaha Network Receiver to your installation, add the following to your `configuration.yaml` file: +To add a Yamaha MusicCast Receiver to your installation, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -27,7 +27,7 @@ media_player: Configuration variables: - **host** (*Required*): IP address or hostname of the device -- **port** (*Optional*): UDP Port +- **port** (*Optional*): UDP source port. If multiple devices are present, specify a different port per device - **interval_seconds** (*Optional*): Polling interval (default: 480 seconds = 8 minutes) A few notes: diff --git a/source/_docs/configuration/devices.markdown b/source/_docs/configuration/devices.markdown index 7b8b1a1f78e..6fbee6a4330 100644 --- a/source/_docs/configuration/devices.markdown +++ b/source/_docs/configuration/devices.markdown @@ -60,10 +60,12 @@ Each group consists of a name and a list of entity IDs. Entity IDs can be retrie ```yaml # Example configuration.yaml entry showing two styles group: - living_room: light.table_lamp, switch.ac + living_room: + entities: light.table_lamp, switch.ac bedroom: - - light.bedroom - - media_player.nexus_player + entities: + - light.bedroom + - media_player.nexus_player ``` For more details please check the [Group](/components/group/) page.