HDHomeRun

Home Assistant integration for the Silicondust HDHomeRun network tuners.

Description

This integration can be used to get basic information on each HDHomeRun device in the network. The integration can use the UDP broadcast discovery protocol, the TCP control protocol and the HTTP API.

Entities Provided

Where applicable the sub-items in the list detail the additional attributes available. All entities may not be available to you depending on how the device was discovered and what its capabilities are.

Binary Sensors

Channel Scanning - denotes whether a channel scan is in progress
- Percentage progress
Update available - denotes whether there is a firmware update available for the device (only if using a HASS version below 2022.4)

Button

Channel Scan - instructs the device to carry out a channel scan using the selected source
Restart - allows restarting a device

Select

Channel Sources - allows selecting the channel source to be used when carrying out a channel scan

Sensors

Channel Count - the number of channels currently tuned on the device
Disabled Channels - the number of channels marked as disabled in the channel list
- List of channel names
Favourite Channels - the number of channels marked as favorites in the channel list
- List of channel names
Newest Version - the latest version of firmware available for the device (only if using a HASS version below 2022.4)
Tuner Count - the number of tuners the device has
Tuner X - where X is the tuner number (states can be: Idle, In use, Scanning or the channel being watched, using the specified format)
- Virtual channel number, virtual channel name, frequency, signal strength, signal quality, symbol quality, network rate and target IP (as applicable)
Tuner X Frequency - where X is the tuner number
Tuner X Network Rate - where X is the tuner number
Tuner X Signal Quality - where X is the tuner number
Tuner X Signal Strength - where X is the tuner number
Tuner X Symbol Strength - where X is the tuner number
Tuner X Target IP - where X is the tuner number
Version - the current firmware version of the device (only if using a HASS version below 2022.4)

Update

Update - used to show if a firmware update is required (only if using a HASS version later than 2022.4)

Setup

`Add Integration` button

If adding the integration by clicking the Add Integration button the following information will be requested.

Host: The IP of an HDHomeRun device on the network. Leave blank to carry out discovery.
- If you provide a valid IP address, and you will be prompted for a friendly name.

HTTP/UDP Discovery

This section is only applicable if you did not provide a host in the Add Integration section.

Click NEXT and you will be prompted for a friendly name.

Setup Complete

On successful set up the following screen will be seen detailing the device.

SSDP Discovery

The integration can also detect the HDHomeRun devices on the network using SSDP. When found they will look like this on your devices screen.

Clicking CONFIGURE you will be prompted for a friendly name.

Configurable Options

It is possible to configure the following options for the integration.

Timeouts

Scan Interval: the frequency of updates for the sensors, default 300s
Tuner status update: the frequency of updates for tuners, default 10s

Options

Channel logo path - the path to a directory containing channel logos, e.g. /local/channel_logos. The default is to have no logo. If previously set, you can clear this option by just entering a space

You can also select which format should be used for the sensor. The default is Channel name.

This setting is only effective when a tuner is actively tuned to a channel.

Troubleshooting

Debug Logging

Debug logging can be enabled in Home Assistant using the logger integration.

logger:
  default: warning
  logs:
    custom_components.hdhomerun: debug

Diagnostics Integration

Starting with Home Assistant 2022.2, a new diagnostics integration can be used to provide troubleshooting for integrations.

The highlighted area in the image below shows where the link for downloading diagnostics can be found.

An example output can be found in this repo.

uvjim/hass_hdhomerun