For the complete documentation index, see llms.txt. This page is also available as Markdown.

TwinCAT Read

Esta función lee una variable de un PLC TwinCAT y devuelve el valor recuperado junto con un indicador de éxito. Está pensada para lecturas sencillas de datos de PLC en escenarios de automatización.

📥 Entradas (sockets)

Connection — Objeto genérico de conexión al PLC (proporcionar usando un bloque de conexión como TwinCAT Connect).

📤 Salidas (sockets)

Data — Valor de la variable recuperado desde el PLC.

Success — Bandera booleana que indica si la operación de lectura tuvo éxito.

🕹️ Controles

Variable Name — Campo de texto donde se ingresa el nombre de la variable del PLC a leer. Este valor debe coincidir con el identificador definido en el PLC.

🎯 Features

  • Operación de lectura sencilla al PLC con retroalimentación clara de éxito.

  • Diseñado para aceptar una conexión desde un bloque de conexión separado, manteniendo la gestión de conexión separada de las lecturas.

  • Valida entradas clave y muestra mensajes de error claros cuando falta la conexión o el nombre de la variable.

📝 How to use

  1. Proporcione una conexión al PLC en la entrada Connection. La forma típica es usar el bloque TwinCAT Connect y conectar su salida a este bloque.

  2. Introduzca la variable objetivo del PLC en el control Variable Name.

  3. Dispare la evaluación (manualmente o desde controles de flujo). El bloque intentará leer la variable indicada y emitirá Data y Success.

  4. Use la salida Success para condicionar la lógica aguas abajo (por ejemplo, registro o almacenamiento) de modo que solo actúe sobre lecturas válidas.

📊 Runtime behavior

Al ejecutarse, el bloque comprueba que haya un Connection válido y que Variable Name no esté vacío. Si falta alguno, informa un error y devuelve Success en falso. Con una configuración válida realiza la lectura, emitiendo el valor de la variable en Data y un booleano en Success.

💡 Tips and Tricks

  • Use TwinCAT Connect para crear y gestionar la conexión al PLC y enrútela hacia Connection.

  • Combine con Rising Edge o Cycle Timer para controlar la frecuencia de lectura (por ejemplo, leer una vez al inicio o periódicamente).

  • Envíe lecturas exitosas a CSV Export o Data to JSON para registrar valores y analizarlos posteriormente.

  • Use Debug Input o Scope para inspeccionar valores mientras construye y prueba el sistema.

  • Para escribir valores en el PLC, empareje este bloque con TwinCAT Write y use bloques lógicos (por ejemplo Logic Input o Set - Reset) para controlar cuándo se ejecutan lecturas/escrituras.

  • Use Data Write Local o Data Write Global para almacenar valores para otras partes de su escenario.

🛠️ Troubleshooting

  • Si ve errores tipo "Connection is not established", verifique que el bloque de conexión (por ejemplo TwinCAT Connect) esté configurado y conectado.

  • Si Variable Name está vacío, el bloque no intentará leer — introduzca un identificador de variable de PLC válido.

  • Si la lectura falla a pesar de entradas válidas, revise los permisos de acceso al PLC, la ortografía del nombre de la variable y el estado de la red/PLC. Use Debug Input para capturar la respuesta cruda y la salida Success para encaminar el manejo de errores.

  • Para mayor estabilidad periódica, controle las lecturas con bloques temporizadores como Cycle Timer y añada lógica de reintento simple usando bloques lógicos.

Última actualización