Функциональный блок FS_READ

Функциональный блок FS_READ считывает данные из файла.

Внимание: При чтении очень больших файлов ПЛК или вся система может зависнуть и больше не запуститься. Используйте вход LENGTH=0 с осторожностью.

Файловая система должна быть предварительно инициализирована с помощью FS_INIT. Все операции выполняются асинхронно для каждого созданного носителя.

Вход READ

При положительном фронте данные считываются с носителя.

Вход DEV

Определяет устройство, с которого следует получать доступ к файлам. Устройство используется в проекте и может быть управляемо в контекстном меню под Проект Внешнее хранилище.

Вход PATH

Указывает путь к файлу на носителе. Путь соответствует Unix-пути к файлу в формате UTF-8, если он поддерживается. Путь представлен следующим образом:

Папка/Подпапка/Файл.txt

Вход OFFSET

Определяет смещение в байтах, с которого следует начинать чтение. Если смещение не определено, чтение начинается с начала файла.

Вход LENGTH

Определяет максимальную длину, до которой будет продолжаться чтение. Если вход не определен, чтение будет продолжаться до конца файла.

Примечание: Максимальный размер для чтения при LENGTH=0 составляет 1024'000 байтов по соображениям безопасности.

Выход DONE

При успешном завершении выход возвращает импульс для выполнения следующей операции. Импульс происходит при завершении процесса, даже если произошла ошибка.

Выход DATA

Возвращает прочитанные данные. Состояние сохраняется для последующего использования.

Выход EOF

Если достигнуто конец файла, вход истинен.

Выход BOM

Если найдена метка порядка байтов UTF-8, выход истинен. BOM определяется при каждом процессе чтения.

Выход ERROR

В случае ошибки возвращает текст с сообщением об ошибке. Он FALSE, если ошибка не возникла. Состояние сохраняется для последующего использования.

Возможные причины:

  • Сервис носителя не был запущен.
  • Хранилище не было инициализировано.
  • Данные для входа недействительны.
  • Удаленный сервер недоступен.
  • Носитель не существует.
  • Указанный путь недействителен.