Skip to main content

Herramientas y recursos de MCP

Las herramientas realizan acciones en el CODESYS El proyecto y los resultados se muestran en la tabla. Las herramientas de lectura no afectan al proyecto. Las herramientas de escritura modifican permanentemente el contenido o la estructura del proyecto, y se indican como tales en la tabla.

Herramienta

Descripción

Efecto

add_library

Añade una referencia de biblioteca al proyecto o la elimina.

Cambio de referencias bibliotecarias en el Gestor de Bibliotecas

add_program_call_to_task

Asigna un programa a una tarea para que se ejecute durante el ciclo de ejecución. Esta herramienta se utiliza después de crear un nuevo programa.

La herramienta también puede eliminar las llamadas al programa de las tareas.

Cambio del programa: convocatorias de tareas

browse_project_tree

Muestra la estructura del árbol del proyecto o de un subárbol específico. Opcionalmente, los métodos, las propiedades y las acciones se muestran debajo de sus POU principales.

Solo lectura

check_for_errors

Comprueba si hay errores en el proyecto y devuelve mensajes de diagnóstico con las rutas de origen y los números de línea. En modo estándar, la herramienta utiliza reglas de precompilación. Opcionalmente, se puede iniciar una compilación completa.

Solo lectura. Opcionalmente, la herramienta puede iniciar la compilación del proyecto.

create_folder

Crea una nueva carpeta en el árbol del proyecto. Esta herramienta se utiliza para organizar las POU en grupos lógicos.

Se creará una nueva carpeta en el proyecto.

create_or_replace_structured_text_object

Crea nuevos objetos de texto estructurado o reescribe por completo los existentes. Se puede crear un POU completo con sub-POU anidados en una sola llamada. Los sub-POU que no se incluyan explícitamente se conservarán.

Los objetos existentes en la misma ruta serán sobrescritos.

get_active_app_as_path

Devuelve la ruta del proyecto cargado actualmente.

Solo lectura

get_active_path_and_selection

Devuelve la ruta de la selección activa en CODESYS Cuando se selecciona un código, también se devuelven los números de línea y el texto seleccionado.

Solo lectura

get_available_libraries_list

Devuelve una lista de todas las bibliotecas disponibles en CODESYS.

Solo lectura

get_detailed_library_documentation

Devuelve documentación detallada para funciones específicas de una biblioteca. Incluye parámetros, tipo de retorno y otros detalles relevantes.

Solo lectura

get_device_and_io_configuration

Devuelve el árbol de dispositivos completo y la configuración de E/S de todos los dispositivos del proyecto. Incluye conectores, canales de E/S, asignaciones a variables e información del dispositivo.

Solo lectura

get_library_documentation

Proporciona una descripción general concisa del contenido de una biblioteca. Contiene todas las funciones, tipos y sus firmas de nivel superior.

Solo lectura

get_libraries_referenced_in_application

Devuelve una lista de todas las bibliotecas a las que se hace referencia en la aplicación.

Solo lectura

get_structured_text_content

Devuelve el código fuente de texto estructurado de un objeto en la ruta especificada. Los subobjetos anidados (por ejemplo, métodos, acciones, propiedades y transiciones) se incluyen en la salida de forma predeterminada.

También admite la restricción de la salida mediante el uso de una línea de inicio y final

Solo lectura

remove_object

Elimina un objeto del proyecto. La herramienta también se utiliza para eliminar sub-POU individuales de un bloque de función.

El objeto será eliminado de forma irreversible.

rename_object

Cambia el nombre de un objeto y actualiza todas las referencias a ese objeto. Si no se puede ajustar una referencia, no se realizará el cambio de nombre

Cambio de nombre completo con un cambio en todas las referencias

replace_text_in_structured_text

Realiza sustituciones de texto específicas en un objeto de texto estructurado.

El texto especificado se sustituirá en el objeto de destino.

search_in_files_by_regex

Busca un patrón de texto en todo el código del proyecto. Las coincidencias se devuelven y se agrupan por ruta del objeto con números de línea.

Solo lectura

search_liebraries_for_type

Busca un tipo o función por nombre en todas las bibliotecas disponibles. Devuelve el nombre de la biblioteca y el tipo de elemento.

Solo lectura

search_path_by_glob

Utiliza patrones glob para encontrar objetos en el árbol del proyecto. En caso de que haya varios resultados con un ancestro común, la salida se muestra agrupada.

Solo lectura

Recursos

Los recursos son datos de contexto de solo lectura, como plantillas y referencias de sintaxis. A diferencia de las herramientas, los recursos no realizan acciones, sino que proporcionan contenido estático. Se puede hacer referencia a los recursos directamente en las instrucciones, por ejemplo: «Cree un caso de prueba de acuerdo con la plantilla de casos de prueba».

Recurso

Descripción

CODESYS Descripción del dialecto de texto estructurado

Referencia sintáctica para el dialecto de CODESYS ST con explicaciones y ejemplos de la norma IEC 61131-3 y CODESYS-extensiones específicas. La referencia incluye las reglas sintácticas, los tipos de datos y los literales, las secciones de variables, los operadores, el flujo de control, las convenciones de llamada, las interfaces, la herencia y las fuentes comunes de errores. Este recurso se puede usar durante la generación y verificación del código para evitar errores de sintaxis causados por peculiaridades específicas de un dialecto

CODESYS Plantilla de caso de prueba IEC UnitTest

Plantilla de caso de prueba siguiendo el patrón TM.Testcase. La plantilla contiene los siguientes métodos:

  • Setup: Preparación del objeto de prueba

  • Execute: Pruebas de estimulación y resultados

  • Teardown: Limpiar una vez finalizada la prueba

  • Abort: Gestión de la cancelación de una prueba en ejecución

Este recurso se usa al crear nuevas pruebas unitarias para que los casos de prueba se generen de acuerdo con el patrón recomendado del CODESYS Test Manager.