Blok funkcija FS_READ

Blok funkcija FS_READ čita podatke iz datoteke.

Pažnja: Pri čitanju vrlo velikih datoteka može doći do rušenja PLC-a ili cijelog sustava i neće se više pokretati. Koristite ulaz LENGTH=0 samo s oprezom.

Datotečni sustav mora biti ranije inicijaliziran putem FS_INIT. Sve operacije se tada izvode asinkrono po svakom napravljenom mediju za pohranu.

Ulaz READ

Pri pozitivnoj ivici čitaju se podatci s medija za pohranu.

Ulaz DEV

Definira uređaj, s kojeg se treba pristupiti datotekama. Uređaj se koristi po projektu i može se upravljati u kontekstnom izborniku pod Projekt ▸ Vanjski pohrana.

Ulaz PATH

Navodi putanju do datoteke na mediju za pohranu. Putanja odgovara Unix-putanji datoteci u UTF-8 formatu, ako je to podržano. Putanja se prikazuje ovako:

Folder/Subfolder/File.txt

Ulaz OFFSET

Definira pomak u bajtovima, od kojeg se treba početi čitati. Ako nije definiran pomak, čita se od početka datoteke.

Ulaz LENGTH

Definira maksimalnu dužinu do koje će se čitanje završiti. Ako ulaz nije definiran, čita se do kraja datoteke.

Napomena: Maksimalna veličina koja se može čitati pri LENGTH=0 iznosi 1024'000 bajtova radi sigurnosti.

Izlaz DONE

Izlaz vraća impuls pri uspjehu, kako bi se sljedeća operacija mogla izvesti. Impuls se javlja na kraju postupka, čak i ako je došlo do pogreške.

Izlaz DATA

Vraća pročitane podatke. Stanje se pohranjuje za kasnije korištenje.

Izlaz EOF

Ako je dosegnut kraj datoteke, ulaz je istinit.

Izlaz BOM

Ako je pronađen UTF-8 Byte Order Mark, izlaz je istinit. BOM se određuje pri svakom postupku čitanja.

Izlaz ERROR

U slučaju pogreške vraća tekst s porukom o pogrešci. Ovo je FALSE, ako nije došlo do pogreške. Stanje se pohranjuje za kasnije korištenje.

Mogući uzroci:

• Usluga medija za pohranu nije pokrenuta.
• Pohrana nije inicijalizirana.
• Podaci za prijavu nisu valjani.
• Daljinski server nije dostupan.
• Medij za pohranu ne postoji.
• Navedena putanja je nevaljana.