Skip to content

Commit

Permalink
Update media_player.yamaha documentation (home-assistant#1229)
Browse files Browse the repository at this point in the history
* Update media_player.yamaha documentation

The documentation wasn't up to date:
 - `source_ignore` and `source_names` were not documented
 - source selection has been around for a while.

* Rework media_player.yamaha documentation

Remove optional attributes from the main sample, add a second, more complete sample.
  • Loading branch information
Kernald authored and fabaff committed Oct 13, 2016
1 parent 57cfb4a commit 88a0c90
Showing 1 changed file with 16 additions and 1 deletion.
17 changes: 16 additions & 1 deletion source/_components/media_player.yamaha.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,26 @@ Configuration variables:
- **name** (*Optional*): Name of the device
- **host** (*Optional*): IP address or hostname of the device
- **source_ignore** (*Optional*): List of sources to hide in the front-end
- **source_names** (*Optional*): Mapping of internal AVR source names to custom ones, allowing to rename e.g. `HDMI1` to `ChromeCast`

A few notes:

- Not specifying the host variable will result in automatically searching your network for Yamaha Receivers. It will add a media player device for each one.
- In some cases, autodiscovery fails due to a known bug in the receiver's firmware. It is possible to manually specify the reveiver's IP address or via it's hostname (if it is discoverably by your DNS) then.
- Please note: If adding the IP address or hostname manually, you **must** enable network standby on your receiver, or else startup of Home Assistant will hang if you have your receiver switched off.
- Currently the only controls that are available is Power On/Off, Mute, and Volume control. Other functions such as source select are in progress of being developed.
- Currently, this component supports powering on/off, mute, volume control and source selection.

A full configuration example will look like the sample below:
```yaml
# Example configuration.yaml entry
media_player:
- platform: yamaha
host: 192.168.0.10
source_ignore:
- "AUX"
- "HDMI6"
source_names:
- HDMI1: "ChromeCast"
- AV4: "Vinyl"
```

0 comments on commit 88a0c90

Please sign in to comment.