Skip to main content

Omada

@jamesakeech/omadav2026.08.08.1· 14d agoMODELS
01README

Observability and safe operational control for a TP-Link Omada controller. One fan-out sync reads every site, device, client, switch port, gateway WAN and SSID into addressable resources, and writes a drift record comparing configuration — not telemetry — against the previous sync, so an idle network reports nothing and a firmware bump, a re-addressed WAN, a disabled PoE port or a device that stopped answering each report themselves. Talks the supported Open API in client-credentials mode, with the controller's own web API as an optional fallback for reads the Open API does not expose. Writes are limited to reversible operational actions — reboot, PoE, client block, reconnect, LED, locate, firmware — each fanning out over a list in one controller session.

02Models1
@jamesakeech/omadav2026.08.08.1omada.ts
fn sync()
Read the whole controller and write one resource per site, device,
fn rebootDevices()
Reboot one or more adopted devices. Each MAC is resolved to its
fn setPoePorts()
Switch PoE on or off for specific switch ports. Ports are grouped
fn setClientAccess()
Block or unblock clients by MAC. Blocking is the controller's own
fn reconnectClients()
Force clients to re-associate. Useful for pushing a client onto a
fn setLed()
Turn the status LEDs on every device in a site on or off.
fn locateDevices()
Start or stop the locate flash on specific devices — the physical
fn upgradeFirmware()
Start an online firmware upgrade on specific devices. The

Resources

controller(infinite)— Controller-wide rollup: version, site and device counts, client
site(infinite)— One managed site: its identity, device and client counts, and
device(infinite)— One access point, switch or gateway: identity, addressing,
client(infinite)— One connected client: identity, addressing, whether it is blocked
switchPort(infinite)— One physical switch port: its profile, admin and PoE state, and
wan(infinite)— One gateway WAN interface: addressing, DNS, connection mode, and
ssid(infinite)— One wireless network as configured: enablement, broadcast,
drift(infinite)— Configuration changes since the previous sync — devices and SSIDs
change(infinite)— Outcome of the most recent run of one mutating method: what was
03Stats
A
100 / 100
Downloads
0
Archive size
64.8 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels