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

Il sistema si basa su un'architettura modulare composta da:

Panel → installato a bordo macchina, acquisisce i segnali
Core → installato su server, gestisce logica e comunicazioni
Database → centralizza tutte le informazioni
ERP/MES → Integrezione con sistema gestionale aziendale

Gestione del flusso dei dati

Il sistema LinkMachine garantisce la bidirezionalità delle informazioni tra produzione e sistemi gestionali.

Il flusso dei dati può avvenire in due modalità:

Con integrazione ERP/MES
In modalità standalone (senza gestionale)

Flusso dati con gestionale (ERP / MES)

In questo scenario il gestionale aziendale è il punto di origine della pianificazione della produzione.

1. Pianificazione

Il gestionale alimenta una tabella (o vista) di programmazione contenente:

cod_macchina
ordine
ricetta
des_ricetta
qta_programmata
qta_prodotta
stato
ordinamento

Questa tabella:

rappresenta la coda di lavoro delle macchine
può risiedere su database esterno
viene utilizzata da LinkMachine in sola lettura

2. Visualizzazione a bordo macchina

Il LinkMachine Panel:

legge i dati dal Core
mostra all’operatore le lavorazioni disponibili

3. Avvio produzione

L’operatore:

seleziona la lavorazione
avvia la produzione sulla macchina

4. Raccolta dati

Durante la lavorazione il pannello acquisisce:

impulsi di produzione (conteggio pezzi)
stato macchina (marcia, fermo, allarme)
eventuali segnalazioni (es. materia prima esaurita)

5. Registrazione dati

Il LinkMachine Core salva le informazioni nelle seguenti tabelle:

Produzione (`produzione`)

quantità prodotte
timestamp lavorazioni

Eventi (`eventi`)

allarmi
anomalie
cambi stato

Stato macchine (`dati_macchine`)

stato realtime delle macchine
aggiornato continuamente
1 record per ogni pannello/machine

6. Integrazione con ERP

Il gestionale può:

leggere la produzione consuntivata
aggiornare lo stato delle commesse
analizzare performance e tempi macchina

L’integrazione può avvenire tramite:

accesso diretto al database
viste dedicate
sincronizzazioni programmate

Flusso dati senza gestionale

In assenza di ERP/MES, LinkMachine gestisce direttamente la pianificazione.

1. Inserimento lavorazioni

L’utente inserisce manualmente i dati nella tabella programmazione

2. Esecuzione produzione

Il flusso operativo è identico:

selezione lavorazione da pannello
avvio produzione
raccolta dati in tempo reale

3. Registrazione dati

Il sistema popola automaticamente:

produzione
eventi
dati_macchine

4. Consultazione dati

Le informazioni possono essere utilizzate tramite:

query dirette su database
report personalizzati
dashboard
future integrazioni ERP

Note di integrazione

La tabella programmazione può essere:
interna al sistema
esterna (ERP/MES)
una vista ODBC
Modalità operative:
Read Only → con gestionale
Read/Write → standalone
Possibili estensioni:
trigger database verso ERP
esportazioni automatiche
integrazione MES custom
API future

Considerazioni

LinkMachine si adatta a qualsiasi contesto produttivo:

integrazione completa con sistemi esistenti
utilizzo standalone per realtà non strutturate
scalabilità su più macchine e più reparti

Il sistema rappresenta il punto centrale per la digitalizzazione dei processi produttivi in ottica Industry 4.0.

LinkMachine Core - Manuale integrazione

LinkMachine Core - Introduzione

Schema LinkMachine

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.

Sistema operativo

Windows Server 2016 o successivo (consigliato)
In alternativa: Windows 10/11 Professional 64 bit per installazioni di piccole dimensioni

Dimensionamento del sistema

Il dimensionamento della macchina dipende dal numero di pannelli LinkMachine (agenti) collegati:

Fino a 6 agenti LinkMachine:
è possibile installare il sistema su un server già utilizzato per altri servizi aziendali
Oltre 6 agenti LinkMachine:
è fortemente consigliato utilizzare una macchina (preferibilmente virtuale) dedicata, al fine di garantire:
maggiore stabilità del sistema
isolamento delle risorse
migliori prestazioni nella gestione dei dati in tempo reale

La macchina virtuale può essere configurata su infrastrutture esistenti (VMware, Hyper-V, Proxmox, ecc.) in base alle policy IT aziendali.

Requisiti hardware

I requisiti hardware variano in base al numero di macchine collegate e al volume di dati gestiti.

