Driver Details

New Community

UniFi Network

By: David Bowdler
Updated: June 28, 2026
Version: 0.33
Download Driver Purchase License
Rating: 0.0 (0 ratings)
Log in to rate this driver

UniFi Network

Bring your Ubiquiti UniFi network into RTI. This driver gives two-way local control and monitoring of a UniFi Network controller - every access point, switch, PoE port and Wi-Fi client - straight from your RTI panels, with no cloud account required.

Key Features

  • Works with both controller types: UniFi OS consoles (UDM, Dream Router, Cloud Gateway, Cloud Key Gen2) on port 443, or a legacy Cloud Key Gen1 / self-hosted controller on 8443 - one tick-box selects which.
  • Device status: per-AP and per-switch online state, model, IP, CPU, memory, uptime, firmware and client counts.
  • PoE control: switch any PoE port on, off or power-cycle it, with live wattage feedback and per-port mode (Auto / Off / 24V).
  • Device control: reboot any access point or switch, or flash its locate LED.
  • Wi-Fi networks: enable or disable any WLAN on demand.
  • Presence by name: track up to eight devices by MAC or by device name - name-matching follows a phone through Wi-Fi MAC randomisation, which a MAC alone cannot.
  • Block a Wi-Fi client: cut a watched device off Wi-Fi from a panel and restore it, always targeting its live address.
  • Device lifecycle events: Connected, Disconnected, Provisioning, Adopting and Missing-Heartbeat events for every AP and switch.
  • Built-in dashboard: an on-processor Web Object control page, plus design-time device discovery and a telnet debug console.

Requirements

  • An RTI XP processor on the same network as the controller.
  • A local controller admin account (a Ubiquiti cloud / SSO login will not work - it needs an emailed MFA code).
  • Integration Designer 11.x.

How It Works

The driver talks to the controller's local API over HTTPS - no cloud, no third-party server. A design-time Discover menu fills in your devices automatically, and the driver's tags drop straight onto your panels. Feedback is optimistic for instant button response, with a fast background poll. Tested on a Cloud Gateway Ultra with a USW-Lite-16-PoE switch and U6+ access points (UniFi OS), and a Cloud Key Gen1 (legacy). A 120-minute free trial is built in.

UniFi Network Control Driver

Version 0.33

Monitor and control a Ubiquiti UniFi Network controller (access points, switches, PoE ports, clients) from RTI.

Setup

1. Enter the controller IP (Cloud Key / UDM / self-hosted).

2. Port: 8443 for Cloud Key Gen1 or self-hosted. For a UniFi OS console (UDM, Dream Router, Cloud Key Gen2) set Port 443 and tick "UniFi OS Console".

3. Username / Password: use a LOCAL controller admin. A Ubiquiti SSO / cloud account will NOT work - cloud accounts require an emailed MFA code that a controller cannot supply. Create a local-only admin on the controller (or contact support if your Cloud Key only offers cloud logins).

4. Site: usually "default".

Features

- Device status: each AP / switch online state, model, IP and client count.

- Client / health counts: total, Wi-Fi, wired; WLAN and LAN health.

- Presence: track up to 8 clients by MAC OR device name - Online / Status (Connected, Disconnected, Blocked) variables + Came Online / Went Offline events for occupancy automation.

- Block a Wi-Fi client: cut a watched device (e.g. a phone) off Wi-Fi and restore it, with Blocked / Unblocked feedback.

- Control: reboot a device, flash its locate LED, switch a PoE port on/off or power-cycle it, enable/disable a WLAN, block/unblock a client.

- Snappy feedback: buttons update the instant you press them (optimistic), and the controller is polled every few seconds (Poll Interval, default 5s) so changes made elsewhere appear quickly.

Functions

Reboot Device (1-8), Locate LED On/Off (1-8), Set PoE Port (port, on/off), Power-Cycle PoE Port (port), WLAN Enable/Disable (wlan #, on/off), Block / Unblock Client (MAC), Block / Unblock Watched Client (1-8), Poll Now, Reconnect.

Presence & Blocking Wi-Fi Clients

Under "Presence Watch" you can track up to 8 clients. For each watch slot set:

- Watch N Name: the friendly label shown on screen (e.g. "David's Phone").

- Watch N MAC or Name: what to match on - either the client's MAC (aa:bb:cc:dd:ee:ff) OR its UniFi device name (e.g. David-s-S23-Ultra), as it appears in the UniFi client list.

IMPORTANT - phones randomise their Wi-Fi MAC. Modern iPhones (Private Wi-Fi Address) and Android phones change their MAC periodically, and a phone can also change its MAC to get around a block. If you watch a phone by MAC it will eventually show offline even while it is connected. For any phone, enter its DEVICE NAME instead of a MAC: the driver then follows it through every MAC change, and Block always targets its current address.

Each watched client exposes Online, Name, Status (Connected / Disconnected / Blocked), Blocked, Unblocked and its resolved live MAC, plus Came Online / Went Offline events. Block and Unblock cut the client off Wi-Fi and restore it; a blocked client reads "Blocked" and shows as off the network. If a phone rotates its MAC immediately after being blocked it can briefly reappear - simply block it again to catch the new address.

Presence timing - please read

Connecting is fast - a device that joins Wi-Fi shows Connected within a few seconds. Disconnecting is slow - when a device leaves on its own (walks out of range, or Wi-Fi is switched off) it can take UP TO ABOUT 5 MINUTES to show Disconnected. This is a UniFi / Wi-Fi limitation, not the driver: the UniFi controller itself waits for the access point's client inactivity timeout (a couple of minutes) before it marks the device offline, and the driver then applies its Away Timeout on top. The driver can only report what UniFi reports. For automation, trigger confidently on Connected (someone has arrived) and treat Disconnected as a slower "has left". Lowering the Away Timeout makes the "left" side a little quicker.

Diagnostics

A telnet debug console is available on the configured Debug Console Port (default 12533): status, devices, clients, wlans, poll, login, reboot N, locate N on/off, poe P auto/off.

Tested With

Validated on both controller types:

- UniFi OS console: Cloud Gateway Ultra (UCG-Ultra, UniFi OS / firmware 5.1.19), adopting a USW-Lite-16-PoE switch (firmware 7.4.1.16850) and U6+ access points (firmware 6.7.54.15663). Port 443, "UniFi OS Console" ticked. Provides real WAN status.

- Legacy controller: Cloud Key Gen1 (UC-CK) running UniFi Network application 7.2.97, with a US-8-150W switch and UAP-nanoHD / AC-Pro / AC-Lite access points. Port 8443.

Other Cloud Key / UDM / Dream Router / self-hosted UniFi Network controllers using the same local API are expected to work (legacy uses port 8443; UniFi OS uses port 443 with the "UniFi OS Console" option).

Support

Smart Home Programming - https://smarthomeprogramming.com.au

120-minute free trial - the driver is fully functional for 120 minutes with no licence key, so you can confirm it works with your controller before buying.

Permanent licence: a one-time, per-processor key keyed to your RTI processor's MAC address (shown in the driver's MAC For Key system variable). One key per processor.

Purchase from Smart Home Programming: https://smarthomeprogramming.com.au/store/