FS_FORMAT

Formata o sistema de arquivos do SDCARD.

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_FORMAT
         +--------------+
BOOL ----|START     DONE|---- BOOL
         |              |
         |        RESULT|---- 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

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]

Considerações para utilização da função:

Este comando pode demorar alguns segundos, podendo chegar a unidade de minutos, pois é dependente da capacidade do cartão de memória existente no SDCARD do controlador.

Uma vez ativada a função, a mesma será sempre executada e concluída pelo controlador, mesmo que a função seja interrompida (fazendo START = FALSE) antes da sua conclusão. Ou seja, uma vez iniciada a formatação, a mesma não pode mais ser interrompida.

Enquanto a função estiver executando no controlador, o código de retorno será de HILS.GL_CMD_PEND (RESULT = 16), indicando que ainda existe um comando com tratamento pendente na fila de processamento da CPU.

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
FORMAT	FS_FORMAT		Instância do bloco “FS_FORMAT”

Clique aqui para baixar a tabela de variáveis

Código ST

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

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

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

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

  end_if;

(* ... *)