GET_SYSVAR

Obtém o valor da variável de sistema associada ao endereço especificado. É uma função.

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

Função

           GET_SYSVAR
         +-------------+
UINT ----|ADDR         |---- INT
         +-------------+

Nota

Se o endereço especificado for inválido a função retorna o valor zero e ativa o código de falha do ambiente. Este código de falha pode ser obtido através da função GET_SYSTEM_ERR.

Parâmetros

Nome

Direção

Tipo

Padrão

Faixa / Unidade

Descrição

ADDR

IN

UINT

0

—

Endereço da variável de sistema a ser obtida.

Retorno / Saídas

Retorna INT — valor da variável de sistema especificada. Retorna zero quando o endereço é inválido (ver Observações).

Observações

  • Endereço inválido faz a função retornar zero e ativar o código de falha do ambiente, recuperável via GET_SYSTEM_ERR.

Ver também

GET_SYSTEM_ERR

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    f_ver : INT; (* Nro da versão do firmware corrente *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
f_ver := HILS.GET_SYSVAR(ADDR := 11);   (* retorna o nro da versão do firmware do equipamento *)
(* ... *)