FS_GET_INFO

Obter informações gerais do sistema de arquivos do SDCARD 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_INFO
         +----------------------+
BOOL ----|START             DONE|---- BOOL
         |                      |
         |                RESULT|---- INT
         |                      |
         |           FS_REVISION|---- INT
         |                      |
         |        MAX_OPEN_FILES|---- INT
         |                      |
         |        CUR_OPEN_FILES|---- INT
         |                      |
         |          MAX_LEN_NAME|---- INT
         +----------------------+

Parâmetros

Nome	Parâmetro	Tipo Dado	Valor Inicial	Descrição
START	Entrada	BOOL	FALSE	Ativação da função
DONE	Saída	BOOL	FALSE	Pulso de fim de execução da função
RESULT	Saída	INT	0	Código de retorno da execução da função
FS_REVISION	Saída	INT	0	Revisão do sistema de arquivos do controlador
MAX_OPEN_FILES	Saída	INT	0	Capacidade de arquivos abertos simultaneamente
CUR_OPEN_FILES	Saída	INT	0	Quantidade de arquivos abertos atualmente no sistema de arquivos
MAX_LEN_NAME	Saída	INT	0	Tamanho máximo para nome de arquivo ou diretório

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”.
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 [3]
FS_REVISION	Revisão do sistema de arquivos, composto por dosi campos de revisão: Revisão menor: bit 0..4, permitindo valores entre (0..31) Revisão maior: bit 5..7, permitindo valores entre (0..7) Exemplo: FS_REVISION = 35, indica : Revisão menor: 3, valor obtido dos bit 0..4 Revisão maior: 1, valor obtido dos bit 5..7, deslocados para os bits 0..2
MAX_OPEN_FILES	Capacidade de arquivos que podem ser abertos simultaneamente na revisão atual do sistema de arquivos. São considerados os acessos abertos para leitura e escrita.
CUR_OPEN_FILES	Quantidade de arquivos com acessos abertos atualmente no sistema de arquivos. São considerados os acessos de leitura e de escrita.
MAX_LEN_NAME	Tamanho máximo para nome de arquivo ou diretório.

Segue alguns exemplos de códigos de retorno:

RESULT	LABEL [4]	Descrição
0	HILS.SUCCESS	Função executada com sucesso.
5	HILS.GL_INV_PAR	Parâmetro(s) inválido(s).
7	HILS.GL_UNA_CMD	Comando não disponivel ou nao implementado.
8	HILS.GL_INV_STT	Estado corrente inválido.
11	HILS.GL_CMD_CAN	Comando cancelado.
16	HILS.GL_CMD_PEND	Tratamento do comando pendente.
24	HILS.RE_NOT_AVA	Sem suporte para o sistema de arquivos ou SDCARD não detectado.
33	HILS.RE_NOT_INIT	Recurso não inicializado.
34	HILS.RE_BUSY	Recurso em processamento.
167	HILS.RC_FS_CORRUPT	Sistema de arquivo pode estar corrompido.

Exemplo

Declaração de variáveis

Nome	Tipo	Valor Inicial	Descrição
MY_START	BOOL	FALSE	Ativação da função
GET_INFO	FS_GET_INFO		Instancia do bloco “FS_GET_INFO”

Clique aqui para baixar a tabela de variáveis

Código ST

//============================================================================
// Trata função FS_GET_INFO
//============================================================================

// Preenche 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_GET_INFO
GET_INFO(
  START := MY_START      // [BOOL] Ativação da função
  );

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

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

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

end_if;

(* ... *)