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
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 *)
(* ... *)