media_player.py

Go to the documentation of this file.

"""Support for Denon Network Receivers."""
 
from __future__ import annotations
 
import logging
import telnetlib  # pylint: disable=deprecated-module
 
import voluptuous as vol
 
from homeassistant.components.media_player import (
    PLATFORM_SCHEMA as MEDIA_PLAYER_PLATFORM_SCHEMA,
    MediaPlayerEntity,
    MediaPlayerEntityFeature,
    MediaPlayerState,
)
from homeassistant.const import CONF_HOST, CONF_NAME
from homeassistant.core import HomeAssistant
import homeassistant.helpers.config_validation as cv
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
_LOGGER = logging.getLogger(__name__)
 
DEFAULT_NAME = "Music station"
 
SUPPORT_DENON = (
    MediaPlayerEntityFeature.VOLUME_SET
    | MediaPlayerEntityFeature.VOLUME_MUTE
    | MediaPlayerEntityFeature.TURN_ON
    | MediaPlayerEntityFeature.TURN_OFF
    | MediaPlayerEntityFeature.SELECT_SOURCE
)
SUPPORT_MEDIA_MODES = (
    MediaPlayerEntityFeature.PAUSE
    | MediaPlayerEntityFeature.STOP
    | MediaPlayerEntityFeature.PREVIOUS_TRACK
    | MediaPlayerEntityFeature.NEXT_TRACK
    | MediaPlayerEntityFeature.PLAY
)
 
PLATFORM_SCHEMA = MEDIA_PLAYER_PLATFORM_SCHEMA.extend(
    {
        vol.Required(CONF_HOST): cv.string,
        vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string,
    }
)
 
NORMAL_INPUTS = {
    "Cd": "CD",
    "Dvd": "DVD",
    "Blue ray": "BD",
    "TV": "TV",
    "Satellite / Cable": "SAT/CBL",
    "Game": "GAME",
    "Game2": "GAME2",
    "Video Aux": "V.AUX",
    "Dock": "DOCK",
}
 
MEDIA_MODES = {
    "Tuner": "TUNER",
    "Media server": "SERVER",
    "Ipod dock": "IPOD",
    "Net/USB": "NET/USB",
    "Rapsody": "RHAPSODY",
    "Napster": "NAPSTER",
    "Pandora": "PANDORA",
    "LastFM": "LASTFM",
    "Flickr": "FLICKR",
    "Favorites": "FAVORITES",
    "Internet Radio": "IRADIO",
    "USB/IPOD": "USB/IPOD",
}
 
# Sub-modes of 'NET/USB'
# {'USB': 'USB', 'iPod Direct': 'IPD', 'Internet Radio': 'IRP',
#  'Favorites': 'FVP'}
 
 
def setup_platform(
    hass: HomeAssistant,
    config: ConfigType,
    add_entities: AddEntitiesCallback,
    discovery_info: DiscoveryInfoType | None = None,
) -> None:
    """Set up the Denon platform."""
    denon = DenonDevice(config[CONF_NAME], config[CONF_HOST])
 
    if denon.do_update():
        add_entities([denon])
 
 
