--- title: "Ropam OptimaGSM" description: "Monitoruj wejścia strefowe i steruj wyjściami Ropam OptimaGSM przez Modbus TCP. Szablon z 1 wyjściem i 9 wejściami, rozszerzalny do 40+48." url: "https://taphome.com/pl/compatibility/ropam-optimagsm/" language: pl lastmod: 2026-10-08 generator: hugo ai: topics: ["modbus-tcp","alarm-system","security-integration","ethernet","gateway"] questions: ["Jak zintegrować Ropam OptimaGSM z TapHome?","Jak podłączyć Ropam OptimaGSM przez Modbus TCP do TapHome?","Co monitoruje i steruje szablon Ropam OptimaGSM dla TapHome?","Czy przez TapHome można uzbrajać lub rozbrajać alarm Ropam OptimaGSM?","Czym jest moduł Ropam AP-IP i dlaczego jest potrzebny do TapHome?","Jak dodać więcej wejść i wyjść do szablonu Ropam OptimaGSM dla TapHome?"] --- # Ropam OptimaGSM Komunikacja: Modbus TCP - [Strona produktowa Ropam OptimaGSM](https://ropam.com.pl/product/optimagsm/?lang=en) > Adres w sieci > > TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji Ropam OptimaGSM to polska centrala alarmowa z łącznością GSM/GPRS. TapHome komunikuje się z centralą przez Modbus TCP za pośrednictwem modułu gateway **Ropam AP-IP**, który zapewnia interfejs komunikacyjny TCP/IP na porcie 502. To jest **szablon startowy** implementujący 1 wyjście i 9 wejść strefowych z pełnej pojemności 40 wyjść i 48 wejść. Użytkownicy mogą dodawać kolejne urządzenia według tego samego wzoru opisanego poniżej. > [!NOTE] > Protokół Modbus w OptimaGSM **nie udostępnia** rejestrów do uzbrajania, rozbrajania ani bezpośredniego odczytu stanu systemu — jest to celowa decyzja projektowa wynikająca z wymogów bezpieczeństwa. Obejście za pomocą mapowania I/O opisano w sekcji Rozwiązywanie problemów. ## Połączenie sprzętowe Moduł AP-IP łączy się z centralą OptimaGSM wewnętrznie i udostępnia port Ethernet (RJ45) do komunikacji TCP/IP. Podłącz moduł AP-IP do tej samej sieci lokalnej co TapHome Core za pomocą standardowego kabla Ethernet. - **Protokół:** Modbus TCP - **Port:** 502 - **Slave ID:** Konfigurowalny (domyślnie 1 w szablonie; oficjalna dokumentacja podaje 255; społeczność zgłasza, że działa również 4) ## Konfiguracja ### Wymagania firmware - **Firmware OptimaGSM:** v2.4 lub nowszy - **Firmware AP-IP:** v1.5 lub nowszy Jeśli zainstalowana jest starsza wersja, zaktualizuj firmware za pomocą OptimaGSM Managera. ### Włączenie serwera Modbus TCP/IP 1. Otwórz **OptimaGSM Manager** (v2.0 lub nowszy) 2. Przejdź do sekcji **moduł internetowy AP-IP** 3. Skonfiguruj ustawienia sieciowe (Ethernet DHCP lub statyczny IP) 4. Zaznacz opcję **„Enable MODBUS TCP/IP server"** na dole strony konfiguracyjnej AP-IP ### Włączenie sterowania wyjściami przez Modbus Każde wyjście, które ma być sterowane przez TapHome, musi mieć włączoną opcję **„WWW/IP control"**: 1. W OptimaGSM Managerze przejdź do sekcji **Wyjścia** 2. Dla każdego wyjścia, które chcesz sterować, zaznacz **„WWW"** na liście „Triggered by" 3. Dzięki temu jednocześnie włączane jest sterowanie przez aplikację, serwer WWW i Modbus TCP/IP > [!WARNING] > Bez włączonej opcji „WWW/IP control" dla danego wyjścia polecenia zapisu Modbus do odpowiedniego rejestru cewki będą ignorowane przez centralę. ### Parametry importu w TapHome Podczas importowania szablonu w TapHome podaj: - **Adres IP** — adres IP modułu AP-IP w sieci lokalnej (wpisz rzeczywisty adres urządzenia; szablon wstępnie wpisuje wartość zastępczą 192.168.1.0) - **Slave ID** — adres Modbus slave (domyślnie: 1) ## Możliwości urządzeń ### Sterowanie wyjściami Szablon zawiera jedno wyjście (Wyjście 1) przypisane do rejestru cewki C:0. Wyjście używa oznaczeń stanu Emergency/OK i może być przełączane włącz/wyłącz za pomocą funkcji Modbus 0x05 (Write Single Coil). ### Monitorowanie wejść strefowych Dziewięć wejść strefowych jest uwzględnionych jako kontaktrony odczytujące dyskretne rejestry wejściowe: - **Wejścia strefowe 1–8** — ciągłe adresy od D:0 do D:7 - **Wejście strefowe 32** — adres D:31 (nieciągły, pomija D:8 do D:30) Każde wejście strefowe odzwierciedla fizyczny stan odpowiedniego wejścia strefy alarmowej z czasem odpowiedzi 250 ms. ### Rozszerzanie szablonu OptimaGSM udostępnia **40 wyjść** (cewki C:0–C:39) i **48 wejść strefowych** (wejścia dyskretne D:0–D:47). Szablon zawiera tylko podzbiór startowy. Aby dodać więcej urządzeń: - **Dodatkowe wyjścia:** Dodaj urządzenie ModbusSwitch z `MODBUSR(C, {adres}, Bool)` gdzie adres to 0–39 - **Dodatkowe wejścia:** Dodaj urządzenie ModbusReedContact z `MODBUSR(D, {adres}, Bool)` gdzie adres to 0–47 ### Dodatkowe możliwości Centrala OptimaGSM udostępnia również rejestry wejściowe dla czujników temperatury (4 kanały), wejścia analogowego (0–10 V), poziomu sygnału GSM, stanu zasilania AC, napięcia zasilania DC, monitorowania mocy/napięcia modułów IOE-IQPL, czasu systemowego, kodów błędów i wersji firmware. Można je dodać do szablonu TapHome jako urządzenia ModbusVariable odczytujące rejestry wejściowe. ## Rozwiązywanie problemów ### Brak komunikacji Modbus 1. Sprawdź, czy firmware modułu AP-IP to v1.5 lub nowszy 2. Potwierdź, że serwer Modbus TCP/IP jest włączony w OptimaGSM Managerze 3. Sprawdź, czy moduł AP-IP i TapHome Core są w tej samej sieci/podsieci 4. Wypróbuj różne slave ID (1, 4 lub 255) — prawidłowa wartość zależy od wersji firmware AP-IP i konfiguracji ### Wyjścia nie reagują na polecenia 1. Sprawdź, czy opcja „WWW/IP control" jest włączona dla każdego wyjścia w OptimaGSM Managerze 2. Użyj **Modbus Testera** Ropam (`modbus_tester.exe`) do weryfikacji, czy wyjścia reagują na polecenia zapisu niezależnie od TapHome ### Uzbrajanie i rozbrajanie przez TapHome Protokół Modbus celowo wyklucza bezpośrednie rejestry do uzbrajania/rozbrajania ze względów bezpieczeństwa. Dostępne jest obejście za pomocą mapowania I/O: 1. **Sterowanie uzbrajaniem:** Skonfiguruj wyjście (cewkę) tak, aby było logicznie mapowane na wejście w centrali. Ustaw typ wejścia na ARM, DISARM, ARM-only, DISARM-only lub CANCEL alarm według potrzeb 2. **Monitorowanie stanu:** Skonfiguruj wyjście/wyjścia tak, aby były wyzwalane stanem systemu w trybie bistabilnym (np. Wyjście 3 dla „Pełne uzbrojenie", Wyjście 4 dla „Alarm"). Odczytuj stan cewki przez Modbus w celu ustalenia stanu systemu ## Dostępne urządzenia 10 Te urządzenia pojawią się w TapHome po imporcie. Ropam OptimaGSM Moduł Wyjście 1 Przełącznik Odczyt i zapis Wyjście O1 centrali alarmowej — przełączalne przez Modbus, wymaga włączenia WWW/IP control w OptimaGSM Managerze Rejestr: C:0 Bool Wartości / Stany: ${Emergency\_Emergency} · ${Emergency\_Ok} Odczyt stanu przełącznika ```taphome MODBUSR(C, 0, Bool) ``` Wejście strefowe 1 Kontakt reed Tylko do odczytu Rejestr: D:0 Bool Odczyt ```taphome MODBUSR(D, 0, Bool) ``` Wejście strefowe 2 Kontakt reed Tylko do odczytu Rejestr: D:1 Bool Odczyt ```taphome MODBUSR(D, 1, Bool) ``` Wejście strefowe 3 Kontakt reed Tylko do odczytu Rejestr: D:2 Bool Odczyt ```taphome MODBUSR(D, 2, Bool) ``` Wejście strefowe 4 Kontakt reed Tylko do odczytu Rejestr: D:3 Bool Odczyt ```taphome MODBUSR(D, 3, Bool) ``` Wejście strefowe 5 Kontakt reed Tylko do odczytu Rejestr: D:4 Bool Odczyt ```taphome MODBUSR(D, 4, Bool) ``` Wejście strefowe 6 Kontakt reed Tylko do odczytu Rejestr: D:5 Bool Odczyt ```taphome MODBUSR(D, 5, Bool) ``` Wejście strefowe 7 Kontakt reed Tylko do odczytu Rejestr: D:6 Bool Odczyt ```taphome MODBUSR(D, 6, Bool) ``` Wejście strefowe 8 Kontakt reed Tylko do odczytu Rejestr: D:7 Bool Odczyt ```taphome MODBUSR(D, 7, Bool) ``` Wejście strefowe 32 Kontakt reed Tylko do odczytu Nieciągłe wejście strefowe — adres D:31 (pomija D:8 do D:30) Rejestr: D:31 Bool Odczyt ```taphome MODBUSR(D, 31, Bool) ``` **Połączenie:** Modbus TCP • Slave ID: $\[SlaveId] Możliwe ulepszenia (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 ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |---------------------|---------------| | Slave Id | `1` | | IP address | `192.168.1.0` | ## Źródła - 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 Dokumenty producentów są © ich właścicieli. Udostępniamy je w formie opublikowanej przez producenta, wyłącznie w celach informacyjnych. ## Powiązana dokumentacja - [Modbus Integration](https://taphome.com/pl/compatibility/modbus-guide/) - [Modbus](https://taphome.com/pl/docs/integration/modbus/) - [Prosta konfiguracja za pomocą szablonów](https://taphome.com/pl/docs/integration/modbus/templates/) - [Skrypty Modbus i prefetch](https://taphome.com/pl/docs/script/modbus-scripts/) - [Funkcje Modbus](https://taphome.com/pl/docs/script/modbus/) - [Typy danych Modbus](https://taphome.com/pl/docs/script/modbus-data-types/)