Unifi Integration feature request - enable / disable switch ports

kanemari · October 8, 2024, 3:54am

Using the Unifi API it is possible to enable and disable switch ports, but this feature is not implemented in the HA integration. Would be a very useful addition.

github.com

Art-of-WiFi/UniFi-API-client/blob/b633fa54c738b7cfac5ca27b8126161eac5f8e5b/examples/disable_switch_port.php

<?php
/**
 * PHP API usage example
 *
 * contributed by: Art of WiFi
 * description:    example PHP script to disable/enable the port of a UniFi switch
 * note:           Requires controller version 5.5.X or higher. This example assumes an override alreay exists for the desired port.
 *                 To create a new port override simply append one (similar in structure to $updated_override) as needed to the
 *                 $existing_overrides array
 */

/**
 * using the composer autoloader
 */
require_once 'vendor/autoload.php';

/**
 * include the config file (place your credentials etc. there if not already present)
 * see the config.template.php file for an example
 */

This file has been truncated. show original

petro · October 8, 2024, 12:26pm

These already exist. They are switch entities in the device page on your switch.

Holdestmade · October 8, 2024, 12:31pm

I think that just turns the POE power on and off, not enabling/disabling the ports ? The non-POE ports don’t show there ?

kanemari · October 8, 2024, 1:24pm

Those buttons only toggle the PoE. I have a US-8 and a US-8-PoE-150W. The 150W has these buttons whereas the other doesnt.

(technically the US-8 has one of those PoE buttons, which aligns with the number of PoE switches available)

petro · October 8, 2024, 1:45pm

That could be the case, I use it to turn on/off POE cameras which effectively do what I’d expect.

Holdestmade · October 8, 2024, 2:57pm

Don’t they only turn off the POE power, not disable the port ? I think that is what is being requested here

petro · October 8, 2024, 2:59pm

I’m not arguing here

I’m simply stating that these switches work the way I expect them to work. I haven’t used them to turn off the actual network because I can’t check that. Once the POE is off, the camera is off. Therefore it’s doing what I’d expect the switches to do. My assumption is that it cuts everything, it may not. Hence why this FR is still open.

emmi89 · October 9, 2024, 7:06am

Hello, this is exactly the function I am looking for and would like from the integration of Unifi Network in Homeassistant.

I would like to completely deactivate the port when a specific device disconnects from it.

This is intended to increase security when the access point in the garden is disconnected from the LAN.

emmi89 · October 9, 2024, 7:13am

I just tested the assumption that everything is separated and not just POE. This is not the case and only the POE is switched off, but the port remains active.

kanemari · October 9, 2024, 11:36am

correct - as I said before, the US-8 only has 1 PoE port, but 8 ports in total. There is only one PoE switch via the HA integration and nothing for the other 7 ports - which quite clearly points to it being only a PoE switch and not a complete port switch.

MikeD190 · October 25, 2024, 5:26pm

What you can do in home assistant is control firewall rules that are configured on your unifi dashboard, so you could set up a firewall rule to block a certain device or port and then have an automation set up in home assistant to activate or deactivate that firewall rule. Not quite as simple as direct controls of the physical ports but still doable.

kanemari · October 25, 2024, 9:40pm

you can use firewall rules, but generally that requires time for the blocked device to time out and take some sort of action - whereas the port getting switched off is instantly detected as “link down”. in my scenario I am trying to force a fail over so I don’t want to be waiting minutes for a time out… I just want the connection dead instantly.

Ulrar · November 9, 2024, 4:33pm

Just want to upvote this as well. I’d love to have an automation trigger when the port goes down to disable it, so having both a sensor and a switch would be great.

That’d allow making outdoor cameras and access points much safer, if someone unplugs it the port goes dead. Wish that was available in Unifi itself, but having it in HA would be great