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

Modbus Read

Este bloque de función lee datos de un servidor Modbus (coils o registros) usando una conexión de cliente Modbus proporcionada. Utilice los controles en pantalla para seleccionar la dirección objetivo, la cantidad de valores a leer y el tipo de dato Modbus.

📥 Entradas

Enable Una señal booleana para permitir o evitar la lectura. Cuando es False el bloque no realizará la lectura y no devuelve datos.

Modbus Client Proporcione un objeto de conexión de cliente Modbus (usualmente proveniente de un bloque Modbus Connect). El bloque utiliza este cliente para comunicarse con el servidor.

📤 Salidas

Data El resultado de la lectura como una lista genérica. Para lecturas de registros, es una lista de valores numéricos de registros; para lecturas de coils/discrete, es una lista de valores booleanos. Si la lectura falla o está deshabilitada, la salida está vacía o es None.

🕹️ Controles

Address Ingrese la dirección inicial (entero) en el dispositivo Modbus desde la cual leer.

Quantity Ingrese cuántos ítems consecutivos (registros o coils) leer.

Data Type Elija el tipo de dato Modbus a leer: Coil, Discrete Input, Input Register o Holding Register.

🎯 Características

  • Soporta la lectura de tipos de datos basados en bits (coils/discrete inputs) y en palabras (input/holding registers).

  • Utiliza una conexión de cliente Modbus externa proporcionada en la entrada Modbus Client, manteniendo la comunicación separada de la configuración del bloque.

  • Devuelve resultados simples numéricos y booleanos como una lista adecuada para registro, graficado o procesamiento posterior.

  • Reporte de errores integrado que muestra fallos de comunicación para que puedas reaccionar (reconectar, reintentar, alertar).

⚙️ Mecanismo de ejecución

Cuando está activo, el bloque verifica la entrada Enable y requiere un cliente válido en la entrada Modbus Client. Lee el rango de direcciones configurado usando el Data Type seleccionado y devuelve los valores en la salida Data. Si la lectura falla o el bloque está deshabilitado, no devuelve datos y registra un mensaje de error útil.

💡 Consejos y trucos

  • Use Modbus Connect para crear y proporcionar la conexión requerida en Modbus Client.

  • Use Logic Input o Rising Edge para controlar cuándo se realizan las lecturas (disparo manual o lecturas de un solo pulso).

  • Para escribir valores de vuelta a un dispositivo, combine con el bloque Modbus Write.

  • Registre las lecturas para su revisión posterior usando CSV Export o persístalas con Data Write Local / Data Write Global.

  • Visualice salidas numéricas en tiempo real alimentando los resultados numéricos al bloque Scope.

  • Use Debug Input para inspeccionar y verificar el Data devuelto durante la configuración y la resolución de problemas.

🛠️ Solución de problemas

  • No se devuelve datos: asegúrese de que haya un cliente válido conectado a la entrada Modbus Client y que Enable sea True.

  • Valores incorrectos o lecturas parciales: verifique que Address y Quantity estén dentro del mapa de direcciones del dispositivo y de los límites del mismo.

  • Errores de comunicación: verifique la configuración de red/serie vía el bloque Modbus Connect y asegúrese de que ninguna otra aplicación esté bloqueando el acceso.

  • Formato de datos inesperado: confirme que seleccionó el Data Type correcto (coils vs registers) para los valores que espera.

Última actualización