Pi-hole

Pi-hole (ab Version 6) über die REST-API in Symcon überwachen und steuern.

Stable 2.0Beta 2.01.478 Downloads114 in 30 Tagen

Privat kostenlos Gewerblich auf Anfrage Anfrage senden

Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 2.0 im Kanal Beta.

PiHole Network

Zeigt Netzwerkinformationen und DHCP-Leases des Pi-holes und verwaltet beides per Skript. Die Instanz braucht den PiHole Splitter und wird manuell angelegt. Die Kachel zeigt die Zahl der Geräte und DHCP-Leases sowie das Gateway.

Inhaltsverzeichnis

1. Konfiguration

FeldBeschreibung
AktualisierungsintervallAbstand in Sekunden, in dem die Daten gelesen werden. Standard ist 300, 0 schaltet die Abfrage ab.

2. Variablen

VariableIdentTypBeschreibung
Bekannte GeräteDeviceCountGanzzahlAnzahl der im Netzwerk gesehenen Geräte (höchstens 1000).
DHCP-LeasesLeaseCountGanzzahlAnzahl der DHCP-Leases.
GatewayGatewayTextIPv4-Adresse des Standardgateways.

3. Funktionen

Beim Aufruf aus Skripten müssen alle Parameter angegeben werden, Standardwerte gelten dort nicht. Übliche Werte: Gruppen [0], Aktiv true, Anzahl 10, Listentyp block, alle übrigen optionalen Parameter leer (''), 0 oder false. Alle Funktionen außer Update liefern die Antwort des Pi-holes als JSON-Text. Bei einem Fehler enthält die Antwort ein Objekt error.

void PIHNET_Update(integer $InstanzID); Liest Geräte, Leases und Gateway. Läuft automatisch im eingestellten Intervall.

string PIHNET_GetDevices(integer $InstanzID, integer $MaxDevices, integer $MaxAddresses); Im Netzwerk gesehene Geräte. 0 verwendet den Standard des Pi-holes.

string PIHNET_DeleteDevice(integer $InstanzID, integer $ID); Löscht ein Gerät anhand seiner Nummer aus der Netzwerktabelle.

string PIHNET_GetGateway(integer $InstanzID, boolean $Detailed); string PIHNET_GetRoutes(integer $InstanzID, boolean $Detailed); string PIHNET_GetInterfaces(integer $InstanzID, boolean $Detailed); Gateway, Routing-Tabelle und Netzwerkschnittstellen des Pi-holes.

string PIHNET_GetLeases(integer $InstanzID); Aktive DHCP-Leases.

string PIHNET_DeleteLease(integer $InstanzID, string $IP); Beendet das DHCP-Lease einer IP-Adresse.

4. Spenden

Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

PayPal Amazon Wunschzettel

5. Lizenz

CC BY-NC-SA 4.0