FS_CHANGE_DIR

Troca o diretório de trabalho atual no sistema de arquivos do SDCARD do controlador; o caminho informado em NAME deve ser absoluto (iniciar por /) e ter no máximo 64 caracteres. É um bloco de função (mantém estado entre scans; requer instância).

Biblioteca: HI_STD · Namespace: HILS · Tipo: bloco de função

Bloco de função

            FS_CHANGE_DIR
           +--------------+
  BOOL ----|START     DONE|---- BOOL
           |              |
           |        RESULT|---- INT
           |              |
STRING ----|NAME -------- |----
           +--------------+

Coloque START em TRUE para iniciar a troca de diretório. Se START voltar a FALSE antes do fim da operação, o bloco é resetado. Ao concluir, DONE emite um pulso de um único ciclo de scan; nesse instante o resultado deve ser lido em RESULT (HILS.SUCCESS = 0 indica sucesso). Após a troca, as demais funções do sistema de arquivos passam a operar dentro do novo diretório. O diretório raiz é identificado por / e, por padrão, é o diretório inicial do sistema de arquivos.

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.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
START	IN	BOOL	FALSE	—	Ativação da função. Voltar a FALSE antes do término reseta o bloco.
NAME	IN_OUT	STRING	—	caminho absoluto, máx. 64 caracteres	Caminho completo do diretório a acessar; deve iniciar por `/` (raiz é apenas `/`).
DONE	OUT	BOOL	FALSE	—	Pulso (um ciclo de scan) que indica o término da execução.
RESULT	OUT	INT	0	RET_CODE	Código de retorno da execução (ver Códigos de retorno).

Códigos de retorno

RESULT é do tipo RET_CODE. Use os identificadores com o namespace HILS (ex.: HILS.RE_NOT_AVA). Códigos mais comuns deste bloco:

Código	Identificador	Significado
0	SUCCESS	Função executada com sucesso.
5	GL_INV_PAR	Parâmetro(s) inválido(s).
7	GL_UNA_CMD	Comando não disponível ou não implementado.
8	GL_INV_STT	Estado corrente inválido.
10	GL_CMD_TMO	Timeout na execução do comando.
11	GL_CMD_CAN	Comando cancelado.
16	GL_CMD_PEND	Tratamento do comando pendente.
24	RE_NOT_AVA	Sem suporte para o sistema de arquivos ou SDCARD não detectado.
25	RE_INV_LEN	Tamanho da variável `NAME` inválido.
33	RE_NOT_INIT	Recurso não inicializado.
167	FS_CORRUPT	Sistema de arquivos pode estar corrompido.
174	FS_NOTFOUND	O diretório não foi encontrado.
178	FS_INVALID_DIR	Diretório inválido ou inexistente.

Lista completa dos códigos de retorno: RET_CODE - Códigos de retorno do firmware G5.

Pré-condições

O controlador deve possuir suporte a sistema de arquivos em SDCARD e o cartão deve estar presente e inicializado.
NAME deve conter um caminho absoluto (iniciar por /) com no máximo 64 caracteres.

Observações

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

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

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

Caracteres numéricos de 0-9

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

Tamanho máximo de 64 caracteres para o nome

O sistema não é case sensitive: DADOS.DAT, Dados.Dat e dados.dat referem-se ao mesmo arquivo.

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

O diretório inicial default é o diretório raiz. Para acessá-lo diretamente, utilize / antes do nome do arquivo ou diretório. Exemplos de caminho completo para diretórios:

/ — diretório raiz do sistema de arquivos

/PASTA_1 — diretório “PASTA_1” localizado na raiz

/PASTA_1/PASTA_2 — caminho completo até “PASTA_2” a partir de “PASTA_1”

/p1/p2/p3 — caminho completo até “p3” a partir de “/p1/p2”

Ver também

FS_GET_CUR_DIR, FS_CREATE_DIR, FS_LIST_DIR

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    DIR_DADOS  : STRING := '/DIR1'; (* String com o nome do diretório a ser acessado *)
    DIR_ROOT   : STRING := '/';     (* String com caractere de acesso ao diretório raiz *)
    MY_START   : BOOL := FALSE;     (* Ativação da função *)
    DIR_NAME   : STRING;            (* Nome do diretório, limitado a 64 caracteres *)
    CHANGE_DIR : HILS.FS_CHANGE_DIR; (* Instância do bloco "FS_CHANGE_DIR" *)
END_VAR

//==========================================================
// Exemplo de parametrização 1: Trocar o diretório atual para '/DIR1'
//==========================================================

// As funções do sistema de arquivo passarão a realizar suas operações
// dentro desse novo diretório '/DIR1'.

// Preenche parâmetros para a chamada do bloco de função
DIR_NAME := DIR_DADOS;   // Nome do diretorio '/DIR1'

(* ... *)

//==============================================================
// Exemplo de parametrização 2: Retorna para diretório raiz do sistema de arquivo
//==============================================================

// Para voltar o acesso ao diretório raiz onde o sistema de arquivos
// é inicializado, é necessário passar a string '/'

// Preenche parâmetros para a chamada do bloco de função
DIR_NAME := DIR_ROOT;    // String para acessar o diretório raiz

(* ... *)

//==============================================================
// Exemplo de parametrização 3: Trocar o diretório atual para '/PASTA_1/PASTA_2'
//==============================================================

// Preenche parâmetros para a chamada do bloco de função
DIR_NAME := '/PASTA_1/PASTA_2';    // String para acessar o diretório

(* ... *)

//============================================================================
// Trata função FS_CHANGE_DIR
//============================================================================

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

(* ... *)

// Exemplo de ativação do bloco de função FS_CHANGE_DIR
CHANGE_DIR(
  START := MY_START,    // [BOOL] Ativação da função
  NAME  := DIR_NAME     // [STRING] Nome do diretório
  );

// Aguarda término da execução da função do sistema de arquivos
if (CHANGE_DIR.DONE) then

  MY_START := FALSE;     // Reseta ativação da função

  // Testa código de retorno da execução da função
  if (CHANGE_DIR.RESULT = HILS.SUCCESS) then
    // ... Função executada com sucesso
  else
    // ... Erro na execução da função
  end_if;

end_if;

(* ... *)