Unifi Protect Relay (UP-Relay)

[valtek428]

Integration name

Unifi Protect

Link to integration documentation on our website

https://www.home-assistant.io/integrations/unifiprotect/

Describe the enhancement

Requesting the addition of the UP-Relay in the Protect integration in order to activate the two buttons.

Use cases

This would allow the use of the Relay as a garage door opener without needing a physical trigger.

Anything else?

No response

[github-actions[bot]]

🏷️ I've automatically added the integration: unifiprotect label to help categorize this feature request.

[RaHehl]

At least the outputs are already coming with 2026.5 — see the beta release notes: https://rc.home-assistant.io/blog/2026/04/29/release-20265/#noteworthy-improvements-to-existing-integrations

However, for practical usability, you’ll still need to wait for Protect 7.1. Inputs are also planned. At the moment, I can’t give a reliable forecast for that; the earliest would be 2026.6.

[valtek428]

You are amazing! Thank you.

[crazyelectron-io]

That is great news as I recently installed two USL-Relay devices for the gate and garage door. All SuperLink devices show up in the protect integration, except the USL-Relay devices. I gave the account SuperAdmin rights to test if it is access rights related, but still no luck. I am currently not interested in the input channels, just the output channels.
Obviously I upgraded to 2026.5.2 and did also a reload of the integration. Is it not yet integrated in 2026.5.2 or am I doing it wrong?

BTW, The USL Siren is also not showing up in the device list.

[anderlk]

What is the status of the integration of the two relay inputs? Is integration planned?

Thanks, Andreas

[anderlk]

@RaHehl thanks for your detailed explanation. Yes, the relay is far from finished at the moment, and a lot of things—especially regarding the inputs—aren't working properly yet.

Well, at least I know this feature is in the works, so I'll just have to be patient a little longer until it works properly.

[igoraugustynski]

Any updates on that?

[anderlk]

@igoraugustynski The relay inputs are a bit buggy ;). Before 7.2.105 there was no functionallity and there comes only Button Pressed as Message after changed the input state of the relay.

In Protect Version 7.2.105 is the "Button pressed" Bug fixed. I installed the version today and at least I'm able to set up an alarm that actually goes off properly.

In my case, I used a magnetic contact (normally closed) as the trigger. In the relay configuration, I selected “Switch” as the type and “Normally Closed” as the logic.

@RaHehl Maybe the status can now be queried correctly via the new PoS API?

[igoraugustynski]

Hey @anderlk, thank you for your reply. I have a similar setup to yours; my USL Relay controls a garage door, and the two inputs are connected to two reed switches, one for fully open and one for fully closed. As far as alarms go, there is a "Sensor => Relay Input Change" alarm trigger now with 7.2.105.

I'll see if I can test the API myself; maybe this update fixed things silently.

[igoraugustynski]

@anderlk @RaHehl I can confirm I'm now seeing the correct "relayInputChanged" events. I have created a PR with my take on the implementation home-assistant/core#179905.

[seensnine]

Correct part number USL-Relay

[seensnine]

Just here to chime in that we really need good relay integration.

Protect integration currently exposes the USL-Relay output channels (O1 / O2) as basic switch entities. Unifi dashboard supports granular output configurations and dry-contact switch/sensor inputs (S1 and S2) that are not yet exposed as native Home Assistant entities.

This request proposes adding full entity coverage for the USL-Relay:

1. Input Monitoring (S1 & S2):
   -Expose S1 and S2 as binary_sensor entities (e.g., binary_sensor.usl_relay_input_s1, binary_sensor.usl_relay_input_s2).
   -Support configurable device classes (e.g., door, garage_door, opening, power, or problem) or default to generic dry contact/switch states.

2. Output Customization & Extended Controls (O1 & O2):
   -Pulse / Momentary Mode Support: Expose pulse duration configuration so momentary dry-contact triggers function without requiring external timer automations.
   -State Reflection
   -Power-on State / Relay Mode Configuration: Expose select entities or configuration parameters for the relay operating mode

[anderlk]

@igoraugustynski, @RaHehl Thanks for the great Integration of the relay input.