Configurazione minima

CPU: 2 core
RAM: 4 GB
Disco: 10 GB liberi

Configurazione consigliata

CPU: 4 core o superiore
RAM: 8 GB o superiore
Disco: SSD consigliato per migliori prestazioni

Connettività di rete

Il server deve disporre di una o due interfacce 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 dei macchinari sia isolata dalla rete aziendale, il server dovrà disporre di due interfacce Ethernet:

una collegata alla rete dei macchinari
una collegata alla rete aziendale

Configurazione con rete condivisa

Nel caso in cui i macchinari siano collegati direttamente alla rete aziendale, è sufficiente una sola interfaccia Ethernet.

In questa configurazione, i pannelli LinkMachine devono essere raggiungibili dal server (ad esempio tramite comando PING).

Porte di comunicazione

Per il corretto funzionamento del sistema è necessario consentire la comunicazione sulla:

porta TCP (default: 502)

Tale porta deve essere aperta tra il server LinkMachine Core e i pannelli installati a bordo macchina.

Accesso remoto per configurazione e assistenza

Per consentire le attività di configurazione, aggiornamento e assistenza tecnica, è necessario prevedere una modalità di accesso remoto al server.

Sono supportate le seguenti modalità:

VPN aziendale (soluzione consigliata)
Software di accesso remoto come Supremo

L’accesso dovrà essere autorizzato dal cliente e attivato solo quando necessario.

Antivirus e sicurezza

Per evitare blocchi o rallentamenti del sistema, è consigliato configurare l’antivirus escludendo:

la cartella di installazione di LinkMachine Core
eventuali cartelle di log e scambio dati
il servizio/database utilizzato (es. MySQL)

Le esclusioni devono essere configurate secondo le policy IT aziendali.

Risoluzione schermo

Risoluzione minima supportata: 1024 × 768 pixel

Permessi di installazione

Durante la fase di installazione è necessario utilizzare un account con privilegi di amministratore locale, al fine di consentire la corretta configurazione del software e dei servizi di sistema.

Configurazione

Agente LinkMachine

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

[Mes]
strServerNameMES=192.168.11.11
strDriverodbcMES={MySQL ODBC 8.0 ANSI Driver}
strDatabaseNameMES=linkmachine
strUserNameMES=root1
strPasswordMES=Password
strTableProdMes=Produzione

