Skip to main content

Strumenti e risorse MCP

Gli strumenti eseguono azioni nel CODESYS progetto e restituisci risultati. Gli strumenti di lettura non hanno alcun impatto sul progetto. Gli strumenti di scrittura modificano in modo permanente il contenuto o la struttura del progetto e sono contrassegnati di conseguenza nella tabella.

Attrezzo

Descrizione

Effetto

add_library

Aggiunge un riferimento di libreria al progetto o lo rimuove.

Modifica dei riferimenti alle biblioteche nel Library Manager

add_program_call_to_task

Assegna un programma a un'attività in modo che venga eseguito nel ciclo di runtime. Lo strumento viene utilizzato dopo la creazione di un nuovo programma.

Lo strumento può anche rimuovere le chiamate al programma dalle attività.

Modifica delle chiamate di attività del programma

browse_project_tree

Visualizza la struttura dell'albero del progetto o di un sottoalbero specifico. Metodi, proprietà e azioni vengono facoltativamente mostrati al di sotto dei rispettivi POU (Point of Use) principali.

Solo lettura

check_for_errors

Verifica la presenza di errori nel progetto e restituisce messaggi diagnostici con i percorsi dei file sorgente e i numeri di riga. In modalità standard, lo strumento fa riferimento alle regole di precompilazione. Facoltativamente, è possibile avviare una compilazione completa.

Sola lettura. Facoltativamente, lo strumento può avviare la compilazione del progetto.

create_folder

Crea una nuova cartella nell'albero del progetto. Questo strumento viene utilizzato per organizzare i POU in gruppi logici.

Nel progetto verrà creata una nuova cartella.

create_or_replace_structured_text_object

Crea nuovi oggetti di testo strutturato o riscrive completamente quelli esistenti. È possibile creare un POU completo con sotto-POU annidati in una singola chiamata. I sotto-POU non inclusi esplicitamente verranno mantenuti.

Gli oggetti esistenti sullo stesso percorso verranno sovrascritti.

get_active_app_as_path

Restituisce il percorso del progetto attualmente caricato.

Solo lettura

get_active_path_and_selection

Restituisce il percorso della selezione attiva in CODESYS Quando si seleziona del codice, vengono visualizzati anche i numeri di riga e il testo selezionato.

Solo lettura

get_available_libraries_list

Restituisce un elenco di tutte le librerie disponibili in CODESYS.

Solo lettura

get_detailed_library_documentation

Restituisce la documentazione dettagliata per specifiche funzioni di una libreria. Include parametri, tipo di ritorno e altri dettagli rilevanti.

Solo lettura

get_device_and_io_configuration

Restituisce l'albero completo dei dispositivi e la configurazione I/O di tutti i dispositivi presenti nel progetto. Include connettori, canali I/O, mappature alle variabili e informazioni sui dispositivi.

Solo lettura

get_library_documentation

Fornisce una panoramica concisa del contenuto di una libreria. Contiene tutte le funzioni, i tipi e le relative firme di primo livello.

Solo lettura

get_libraries_referenced_in_application

Restituisce un elenco di tutte le librerie a cui si fa riferimento nell'applicazione.

Solo lettura

get_structured_text_content

Restituisce il codice sorgente in formato testo strutturato di un oggetto al percorso specificato. Gli oggetti secondari annidati (ad esempio metodi, azioni, proprietà e transizioni) sono inclusi nell'output per impostazione predefinita.

Supporta anche la limitazione dell'output utilizzando una riga iniziale e una riga finale

Solo lettura

remove_object

Consente di rimuovere un oggetto dal progetto. Lo strumento viene utilizzato anche per rimuovere singoli sotto-POU da un blocco funzione.

L'oggetto verrà eliminato in modo irreversibile.

rename_object

Rinomina un oggetto e aggiorna tutti i riferimenti a quell'oggetto. Se un riferimento non può essere modificato, la ridenominazione non verrà eseguita

Rinominazione completa con una modifica a tutti i riferimenti

replace_text_in_structured_text

Esegue sostituzioni di testo mirate in un oggetto Testo strutturato.

Il testo specificato verrà sostituito nell'oggetto di destinazione.

search_in_files_by_regex

Cerca un pattern di testo nell'intero codice del progetto. Le corrispondenze vengono restituite e raggruppate per percorso dell'oggetto con numeri di riga

Solo lettura

search_liebraries_for_type

Cerca un tipo o una funzione per nome in tutte le librerie disponibili. Restituisce il nome della libreria e il tipo di elemento.

Solo lettura

search_path_by_glob

Utilizza pattern glob per trovare oggetti nell'albero del progetto. Nel caso di molti risultati con un antenato comune, l'output viene visualizzato in un gruppo.

Solo lettura

Risorse

Le risorse sono dati contestuali di sola lettura come modelli e riferimenti di sintassi. A differenza degli strumenti, le risorse non eseguono azioni, ma forniscono contenuti statici. È possibile fare riferimento alle risorse direttamente nei prompt, ad esempio: «Crea un test case in base al modello di test case

Risorsa

Descrizione

CODESYS Descrizione del dialetto con testo strutturato

Riferimento alla sintassi per il dialetto di CODESYS ST con spiegazioni ed esempi dello standard IEC 61131-3 e CODESYS-estensioni specifiche. Il riferimento comprende regole di sintassi, tipi di dati e valori letterali, sezioni variabili, operatori, flusso di controllo, convenzioni di chiamata, interfacce, ereditarietà e fonti di errore comuni. Questa risorsa può essere utilizzata durante la generazione e il controllo del codice per evitare errori di sintassi causati da peculiarità specifiche

CODESYS Modello IEC UnitTest Testcase

Modello di test case che segue lo schema TM.Testcase. Il modello contiene i seguenti metodi:

  • Setup: Preparazione dell'oggetto di prova

  • Execute: Stimolazione e test dei risultati

  • Teardown: Pulisci dopo il completamento del test

  • Abort: Gestione dell'annullamento di un test in corso

Questa risorsa viene utilizzata durante la creazione di nuovi test unitari in modo che i casi di test vengano generati secondo lo schema consigliato di CODESYS Test Manager.