--- title: "Ropam OptimaGSM" description: "Monitora ingressi di zona e controlla le uscite Ropam OptimaGSM via Modbus TCP. Template con 1 uscita e 9 ingressi, espandibile a 40+48." url: "https://taphome.com/it/compatibility/ropam-optimagsm/" language: it lastmod: 2026-10-08 generator: hugo ai: topics: ["modbus-tcp","alarm-system","security-integration","ethernet","gateway"] questions: ["Come integrare la Ropam OptimaGSM con TapHome?","Come collegare la Ropam OptimaGSM tramite Modbus TCP a TapHome?","Cosa monitora e controlla il template Ropam OptimaGSM per TapHome?","È possibile inserire o disinserire l'allarme Ropam OptimaGSM tramite TapHome?","Cos'è il modulo Ropam AP-IP e perché è necessario per TapHome?","Come aggiungere ulteriori ingressi e uscite al template Ropam OptimaGSM per TapHome?"] --- # Ropam OptimaGSM Comunicazione: Modbus TCP - [Pagina prodotto Ropam OptimaGSM](https://ropam.com.pl/product/optimagsm/?lang=en) > Indirizzo di rete > > TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione La Ropam OptimaGSM è una centrale di allarme polacca con connettività GSM/GPRS. TapHome comunica con la centrale tramite Modbus TCP attraverso il modulo gateway **Ropam AP-IP**, che fornisce l'interfaccia di comunicazione TCP/IP sulla porta 502. Questo è un **template iniziale** che implementa 1 uscita e 9 ingressi di zona dalla capacità totale di 40 uscite e 48 ingressi. Gli utenti possono aggiungere ulteriori dispositivi seguendo lo stesso schema descritto di seguito. > [!NOTE] > Il protocollo Modbus della OptimaGSM **non** espone registri per inserimento, disinserimento o stato del sistema direttamente — si tratta di una scelta progettuale di sicurezza. Una soluzione alternativa tramite mappatura I/O è descritta nella sezione Risoluzione dei problemi. ## Collegamento hardware Il modulo AP-IP si collega internamente alla centrale OptimaGSM e fornisce una porta Ethernet (RJ45) per la comunicazione TCP/IP. Collega il modulo AP-IP alla stessa rete locale di TapHome Core utilizzando un cavo Ethernet standard. - **Protocollo:** Modbus TCP - **Porta:** 502 - **Slave ID:** Configurabile (predefinito 1 nel template; la documentazione ufficiale indica 255; la community riporta che anche 4 funziona) ## Configurazione ### Requisiti firmware - **Firmware OptimaGSM:** v2.4 o successivo - **Firmware AP-IP:** v1.5 o successivo Se è installata una versione precedente, aggiorna il firmware utilizzando OptimaGSM Manager. ### Abilitazione del server Modbus TCP/IP 1. Apri **OptimaGSM Manager** (v2.0 o successivo) 2. Vai alla sezione **modulo internet AP-IP** 3. Configura le impostazioni di rete (Ethernet DHCP o IP statico) 4. Abilita la casella **"Enable MODBUS TCP/IP server"** in fondo alla pagina di configurazione AP-IP ### Abilitazione del controllo uscite tramite Modbus Ogni uscita che deve essere controllabile tramite TapHome deve avere l'opzione **"WWW/IP control"** abilitata: 1. In OptimaGSM Manager, vai alla sezione **Uscite** 2. Per ogni uscita che desideri controllare, abilita **"WWW"** nell'elenco "Triggered by" 3. Questo abilita simultaneamente il controllo tramite app, server web e Modbus TCP/IP > [!WARNING] > Senza l'opzione "WWW/IP control" abilitata per una specifica uscita, i comandi di scrittura Modbus al registro bobina corrispondente verranno ignorati dalla centrale. ### Parametri di importazione TapHome Durante l'importazione del template in TapHome, specifica: - **Indirizzo IP** — l'IP del modulo AP-IP nella rete locale (inserisci l'indirizzo effettivo del dispositivo; il template precompila il segnaposto 192.168.1.0) - **Slave ID** — indirizzo Modbus slave (predefinito: 1) ## Funzionalità dei dispositivi ### Controllo uscite Il template include un'uscita (Uscita 1) mappata sul registro bobina C:0. L'uscita utilizza etichette di stato Emergency/OK e può essere attivata/disattivata tramite la funzione Modbus 0x05 (Write Single Coil). ### Monitoraggio ingressi di zona Nove ingressi di zona sono inclusi come contatti reed che leggono registri di ingresso discreti: - **Ingressi di zona 1–8** — indirizzi continui da D:0 a D:7 - **Ingresso di zona 32** — indirizzo D:31 (non continuo, salta da D:8 a D:30) Ogni ingresso di zona riflette lo stato fisico dell'ingresso della zona di allarme corrispondente con un tempo di risposta di 250 ms. ### Espansione del template La OptimaGSM espone **40 uscite** (bobine C:0–C:39) e **48 ingressi di zona** (ingressi discreti D:0–D:47). Il template include solo un sottoinsieme iniziale. Per aggiungere ulteriori dispositivi: - **Uscite aggiuntive:** Aggiungi un dispositivo ModbusSwitch con `MODBUSR(C, {indirizzo}, Bool)` dove l'indirizzo è 0–39 - **Ingressi aggiuntivi:** Aggiungi un dispositivo ModbusReedContact con `MODBUSR(D, {indirizzo}, Bool)` dove l'indirizzo è 0–47 ### Funzionalità aggiuntive La centrale OptimaGSM espone anche registri di ingresso per sensori di temperatura (4 canali), ingresso analogico (0–10 V), livello segnale GSM, stato alimentazione AC, tensione alimentazione DC, monitoraggio potenza/tensione moduli IOE-IQPL, ora di sistema, codici errore e versioni firmware. Questi possono essere aggiunti al template TapHome come dispositivi ModbusVariable che leggono registri di ingresso. ## Risoluzione dei problemi ### Nessuna comunicazione Modbus 1. Verifica che il firmware del modulo AP-IP sia v1.5 o successivo 2. Conferma che il server Modbus TCP/IP sia abilitato in OptimaGSM Manager 3. Controlla che il modulo AP-IP e TapHome Core siano sulla stessa rete/sottorete 4. Prova diversi slave ID (1, 4 o 255) — il valore corretto dipende dalla versione firmware AP-IP e dalla configurazione ### Le uscite non rispondono ai comandi 1. Verifica che l'opzione "WWW/IP control" sia abilitata per ogni uscita in OptimaGSM Manager 2. Usa il **Modbus Tester** di Ropam (`modbus_tester.exe`) per verificare che le uscite rispondano ai comandi di scrittura indipendentemente da TapHome ### Inserimento e disinserimento tramite TapHome Il protocollo Modbus esclude intenzionalmente registri diretti per inserimento/disinserimento per motivi di sicurezza. È disponibile una soluzione alternativa tramite mappatura I/O: 1. **Controllo inserimento:** Configura un'uscita (bobina) in modo che sia logicamente mappata su un ingresso nella centrale. Imposta il tipo di ingresso su ARM, DISARM, ARM-only, DISARM-only o CANCEL allarme secondo necessità 2. **Monitoraggio stato:** Configura uscita/uscite in modo che vengano attivate dallo stato del sistema in modalità bistabile (es. Uscita 3 per "Inserimento totale", Uscita 4 per "Allarme"). Leggi lo stato della bobina tramite Modbus per determinare lo stato del sistema ## Dispositivi disponibili 10 Questi dispositivi compaiono in TapHome dopo l'importazione. Ropam OptimaGSM Modulo Uscita 1 Interruttore Lettura e scrittura Uscita O1 della centrale di allarme — commutabile via Modbus, richiede WWW/IP control abilitato in OptimaGSM Manager Registro: C:0 Bool Valori / Stati: ${Emergency\_Emergency} · ${Emergency\_Ok} Lettura stato interruttore ```taphome MODBUSR(C, 0, Bool) ``` Ingresso di zona 1 Contatto reed Solo lettura Registro: D:0 Bool Lettura ```taphome MODBUSR(D, 0, Bool) ``` Ingresso di zona 2 Contatto reed Solo lettura Registro: D:1 Bool Lettura ```taphome MODBUSR(D, 1, Bool) ``` Ingresso di zona 3 Contatto reed Solo lettura Registro: D:2 Bool Lettura ```taphome MODBUSR(D, 2, Bool) ``` Ingresso di zona 4 Contatto reed Solo lettura Registro: D:3 Bool Lettura ```taphome MODBUSR(D, 3, Bool) ``` Ingresso di zona 5 Contatto reed Solo lettura Registro: D:4 Bool Lettura ```taphome MODBUSR(D, 4, Bool) ``` Ingresso di zona 6 Contatto reed Solo lettura Registro: D:5 Bool Lettura ```taphome MODBUSR(D, 5, Bool) ``` Ingresso di zona 7 Contatto reed Solo lettura Registro: D:6 Bool Lettura ```taphome MODBUSR(D, 6, Bool) ``` Ingresso di zona 8 Contatto reed Solo lettura Registro: D:7 Bool Lettura ```taphome MODBUSR(D, 7, Bool) ``` Ingresso di zona 32 Contatto reed Solo lettura Ingresso di zona non contiguo — indirizzo D:31 (salta da D:8 a D:30) Registro: D:31 Bool Lettura ```taphome MODBUSR(D, 31, Bool) ``` **Connessione:** Modbus TCP • Slave ID: $\[SlaveId] Possibili miglioramenti (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 ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------|---------------| | Slave Id | `1` | | IP address | `192.168.1.0` | ## Fonti - 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 I documenti del produttore sono © dei rispettivi proprietari. Sono forniti così come pubblicati dal produttore, solo a titolo informativo. ## Documentazione correlata - [Modbus Integration](https://taphome.com/it/compatibility/modbus-guide/) - [Modbus - Configurazione](https://taphome.com/it/docs/integration/modbus/) - [Configurazione semplice utilizzando modelli](https://taphome.com/it/docs/integration/modbus/templates/) - [Script Modbus e prefetch](https://taphome.com/it/docs/script/modbus-scripts/) - [Funzioni Modbus](https://taphome.com/it/docs/script/modbus/) - [Tipi di dati Modbus](https://taphome.com/it/docs/script/modbus-data-types/)