[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:

exchangeS7
exchangeMB
exchangeOU
exchangeFL

i valori possibili sono:

0 → comunicazione disabilitata
1 → 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 LinkMachine utilizza preferibilmente un database relazionale MySQL o MariaDB per gestire l’integrazione tra pianificazione, produzione e raccolta dati in tempo reale.

L’architettura database è basata su 4 tabelle principali, ciascuna con un ruolo ben definito.

Panoramica tabelle

Tabella	Ruolo	Modalità
`programmazione`	Pianificazione ordini di produzione	Sola lettura (da gestionale)
`programmazione_link`	Avanzamento reale produzione	Scrittura LinkMachine
`registro_pannello`	Log eventi e tracciabilità	Scrittura LinkMachine
`dati_macchine`	Stato realtime macchine/pannelli	Scrittura LinkMachine

Schema logico

👉 Pianificazione → programmazione
👉 Produzione → programmazione_link
👉 Eventi → registro_pannello
👉 Realtime → dati_macchine

Descrizione sintetica

`programmazione`

Contiene gli ordini di produzione pianificati.
Viene alimentata dal gestionale aziendale (ERP/MES) ed è utilizzata da LinkMachine in sola lettura.

`programmazione_link`

Contiene lo stato reale della produzione.
Viene gestita direttamente da LinkMachine durante l’avanzamento delle lavorazioni.

`registro_pannello`

Raccoglie gli eventi provenienti dal pannello operatore e dalla macchina.
È utilizzata per debug, tracciabilità e audit.

`dati_macchine`

Contiene lo stato aggiornato in tempo reale delle macchine/pannelli collegati.
Rappresenta una fotografia istantanea del sistema produttivo.

Vantaggi dell’architettura

separazione chiara tra pianificato e reale
alta tracciabilità delle operazioni
scalabilità su più macchine e pannelli
integrazione semplice con sistemi esterni
possibilità di collegamento con ERP/MES già esistenti

Architettura Database

Il sistema LinkMachine utilizza un database relazionale per coordinare la comunicazione tra:

pianificazione proveniente dal gestionale
produzione reale effettuata dalle macchine
eventi operativi rilevati dai pannelli
stato realtime del sistema produttivo

L’architettura è costruita per separare chiaramente:

il dato pianificato
il dato consuntivo
il dato di log
il dato realtime

Modello logico

Area	Tabella	Descrizione
Pianificazione	`programmazione`	ordini pianificati provenienti dal gestionale
Consuntivazione	`programmazione_link`	stato avanzamento reale produzione
Eventi	`registro_pannello`	log operazioni pannello/macchina
Realtime	`dati_macchine`	ultimo stato noto macchina/pannello

Flusso operativo

Il gestionale alimenta la tabella programmazione
LinkMachine legge la coda di lavoro
All’avvio della produzione, LinkMachine scrive su programmazione_link
Durante il ciclo operativo registra eventi in registro_pannello
Aggiorna continuamente lo stato corrente in dati_macchine

Obiettivi dell’architettura

non duplicare inutilmente i dati gestionali
rendere il sistema integrabile con diversi ERP/MES
mantenere storico e tracciabilità degli eventi
fornire uno stato macchina aggiornato in tempo reale
facilitare esportazioni o sincronizzazioni verso sistemi esterni

Integrazione con gestionali

Il sistema LinkMachine è progettato per integrarsi con gestionali aziendali, ERP o MES tramite diverse modalità.

Tabella `programmazione`

La tabella programmazione contiene gli ordini di produzione pianificati ed è utilizzata da LinkMachine in sola lettura.

Rappresenta la coda di lavoro delle macchine.

Origine dati

La tabella programmazione non deve necessariamente risiedere nello stesso database di LinkMachine.

Può essere:

nello stesso database MySQL/MariaDB
su un database esterno (es. MySQL, SQL Server)
accessibile tramite ODBC
una vista (VIEW) esposta dal gestionale

Configurazione

I parametri di connessione e accesso vengono definiti nel file di configurazione del sistema (config.ini o equivalente), dove è possibile specificare:

tipo di connessione (MySQL, MSSQL, ODBC)
host / server
database
credenziali
eventuale query o vista da utilizzare

Vantaggi

Questa architettura consente:

integrazione con qualsiasi gestionale esistente
nessuna duplicazione dei dati
aggiornamento automatico della pianificazione
massima flessibilità di configurazione

Nota tecnica

Nel caso di utilizzo tramite ODBC o viste:

LinkMachine si comporta come client in sola lettura
eventuali trasformazioni dati possono essere gestite lato gestionale tramite VIEW
si consiglia di esporre solo i campi necessari per migliorare le prestazioni

Scrittura dati verso il gestionale

Oltre alla lettura della pianificazione, è possibile implementare meccanismi di ritorno dati verso il gestionale tramite:

export periodici
trigger database
viste dedicate
code di sincronizzazione
API o servizi intermedi

Obiettivi dell’integrazione avanzata

leggere quantità prodotte
aggiornare lo stato degli ordini
sincronizzare avanzamenti produzione
mantenere allineati gestionale e reparto produttivo
ottenere visibilità realtime sullo stato delle macchine

Tabella `programmazione` (RO)

Nel database è presente una tabella programmazione, utilizzata per gestire gli ordini pianificati sulle singole macchine.

Funzione

La tabella programmazione:

contiene i dati pianificati provenienti dal gestionale o dal sistema di schedulazione
è utilizzata da LinkMachine in sola lettura
rappresenta la coda di lavoro delle macchine

Struttura campi

Campo	Tipo	Descrizione
`cod_macchina`	varchar	codice identificativo della macchina
`anno`	long	anno di riferimento dell’ordine di produzione
`ordine`	varchar	numero o codice ordine di produzione
`ricetta`	varchar	codice ricetta associata alla produzione
`note`	varchar	note visualizzate associate alla produzione
`path_etichetta`	varchar	path del modello etichetta
`path_pdf`	varchar	path del PDF di stampa
`des_ricetta`	varchar	descrizione della ricetta
`qta_programmata`	long	quantità pianificata da produrre
`ordinamento`	long	valore numerico utilizzato per definire la sequenza di lavorazione
`stato`	integer	stato ordine

Note

qta_programmata contiene la quantità prevista per l’ordine
ordinamento consente di stabilire la priorità o la posizione dell’ordine nella coda di produzione
stato può assumere valori come ad esempio:
0 = Da eseguire
1 = In corso
2 = Completato

Tabella `programmazione_link` (RW)

La tabella programmazione_link viene utilizzata da LinkMachine per registrare lo stato operativo reale della produzione.

Funzione

Questa tabella:

viene gestita direttamente da LinkMachine
contiene il consuntivo operativo
registra l’avanzamento reale rispetto alla pianificazione

Struttura campi

Campo	Tipo	Descrizione
`cod_macchina`	varchar	codice identificativo della macchina
`anno`	long	anno di riferimento dell’ordine di produzione
`ordine`	varchar	numero o codice ordine di produzione
`ricetta`	varchar	codice ricetta associata alla produzione
`qta_prodotta`	long	quantità effettivamente prodotta
`stato`	integer	stato della lavorazione

Logica di utilizzo

La tabella viene utilizzata in scrittura da LinkMachine durante l’esecuzione della produzione:

all’avvio produzione (Start) viene eseguito un INSERT
durante la produzione viene aggiornato il campo qta_prodotta
a fine lavorazione (Stop) viene aggiornato il campo stato

Note

qta_prodotta contiene la quantità realmente prodotta dalla macchina
stato può assumere valori come ad esempio:
0 = Da eseguire
1 = In corso
2 = Completato

Tabella `registro_pannello` (RW)

La tabella registro_pannello viene utilizzata per registrare i dati provenienti dal pannello operatore e dalla macchina in tempo reale.

Contiene informazioni su produzione, stati, barcode letti e variazioni operative.

Struttura campi

Campo	Tipo	Descrizione
`idregistro_pannello`	int	identificativo univoco del record (PK, autoincrement)
`operazione`	varchar	tipo di operazione eseguita (`start`, `stop`, cambio lotto, ecc.)
`lotto`	varchar	codice lotto corrente
`barcode_mp`	varchar	barcode materia prima
`ricetta`	varchar	codice ricetta attiva
`distinta`	varchar	codice distinta base
`stato`	varchar	stato generale della lavorazione
`lottoOLD`	varchar	lotto precedente
`barcodeOLD`	varchar	barcode precedente
`ricettaOLD`	varchar	ricetta precedente
`distintaOLD`	varchar	distinta precedente
`sensoreMP`	varchar	stato o valore sensore materia prima
`macchina`	varchar	identificativo macchina descrittivo
`cod_macchina`	int	codice macchina numerico
`created_at`	timestamp	data e ora registrazione evento
`stato_ricetta`	int	stato validazione ricetta
`stato_barcode`	int	stato validazione barcode
`stato_lotto`	int	stato validazione lotto
`stato_macchina`	int	stato macchina

Logica di utilizzo

La tabella registro_pannello è una tabella di tipo log/eventi, alimentata automaticamente dal sistema LinkMachine.

Viene utilizzata per:

tracciare tutte le operazioni effettuate sul pannello
storicizzare cambi di lotto, ricetta e barcode
monitorare lo stato della macchina
effettuare controlli di congruenza tra ricetta, lotto e materiale

Note

I campi OLD permettono di mantenere lo storico immediato del valore precedente
I campi stato_* sono utilizzati per verifiche automatiche:
0 = OK
1 = errore o mismatch
altri valori possono rappresentare stati avanzati
Il campo created_at viene valorizzato automaticamente con timestamp

Tabella `dati_macchine` (RW)

La tabella dati_macchine contiene lo stato in tempo reale delle macchine e dei pannelli collegati al sistema LinkMachine.

Ogni record rappresenta l’ultimo stato noto di una macchina o di un pannello.

Struttura campi

Campo	Tipo	Descrizione
`iddati_macchine`	int	identificativo univoco (PK, autoincrement)
`cod_macchina`	varchar	codice macchina
`cod_ricetta`	int	codice ricetta attiva
`cod_commessa`	int	codice commessa
`cod_programma`	int	codice programma macchina
`contaore`	int	contatore ore macchina
`contapezzi`	int	contatore pezzi prodotti
`ciclo_macchina`	varchar	stato ciclo macchina
`update_at`	timestamp	ultimo aggiornamento dati
`barcode_lottoMP1`	int	barcode materia prima 1
`barcode_lottoMP2`	int	barcode materia prima 2
`barcode_lottoMP3`	int	barcode materia prima 3
`barcode_lottoMP4`	int	barcode materia prima 4
`barcode_lottoMP5`	int	barcode materia prima 5
`coeffMP1`	decimal	coefficiente consumo MP1
`coeffMP2`	decimal	coefficiente consumo MP2
`coeffMP3`	decimal	coefficiente consumo MP3
`coeffMP4`	decimal	coefficiente consumo MP4
`coeffMP5`	decimal	coefficiente consumo MP5
`lotto`	int	lotto corrente
`lottini`	varchar	sotto-lotto
`lottilav`	varchar	lotto lavorazione
`contparz_LOTTO`	int	contatore parziale lotto
`statomacchina`	int	stato macchina
`fl_cicli`	int	flag cicli macchina
`operazione`	varchar	operazione corrente
`ver_panel`	varchar	versione pannello
`contparzMP`	int	contatore parziale MP
`contparzMP1`	int	contatore parziale MP1
`contparzMP2`	int	contatore parziale MP2
`contparzMP3`	int	contatore parziale MP3
`contparzMP4`	int	contatore parziale MP4

Logica di utilizzo

La tabella dati_macchine è una tabella di tipo snapshot realtime multi-pannello.

contiene lo stato aggiornato dei pannelli LinkMachine presenti in rete
ogni pannello aggiorna la propria riga tramite UPDATE
il numero totale di record dipende dal numero di pannelli attivi

In termini pratici:

👉 n_record = n_pannelli attivi

Identificazione record

Ogni pannello dovrebbe essere identificato in modo univoco tramite:

cod_macchina
oppure, in modo più robusto, tramite una chiave composta come:
cod_macchina + id_pannello

Differenza rispetto alle altre tabelle

Tabella	Funzione
`programmazione`	pianificazione produzione
`programmazione_link`	avanzamento reale produzione
`dati_macchine`	stato realtime macchina/pannello

Note

il campo update_at consente di verificare se la macchina è online:
timestamp aggiornato → macchina attiva
timestamp fermo → possibile offline
i campi barcode_lottoMP* rappresentano i materiali in uso
i campi coeffMP* definiscono i coefficienti di consumo
i contatori (contapezzi, contparz*) permettono analisi produzione realtime

LinkMachine Panel - Manuale integrazione

LinkMachine Panel

Hardware LinkMachine

Il LinkMachine Panel è il dispositivo installato a bordo macchina che consente all’operatore di interagire con il sistema di raccolta dati.

Il pannello rappresenta il punto di connessione tra: - operatore - macchina - sistema LinkMachine Core

Funzioni principali

Identificazione operatore (RFID o manuale)
Selezione ordine / ricetta
Lettura barcode
Conteggio produzione in tempo reale
Segnalazione stati macchina
Comunicazione con il server centrale

Architettura del sistema

Il pannello opera come nodo periferico del sistema LinkMachine:

riceve dati dalla macchina (sensori, segnali digitali)
invia dati al server Linkmachine CORE (produzione, stati, eventi)
gestisce logiche di abilitazione macchina

Componenti principali

Il sistema può include:

Display touch industriale
Lettore barcode (opzionale)
Lettore RFID (opzionale)
Ingressi digitali (sensori macchina)
Uscite digitali (stati / consenso macchina)
Connessione LAN CABLATA
Connessione WLAN (opzionale)

Flusso operativo

L’operatore si identifica
Seleziona o legge la produzione
Il sistema abilita la macchina
I pezzi vengono conteggiati automaticamente
I dati vengono inviati al server

Integrazione

Il pannello è progettato per integrarsi con:

sistemi MES
gestionali aziendali
PLC e macchine industriali

Installazione pannello

Schema Pannello

Questa sezione descrive il collegamento elettrico e l’installazione del LinkMachine Panel a bordo macchina.

Alimentazione

Il pannello funziona a:

24V DC

Collegamenti:

Segnale	Descrizione
+24V	Alimentazione positiva
GND	Massa

Ingressi digitali

Gli ingressi digitali permettono di acquisire segnali dalla macchina.

Ingresso	Descrizione
IN_01	Impulso conteggio pezzi
IN_02	Materia prima esaurita (opzionale)

Note

IN_01 è utilizzato per il conteggio produzione
Il segnale deve essere pulito e stabile (no rimbalzi)

Uscite digitali

Le uscite digitali permettono di inviare segnali alla macchina.

Uscita	Descrizione
OUT_01	Stato connessione Core (Lampeggio)
OUT_02	Stato macchina
OUT_03	Consenso lavorazione

Consenso lavorazione (OUT_03)

Può essere utilizzato per:

abilitare la macchina
gestire logiche di sicurezza
implementare modalità bypass

Porte di comunicazione

Porta	Utilizzo
LAN	Connessione al server LinkMachine
Seriale	Collegamento dispositivi esterni
Micro USB	Configurazione
Micro SD	Log / storage

Collegamento dispositivi

È possibile collegare:

Lettore barcode (seriale o USB)
Lettore RFID
Sensori macchina
Segnalatori luminosi

Schema generale

Il pannello viene collegato:

alla macchina tramite I/O digitali
alla rete aziendale tramite LAN
ai dispositivi tramite seriale/USB

Note di installazione

Installare in ambiente protetto (quadro o box)
Verificare corretta polarità alimentazione
Utilizzare alimentazione stabilizzata 24V
Separare cavi di segnale da potenza

Utilizzo operatore

Screen LinkMachine

Questa sezione descrive l’utilizzo del pannello da parte dell’operatore.

Avvio del sistema

All’accensione il pannello:

avvia il software LinkMachine
verifica la connessione al server
si porta in stato pronto

Identificazione operatore

L’operatore può identificarsi tramite:

badge RFID
inserimento manuale

Selezione produzione

La produzione può essere selezionata tramite:

lettura barcode
selezione da elenco

Dati principali:

ordine
ricetta
lotto

Avvio lavorazione

Una volta selezionata la produzione:

viene attivato il consenso macchina (OUT_03)
l’operatore può avviare la produzione

Conteggio produzione

Il conteggio avviene automaticamente tramite:

ingresso IN_01

Ogni impulso corrisponde a un pezzo prodotto.

Stati macchina

Il pannello gestisce diversi stati:

Produzione attiva
Fermo macchina
Allarme
Bypass

Segnalazioni

Il sistema segnala:

perdita connessione
errori di produzione
materia prima esaurita

Fine produzione

Al termine:

viene chiusa la lavorazione
i dati vengono inviati al server
il sistema torna in attesa

Note operative

Non spegnere il pannello durante la produzione
Verificare sempre la produzione selezionata
Segnalare eventuali anomalie

Integrazione con sistema centrale

Tutti i dati raccolti vengono inviati al:

LinkMachine Core

per:

tracciabilità
analisi
integrazione con gestionale

LinkMachine Documentation

Integrazione Industry 4.0

Architettura generale

Gestione del flusso dei dati

Flusso dati con gestionale (ERP / MES)

1. Pianificazione

2. Visualizzazione a bordo macchina

3. Avvio produzione

4. Raccolta dati

5. Registrazione dati

Produzione (produzione)

Eventi (eventi)

Stato macchine (dati_macchine)

6. Integrazione con ERP

Flusso dati senza gestionale

1. Inserimento lavorazioni

2. Esecuzione produzione

3. Registrazione dati

4. Consultazione dati

Note di integrazione

Considerazioni

LinkMachine Core - Manuale integrazione

LinkMachine Core - Introduzione

Installazione server

Sistema operativo

Dimensionamento del sistema

Requisiti hardware

Configurazione minima

Configurazione consigliata

Connettività di rete

Configurazione con rete separata macchina / aziendale

Configurazione con rete condivisa

Porte di comunicazione

Accesso remoto per configurazione e assistenza

Antivirus e sicurezza

Risoluzione schermo

Permessi di installazione

Configurazione

Struttura cartelle

File di configurazione config.ini

Esempio di configurazione

Descrizione delle sezioni del file config.ini

Parametri di integrazione macchina

Valori possibili

Database

Database

Panoramica tabelle

Schema logico

Descrizione sintetica

programmazione

programmazione_link

registro_pannello

dati_macchine

Vantaggi dell’architettura

Architettura Database

Modello logico

Flusso operativo

Obiettivi dell’architettura

Integrazione con gestionali

Tabella programmazione

Origine dati

Configurazione

Vantaggi

Nota tecnica

Scrittura dati verso il gestionale

Obiettivi dell’integrazione avanzata

Tabella programmazione (RO)

Funzione

Struttura campi

Note

Tabella programmazione_link (RW)

Funzione

Struttura campi

Logica di utilizzo

Note

Tabella registro_pannello (RW)

Struttura campi

Logica di utilizzo

Note

Tabella dati_macchine (RW)

Produzione (`produzione`)

Eventi (`eventi`)

Stato macchine (`dati_macchine`)

File di configurazione `config.ini`

Descrizione delle sezioni del file `config.ini`

`programmazione`

`programmazione_link`

`registro_pannello`

`dati_macchine`

Tabella `programmazione`

Tabella `programmazione` (RO)

Tabella `programmazione_link` (RW)

Tabella `registro_pannello` (RW)

Tabella `dati_macchine` (RW)