The integration works fine so far, but I have a small problem.

I used the input as garage door closed sensor. If the contact is closed means the door is closed. The display in Home Assistant is inverted for me. When the contact is closed, it's shown as open and upside down.

Is this a settings issue? How to change this behavior?

[RaHehl]

Home Assistant shows the input state exactly as Protect reports it. Your input is on while the door is closed, and with "Show as: Garage door" on means open. To flip it, create a template binary sensor helper with {{ is_state('binary_sensor.your_input', 'off') }} and device class Garage door.

[RaHehl]

Which garage door opener are you using?

[anderlk]

The Garage Door Opener is not the Problem. All works correct, but the Status of the relay Inputs are shown wrong in homeassistant. In my case, when the garage door is closed, the contact is closed. However, it is displayed as open in Homeassistant.

[seensnine]

I encountered the exact same issue and used the same fix. The problem stems from Protect not correctly recognizing the NC/NO values and configuration, as well as Ubiquiti's lack of support for the product.

…

On Thu, Oct 15, 2026 at 10:21 AM Raphael Hehl ***@***.***> wrote: Home Assistant shows the input state exactly as Protect reports it. Your input is on while the door is closed, and with "Show as: Garage door" on means open. To flip it, create a template binary sensor helper with {{ is_state('binary_sensor.your_input', 'off') }} and device class Garage door. — Reply to this email directly, view it on GitHub <#3611?email_source=notifications&email_token=BXVMQABJYK72FWHIBOPSZM35UEBPVA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZGU2DINBYUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-18954448>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BXVMQAFGCBEZ623GKZJFF735UEBPVAVCNFSNUABHKJSXA33TNF2G64TZHM4TSNRXHA2DCNBWHNCGS43DOVZXG2LPNY5TSOJXGM3DKMFBOYBA> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BXVMQAEX45RKDR74NLOBHET5UEBPVA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZGU2DINBYUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/BXVMQAA6NEIFCMXCYDOLV6D5UEBPVA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZGU2DINBYUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you commented.Message ID: <home-assistant/feature-requests/repo-discussions/3611/comments/18954448@ github.com>

[anderlk]

@seensnine yes thats it!! If we could read the NC/NO status in Home Assistant, that would be the solution. @RaHehl I don't kow if this is possible via the API?

[RaHehl]

@anderlk The API only gives on (circuit closed) or off (open), no NC/NO setting, so HA can't read it. The template helper is the fix.

I asked about the opener because some report their state directly, e.g. Hörmann via ESPHome shows the exact position in %, no reed switches needed.

[anderlk]

@RaHehl thanks for your Feedback. No my opener has no Feedback about the state of the door. Yes, with template helper it works. Thanks for the Tip!

Regards Andreas

[seensnine]

@RaHehl <https://github.com/RaHehl> Oh wow that's so nice to have the exact position in % I doubt my Genie opener will support that

…

On Fri, Oct 16, 2026 at 4:14 AM Raphael Hehl ***@***.***> wrote: @anderlk <https://github.com/anderlk> The API only gives on (circuit closed) or off (open), no NC/NO setting, so HA can't read it. The template helper is the fix. I asked about the opener because some report their state directly, e.g. Hörmann via ESPHome shows the exact position in %, no reed switches needed. — Reply to this email directly, view it on GitHub <#3611?email_source=notifications&email_token=BXVMQACL5HXJNFM4QYYNLFD5UH7JNA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZG4YTOMBXUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-18971707>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BXVMQAGCTKJHCZ6SPQ4PD6L5UH7JNAVCNFSNUABHKJSXA33TNF2G64TZHM4TSNRXHA2DCNBWHNCGS43DOVZXG2LPNY5TSOJXGM3DKMFBOYBA> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BXVMQAGV3FBPQM7QKR4SSQT5UH7JNA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZG4YTOMBXUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/BXVMQAEXCLH5CV5COOTJWVL5UH7JNA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBZG4YTOMBXUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you were mentioned.Message ID: <home-assistant/feature-requests/repo-discussions/3611/comments/18971707@ github.com>