iDBlock Next

The iDBlock Next smart turnstile (see https://www.controlid.com.br/controle-de-acesso/idblock-next/) has as components a main board and identification devices, namely: up to 2 iDFaces (according to model) and HMI (according to model). If desired, connecting the set as a whole to the internet involves a single external Ethernet network point, as the other connections are all internal, in an integrated switch, in order to enable communication between the components.

Each of the identification components can have the role of primary or secondary, as described in the next section. Once the roles are configured, all subsequent integration is done with exclusive communication with the primary device in the set. For example, it is the IP address of the primary that must be provided to the iDSecure software, which will inform changes like user registrations and access rules directly to the primary, so that they are valid for the entire set. In subsequent sections, other integration features for iDBlock Next will be listed.

iDBlock Next operation modes

Devices that are part of an iDBlock Next set must be configured to work in one of two modes: Primary Device or Secondary Device.

A device configured as primary will be responsible for authorizing user access to all secondary devices connected to it. Additionally, some features, such as user registration and access reporting, are not available on secondary devices and specific settings are automatically modified to remain consistent across the entire set.

It is recommended that the role configuration of each device in the set be done as soon as possible, as it is essential for the correct functioning of the iDBlock Next smart turnstile. It is also important to ensure that each turnstile has one, and only one, primary device, avoiding any conflicts during operation.

Configuring the operation modes

The operation modes in the iDBlock Next set can be changed using the API through the parameter catra_role, located in the sec_box module, following the table below:

Operation Mode catra_role
Device not in iDBlock Next 0
Primary device 1
Secondary device 2

Changing this parameter must be done carefully, because, to guarantee the integrity and proper functioning of the iDBlock Next set, changing the value of the catra_role configuration causes a restart of the equipment and the cleaning of information in its database (general and network settings are maintained) automatically. For this reason, it is recommended that there is a backup of important information before carrying out this procedure, in addition to not changing the operating mode frequently.

Regarding the primary device, other operating mode settings can be modified, according to the section Operation modes of this document. For devices configured as secondary, such settings must not be modified.

It is also important to highlight that the must not function as a primary device if one or more iDFace is connected to the iDBlock Next and, if it is configured this way, the configuration will be automatically overwritten.

Turnstile Configuration with iDFaces and HMI

It’s worth noting that an iDBlock Next can be configured in multiple ways by combining its cover (HMI) and iDFace devices. The HMI is the cover that goes on top of the iDBlock Next, with a display on it.

  • Configuration 1: HMI Only, No iDFace - In this mode, the HMI acts as the primary device and must be configured to control the turnstile entirely. Access control in this case is done through biometrics, cards, PINs, or passwords.
  • Configuration 2: Only 1 or 2 iDFaces, No HMI - In this mode, one of the installed iDFaces serves as the primary. With this configuration, the iDFaces are responsible for access control at the turnstile for both entry and exit. While this mode doesn’t offer biometric access control like the HMI, it still provides access control via facial recognition, cards, PINs, or passwords.
  • Configuration 3: HMI with 1 or 2 iDFaces - In this mode, one of the iDFaces must be the primary, controlling the other iDFace (if present) and the HMI as secondary devices. This configuration offers both biometric and facial identification, as well as card, PIN, and password access.

It’s also important to note that the secondary device, in any of the configurations, is never connected to an online server. All configurations are exclusively managed by the primary device, that controls the turnstile as an Access Control device or by receiving commands via the API.

Example of request for primary iDFace or HMI

This request configures an iDFace or HMI as the primary device:

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

Example request for secondary iDFace or HMI

This request configures an iDFace or HMI as a secondary device:

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

Other important turnstile settings

Specific settings for turnstile control. All settings are also from the sec_box module.

Parameters from the module: sec_box

Field Type Description
catra_default_fsm string The turnstile operating mode. Controls which turnstile directions will be controlled or released. It should be "0" (both turns controlled), "1" (both turns released), "2" (anticlockwise turn released), or "3" (clockwise turn released).
catra_side_to_enter string Indicates which turn direction of the turnstile will be used as entrance. Values are "0" (clockwise) or "1" (anticlockwise).
catra_timeout string Indicates the default turn release time, in milliseconds. Ex.: "5000" for entry/exit release for 5 seconds.
catra_bio_sync_period string Time interval in which there will be periodic synchronization of biometrics between the primary and secondary devices, in milliseconds. Default value: "1000".
catra_sync_period string Time interval in which there will be periodic synchronization of users between the primary and secondary devices, in milliseconds. Default value: "5000".
catra_config_sync_period string Time interval in which there will be periodic synchronization of configurations between the primary and secondary devices, in seconds. Default value: "60".
catra_relay_1_enabled int Indicates if relay 1 of the turnstile is enabled. Values: "0" for disabled and "1" for enabled.
catra_relay_1_enable_direction string Indicates the direction of turnstile arm rotation release that will cause relay 1 to activate if parameter catra_relay_1_enabled is enabled. Values: "left" for counterclockwise rotation and "right" for clockwise rotation.
catra_relay_2_enabled int Indicates if relay 2 of the turnstile is enabled. Values: "0" for disabled and "1" for enabled.
catra_relay_2_enable_direction string Indicates the direction of turnstile arm rotation release that will cause relay 2 to activate if parameter catra_relay_2_enabled is enabled. Values: "left" for counterclockwise rotation and "right" for clockwise rotation.
catra_collect_visitor_card string Enables the exit of visitors with cards made exclusively by depositing the card in the collection box. Values ​​are "0" to disable the functionality and "1" to enable.

Example of request for primary device

This request configures a primary device with the turnstile parameters:

$.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"
        }
    })
});

