Bloque de funciones FS_READ

El bloque de funciones FS_READ lee datos de un archivo.

Atención: Al leer archivos muy grandes, la PLC o todo el sistema puede colapsar y no poder reiniciarse. Use con precaución la entrada LENGTH=0.

El sistema de archivos debe haber sido inicializado previamente mediante FS_INIT. Todas las operaciones se realizan de manera asíncrona por cada medio de almacenamiento configurado.

Entrada READ

Al detectar un flanco positivo, los datos se leen del medio de almacenamiento.

Entrada DEV

Define el dispositivo desde el cual se accederá a los archivos. El dispositivo se utiliza por proyecto y puede administrarse en el menú contextual bajo Proyecto ▸ Almacenamiento externo.

Entrada PATH

Especifica la ruta al archivo en el medio de almacenamiento. La ruta corresponde a una ruta de archivo Unix en formato UTF-8, si este es soportado. La ruta se representa de la siguiente manera:

Carpeta/Subcarpeta/Archivo.txt

Entrada OFFSET

Define el desplazamiento en bytes desde donde se comenzará a leer. Si no se define un desplazamiento, se lee desde el inicio del archivo.

Entrada LENGTH

Define la longitud máxima hasta que se detenga la lectura. Si la entrada no está definida, se lee hasta el final del archivo.

Nota: El tamaño máximo legible cuando LENGTH=0 es de 1'024'000 bytes por razones de seguridad.

Salida DONE

La salida devuelve un pulso en caso de éxito para realizar la siguiente operación. El pulso ocurre al finalizar el proceso, incluso si ha ocurrido un error.

Salida DATA

Devuelve los datos leídos. El estado se almacena para su uso posterior.

Salida EOF

Si se alcanza el final del archivo, la entrada es verdadera.

Salida BOM

Si se encuentra el UTF-8 Byte Order Mark, la salida es verdadera. El BOM se determina en cada operación de lectura.

Salida ERROR

En caso de error, devuelve un texto con un mensaje de error. Este es FALSE, si no ha ocurrido ningún error. El estado se almacena para su uso posterior.

Posibles causas:

  • El servicio del medio de almacenamiento no se ha iniciado.
  • El almacenamiento no ha sido inicializado.
  • Las credenciales de inicio de sesión son inválidas.
  • No se pudo alcanzar el servidor remoto.
  • El medio de almacenamiento no existe.
  • La ruta especificada es inválida.