Documentazione tecnica RTIndustry 2.0

Per chi installa e mantiene RTIndustry: requisiti, installazione, collegamento alla macchina, licenza, rete, backup e soluzione dei problemi. Per l'uso quotidiano delle schermate c'è il manuale d'uso.

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 Assistenza

Panoramica

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.

ComponenteCosa fa
Servizio RTIndustryParte con Windows e raccoglie i dati anche a browser chiuso. Si riavvia da solo in caso di errore.
Interfaccia webPorta 1880: Work order, HMI macchina, Telemetria, OEE, Report, Energia, Allarmi, Storico WO, Impostazioni, Operatori e registro.
Database integratoWork order, storico dei turni, allarmi, impostazioni e registro attività. Non serve installare un database a parte.
Broker MQTT integratoPorta 1883: telemetria in uscita e comandi sui work order dai sistemi esterni autenticati.
Icona nell'area di notificaStato del servizio e della licenza a colori, apertura della dashboard, riavvio del servizio, log.
Manuale d'usoIncluso nel programma (pulsante «? Guida» in ogni schermata) e disponibile online.

Requisiti

VoceRequisito
Sistema operativoWindows 10 versione 1809 o successiva, Windows 11, Windows Server 2019 o successivo. Solo 64 bit.
MemoriaAlmeno 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).
DiscoAlmeno 2 GB liberi; consigliati 10 GB per conservare anni di storico e i backup.
Rete verso la macchinaCollegamento Ethernet al CNC o al PLC (vedi porte per protocollo).
Porte locali1880 (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.
InternetPer la verifica della licenza, anche tramite proxy aziendale. Senza connessione il programma continua a lavorare.
AlimentazioneIl PC non deve andare in sospensione: con il PC sospeso i dati non vengono raccolti.
BrowserUn browser aggiornato (Chrome, Edge, Firefox, Safari) su PC, tablet o telefono.
InstallazioneServe 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

  1. Avvia l'installer di RTIndustry con un account amministratore. La cartella predefinita è C:\RTIndustry.
  2. L'installer crea il servizio Windows RTIndustry con avvio automatico e riavvio automatico in caso di errore, apre nel firewall le porte 1880 e 1883 e protegge la cartella dei dati.
  3. Al termine si apre il browser sulla configurazione guidata.
CartellaContenutoAgli aggiornamenti
app\, node\, tray\Programma, runtime e icona dell'area di notificaSostituite
config\Configurazione di avvio (porta, cartella dati)Mai sovrascritta
data\Database, backup, log, identità dell'installazioneMai toccata
strumenti\Strumento di verifica di PC, rete e macchinaSostituita
Il programma è legato al PC su cui è installato: non copiare la cartella su un altro computer. Per spostare RTIndustry su un nuovo PC si reinstalla e si trasferisce la licenza (vedi Licenza).

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.

  1. Installa RTIndustry la prima volta: è l'istanza principale (C:\RTIndustry, porta 1880).
  2. Avvia di nuovo l'installer: scegli Installare una nuova istanza e dai un nome (lettere, cifre e trattini, per esempio Fresa2 o TORNIO-01).
  3. 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 principaleIstanza «Fresa2»
CartellaC:\RTIndustryC:\RTIndustry-Fresa2
Servizio WindowsRTIndustryRTIndustry-Fresa2
Porte (dashboard / MQTT)1880 / 1883prime libere: 1890 / 1893, poi 1900 / 1903…
Icona, dati, backup, licenzapropri 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.

Ogni istanza occupa un posto della licenza: per 8 macchine serve una chiave con 8 posti (vedi Licenza).

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.

  1. Azienda: nome dell'azienda (obbligatorio), stabilimento, reparto, nome della macchina e fuso orario (per l'Italia Europe/Rome, l'ora legale è automatica).
  2. 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.
  3. Turni: orari di inizio e fine di ogni turno, anche a cavallo della mezzanotte.
  4. Licenza: chiave nel formato XXXX-XXXX-XXXX-XXXX e Attiva licenza. Senza chiave parte una prova gratuita di 30 giorni. In Opzioni avanzate si indica l'eventuale proxy aziendale.
  5. Amministratore: nome utente e password (almeno 8 caratteri) del primo amministratore.
  6. Avvio: riepilogo e Avvia RTIndustry.

Passo Macchina della configurazione guidata di 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.

ProtocolloMacchineNote
OPC UAPLC e CNC con server OPC UAIndirizzo 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 FOCASCNC FANUC con Ethernet integrataPorta 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 DNCTNC 640, TNC 6xx, TNC 320, TNC 128, iTNC 530, CNC PILOT 6xx, MANUALplus 620, MillPlus ITPorta 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 TCPPLC e moduli di I/OIndirizzo 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.
SimulatoreNessuna macchinaDati 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à

RuoloCosa può fare
OperatoreWork order, HMI, telemetria, OEE, report, energia, allarmi, storico. Non vede le Impostazioni.
Capo repartoCome l'operatore, in più gestisce anagrafiche (clienti, articoli, materiali, distinte) e magazzino.
AmministratoreTutto, 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.

Operatori e registro attività in RTIndustry

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.

I messaggi della licenza e cosa fare sono spiegati nel manuale.

Rete e sicurezza

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).

Dati e backup

Servizio e icona nell'area di notifica

Vicino all'orologio di Windows c'è l'icona di RTIndustry:

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»

I pezzi non aumentano

La pagina non si apre

Dal PC la dashboard si apre, dai tablet no

Avviso «Cicli brevi» nelle Impostazioni

I consumi sembrano 10, 100 o 1000 volte sbagliati

Codici di errore

CodiceSignificato e soluzione
RTI-E001Il 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-E011La porta 1880 è occupata da un altro programma (per esempio la versione precedente). Chiudi l'altro programma o cambia porta.
RTI-E020 / E021Problema del database. Contatta l'assistenza: esistono backup automatici giornalieri.
RTI-E030Identità 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.