FS_GET_CUR_DIR

Obter o caminho completo referente ao diretório corrente de trabalho no sistema de arquivos do controlador.

Nota

Antes de utilizar este bloco de função, consulte no manual do controlador utilizado se o mesmo possui suporte para sistema de arquivos no SDCARD.

Bloco

           FS_GET_CUR_DIR
         +----------------+
BOOL ----|START       DONE|---- BOOL
         |                |
         |          RESULT|---- INT
         |                |
         |        PATH_DIR|---- STRING
         +----------------+

Parâmetros

Nome	Classe	Tipo	Dim.	V. Ini.	Descrição
START	Entrada	BOOL		FALSE	Ativação da função
ENO	Saída	BOOL		FALSE	Saída de habilitação
RESULT	Saída	INT		0	Código de retorno da execução da função
PATH_DIR	Saída	STRING			Caminho completo do diretório corrente

Detalhamento dos Parâmetros

Parâmetro	Descrição
START	Deve ser colocado em “TRUE” para iniciar a execução. Caso seu valor seja alterado para “FALSE” antes do fim da operação, o bloco irá ser resetado.
DONE	Pulso para indicar o término da execução da função. Após este pulso (fica ativo por apenas um ciclo de scan), o resultado da execução da função deve ser consultado no parâmetro de saída “RESULT”.
PATH_DIR	Retorna o caminho completo para o diretório corrente de operação do sistema de arquivo. Se estiver no diretório raiz retorna string com valor ‘/’.
RESULT	Código de retorno associado a execução da função, onde: Se for igual a 0: Função executada com sucesso, código HILS.SUCCESS Se for diferente de 0: Falha na execução da função [2]

Recomendações para nomes de arquivos e diretórios:

Apesar do sistema de arquivos aceitar qualquer caracter para definição de um nome de arquivo ou diretório, recomenda-se utilizar apenas os tipos:

Caracteres alfabéticos de A-Z ou a-z

Caracteres numéricos de 0 - 9

Caracteres especiais . (ponto decimal) ou _ (underline)

O tamanho máximo permitido para nome do arquivo ou diretório é de 64 caracteres.

Apesar de permitir caracteres em minúscula e maiúscula na nomenclatura, o sistema não é “case sensitive”, ou seja, os nomes ‘DADOS.DAT’, ‘Dados.Dat’ e ‘dados.dat’ referem-se ao mesmo arquivo.

Essa recomendação é sugerida, pois quando o arquivo for eventualmente transferido para o computador, o arquivo/diretório deve obedecer as regras de nomeação do sistema operacional do PC.

Exemplos de nomes recomendados:

‘PASTA’

‘/Pasta_1/Pasta_2’

‘dados.dat’

‘abc_123.txt’

Exemplos de nomes não recomendados:

‘teste abc’

‘áãç’

‘abc’ e ‘ABC’ (considerados como o mesmo arquivo pelo sistema operacional windows)

Instruções de acesso para arquivos e diretórios:

O diretório inicial default do sistema de arquivo é o diretório raiz.

Para acessar diretamente o diretório raiz, utilizar ‘/’ antes do nome do arquivo ou diretório.

Exemplos de caminho completo para diretórios:

‘/’ : Diretório raiz do sistema de arquivo
‘/PASTA_1’ : Diretório “PASTA_1” localizado na raiz do sistema de arquivo
‘/PASTA_1/PASTA_2’ : Caminho completo para diretório “PASTA_2” a partir da “PASTA_1” localizado na raiz do sistema de arquivo
‘/p1/p2/p3’ : Caminho completo para diretório “p3” a partir dos diretórios “/p1/p2”

Exemplos de caminho completo para arquivos:

‘/dados.dat’ : Arquivo “dados.dat” localizado na raiz do sistema de arquivo
‘/PASTA_1/Log.dat’ : Arquivo “Log.dat” localizado dentro do diretório “/PASTA_1”
‘/DADOS/Jan/Dados.bak’ : Arquivo “Dados.bak” localizado dentro dos diretórios “/DADOS/Jan”
‘/P1/P2/P3/SETUP.CFG’ : Arquivo “SETUP.CFG” localizado dentro dos diretórios “/P1/P2/P3”

Exemplo

Declaração de variáveis

Nome	Tipo	Valor Inicial	Descrição
PATH	STRING		String com o caminho do diretório corrente
MY_START	BOOL	FALSE	Ativa função do sistema de arquivo
CUR_DIR	FS_GET_CUR_DIR		Instância do bloco “FS_GET_CUR_DIR”

Clique aqui para baixar a tabela de variáveis

Código ST

  //==============================================================
  // Exemplo para obter o diretório atual
  //==============================================================

  // Preenche parâmetros para a chamada do bloco de função
  MY_START := TRUE;      // Ativa função do sistema de arquivo

  // Exemplo de ativação do bloco de função FS_GET_CUR_DIR
  CUR_DIR(
    START := MY_START  // [BOOL] Ativa função do sistema de arquivo
    );

  // Aguarda término da execução da função do sistema de arquivos
  if (CUR_DIR.DONE) then
    // Testa código de retorno da execução da função
    if (CUR_DIR.RESULT = HILS.SUCCESS) then

      // ... Função executada com sucesso.

      //     Resultado disponível nas variáveis:
      //     CUR_DIR.PATH_DIR   // [STRING] Caminho do diretório corrente

      PATH := CUR_DIR.PATH_DIR;
    else
      // ... Erro na execução da função
      //
      //     Em CUR_DIR.RESULT temos o código de erro referente a execução da função
    end_if;

  end_if;

(* ... *)