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.
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)
Assegna un indirizzo IP statico al modulo AP-IP nelle impostazioni DHCP del router. Il modulo utilizza DHCP per impostazione predefinita — senza una prenotazione, l’IP potrebbe cambiare dopo un’interruzione di corrente.
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
- Apri OptimaGSM Manager (v2.0 o successivo)
- Vai alla sezione modulo internet AP-IP
- Configura le impostazioni di rete (Ethernet DHCP o IP statico)
- 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:
- In OptimaGSM Manager, vai alla sezione Uscite
- Per ogni uscita che desideri controllare, abilita “WWW” nell’elenco “Triggered by”
- Questo abilita simultaneamente il controllo tramite app, server web e Modbus TCP/IP
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 (predefinito: 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
- Verifica che il firmware del modulo AP-IP sia v1.5 o successivo
- Conferma che il server Modbus TCP/IP sia abilitato in OptimaGSM Manager
- Controlla che il modulo AP-IP e TapHome Core siano sulla stessa rete/sottorete
- 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
- Verifica che l’opzione “WWW/IP control” sia abilitata per ogni uscita in OptimaGSM Manager
- 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:
- 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à
- 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
