iDBlock Next

A catraca inteligente iDBlock Next (vide https://www.controlid.com.br/controle-de-acesso/idblock-next/) tem como componentes uma placa principal (Main) e dispositivos de identificação, a saber: até 2 iDFaces (conforme modelo) e IHM (conforme modelo). Caso desejado, a conexão do conjunto como um todo à internet envolve um único ponto de rede Ethernet externo, pois as demais conexões são todas internas, em um switch integrado, de forma a possibilitar a comunicação entre os componentes.

Cada um dos componentes de identificação pode ter como papel o de primário ou o de secundário, conforme descrito na próxima seção. Uma vez configurados os papéis, toda a integração seguinte é feita com comunicação exclusiva com o dispositivo primário do conjunto. Por exemplo, é o endereço IP do primário que deve ser fornecido ao software iDSecure, o qual informará alterações de cadastro de usuários e de regras de acesso diretamente ao primário, de forma a serem válidas para todo o conjunto. Nas seções posteriores serão elencadas as demais particularidades de integração para a iDBlock Next.

Modos de operação na iDBlock Next

Equipamentos que fazem parte de um conjunto iDBlock Next devem ser configurados para funcionarem em um de dois modos: Dispositivo Primário ou Dispositivo Secundário.

Um dispositivo configurado como primário será responsável por autorizar o acesso de usuários em todos os dispositivos secundários com os quais está conectado. Além disso, algumas funcionalidades, como cadastro de usuários e geração de relatórios de acesso, não estão disponíveis em dispositivos secundários e configurações específicas são modificadas automaticamente para se manterem consistentes em todo o conjunto.

É recomendado que a configuração do papel de cada dispositivo do conjunto seja feita assim que possível, pois é essencial para o funcionamento correto da catraca iDBlock Next. É importante também se assegurar que cada catraca possui um, e somente um, dispositivo primário, evitando conflitos durante a operação.

Configuração dos modos de operação

Para configurar o modo de operação no conjunto da catraca pela API, é necessário modificar a configuração catra_role, localizada no módulo sec_box, de acordo com a tabela abaixo:

Modo de Operação catra_role
Dispositivo fora do conjunto 0
Dispositivo primário 1
Dispositivo secundário 2

A alteração desse parâmetro deve ser feita com cuidado, pois, para garantir a integridade e bom funcionamento do conjunto iDBlock Next, a mudança no valor da configuração catra_role causa um reinício no equipamento e a limpeza de informações em seu banco de dados (configurações gerais e de rede são mantidas) automaticamente. Por esse motivo, é recomendado que exista um backup de informações importantes antes da execução desse procedimento, além de não se alterar o modo de operação frequentemente.

No caso do dispositivo primário, outras configurações de modo de operação podem ser modificadas, de acordo com a seção Modos de operação deste documento. Já para aparelhos configurados como secundários, tais configurações não devem ser modificadas.

Também é importante ressaltar que a IHM não deve funcionar como dispositivo primário caso um ou mais iDFace estejam conectados à iDBlock Next e, caso seja configurada dessa forma, a configuração será sobrescrita automaticamente.

Exemplo de requisição para iDFace ou IHM primários

Essa requisição configura um iDFace ou IHM como dispositivo primário:

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({
        "sec_box": {
            "catra_role": "1"
        }
    })
});

Exemplo de requisição para iDFace ou IHM secundários

Essa requisição configura um iDFace ou IHM como dispositivo secundário:

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({
        "sec_box": {
            "catra_role": "2"
        }
    })
});

Outras configurações importantes da catraca

Configurações específicas para controle da catraca. Todas as configurações também são do módulo sec_box.

Parâmetros do módulo: sec_box

