Come documentare un progetto di interconnessione industriale

Una buona documentazione è la differenza tra un progetto di interconnessione che può essere mantenuto e scalato nel tempo, e uno che diventa incomprensibile al primo cambio di personale tecnico. Nei progetti industriali questo vale doppio: i sistemi durano anni, le persone cambiano, e la documentazione è spesso l’unico modo per capire come funziona un’integrazione esistente.

1. Mappa dei segnali

Il documento più importante di qualsiasi progetto di interconnessione. Per ogni segnale raccolta dalla macchina deve essere documentato:

• Nome tecnico del segnale nel sistema (es. machine_01.state)
• Sorgente: indirizzo nel PLC, variabile OPC UA, contatto I/O
• Tipo di dato: booleano, intero, float, stringa
• Unità di misura (secondi, pezzi, mm/min…)
• Frequenza di aggiornamento configurata
• Funzione nel sistema: a cosa serve nel MES (OEE, tracciabilità, allarme, part program)

Senza questa mappa, capire da dove viene un dato nel MES richiede di rileggere il codice del driver.

2. Protocollo e driver utilizzati

• Protocollo scelto per ogni macchinario (OPC UA, FOCAS, S7, Modbus, RS232…)
• Versione del driver e data di installazione
• Parametri di configurazione: IP, porta, polling interval, timeout
• Eventuali configurazioni specifiche: indirizzo DB per S7, node ID per OPC UA, baud rate per RS232
• Licenze necessarie sul macchinario (es. licenza FOCAS Fanuc)

3. Architettura del sistema

Un diagramma dell’architettura che mostri come sono connessi i componenti: macchinari → middleware → MES → ERP. Il diagramma deve includere:

• Tutti i macchinari connessi con marca, modello e protocollo
• Il middleware (es. Exchanger) con il server su cui è installato
• I sistemi a valle (MES, ERP, database) e le interfacce usate (API, DB)
• La topologia di rete: VLAN, switch, indirizzi IP

4. Diagnostica e log

Documentare come viene gestita la diagnostica del sistema:

• Dove si trovano i log delle connessioni (percorso file o sistema di logging)
• Come si interpretano gli errori più comuni (timeout, disconnessione, dato non disponibile)
• Chi riceve le notifiche di errore e tramite quale canale
• Procedura di primo intervento in caso di dati mancanti nel MES

5. Manutenzione e aggiornamenti

• Procedura per aggiornare un driver senza interrompere le altre connessioni
• Come aggiungere una nuova macchina al sistema
• Procedura di backup della configurazione del middleware
• Contatti per supporto tecnico (fornitore del middleware, sistemista di rete)

6. Registro delle modifiche

Un log cronologico delle modifiche significative al sistema: aggiunta di una macchina, cambio di protocollo, modifica delle frequenze di polling, aggiornamenti firmware. Ogni voce deve includere data, autore e motivazione della modifica. È il documento che permette di capire perché il sistema è configurato in un certo modo, mesi o anni dopo.

Stai documentando un progetto di interconnessione? Possiamo aiutarti.