Tutorial

Generare codice SCL da specifiche di progetto CSV

Descrivi i tuoi equipaggiamenti e le sequenze in un foglio di calcolo — T-IA Connect genera i blocchi funzione automaticamente.

T
T-IA Connect Team
12 min di lettura
Aggiornato l'11 mar 2026

Dal foglio di calcolo al codice PLC

Programmare manualmente le macchine a stati ISA-88 in TIA Portal è noioso e soggetto a errori. Il modulo FDS (Specifica di Progetto Funzionale) ti permette di descrivere i tuoi equipaggiamenti (Moduli di Controllo) e le sequenze delle fasi in un semplice file CSV, poi genera automaticamente blocchi funzione SCL pronti per la produzione — completi di gestione HOLD/ABORT, logica della macchina a stati e dichiarazioni I/O appropriate.

Prerequisiti

  • T-IA Connect installato e in esecuzione
  • Un progetto TIA Portal aperto (V16–V21)
  • Un file CSV con la tua specifica di progetto (oppure usa l'esempio qui sotto)

Passo 1: Preparare il file CSV

Il CSV segue lo standard ISA-88 con due sezioni: [CmTypes] per le definizioni degli equipaggiamenti (valvole, pompe, sensori) e [Phases] per la logica di sequenza (macchine a stati). Ecco un esempio minimale:

design-spec.csv
[CmTypes]
CmType;Variable;Direction;DataType;Description
Valve;Cmd_Open;Out;Bool;Open command
Valve;Sts_Opened;In;Bool;Opened feedback
Valve;Sts_Closed;In;Bool;Closed feedback
Pump;Cmd_Run;Out;Bool;Run command
Pump;Sts_Running;In;Bool;Running feedback
Pump;Speed_SP;Out;Real;Speed setpoint
TempSensor;Value;In;Real;Temperature value
TempSensor;Sts_Fault;In;Bool;Sensor fault

[Phases]
PhaseType;Step;StepName;IsInitial;IsFinal;EntryAction;Condition;NextStep
Fill;10;Init;TRUE;;;"Execute=TRUE";20
Fill;20;OpenValve;;;"Valve.Cmd_Open:=TRUE";"Valve.Sts_Opened=TRUE";30
Fill;30;StartPump;;;"Pump.Cmd_Run:=TRUE";"TempSensor.Value>=80.0";40
Fill;40;StopPump;;;"Pump.Cmd_Run:=FALSE";"TRUE";50
Fill;50;CloseValve;;;"Valve.Cmd_Open:=FALSE";"Valve.Sts_Closed=TRUE";60
Fill;60;Done;;TRUE;"Pump.Cmd_Run:=FALSE";"TRUE";

Il CSV usa il punto e virgola come separatore. Ogni CmType definisce l'interfaccia I/O di un modulo equipaggiamento, e ogni Phase definisce una macchina a stati con passi, azioni d'ingresso e condizioni di transizione.

Passo 2: Caricare la specifica di progetto

Puoi caricare il CSV in tre modi: dalla pagina FDS nella barra laterale dell'app desktop, tramite API REST o tramite gli strumenti MCP del copilota IA. Ecco il metodo API:

curl — POST /api/design-spec/load
curl -X POST http://localhost:9000/api/design-spec/load \
  -H "Content-Type: multipart/form-data" \
  -F "file=@design-spec.csv"
Response
{
  "success": true,
  "areas": 1,
  "processCells": 1,
  "unitTypes": 1,
  "cmTypes": 3,
  "phases": 1
}

Una volta caricato, il CSV viene salvato nella cartella .tia-connect/cdc/ accanto al tuo progetto TIA e verrà ricaricato automaticamente la prossima volta.

Passo 3: Esplorare il modello analizzato

Dopo il caricamento, T-IA Connect analizza il CSV in una gerarchia ISA-88: Area → CellaDiProcesso → TipoDiUnità → Moduli di Controllo + Fasi. Puoi ispezionare il risultato:

curl — GET /api/design-spec/model
# Get the full ISA-88 hierarchy
curl http://localhost:9000/api/design-spec/model

# List all phases
curl http://localhost:9000/api/design-spec/phases
Response
{
  "areas": [{
    "name": "Area1",
    "processCells": [{
      "name": "PC1",
      "unitTypes": [{
        "name": "Unit1",
        "cmTypes": [
          { "name": "Valve", "variables": 3 },
          { "name": "Pump", "variables": 3 },
          { "name": "TempSensor", "variables": 2 }
        ],
        "phases": [
          { "name": "Fill", "steps": 6 }
        ]
      }]
    }]
  }]
}

// GET /api/design-spec/phases
[
  {
    "name": "Fill",
    "steps": ["Init", "OpenValve", "StartPump",
              "StopPump", "CloseValve", "Done"]
  }
]

Passo 4: Generare il codice SCL

Genera il blocco funzione SCL per qualsiasi fase. Il generatore crea una macchina a stati completa con VAR_INPUT (Execute, Abort, Hold + variabili personalizzate), VAR_OUTPUT (Done, Active, Held, Error) e un'istruzione CASE con tutti i passi.

curl — POST /api/design-spec/generate
curl -X POST http://localhost:9000/api/design-spec/generate \
  -H "Content-Type: application/json" \
  -d '{ "phase": "Fill" }'
Response
FUNCTION_BLOCK "FB_Fill"

VAR_INPUT
    Execute : Bool;
    Abort   : Bool;
    Hold    : Bool;
    Valve   : "UDT_Valve";
    Pump    : "UDT_Pump";
    TempSensor : "UDT_TempSensor";
END_VAR

VAR_OUTPUT
    Done   : Bool;
    Active : Bool;
    Held   : Bool;
    Error  : Bool;
END_VAR

VAR
    _Step      : Int;
    _StepEntry : Bool;
END_VAR

BEGIN
CASE #_Step OF
    0:  // IDLE
        IF #Execute THEN
            #Active := TRUE;
            #_Step := 10;
        END_IF;

    10: // Init
        IF Execute = TRUE THEN
            #_Step := 20;
        END_IF;

    20: // OpenValve
        IF #_StepEntry THEN
            #Valve.Cmd_Open := TRUE;
        END_IF;
        IF #Valve.Sts_Opened = TRUE THEN
            #_Step := 30;
        END_IF;

    30: // StartPump
        IF #_StepEntry THEN
            #Pump.Cmd_Run := TRUE;
        END_IF;
        IF #TempSensor.Value >= 80.0 THEN
            #_Step := 40;
        END_IF;

    40: // StopPump
        IF #_StepEntry THEN
            #Pump.Cmd_Run := FALSE;
        END_IF;
        IF TRUE THEN
            #_Step := 50;
        END_IF;

    50: // CloseValve
        IF #_StepEntry THEN
            #Valve.Cmd_Open := FALSE;
        END_IF;
        IF #Valve.Sts_Closed = TRUE THEN
            #_Step := 60;
        END_IF;

    60: // Done
        IF #_StepEntry THEN
            #Pump.Cmd_Run := FALSE;
        END_IF;
        #Done := TRUE;
        #Active := FALSE;
        #_Step := 0;
END_CASE;

// HOLD management
IF #Hold AND #Active THEN
    #Held := TRUE;
END_IF;

// ABORT management
IF #Abort AND #Active THEN
    #Active := FALSE;
    #_Step := 0;
END_IF;

END_FUNCTION_BLOCK

Passo 5: Importare in TIA Portal

L'ultimo passo genera l'SCL, lo racchiude in XML SimaticML, lo importa in TIA Portal e lo compila automaticamente per la validazione. Tutto in una singola chiamata API:

curl — POST /api/design-spec/generate-and-import
curl -X POST http://localhost:9000/api/design-spec/generate-and-import \
  -H "Content-Type: application/json" \
  -d '{ "phase": "Fill", "device": "PLC_1" }'
Response
{
  "phase": "Fill",
  "blockName": "FB_Fill",
  "imported": true,
  "compiled": true,
  "errors": [],
  "warnings": 0
}

Cosa ottieni

Un blocco funzione ISA-88 completo con macchina a stati, logica HOLD/ABORT e I/O tipizzati — generato in pochi secondi da un semplice foglio di calcolo. Niente più programmazione manuale della logica di controllo ripetitiva.

Provalo ora con le tue specifiche di progetto usando T-IA Connect.