AnPeAktor
Ein Schalter für das Internet der Dinge (IoT)
Die aktuelle Version dieses Dokumentes finden Sie online auf
http://iot.percher.eu
Sie erreichen den Entwickler unter
Der AnPeAktor übernimmt Schaltaufgaben im Internet der Dinge (IoT / Internet of Things).
Dazu verfügt er über einen potentialfreien Schaltausgang und zwei Schalteingänge, die mit je einem Taster verbunden, die Endstellungen des Tores signalisieren.
Zur Bedienung wird ein Android-fähiges Gerät benötigt, dass im lokalen WLan-Netzwerk eingebunden sein muss. Die Software ist kostenlos und kann auf beliebig vielen Geräten installiert werden.
Zur Zeit ist es noch nicht möglich die Verbindung mit HTTPS abzusichern. Daher sollte auf keinen Fall eine Portweiterleitung geschaltet werden, mit der der Aktor aus dem Internat erreichbar wird.
Notieren Sie hier die Zugangsdaten und Kennworte um diese für die Konfiguration griffbereit zu haben.
SSID (Netzwerkname) | AnPeAktor_ | SSID zur Anmeldung im AP-Modus |
Kennwort | app425768190 | Kennwort im Accesspointmode |
Konfigurationsmenü | http://192.168.4.1:27424 | Link zur Konfiguration im AP-Modus |
3) Gerätename | Name des Aktors | |
5) Basic Auth User | Username für Anmeldung Normalbetrieb | |
6) Basic Auth Passwort | Kennwort im Normalbetrieb | |
9) Startschlüssel | Vierstelliger Schlüssel für Datenverschlüsselung | |
11) Access Point Name | SSID des lokalen Netzwerks | |
12) Access Point Pwd | Passwort im lokalen Netzwerk | |
14/15) IP-Adresse | IP-Adresse des Aktors im Netzwerk |
Spannungsversorgung | Micro-USB Netzteil 5V |
Potentialfreier Schaltausgang | max 24V= oder 120V~ max 3A |
Schalteingang “Auf” und “Zu” | für den Anschluss eines Schalters |
Um den AnPeAktor zu konfigurieren und alle Systemeinstellungen anzupassen, gibt es zwei Möglichkeiten. Accesspointmode oder den Aufruf der Einstellungsseite.
Solange die Zugangsdaten zum lokalen Netzwerk nicht eingetragen (oder falsch) sind, startet der AnPeAktor immer im Accesspointmode.
Der AnPeAktor startet automatisch in den Accesspointmode, wenn er beim Neustart keine Verbindung zum Accesspoint hat bzw diese innerhalb des Verbindungstimeouts die Verbindung nicht etabliert werden kann.
Der Accesspointmode wird auch gestartet, wenn während des Bootvorgangs, wenn die LED schnell flackert der Konfigurationstaster auf der Steuerplatine gedrückt wird.
Im Accessointmode stellt der AnPeAktor einen Accesspoint mit folgenden Zugangsdaten bereit:
SSID (Netzwerkname) | AnPeAktor |
Kennwort | app425768190 |
Rufen Sie nach der Verbindung der folgende Adresse auf, um in das Konfigurationsmenü zu gelangen:
http://192.168.4.1:27424
Ist der AnPeAktor im lokalen Netzwerk eingebucht, kann durch Aufruf der Seite
http://<IP-Adresse des AnPeAktor>:27424/einstellungen
die Konfigurationsseite geöffnet werden.
AnPeAktor konfigurieren Info | ||
MAC-Adresse | XX:XX:XX:XX:XX:XX | MAC-Adresse des AnPeAktor |
IP-Adresse | xxx.xxx.xxx.xxx | aktuelle IP-Adresse des AnPeAktor |
Web Interface | ||
[X] Basic Auth verwenden zum Schalten | nicht abschalten da sonst ungesichert! | |
Basic Auth User | [Username_____] | Benutzername für den Zugriff (min 5 Zeichen) |
Basic Auth Pwd | [Kennwort______] | Kennwort für den Zugriff (min 5 Zeichen) |
Verhalten | ||
Modus | [Betriebsodus[v]] | Gargentor/Haustür/Scahlter |
[X ] Richtungsumkehr bei Start | siehe Garagentormodus | |
Startschlüssel(4-Stellig) | [4711_________] | Startwert zur Erzeugung des Verbindungschlüssels |
[_] Debug Modus | nur Einschalten für die erste Funktionsprüfung | |
Netzwerkverbindung mit Router | ||
Access Point Name | [SSID________] | Name Ihres WLAN-Netzwerks (2.4 GHz) |
Access Point Kennwort | [Kennwort_____] | Kennwort ins WLAN |
IP-Adresse beziehen | ||
[X] via DHCP | Bezieht die IP-Adresse per DHCP vom Router* | |
[_] feste IP-Adresse | [xxx.xxx.xxx.xxx] | Feste IP-Adresse |
Timeout Verbindung | [30________] | 30-300 Sekunden versuchen die Verbindung aufzub, |
*Wird DHCP als Verbindungsweg gewählt, muss im Router diese IP-Adresse an den Aktor gebunden werden. Bitte folgende Sie dafür den Anweisungen im Handbuch Ihres Routers.
[Speichern] Sie Ihr Einstellungen und starten Sie den AnPeAktor mit [Neustart]
Im Normalbetrieb stehen drei Betriebmodi zur Auswahl “Haustürmodus”, “Garagentormodus” oder “Schaltermodus”.
Im Debug Modus können die Befehle im Browser in der Form
http://<IP-Adresse des AnPeAktor>:27424/<befehl>
verwendet werden.
Der Debugmodus kann verwendet werden, um die Funktion nach dem Einbau zu prüfen.
Danach sollte dieser deaktiviert werden und die Steuerung erfolgt nur noch über die App.
Die Adresse
http://<IP-Adresse des AnPeAktor>:27424
zeigt die Startseite/Homepage mit der einigen Informationen zum System an:
Hallo, | |
Hier ist Dein XXXXXXXXXXX | Der eingetragene Name für den Aktor |
Aktueller Status: Zu. | Aktuelle Status im Tor-Modus |
MAC-Adresse: XX:XX:XX:XX:XX:XX | Die MAC-Adresse des Aktors |
Signalstärke: -XX dBm | Aktuelle Signalstärke |
Grafik mit der Signalqualität der letzten Minuten |
Die Seite - und damit die Signalstärke und die Grafik - werden alle 5 Sekunden aktualisiert.
Im Haustürmodus steht nur der Befehl oeffne zur Verfügung.
Mit jedem Aufruf wird das Relais einmal geschaltet.
Befehl | Funktion | Rückgabewerte | Bedeutung |
oeffne | Entriegelt die Tür | Entriegelt (Schalte) | Relais zieht an um die Tür zu entriegeln |
Im Garagentormodus stehen die folgenden Befehle zur Verfügung:
Befehl | Funktion | Rückgabewerte | Bedeutung |
status | Anzeige der Position des Tores, bzw der letzten Position, wenn keiner der beiden Schalter betätigt ist | Unbekannt | undefinierter Zustand nach Neustart. |
Zu | Tor ist geschlossen | ||
Oeffnet | Tor war geschlossen | ||
Auf | Tor ist offen | ||
Schliesst | Tor war offen | ||
auf | Öffnet das Tor, wenn es geschlossen ist | Status unbekannt => Nicht zu | undefinierter Zustand nach Neustart. |
Zu => Oeffnet (Schalte) | Tor wird geöffnet (Relais schaltet) | ||
Oeffnet => Nicht zu | Tor öffnet sich gerade | ||
Auf => Nicht zu | Tor ist auf | ||
zu | schließt das Tor, wenn es offen ist | Status unbekannt => Nicht auf | undefinierter Zustand nach Neustart. |
Auf => Schliesst (Schalte) | Tor wird geschlossen (R.schaltet) | ||
Schliesst => Nicht auf | Tor schließt sich gerade | ||
Zu => Nicht auf | Tor ist zu | ||
startstop | Startet oder Stop das Tor. | Status unbekannt => Status unbekannt (Schalte) | undefinierter Zustand nach Neustart |
Zu => Oeffnet (Schalte) | Tor wird geöffnet | ||
Oeffnet => Stop (Schalte) | Tor wird gestoppt | ||
Stop => Schliesst (Schalte) | Tor wird geschlossen | ||
Schliesst => Stop (Schalte) | Tor wird gestoppt | ||
Stop => Oeffnet (Schalte) | Tor wird geöffnet | ||
Auf => Schliesst (Schalte) | Tor wird geöffnet |
Im Schaltermodus stehen die folgenden Befehle zur Verfügung:
Befehl | Funktion | Rückgabewerte | Bedeutung |
status | Anzeige des Zustands des Relais | Unbekannt | undefinierter Zustand nach Neustart. |
An | Relaiskontakt ist geschlossen | ||
Aus | Relaiskontakt ist offen | ||
an | Schaltet das Relais an | An | Relaiskontakt ist geschlossen |
aus | Schaltet das Relais aus | Aus | Relaiskontakt ist offen |
um | Schaltet das Relais um | An | Relaiskontakt ist geschlossen |
Aus | Relaiskontakt ist offen |
Laden Sie die Steuersoftware “AnPeAktor” im Android Play Store mit dem QR-Code herunter oder suchen Sie nach AnPeAktor: Beim ersten Öffnen startet die Seite mit den Einstellungen, die Sie aus dem Hauptmenü mit dem Button [Einstellungen] erreichen. Tragen Sie die Daten aus der Webseite der AnPeAktor-Konfiguration hier ein. Die Nummern entsprechen den der Webseite. Im Garagentormodus wird in der Fußzeile der letzte gelesene Status angezeigt. |
Beim Klicken auf [Auf], [Zu] oder [Start/Stop] wird der Status für maximal 30 Sekunden automatisch aktualisiert, bis der Status die Position “Auf” oder “Zu” zeigt.
Garagentormodus | Türmodus | Einstellungen |
Die Software finden Sie zum Download auf meiner Projekt-Homepage:
http://iot.percher.eu/download/AnPeAktor.jar
Starten Sie die Anwendung mit einem Doppelklick auf die JAR-Datei. Sollten Sie einen Fehlermeldung erhalten, müssen Sie die aktuelle Version der Java Runtime-Umgebung (JRE) installieren.
Diese finden Sie direkt beim Hersteller hier:
https://www.java.com/de/download/
Unter Linux können Sie die JRE bequem mit apt-get installieren
sudo apt-get install default-jre
Beim ersten Start ist nur der Button “Einstellungen” anwählbar.
Tragen Sie dort bitte die gleichen Daten ein, die Sie auch im AnPeAktor eingetragen haben.
Je nach gewählte Funktion werden die entsprechenden Buttons klickbar bzw ausgegraut:
Garagentor | Haustür | Schalter |
1.0 | Initiale Version | Andreas Percher | 11.04.2016 |
1.1 | Android Software | Andreas Percher | 12.04.2016 |
1.2 | Signalqualität loggen | Andreas Percher | 17.04.2016 |
1.3 | AnPeAktor.jar | Andreas Percher | 20.04.2016 |
1.4 | Neue Oberfläche JAR | Andreas Percher | 23.04.2016 |
2.0 | Schaltfunktion | Andreas Percher | 26.10.2017 |
2.1 | Update AnPeAktor.jar | Andreas Percher | 27.10.2017 |
Andreas Percher 26.10.2017