Home Assistant integration for the Silicondust HDHomeRun network tuners.
The integration can be installed using HACS. The integrations is not available in the default repositories, so you will need to add the URL of this repository as a custom repository to HACS (see here).
Alternatively you can use the button below.
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.
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.
| Location | Name | Enabled by default | Additional Information |
|---|---|---|---|
| Device | Channel Scanning | ✔️ | Percentage progress of the channel scan |
| Location | Name | Enabled by default | Comments |
|---|---|---|---|
| Device | Channel Scan | ✔️ | Requires the source to be selected first (see here) |
| Device | Restart | ✔️ |
| Location | Name | Enabled by default | Comments |
|---|---|---|---|
| Device | Channel Sources | ✔️ | Selects the channel source to be used when carrying out a channel scan |
| Location | Name | Enabled by default | Primary value | Additional Information | Comments |
|---|---|---|---|---|---|
| Device | Channel Count | ✔️ | Number of channels currently tuned on the device | ||
| Device | Disabled Channels | ✔️ | Number of channels marked as disabled in the channel list | List of channel names | |
| Device | Favourite Channels | ✔️ | Number of channels marked as favorites in the channel list | List of channel names | |
| Device | Tuner Count | ✔️ | Number of tuners the device has | ||
| Tuner | Tuner X | ✔️ | Status of the tuner; Idle, In use, Scanning or the channel being watched |
Frequency, signal strength, signal quality, symbol quality, network rate and target IP (as applicable) | X is the tuner number. |
| Tuner | Frequency | ✔️ | |||
| Tuner | Network Rate | ✔️ | |||
| Tuner | Signal Quality | ✔️ | |||
| Tuner | Symbol Strength | ✔️ | |||
| Tuner | Target IP | ✔️ |
| Location | Name | Enabled by default | Comments |
|---|---|---|---|
| Device | Firmware | ✔️ |
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.
-
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.
On successful set up the following screen will be seen detailing the device.
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.
It is possible to configure the following options for the integration.
Scan Interval: the frequency of updates for the sensors, default300sTuner status update: the frequency of updates for tuners, default10s
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.
Debug logging can be enabled in Home Assistant using the logger
integration.
logger:
default: warning
logs:
custom_components.hdhomerun: debugStarting 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.