Integración con dispositivos de terceros

Prev Next

Integración vía Wiegand

La función Wiegand permite que el dispositivo Akuvox actúe como controlador o lector de tarjetas.

Configúralo en el dispositivo web > la interfaz de Wiegand.

  • Modo de visualización Wiegand: Selecciona el formato de código de tarjeta Wiegand entre las opciones proporcionadas.

    • Ignorar código de instalación: Esta opción está disponible cuando se selecciona 6H3D5D (WG26). Cuando está activada, los tres primeros bits de las tarjetas serán ignorados para una lectura exitosa.

    • Usar los primeros 3 bytes: Esta opción está disponible cuando se selecciona 6HN. Cuando está activado, el dispositivo utiliza los primeros tres bytes del número de tarjeta. Si está desactivado, utiliza los últimos tres bytes. Al recibir tres bytes de datos, el dispositivo no añade ceros iniciales, independientemente del modo lector de tarjetas Wiegand que se utilice.

  • Modo lector de tarjetas Wiegand: El formato de transmisión debe ser idéntico entre el teléfono de puerta y el dispositivo de terceros. Seleccione un formato predefinido o Personalize para configurarlo manualmente.

  • Modo de transferencia Wiegand:

    • Entrada: El dispositivo actúa como receptor.

    • Salida: El dispositivo actúa como emisor y puede enviar directamente los datos, como el código de la tarjeta.

    • Convertir a tarjeta nº Salida: El dispositivo actúa como emisor y no puede enviar directamente los datos, como los datos de la cara.

Nota

Personalizar solo está disponible cuando se selecciona Salida como Modo de Transferencia Wiegand.

Formato Wiegand personalizado

Cuando se seleccione Personalizar , configura los siguientes parámetros:

  • Número total de bits: Especifica el número total de bits en los datos de Wiegand. El rango es de 1 a 128, y el valor por defecto es 26.

  • Longitud del número de tarjeta: Especifica el rango de bits utilizado para el número de tarjeta. El rango seleccionado debe estar dentro del número total de bits.

  • Usar código de sitio: Especifica si incluir un código de sitio en los datos de Wiegand. Cuando esté habilitado, especifica el rango de bits utilizado para el código de sitio.

  • Comprobación de paridad (par): Permite una comprobación uniforme de paridad para los bits seleccionados.

  • Bit de paridad para comprobación par: Especifica la posición del bit usada como bit de paridad para la comprobación de paridad (par).

  • Comprobación de paridad (Impar): Permite la comprobación de paridad impar para los bits seleccionados.

  • Bit de paridad para comprobación impar: Especifica la posición del bit utilizada como bit de paridad para la comprobación de paridad (impar).

Ejemplo de comprobación de paridad

Cuando la comprobación de paridad está activada, el dispositivo comprueba los datos de Wiegand antes de procesar el número de tarjeta. El número de tarjeta solo se procesa después de que supera la comprobación de paridad.

Por ejemplo, si los datos de Wiegand contienen 32 bits:

0011 1000 0101 1100 0010 0100 0011 1110 (385C243E)

Los datos pueden configurarse de la siguiente manera:

Ambientación

Rango de bits

Datos

Código del sitio

1–12

385

Número de tarjeta

13–32

C243E

Comprobación de paridad (par)

2–15

—

Comprobación de paridad (Impar)

16–31

—

En este ejemplo, los datos completos de Wiegand son 385C243E, mientras que los bits 13–32 contienen el número de tarjeta . Después de que los datos superan las comprobaciones de paridad configuradas, el dispositivo se procesa C243E como el número de tarjeta.