Campo Tipo Descrição
catra_default_fsm string Modo de operação da catraca. Controla quais sentidos da catraca serão controlados ou liberados. Deve ser "0" (ambos os giros controlados), "1" (ambos os giros liberados), "2" (giro no sentido anti-horário liberado) ou "3" (giro no sentido horário liberado).
catra_side_to_enter string Indica qual sentido de giro da catraca será considerado como de entrada. Os valores são "0" (horário) ou "1" (anti-horário).
catra_timeout string Indica o tempo de duração da liberação do giro, em milissegundos. Ex.: "5000" para liberação de entrada / saída por 5 segundos.
catra_bio_sync_period string Intervalo de tempo em que haverá sincronismo periódico de biometria entre os dispositivos primário e secundário(s), em milissegundos. Valor padrão: "1000".
catra_sync_period string Intervalo de tempo em que haverá sincronismo periódico de usuários entre os dispositivos primário e secundário(s), em milissegundos. Valor padrão: "5000".
catra_config_sync_period string Intervalo de tempo em que haverá sincronismo periódico de configurações entre os dispositivos primário e secundário(s), em segundos. Valor padrão: "60".
catra_relay_1_enabled int Indica se o relé 1 da catraca está habilitado. Valores: "0" para desabilitado e "1" para habilitado.
catra_relay_1_enable_direction string Indica a direção da liberação de rotação do braço da catraca que causará a ativação do relé 1, caso o parâmetro catra_relay_1_enabled esteja habilitado. Valores: "left" para rotação em sentido anti-horário e "right" para rotação em sentido horário.
catra_relay_2_enabled int Indica se o relé 2 da catraca está habilitado. Valores: "0" para desabilitado e "1" para habilitado.
catra_relay_2_enable_direction string Indica a direção da liberação de rotação do braço da catraca que causará a ativação do relé 2, caso o parâmetro catra_relay_2_enabled esteja habilitado. Valores: "left" para rotação em sentido anti-horário e "right" para rotação em sentido horário.
catra_collect_visitor_card string Habilita a saída de visitantes com cartão feita exclusivamente através de depósito de cartão na urna coletora. Os valores são "0" para desabilitar a funcionalidade e "1" para habilitar.

Exemplo de requisição para dispositivo primário

Essa requisição configura um dispositivo primário com os parâmetros da catraca:

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({
        "sec_box": {
            "catra_default_fsm": "0",
            "catra_side_to_enter": "0",
            "catra_timeout": "1000",
            "catra_sync_period": "5000",
            "catra_config_sync_period": "60",
            "catra_relay_1_enabled": "1",
            "catra_relay_1_enable_direction": "right",
            "catra_relay_2_enabled": "1",
            "catra_relay_1_enable_direction": "left"
        }
    })
});

Evento de desistência de acesso

Assim como nas catracas da linha iDBlock V2, nos modos standalone ou contingência (vide Modos de operação), caso um acesso autorizado (evento 7) não seja seguido de um evento de giro no respectivo tempo de liberação, este passará a ser uma desistência de acesso (evento 13) no respectivo log de acesso. Vide Lista de Objetos para mais detalhes sobre os eventos dos logs de acesso.

Notificações do monitor

De forma também equivalente às catracas da linha iDBlock V2, a iDBlock Next conta com o endpoint de eventos de catraca catra_event em todos os modos de operação. Nele serão notificados eventos de giro à direita (horário), giro à esquerda (anti-horário) e desistência de acesso, conforme documentado aqui.

Eventos de identificação no modo online

Em complemento à documentação de mensagens dos eventos de identificação em modo online, caso o dispositivo seja o primário de um conjunto iDBlock Next haverá também o envio do seguinte parâmetro:

component_id,

o qual segue a mesma lei de formação documentada aqui e pode ser utilizado para definir se a identificação ocorreu em um iDFace primário, iDFace secundário, Wiegand da Urna ou IHM (com valores decodificados "0MS1", "0MS2", "0WS0" e "0TS0", respectivamente), possibilitando o correto gerenciamento do servidor online.

Saída de visitantes

A saída de visitantes com cartão deve ser obrigatoriamente realizada com depósito de cartão na urna. Essa funcionalidade deve ser habilitada apenas sob o uso de catraca com urna coletora de cartão. Sua configuração pode ser feita via interface WEB do embarcado, via API ou via GUI. A requisição para habilitar essa opção está mostrada abaixo.

Exemplo de requisição para habilitar saída de visitantes somente por cartão

Essa requisição configura a saída de visitantes somente com depósito de cartão na urna:

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({
        "sec_box": {
            "catra_collect_visitor_card": "1"
        }
    })
});