Yamaha Network Receivers

    The Yamaha Network Receivers integration allows you to control Yamaha Network Receivers from Home Assistant.

    Supported devices:

    To add a Yamaha Network Receiver to your installation, add the following to your "configuration.yaml" file. :::tip 更改配置后需要重启 Home Assistant。 :::

    # Example configuration.yaml entry
media_player:
  - platform: yamaha

    You must enable network standby on your receiver, or else startup of Home Assistant will hang if you have your receiver switched off.

    name:
  description: Name of the device. This overrides the default name (often model number) that is returned by the device.
  required: false
  type: string
host:
  description: IP address or hostname of the device.
  required: false
  type: string
source_ignore:
  description: List of sources to hide in the front-end.
  required: false
  type: list
source_names:
  description: Mapping of internal AVR source names to custom ones, allowing one to rename e.g., `HDMI1` to `ChromeCast`.
  required: false
  type: list
zone_ignore:
  description: List of zones to hide in the front-end.
  required: false
  type: list
zone_names:
  description: Mapping of zone names to custom ones, allowing one to rename e.g., `Main_Zone` to `Family Room`.
  required: false
  type: list

    Supported operations

    • Media players created by Yamaha support powering on/off, mute, volume control and source selection. Playback controls, for instance play and stop are available for sources that supports it.
    • The play_media action is implemented for NET RADIO source only. The media_id is a > separated string of the menu path on the vtuner service. For instance Bookmarks>Internet>WAMC 90.3 FM. MusicCast devices use the path Radio>Favorites>WAMC 90.3 FM.

    Example configuration

    A full configuration example will look like the sample below:

    # Example configuration.yaml entry
media_player:
  - platform: yamaha
    host: 192.168.0.10
    source_ignore:
      - "AUX"
      - "HDMI6"
    source_names:
      HDMI1: "ChromeCast"
      AV4: "Vinyl"
    zone_ignore:
      - "Zone_2"
    zone_names:
      Main_Zone: "Family Room"

    Example play_media script

    The play_media function can be used in scripts easily to build media player presets. When done in scripts, the sequence will also allow you to set volume per source.

    # Example play_media script
#
# This is for an environment where Zone 2 of the receiver named
# `Living Room Stereo` drives outdoor speakers on the porch.
script:
 rp_porch:
    alias: "Radio Paradise Porch"
    sequence:
      - action: media_player.turn_on
        target:
          entity_id: media_player.living_room_stereo_zone_2
      - action: media_player.volume_set
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          volume_level: 0.48
      - action: media_player.play_media
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          media_content_type: "NET RADIO"
          media_content_id: "Bookmarks>Internet>Radio Paradise"

    Action: Enable output

    The enable_output action enables or disables an output port (HDMI) on the receiver.

    Data attributeOptionalDescription
    entity_idyesString or list of strings that point at entity_ids of Yamaha receivers.
    portnoPort to enable or disable, e.g., hdmi1.
    enablednoTo enable set true, otherwise set to false.

    Action: Menu cursor

    The menu_cursor action controls the menu cursor.

    Data attributeOptionalDescription
    entity_idyesString or list of strings that point at entity_ids of Yamaha receivers.
    cursornoName of the cursor key to press: up, down, left, right, select, return

    Action: Select scene

    The select_scene action selects a scene on the receiver.

    Data attributeOptionalDescription
    entity_idyesString or list of strings that point at entity_ids of Yamaha receivers.
    scenenoScene to select, e.g., BD/DVD Movie Viewing, TV Viewing, NET Audio Listening or Radio Listening.