AnPeAktor

Ein Schalter für das Internet der Dinge (IoT)

Allgemeines

Hinweis

Kennworte und Zugänge

Technische Daten

Konfiguration

Accesspointmode

Aufruf der Einstellungsseite

Einstellungsseite

Normalbetrieb

Homepage

Haustürmodus

Garagentormodus

Steuersoftware

Die Android App AnPeAktor

Die Java App AnPeAktor.jar

Einrichten

Verwenden

Historie

Die aktuelle Version dieses Dokumentes finden Sie online auf

http://iot.percher.eu
Sie erreichen den Entwickler unter

iot@percher.eu


Allgemeines

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.

Hinweis

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.

Kennworte und Zugänge

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


Technische Daten

Spannungsversorgung

Micro-USB Netzteil 5V

Potentialfreier Schaltausgang

max 24V=  oder  120V~   max 3A

Schalteingang “Auf” und “Zu”

für den Anschluss eines Schalters


Konfiguration

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.

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


Aufruf der Einstellungsseite

Ist der AnPeAktor im lokalen Netzwerk eingebucht, kann durch Aufruf der Seite

http://<IP-Adresse des AnPeAktor>:27424/einstellungen

die Konfigurationsseite geöffnet werden.

Einstellungsseite

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]

Normalbetrieb

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.

Homepage

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.

Haustürmodus

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


Garagentormodus

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.
Das Relais wird immer betätigt!

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



Schaltmodus

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


Steuersoftware

Die Android App AnPeAktor

Laden Sie die Steuersoftware “AnPeAktor”  im Android Play Store mit dem QR-Code herunter oder suchen Sie nach AnPeAktor:
https://play.google.com/apps/testing/de.percher.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.

Vorschau Ihres QR Code

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 Java App AnPeAktor.jar

Die Software finden Sie zum Download auf meiner Projekt-Homepage:
http://iot.percher.eu/download/AnPeAktor.jar

Einrichten

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.

   


Verwenden

Je nach gewählte Funktion werden die entsprechenden Buttons klickbar bzw ausgegraut:

Garagentor

Haustür

Schalter

Historie

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