Configuración de datos de Wiegand

  • Orden de lectura de la tarjeta IC: Esta opción solo funciona cuando se selecciona Wiegand-26.

    • Normal: El dispositivo leerá los últimos tres bytes de la tarjeta CI. Por ejemplo, si el número de la tarjeta IC es 840C9F50, se leerá 0C9F50.

    • Invertido: El dispositivo leerá los primeros tres bytes de la tarjeta CI. Por ejemplo, si el número de la tarjeta IC es 840C9F50, se leerá 840C9F.

  • Wiegand Input Clear Time: Cuando el intervalo para introducir contraseñas supere el tiempo. Todas las contraseñas introducidas serán borradas.

  • Orden de datos de entrada Wiegand: Establece la secuencia de datos de entrada de Wiegand entre Normal e Invertido. Si seleccionas Invertido, entonces el número de la tarjeta de entrada se invertirá.

  • Orden básico de datos de salida Wiegand: Establece la secuencia de datos de la tarjeta antes de pasar por la conversión Wiegand y enviar el código de la tarjeta.

    Por ejemplo, si los datos de la tarjeta están 0x11 0x22 0x33 0x44 y se selecciona la opción Invertida , los datos se 0x44 0x33 0x22 0x11.

  • Orden de los datos de salida de Wiegand: Determinar la secuencia de datos de la tarjeta tras la conversión de Wiegand.

    Por ejemplo, si los datos de la tarjeta son 0x11 0x22 0x33 0x44 0x55, se 0x33 0x44 0x55 después de la conversión de Wiegand (por ejemplo, Wiegand 26). Si se selecciona Invertido , los datos de la tarjeta se 0x55 0x44 0x33.

Verificación y Configuración de Salida

  • Verificación de tarjeta RF: Disponible al Salida o Conversión a la tarjeta No. Salida seleccionada. Cuando está habilitada, el dispositivo verificará si el código de la tarjeta está asignado a un usuario. Si no lo está, aparecerá un aviso "Abriendo puerta fallida" en la pantalla del teléfono portero. Cuando está desactivado, el teléfono no realizará la verificación local.

  • Verificación de código PIN/QR: Disponible cuando se selecciona Salida como Modo de Transferencia Wiegand. Cuando está activado, el dispositivo verificará si la credencial está asignada a un usuario. Si no es así, aparecerá un mensaje "Apertura de puerta fallida" en la pantalla del teléfono portero. Cuando está desactivado, el teléfono no realizará verificación local.

  • Wiegand Output CRC: Está habilitado por defecto para la inspección de datos de Wiegand. Desactivarlo puede provocar fallos de integración con dispositivos de terceros.

  • Wiegand Open Relay: Comprueba que el relé se active a través de Wiegand.

  • Convertir a salida Wiegand: Disponible cuando se selecciona Salida como Modo de Transferencia Wiegand. Esta opción determina el formato PIN de salida.

    • Desactivado: Desactiva la función.

    • 8 bits por dígito: Cuando los usuarios pulsan "1" en el teclado, los datos binarios se transmitirán en 8 bits: "11100001".

    • 4 bits por dígito: Cuando los usuarios pulsan "1" en el teclado, los datos binarios se transmitirán en 4 bits: "0001".

    • Todo de golpe: Después de introducir el código PIN completo, los datos se transmitirán según el modo lector de tarjetas Wiegand. Por ejemplo, "123456" se convertirá en "01e240" en Wiegand 26.

Nota

Haz clic aquí para ver más información sobre la configuración de Wiegand, incluyendo:

  • Los dispositivos Akuvox funcionan como entrada/salida Wiegand;

  • Conexión al lector de tarjetas Wiegand.

Establecimiento del código de instalación

Un código de instalación es un número único en las tarjetas de control de acceso. Identifica el dispositivo que emitió la tarjeta.

Cuando el Modo de Transferencia Wiegand está en Salida, puedes configurar el código de la instalación en la interfaz Dispositivo > Wiegand .

  • Código de instalación: El valor va de 0 a 255. Si se rellena, los dos primeros dígitos del número de tarjeta serán reemplazados por el código. Si el código es menor a 2 dígitos, se añadirá automáticamente un cero al número de la tarjeta.

Propina

