TP-Link Omada Open API für Home Assistant (Marketplace-Integration)

Installationen: 194 teilen Analysedaten
GitHub-Sterne: 42
Verbindung: Nutzt die Cloud des Herstellers
Pflege: In den letzten 6 Monaten aktualisiert
Version: v1.11.1, 27. Oktober 2026
Kategorie: Computer und Netzwerk, Router und Netzwerk
Art: Marketplace-Integration
Marke: TP-Link
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: omada_open_api
Quelle: github.com/bullitt186/ha-omada-open-api
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

TP-Link Omada Open API überwacht und steuert Omada-SDN-Access-Points, Switches, Gateways und Clients aus Home Assistant. Es verbindet sich über die Omada Open API mit einem in der Cloud gehosteten oder lokalen Omada-Controller, und Fusion-Gateways melden sich stattdessen mit dem Benutzernamen und Passwort ihrer Weboberfläche an. Es fügt Sensoren, Binärsensoren, Geräte-Tracker, Tasten, Schalter und Firmware-Update-Entitäten hinzu. Die Schalter decken PoE, LED, SSID, Funkbänder und den Netzwerkzugang von Clients ab, und die Tasten decken Neustart, Orten, Wiederverbinden und einen Geschwindigkeitstest des Gateways ab. Die Anwesenheitserkennung von Clients kann nach SSID eingeschränkt werden, kann kabelgebundene Clients und Gast-Clients ein- oder ausschließen und hat einen optionalen Modus für automatische Erkennung. Optionale Sensoren sind unter anderem Bedrohungs-Heatmaps, die Überwachung von VPN-Tunneln und die Funkauslastung, und die Update-Intervalle lassen sich in den Optionen anpassen. Steuernde Entitäten benötigen Schreibrechte für die Open API, und kostenlose Cloud-Konten werden nicht unterstützt.

Zusammenfassung der README und des Codes von bullitt186/ha-omada-open-api, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren
Anwesenheit

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Controller-Typ auswählen

Controller-TypCloud-gehostet nutzt die TP-Link-Cloud; lokal verbindet sich direkt mit deinem Controller

Omada-API-Zugangsdaten

Omada IDMSP ID oder Customer ID aus deiner Open-API-Anwendung
Client IDOAuth2 Client ID aus deiner Open-API-Anwendung
Client SecretOAuth2 Client Secret aus deiner Open-API-Anwendung

Cloud-Region auswählen

RegionWähle die Cloud-Region, die zur Bereitstellung deines Omada-Controllers passt

URL des lokalen Controllers

Controller-URLVollständige URL mit Protokoll und Port
TLS-Zertifikat überprüfenLass die Option für gültige HTTPS-Zertifikate aktiviert. Deaktiviere sie, um dich mit einem Hardware-Controller (zum Beispiel OC200/OC300) zu verbinden, der das selbstsignierte Werkszertifikat verwendet.

Zugangsdaten des Fusion-Gateways

