Table of Contents
LinkMachine Documentation
Benvenuti nella documentazione tecnica del sistema LinkMachine.
La documentazione è suddivisa nelle seguenti sezioni:
- Integrazione Industry 4.0
- LinkMachine Core - Manuale integrazione
- LinkMachine Panel - Manuale integrazione
Integrazione Industry 4.0
LinkMachine è un sistema progettato per collegare le macchine di produzione ai sistemi informativi aziendali.
Architettura generale
Macchina
↓
LinkMachine Panel
↓
LinkMachine Core
↓
Database MySQL
↓
ERP / MES
LinkMachine Core - Manuale integrazione
LinkMachine Core - Introduzione
Manuale di installazione e integrazione.
LinkMachine Core è il software centrale installato sul server aziendale che gestisce la comunicazione con i pannelli LinkMachine installati a bordo macchina.
Il sistema è progettato per raccogliere e gestire i dati di produzione provenienti dalle postazioni operative, consentendo l’integrazione con i sistemi informativi aziendali e con eventuali piattaforme MES.
LinkMachine Core riceve le informazioni trasmesse dai pannelli LinkMachine, che possono includere dati di produzione, stati macchina, identificativi di lotto, codici operatore e altre informazioni legate ai processi produttivi. I dati raccolti vengono elaborati e salvati su database, rendendoli disponibili per successive analisi, consultazioni o integrazioni con software gestionali.
Il software funge quindi da nodo centrale di raccolta e distribuzione delle informazioni, permettendo di collegare più pannelli installati sulle diverse macchine dell’impianto e di gestire in modo unificato i flussi informativi provenienti dal reparto produttivo.
Grazie alla sua architettura modulare, LinkMachine Core può essere integrato con diversi sistemi di database e può dialogare con applicativi esterni, tra cui sistemi MES, software gestionali o piattaforme di monitoraggio della produzione.
In questo modo il sistema consente di digitalizzare la raccolta dei dati di fabbrica, migliorare la tracciabilità delle lavorazioni e supportare le aziende nei processi di integrazione e automazione tipici dei contesti Industria 4.0 e 5.0.
Funzioni principali:
- comunicazione con pannelli
- raccolta dati produzione
- integrazione con database
- interfacciamento con sistemi MES
Installazione server
Per il corretto funzionamento di LinkMachine Core il sistema su cui verrà installato il software deve rispettare i seguenti requisiti minimi.
Sistema operativo
Microsoft Windows 7 Professional 64 bit o versione successiva.
Connettività di rete
Il server deve disporre di una o due porte Ethernet, a seconda della configurazione della rete aziendale e del collegamento con i macchinari.
Configurazione con rete separata macchina / aziendale Nel caso in cui la rete del macchinario sia isolata dalla rete aziendale, il server dovrà disporre di due interfacce Ethernet:
una collegata direttamente alla rete del macchinario
una collegata alla rete aziendale
Configurazione con rete condivisa Nel caso in cui il macchinario sia collegato alla rete aziendale, sarà sufficiente una sola porta Ethernet, collegata alla stessa rete del macchinario. In questa configurazione il macchinario deve essere raggiungibile tramite comando PING dal server su cui verrà installato LinkMachine Core.
Spazio su disco
Almeno 10 GB di spazio libero su disco.
Risoluzione schermo
Risoluzione minima supportata: 1024 × 768 pixel.
Permessi di installazione
Durante la fase di installazione sarà necessario utilizzare un account con privilegi di amministratore locale, in modo da consentire la corretta configurazione del software e dei servizi di sistema.
Configurazione

