Skip to content

Digital Devices Octopus NET Monitoring as a Custom Component for Home Assistant.

License

Notifications You must be signed in to change notification settings

ufozone/ha-octopusnet

Repository files navigation

Digital Devices Octopus NET Monitoring

License Project Maintenance GitHub Activity

hacs Discord Community Forum

GitHub Release issues release-badge validate-badge lint-badge

Digital Devices Octopus NET Monitoring as a Custom Component for Home Assistant. Octopus NET with firmware octonet-pro-2.0.0 or higher are supported.

Installation

Important

Requires Home Assistant 2023.11.0 or newer.

Installation through HACS

Installation using Home Assistant Community Store (HACS) is recommended.

  1. If HACS is not installed, follow HACS installation and configuration at https://hacs.xyz/.

  2. Click the button below or visit HACS and add https://github.com/ufozone/ha-octopusnet.git as a custom repository with type Integration by following these instructions.

    Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  3. Install the integration.

  4. Restart Home Assistant!

  5. Make sure that you refresh your browser window too.

Manual installation

  1. Download the octopusnet.zip file from the repository release section.

    Do not download directly from the main branch.

  2. Extract and copy the content into the path /config/custom_components/octopusnet of your HA installation.

  3. Restart Home Assistant!

  4. Make sure that you refresh your browser window too.

Setup integration

Start setup:

  • Click this button:

    Open your Home Assistant instance and start setting up a new integration.

  • Or use the "Add Integration" in Home Assistant, Settings, Devices & Services and select "Digital Devices Octopus NET Monitoring".

Configuration

  • All configuration options are offered from the front end.

Available components

Binary Sensors

  • binary_sensor.{host}_epg

    Attributes:

    total, events, last_poll
    
  • binary_sensor.{host}_tuner_{n}

    This entity is disabled by default. You have to activate it if you want to use it.

    Attributes:

    lock, strength, snr, quality, level, last_poll
    
  • binary_sensor.{host}_stream_{n}

    This entity is disabled by default. You have to activate it if you want to use it.

    Attributes:

    input, packets, bytes, client, last_poll
    

Buttons

  • button.{host}_update

    Attributes:

    last_poll
    
  • button.{host}_reboot

    Attributes:

    last_poll
    
  • button.{host}_epg_scan

    Attributes:

    last_poll
    

Sensors

  • sensor.{host}_fanspeed

    Attributes:

    last_poll
    
  • sensor.{host}_temperature

    Attributes:

    last_poll
    
  • sensor.{host}_tuner

    Attributes:

    count, avg. strength, avg. snr, avg. quality, avg. level, last_poll
    
  • sensor.{host}_stream

    Attributes:

    total input, total packets, total bytes, total clients, last_poll
    

Services

  • octopusnet.epg_scan

    Start the EPG scan.

  • octopusnet.reboot

    Reboot the device.

Logging

Set the logging to debug with the following settings in case of problems.

logger:
  default: warn
  logs:
    custom_components.octopusnet: debug