TP-Link Omada Open API voor Home Assistant (Marketplace-integratie)

Installaties: 194 die analysegegevens delen
GitHub-sterren: 42
Verbinding: Gebruikt de cloud van de aanbieder
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v1.11.1, 27 oktober 2026
Categorie: Computers en netwerk, Routers en netwerk
Soort: Marketplace-integratie
Merk: TP-Link
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: omada_open_api
Bron: github.com/bullitt186/ha-omada-open-api
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

TP-Link Omada Open API bewaakt en bedient Omada SDN-accesspoints, switches, gateways en clients vanuit Home Assistant. Het maakt verbinding met een in de cloud gehoste of lokale Omada-controller via de Omada Open API, en Fusion-gateways loggen in plaats daarvan in met de gebruikersnaam en het wachtwoord van hun webinterface. Het voegt sensoren, binaire sensoren, apparaattrackers, knoppen, schakelaars en firmware-updateentiteiten toe. De schakelaars betreffen PoE, LED, SSID, radiobanden en netwerktoegang voor clients, en de knoppen betreffen opnieuw opstarten, lokaliseren, opnieuw verbinden en een snelheidstest van de gateway. Aanwezigheidsdetectie van clients kan worden beperkt op SSID, kan bekabelde clients en gastclients wel of niet meenemen, en heeft een automatische ontdekkingsmodus die je zelf moet inschakelen. Optionele sensoren zijn onder andere dreigingsheatmaps, bewaking van VPN-tunnels en radiobenutting, en de update-intervallen zijn instelbaar in de opties. Voor bedieningsentiteiten zijn schrijfrechten voor de Open API nodig, en gratis cloudaccounts worden niet ondersteund.

Automatische samenvatting van de README en de code van bullitt186/ha-omada-open-api, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Gebruikt de cloud van de aanbieder Heeft een internetverbinding en een account bij de aanbieder nodig.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren
Aanwezigheid

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Controllertype selecteren

ControllertypeCloud-gehost gebruikt de TP-Link cloud; lokaal maakt rechtstreeks verbinding met je controller

Omada API-inloggegevens

Omada IDMSP ID of Customer ID van je Open API-toepassing
Client IDOAuth2 Client ID van je Open API-toepassing
Client SecretOAuth2 Client Secret van je Open API-toepassing

Cloudregio selecteren

RegioKies de cloudregio die overeenkomt met de implementatie van je Omada-controller

URL van lokale controller

Controller-URLVolledige URL inclusief protocol en poort
TLS-certificaat verifiërenLaat dit ingeschakeld voor geldige HTTPS-certificaten. Schakel het uit om verbinding te maken met een hardwarecontroller (bijvoorbeeld OC200/OC300) die het zelfondertekende fabriekscertificaat gebruikt.

Inloggegevens van Fusion-gateway

