Repository navigation
The first udeco release. udeco makes TP-Link Deco X20 mesh units, and a
JioFiber JCOW414 router, show up in a UniFi Network controller as UniFi
access points. You then manage their Wi-Fi from UniFi like any UniFi AP.
Everything the agent does today is listed below.
Downloads
| File | For | Install with |
|---|---|---|
udeco-ap-deco-x20-linux-armv7 and .gz |
TP-Link Deco X20 V2 (Broadcom, armv7) | deploy/deco-ap.sh |
udeco-ap-jio-jcow414-linux-mipsle and .gz |
JioFiber JCOW414 (MediaTek, mipsle) | deploy/jio-ap.sh |
SHA256SUMS |
checksums of all four files |
The deploy scripts build these same files from the same commit (the build
is reproducible), so a deploy's md5 matches the download's. You need root
SSH (Deco) or telnet (JioFiber) on the unit; getting it is not covered.
What to expect
- The unit appears in UniFi as a U6-Lite (Deco) or a UAP-AC-Lite /
UAP-IW-HD (JioFiber). Adopt it like any UniFi AP. - After a reboot the Deco runs TP-Link's own Wi-Fi for about 2 minutes,
then the agent takes over. Clients see one short drop at takeover. - TP-Link's mesh, app and cloud stop working on taken-over units: every
unit must be wired to your network, and you manage it only from UniFi. - Firmware upgrades from UniFi are ignored; no Ubiquiti firmware is ever
flashed. - Remove the launcher and reboot, and the unit is stock TP-Link again.
- Tested on: three Deco X20 V2 (TP-Link firmware 1.3.0 Build 20250912)
wired, UniFi Network 11.1.50 on a UniFi Cloud Gateway; one JCOW414. Other
models and firmware are untested.
Deco X20: management
- Verified: adoption, provisioning, Forget and re-adoption (no Wi-Fi
restart on re-adoption). - Verified: live stats following the controller's 1 s / 10 s inform
interval. - Built:
inform_every_s(5-60 s, off by default) reports more often
than the controller's ~30 s pacing for unwatched APs (Verified on the
JioFiber at 10 s; not yet run on a Deco). - Verified: restart from UniFi (back in UniFi about 3 minutes later).
- Verified: Locate and LED on/off (green; UniFi's LED colour is not
carried). - Verified: topology: UniFi shows the switch port the unit is on (LLDP).
- Verified: site SSH keys and site logins pushed from UniFi.
- Verified: login lock: while UniFi's Device SSH Authentication is off
and the controller answers, new root logins to the unit are refused; they
open after 10 minutes without the controller, or when Device SSH is
turned on. - Verified: encrypted remote syslog to the controller.
- Built: SNMP and an mDNS bridge (both off by default).
Deco X20: Wi-Fi networks and security
- Verified: open and WPA2-Personal networks, with PMF optional or
required. - Verified: WPA2/WPA3 transition and WPA3 (SAE) with
"wpa3": true. - Verified: hidden networks, enabling and disabling networks, a VLAN per
network, networks per AP group, MAC allow/deny lists, and Wi-Fi schedules. - Built: WPA2/WPA3 Enterprise, RADIUS MAC authentication, private PSK
and Hotspot 2.0. A network whose RADIUS server is unusable is refused,
never brought up open. - Not possible: Enhanced Open (OWE) and RADIUS-assigned VLANs (this
hostapd has neither); such networks are refused.
Deco X20: roaming and client tuning
- Verified: 802.11k neighbour reports listing the other units, and
802.11v. - Built: 802.11r fast roaming for WPA2 (FT-PSK) and WPA3 (FT-SAE). The
units share roaming keys with signed announcements on the LAN. Phones join
with it on; a fast roam between units has not been observed yet. - Verified: client isolation, proxy ARP, multicast-to-unicast, DTIM and
U-APSD settings, and Intelligent DHCP (DHCP replies sent unicast). - Built: BSS Load element, BPDU filter, IGMP/MLD snooping on the
agent's VLAN bridges, Target Wake Time (on by default, as on a U6 Pro). - Built: band steering and max clients per radio.
- Built: Restrict to 5 GHz: dual-band clients seen on 5 GHz in the last
hour are asked to leave 2.4 GHz; clients never seen on 5 GHz are never
refused. - Built: Minimum RSSI: a client below the controller's minimum for 3
readings is asked to roam, then disconnected with a 30 s ban on that AP. - Built: minimum data rates (off by default; it restarts the radio).
Deco X20: radios
- Verified: channel, width (80 MHz on 5 GHz), transmit power, custom
power without a radio restart, and U6 Pro radio defaults (implicit
beamforming off, receiver desense off). - Built: low/medium/high power presets, matching a U6 Pro.
- Built: auto channel: picked once when the radio restarts anyway; 2.4
GHz uses 1, 6 or 11; 5 GHz never picks DFS; blocked channels are never
used. - Verified: country tables, including per-radio tables
(driver_country_bands). The tested units run Broadcom's#atable on
5 GHz for Wi-Fi 6 rates on 36-144 and 149-161; under it the agent
refuses 120-128 (weather radar). - Verified: DFS channels with the driver's channel availability check
under a country table that has DFS; radar moves are followed and reported
to UniFi (a real radar move has not been seen). - Verified: neighbour and rogue-AP list, refreshed every minute.
- Partial: spectrum scan: 2.4 GHz complete; 5 GHz covers 36-48 only.
Deco X20: clients
- Verified: client list with signal, rates, traffic and Wi-Fi
generation; no clients flapping between APs. - Verified: connect and leave events; a client that leaves disappears
from UniFi at once. - Verified: per-client TX retries; reconnect, block and unblock; lock a
client to an AP (live, no hostapd restart). - Verified: per-client speed limits (user groups). While any limit is
set, the unit turns off its hardware flow cache, which costs some
throughput. - Built: network and user-group speed limits.
- Built: connection-timing events (association, authentication, DHCP,
DNS timings, as UniFi APs report them), and a gratuitous ARP when a
client joins so switches learn it at once.
Deco X20: guests
- Verified: guests reach the gateway and internet but never LAN hosts.
- Verified: the gateway-hosted guest portal: before login a guest gets
DHCP, DNS and the portal only; authorise opens the internet. - Built: guest isolation across APs.
- Not possible: automatic captive-portal redirect (this ebtables has no
redirect target); guests open the portal page themselves.
Deco X20: stats, uplink and safety
- Verified: channel utilisation, CPU, memory, uptime, load, Wi-Fi
Experience, wired uplink and its traffic. - Built: networks go down when the uplink cable has no link for 5 s
(and back after 10 s of link), so clients move to another AP; the LED
blinks red meanwhile. - Built-in safety: a failed apply retries the last good config, then
hands Wi-Fi back to TP-Link with every network restored and stops
changing anything (observe mode). TP-Link's app and web ports are closed;
the unit's own internet access is blocked except to the controller. An
unexplained reboot is recorded inevents.log.
JioFiber JCOW414
Run with "platform": "jio-mtk"; adopted as a UAP-AC-Lite (U7LT) or, with
"model": "UHDIW", a UAP-IW-HD with LAN ports.
- Verified: adoption and provisioning; networks per AP group with WPA2
and VLANs; channel, width and power; client list and stats; login lock
(telnet and SSH). Jio's own services are stopped; telnet is kept. - Verified: downlink watchdog: a 2.4 GHz client that stops answering
while dozing (seen with a Tuya pump) is disconnected so it reconnects
(seen live). In this release it checks every 5 s between informs, which
has not yet caught a real stall. - Verified: DTIM period per radio over the controller's
(driver_dtim_bands, 2 on 2.4 GHz on the tested unit). - Partial: WPA3 on 5 GHz only (the 2.4 GHz driver has no SAE); no SAE
client seen yet. - Built: U6 parity on this hardware: Minimum RSSI, WPS off, group rekey
and PMK cache, 2.4 GHz auto channel on 1/6/11, multicast enhancement, tx
power reported in dBm, implicit beamforming and 20/40 coexistence off,
networks down on uplink loss (except one management network), immediate
leave events, stable BSSIDs per network (bss_pinning), guest networks
with the portal, proxy ARP, DFS on 52-64 (dfs), gratuitous ARP on join. - Built: RF scans from UniFi (
site_survey): neighbour list on both
bands and per-channel utilisation charts on 2.4 GHz. - Built: LAN port VLANs as a UAP-IW-HD, with a port monitor that undoes
any port change that cuts the unit off from the controller. - Built: gateway guard: a new build that loses the gateway rolls back
to the previous build after 180 s, and the unit reboots after 480 s. - Not on this platform: speed limits.
Tooling
deploy/deco-ap.shanddeploy/jio-ap.sh: build, read-only preflight
checks, md5-checked install, launcher, and a one-line rollback.- GitHub Actions: tests every push and builds one agent per device; tagged
releases publish the builds with these notes. - The Go module is
github.com/dtechterminal/udeco. The OpenWrt code,
tools and packaging inherited from unifi-openwrt (the project udeco was
forked from) are removed; its UniFi protocol notes stay in
docs/internals.md.