SET_SECURITY_GRP

Define o atributo de segurança dos grupos indicados pelos bits do parâmetro GROUP, aplicando a cada grupo selecionado o atributo informado em ATB; falha se o equipamento não suportar Recursos de segurança da aplicação. É uma função (sem estado interno; não requer instância).

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

Função

         SET_SECURITY_GRP
         +-------------+
 WORD ---|GROUP        |--- INT
         |             |
USINT ---|ATB          |
         +-------------+

Os grupos são mapeados nos bits de GROUP: o bit 0 corresponde ao grupo 0, o bit 1 ao grupo 1 e assim por diante. Bit em 0 mantém o grupo inalterado (ignorado); bit em 1 programa no grupo associado o atributo definido em ATB.

Atributos possíveis para ATB:

Valor

Descrição

0

Grupo sem restrição de segurança.

1

Grupo com restrição de segurança liberada por senha.

3

Grupo com restrição de segurança e sem liberação por senha.

Importante

Para consultar os grupos e os atributos de segurança disponíveis acesse: Recursos de segurança da aplicação.

Ao definir um atributo com restrições de segurança será bloqueado qualquer comando de comunicação associado ao grupo especificado. Na tentativa de comunicação o mestre que enviou o comando obtém o código de retorno “Comando recusado por restrições de segurança” (HILS.CO_CMD_DENIED).

No caso de restrições aos comandos de leitura e escrita na base exportada (grupos 2 e 3), o mestre obtém o código de retorno “Falha na execução do comando pelo equipamento remoto”.

Nota

Se o equipamento não suportar o recurso de Recursos de segurança da aplicação a função falha e retorna HILS.RE_NOT_AVA. Se o atributo for inválido a função falha e retorna HILS.GL_INV_PAR.

A Biblioteca HI_STD disponibiliza dois tipos enumeradores para a definição dos flags de grupos e atributos de segurança (ver Definição de recursos de segurança via flag).

Parâmetros

Nome

Direção

Tipo

Padrão

Faixa / Unidade

Descrição

GROUP

IN

WORD

—

bitmask de grupos

Grupos de segurança associados (cada bit seleciona um grupo).

ATB

IN

USINT

—

0, 1, 3

Atributo de bloqueio a ser programado nos grupos selecionados.

Códigos de retorno

A função retorna um INT com o código de resultado (0 = sucesso). Códigos mais comuns desta função:

Código

Identificador

Significado

0

SUCCESS

Atributo programado com sucesso.

5

GL_INV_PAR

Atributo (ATB) inválido.

24

RE_NOT_AVA

Equipamento não suporta o recurso de flags de segurança.

Lista completa dos códigos de retorno: RET_CODE - Códigos de retorno do firmware G5.

Pré-condições

Ver também

SET_SECURITY_ATB, Recursos de segurança da aplicação

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    GRP_FLAGS : WORD; (* definição dos grupos *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)

GRP_FLAGS := 16#0006;  (* Seleciona os grupos 1 e 2 *)
HILS.SET_SECURITY_GRP(GROUP := GRP_FLAGS, ATB := 1); (* Habilita segurança dos grupos 1 e 2 com liberação via senha *)
(* ... *)