Saltar a contenido

Origin type declaration

En esta sección se declaran las configuraciones de los drivers de comunicación que vamos a utilizar en los dispositivos a los que se aplica la plantilla.

Parámetros generales

Se especifica el origen (origin) seguido de las propiedades específicas de cada driver contenidas en un array (originTypes):

1. origin: identificación del sistema, subsistema, dispositivo, etc. monitorizado que es la fuente de datos del datapoint, mediante variables de sustitución que garantizan que la plantilla se instancie correctamente

2. originTypes: array que contiene las propiedades específicas de cada driver.

3. originType: identificación del tipo de origen (driver, importer o system), con el patrón "sistema-subsistema-tipo de origen-nombre".

netin-spider-templates-origin-type-declaration-01.png


Drivers

ICMP

Parámetros

  • originTypes:
  • originType: netin-ds-drv-icmp
  • address: dirección IP del dispositivo que se va a leer. Se suelen usar variables de sustitución.
  • count: cantidad de mensajes ICMP que se enviarán al destino en cada polling. Se recomienda mínimo 3.
  • timeout: tiempo máximo de espera de una respuesta (en milisegundos).

Ejemplo

###########################################################################################################
# Origin type declaration:
###########################################################################################################
origin: "/{ICMP_IPAddress}/"
originTypes:
- originType: netin-ds-drv-icmp
  address: "/{ICMP_IPAddress}/"
  count: 4
  timeout: 1000


SNMP

Parámetros

  • originTypes:
  • originType: netin-ds-drv-snmp
  • basicConfig: configuración básica del driver.
    • retries: número de intentos de conexión.
    • address: dirección IP del dispositivo que se va a leer. Se suelen usar variables de sustitución.
    • port: número de puerto de destino del dispositivo. El agente SNMP recibe solicitudes en el puerto UDP 161.
    • version: versión del protocolo SNMP.
    • timeout: Tiempo máximo de espera de una respuesta (en milisegundos).
  • snmpCommunities: las comunidades de SNMP gestionan los derechos de acceso. Son un tipo de contraseña compartida entre la estación de gestión SNMP y el dispositivo, y se usan para autenticar la estación. Los valores estándar son "public" y "private".
    • readCommunity: public (asignado por defecto).
    • writeCommunity: private (asignado por defecto).
  • snmpV3Security: opciones de seguridad para el protocolo SNMP V3.
    • authAlgorithm: algoritmo de autenticación. Puede ser:
      • HMAC128SHA224
      • HMAC192SHA256
      • HMAC256SHA384
      • HMAC384SHA512
      • MD5
      • SHA
    • privacyAlgorithm: algoritmo de privacidad. Puede ser:
      • 3DES
      • AES128
      • AES192
      • AES256
    • usmUser: nombre de usuario USM.. Si no se quiere configurar seguridad se debe poner ' '.
    • authPassword: contraseña de autenticación. Si no se quiere configurar seguridad se debe poner ' '.
    • privacyPassword: contraseña de privacidad. Si no se quiere configurar seguridad se debe poner ' '.

Ejemplo

###########################################################################################################
# Origin type declaration:
###########################################################################################################
origin: "/{ICMP_IPAddress}/"
originTypes:
- originType: netin-ds-drv-snmp
  basicConfig:
    retries: 2
    address: "/{ICMP_IPAddress}/"
    port: 161
    version: 2
    timeout: 5000
  snmpCommunities:
    readCommunity: public
    writeCommunity: private
  snmpV3Security:
    authAlgorithm: MD5
    privacyCommunity: private
    usmUser: ''
    authPassword: ''
    privacyPassword: ''


PNIO

Parámetros

  • originTypes:
  • originType: netin-ds-drv-pnio
  • ipAddress: dirección IP del dispositivo que se va a leer. Se suelen usar variables de sustitución.
  • gsd: Nombre del archivo GSD compilado que se usará para la traducción de textos.

Ejemplo

###########################################################################################################
# Origin type declaration:
###########################################################################################################
origin: "/{ICMP_IPAddress}/"
originTypes:
- originType: netin-ds-drv-pnio
  ipAddress: "/{ICMP_IPAddress}/"
  gsd: GSDML-V2.33-Siemens-002A-SCALANCE_X200-20171009


S7

Parámetros

  • originTypes:
  • originType: netin-ds-drv-s7
  • s7basicConfig: configuración básica del driver:
    • address: dirección IP del dispositivo que se va a leer. Se suelen usar variables de sustitución.
    • rack: número que indica la posición del rack.
    • slot: número que indica la posición del slot.
    • deviceType: tipo de dispositivo dentro de la gama SIMATIC S7 CPU. Puede ser:
      • S7-200
      • S7-300
      • S7-400
      • S7-1200
      • S7-1500
      • LOGO!
  • s7extraConfig: configuración avanzada del driver:
    • requestTimeout: tiempo máximo de espera de una respuesta (en milisegundos).
    • connectionTimeout: tiempo máximo de conexión (en milisegundos).
    • port: número de puerto TCP/IP de destino (por defecto el 102).
  • s7security: configuración para la contraseña del driver:
    • password: contraseña de acceso. Si no se quiere configurar seguridad se debe poner ' '.
    • accessProtection: establece si se aplica un algoritmo de autenticación (true) o no (false, valor por defecto).
  • s7diagnosticBuffer: configuración del búfer de diagnóstico:
    • loggingEnabled: indica si la opción de login está habilitada (true) o no (false, valor por defecto).

Ejemplo

###########################################################################################################
# Origin type declaration:
###########################################################################################################
origin: "/{ICMP_IPAddress}/"
originTypes:
- originType: netin-ds-drv-s7
  s7basicConfig:
    address: "/{ICMP_IPAddress}/"
    rack: 0
    slot: 2
    deviceType: S7-300
  s7extraConfig:
    requestTimeout: 15000
    connectionTimeout: 3000
    port: 102
  s7security:
    password: ''
    accessProtection: false
  s7diagnosticBuffer:
    logginEnabled: false


MODBUS

Parámetros

  • originTypes:
  • originType: netin-ds-drv-modbus-tcp
  • address: dirección IP del dispositivo que se va a leer. Se suelen usar variables de sustitución.
  • slaveId: ID del esclavo (por defecto 1)
  • port: puerto de comunicación (por defecto el 502)
  • orderByteNums: orden en el que se leen los bytes (datos numéricos):
    • AB_CD
    • CD_AB
    • BA_DC
    • DC_BA
  • orderByteStrings: orden en el que se leen los bytes (cadena de caracteres):
    • AB_CD
    • CD_AB
    • BA_DC
    • DC_BA
  • registerMode: indica si los registros del dispositivo son de 16 bits o 32 bits.

Ejemplo

###########################################################################################################
# Origin type declaration:
###########################################################################################################
origin: "/{ICMP_IPAddress}/"
originTypes:
- originType: netin-ds-drv-modbus-tcp
  address: "/{ICMP_IPAddress}/"
  slaveId: 1
  port: 502
  orderByteNums: CD_AB
  orderByteStrings: BA_DC
  registerMode:16




Info

Pasos siguientes:
Configuración de la especificación de la sección DatapointSets declaration.