Skip to content

Latest commit

 

History

History
146 lines (84 loc) · 7 KB

README.md

File metadata and controls

146 lines (84 loc) · 7 KB

DHCPSniffer (Network)

Modul für IP-Symcon ab Version 4.3 ermöglicht es auf Events von Geräten zu reagieren, die eine Anfrage ins Netzwerk per DHCP oder dem Bootstrap Protocol stellen. So lässt sich zum Beispiel auf das Drücken eines Dashbuttons (siehe Anhang) reagieren oder auf das Anmelden eines Geräts, wie ein Smartphone, in einem LAN.

Dokumentation

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Einrichten der Instanz in IP-Symcon
  5. PHP-Befehlsreferenz
  6. Parameter / Modul-Infos
  7. Anhang
  8. Lizenz

1. Funktionsumfang

Viele Geräte besitzen keine feste IP Adresse, sondern erfragen diese im LAN an z.B. über das Bootstrap Protocol oder über DHCP (Dynamic Host Configuration Protocol).
Dabei senden diese Geräte eine Anfrage in das Netzwerk und warten dann auf die Zuweisung einer IP Adresse durch einen Server.
Dieses Modul registriert solche Anfragen von Geräten auf Basis deren MAC-Adresse und kann dann ein Event in IP-Symcon auslösen.
Auf diese Weise ist es z.B. möglich auf das Drücken eine Dashbuttons zu reagieren oder das Einbuchen eines Smartphones in ein WLAN.

2. Voraussetzungen

  • IPS 4.3
  • Das Gerät, das ein Event in IP-Symcon auslösen soll, bezieht die IP Adresse dynamisch per DHCP oder Bootstrap (z.B. Dashbutton, Smartphone)

3. Installation

Die IP-Symcon (min Ver. 4.3) Konsole öffnen. Im Objektbaum unter Kerninstanzen die Instanz Modules durch einen doppelten Mausklick öffnen.

Modules

In der Modules Instanz rechts oben auf den Button Hinzufügen drücken.

Modules

In dem sich öffnenden Fenster folgende URL hinzufügen:

Modules

`https://github.com/Nall-chan/Network`  

und mit OK bestätigen.

Anschließend erscheint ein Eintrag für das Modul in der Liste der Instanz Modules

4. Einrichten der Instanzen in IP-Symcon

In IP-Symcon wird von jedes Gerät das ein Event auslösen soll eine seperate Instanz angelegt. Der Mulicast Socket wird automatisch mit angelegt. Um die Instanz zu erstellen wechseln wir in die Kategorie, unter der wir die Instanz platzieren wollen und erstellen mit CTRL+1 eine neue Instanz. Bei Gerät geben wir DHCP Sniffer an. Bei Protocoll wählen wir das Protokoll aus, bei einem Dashbutton z.B. DHCP & Bootp. Unter MAC Adress wird die MAC Adresse des Geräts eingetragen.

5. PHP-Befehlsreferenz

(Keine PHP Funktionen)

Dashbutton

Keine gesonderte Funktion, die Variable wird geändert sobald eine Anfrage vom Gerät mit der passenden MAC gestellt wird. Auf die Variable kann dann ein Ereigniss gelegt werden, dass bei Variablenänderung eine beliebige Aktion in IP-Symcon ausführt.

6. Parameter / Modul-Infos

GUID des Modules (z.B. wenn Instanz per PHP angelegt werden soll):

Instanz GUID
DHCP Sniffer {E93BCE5E-BA95-424E-8C3A-BF6AEE6CB976}

Eigenschaften des 'DHCP Sniffer' für Get/SetProperty-Befehle:

Eigenschaft Typ Standardwert Funktion
Protocol integer Auswahl des Protokolls
Address string MAC Adresse des Geräts das ein Event in IP-Symcon auslösen soll
Action integer Art der Aktion, die ausgeführt werden soll

7. Anhang

Nutzung eines Dashbutton in IPS

Zuerst muss der Dash Button mit der dazu gehörigen Amazon App von Amazon einrichtet werden. In der Amazon App auf das Menü drücken

Setup1

Mein Konto auswählen

Setup2

Bei Dash-Geräte auf Ein neues Gerät einrichten drücken

Setup3

im Anschluss den Anweisungen im Bildschirm der App folgen bzw. der Anleitung von Amazon Einrichtung des Dashbuttons folgen.

Wenn in einer Fritzbox eine Mitteilung eingerichtet ist bekommt man nun eine Email geschickt.

FritzboxMessage

Die MAC Adresse notieren wir hier um diese dann später in IP-Symcon im Modul eintragen zu können. Man kann auch noch in der Fritzbox bzw. den verwendeten DHCP Server so Einrichten, das stets die gleiche IP Adresse an den Dash Button vergeben wird. Falls keine Mitteilung in Fritzbox oder einen anderen Router eingerichtet wurde, muss man im DHCP Server bzw. der Fritzbox nachschauen welches Gerät zuletzt eine neue IP Adresse zugewiesen bekommen hat. Dies ist dann der Dashbutton, hier ist die MAC Adresse zu notieren, diese brauchen wir für IP-Symcon.

Jedes mal wenn der Dash Button gedrückt wird nun zur Zeit eine Bestellung ausgeführt. Wir können dann in IP-Symcon nachvollziehen wann eine Bestellung gesendet wurde indem wir die Variable loggen. Wenn wir den Dash Button nicht für eine Bestellung benutzten wollen, sondern damit z.B. eine Lampe schalten wollen, müssen wir den Zugang des Dash Buttons zum Internet sperren, damit der Dashbutton nicht bei jedem Druck einen Artikel bestellt.

Siehe auch Internetnutzung in der Fritzbox einschränken.

Dazu kann man den Zugang der MAC bzw. IP-Adresse zum Internet im Router sperren.

In einer Fritzbox wechseln wir hierzu auf

FritzboxMenu

Dort wählen wir nun die passende IP Adresse aus und setzten diese auf Gesperrt

FritzboxGesperrt1

FritzboxGesperrt

Nun sollte bei einem Druck auf den Knopf die Leuchte erst ein paar Mal weiß und dann ein paar Mal rot leuchten, ist dies der Fall so sendet der Dash Button eine Anfrage in das LAN, eine Internet Verbindung wird aber keine aufgebaut und daher auch nichts bestellt.

Die notierte MAC-Adresse wird nun unter MAC Adresse in der DHCPSniffer Instanz eingetragen.

Changlog

Version 1.0:

  • Erstes offizielles Release

8. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0