BRESIMAR(asaTek)-Beckhoff-Nota Aplicação TwinCAT 2-15 MFiles

Beckhoff TwinCAT 

The Windows Control and Automation Technology 

NOTA DE APLICAÇÃO 15 

Funções Bloco de manuseamento de ficheiros em CX 

e IPC com TwinCAT PLC 

BRESIMAR (asaTek) 

e-mail j.andril@bresimar.pt 

B-NA15(v1.0) 

Novembro/2018

Bresimar Automação, S.A. 

Geral (Sede) 

Quinta do Simão - EN109 - Esgueira 

Apartado 3080 

3801-101 Aveiro 

PORTUGAL 

Telf . +351 234 303 320 Telm . +351 939 992 222 

Fax +351 234 303 328/9 

e-mail bresimar@bresimar.pt

NA12 – Manuseamento de ficheiros em PC e CX com TwinCAT PLC 

Índice 

1. Introdução 2 

2. Livraria “TcSystem.lib” 

2.1. Criar/abrir ficheiro (“FB_FileOpen”) 3 

2.2. Escrever/guardar em ficheiro (“FB_FileWrite”) 5 

2.3. Fechar ficheiro (“FB_FileClose”) 7 

2.4. Outras FB´s de manuseamento de ficheiros 9 

3. Programa exemplo de acesso a ficheiros 

3.1. 1º exemplo – Copia de ficheiros de dados 12 

BRESIMAR (asaTek) - Jorge Andril (v1.0) Pag. 1 de 16


1 – Introdução 

O software TwinCAT PLC é um sistema que permite criar um PLC “virtual” a 

correr em IPC´s ou em PC´s “embbeded” com o sistema operativo Windows 2000, XP, 

Vista, 7(32 bit) (a partir da versão 2.11) ou Windows CE (CX “embedded PC”) e que 

pode ser programado utilizando a norma “standard” IEC 61131-3. 

Este documento técnico irá descrever de uma maneira simples os princípios 

básicos de como: 

- Utilização da livraria “TcSystem.lib“ (é colocada na pasta “TwinCAT\PLC\Lib” 

quando da instalação do TwinCAT, não necessitando de licença) e explicação do 

modo de funcionamento das suas Funções Bloco principais. 

- Criar programas de automatismo, utilizando o TwinCAT PLC, que permita 

o manuseamento de ficheiros de dados para guardar ou ler parâmetros de máquina ou 

outros dados permanentes. 



2 – Livraria “TcSystem.lib” com FB´s de manuseamento de dados 

2.1 – Função Bloco de criar/abrir ficheiros (“FB_FileOpen”) 

Com esta função bloco um novo ficheiro pode ser criado, ou um ficheiro já 

existente e fechado pode ser aberto para posterior processamento. 

VAR_INPUT 

sNetId: É uma string contendo o endereço AMS do PC em que se encontram os 

ficheiros e para a qual os comandos ADS serão dirigidos. T_AmsNetId é do tipo 

de dados STRING(23) e que levará o endereço AMS (ex. 172.16.17.1.1.1) . Caso 

esta variável esteja vazia ou não declarada, por defeito, o sistema assume o PC 

local onde está a correr o soft PLC. 

sPathName: Contem o caminho e o nome do ficheiro a ser aberto. O caminho só 

pode apontar para ficheiros pertencentes ao PC local. Isto significa que aqui não 

podemos colocar o caminho, de um outro PC, colocado numa rede. 

nMode: Contem o modo em que o ficheiro é aberto. Existem diversos códigos, 

predefinidos como constantes na libraria, para os variados modos de abertura. 

“r” - FOPEN_MODEREAD – Abre ficheiro para leitura. Caso não exista ou o 

ficheiro não é encontrado a chamada falha e dará um erro. 

“w” - FOPEN_MODEWRITE - Abre ficheiro vazio para escrita. Caso exista o 

ficheiro o seu conteúdo será apagado. 

“a” - FAOPEN_MODEAPPEND – Abre ficheiro para adicionar mais dados. 

