Merge branch 'next' into rc

This commit is contained in:
Franck Nijhof 2020-03-11 20:59:17 +01:00
commit 8ba96584da
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
3 changed files with 21 additions and 64 deletions

View File

@ -7,83 +7,34 @@ ha_category:
ha_release: 0.25
ha_iot_class: Local Polling
ha_domain: directv
ha_config_flow: true
---
Master [DirecTV](https://www.directv.com/) receivers (ie: those that have tuners) will be automatically discovered if you enable the [discovery integration](/integrations/discovery/) 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.
The DirecTV platform allows you to control a [DirecTV](https://www.directv.com) receiver and its client devices.
### 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:
To ensure that your DirecTV boxes are always found and configured, they should be added into your `configuration.yaml`.
```yaml
# Example configuration.yaml entry
media_player:
- platform: directv
directv:
- host: IP_ADDRESS
```
{% 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
description: "The hostname or IP of the DirecTV receiver, e.g., `192.168.0.10`."
required: true
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:
```json
{
"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:
```yaml
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.
## Services
### Media control services

View File

@ -56,6 +56,11 @@ password:
description: Your iCloud account password.
required: true
type: string
with_family:
description: If you want to fetch your family devices.
required: false
default: false
type: boolean
max_interval:
description: Maximum interval in minutes between subsequent location updates. This tracker uses dynamic intervals for requesting location updates. When the iPhone is stationary, the interval will eventually be set to `max_interval` to save battery. When the iPhone starts moving again, the interval will be dynamically updated to 1 min. Note that updating interval to 1 min might be delayed by maximum `max_interval` minutes. Minimum value is 1 min.
required: false

View File

@ -25,6 +25,7 @@ ssdp:
The following integrations are automatically discovered by the SSDP integration:
- [deCONZ](../deconz/)
- [DirecTV](/integrations/directv/)
- [Huawei LTE](../huawei_lte/)
- [Philips Hue](../hue/)
- [Samsung TV](../samsungtv/)