Ogni agente LinkMachine utilizza un file config.ini presente nella
stessa cartella dell'eseguibile.
Per ogni pannello/macchina gestita dal sistema deve esistere una cartella dedicata contenente l'agente LinkMachine.
Struttura cartelle
Esempio struttura del sistema:
C:\LinkMachine\
│
├─ ctrlprocess.exe
│
├─ linkmachine1\
│ ├─ linkmachine1.exe
│ └─ config.ini
│
├─ linkmachine2\
│ ├─ linkmachine2.exe
│ └─ config.ini
│
└─ linkmachine3\
├─ linkmachine3.exe
└─ config.ini
Il programma ctrlprocess.exe è installato nella cartella principale
LinkMachine e viene eseguito come servizio di sistema.
Il suo compito è monitorare gli agenti LinkMachine e garantirne la corretta esecuzione.
Ogni cartella linkmachineX contiene invece l'agente dedicato a una
specifica macchina o pannello.
File di configurazione config.ini
Il file config.ini contiene tutti i parametri necessari per il
funzionamento dell'agente.
Esempio di configurazione
[Pannello]
ipaddress=192.168.11.79
[SrvMysql]
strServerName=192.168.11.11
strDriverodbc={MySQL ODBC 8.0 ANSI Driver}
strDatabaseName=linkmachine
strUserName=root1
strPassword=Password
[parametri]
etichettatrice=\\192.168.0.9\stampaetich\metrologica\
etichettatrice1=\\192.168.0.9\stampaetich\produzione1\
etichettatrice2=\\192.168.0.9\stampaetich\produzione2\
pdfpath=\\192.168.10.11\readypro\Archivio_RV\
macchina=PRESSA2
codmacchina=290
debug=0
ricettaPRE=1742
barcodeMPPRE=0
barcodeMPPRE1=0
barcodeMPPRE2=0
barcodeMPPRE3=0
barcodeMPPRE4=0
lottoPRE=0
distintaPRE=0
desricetta=0
closeerror=1
ordernumPRE=21101
exchangeS7=0
exchangeFL=0
exchangeOT=0
exchangeMB=0
exchangeOU=0
idartifin=1014
stampante1=OKIB412(PCL6)
[step7]
tipoMacchinaS7=2
ips7=192.168.0.94
[file]
tipoMacchinaFL=1
[altro]
tipoMacchinaOT=1
[registri]
inidesricetta=371
[dati]
lastERROR=
Descrizione delle sezioni del file config.ini
[Pannello]
Contiene i parametri di collegamento al pannello operatore installato sulla macchina.
Parametro principale:
- ipaddress → indirizzo IP del pannello HMI utilizzato per la comunicazione con il sistema LinkMachine.
[SrvMysql]
Contiene i parametri di connessione al database MySQL utilizzato dal sistema LinkMachine per la gestione dei dati di produzione, ricette, lotti e tracciabilità.
Parametri principali:
- strServerName → indirizzo IP del server MySQL
- strDatabaseName → nome del database utilizzato dal sistema
- strUserName → utente utilizzato per la connessione al database
- strPassword → password dell’utente database
- strDriverodbc → driver ODBC utilizzato per la connessione MySQL
[parametri]
Contiene i principali parametri operativi associati alla macchina gestita dall’agente LinkMachine.
In questa sezione vengono configurati, ad esempio:
- identificativo della macchina
- percorsi di stampa etichette
- percorsi archivio documenti o PDF
- configurazione stampanti
- parametri di ricetta e produzione
- modalità di comunicazione con PLC o sistemi esterni
[step7]
Contiene i parametri necessari alla comunicazione con PLC Siemens tramite protocollo S7.
Parametri principali:
- ips7 → indirizzo IP del PLC Siemens
- tipoMacchinaS7 → tipologia di macchina o configurazione di comunicazione utilizzata con il PLC
Parametri di integrazione macchina
I seguenti parametri definiscono la modalità di comunicazione utilizzata tra LinkMachine e la macchina o il PLC.
| parametro | descrizione |
|---|---|
| exchangeS7 | Abilita la comunicazione con PLC Siemens S7. Se attivo, LinkMachine utilizza il protocollo S7 tramite l'indirizzo IP configurato nella sezione [step7]. |
| exchangeMB | Abilita la comunicazione tramite protocollo Modbus (Modbus TCP o RTU a seconda della configurazione macchina). |
| exchangeOU | Abilita la comunicazione tramite OPC UA. |
| exchangeFL | Abilita lo scambio dati tramite file. In questa modalità LinkMachine legge o scrive file utilizzati dalla macchina o da altri sistemi per lo scambio delle informazioni. |
| exchangeOT | Modalità di comunicazione Other utilizzata per integrazioni personalizzate con macchine o sistemi specifici. |
Valori possibili
Per i parametri:
exchangeS7exchangeMBexchangeOUexchangeFL
i valori possibili sono:
0→ comunicazione disabilitata1→ comunicazione abilitata
Per il parametro:
exchangeOT
i valori possono essere diversi da 0 e 1 e identificano modalità di integrazione specifiche definite per la macchina o il progetto.
Database
Il sistema utilizza preferibilmente MySQL o MariaDB.
Tabella programmazione
Nel database è presente una tabella programmazione, utilizzata per gestire gli ordini pianificati sulle singole macchine.
| Campo | Tipo | Descrizione |
|---|---|---|
| cod_macchina | varchar | codice identificativo della macchina |
| ordine | varchar | numero o codice ordine di produzione |
| ricetta | varchar | codice ricetta associata alla produzione |
| des_ricetta | varchar | descrizione della ricetta |
| qta_programmata | long | quantità pianificata da produrre |
| qta_prodotta | long | quantità effettivamente prodotta |
| stato | varchar | stato dell’ordine o della lavorazione |
| ordinamento | long | valore numerico utilizzato per definire la sequenza di lavorazione |
Note
- qta_programmata contiene la quantità prevista per l’ordine.
- qta_prodotta viene aggiornata in base all’avanzamento reale della produzione.
- stato può assumere valori come ad esempio:
Da fareIn corsoCompletatoSospeso- ordinamento consente di stabilire la priorità o la posizione dell’ordine nella coda di produzione della macchina.
Esempio SQL
```sql SELECT * FROM programmazione ORDER BY cod_macchina, ordinamento;
Integrazione MES
Il sistema MES può interrogare direttamente il database.
Esempio tabella ordini
| Campo | Tipo |
|---|---|
| id | int |
| ordine | varchar |
| articolo | varchar |
| qta_prevista | int |
Query esempio
SELECT * FROM ordini;
Risoluzione problemi
Il pannello non comunica
Verificare:
- rete
- indirizzo IP
- firewall
LinkMachine Panel - Manuale integrazione
LinkMachine Panel
Il pannello LinkMachine è installato a bordo macchina e consente all'operatore di interagire con il sistema.
Installazione pannello
Installare il pannello vicino alla macchina e collegarlo alla rete.
Utilizzo operatore
Il pannello consente di:
- selezionare ordini
- avviare produzione
- inserire dati