DevOps / Distribuzione

Distribuzione PLC Automatizzata
per progetti TIA Portal

Automatizza l'intero ciclo di vita della distribuzione: compila hardware e software, stabilisci connessioni online, confronta gli stati online/offline, scarica firmware e programmi sul PLC e controlla lo stato di esecuzione della CPU - tutto tramite script via REST API.

Automazione completa del ciclo di vita della distribuzione

Ogni passaggio dal codice sorgente al PLC in funzione, programmabile e ripetibile

Compilazione

Compila la configurazione hardware e i blocchi software individualmente o insieme. I risultati della compilazione includono errori e avvisi - integrali nelle pipeline CI per vincolare la distribuzione a build riusciti.

Connessione Online

Stabilisci e termina le connessioni online con i PLC. Supporta PLCSim Softbus, PROFINET e override manuali del percorso. Rilevamento automatico dei parametri di connessione o specifica esplicita dei punti di accesso.

Ambiti di Download

Scegli l'ambito del download per ogni distribuzione: Solo Software, Solo Hardware, Hardware e Software combinati o Solo modifiche software per aggiornamenti a impatto minimo. Controllo preciso su ciò che raggiunge il PLC.

Gestione dello stato della CPU

Avvia e arresta la CPU a livello di codice. Leggi lo stato corrente della CPU prima e dopo la distribuzione. Crea sequenze di distribuzione sicure che portano la CPU attraverso STOP, download e RUN automaticamente.

Supporto per PLC protetti da password

Autenticati con PLC protetti da password prima di andare online. Imposta, aggiorna e cancella le credenziali di autenticazione online tramite l'API per supportare ambienti di produzione sicuri.

Protezioni di sicurezza

Il flag confirmPhysicalDownload impedisce download accidentali su hardware reale - solo i target PLCSim consentono il download senza conferma esplicita. Una barriera critica per le pipeline CI/CD destinate a PLC fisici.

Workflow di distribuzione standard

Cinque passaggi dal codice compilato a un PLC in funzione

1

Compila

Attiva la compilazione hardware e software tramite compile_device o compile_block. Controlla il risultato per eventuali errori prima di procedere. Una compilazione fallita interrompe la distribuzione.

2

Vai Online

Chiama go_online con il dispositivo di destinazione. T-IA Connect risolve automaticamente il punto di accesso o accetta un percorso manuale. Verifica lo stato della connessione con get_online_state prima di procedere.

3

Confronta Online / Offline

Esegui compare_online_offline per verificare se il PLC corrisponde già al progetto. Salta i download non necessari se non viene rilevato alcun delta, riducendo l'interruzione del PLC in produzione.

4

Download sul PLC

Esegui download_to_plc con l'ambito scelto (Software, Hardware, HardwareAndSoftware o SoftwareOnlyChanges). Imposta confirmPhysicalDownload su true solo quando punti intenzionalmente a hardware reale.

5

Avvia CPU

Invia start_cpu per portare il PLC da STOP a RUN. Conferma lo stato finale con get_cpu_state. Registra il risultato per l'audit trail e il reporting CI.

Scripting della distribuzione tramite REST API

Integra la distribuzione PLC in qualsiasi strumento CI/CD utilizzando chiamate HTTP standard

Compila e controlla il risultato

# Compila il dispositivo (hardware + software)
curl -X POST http://localhost:5000/api/compile-device \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}

Vai online e scarica

# Vai online
curl -X POST http://localhost:5000/api/go-online \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}\n\n# Scarica solo il software
curl -X POST http://localhost:5000/api/download-to-plc \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1", "scope": "Software", "confirmPhysicalDownload": true}

Avvia la CPU e verifica lo stato

# Avvia la CPU
curl -X POST http://localhost:5000/api/start-cpu \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}\n\n# Leggi lo stato della CPU
curl -X GET 'http://localhost:5000/api/get-cpu-state?deviceName=PLC_1'

Strumenti di distribuzione disponibili

Tutti gli strumenti sono accessibili tramite REST API e protocollo MCP

StrumentoDescrizione
compile_deviceCompila l'intero dispositivo (hardware + software) e restituisce errori e avvisi.
compile_blockCompila un singolo blocco di programma. Utile per controlli preliminari mirati nelle pipeline CI.
go_onlineStabilisce una connessione online con il PLC. Supporta PLCSim, PROFINET e percorso manuale.
go_offlineTermina la connessione online e riporta il dispositivo in modalità offline.
get_online_stateRestituisce lo stato attuale della connessione online/offline per un dispositivo.
download_to_plcScarica i dati del progetto sul PLC. Ambito: Software, Hardware, HardwareAndSoftware, SoftwareOnlyChanges.
upload_from_plcCarica il programma PLC corrente nel progetto TIA Portal.
compare_online_offlineConfronta lo stato online del PLC con il progetto offline per rilevare eventuali differenze.
start_cpuPorta la CPU dallo stato STOP allo stato RUN.
stop_cpuPorta la CPU dallo stato RUN allo stato STOP prima di un download.
get_cpu_stateLegge lo stato operativo corrente della CPU (RUN, STOP, STARTING, ecc.).
list_access_pointsElenca tutti i punti di accesso configurati per risolvere i percorsi di connessione PLC.
list_parameter_setsElenca i set di parametri disponibili per la configurazione della connessione.
get_pgpc_diagnosticRecupera la diagnostica dell'interfaccia PG/PC per risolvere i problemi di connessione.

Distribuisci il tuo primo PLC automaticamente

Smetti di cliccare su TIA Portal. Crea lo script dell'intera pipeline di distribuzione una volta e avvialo ad ogni commit.