Dado que el Código de Instalación reemplaza los dos primeros dígitos del número original de la tarjeta, para mantener intacto el número original, puedes configurar manualmente el Modo Lector de Tarjetas Wiegand.

Por ejemplo, si el número de la tarjeta es 3 bytes (Wiegand-26), puedes seleccionar Wiegand-34 (4 bytes) para asegurarte de que el código de instalación sustituya los dos primeros dígitos por 0 en lugar del número original.

Modo Puerta Virtual Wiegand

Esta función determina qué relé abrir cuando se lee una credencial desde un dispositivo Wiegand.

Configúralo en la interfaz Device > Wiegand .

  • Activado: Está activado por defecto.

    • Cuando está activado, el teléfono de puerta da prioridad a el/los relé configurado(s) en Wiegand Open Relay.

      Cuando un usuario presenta sus credenciales a través de Wiegand, el teléfono de entrada abrirá el(los) relé(s) definido(s) en el Wiegand Open Relay.

      Si no hay relé configurado, el teléfono abrirá el(los) relé(s) asignado(s) al usuario.

    • Cuando está desactivado, un relé solo se abrirá si está permitido tanto en el Wiegand Open Relay como en los permisos del usuario en el relé.

Nota

Si se utilizan métodos de autenticación de dos pasos y uno de ellos proviene de un dispositivo Wiegand, el teléfono de entrada seguirá las reglas de apertura de relés establecidas en la configuración de Wiegand.

Integración mediante HTTP API

La API HTTP está diseñada para lograr una integración basada en red entre el dispositivo de terceros y el dispositivo Akuvos.

Configúralo en la web Configurando > interfaz HTTP API para la integración.

  • Habilitado: Habilitar o desactivar la función API HTTP para integración de terceros. Si la función está desactivada, cualquier solicitud para iniciar la integración será denegada y devolverá el estado de HTTP 403 prohibido.

  • Modo de autorización: Selecciona entre las siguientes opciones: Ninguno, Normal, Lista de Permisos, Básico y Resumido para el tipo de autorización, que se explicará en detalle en el siguiente gráfico.

  • Nombre de usuario: Introduce el nombre de usuario cuando se selecciona el modo de autorización Basic o Digest . El nombre de usuario predeterminado es admin.

  • Contraseña: Introduce la contraseña cuando se selecciona el modo de autorización Basic o Digest . La contraseña predeterminada es admin.

  • 1ª IP-5ª IP: Introduzca la dirección IP de los dispositivos de terceros cuando se seleccione la autorización de Lista de Permisos para la integración.

Por favor, consulte la siguiente descripción para el modo de autenticación:

Modo de autorización

Descripción

Ninguno

No se requiere autenticación para la API HTTP ya que solo se utiliza para pruebas de demostración.

Normal

Este modo es utilizado únicamente por desarrolladores de Akuvox.

Lista de permisos

Si se selecciona este modo, solo se requiere rellenar la dirección IP del dispositivo de terceros para la autenticación. La lista de permisos es adecuada para operar en la LAN.

Básico

Si se selecciona este modo, se requiere que rellenes el nombre de usuario y la contraseña para la autenticación. En el campo Autorización del encabezado de la solicitud HTTP, utiliza el método de codificación Base64 para codificar nombre de usuario y contraseña.

Digest

El método de cifrado de contraseñas solo soporta MD5. MD5( Algoritmo de Resumen de Mensajes) En el campo Autorización del encabezado de solicitud HTTP: WWW-Authenticate: Digest realm="HTTPAPI",qop="auth,auth-int",nonce="xx", opaque="xx".

Control de potencia

El dispositivo puede servir como fuente de alimentación para los relés externos. Haz clic aquí para ver los requisitos de potencia de salida.

