Skip to content

CoMPaTech/hAirOS

Repository files navigation

Ubiquiti airOS Custom Component for Home Assistant

⚠️⚠️⚠️Read the release notes before upgrading, in case there are BREAKING changes! ⚠️ ⚠️ ⚠️

Maintenance CodeFactor HASSfest Generic badge

CodeRabbit.ai is Awesome Quality Gate Status Technical Debt Code Smells

Requirements

Only tested/confirmed with airOS 8 on:

  • Nanostation 5AC (LOCO5AC) by @CoMPaTech
  • PowerBeam 5AC gen2 by @exico91

Installation

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

Configuration

Configure this integration the usual way, requiring your username (ubnt), password and IP address of the airOS device.

What it provides

In the current state it retrieves some information and should display the 'other device connected', connection mode, SSID and both actual data being transferred and the maximum capacity. These are displayed as sensors or binary_sensors though most binary_sensors are disabled by default. Additionally for stations connected, child-devices are displayed with both a binary_sensor indicating connection and a button to force reconnect on the connected device (i.e. the same as the reconnect button on the default homepage of airOS

State: BETA

Even though available does not mean it's stable yet, the HA part is solid but the class used to interact with the API is in need of improvement (e.g. better overall handling). This might also warrant having the class available as a module from pypi.

How to install?

  • Use HACS
  • Navigate to the Integrations page and use the three-dots icon on the top right to add a custom repository.
  • Use the link to this page as the URL and select 'Integrations' as the category.
  • Look for airOS in Integrations and install it!

How to add the integration to HA Core

For each device you will have to add it as an integration.

  • In Home Assistant click on Configuration
  • Click on Integrations
  • Hit the + button in the right lower corner
  • Search or browse for 'Ubiquiti airOS' and click it
  • Enter your details

Is it tested?

It works on my bike and Home Assistant installation :) Let me know if it works on yours!

SonarCloud

And Home-Assistant Hassfest and HACS validation