class DenonDevice(MediaPlayerEntity):
    """Representation of a Denon device."""
 
    def __init__(self, name, host):
        """Initialize the Denon device."""
        self._name_name = name
        self._host_host = host
        self._pwstate_pwstate = "PWSTANDBY"
        self._volume_volume = 0
        # Initial value 60dB, changed if we get a MVMAX
        self._volume_max_volume_max = 60
        self._source_list_source_list = NORMAL_INPUTS.copy()
        self._source_list_source_list.update(MEDIA_MODES)
        self._muted_muted = False
        self._mediasource_mediasource = ""
        self._mediainfo_mediainfo = ""
 
        self._should_setup_sources_should_setup_sources = True
 
    def _setup_sources(self, telnet):
        # NSFRN - Network name
        nsfrn = self.telnet_requesttelnet_request(telnet, "NSFRN ?").removeprefix("NSFRN ")
        if nsfrn:
            self._name_name = nsfrn
 
        # SSFUN - Configured sources with (optional) names
        self._source_list_source_list = {}
        for line in self.telnet_requesttelnet_request(telnet, "SSFUN ?", all_lines=True):
            ssfun = line.removeprefix("SSFUN").split(" ", 1)
 
            source = ssfun[0]
            if len(ssfun) == 2 and ssfun[1]:
                configured_name = ssfun[1]
            else:
                # No name configured, reusing the source name
                configured_name = source
 
            self._source_list_source_list[configured_name] = source
 
        # SSSOD - Deleted sources
        for line in self.telnet_requesttelnet_request(telnet, "SSSOD ?", all_lines=True):
            source, status = line.removeprefix("SSSOD").split(" ", 1)
            if status == "DEL":
                for pretty_name, name in self._source_list_source_list.items():
                    if source == name:
                        del self._source_list_source_list[pretty_name]
                        break
 
    @classmethod
    def telnet_request(cls, telnet, command, all_lines=False):
        """Execute `command` and return the response."""
        _LOGGER.debug("Sending: %s", command)
        telnet.write(command.encode("ASCII") + b"\r")
        lines = []
        while True:
            line = telnet.read_until(b"\r", timeout=0.2)
            if not line:
                break
            lines.append(line.decode("ASCII").strip())
            _LOGGER.debug("Received: %s", line)
 
        if all_lines:
            return lines
        return lines[0] if lines else ""
 
    def telnet_command(self, command):
        """Establish a telnet connection and sends `command`."""
        telnet = telnetlib.Telnet(self._host_host)
        _LOGGER.debug("Sending: %s", command)
        telnet.write(command.encode("ASCII") + b"\r")
        telnet.read_very_eager()  # skip response
        telnet.close()
 
    def update(self) -> None:
        """Get the latest details from the device."""
        self.do_updatedo_update()
 
    def do_update(self) -> bool:
        """Get the latest details from the device, as boolean."""
        try:
            telnet = telnetlib.Telnet(self._host_host)
        except OSError:
            return False
 
        if self._should_setup_sources_should_setup_sources:
            self._setup_sources_setup_sources(telnet)
            self._should_setup_sources_should_setup_sources = False
 
        self._pwstate_pwstate = self.telnet_requesttelnet_request(telnet, "PW?")
        for line in self.telnet_requesttelnet_request(telnet, "MV?", all_lines=True):
            if line.startswith("MVMAX "):
                # only grab two digit max, don't care about any half digit
                self._volume_max_volume_max = int(line[len("MVMAX ") : len("MVMAX XX")])
                continue
            if line.startswith("MV"):
                self._volume_volume = int(line.removeprefix("MV"))
        self._muted_muted = self.telnet_requesttelnet_request(telnet, "MU?") == "MUON"
        self._mediasource_mediasource = self.telnet_requesttelnet_request(telnet, "SI?").removeprefix("SI")
 
        if self._mediasource_mediasource in MEDIA_MODES.values():
            self._mediainfo_mediainfo = ""
            answer_codes = [
                "NSE0",
                "NSE1X",
                "NSE2X",
                "NSE3X",
                "NSE4",
                "NSE5",
                "NSE6",
                "NSE7",
                "NSE8",
            ]
            for line in self.telnet_requesttelnet_request(telnet, "NSE", all_lines=True):
                self._mediainfo_mediainfo += f"{line.removeprefix(answer_codes.pop(0))}\n"
        else:
            self._mediainfo_mediainfo = self.sourcesourcesource
 
        telnet.close()
        return True
 
    @property
    def name(self):
        """Return the name of the device."""
        return self._name_name
 
    @property
    def state(self) -> MediaPlayerState | None:
        """Return the state of the device."""
        if self._pwstate_pwstate == "PWSTANDBY":
            return MediaPlayerState.OFF
        if self._pwstate_pwstate == "PWON":
            return MediaPlayerState.ON
 
        return None
 
    @property
    def volume_level(self):
        """Volume level of the media player (0..1)."""
        return self._volume_volume / self._volume_max_volume_max
 
    @property
    def is_volume_muted(self):
        """Return boolean if volume is currently muted."""
        return self._muted_muted
 
    @property
    def source_list(self):
        """Return the list of available input sources."""
        return sorted(self._source_list_source_list)
 
    @property
    def media_title(self):
        """Return the current media info."""
        return self._mediainfo_mediainfo
 
    @property
    def supported_features(self) -> MediaPlayerEntityFeature:
        """Flag media player features that are supported."""
        if self._mediasource_mediasource in MEDIA_MODES.values():
            return SUPPORT_DENON | SUPPORT_MEDIA_MODES
        return SUPPORT_DENON
 
    @property
    def source(self) -> str | None:
        """Return the current input source."""
        for pretty_name, name in self._source_list_source_list.items():
            if self._mediasource_mediasource == name:
                return pretty_name
        return None
 
    def turn_off(self) -> None:
        """Turn off media player."""
        self.telnet_commandtelnet_command("PWSTANDBY")
 
    def volume_up(self) -> None:
        """Volume up media player."""
        self.telnet_commandtelnet_command("MVUP")
 
    def volume_down(self) -> None:
        """Volume down media player."""
        self.telnet_commandtelnet_command("MVDOWN")
 
    def set_volume_level(self, volume: float) -> None:
        """Set volume level, range 0..1."""
        self.telnet_commandtelnet_command(f"MV{round(volume * self._volume_max):02}")
 
    def mute_volume(self, mute: bool) -> None:
        """Mute (true) or unmute (false) media player."""
        mute_status = "ON" if mute else "OFF"
        self.telnet_commandtelnet_command(f"MU{mute_status})")
 
    def media_play(self) -> None:
        """Play media player."""
        self.telnet_commandtelnet_command("NS9A")
 
    def media_pause(self) -> None:
        """Pause media player."""
        self.telnet_commandtelnet_command("NS9B")
 
    def media_stop(self) -> None:
        """Pause media player."""
        self.telnet_commandtelnet_command("NS9C")
 
    def media_next_track(self) -> None:
        """Send the next track command."""
        self.telnet_commandtelnet_command("NS9D")
 
    def media_previous_track(self) -> None:
        """Send the previous track command."""
        self.telnet_commandtelnet_command("NS9E")
 
    def turn_on(self) -> None:
        """Turn the media player on."""
        self.telnet_commandtelnet_command("PWON")
 
    def select_source(self, source: str) -> None:
        """Select input source."""
        self.telnet_commandtelnet_command(f"SI{self._source_list.get(source)}")