--- title: "Ropam OptimaGSM" description: "Zoneneingänge überwachen und Ausgänge der Ropam OptimaGSM über Modbus TCP steuern. Vorlage mit 1 Ausgang und 9 Eingängen, erweiterbar auf 40+48." url: "https://taphome.com/de/compatibility/ropam-optimagsm/" language: de lastmod: 2026-10-08 generator: hugo ai: topics: ["modbus-tcp","alarm-system","security-integration","ethernet","gateway"] questions: ["Wie integriert man die Ropam OptimaGSM mit TapHome?","Wie verbindet man die Ropam OptimaGSM über Modbus TCP mit TapHome?","Was überwacht und steuert die Ropam-OptimaGSM-TapHome-Vorlage?","Kann TapHome die Ropam OptimaGSM Alarmanlage scharf- oder unscharf schalten?","Was ist das Ropam AP-IP Modul und warum wird es für TapHome benötigt?","Wie fügt man der Ropam-OptimaGSM-TapHome-Vorlage weitere Ein- und Ausgänge hinzu?"] --- # Ropam OptimaGSM Kommunikation: Modbus TCP - [Ropam OptimaGSM Produktseite](https://ropam.com.pl/product/optimagsm/?lang=en) > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung 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. > [!NOTE] > 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) ## 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 > [!WARNING] > 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 (geben Sie die tatsächliche Adresse des Geräts ein; die Vorlage füllt den Platzhalter 192.168.1.0 vor) - **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 ## Verfügbare Geräte 10 Diese Geräte erscheinen nach dem Import in TapHome. Ropam OptimaGSM Modul Ausgang 1 Schalter Lesen und Schreiben Alarmzentralen-Ausgang O1 — schaltbar über Modbus, erfordert aktivierte WWW/IP-Steuerung im OptimaGSM Manager Register: C:0 Bool Werte / Zustände: ${Emergency\_Emergency} · ${Emergency\_Ok} Schaltzustand lesen ```taphome MODBUSR(C, 0, Bool) ``` Zoneneingang 1 Reed-Kontakt Nur lesen Register: D:0 Bool Lesen ```taphome MODBUSR(D, 0, Bool) ``` Zoneneingang 2 Reed-Kontakt Nur lesen Register: D:1 Bool Lesen ```taphome MODBUSR(D, 1, Bool) ``` Zoneneingang 3 Reed-Kontakt Nur lesen Register: D:2 Bool Lesen ```taphome MODBUSR(D, 2, Bool) ``` Zoneneingang 4 Reed-Kontakt Nur lesen Register: D:3 Bool Lesen ```taphome MODBUSR(D, 3, Bool) ``` Zoneneingang 5 Reed-Kontakt Nur lesen Register: D:4 Bool Lesen ```taphome MODBUSR(D, 4, Bool) ``` Zoneneingang 6 Reed-Kontakt Nur lesen Register: D:5 Bool Lesen ```taphome MODBUSR(D, 5, Bool) ``` Zoneneingang 7 Reed-Kontakt Nur lesen Register: D:6 Bool Lesen ```taphome MODBUSR(D, 6, Bool) ``` Zoneneingang 8 Reed-Kontakt Nur lesen Register: D:7 Bool Lesen ```taphome MODBUSR(D, 7, Bool) ``` Zoneneingang 32 Reed-Kontakt Nur lesen Nicht fortlaufender Zoneneingang — Adresse D:31 (überspringt D:8 bis D:30) Register: D:31 Bool Lesen ```taphome MODBUSR(D, 31, Bool) ``` **Verbindung:** Modbus TCP • Slave ID: $\[SlaveId] Mögliche Verbesserungen (14) - C:1–C:39 Outputs O2–O40 — 39 additional coil outputs available — users can add following the same pattern as Output1 - D:8–D:30 Zone Inputs I9–I31 — 23 additional discrete inputs available — users can add following the same pattern - D:32–D:47 Zone Inputs I33–I48 — 16 additional discrete inputs available - I:0–I:3 Temperature Sensors T1–T4 — 4 temperature sensors, Input Register, UInt16, value / 10 = degrees C - I:12 Analog Input (0–10V) — Analog input value in mV - I:14 GSM Signal Level — Signal strength 0–5 (0=min, 5=max) - I:16 AC Power Status — 1=present, 0=absent - I:18 DC Supply Voltage — Supply voltage in mV (e.g. 13700 = 13.7V) - I:20–I:27 IOE-IQPL Power Consumption (p1–p8) — Power consumption per IOE-IQPL module in Watts - I:30–I:37 IOE-IQPL Supply Voltage (u1–u8) — Supply voltage per IOE-IQPL module in Volts - I:40–I:44 System Time — Minutes, hour, day, month, year - I:50–I:53 Fault Codes — 4 fault code bytes - I:60 AP-IP Firmware Version — Firmware version of AP-IP module - I:61 OptimaGSM Firmware Version — Firmware version of OptimaGSM panel ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|---------------| | Slave Id | `1` | | IP address | `192.168.1.0` | ## Quellen - MODBUS TCP/IP Application Note [ropam.com.pl](https://ropam.com.pl/wsparcie/wp-content/uploads/2018/04/an_optimagsm_apip_modbus_tcpip.pdf) 2026-04-21 [PDF](https://taphome.com/compatibility/devices/ropam-optimagsm/manufacturer/modbus-application-note.pdf) - Ropam MODBUS TCP/IP Support Page [ropam.com.pl](https://ropam.com.pl/wsparcie/modbus-tcp-ip-3/) 2026-04-21 - ArturHome Forum — Ropam Optima Modbus HA Integration [forum.arturhome.pl](https://forum.arturhome.pl/t/ropam-optima-po-modbusie/7083) 2026-04-21 Herstellerdokumente sind © ihrer jeweiligen Eigentümer. Sie werden so bereitgestellt, wie der Hersteller sie veröffentlicht hat, nur zur Information. ## Verwandte Dokumentation - [Modbus Integration](https://taphome.com/de/compatibility/modbus-guide/) - [Modbus](https://taphome.com/de/docs/integration/modbus/) - [Einfache Konfiguration mit Vorlagen](https://taphome.com/de/docs/integration/modbus/templates/) - [Modbus-Skripte und Prefetch](https://taphome.com/de/docs/script/modbus-scripts/) - [Modbus-Funktionen](https://taphome.com/de/docs/script/modbus/) - [Modbus-Datentypen](https://taphome.com/de/docs/script/modbus-data-types/)