Serão escritos a partir do EOF(End Of File) sem o apagar. Cria um ficheiro novo caso 

ele não exista. 

“r+” - FOPEN_MODEREAD OR FOPEN_MODEPLUS - Abre ficheiro já 

existente para leitura e escrita. 

“w+” - FOPEN_MODEWRITE OR FOPEN_MODEPLUS - Abre ficheiro vazio 

para leitura e escrita. Se o ficheiro já existe o seu conteúdo será destruído. 

“a+” - FOPEN_MODEAPPEND OR FOPEN_MODEPLUS - Abre ficheiro para 

leitura e adicionar novos dados. Será primeiro apagado o comando EOF, depois são 

escritos os novos dados e no fim é colocado o comando EOF. Se o ficheiro não existe 

será criado um novo. Quando o ficheiro é aberto com o comando “a” ou “a+” toda a 

escrita ocorre a partir do comando EOF. O ponteiro do ficheiro pode ser reposicionado 

(com FB_FileSeek) mas ele está sempre apontado para o final do ficheiro antes da 

escrita. Assim evita-se a escrita sobre os dados anteriores já existentes. 

“b” - FOPEN_MODEBINARY - Abre ficheiro em modo binário (não legível). 

“t” - FOPEN_MODETEXT - Abre ficheiro em modo texto (legível). 

ePath: Contem um caminho genérico ou de um outro PC, com o TwinCAT, 

colocado na rede. 

bExecute: Ordem de execução FB com a transição de flanco positiva da variável. 

tTimeout: Tempo (timeout) máximo para executar a tarefa (antes ser cancelada) 



VAR_OUTPUT 

bBusy: Esta saída permanece a TRUE até a FB completar a execução da tarefa 

(durante o tempo máximo do timeout). Enquanto esta variável estiver a TRUE não 

é aceite uma nova ordem de execução da FB. 

bError: Esta saída é posta a TRUE se ocorrer um erro durante a execução do 

comando. O tipo de erro é indicado com um código em “nErrId”. 

nErrId: Contem o tipo de erro ADS ocorrido. 

0x703 

0x70c 

0x716 

- Desconhecido ou invalido “nMode” ou “ePath”. 

- Ficheiro não encontrado. Caminho ou nome do ficheiro invalido. 

- Não existem mais ficheiros livres manuseados. 

hFile: Contem informação do endereço (ponteiro) do ficheiro aberto com sucesso. 

Exemplo: 

Neste exemplo é criado um ficheiro novo (ou abre um já existente) com o nome 

“TestFile2.txt”, que está localizado no PC local no directório raiz “C:\” . 

NOTA: Podemos usar na variável de entrada da FB “nMode” a combinação de diversos modos funcionais 

No máximo 3 como por exemplo: 

Mode = [P1] OR [P2] OR [P3] 

P1: FOPEN_MODEREAD ou FOPEN_MODEWRITE ou FOPEN_MODEAPPEND 

P2: FOPEN_MODEPLUS 

P3: FOPEN_MODEBINARY ou FOPEN_MODETEXT 

Se não configurado, em modo de texto ou binário. o ficheiro é aberto no modo configurado no sistema. Na 

maior parte dos casos é aberto em modo texto. 



2.2 – Função Bloco de escrever / guardar ficheiros (“FB_FileWrite”) 

Com esta função bloco podemos escrever e guardar dados num ficheiro. O 

ficheiro deverá ter sido criado previamente. 

VAR_INPUT 

sNetId: É uma string contendo o endereço AMS do PC em que se encontram os 





hFile: Contem informação do ficheiro anteriormente criada (“file handle”) pela 

função bloco “FB_FileOpen”. 

pWriteBuff: Contem o endereço do buffer com os dados a serem guardados / 

escritos no ficheiro. O buffer pode ser uma simples variável array cujo endereço 

pode ser encontrado com o comando ADR. 

cbWriteLen: Contem o número de bytes a serem escritos no ficheiro. 

bExecute: Ordem de execução da FB com a transição de flanco + da variável. 

tTimeout: Tempo de timeout (tempo máximo para executar a tarefa). 

VAR_OUTPUT 

