Indice
Panoramica Requisiti Verifica prima dell'installazione Installazione Più macchine sullo stesso PC Configurazione guidata Collegamento alla macchina Contatore di energia Turni Integrazione ERP e MES Utenti e registro Licenza Rete e sicurezza Antivirus e firewall Dati e backup Servizio e icona Aggiornamenti e versione 1 Problemi frequenti AssistenzaPanoramica
RTIndustry 2.0 è un unico servizio Windows installato su un PC collegato in rete alla macchina. Il servizio legge i dati dal controllo (CNC o PLC), li elabora e li conserva nel suo database; l'interfaccia si usa dal browser, sullo stesso PC o da qualunque PC, tablet o telefono della rete aziendale.
| Componente | Cosa fa |
|---|---|
Servizio RTIndustry | Parte con Windows e raccoglie i dati anche a browser chiuso. Si riavvia da solo in caso di errore. |
| Interfaccia web | Porta 1880: Work order, HMI macchina, Telemetria, OEE, Report, Energia, Allarmi, Storico WO, Impostazioni, Operatori e registro. |
| Database integrato | Work order, storico dei turni, allarmi, impostazioni e registro attività. Non serve installare un database a parte. |
| Broker MQTT integrato | Porta 1883: telemetria in uscita e comandi sui work order dai sistemi esterni autenticati. |
| Icona nell'area di notifica | Stato del servizio e della licenza a colori, apertura della dashboard, riavvio del servizio, log. |
| Manuale d'uso | Incluso nel programma (pulsante «? Guida» in ogni schermata) e disponibile online. |
Requisiti
| Voce | Requisito |
|---|---|
| Sistema operativo | Windows 10 versione 1809 o successiva, Windows 11, Windows Server 2019 o successivo. Solo 64 bit. |
| Memoria | Almeno 4 GB consigliati (il servizio usa circa 100 MB; il resto serve a Windows e al browser). Con più macchine sullo stesso PC conta circa 100 MB in più per ogni istanza; da 6 macchine in su consigliati 8 GB (prova con 8 istanze attive: circa 60 MB ciascuna a riposo). |
| Disco | Almeno 2 GB liberi; consigliati 10 GB per conservare anni di storico e i backup. |
| Rete verso la macchina | Collegamento Ethernet al CNC o al PLC (vedi porte per protocollo). |
| Porte locali | 1880 (interfaccia web e API) e 1883 (MQTT), aperte nel firewall di Windows dall'installer. Ogni istanza aggiuntiva usa la coppia successiva: 1890/1893, 1900/1903… Se l'antivirus ha un firewall proprio vedi Antivirus e firewall. |
| Internet | Per la verifica della licenza, anche tramite proxy aziendale. Senza connessione il programma continua a lavorare. |
| Alimentazione | Il PC non deve andare in sospensione: con il PC sospeso i dati non vengono raccolti. |
| Browser | Un browser aggiornato (Chrome, Edge, Firefox, Safari) su PC, tablet o telefono. |
| Installazione | Serve un account amministratore di Windows. |
Verifica prima dell'installazione
Lo strumento Verifica-RTIndustry.bat si copia su una chiavetta e si lancia sul PC del cliente prima di installare. Non modifica nulla: legge soltanto e crea una pagella sul Desktop (verde = pronto, giallo = avvisi da valutare, rosso = da risolvere prima).
Controlla versione di Windows, memoria e disco, permessi, porte 1880 e 1883, schede di rete, sospensione del PC, antivirus e firewall di terze parti, installazioni e istanze già presenti, proxy, raggiungibilità del servizio licenze, ora e fuso orario, raggiungibilità della macchina (ping e porta del protocollo). Dopo l'installazione lo stesso strumento si trova in C:\RTIndustry\strumenti.
Installazione
- Avvia l'installer di RTIndustry con un account amministratore. La cartella predefinita è
C:\RTIndustry. - L'installer crea il servizio Windows
RTIndustrycon avvio automatico e riavvio automatico in caso di errore, apre nel firewall le porte 1880 e 1883 e protegge la cartella dei dati. - Al termine si apre il browser sulla configurazione guidata.
| Cartella | Contenuto | Agli aggiornamenti |
|---|---|---|
app\, node\, tray\ | Programma, runtime e icona dell'area di notifica | Sostituite |
config\ | Configurazione di avvio (porta, cartella dati) | Mai sovrascritta |
data\ | Database, backup, log, identità dell'installazione | Mai toccata |
strumenti\ | Strumento di verifica di PC, rete e macchina | Sostituita |
Più macchine sullo stesso PC
Ogni installazione di RTIndustry segue una macchina. Per monitorare più macchine da un solo PC o server (per esempio 8 macchine in un reparto) si installano più istanze, una per macchina, tutte attive insieme.
- Installa RTIndustry la prima volta: è l'istanza principale (
C:\RTIndustry, porta 1880). - Avvia di nuovo l'installer: scegli Installare una nuova istanza e dai un nome (lettere, cifre e trattini, per esempio
Fresa2oTORNIO-01). - Completa la configurazione guidata della nuova istanza all'indirizzo proposto (per esempio
http://NOME-O-IP-DEL-PC:1890) con la macchina da collegare e la stessa chiave di licenza.
| Istanza principale | Istanza «Fresa2» | |
|---|---|---|
| Cartella | C:\RTIndustry | C:\RTIndustry-Fresa2 |
| Servizio Windows | RTIndustry | RTIndustry-Fresa2 |
| Porte (dashboard / MQTT) | 1880 / 1883 | prime libere: 1890 / 1893, poi 1900 / 1903… |
| Icona, dati, backup, licenza | propri di ogni istanza | |
Il nome dell'istanza compare accanto al logo, nella pagina di accesso e nel titolo della scheda del browser. Per aggiornare si avvia l'installer e si sceglie quale istanza aggiornare; disinstallarne una non tocca le altre. Installazione silenziosa: RTIndustry-Setup-x.y.z.exe /VERYSILENT /ISTANZA=Fresa2.
Configurazione guidata
Compare solo la prima volta, subito dopo l'installazione. Se si chiude il browser a metà, riaprendolo si riprende dal passo a cui si era arrivati.
- Azienda: nome dell'azienda (obbligatorio), stabilimento, reparto, nome della macchina e fuso orario (per l'Italia
Europe/Rome, l'ora legale è automatica). - Macchina: tipo di collegamento (OPC UA, FANUC, Heidenhain, Modbus TCP oppure Simulatore per dati di prova), indirizzo e Prova la connessione. Il riquadro verde «Macchina collegata» conferma che stato e pezzi arrivano. Se la macchina è spenta si può proseguire e riprovare più tardi dalle Impostazioni.
- Turni: orari di inizio e fine di ogni turno, anche a cavallo della mezzanotte.
- Licenza: chiave nel formato
XXXX-XXXX-XXXX-XXXXe Attiva licenza. Senza chiave parte una prova gratuita di 30 giorni. In Opzioni avanzate si indica l'eventuale proxy aziendale. - Amministratore: nome utente e password (almeno 8 caratteri) del primo amministratore.
- Avvio: riepilogo e Avvia RTIndustry.

