---
id: MachineAnalytics_SCADA_Flowpack_MachineAnalytics_Documentation
sidebar_position: 0
sidebar_label: Documentazione Tecnica – Flowpack MachineAnalytics & SCADA
pagination_prev: null
hide_table_of_contents: TRUE
---

# Documentazione Tecnica – Flowpack MachineAnalytics & SCADA

---

## Sommario

- [Struttura SCADA Interface – Cambio Ricetta & Aggiornamento Produzione](sections/00-SCADAInterface_Structure.md#struttura-scada-interface--cambio-ricetta--aggiornamento-produzione)
- [Status Macchina e Interfaccia SCADA](sections/01-ScadaInterfaceMasterStructure.md#status-macchina-e-interfaccia-scada)
- [Gestione Cambio Ricetta](sections/02-GestioneRicette.md#gestione-cambio-ricetta)
- [Statistiche Flowpack](sections/03-StatisticheFlowpack.md#statistiche-flowpack)
- [Analytics & Allarmi](sections/04-AnalyticsAllarmi.md#analytics--allarmi)
- [Ranking Allarmi (Frequenza/Downtime)](sections/05-RankingAllarmi.md#ranking-allarmi-frequenzadowntime)
- [Tempi Macchina](sections/06-TempiMacchina.md#tempi-macchina)
- [Timestamp & Reset](sections/07-TimestampReset.md#timestamp--reset)
- [Popup & Logica HMI](sections/08-PopupLogicaHMI.md#popup--logica-hmi)
- [Note di Interfaccia e Utilizzo](sections/10-NoteInterfacciaUtilizzo.md#note-di-interfaccia-e-utilizzo)
- [Espansioni Future](#espansioni-future)

---

## Sessioni aggiunte (in alto)

- Documentazione generata da Ufficio Sviluppo TecnoPack Group Spa
- Versione: 2025-09-26
- Repository di riferimento: [DFFM-maker/ai-assistant](https://github.com/DFFM-maker/ai-assistant)

---

## Introduzione

Questa documentazione descrive la struttura, i dati e i flussi di comunicazione della macchina Flowpack integrata con sistemi SCADA/MES.  
Il sistema è pensato per massima compatibilità, chiarezza e performance, sia per la gestione locale che per l’integrazione con supervisori industriali.

---

## Protocollo di Comunicazione

La comunicazione tra PLC e sistemi SCADA/MES avviene tramite **protocollo OPC-UA**, garantendo:
- Interoperabilità tra piattaforme
- Sicurezza nella trasmissione dati
- Scalabilità per future espansioni

---

## Struttura Dati Principale

La struttura dati centrale è la **ST_ScadaInterface**.  
Questa aggrega tutte le variabili, array, handshake e KPI necessari per la supervisione, la diagnostica e la gestione della produzione.

```plaintext
ST_ScadaInterface
├── Egress (PLC → SCADA)
│   ├── Status macchina e produzione
│   ├── Ricette attive e lista ricette
│   ├── Statistiche Flowpack
│   ├── Analytics allarmi e ranking
│   ├── Tempi macchina, timestamp e reset
│   ├── Variabili di handshake e popup operatore
├── Ingress (SCADA → PLC)
│   ├── Comandi cambio ricetta/produzione
│   ├── Reset statistiche/counters
│   ├── Parametri di produzione richiesti
```

---

## Macro-sezioni
### [Struttura SCADA Interface – Cambio Ricetta & Aggiornamento Produzione](sections/00-SCADAInterface_Structure.md#struttura-scada-interface--cambio-ricetta--aggiornamento-produzione)

Questa sezione raccoglie tutte le variabili, i flussi di handshake e le logiche di stato che governano lo scambio dati tra PLC e SCADA/MES per:
- **Cambio ricetta**: gestione richiesta, conferma operatore, popup HMI, timer di reset, logging eventi.
- **Aggiornamento dati produzione**: gestione cambio lotto/ordine, quantità, info aggiuntive, conferma e tracciamento.
- Tutti i segnali di stato e i comandi per garantire sicurezza, tracciabilità e interoperabilità tra sistemi.

Include:
- Tabelle dettagliate di variabili Egress/Ingress.
- Tree strutturale delle variabili di scambio.
- Diagrammi di stato per cambio ricetta e produzione (Mermaid).
- Note avanzate e best practice per configurazione, audit e troubleshooting.

Questa macro-sezione è la base architetturale per l’integrazione e la supervisione della macchina tramite SCADA/MES.

### [Status Macchina e Interfaccia SCADA](sections/01-ScadaInterfaceMasterStructure.md#status-macchina-e-interfaccia-scada)

- Variabili di stato (IsRunning, IsStopped, IsInEmergency, ecc.)
- Handshake per comandi remoti e conferme operatore
- Heartbeat e monitor connessione PLC-SCADA

### [Gestione Ricette](sections/02-GestioneRicette.md#gestione-ricette)

- Scambio ricette tra PLC e SCADA: `ActualRecipeIndex`, `ActualRecipeName`, `RecipeList[0..40]`
- Handshake cambio ricetta: `RecipeChangeRequest`, `RecipeChangeACK`, `RecipeChangeOK`, `RecipeChangeReject`, `RecipeChangePostpone`
- Popup e logica HMI per conferma operatore

### [Statistiche Flowpack](sections/03-StatisticheFlowpack.md#statistiche-flowpack)

- Dati produzione: `Products_In_Total`, `Products_Out_Good`, `Products_Out_Rejected`
- Dettaglio scarti: `Reject_EmptyPackets`, `Reject_DoublePackets`, ecc.
- Percentuali di produzione/scarto
- Velocità attuale e di riferimento

### [Analytics & Allarmi](sections/04-AnalyticsAllarmi.md#analytics--allarmi)

- KPI allarmi: `State`, `Count`, `TotalActiveTime_ms`, `MTTR_sec`, `MTBF_h`
- Array compatto allarmi: `Alarms_Packed[0..80]` per sistemi SCADA con limiti di tag
- Spiegazione dei ranking e KPI per manutenzione predittiva

### [Ranking Allarmi (Frequenza/Downtime)](sections/05-RankingAllarmi.md#ranking-allarmi-frequenzadowntime)

- `TopAlarms_ByFrequency[0..99]` per allarmi più frequenti
- `TopAlarms_ByDowntime[0..99]` per allarmi che causano più fermo
- Visualizzazione e priorità interventi

### [Tempi Macchina](sections/06-TempiMacchina.md#tempi-macchina)

- Statistiche dettagliate: `TotalTime`, `RunTime`, `StopTime`, `EmergencyTime`, `DownstreamTime`, `UpstreamTime`
- Reset counters per cambio batch/turno

### [Timestamp & Reset](sections/07-TimestampReset.md#timestamp--reset)

- Tracciamento avvio/fine produzione e ultimo reset (`ProductionStart_Timestamp`, `ProductionStop_Timestamp`, `ProductionLastReset_Timestamp`)
- Comando `ResetCounters` per azzeramento sicuro

### [Popup & Logica HMI](sections/08-PopupLogicaHMI.md#popup--logica-hmi)

- Flusso handshake ricette/produzione con popup e timer reset (OK/Reject: 2s, Postpone: 30s)
- Variabili di stato per conferma/rifiuto operatore

---

## Note di Interfaccia e Utilizzo

- Tutte le variabili sono pronte per mapping OPC-UA, con naming standard e struttura chiara.
- Gli array compatti sono pensati per ridurre costi/licenze e rendere la supervisione più efficiente.
- Diagrammi di stato e tree strutturali facilitano la configurazione e il troubleshooting.
- Documentazione pronta per training, onboarding e audit.

---

## Espansioni Future

- Integrazione con moduli OEE, predictive maintenance, reportistica avanzata
- Estensione delle strutture per nuovi KPI, ranking, ricette
- Logging centralizzato e dashboard custom

---

## Sessioni aggiunte (in basso)

- Documento generato da Ufficio Sviluppo TecnoPack Group Spa
- Versione: 2025-09-26


---