Skip to main content

MCP-Werkzeuge und Ressourcen

Werkzeuge führen Aktionen im CODESYS-Projekt aus und geben Ergebnisse zurück. Lesende Werkzeuge haben keine Auswirkung auf das Projekt. Schreibende Werkzeuge verändern Projektinhalte oder die Projektstruktur dauerhaft und sind in der Tabelle entsprechend gekennzeichnet.

Werkzeug

Beschreibung

Effekt

add_or_remove_library

Fügt dem Projekt eine Bibliotheksreferenz hinzu oder entfernt diese.

Änderung von Bibliotheksreferenzen im Bibliotheksverwalter.

add_or_remove_program_call_in_task

Weist ein Programm einer Task zu, damit es im Laufzeitzyklus ausgeführt wird. Das Werkzeug wird nach dem Erstellen eines neuen Programms verwendet.

Das Tool kann auch Programmaufrufe aus Tasks entfernen.

Änderung der Programmaufrufe von Tasks

browse_project_tree

Zeigt die Struktur des Projektbaums oder eines bestimmten Teilbaums an. Optional werden Methoden, Eigenschaften und Aktionen unter ihren übergeordneten POUs eingeblendet.

Nur lesend

check_for_errors

Prüft das Projekt auf Fehler und gibt Diagnosemeldungen mit Quellpfaden und Zeilennummern zurück. Im Standardmodus bezieht sich das Tool auf Precompile-Regeln. Optional kann eine vollständige Kompilierung ausgelöst werden.

Nur lesend. Optional kann das Tool das Kompilieren des Projekts auslösen.

create_folder

Erstellt einen neuen Ordner im Projektbaum. Das Werkzeug wird verwendet, um POUs in logische Gruppen zu organisieren.

Ein neuer Ordner wird im Projekt erstellt.

create_or_replace_structured_text_object

Erstellt neue Structured-Text-Objekte oder schreibt bestehende vollständig neu. Eine vollständige POU mit verschachtelten Unter-POUs kann in einem einzelnen Aufruf erstellt werden. Nicht explizit enthaltene Unter-POUs bleiben erhalten.

Bestehende Objekte am gleichen Pfad werden überschrieben.

get_active_app_as_path

Gibt den Pfad des aktuell geladenen Projekts zurück.

Nur lesend

get_active_path_and_selection

Gibt den Pfad der aktiven Auswahl in CODESYS zurück. Bei markiertem Code werden zusätzlich Zeilennummern und der ausgewählte Text zurückgegeben.

Nur lesend

get_available_libraries_list

Gibt eine Liste aller in CODESYS verfügbaren Bibliotheken zurück.

Nur lesend

get_detailed_library_documentation

Gibt detaillierte Dokumentation für bestimmte Funktionen einer Bibliothek zurück. Umfasst Parameter, Rückgabetyp und weitere relevante Einzelheiten.

Nur lesend

get_device_and_io_configuration

Gibt den vollständigen Gerätebaum und die E/A-Konfiguration aller Geräte im Projekt zurück. Umfasst Konnektoren, E/A-Kanäle, Zuordnungen zu Variablen und Geräteinformationen.

Nur lesend

get_library_documentation

Gibt einen kompakten Überblick über den Inhalt einer Bibliothek zurück. Enthält alle Funktionen, Typen und deren Signaturen auf oberster Ebene.

Nur lesend

get_libraries_referenced_in_application

Gibt eine Liste aller in der Applikation referenzierten Bibliotheken zurück.

Nur lesend

get_structured_text_content

Gibt den Structured-Text-Quellcode eines Objekts am angegebenen Pfad zurück. Verschachtelte Unterobjekte wie Methoden, Aktionen, Propertys und Transitionen werden standardmäßig mit ausgegeben.

Unterstützt außerdem die Beschränkung der Ausgabe mittels Start- und Endzeile.

Nur lesend

remove_object

Entfernt ein Objekt aus dem Projekt. Das Werkzeug wird auch zum Entfernen einzelner untergeordneter Bausteine aus einem Funktionsbaustein verwendet.

Das Objekt wird unwiderruflich gelöscht.

rename_object

Benennt ein Objekt um und passt alle Referenzen auf dieses Objekt an. Kann eine Referenz nicht angepasst werden, wird die Umbenennung nicht durchgeführt.

Vollständige Umbenennungen mit Änderung aller Referenzen.

replace_text_in_structured_text

Führt gezielte Textersetzungen in einem Structured-Text-Objekt durch.

Der angegebene Text wird im Zielobjekt ersetzt.

search_in_files_by_regex

Durchsucht den gesamten Projektcode nach einem Textmuster. Treffer werden nach Objektpfad mit Zeilennummern gruppiert zurückgegeben.

Nur lesend

search_libraries_for_type

Sucht einen Typ oder eine Funktion anhand des Namens über alle verfügbaren Bibliotheken. Gibt Bibliotheksname und Elementtyp zurück.

Nur lesend

search_path_by_glob

Findet Objekte im Projektbaum anhand von Glob-Mustern. Bei vielen Ergebnissen mit gemeinsamem Vorfahren wird die Ausgabe gruppiert dargestellt.

Nur lesend

Ressourcen

Ressourcen sind schreibgeschützte Kontextdaten wie Vorlagen und Syntaxreferenzen. Im Gegensatz zu Werkzeugen führen Ressourcen keine Aktionen aus, sondern stellen statische Inhalte bereit. Ressourcen können direkt in Prompts referenziert werden, zum Beispiel: "Erstelle einen Testfall nach der Testcase-Vorlage".

Ressource

Beschreibung

CODESYS Structured Text Dialect Description

Syntaxreferenz für den Dialekt von CODESYS ST mit Erklärungen und Beispielen des IEC 61131-3-Standards und CODESYS-spezifischen Erweiterungen. Die Referenz umfasst Syntaxregeln, Datentypen und Literale, Variablenabschnitte, Operatoren, Kontrollfluss, Aufrufkonventionen, Interfaces, Vererbung und häufige Fehlerquellen. Die Ressource kann bei der Codegenerierung und Codeprüfung verwendet werden, um Syntaxfehler durch dialektspezifische Besonderheiten zu vermeiden.

CODESYS IEC UnitTest Testcase Template

Testfall-Vorlage nach dem Muster TM.Testcase. Die Vorlage enthält folgende Methoden:

  • Setup: Vorbereitung des Prüflings

  • Execute: Stimulation und Ergebnisprüfung)

  • Teardown: Aufräumen nach Testabschluss

  • Abort: Abbruchbehandlung eines laufenden Tests

Die Ressource wird bei der Erstellung neuer Unit-Tests verwendet, damit Testfälle nach dem empfohlenen Muster des CODESYS Test Managers generiert werden.