Geräteprofil · Türsprechstellen

Akuvox IP-Türsprechstelle

Hinweis: Dieses Profil beruht auf dem Akuvox HTTP API Manual (Stand 10.06.2022), das Akuvox für die R29-Serie veröffentlicht; andere Türstationen von Akuvox sprechen dieselbe Schnittstelle unter Intercom → HTTP API.

Voraussetzungen

1. Eine Akuvox-Türsprechstelle mit HTTP-API (dokumentiert für R29; R20, E12, X915 und weitere nutzen dieselben Pfade).
2. In der Weboberfläche unter Intercom → HTTP API (bei manchen Modellen Setting → HTTP API):
   • HTTP API: Enabled — ist sie aus, antwortet das Gerät auf jede Anfrage mit 403 Forbidden
   • Auth Mode: Basic ⚠️ wichtig, siehe Hinweise. Alternativ WhiteList mit der IP-Adresse des nomos Controllers
   • User Name und Password notieren (ab Werk admin / httpapi)
3. Die Türstation braucht eine feste IP-Adresse.

Einrichtung

1. Der Türstation im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen, IP-Adresse eintragen, dazu Benutzername und Passwort der HTTP-API. Der Port ist 80 und lässt sich ändern.

Datenbereich

Abgefragt werden der Gesprächszustand alle 3 Sekunden, die Eingänge alle 5, die Relais alle 10 und die Geräteinformationen stündlich. Alle Intervalle außer dem letzten lassen sich ändern.

• Klingel (doorbell) und Gespräch aktiv (active) — beide aus dem Gesprächszustand, siehe Hinweise
• Status (status): das Wort, das die Station selbst meldet, z. B. READY
• Relais A/B/C (relay1–relay3): ob der Kontakt gerade geschlossen ist
• Eingänge A/B/C (input1–input3): Zustand der Eingangsklemmen, z. B. Türkontakt oder Austrittstaster
• Modell, Firmware, MAC-Adresse und ob SIP-Konto 1 registriert ist (ausgeblendet)
• Erreichbar (reachable)

Schreibbar ist das Türöffnen über Relais A, B oder C.

Hinweise

• nomos kann sich nur mit Basic anmelden. Lesebefehle gehen als HTTP-GET, und auf diesem Weg beherrscht der nomos Daemon ausschließlich das Basic-Verfahren. Stellt man am Gerät Digest ein, bleiben alle Werte leer. Wer kein Passwort über die Leitung schicken will, nimmt WhiteList und trägt dort die IP-Adresse des Controllers ein — dann ist gar keine Anmeldung nötig. (Akuvox weist darauf hin, dass Normal und Token nur für eigene Entwicklungen gedacht sind.)
• Die Klingel ist abgeleitet, nicht gemeldet. Die Schnittstelle kennt nur /api/call/status mit einem Wort wie READY. nomos wertet alles außer READY als „es läuft ein Gespräch” und meldet das als Klingel. Zwei Folgen davon: ein sehr kurzer Klingelruf kann zwischen zwei Abfragen (3 Sekunden) durchrutschen, und ein eingehender Anruf an die Türstation sieht genauso aus wie ein Klingeln. Wer eine exakte Klingelmeldung braucht, nutzt den Türkontakt-Eingang oder die Action-URL der Station.
• Türöffnen schaltet den NC-Kontakt für 5 Sekunden (mode=1, level=1, delay=5), so wie es im Akuvox-Handbuch steht. Ist Ihr Türöffner am NO-Kontakt angeschlossen und passiert nichts, nehmen Sie stattdessen die ausgeblendeten Befehle Open Door (Relay A, NO contact) — die schicken denselben Befehl mit level=0.
• Was ein Eingang bedeutet, steht am Gerät. Ob 1 offen oder geschlossen heißt, hängt von Trig Option (Low/High) in den Türeinstellungen ab. Das Profil meldet den rohen Zustand; bitte nach der Einrichtung einmal mit der Tür vergleichen.
• Kein Kamerabild. Die HTTP-API von Akuvox beschreibt keinen Schnappschuss-Endpunkt, deshalb enthält das Profil keinen.
• Nicht im Profil enthalten: Telefonbuch und Benutzerverwaltung, Zeitpläne, RFID-Karten und PIN-Codes, die Protokolle (Anruf- und Türlog), Firmware-Update, das Sichern und Einspielen der Konfiguration sowie das Wählen und Auflegen von Gesprächen.