mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-31 15:26:49 +00:00
127 lines
3.1 KiB
Markdown
127 lines
3.1 KiB
Markdown
---
|
|
title: DirecTV
|
|
description: Instructions on how to integrate DirecTV receivers into Home Assistant.
|
|
ha_category:
|
|
- Media Player
|
|
- Remote
|
|
ha_release: 0.25
|
|
ha_iot_class: Local Polling
|
|
ha_domain: directv
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@ctalkington'
|
|
ha_quality_scale: gold
|
|
---
|
|
|
|
The DirecTV platform allows you to control a [DirecTV](https://www.directv.com) receiver and its client devices.
|
|
|
|
### Requirements
|
|
|
|
For proper integration with Home Assistant, your DirecTV device settings should allow "External Access".
|
|
|
|
This is done via series of settings found via "Menu > Settings & Help > Settings > Whole Home > External Device":
|
|
|
|
- External Access: Allow
|
|
- Current Program: Allow
|
|
- Recordings: Allow
|
|
|
|
### Configuration
|
|
|
|
Go to the integrations page in your configuration and click on new integration -> DirecTV.
|
|
If your DirecTV device is on, it has likely been discovered already and you just have to confirm the detected device.
|
|
|
|
### YAML Configuration
|
|
|
|
Manual configuration of your DirecTV device is also possible, add the following to your `configuration.yaml` file:
|
|
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
directv:
|
|
- host: IP_ADDRESS
|
|
```
|
|
|
|
{% configuration %}
|
|
host:
|
|
description: "The hostname or IP of the DirecTV receiver, e.g., `192.168.0.10`."
|
|
required: true
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
## Services
|
|
|
|
### Media control services
|
|
|
|
Available services: turn_on, turn_off, media_play, media_pause, media_stop, media_next_track, media_previous_track, play_media
|
|
|
|
#### 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`.
|
|
|
|
## Remote
|
|
|
|
The DirecTV remote platform allows you to send remote control buttons to a DirecTV receiver. It is automatically set up when a DirecTV receiver is configured.
|
|
|
|
At the moment, the following buttons are supported:
|
|
|
|
- `power`
|
|
- `poweron`
|
|
- `poweroff`
|
|
- `format`
|
|
- `pause`
|
|
- `rew`
|
|
- `replay`
|
|
- `stop`
|
|
- `advance`
|
|
- `ffwd`
|
|
- `record`
|
|
- `play`
|
|
- `guide`
|
|
- `active`
|
|
- `list`
|
|
- `exit`
|
|
- `back`
|
|
- `menu`
|
|
- `info`
|
|
- `up`
|
|
- `down`
|
|
- `left`
|
|
- `right`
|
|
- `select`
|
|
- `red`
|
|
- `green`
|
|
- `yellow`
|
|
- `blue`
|
|
- `chanup`
|
|
- `chandown`
|
|
- `prev`
|
|
- `0`
|
|
- `1`
|
|
- `2`
|
|
- `3`
|
|
- `4`
|
|
- `5`
|
|
- `6`
|
|
- `7`
|
|
- `8`
|
|
- `9`
|
|
- `dash`
|
|
- `enter`
|
|
|
|
A typical service call for press several buttons looks like this.
|
|
|
|
```yaml
|
|
service: remote.send_command
|
|
data:
|
|
entity_id: remote.directv_entity
|
|
command:
|
|
- left
|
|
- left
|
|
- menu
|
|
- select
|
|
```
|