bBusy: Esta saída permanece a TRUE até a FB completar a tarefa (tempo 

máximo de timeout). Enquanto esta variável estiver a TRUE não é aceite uma 

nova ordem de execução da FB. 

bError: Esta saída é posta a TRUE, se ocorrer um erro durante a execução do 

comando. O tipo de erro é indicado com um código em “nErrId”. 

nErrId : Contem o tipo de erro ADS que ocorreu . 

0x703 

0x70E 

- Desconhecido ou informação (“file handle”) invalida. 

- Ficheiro aberto com método errado. 

cbWrite: Contem o nº de bytes escritos com sucesso. 

NOTA: Erros de escrita podem ocorrer por diversos motivos e não são assinalados nas variáveis 

de saída “bError” e “nErrID”. Se ocorrer um erro de escrita o ponteiro dos dados interno do 

ficheiro está em uma posição indefinida. 

Destaco, entre outros, os seguintes: 

- O nº de bytes de dados escritos com sucesso é menor do que o comprimento indicado 

(“cbWriteLen”) ou é zero. 

- O meio físico (HD, flash memory) onde vão ser escritos os dados encontra-se cheio. 



Exemplo: 

Neste exemplo é guardado / escrito no ficheiro, aberto anteriormente com a 

“FB_FileOpen”, 10 bytes do array FILEDATA. 



2.3 – Função Bloco de fechar ficheiro (“FB_FileClose”) 

Com esta função bloco fechamos um ficheiro de dados. Só depois deste 

procedimento é que podermos manuseá-lo com outras aplicações informáticas. 

VAR_INPUT 

sNetId : É uma string contendo o endereço AMS do PC em que se encontram os 





hFile: Contem informação do ficheiro anteriormente criada (“ file handle”) pela 

função bloco “FB_FileOpen”. 

bExecute: Ordem de execução da FB com a transição de flanco + da variável. 

tTimeout: Tempo de timeout (tempo máximo para executar a tarefa). 

VAR_OUTPUT 

bBusy: Esta saída permanece a TRUE até a FB completar a tarefa (tempo 

máximo de timeout). Enquanto esta variável estiver a TRUE não é aceite uma 

nova ordem de execução da FB 

bError: Esta saída é posta a TRUE se ocorrer um erro durante a execução do 

comando . O tipo de erro é indicado com um código em “nErrId”. 

nErrId: Contem o tipo de erro ADS ocorrido. 

0x703 

0x70E 

- Desconhecido ou informação (“file handle”) invalida. 

- Ficheiro aberto com método errado (ex. com a FB obsoleta FILEOPEN). 



Exemplo: 

Neste exemplo, o ficheiro de dados associado à variável de entrada “hFile” (“file 

handle”) e anteriormente aberto com “FB_FileOpen” , é fechado . 



2.4 – Outras Funções Bloco de manuseamento de ficheiros 

2.4.1 – “FB_FileRead” 

Com esta função bloco lemos os dados de um ficheiro , já anteriormente 

aberto . 

2.4.2 – “FB_FileRename” 

Com esta função bloco renomeamos o nome de um ficheiro já existente. 

2.4.3 – “FB_FileDelete” 

Com esta função bloco apagamos um ficheiro já existente. 



2.4.4 – “FB_EOF” 

Verifica a existência no ficheiro do comando EOF (“End Of File”) . 

2.4.5 – “FB_FileGets” 

Esta função bloco lê , num ficheiro de texto anteriormente aberto , os 

dados até encontrar uma string com um comando (ex. “Line feed”, “EOF” 

ou um nº máximo de caracteres da string definida em “sLine” ) . 

2.4.6 – “FB_FilePuts” 

Esta função bloco permite escrever uma string num ficheiro de texto 

aberto . O comando de términos da string ($00) não será escrita no ficheiro. 

2.4.7 – “FB_FileSeek” 

Com esta função bloco o ponteiro (“pointer”) dos dados no ficheiro aberto, 

pode ser posicionado em outro endereço pelo programador . 



2.4.8 – “FB_FileTell” 