Access give up event

As with the turnstiles of the iDBlock V2 line, in standalone or contingency modes (see Operation modes), if an authorized access (event 7) is not followed by a turn event within the respective release timeout, this will become an access withdrawal (event 13) in the respective access log. See List of Objects for more details about access log events.

Monitor notifications

Also equivalently to the turnstiles in the iDBlock V2 line, iDBlock Next has the turnstile event endpoint catra_event in all operation modes. Events of turning right (clockwise turn), turning left (anticlockwise turn) , and give up access will be notified there, as documented here.

Identification events in online mode

In addition to the message documentation for events of identification in online mode, if the device is the primary of an iDBlock Next set, the following parameter will also be sent:

component_id,

which follows the same formation law documented here and can be used to define whether the identification occurred on a primary iDFace, secondary iDFace, Collector's Wiegand or HMI (with decoded values "0MS1", "0MS2", "0WS0" and "0TS0", respectively), facilitating the correct management by the online server.

Exit of visitors

Visitors with a card must leave by depositing the card in the ballot box. This functionality must only be enabled when using a turnstile with a card collection box. Its configuration can be done via the WEB interface, via API or via GUI. The request to enable this option is shown below.

Example of request to enable visitor exit only by card

This request allows visitors to leave only after depositing a card in the ballot box:

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

Setting up the LEDs

Through the API we can configure the color of the RGB LEDs on the iDBlock Next and trigger events that will change those colors through the following request:

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

As each parameter on the request is described below:

  • color: String with a number that represents an Alfa-RGB hexadecimal code (ordered in ARGB). For example "4278255360" for the color green (#FF00FF00) or "4294901760" for red (#FFFF0000).

  • event: Integer representing an event among the following five options:

    • 0: Authorized event (sets light as green)
    • 1: Non-authorized event (sets light as red)
    • 2: Idle event (sets light as Idle Color)
    • 3: De-activation event (turns light off)
    • 4: Idle Color change event (sets Idle Color as the passed color parameter)
    • Others: Idle Event

In short, authorized and non-authorized event colors are fixed as green and red, respectively. However, we can change the Idle State color as we wish by sending it with an event with code 4, followed by an event with code 2 to switch to the Idle State.

To turn the lights off, we can send an event with code 3.