Gateway-URLVollständige URL mit Protokoll (zum Beispiel https://192.168.1.1)
BenutzernameBenutzername für die Anmeldung an der Weboberfläche
PasswortPasswort für die Anmeldung an der Weboberfläche

Standorte auswählen

Zu überwachende StandorteWähle einen oder mehrere Omada-Standorte aus, um Geräte und Clients zu überwachen

Clients nach SSID filtern (optional)

Nach SSID filtern (optional)Wähle SSIDs aus, um die Client-Liste einzuschränken. Kabelgebundene Clients werden immer angezeigt

Zu verfolgende Clients auswählen (optional)

Zu verfolgende ClientsWähle Netzwerk-Clients aus, für die Geräte-Tracker-Entitäten erstellt werden sollen

Nach der Einrichtung

Nach SSID filtern (optional)Wähle SSIDs aus, um die Client-Liste einzuschränken. Kabelgebundene Clients werden immer angezeigt
Zu verfolgende Clients
Zu verfolgende Anwendungen
Abfrageintervall für Geräte (Sekunden)
Abfrageintervall für Clients (Sekunden)
Abfrageintervall für Anwendungsverkehr (Sekunden)
Zeitlimit für Client-Trennung (Minuten)Auf 0 setzen für sofortige Erkennung der Trennung. Werte von 1 bis 60 halten das Gerät so viele Minuten als zu Hause markiert, nachdem es aus dem Netzwerk verschwunden ist.
Anwesenheits-Tracker für Clients automatisch erkennen (optional; standardmäßig aus)Standardmäßig aus. Aktiviere die Option, um pro aktivem Netzwerk-Client einen reinen Anwesenheits-Tracker zu erstellen; große Netzwerke können Hunderte erzeugen. Bereits verfolgte Clients behalten ihre Identität und ihre umfangreicheren Steuerungen.
Inaktive automatisch erkannte Clients nach dieser Anzahl von Tagen entfernenStandard ist 30 Tage. Auf 0 setzen, um automatisch erkannte Registry-Einträge dauerhaft zu behalten. Die Bereinigung entfernt nie manuell ausgewählte Clients oder Geräte, die noch andere Entitäten haben.
Nur diese WLAN-SSIDs (leer bedeutet alle)Optionale genaue SSID-Namen. Ohne Auswahl werden alle WLAN-SSIDs berücksichtigt.
Kabelgebundene Clients einbeziehenWenn deaktiviert, werden nur WLAN-Clients erkannt, die zur SSID-Auswahl passen.
Gast-Clients ausschließenVerhindert, dass Clients aus dem temporären Gastnetzwerk Registry-Einträge erzeugen.
Lokal administrierte oder private MAC-Adressen ausschließenLokal administrierte MACs stehen oft für private WLAN-Adressen. Lass die Option deaktiviert, wenn diese Geräte für die Anwesenheitserkennung nützlich sind.
Nur Clients mit Namen erkennenÜberspringt Clients, für die Omada nur eine MAC-Adresse und keinen Namen oder Hostnamen meldet.
Clients, die von der automatischen Erkennung ausgeschlossen werdenAusdrücklich ausgeschlossene MAC-Adressen bleiben ignoriert, wenn sie sich erneut verbinden.
WLAN-RSSI, SNR und Signalqualität bei vorhandenen Client-Trackern anzeigenStandardmäßig aktiviert. Zeigt den vom Controller gemeldeten RSSI (dBm), SNR (dB) und Signalpegel (%) als Attribute jedes vorhandenen Trackers an. SSID-Wechsel aktualisieren dasselbe Gerät; es werden keine eigenen Signalsensor-Entitäten erstellt.
Sensoren für die tägliche Bandbreite (Summen für Download/Upload)
Sensoren für die Client-Anzahl pro Gerät
Diagnosesensoren (CPU, Arbeitsspeicher, Betriebszeit, IP, Firmware)
Sensoren für die Funkauslastung (TX/RX/Störungen pro Band)
Bandbreitensensoren (heruntergeladen, hochgeladen, RX/TX-Aktivitätsrate)
Signalsensoren (RSSI, SNR, Signalstärke)
Schalter für Netzwerkzugriff (sperren/entsperren)
Taste zum erneuten Verbinden
Bedrohungs-Heatmap-Sensoren (täglich/wöchentlich/monatlich)
VPN-Überwachungssensoren (Tunnel und Peers)
WAN-Geschwindigkeitstest (Auslösetaste, Ergebnisse und Laufstatus)

Texte aus dem Code von bullitt186/ha-omada-open-api. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenStatus, Energiesparmodus, Verbunden, Internet, Geschwindigkeitstest läuft, WLAN-Optimierung läuft
TastenNeustarten, Erneut verbinden, WLAN-Optimierung, Orten, Geschwindigkeitstest starten
SensorenVerbundene Clients, Kabelgebundene Clients, Drahtlose Clients, Gast-Clients, Clients insgesamt, PoE-Verbrauch, Betriebszeit, CPU-Auslastung, Speicherauslastung, Gerätetyp, Tag, Uplink-Gerät und 69 weitere
SchalterPoE, Netzwerkzugriff, LED, Broadcast, SSID, 2,4-GHz-Funk, 5-GHz-Funk, 5-GHz-1-Funk, 5-GHz-2-Funk, 6-GHz-Funk
UpdatesFirmware

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Omada-API-Zugangsdaten haben nur Lesezugriff, Die Verfolgung des Anwendungsverkehrs erfordert ein Gateway