Configúralo en la interfaz web de Control de Acceso > Relé >12V Power Output .

  • Salida de 12V:

    • Desactivado: Desactiva la función de salida de energía.

    • Siempre: Proporciona alimentación continua al dispositivo de terceros.

    • Activado por relé abierto: Suministrar energía al dispositivo de terceros a través de la salida de 12V y la interfaz GND durante el tiempo de espera cuando el estado de los relés cambia de bajo a alto.

      • Tiempo de espera (Seg): Selecciona la duración del tiempo de la fuente de alimentación después de que el relé se active de 3, 5 y 10. Por defecto son 3 segundos. La salida de potencia es de 12V, y el amperaje máximo de salida es de 0,8A.

    • Relé de Seguridad A: El dispositivo puede funcionar con el relé de seguridad.

Integración con un servidor de control de acceso de terceros

El dispositivo puede transmitir datos de credenciales de acceso a un servidor de terceros sin realizar una verificación local. La generación y verificación de los datos se realiza en el servidor de terceros.

Configúralo en la interfaz web de Control de Acceso > Relay > Third Party Integration.

  • Lista:

    • Ninguno: Desactiva la función.

    • General: Transmite la URL HTTP vinculada por código QR en el método de Akuvox.

      • URL HTTP: Introduzca el formato de comando HTTP proporcionado por el proveedor de servicios externo. Tras escanear el código QR, el comando HTTP transportará automáticamente la información dinámica del código QR antes de enviarla al servidor de códigos QR para su verificación. Consulte el ejemplo: http://{IP del servidor}:8090/api/visitor/scan?codeKey={QRCode}&deviceId={DeviceID}.

      • ID de dispositivo: El ID del dispositivo lo proporciona el servidor de terceros. Se añadirá automáticamente al comando HTTP al usar un código QR para acceder a la puerta.

      • Parámetro de éxito: Recibir este valor indica que abrir la puerta tiene éxito.

      • Parámetro fallido: Recibir este valor indica que abrir la puerta falla.

    • Personalizar: Transmite los datos de las credenciales de acceso de forma personalizada.

      • Prompt en la pantalla LCD: Seleccione Predeterminado para adoptar el prompt de apertura de puerta del teléfono Akuvox; Seleccione Return Value para usar el return value del servidor de terceros como prompt.

      • Verificación remota: Especifique qué credenciales de acceso serán verificadas por el servidor de terceros. Cuando se selecciona la Cara , el dispositivo realiza primero el reconocimiento facial local. Si no se detecta ninguna cara coincidente, la autenticación falla. Si se encuentra una coincidencia, el ID de usuario o PIN asociado se envía al servidor de terceros para una verificación adicional.

        Las opciones disponibles dependen del modo de autenticación de acceso:

        Modo de autenticación

        Opciones disponibles

        Cualquier método

        Código QR, tarjeta, NIP, rostro

        Autenticación multifactor

        Código QR, Multifactor

        Cuando se selecciona el tema de Autenticación Multifactor , las opciones de Verificación Remota se comportan de la siguiente manera:

        Opción

        Descripción

        Código QR

        El dispositivo escanea el código QR y lo envía directamente al servidor de terceros.

        Multifactor

        El dispositivo primero comprueba si el método de autenticación coincide con el método configurado.

        Si no se empareja → usuario debe usar el método correcto.

        Si coinciden → Las credenciales recopiladas se envían al servidor para su verificación.

      • URL HTTP: Introduce el comando HTTP en el formato proporcionado por el proveedor de servicios externo. Tras escanear códigos QR, deslizar tarjetas, introducir PIN o reconocer facialmente, el comando HTTP transportará automáticamente la información dinámica antes de enviarla al servidor para su verificación.

        Formato de ejemplo:

        http://{Server IP}:8090/api/visitor/scan?codeKey={QRCode}/{Card}/{Pin}/{UserID}&deviceId={DeviceID}.

        Por ejemplo, si un usuario desliza la tarjeta RF, la URL será http://192.168.35.123:8090/api/visitor/scan?codeKey={QRCode}/45678999/{Pin}/{UserID}&deviceId=1.

        En el tema de Autenticación Multifactor , los marcadores de posición disponibles dependen del Modo de Autenticación seleccionado.

        Variable

        Descripción

        {Token}

        Credenciales recogidas en el paso actual de autenticación.

        {Tipo}

        Tipo de autenticación de dos pasos:

        1 = Tarjeta + PIN

        3 = Figura + Carta

        4 = Cara + PIN

      • ID de dispositivo: El ID del dispositivo lo proporciona el servidor de terceros. Se añadirá automáticamente al comando HTTP al usar las credenciales de acceso para la puerta.

      • Parámetro de éxito: Recibir este valor indica que abrir la puerta tiene éxito.

      • Parámetro fallido: Recibir este valor indica que abrir la puerta falla.