Gateway-URLVolledige URL inclusief protocol (bijvoorbeeld https://192.168.1.1)
GebruikersnaamGebruikersnaam voor inloggen op de webinterface
WachtwoordWachtwoord voor inloggen op de webinterface

Sites selecteren

Te bewaken sitesSelecteer een of meer Omada-sites om apparaten en clients te bewaken

Clients filteren op SSID (optioneel)

Filteren op SSID (optioneel)Selecteer SSID's om de clientlijst te beperken. Bekabelde clients worden altijd getoond

Te volgen clients selecteren (optioneel)

Te volgen clientsSelecteer netwerkclients waarvoor apparaattrackerentiteiten worden aangemaakt

Na het instellen

Filteren op SSID (optioneel)Selecteer SSID's om de clientlijst te beperken. Bekabelde clients worden altijd getoond
Te volgen clients
Te volgen toepassingen
Pollinginterval voor apparaten (seconden)
Pollinginterval voor clients (seconden)
Pollinginterval voor toepassingsverkeer (seconden)
Time-out voor verbreken van client (minuten)Stel in op 0 voor directe detectie van verbroken verbindingen. Waarden van 1 tot 60 houden het apparaat zo veel minuten als thuis gemarkeerd nadat het van het netwerk verdwijnt.
Aanwezigheidstrackers voor clients automatisch ontdekken (opt-in; standaard uit)Standaard uit. Schakel in om per actieve netwerkclient één tracker aan te maken die alleen aanwezigheid bijhoudt; grote netwerken kunnen honderden trackers aanmaken. Bestaande gevolgde clients behouden hun identiteit en uitgebreidere bediening.
Inactieve automatisch ontdekte clients verwijderen na dit aantal dagenStandaard 30 dagen. Stel in op 0 om automatisch ontdekte registervermeldingen voor altijd te bewaren. Het opruimen verwijdert nooit handmatig geselecteerde clients of apparaten die nog andere entiteiten hebben.
Alleen deze draadloze SSID's (leeg betekent alle)Optionele exacte SSID-namen. Een lege selectie omvat alle draadloze SSID's.
Bekabelde clients meenemenIndien uitgeschakeld worden alleen draadloze clients ontdekt die overeenkomen met de SSID-selectie.
Gastclients uitsluitenVoorkomt dat clients van tijdelijke gastnetwerken registervermeldingen aanmaken.
Lokaal beheerde of privé-MAC-adressen uitsluitenLokaal beheerde MAC-adressen zijn vaak privé-wifiadressen. Laat dit uitgeschakeld als die apparaten nuttig zijn voor aanwezigheidsdetectie.
Alleen clients met een naam ontdekkenSla clients over waarvoor Omada alleen een MAC-adres meldt en geen naam of hostnaam.
Clients die van automatische ontdekking worden uitgeslotenExpliciet uitgesloten MAC-adressen blijven genegeerd als ze opnieuw verbinding maken.
Wifi-RSSI, SNR en signaalkwaliteit tonen bij bestaande clienttrackersStandaard ingeschakeld. Toont de door de controller gemelde RSSI (dBm), SNR (dB) en het signaalniveau (%) als attributen van elke bestaande tracker. Wijzigingen van de SSID werken hetzelfde apparaat bij; er worden geen aparte signaalsensorentiteiten aangemaakt.
Dagelijkse bandbreedtesensoren (totalen voor download/upload)
Sensoren voor aantal clients per apparaat
Diagnosesensoren (CPU, geheugen, uptime, IP, firmware)
Sensoren voor radiobenutting (TX/RX/interferentie per band)
Bandbreedtesensoren (gedownload, geüpload, RX/TX-activiteitssnelheid)
Signaalsensoren (RSSI, SNR, signaalsterkte)
Schakelaar voor netwerktoegang (blokkeren/deblokkeren)
Knop Opnieuw verbinden
Sensoren voor dreigingsheatmap (dagelijks/wekelijks/maandelijks)
VPN-monitoringsensoren (tunnels en peers)
WAN-snelheidstest (starttknop, resultaten en actieve status)

Teksten uit de code van bullitt186/ha-omada-open-api. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenStatus, Energiebesparing, Verbonden, Internet, Snelheidstest actief, WLAN-optimalisatie actief
KnoppenHerstarten, Opnieuw verbinden, WLAN-optimalisatie, Lokaliseren, Snelheidstest uitvoeren
SensorenVerbonden clients, Bedrade clients, Draadloze clients, Gastclients, Totaal aantal clients, PoE-verbruik, Uptime, CPU-belasting, Geheugengebruik, Apparaattype, Tag, Uplink-apparaat en nog 69
SchakelaarsPoE, Netwerktoegang, LED, Broadcast, SSID, 2,4 GHz-radio, 5 GHz-radio, 5 GHz-1-radio, 5 GHz-2-radio, 6 GHz-radio
UpdatesFirmware

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Omada API-inloggegevens hebben alleen leestoegang, Het bijhouden van applicatieverkeer vereist een gateway