home-assistant.io/source/_components/directv.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class	redirect_from
page	DirecTV	Instructions on how to integrate DirecTV receivers into Home Assistant.	2016-07-19 01:0+0000	true	false	true	true	directv.png	Media Player	0.25	Local Polling	/components/media_player.directv/

Master DirecTV receivers (ie: those that have tuners) will be automatically discovered if you enable the discovery component and the receiver is powered-on. Slave/RVU client/Genie boxes will also be discovered, but only if they are also online at the time of discovery.

To ensure that your DirecTV boxes are always found and configured, they should be added into your configuration.yaml.

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

{% configuration %} host: description: The IP address or the hostname of the device. Use only if you don't want to scan for devices. required: false type: string port: description: The port your receiver is using. required: false default: 8080 type: integer name: description: Use to give a specific name to the device. required: false default: DirecTV Receiver type: string device: description: Use to specify a particular receiver in a Genie setup. required: false type: string {% endconfiguration %}

To find valid device IDs, open http://<IP Address of Genie Server>:8080/info/getLocations in a web browser. For each Genie slave, you will find a variable clientAddr in the response, and this should be used for device in configuration.yaml

For example, a response such as:

{
  "locations": [
    {
      "clientAddr": "0",
      "locationName": "MASTER GENIE SERVER",
      "tunerBond": true
    },
    {
      "clientAddr": "5009591D6969",
      "locationName": "SOME SLAVE GENIE"
    }
  ],
  "status": {
    "code": 200,
    "commandResult": 0,
    "msg": "OK.",
    "query": "/info/getLocations"
  }
}

Could be formatted into configuration.yaml like so:

media_player:
  - platform: directv
    host: 192.168.1.10
    port: 8080
    name: Main DirecTV Box
    device: 0
  - platform: directv
    host: 192.168.1.10
    port: 8080
    name: Bedroom DirecTV
    device: 5009591D6969

It is important to notice that the host and port variables for slave/Genie receivers are the same as the master receiver.

{% linkable_title Services %}

{% linkable_title Media control services %}

Available services: turn_on, turn_off, media_play, media_pause, media_stop, media_next_track, media_previous_track, play_media

{% linkable_title Service media_player.play_media %}

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. Defaults to all.
media_content_id	no	The channel number to change to.
media_content_type	no	A media type. Has to be channel.