GET_SCAN

Obtém informações sobre o tempo de scan da aplicação em execução no equipamento, em microssegundos. O tipo de informação (média, última, mínima ou máxima) é selecionado pela entrada. É uma função (sem estado entre scans).

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

Função

            GET_SCAN
        +--------------+
        |              |
INT ----|scan_type     |---- UDINT
        |              |
        +--------------+

O valor de scan_type seleciona qual métrica de tempo de scan é retornada:

Valor	Informação retornada
0	Tempo médio de scan (µs) das últimas 100 interações consecutivas.
1	Tempo de scan (µs) da última interação do programa de aplicação.
2	Menor tempo de scan (µs) da sessão corrente, ou desde a última carga da aplicação.
3	Maior tempo de scan (µs) da sessão corrente, ou desde a última carga da aplicação.

Nota

A resolução do valor retornado depende do hardware do equipamento.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
scan_type	IN	INT	0	0 .. 3	Tipo de informação de scan a ser obtida (ver tabela acima).

Retorno / Saídas

Retorna um UDINT com o tempo de scan selecionado, em microssegundos (µs).

Observações

• A resolução do tempo retornado é dependente do hardware do equipamento.

• Valores de scan_type fora da faixa 0 .. 3 não possuem informação associada.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    scan_code  : INT;   (* Tipo de scan a ser solicitado *)
    scan_value : UDINT; (* Tempo de scan em microsegundos *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
scan_code  := 0;
scan_value := HILS.GET_SCAN(scan_type := scan_code);
(* ... *)
scan_code  := 1;
scan_value := HILS.GET_SCAN(scan_code);
(* ... *)
scan_code  := 2;
scan_value := HILS.GET_SCAN(scan_type := scan_code);
(* ... *)
scan_value := HILS.GET_SCAN(3);
(* ... *)