Nota

Haz clic aquí para ver los pasos detallados de integración.

Integración mediante RS485

Puedes conectar el dispositivo a un dispositivo externo como SR01 o a un lector de tarjetas basado en OSDP mediante RS485. Para que la conexión sea efectiva, necesitas seleccionar el modo RS485 adecuado.

Haz clic aquí para ver la configuración detallada de la función OSDP.

Configúralo en la interfaz Device > RS485 .

  • Desactivación: La función RS485 está desactivada.

  • Relé de seguridad: La opción predeterminada. Seleccionarlo cuando el dispositivo funcione con el relé de seguridad (SR01).

  • OSDP: El dispositivo está conectado a un dispositivo externo basado en OSDP, como un lector de tarjetas.

  • Modo de transferencia: Selecciona el modo de trabajo RS485, Salida o Entrada.

    Cuando se seleccione Salida , configura las siguientes opciones:

    • Verificación local de relés: Establece si realizar la verificación de credenciales de acceso. Cuando no se activa, no se darán avisos de fallo al abrir la puerta.

    • Cifrado: Comprueba esta opción cuando el protocolo esté cifrado.

    • Clave de cifrado: Cuando se llena, OSDP usará este valor para cifrado, empleando un protocolo personalizado para la comunicación; Cuando queda vacío, OSDP usará el protocolo cifrado predeterminado para la comunicación. Debe tener 32 bits de longitud y puede incluir números (0-9) y letras (a-f, A-F).

    Cuando se seleccione Entrada , configura las siguientes opciones:

    • Escanear lectores: Haz clic en Escanear para detectar el lector de tarjetas conectado.

    • Cifrado: Comprueba esta opción cuando el protocolo OSDP esté cifrado.

    • Clave de cifrado: Rellena la clave cuando se marque el cifrado . Si el dispositivo de salida es un lector de tarjetas de terceros, por favor confirma la clave con el proveedor del servicio.

    • Modificar clave: Haz clic para modificar la clave de cifrado, que debe tener 32 bits de longitud y puede incluir números (0-9) y letras (a-f, A-F).

    • Estado de la conexión: Muestra si el lector está conectado correctamente.

    • Relé Abierto OSDP: Comprueba la puerta que debe abrirse.

    • Detalles: Haz clic para ver la información del lector de tarjetas.

Modo de puerta virtual RS485

Esta función determina qué relé abrir cuando se lee una credencial desde un dispositivo OSDP(RS485).

  • Activado: Está activado por defecto.

    • Cuando está activado, el teléfono de puerta da prioridad a el(los) relé(s) configurado(s) en OSDP Open Relay.

      Cuando un usuario presenta sus credenciales, el teléfono de puerta abrirá el(los) relé(s) definido(s) en el Relé Abierto OSDP.

      Si no hay relé configurado, el teléfono abrirá el(los) relé(s) asignado(s) al usuario.

    • Cuando está desactivado, un relé solo se abrirá si está permitido tanto en el Relé Abierto OSDP como en los permisos del relé del usuario.

Integración con Control4

El dispositivo soporta integración con Control4, que permite a los usuarios llamar, monitorizar y abrir puertas en el panel de Control4.

Haz clic aquí para conocer la configuración detallada y otros modelos que soportan la integración.

Para habilitar la integración, activa el interruptor en la interfaz Dispositivo > Control4 .