MaHo Labs: 2N Sprechanlage

Was ist der 2N Sprechanlagen-Baustein?

Hauptfunktionen

Teil 1: Einrichtung der 2N Sprechanlage

Bevor der Baustein Daten empfangen kann, müssen auf der 2N einige Einstellungen vorgenommen werden. Alle Einstellungen erfolgen im Web-Interface der 2N (Aufruf über http://<2N-IP> im Browser).

1.1 HTTP API aktivieren

1. Web-Interface öffnen
   Rufen Sie im Browser die IP-Adresse Ihrer 2N auf und melden Sie sich als Administrator an.
2. Zu den Services wechseln
   Navigieren Sie zu Dienste → HTTP API.
3. HTTP API einschalten
   Aktivieren Sie den Dienst. Stellen Sie die Verbindungssicherheit auf TLS und unverschlüsselt (oder unverschlüsselt), damit der Baustein per HTTP zugreifen kann.
4. Dienste einzeln freigeben
   Aktivieren Sie in der Tabelle die benötigten API-Bereiche: System, Switch, I/O, Logging, Call und (falls genutzt) Display. Setzen Sie die Berechtigung jeweils auf Vollständig oder mindestens Überwachung + Steuerung.

1.2 API-Benutzer anlegen

1. Benutzerverwaltung öffnen
   Navigieren Sie zu Dienste → HTTP API → Konten (Account).
2. Neues Konto erstellen
   Legen Sie einen Benutzernamen und ein Passwort an. Diese Daten tragen Sie später im Baustein ein.
3. Rechte zuweisen
   Geben Sie dem Konto Zugriff auf dieselben API-Bereiche, die Sie in Schritt 1.1 aktiviert haben.

1.3 Türrelais (Switch) prüfen

Zum Öffnen der Tür steuert der Baustein einen Switch der 2N. Unter Hardware → Schalter sehen Sie die vorhandenen Switches (meist Switch 1 für den Türöffner). Die Nummer tragen Sie im Baustein-Parameter Switch-Nummer ein.

1.4 Türkontakt-Sensor zuweisen (optional)

Wenn Sie einen Türkontakt (Magnetsensor) an einen digitalen Eingang der 2N angeschlossen haben, weisen Sie diesen unter Hardware → Türen → Türsensor dem entsprechenden Eingang zu. Erst dann sendet die 2N die Events für Tür offen, Tür zu lange offen und unbefugtes Öffnen. Die Zeit für „zu lange offen" stellen Sie ebenfalls dort ein.

1.5 HTTP Listener einrichten (optional, Gold-Lizenz)

Für sofortige Push-Benachrichtigungen ohne Polling-Verzögerung nutzt die 2N die Automation. Diese benötigt die Gold-Lizenz.

1. Automation öffnen
   Navigieren Sie zu Hardware → Automation (oder Dienste → Automation).
2. Neue Regel erstellen
   Wählen Sie als Auslöser z.B. Event.SwitchStateChanged oder Event.KeyPressed.
3. HTTP-Aktion hinzufügen
   Fügen Sie die Aktion Action.HttpRequest hinzu mit der Ziel-URL: http://<X1-IP>:8080/tuer?open=1. Der Pfad und die Parameter sind frei wählbar und erscheinen im Baustein an den Listener-Ausgängen.

Teil 2: Feature-Schalter im Baustein

Jede Funktion wird über einen eigenen Bool-Parameter aktiviert. Beim Umschalten erscheinen oder verschwinden die zugehörigen Ports automatisch. So bleibt der Baustein übersichtlich.

Schalter	Standard	Aktivierte Ports
Klingel aktivieren	Ein	Klingel, Klingel-Taste, Letzte Taste
Türsteuerung aktivieren	Aus	Eingang Tür, Ausgang Tür-Status
Anrufe aktivieren	Aus	Anruf aktiv/wählt/klingelt/verbunden/beendet, Anruf-Status, -Richtung, -Gegenstelle
Codeschloss aktivieren	Aus	Letzter Code, Zutritt Code gewährt/verweigert
RFID-Kartenleser aktivieren	Aus	Letzte Karte, Zutritt RFID gewährt/verweigert
Zutritt/Nutzer aktivieren	Aus	Letzter Nutzer, Zutrittsmethode
Bewegungserkennung aktivieren	Aus	Bewegung erkannt
Sabotagekontakt aktivieren	Aus	Sabotage
Display aktivieren	Aus	Eingang Display-Text
I/O Erweiterung aktivieren	Aus	I/O Port-Name, I/O Einschalten/Ausschalten, I/O Status
Türkontakt aktivieren	Aus	Tür offen, Tür zu lange offen, Unbefugtes Öffnen
HTTP Listener aktivieren	Aus	Listener Trigger, Listener URL, Listener Parameter

Teil 3: Verbindungsparameter

Parameter	Beschreibung
IP-Adresse	IP-Adresse der 2N im lokalen Netzwerk (z.B. 192.168.1.100)
Port	HTTP-Port der 2N API (Standard: 80)
Benutzername	API-Benutzername aus Schritt 1.2
Passwort	API-Passwort aus Schritt 1.2
Abfrageintervall (Sekunden)	Wie oft die 2N nach neuen Events gefragt wird (Standard: 2). Für schnellere Reaktion auf 1 setzen.
Switch-Nummer (Türrelais)	Welches Türrelais der 2N über den Tür-Eingang gesteuert wird (Standard: 1)
Impulsdauer (Sekunden)	Wie lange die Impuls-Ausgänge (Klingel, Zutritt gewährt/verweigert usw.) auf true bleiben (Standard: 1)
Klingeltasten	Kommagetrennte Liste der Tasten, die als Klingeln gewertet werden (Standard: %1,%2,%3,%4,%5,%6). Siehe Abschnitt „Klingeln vs. Keypad".
Listener Port	Port des HTTP Listeners (Standard: 8080), nur bei aktiviertem Listener relevant

Teil 4: Eingänge

Eingang	Beschreibung
Tür	Steuert das Türrelais: eine steigende Flanke (true) öffnet, false schließt. Nur bei aktivierter Türsteuerung sichtbar.
Display-Text	Der übergebene Text wird auf dem Display der 2N angezeigt. Nur bei aktiviertem Display sichtbar.
I/O Port-Name	Name des zu schaltenden 2N-Ausgangs (z.B. relay1). Nur bei aktivierter I/O Erweiterung.
I/O Einschalten	Schaltet den unter I/O Port-Name genannten Ausgang ein.
I/O Ausschalten	Schaltet den Ausgang aus.
Lizenzschlüssel	Gerätegebundener Lizenzschlüssel. Nach Ablauf des Testzeitraums erforderlich. Siehe Abschnitt „Lizenzierung".
Ein / Aus	Globaler Schalter für das Polling. Bei false werden keine Abfragen gesendet. Standard true, standardmäßig ausgeblendet.

Teil 5: Ausgänge

Allgemein (immer sichtbar)

Ausgang	Beschreibung
Klartext	Lesbare Beschreibung des letzten Ereignisses, z.B. „Zutritt: Marcus (Bluetooth)" oder „Klingel: Taste 1"
Letzter Event	Technischer Name des letzten Events (z.B. CodeEntered, KeyPressed)
Letzter Event-Zeit	Zeitstempel des letzten Events (dd.MM.yyyy HH:mm:ss)

Klingel

Ausgang	Beschreibung
Klingel	Impuls, wenn über eine echte Klingeltaste geklingelt wird. Dauer über Parameter „Impulsdauer".
Klingel-Taste	Nummer der gedrückten Klingeltaste (bereinigt, z.B. „1" bei mehreren Parteien)
Letzte Taste	Jede am Keypad gedrückte Taste im Rohformat (z.B. %1, „B", „1"). Auch Nicht-Klingeltasten.

Türsteuerung & Türkontakt

Ausgang	Beschreibung
Tür-Status	Zustand des Türrelais (true = geschaltet/offen)
Tür offen	Zustand des Türkontakts (true = Tür physisch offen). Nur bei aktiviertem Türkontakt.
Tür zu lange offen	Zustand: Tür überschreitet die in der 2N eingestellte Offenzeit
Unbefugtes Öffnen	Impuls: Tür wurde ohne Freigabe geöffnet (aufgebrochen)

Anrufe

Ausgang	Beschreibung
Anruf aktiv	Sammelmeldung: true während der gesamte Anruf läuft (wählt, klingelt oder verbunden)
Anruf wählt	Verbindungsaufbau läuft
Anruf klingelt	Es klingelt bei der Gegenstelle
Anruf verbunden	Gespräch läuft, jemand hat abgenommen
Anruf beendet	Anruf wurde aufgelegt/beendet
Anruf-Status	Klartext: „Wählt" / „Klingelt" / „Verbunden" / „Beendet"
Anruf-Richtung	„Ausgehend" (jemand klingelt an der Tür) oder „Eingehend" (jemand ruft die 2N an)
Anruf-Gegenstelle	SIP-Adresse/Nummer des Gesprächspartners

Zutritt: Codeschloss, RFID, Nutzer

Ausgang	Beschreibung
Letzter Code	Der zuletzt eingegebene Zahlencode
Zutritt Code gewährt	Impuls: gültiger Code eingegeben
Zutritt Code verweigert	Impuls: ungültiger Code eingegeben
Letzte Karte	UID der zuletzt aufgelegten RFID-Karte
Zutritt RFID gewährt	Impuls: gültige Karte aufgelegt
Zutritt RFID verweigert	Impuls: ungültige Karte aufgelegt
Letzter Nutzer	Name des zutretenden Nutzers (aus der 2N-Benutzerverwaltung), auch bei Bluetooth
Zutrittsmethode	„Code", „RFID", „Bluetooth" oder „Fingerprint"

Weitere

Ausgang	Beschreibung
Bewegung erkannt	Zustand: Kamera erkennt Bewegung
Sabotage	Zustand: Gehäuse-Sabotagekontakt ausgelöst
I/O Status	Zustand des zuletzt geschalteten I/O-Ausgangs
Listener Trigger	Impuls: HTTP-Request am Listener eingegangen
Listener URL	Pfad des eingegangenen Requests (z.B. /tuer)
Listener Parameter	Query-Parameter des Requests (z.B. ?open=1)

System & Lizenz

Ausgang	Beschreibung
Online	true wenn die 2N erreichbar ist und Events empfangen werden
Gerätetyp	Modellbezeichnung der 2N (z.B. 2N IP Verso 2.0)
Fehlercode	0 = OK, 994 = Listener-Fehler, 998 = Verbindungsfehler, 999 = allgemeiner Fehler
Fehlermeldung	Detaillierte Fehlerbeschreibung im Fehlerfall
Lizenz gültig	true bei gültiger Lizenz oder während des Testzeitraums
MAC-Adresse	MAC des Gira X1 – wird für die Lizenzanforderung benötigt
Lizenz-Status	Klartext-Status der Lizenz

Teil 6: Klingeln vs. Keypad verstehen

Die 2N sendet bei jedem Tastendruck am Keypad ein Ereignis. Der Baustein unterscheidet dabei zwei Fälle:

• Echte Klingeltasten – die Ruftasten der 2N melden sich mit Codes wie %1, %2 usw. (eine pro Partei). Diese lösen den Klingel-Impuls aus.
• Normale Keypad-Tasten – Ziffern und Funktionstasten (z.B. „B" beim Bluetooth-Zutritt) erscheinen nur an Letzte Taste, lösen aber kein Klingeln aus.

Über den Parameter Klingeltasten legen Sie fest, welche Tastencodes als Klingeln zählen. Standard ist %1,%2,%3,%4,%5,%6.

Teil 7: Anwendungsbeispiele

Teil 8: Lizenzierung

So aktivieren Sie den Baustein dauerhaft:

1. MAC-Adresse ablesen
   Am Ausgang „MAC-Adresse" wird die Geräte-Adresse angezeigt (z.B. 00:0A:B3:31:00:F8).
2. Lizenz anfordern
   Übermitteln Sie die MAC-Adresse an MaHo Labs per E-Mail an labs@maho-elektrotechnik.de.
3. Schlüssel eintragen
   Tragen Sie den erhaltenen Schlüssel am Eingang „Lizenzschlüssel" ein.

Teil 9: Fehlerbehebung

Problem	Mögliche Ursache	Lösung
Online bleibt false	2N nicht erreichbar oder falsche IP	IP-Adresse und Netzwerk prüfen. http://<2N-IP>/api/system/info im Browser testen
Fehlercode 998, „Log-Subscribe fehlgeschlagen"	HTTP API nicht aktiviert, falscher Benutzer oder Logging-Dienst gesperrt	Dienste → HTTP API prüfen, Logging-Bereich freigeben, Benutzer/Passwort kontrollieren
Klingel reagiert nicht	Klingeltaste nicht in der Liste	Parameter „Klingeltasten" prüfen. Am Ausgang „Letzte Taste" sehen, welcher Code beim Klingeln kommt, und eintragen
Klingel löst bei Keypad/Bluetooth aus	Zu viele Tasten in „Klingeltasten"	Nur echte Klingeltasten (%1 usw.) eintragen, keine Ziffern
Tür öffnen funktioniert nicht	Falsche Switch-Nummer oder Türsteuerung aus	Switch-Nummer unter Hardware → Schalter prüfen, Türsteuerung aktivieren
Zutrittsmethode zeigt „Unbekannt"	Credential-Event kam nicht kurz vor der Anmeldung	Normal bei manchen Zutrittsarten. Name wird trotzdem angezeigt.
Anruf-Ausgänge bleiben false	Anrufe-Feature nicht aktiviert oder Call-Dienst gesperrt	„Anrufe aktivieren" einschalten, Call-Bereich in der HTTP API freigeben
Tür offen kommt nicht	Türsensor in der 2N nicht zugewiesen	Hardware → Türen → Türsensor dem richtigen Eingang zuweisen
Fehlercode 994, Listener startet nicht	Port belegt oder keine Berechtigung	Anderen Listener Port wählen (z.B. 8081)
Events kommen verzögert	Abfrageintervall zu groß	Abfrageintervall auf 1 Sekunde reduzieren
Ports fehlen im GPA	Feature-Schalter nicht aktiviert	Den zugehörigen Schalter einschalten, Ports erscheinen automatisch
Lizenz-Status „Testzeitraum abgelaufen"	12-h-Test vorbei, keine Lizenz	Gültigen Lizenzschlüssel eintragen