Überblick
Cudy Router ist eine Integration, die Home Assistant mit Cudy-Routern mit einer LuCI-basierten Weboberfläche verbindet. Sie fragt den Router lokal ab und macht aus seinen Statusseiten Sensoren für Modem, WAN, LAN, DHCP, VPN, WLAN, SMS und Datenverkehr, je nach Modell und Firmware. Außerdem fügt sie eine Reboot-Taste, einen LED-Schalter, Auswahlen für beschreibbare Router-Einstellungen sowie Aktionen zum Senden von SMS, zum Senden von AT-Befehlen, zum Neustarten der 5G-Verbindung und zum Wechseln des 5G-Bands hinzu. Mesh-Knoten erscheinen als separate Geräte, und verbundene Clients können automatisch hinzugefügt oder aus einer Liste ausgewählt werden, optional mit Geräte-Trackern. Router mit SMS-Unterstützung erhalten außerdem ein Seitenleisten-Panel zum Lesen und Verfassen von Nachrichten, das in den Optionen ausgeblendet werden kann. Die Einrichtung erfolgt in der Oberfläche mit Routeradresse, Benutzername und Passwort.
Zusammenfassung der README und des Codes von usersaynoso/ha-cudy-router, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
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.
Neuen Router hinzufügen
- IP-Adresse des RoutersDie IP-Adresse deines Routers (z. B. 192.168.10.1)
- Passwort
- Benutzername
Erneut mit Cudy Router verbinden
- Passwort
- Benutzername
Nach der Einrichtung
- Verbundene Geräte automatisch hinzufügenErstellt Client-Geräte und Live-Client-Entitäten für jedes aktuell verbundene Gerät. Bei neuen Integrationen standardmäßig deaktiviert. Schalte dies ein, um Client-Geräte und Live-Entitäten pro Client automatisch zu erstellen, oder lass es aus, um sie nur für die unten aufgeführten Geräte zu erstellen.
- Geräte-Tracker für verbundene Geräte automatisch hinzufügenErstellt device_tracker-Entitäten für jedes aktuell verbundene Gerät mit einer MAC-Adresse. Standardmäßig deaktiviert. Schalte dies ein, wenn du zusätzlich zu den Live-Client-Entitäten Anwesenheits-Tracker möchtest.
- Cudy SMS in der Seitenleiste anzeigenZeigt den Link zum Cudy-SMS-Panel in der Seitenleiste von Home Assistant an. Deaktiviere dies, wenn die SMS-Seite nur über die direkte URL erreichbar sein soll.
- Update-IntervallWie oft der Router auf Updates abgefragt wird (in Sekunden)
- Verbundene Geräte manuell hinzufügenWähle verbundene Clients aus einer Liste aus, wenn die automatische Erkennung verbundener Geräte ausgeschaltet ist. Ausgewählte manuelle Geräte bleiben in Home Assistant erhalten, wenn sie offline sind, und sind nicht verfügbar, bis der Client sich wieder verbindet. Ältere textbasierte Werte werden weiterhin berücksichtigt, bis du diese Auswahl speicherst.
- Verfolgte GeräteWähle bestimmte verbundene Clients aus, die immer eine device_tracker-Entität behalten sollen. Wenn die automatische Erkennung verbundener Geräte aus ist, zeigt diese Auswahl die im vorherigen Schritt ausgewählten manuell verbundenen Geräte oder alle live verbundenen Clients, wenn keine manuell verbundenen Geräte ausgewählt sind. Ausgewählte Tracker bleiben über Neustarts hinweg verfügbar und zeigen away/not_home, wenn der Client offline ist.
Texte aus dem Code von usersaynoso/ha-cudy-router. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- TastenNeustart
- SensorenMesh-Geräte, Name, Modell, MAC-Adresse, Firmware, Status, IP-Adresse
- SchalterLED
Aktionen
- Router neu startenStartet den Cudy-Router neu.Felder: Config-Entry-ID
- 5G-Verbindung neu startenStartet die 5G-Modemverbindung neu, indem ein Modem-Reset ausgelöst wird.Felder: Config-Entry-ID
- 5G-Band wechselnÄndert die 5G-Band-Einstellung am Router.Felder: Config-Entry-ID, Band
- SMS sendenSendet eine SMS über das Mobilfunkmodem des Routers.Felder: Config-Entry-ID, Telefonnummer, Nachricht
- AT-Befehl sendenSendet einen rohen AT-Befehl an das Mobilfunkmodem des Routers.Felder: Config-Entry-ID, Befehl
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Aus der README
cudy_router is a community-built Home Assistant integration for Cudy routers that expose a LuCI-based web interface.
It connects directly to the router over your local network, reads the same status and configuration pages you see in the browser, and turns them into Home Assistant entities, devices, and services.
- Local polling integration with Home Assistant config flow and options flow.
- Router-wide sensors for modem/cellular, WAN, LAN, DHCP, VPN, load balancing, Wi-Fi, SMS, traffic, and system status, including CPU/RAM usage when the router reports it.
- Writable router settings exposed as Home Assistant switch and select entities when the router supports them.
- WISP uplink scan and connect on supported models: a WISP scan button, a WISP network picker, a write-only WISP password field, and a WISP connect button.
- Reboot buttons and services for SMS, AT commands, 5G connection restart, and band switching.
- Mesh node support with separate Home Assistant devices, per-node LED control, and per-node reboot.
- Connected client devices, per-client controls, and optional device_tracker entities.
- Automatic config entry migration from older versions.
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 169 teilen Analysedaten
- GitHub-Sterne
- 17
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.3.38,
- Kategorie
- Computer und Netzwerk, Router und Netzwerk
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
cudy_router- Probleme
- Problem melden
