Skip to content

Releases: w1tw0lf/Unifi-Device-info

v1.0.2 Remove logging error device

07 Feb 11:14
0da3c36
Compare
Choose a tag to compare

Remove the logging of devices that are not in the right format

v1.0.1 - Support user selection of updating interval

05 Feb 03:49
13f0271
Compare
Choose a tag to compare

Allow the user to select, in seconds, how often the information should be refreshed.

v1.0.0 Release

02 Feb 09:13
6778578
Compare
Choose a tag to compare

v1.0.0 - Initial Release

We are pleased to announce the initial release of UniFi Device Info Integration for Home Assistant!

Overview

The UniFi Device Info Integration polls your UniFi controller every 60 seconds for device statistics and publishes the data via MQTT discovery. This allows Home Assistant to automatically create sensor entities from your UniFi devices.

Features

  • Automatic MQTT Discovery:
    Automatically publishes MQTT discovery messages to configure sensors in Home Assistant.

  • Frequent Updates:
    Polls your UniFi controller every 60 seconds to provide up-to-date device statistics.

  • Comprehensive Device Data:
    Retrieves various device attributes such as uptime, CPU, RAM, model, firmware version, and more.

  • UI-Based Configuration:
    Configure the integration entirely through the Home Assistant UI using a built‑in config flow. No manual edits to configuration.yaml are required.

  • SSL Verification Option:
    The integration supports SSL verification with a configurable option (labeled as "Verify SSL").

Installation

Manual Installation

  1. Clone or download this repository.
  2. Place the entire unifi_mqtt folder in your Home Assistant custom_components directory (e.g., /config/custom_components/unifi_mqtt/).
  3. Restart Home Assistant.
  4. Go to Settings → Devices & Services → Add Integration, search for UniFi MQTT Integration, and follow the on‑screen instructions.

Files Included

  • __init__.py:
    Contains the core logic for polling the UniFi controller, processing the data, and publishing MQTT discovery and sensor messages.

  • config_flow.py:
    Implements a UI-based configuration flow for setting up the integration.

  • const.py:
    Defines constants used throughout the integration, including configuration keys and default values.

Known Issues & Workarounds

  • Entity Friendly Name Duplication:
    Home Assistant automatically concatenates the sensor’s name with the device’s name if both are provided. If you see a friendly name such as "UAP NanoHD UAP NanoHD", you can either:

    • Manually override the entity’s friendly name in the Home Assistant entity registry.
  • Cached Discovery Data:
    If changes are not reflected, be sure to remove cached entities from the entity registry and restart Home Assistant.

Requirements

  • Home Assistant (latest version recommended)
  • An MQTT Broker configured in Home Assistant
  • pyunifi Python package
  • pandas Python package

Contributing

Contributions, bug reports, and feature requests are welcome! Please open an issue or submit a pull request if you have suggestions for improvements.

License

This project is licensed under the MIT License.


Enjoy your new integration and happy automating with Home Assistant!