2N IP Intercom

Geräteprofil · Türsprechstellen

Hinweis: Dieses Profil beruht auf dem offiziellen HTTP API manual for 2N devices (v2.45).

Das Profil liest Klingel-, Ruf- und Türöffner-Zustände über die 2N HTTP API und öffnet die Tür. Gespräche (Audio/Video-Telefonie) laufen weiter über die bestehende nomos SIP-Integration – dieses Add-on ersetzt sie nicht, es ergänzt nur Zustände, Türöffner und Kamerabild.

Voraussetzungen

2N IP Sprechstelle mit HTTP API (z. B. IP Verso, IP Style, IP Solo, IP Force, IP Safety, IP Base, IP One)
Firmware 2.35 oder neuer empfohlen: Ab 2.35 sind die HTTP-API-Funktionen ohne Lizenzschlüssel verfügbar. Bei älterer Firmware brauchen switch, io und call die Enhanced Integration Lizenz (lizenzfrei sind dort nur system/info, camera/snapshot und log).
Fixe IP-Adresse der Sprechstelle

Einrichtung an der Sprechstelle (Weboberfläche)

Unter Services → HTTP API:

Diese Dienste aktivieren: System API, Switch API, I/O API, Phone/Call API, Camera API
Bei jedem dieser Dienste:
- Protokoll HTTP wählen (nimmt HTTP und HTTPS an). Mit HTTPS lehnt die Sprechstelle die Anfragen von nomos ab.
- Authentifizierung Basic wählen. Digest (Werkseinstellung) funktioniert nicht – nomos kann bei diesen Geräten nur Basic.
Ein eigenes API-Benutzerkonto anlegen (Konto aktivieren, Benutzername, Passwort) mit diesen Rechten:
- Switches – Monitoring und Switches – Control
- Inputs and outputs – Monitoring
- Phone/Calls – Monitoring
- Camera – Monitoring

Mit Basic über HTTP geht das Passwort unverschlüsselt durchs LAN. Deshalb ein eigenes Konto nur mit diesen Rechten verwenden, nicht das Admin-Konto.

Einrichtung in nomos

Skills → Add-ons: Profil 2N IP Intercom importieren
Gerät hinzufügen
IP-Adresse, Port (Standard 80), Benutzername und Passwort des API-Kontos eintragen

Datenbereich

Wert	Quelle	Bedeutung
`doorbell`	`/api/call/status`	`true`, solange die Sprechstelle selbst einen Ruf aufbaut (Klingeltaste gedrückt) – in den Zuständen connecting, ringing und connected
`status`	`/api/call/status`	0 = Idle, 1 = Ringing (inkl. connecting), 2 = Connected
`active`	`/api/call/status`	`true`, solange irgendein Gespräch läuft (auch eingehende Rufe zur Sprechstelle)
`switch1` … `switch4`	`/api/switch/status`	Schalter (Türöffner) aktiv
`input1`, `input2`	`/api/io/status`	Digitale Eingänge `input1`/`input2`
`tamper`	`/api/io/status`	Sabotagekontakt (Port `tamper`, nur wenn vorhanden)
`model`, `firmware`	`/api/system/info`	Modell und Firmware-Version
`reachable`	jede Abfrage	`false`, wenn die Sprechstelle nicht antwortet oder die Anmeldung scheitert

Aktionen:

Open Door (opendoor): Schalter 1, action=trigger – zieht den Schalter für die an der Sprechstelle eingestellte Zeit an
opendoor2 … opendoor4: Schalter 2–4, ebenfalls trigger
switchN_on / switchN_off (ausgeblendet): Schalter N dauerhaft ein/aus (z. B. bistabiler Schalter)

Kamera: Standbild über /api/camera/snapshot?width=640&height=480, Live-Bild als MJPEG mit fps=10. Ein RTSP-Stream (rtsp://<IP>:554/h264_stream) ist im Profil nicht hinterlegt; der RTSP-Server der Sprechstelle hat eigene Benutzer.

Abfrageintervalle: Rufstatus alle 3 s, Schalter und Eingänge alle 5 s, Geräteinfo stündlich.

Hinweise

Klingeln wird abgefragt, nicht gemeldet. Die Klingel kann bis zu 3 s verzögert ankommen; ein Ruf, der kürzer als 3 s dauert, kann übersehen werden.
doorbell zählt nur Rufe, die von der Sprechstelle ausgehen (Richtung outgoing aus Sicht der Sprechstelle). Ruft jemand die Sprechstelle an (z. B. ein Videobild aus der App), bleibt doorbell aus, active und status zeigen das Gespräch aber an.
Bis zum ersten Ruf nach einem Neustart von nomos bleiben doorbell und status auf ihrem Grundwert (aus / Idle).
Ein Schalter, der an der Sprechstelle deaktiviert oder gesperrt ist, lässt sich nicht schalten (Fehler 14 der Sprechstelle).
Eingänge an Erweiterungsmodulen (z. B. modul1.input1) liest das Profil nicht.
Andere Port-Namen als input1, input2 und tamper liefern keinen Wert. Welche Ports das Gerät hat, zeigt http://<IP>/api/io/caps.