Com esta função bloco obtemos a posição atual do ponteiro (“pointer”) de 

dados do ficheiro aberto. Essa posição é um offset em relação á posição inicial. 

2.4.9 – “FB_CreateDir” 

Com esta função bloco criamos um novo diretório de ficheiros. 

2.4.10 – “FB_RemoveDir” 

Esta função bloco apaga um diretório de ficheiros. Não poderá conter 

ficheiros ( o directório deverá estar vazio ) . 



3 – Programa exemplo de acesso a ficheiros através de PLC 

Este exemplo ilustra o uso de diversas funções Bloco, de manuseamento de 

ficheiros de dados, da livraria “TcSystem.lib”. Será usada uma instancia da FB 

“FB_FileCopy” criada para copiar ficheiros de dados, em binário, existentes em um PC 

local ou PC remoto e guarda-los no PC local. Esta Funções Bloco não pode ser usada no 

acesso a ficheiros de dados existentes em drives localizados na rede. 

3.1 – 1º Exemplo – Programa que copia ficheiros de dados 

A sequência do automatismo da copia de dados é despoletado pela transição 

positiva da variável boolena “bExecute” e é a seguinte: 

a) Abertura dos ficheiros fonte e destino. 

b) Leitura do ficheiro fonte e colocação dos dados no buffer. 

c) Escrita dos bytes de dados, que foram lidos do buffer, no ficheiro destino. 

d) Verifica se o “fim” do ficheiro fonte foi executado. Se não foi, terá de se 

repetir os passos b) e c). Se sim salta para o passo e). 

e) Fecho dos ficheiros fonte e destino. 

O ficheiro é copiado em 1 segmento de cada vez. Neste exemplo, o tamanho do 

buffer foi dimensionado para 100 bytes mas poderá ser alterado para outro valor. 

3.1.1 - Programa principal (“MAIN”) 

Neste exemplo o ficheiro origem “Settings.txt” é copiado do diretório “Temp” do 

PC remoto (tem o TwinCAT instalado, com o endereço AMS “172.16.2.209.1.1”) para o 

ficheiro destino, com o nome “NewSettings.txt”, localizado no diretório “C:\Twincat\” do 

PC local. 



3.1.2 - Função Bloco (“FB_FileCopy”) 

Declaração das variáveis locais (“VAR_INPUT”,”VAR_OUTPUT”,”VAR”) 

Implementação do programa em ST - Structured Text . 

1º Bloco funcional do programa: Trigger de inicio da sequência das tarefas de 

manuseamento de ficheiros, a executar dentro da instrução CASE . 



2º Bloco funcional do programa: Sequência de tarefas de manuseamento de 

ficheiros. 

ETAPA 1 – [Step = 1]: Abrir ficheiro fonte para leitura em formato binário 

ETAPA 2 – [Step = 2]: Controlo da abertura do ficheiro fonte 

ETAPA 3 – [Step = 3]: Abrir ficheiro destino para escrita em formato binário 

ETAPA 4 – [Step = 4]: Controlo da abertura do ficheiro destino 



ETAPA 5 – [Step = 5]: Ler dados do ficheiro fonte 

ETAPA 6 – [Step = 6]: Controlo da leitura de dados do ficheiro fonte 

ETAPA 7 – [Step = 7]: Escrever dados no ficheiro destino 

ETAPA 8 – [Step = 8]: Controlo da escrita de dados no ficheiro destino 

BRESIMAR (asaTek) - Jorge Andril (v1.0) Pag. 15 de 16


ETAPA 9 – [Step = 30]: Fechar ficheiro destino 

ETAPA 10 – [Step = 31]: Controlo do fecho do ficheiro destino 

ETAPA 11 – [Step = 40]: Fechar ficheiro fonte 

ETAPA 12 – [Step = 41]: Controlo do fecho do ficheiro fonte 

ETAPA 13 – [Step = 50]: Controlo de erro e fecho da sequência

BRESIMAR(asaTek)-Beckhoff-Nota Aplicação TwinCAT 2-15 MFiles

Create successful ePaper yourself

Delete template?

Save as template?