Collegamento alla macchina
Il collegamento si sceglie nella configurazione guidata e si modifica in Impostazioni › Macchina e protocollo. Cambiando protocollo, la configurazione precedente resta salvata. Con Prova le modifiche prima di salvare si verifica un nuovo indirizzo o protocollo senza toccare quello in uso.
| Protocollo | Macchine | Note |
|---|---|---|
| OPC UA | PLC e CNC con server OPC UA | Indirizzo opc.tcp://IP:porta (spesso 4840). Profili pronti per Siemens SINUMERIK 840D sl (nodi nativi acProg, verificati sul campo, oppure progStatus), macchine umati (OPC 40501) e gateway già usati con la versione 1. Sicurezza: nessuna, firma, firma e cifratura (Basic256Sha256, Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss), con utente e password. Pulsanti per cercare i nodi della macchina e riconoscere il tipo di controllo. |
| FANUC FOCAS | CNC FANUC con Ethernet integrata | Porta 8193 del CNC. Serie: 0i-D / 0i-F, 30i / 31i / 32i / 35i, 16i / 18i / 21i, 15 / 15i. La serie decide come si leggono gli stati. |
| Heidenhain DNC | TNC 640, TNC 6xx, TNC 320, TNC 128, iTNC 530, CNC PILOT 6xx, MANUALplus 620, MillPlus IT | Porta DNC del controllo. Se il controllo non ha un contapezzi, i pezzi si contano a fine programma (M30, M2/M02 o END PGM); in alternativa si legge un contatore da un percorso dati del PLC (con password di accesso). Invio dei programmi al controllo da Impostazioni › Cartelle e trasferimenti. |
| Modbus TCP | PLC e moduli di I/O | Indirizzo IP, porta (di solito 502) e Unit ID. Mappa pronta oppure registri personalizzati: holding (FC3), input (FC4), coil (FC1), ingressi (FC2); tipi da 16 e 32 bit, float e stringhe, con ordine dei byte configurabile e pulsante Prova per ogni registro. |
| Simulatore | Nessuna macchina | Dati realistici per demo e prove in ufficio. |
Variabili, stati e contapezzi
Da ogni macchina RTIndustry legge fino a 11 variabili: stato, modo operativo, contapezzi, programma, stato e messaggio di allarme, avanzamento, override mandrino e rapido, utensile, contatore di energia. Di solito sono proposte in automatico dal profilo del protocollo; si possono cambiare in Impostazioni › Variabili macchina.
In Mapping stati e modi · contapezzi si indica come tradurre i valori della macchina negli stati di RTIndustry (In lavorazione, In pausa, Fermo, In allarme, Inattivo…) e come contare i pezzi. Il conteggio è protetto da azzeramenti e salti del contatore della macchina, anche dopo un riavvio del PC.
Se la macchina non ha un contapezzi (spesso Heidenhain, oppure SINUMERIK con actParts non configurato) si attiva il conteggio a fine programma: vale un pezzo ogni passaggio diretto da In lavorazione a Fine programma; un reset dopo un arresto (programma annullato) non conta. Poiché la macchina si legge a intervalli (di norma ogni 5 secondi), un ciclo intero più breve dell'intervallo non si vede: quando i cicli misurati sono più brevi di tre letture le Impostazioni mostrano l'avviso Cicli brevi e conviene usare il contapezzi della macchina o un contatore nel PLC.
L'opzione Con l'allarme attivo la macchina è «In allarme» fa diventare la macchina In allarme quando la variabile di allarme è attiva (anche un numero d'allarme diverso da 0, mostrato come «Allarme N»).
Se non arrivano dati per oltre 15 secondi la macchina risulta «Spenta o non raggiungibile».
Contatore di energia
Oltre al contatore letto dalla macchina, si può collegare un contatore di energia Modbus TCP separato (Impostazioni › Contatore di energia), con prova di lettura in Wh e kWh. Per l'IME CE4DT MID (Conto D4) c'è un profilo pronto (input register 20592, unit ID 5, fattore 100): basta l'indirizzo IP. Per gli altri modelli si indicano registro, funzione (FC3/FC4), tipo di dato (uint32, int32, float32, uint64), ordine dei registri (ABCD, CDAB, BADC, DCBA) e fattore di scala: il valore moltiplicato per il fattore deve risultare in Wh (contatore in kWh → 1000; in 0,1 kWh → 100). Correggere il fattore non crea salti di energia nei work order. Il prezzo dell'energia in euro al kWh, usato per il costo del turno e dei periodi, si imposta in Impostazioni › Servizi, energia e licenza.
Turni
I turni si definiscono con numero, ora di inizio e ora di fine, anche a cavallo della mezzanotte. Il cambio turno usa il fuso orario impostato (non l'ora del PC): all'inizio di ogni turno si azzerano i contatori del turno, mentre i work order conservano i loro totali. L'OEE e i report si possono leggere per turno.
Integrazione ERP e MES
I sistemi esterni creano, modificano, avviano ed eliminano i work order e ne leggono l'avanzamento tramite API REST, tabella di scambio su database (compatibile con la versione 1) o MQTT. I canali si attivano in Impostazioni › Integrazione work order. Dalla versione 2.5 il gestionale invia e legge anche clienti, materiali e articoli con la distinta base, legge i consumi di materiale e, con il modulo Magazzino, le giacenze. Tutti i dettagli, con esempi, sono nella guida all'integrazione.
Utenti e registro attività
| Ruolo | Cosa può fare |
|---|---|
| Operatore | Work order, HMI, telemetria, OEE, report, energia, allarmi, storico. Non vede le Impostazioni. |
| Capo reparto | Come l'operatore, in più gestisce anagrafiche (clienti, articoli, materiali, distinte) e magazzino. |
| Amministratore | Tutto, più Impostazioni, licenza e Operatori e registro. Si crea nella configurazione guidata. |
L'amministratore crea gli account degli operatori in Operatori e registro (nome utente, nome e cognome, password iniziale di almeno 8 caratteri) e può modificarli, disattivarli o eliminarli: un account disattivato viene scollegato subito. Ogni utente cambia la propria password da La mia password.
Il registro attività elenca ogni operazione fatta nell'interfaccia: accessi (anche quelli rifiutati), uscite, creazione, modifica, spostamento, cambio di stato, scarti, pezzi aggiunti, allegati ed eliminazione dei work order, invio dei programmi alla macchina, gestione degli account, salvataggio delle impostazioni. Si filtra per periodo, utente e attività e si esporta in CSV (fino a 1000 voci, data e ora in UTC). Dall'interfaccia non si modifica né si cancella.

Licenza
La licenza si attiva con la chiave (XXXX-XXXX-XXXX-XXXX) nella configurazione guidata o in Impostazioni › Servizi, energia e licenza, e si verifica via internet con il servizio licenze. Senza chiave parte una prova gratuita di 30 giorni.
- Se la connessione manca, RTIndustry continua a lavorare normalmente e riprova da solo.
- Se l'azienda esce su internet tramite proxy, se ne indicano indirizzo ed eventuali utente e password.
- Una licenza scaduta porta l'interfaccia in sola lettura: i dati si vedono ma non si modificano. Va rinnovata entro 30 giorni.
- Ogni chiave ha un numero di posti: ogni installazione o istanza ne occupa uno. Per più macchine si usa di solito una sola chiave con tanti posti quante sono le macchine. Disattiva licenza libera il posto per un altro PC, ma ferma la raccolta dati su quello attuale finché non la si riattiva.
- La licenza può comprendere i moduli Anagrafiche (con distinta e consumi), Archivio aziendale e Magazzino. Un modulo non compreso nasconde le sue funzioni ma non cancella i dati.
I messaggi della licenza e cosa fare sono spiegati nel manuale.
Rete e sicurezza
- Accesso con account personali; password conservate in forma cifrata (hash), mai in chiaro.
- Sessione firmata con una chiave generata al primo avvio sul PC, protezione delle scritture da richieste esterne.
- Porte: 1880 (interfaccia e API REST) e 1883 (MQTT). Il protocollo HTTPS si attiva installando un certificato sul PC.
- API ERP con chiave generata dall'amministratore e mostrata una sola volta: RTIndustry ne conserva solo l'impronta.
- MQTT: la telemetria è leggibile, ma i comandi sui work order sono accettati solo da client autenticati.
- Password della macchina, del proxy e dei database esterni conservate cifrate sul PC.
- Il file di diagnostica per l'assistenza non contiene password.
- Archivio aziendale: anagrafiche, consumi e magazzino partono dalla postazione già cifrati (AES-256-GCM) con una chiave che ha solo l'azienda, sulla stessa connessione HTTPS della licenza: nessuna porta in più. Il servizio online li conserva senza poterli leggere.
Antivirus e firewall
Con il solo antivirus di Windows (Defender) l'installer configura tutto da solo. Molti antivirus di terze parti, soprattutto nelle versioni a pagamento o di prova (Avast, AVG, Kaspersky, ESET, Bitdefender, Norton…), installano invece un firewall proprio che sostituisce quello di Windows: le regole create dall'installer non valgono e tablet e PC dell'officina non raggiungono la dashboard, anche se sul PC di RTIndustry si apre normalmente. Alcuni segnalano per errore l'icona RTIndustryTray.exe (falso positivo per un programma nuovo).
- Aggiungi alle eccezioni dell'antivirus la cartella
C:\RTIndustrye quelle delle istanze (C:\RTIndustry-…). - Nel firewall dell'antivirus consenti le connessioni in ingresso a
C:\RTIndustry\node\node.exe(uno per istanza), oppure imposta la rete dell'officina come privata o attendibile. - Se l'icona è finita in quarantena, ripristinala e riavvia il PC: la raccolta dati (servizio) continua comunque.
- Su server e PC aziendali con protezione centralizzata (EDR come Cortex XDR, CrowdStrike, SentinelOne) l'icona
RTIndustryTray.exepuò essere cancellata senza avvisi subito dopo l'installazione: l'autodiagnosi lo segnala. Serve un'esclusione per le cartelle di RTIndustry da parte del reparto IT, poi si reinstalla scegliendo «aggiorna». - Prova sempre l'accesso da un tablet. Lo strumento di verifica segnala la presenza di un firewall di terze parti.
Dati e backup
- I dati stanno nella cartella
C:\RTIndustry\data, accessibile solo agli amministratori di Windows. - Backup automatico giornaliero del database in
data\backups: si conservano gli ultimi 7 giorni e 4 domeniche. Si può impostare una copia secondaria (per esempio su un'altra unità) e lanciare un backup a mano da Impostazioni › Servizi, energia e licenza. - All'avvio il database viene controllato; se risulta danneggiato si ripristina dall'ultimo backup valido. Prima di ogni aggiornamento del database viene fatta una copia di sicurezza.
- I log di funzionamento sono in
data\logs, con rotazione automatica. - Con l'archivio aziendale attivo, anagrafiche, consumi e magazzino sono anche sul servizio online, cifrati: si recuperano su un PC nuovo con il codice di recupero stampato all'attivazione.
Servizio e icona nell'area di notifica
Vicino all'orologio di Windows c'è l'icona di RTIndustry:
- Verde: servizio attivo e licenza valida.
- Gialla: configurazione da completare o avviso (per esempio licenza in scadenza).
- Rossa: servizio fermo o licenza non attiva.
Con il clic destro: versione installata, stato di servizio e licenza, Apri Dashboard, Impostazioni, Ferma/Riavvia servizio, Mostra log. Gli utenti di Windows possono fermare e riavviare il servizio dall'icona senza permessi di amministratore.
Aggiornamenti e passaggio dalla versione 1
Un aggiornamento si installa sopra la versione precedente: configurazione e dati restano dove sono e gli aggiornamenti del database si applicano all'avvio, dopo una copia di sicurezza.
Chi usa RTIndustry 1 può passare alla 2.0 mantenendo lo storico (work order, turni, allarmi), la configurazione della macchina, gli utenti e la stessa licenza. La migrazione la esegue il tecnico sul PC che ospiterà la nuova versione. Le integrazioni ERP basate sulle tabelle writewo/readwo continuano a funzionare (vedi tabella di scambio).
Problemi frequenti
La macchina risulta «Spenta o non raggiungibile»
- Verifica che la macchina sia accesa e il cavo di rete collegato.
- In Impostazioni premi Testa connessione: il messaggio indica cosa non va (indirizzo, porta, credenziali).
- Lancia
C:\RTIndustry\strumenti\Verifica-RTIndustry.batper controllare rete e porta del protocollo.
I pezzi non aumentano
- Controlla che ci sia un work order In corso e che la macchina sia In lavorazione.
- In Impostazioni › Mapping stati e modi · contapezzi verifica la variabile del contapezzi.
- Se il contapezzi della macchina resta a 0, attiva il conteggio a fine programma; con Heidenhain verifica che il programma finisca con M30, M2 o END PGM.
La pagina non si apre
- Guarda l'icona nell'area di notifica: se è rossa, clic destro › Riavvia servizio.
- Da un altro PC usa l'indirizzo
http://NOME-O-IP-DEL-PC:1880(istanze aggiuntive: 1890, 1900…) e verifica che il firewall non blocchi la porta.
Dal PC la dashboard si apre, dai tablet no
- Quasi sempre è il firewall dell'antivirus: vedi Antivirus e firewall.
Avviso «Cicli brevi» nelle Impostazioni
- Con il conteggio a fine programma alcuni pezzi possono sfuggire: usa il contapezzi della macchina o un contatore nel PLC (vedi Variabili, stati e contapezzi).
I consumi sembrano 10, 100 o 1000 volte sbagliati
- Il fattore di scala del contatore di energia non è giusto: il valore deve risultare in Wh (vedi Contatore di energia). Confronta la prova di lettura con il display del contatore.
Codici di errore
| Codice | Significato e soluzione |
|---|---|
RTI-E001 | Il programma non si avvia su questo PC (cartella copiata da un altro PC, nome del PC cambiato o Windows reinstallato). Reinstalla RTIndustry: i dati vengono conservati. |
RTI-E011 | La porta 1880 è occupata da un altro programma (per esempio la versione precedente). Chiudi l'altro programma o cambia porta. |
RTI-E020 / E021 | Problema del database. Contatta l'assistenza: esistono backup automatici giornalieri. |
RTI-E030 | Identità dell'installazione non leggibile: va riattivata la licenza. |
Assistenza
Per dubbi o problemi contatta il tecnico o il rivenditore che ha installato RTIndustry, oppure scrivi a assistenza@rtindustry.it. Allega il file della diagnostica (Impostazioni › Esporta diagnostica) oppure, se il programma non si apre, la pagella dello strumento di verifica.
Per una demo o informazioni commerciali: demo@rtindustry.it.