Funktionsblock FS_READ

Funktionsblocket FS_READ läser data från en fil.

Varning: Vid läsning av mycket stora filer kan SPS eller hela systemet krascha och inte startas igen. Använd endast med försiktighet ingången LENGTH=0.

Filsystemet måste ha initierats tidigare med hjälp av FS_INIT. Alla operationer sker asynkront per upprättat lagringsmedium.

Ingång READ

Vid en positiv flank läses data från lagringsmediet.

Ingång DEV

Definierar enheten, varifrån filerna ska åtkommas. Enheten används per projekt och kan hanteras i menyn under Projekt ▸ Extern lagring.

Ingång PATH

Anger sökvägen till filen på lagringsmediet. Sökvägen motsvarar en Unix-filsökväg i UTF-8-format, om detta stöds. Sökvägen visas som följer:

Mapp/Undermapp/Fil.txt

Ingång OFFSET

Definierar offsettet i byte, varifrån läsningen ska börja. Om inget offset definieras, läses från början av filen.

Ingång LENGTH

Definierar den maximala längden innan läsningen avslutas. Om ingången inte är definierad, läses till slutet av filen.

Anmärkning: Den maximala läsliga storleken vid LENGTH=0 är av säkerhetsskäl 1024'000 byte.

Utgång DONE

Utgången ger vid lyckad operation en puls för att utföra nästa operation. Pulsen sker när processen avslutas, även om ett fel har inträffat.

Utgång DATA

Returnerar de lästa data. Tillståndet sparas för senare användning.

Utgång EOF

Om slutet av filen har nåtts, är ingången sann.

Utgång BOM

Om UTF-8 Byte Order Mark hittats, är utgången sann. BOM bestäms vid varje läsoperation.

Utgång ERROR

Returnerar i felet ett meddelande med en felkod. Denna är FALSE, om inget fel har inträffat. Tillståndet sparas för senare användning.

Möjliga orsaker:

• Tjänsten för lagringsmediet har inte startats.
• Lagringen har inte initierats.
• Inloggningsuppgifterna är ogiltiga.
• Den avlägsna servern kunde inte nås.
• Lagringsmediet existerar inte.
• Den angivna sökvägen är ogiltig.