Die Ropam OptimaGSM ist eine polnische Sicherheits-Alarmzentrale mit GSM/GPRS-Anbindung. TapHome kommuniziert mit der Zentrale über Modbus TCP durch das Ropam AP-IP Gateway-Modul, das die TCP/IP-Kommunikationsschnittstelle auf Port 502 bereitstellt.

Dies ist eine Starter-Vorlage, die 1 Ausgang und 9 Zoneneingänge von der Gesamtkapazität von 40 Ausgängen und 48 Eingängen implementiert. Benutzer können weitere Geräte nach dem gleichen, unten beschriebenen Muster hinzufügen.

Das Modbus-Protokoll der OptimaGSM stellt keine Register für Scharfschaltung, Unscharfschaltung oder Systemstatus direkt bereit — dies ist eine sicherheitstechnische Designentscheidung. Ein Workaround über I/O-Zuordnung wird im Abschnitt Fehlerbehebung beschrieben.

Hardwareverbindung#

Das AP-IP Modul wird intern mit der OptimaGSM-Zentrale verbunden und stellt einen Ethernet-Port (RJ45) für die TCP/IP-Kommunikation bereit. Verbinden Sie das AP-IP Modul über ein Standard-Ethernet-Kabel mit demselben lokalen Netzwerk wie TapHome Core.

• Protokoll: Modbus TCP
• Port: 502
• Slave-ID: Konfigurierbar (Standard 1 in der Vorlage; offizielle Dokumentation gibt 255 an; Community meldet, dass auch 4 funktioniert)

Weisen Sie dem AP-IP Modul eine statische IP-Adresse in den DHCP-Einstellungen des Routers zu. Das Modul verwendet standardmäßig DHCP — ohne Reservierung kann sich die IP-Adresse nach einem Stromausfall ändern.

Konfiguration#

Firmware-Anforderungen

• OptimaGSM Firmware: v2.4 oder neuer
• AP-IP Firmware: v1.5 oder neuer

Falls eine ältere Version installiert ist, aktualisieren Sie die Firmware mit dem OptimaGSM Manager.

Aktivierung des Modbus TCP/IP Servers

1. Öffnen Sie den OptimaGSM Manager (v2.0 oder neuer)
2. Navigieren Sie zum Abschnitt AP-IP Internetmodul
3. Konfigurieren Sie die Netzwerkeinstellungen (Ethernet DHCP oder statische IP)
4. Aktivieren Sie das Kontrollkästchen „Enable MODBUS TCP/IP server" unten auf der AP-IP Konfigurationsseite

Aktivierung der Ausgangssteuerung über Modbus

Jeder Ausgang, der über TapHome steuerbar sein soll, muss die Option „WWW/IP control" aktiviert haben:

1. Navigieren Sie im OptimaGSM Manager zum Abschnitt Ausgänge
2. Aktivieren Sie bei jedem zu steuernden Ausgang „WWW" in der Checkbox-Liste „Triggered by"
3. Dadurch wird die Steuerung über App, Webserver und Modbus TCP/IP gleichzeitig aktiviert

Ohne die aktivierte Option „WWW/IP control" für einen bestimmten Ausgang werden Modbus-Schreibbefehle an das entsprechende Spulenregister von der Zentrale ignoriert.

TapHome Import-Parameter

Beim Importieren der Vorlage in TapHome geben Sie Folgendes an:

• IP-Adresse — die IP-Adresse des AP-IP Moduls im lokalen Netzwerk (Standard: 192.168.1.0)
• Slave-ID — Modbus-Slave-Adresse (Standard: 1)

Gerätefunktionen#

Ausgangssteuerung

Die Vorlage enthält einen Ausgang (Ausgang 1), der auf das Spulenregister C:0 abgebildet ist. Der Ausgang verwendet Emergency/OK-Statusbezeichnungen und kann über Modbus-Funktion 0x05 (Write Single Coil) ein-/ausgeschaltet werden.

Überwachung von Zoneneingängen

Neun Zoneneingänge sind als Reed-Kontakte eingebunden, die diskrete Eingangsregister lesen:

• Zoneneingänge 1–8 — fortlaufende Adressen D:0 bis D:7
• Zoneneingang 32 — Adresse D:31 (nicht fortlaufend, überspringt D:8 bis D:30)

Jeder Zoneneingang spiegelt den physischen Zustand des entsprechenden Alarm-Zoneneingangs mit einer Antwortzeit von 250 ms wider.

Erweiterung der Vorlage

Die OptimaGSM stellt 40 Ausgänge (Spulen C:0–C:39) und 48 Zoneneingänge (diskrete Eingänge D:0–D:47) bereit. Die Vorlage enthält nur ein Starter-Subset. Um weitere Geräte hinzuzufügen:

• Weitere Ausgänge: Fügen Sie ein ModbusSwitch-Gerät mit MODBUSR(C, {Adresse}, Bool) hinzu, wobei die Adresse 0–39 ist
• Weitere Eingänge: Fügen Sie ein ModbusReedContact-Gerät mit MODBUSR(D, {Adresse}, Bool) hinzu, wobei die Adresse 0–47 ist

Weitere Funktionen

Die OptimaGSM-Zentrale stellt auch Eingangsregister für Temperatursensoren (4 Kanäle), Analogeingang (0–10 V), GSM-Signalstärke, AC-Versorgungsstatus, DC-Versorgungsspannung, Leistungs-/Spannungsüberwachung der IOE-IQPL Module, Systemzeit, Fehlercodes und Firmware-Versionen bereit. Diese können als ModbusVariable-Geräte, die Eingangsregister lesen, zur TapHome-Vorlage hinzugefügt werden.

Fehlerbehebung#

Keine Modbus-Kommunikation

1. Überprüfen Sie, dass die Firmware des AP-IP Moduls v1.5 oder neuer ist
2. Bestätigen Sie, dass der Modbus TCP/IP Server im OptimaGSM Manager aktiviert ist
3. Prüfen Sie, dass AP-IP Modul und TapHome Core im selben Netzwerk/Subnetz sind
4. Probieren Sie verschiedene Slave-IDs (1, 4 oder 255) — der korrekte Wert hängt von der AP-IP Firmware-Version und Konfiguration ab

Ausgänge reagieren nicht auf Befehle

1. Überprüfen Sie, dass die Option „WWW/IP control" für jeden Ausgang im OptimaGSM Manager aktiviert ist
2. Verwenden Sie den Ropam Modbus Tester (modbus_tester.exe), um zu überprüfen, ob Ausgänge unabhängig von TapHome auf Schreibbefehle reagieren

Scharfschaltung und Unscharfschaltung über TapHome

Das Modbus-Protokoll schließt absichtlich direkte Register für Scharfschaltung/Unscharfschaltung aus Sicherheitsgründen aus. Ein Workaround über I/O-Zuordnung ist verfügbar:

1. Scharfschaltungssteuerung: Konfigurieren Sie einen Ausgang (Spule) so, dass er logisch auf einen Eingang in der Zentrale abgebildet wird. Stellen Sie den Eingangstyp auf ARM, DISARM, ARM-only, DISARM-only oder CANCEL Alarm nach Bedarf ein
2. Statusüberwachung: Konfigurieren Sie Ausgang/Ausgänge so, dass sie vom Systemstatus im bistabilen Modus ausgelöst werden (z. B. Ausgang 3 für „Vollständig scharf", Ausgang 4 für „Alarm"). Lesen Sie den Spulenstatus über Modbus, um den Systemzustand zu ermitteln