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: es el parámetro que utiliza Netin para identificar a un dispositivo dentro de la localización donde se encuentra. Se configura utilizando variables de sustitución.

En la mayoría de los casos se quiere tener como origen la IP, pero se pueden utilizar otros parámetros que se descubren y que son únicos para cada dispositivo:

  • DCP_MACAddress: "28:63:36:0e:8a:1a"
  • DCP_NameOfStation: "io-device4mesa
  • DCP_IPAddress: "10.10.50.205"
  • ICMP_IPAddress : "10.10.50.205

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

3. originType: identificación del tipo de driver que va a utilizar ese dispositivo para comunicar.

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

Info

Varios dispositivos pueden tener el mismo origin, por ejemplo, misma IP, siempre que se encuentren en localizaciones diferentes.


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.