autómata programable chintcontrol ctrl1€¦ · 2.6. puerto de comunicaciones ethernet ctrl1 está...

Autómata programable ChintControl

CTRL1

MANUAL DE INSTRUCCIONES

1. Introducción2. Características técnicas2.1. Tabla de características2.2. Entradas digitales2.3. Salidas digitales2.4. Entradas analógicas2.5. Salidas analógicas2.6. Puerto de comunicaciones Ethernet2.7. Puerto de comunicaciones RS4852.8. Reset del CTRL1

3. Dimensiones y panel frontal

4. Instalación y cableado4.1. Entradas digitales4.2. Salidas digitales4.3. Entradas analógicas4.4. Salidas analógicas4.5. Ejemplo de cableado

5. Acceso al CTRL15.1. Estado de los Leds5.1.1. Estado del Led general5.1.2. Estado del Led puertos de comunicaciones5.2. Solución de problemas5.2.1. No se puede acceder desde la red5.2.2. Configuración errónea

6. Programación/Configuración del CTRL16.1. Pantalla inicial6.2. Opciones del Configurator 6.3. Configuración de puertos 6.3.1. Puertos de salida digitales 6.3.2. Puertos de entradas digitales 6.3.3. Puertos de salida analógicos 6.3.4. Puertos de entrada analógicos 6.3.5. Puertos virtuales

7. Programación/Configuración mediante comandos7.1. Comunicación con CTRL17.1.1. API de Control HTTP7.2. Comandos generales7.3. Comandos configuración de puertos7.4. Comandos especiales entradas analógicas7.5. Comandos especiales puertos virtuales7.6. Comandos para crear links-enlaces7.7. Comandos para configuración de red7.8. Comandos para funciones de fecha y hora7.9. Comandos para funciones de seguridad (SEC)7.10. Códigos de error

8. Modo simulación8.1. Activar el modo de simulación

1

CTRL1 Autómata programable con servidor web embebido

1. IntroducciónChintControl (a partir de ahora CTRL1) es un controlador eléctrico IP para uso doméstico o industrial, capaz de interactuar con sensores y actuadores tanto digitales como analógicos. El equipo dispone de un servidor web para su control y configuración además de poder ser configurado y controlado a distancia. El CTRL1 se programa mediante un configurador integrado al que se accede vía web. Además, se pueden utilizar plantillas y éstas se pueden guardar de forma segura. También se dispone de un SDK para integradores.

2


CTRL1

Parámetro Mínimo Estandar MáximoTensión de alimentación 8 Vcc 12 o 24 Vcc 28 Vcc

Corriente de alimentación (12Vcc) 120 mA Corriente de alimentación (24Vcc) 65 mA

Tensión admisible de puerto digital de entrada 0 Vcc 28 Vcc

Tensión admisible de puerto digital de salida 0 Vcc Tensión de alimentación del

equipo

Valor “1” en puerto digital de entrada 5 Vcc 28 Vcc

Valor “0” en puerto digital de salida 0 Vcc 2 Vcc

Corriente en puerto digital de salida 0 mA 100 mA

Voltaje admisible de los puertos AI1 y AI2 en modo voltaje

0 Vcc 0-10Vcc 30 Vcc (1)

Impedancia de entrada de los puertos analógicos AI1 y AI2 en modo voltaje

39,2 kΩ

Corriente admisible de los puertos analógicos AI1 y AI2 en modo corriente

0 mA 0-20 mA o

4-20 mA

25 mA (2)

Resistencia interna de los puertos analógicos AI1 y AI2 en modo corriente

82 Ω

Tensión de salida de los puertos analógicos AO1 y AO2 en modo voltaje

0 Vcc 10 Vcc

Corriente de salida de los puertos analógicos AO1 y AO2 en modo voltaje

0 mA 10 mA

Corriente de salida de los puertos analógicos AO1 y AO2 en modo corriente

0 mA 20 mA

Velocidad de transmisión del puerto RS485 1200

baudios

115200 baudios

Longitud del bus RS485 1200 m (3)

Número de dispositivos en el bus RS485 256 (4)

Velocidad de transmisión del puerto Ethernet 10 Mbps

Longitud del cable Ethernet 100 m. (5)

Parámetro Mínimo Estandar MáximoAutonomía del reloj en tiempo real sin alimentación

60 horas (6)

Temperatura operativa -10 ºC 60 ºC

Temperatura de almacenamiento -10 ºC 70 ºC

Par de apriete del borne de entrada de alimentación

0,5 Nm

Par de apriete del resto de bornes 0,3 Nm

Sección de los conductores del borne de entrada de alimentación

0,5 mm

(AWG20)

2,5 mm fino (AWG14)

2 o 4 mm sólido (AWG12)

Sección de los conductores del resto de bornes 0,75 mm

(AWG19)

(1) A partir de 10 V la entrada de voltaje está saturada y el equipo no indicará un voltaje superior. (2) A partir de 20 mA la entrada de corriente está saturada y el equipo no indicará una corriente superior. (3) Valor teórico asumiendo un cable de sección AWG24 y una velocidad máxima de 100 kbps, la resistencia del cable se acerca al valor de la resistencia del final de bus reduciendo la señal unos 6 dB. (4) Valor teórico del número máximo de dispositivos conectados al mismo bus. El estándar TIA/EIA especifica un máximo de 32 dispositivos en un mismo bus limitados por la carga de cada dispositivo en el bus. El CTRL1 tiene una carga de 1/8 de dispositivo. (5) Utilizando cable UTP, valor especificado en el estándar IEEE 802.3-2008.

2. Características técnicas2.1. Tabla de características

El equipo incorpora ocho entradas digitales, pudiendo conectar pulsadores, interruptores o cualquier dispositivo como un sensor o alarma con un contacto libre de tensión (contacto seco) o cualquier fuente de voltaje compatible con los valores mostrados en latabla de características del producto.

Todas las entradas tienen una configuración interna “pull-down”, esto provoca que todas las entradas sin conectar tendrán un valor de cero. (Ver la figura) Para ver el rango de trabajo de las entradas digitales, se pueden observar 3 zonas de trabajo: valor alto (1), valor bajo (0) y valor no definido. Para el correcto funcionamiento del equipo se debe trabajar siempre en las zonas de trabajo seguro que son el valor alto (1) y el valor bajo (0). En el caso en entrar en la zona no definida, el valor medido no está garantizado pudiendo medir cualquier de los dos niveles lógicos.

Ejemplos de dispositivos compatibles: - Interruptores, pulsadores y finales de carrera. - Sensores, boyas, contactos en general.

El equipo incorpora ocho salidas digitales que son de tipo colector abierto, se puede conectar una carga para corriente continua respetando la polaridad y una corriente máxima de 100 mA para cada salida. Cada salida tiene un diodo interno montado en anti-paralelo para simplificar el montaje de relés y otros tipos de cargas inductivas en las salidas. (Ver punto 4.2).

Ejemplos de dispositivos compatibles:

- Relés y relés de estado sólido. - Pilotos luminosos, sirenas y otros dispositivos de indicación.

El CTRL1 incorpora dos entradas analógicas con dos modos de operación: voltaje y corriente.

En el modo de operación de voltaje, las entradas se pueden configurar para un modo estándar de 0-10 V o de 1-10 V. Se pueden utilizar las entradas analógicas en modo voltaje como voltímetro para medir cualquier voltaje dentro de los márgenes desde 0 hasta 10 V.

En el modo de operación de corriente, las entradas se pueden configurar para una entrada estándar de 0-20 mA o de 4-20 mA. El equipo admite bucles de corriente de 2, 3 y 4 hilos.

Ejemplos de dispositivos compatibles:

2.2. Entradas digitales

3


CTRL1

2.3. Salidas digitales

2.4. Entradas analógicas

- Sensores ambientales (temperatura, humedad, intensidad luminosa, etc). - Sensores de magnitudes eléctricas (voltaje, corriente, potencia, etc). - Sensores de distancias, volumen, peso, presión, etc.

El CTRL1 está provisto 2 salidas analógicas con dos modos de operación: voltaje y corriente. En el modo de operación de voltaje, las salidas se pueden configurar para un modo estándar de 0-10 V ó de 1-10 V.

En el modo de operación de corriente, las salidas se pueden configurar para un modo estándar de 0-20 mA y 4-20 mA.

Algunos ejemplos de dispositivos compatibles son:

- Regulación de luminosidad LED, fluorescente, incandescente, ... - Control de electroválvulas. - Control de dosificadores de producto. - Actuadores lineales o servos. - Etc.

2.5. Salidas analógicas

2.6. Puerto de comunicaciones Ethernet

CTRL1 está provisto de un puerto de comunicaciones estándar Ethernet 10BASE-T para conexiones TCP/IP. Se deberá utilizar cable de 4 pares trenzados de Categoría 3 o superior, pero se recomienda utilizar cables UTP Categoría 5. En ambientes industriales o muy ruidosos se deberá utilizar cableado apantallado.

El equipo, al igual que otros equipos con interfaces de red Ethernet necesita un cableado específico para la conexión de la red. Si conecta el CTRL1 directamente a un ordenador o cualquier host sin pasar por un router o switch, deberá utilizar un cable “cruzado” (un extremo con terminación T568A y el otro extremo T568B). Si conecta el CTRL1 directamente a un switch o router, deberá utilizar un cable “directo” (los dos extremos con terminación T568B).

El puerto Ethernet tiene 2 LEDs indicadores de estado, El LED de enlace Ethernet se encenderá cuando de conecte un cable Ethernet entre el CTRL1 y un host o switch de red y se crea un enlace correcto. Si se conecta el cable de red y no se enciende el LED de enlace significará que hay un fallo en la conexión que puede ser por que el cable está cortado o por no elegir el tipo de cable correcto. El LED de actividad Ethernet se enciende y se apaga por cada paquete de red enviado o recibido.

2.7. Puerto de comunicaciones RS485

El CTRL1 tiene un puerto de comunicaciones RS485 que le permitirá realizar comunicaciones a larga distancia con dispositivos compatibles mediante cable trenzado. El puerto RS485 tiene un LED de estado de color amarillo, este, LED por defecto siempre está apagado y parpadeará cuando haya tráfico de datos por el puerto.

El puerto RS485 tiene un puente de terminación de bus. Al conectar el puente se habilita una resistencia de final de bus de 120 ohmios conectada entre los bornes A y B del bus. Por defecto el producto trae habilitado el final de bus, para desactivarla es tan fácil como desconectar el puente que está introducido a presión.

Es importante mantener la impedancia del bus colocando correctamente sus resistencias terminales de 120Ω en los extremos del bus, en caso contrario se producirán reflexiones que distorsionarán la señal del bus, dependiendo del grado de distorsión no se podrán realizar con éxito comunicaciones por el bus. No podrán haber más de 2 terminaciones en un bus.

4


CTRL1

5


CTRL1

2.8. Reset del CTRL1

El CTRL1 tiene un pulsador de reset de seguridad, está escondido bajo un agujero de la tapa. Para reiniciar el dispositivo deberá introducir por el agujero un destornillador, palillo, bolígrafo o cualquier objeto con un diámetro inferior al del agujero que es de 2mm.

Puede reiniciar el dispositivo con una breve pulsación o bien puede restablecer la configuración inicial del equipo a los valores de fábrica realizando una pulsación larga de más de 5 segundos.

¡ATENCIÓN! Una pulsación larga del botón de reset borrará toda la configuración del dispositivo dejándola igual que los valores de salida de fábrica borrando todas las configuraciones, programaciones y plantillas guardadas.

3. Dimensiones y panel frontal

DIMENSIONES: 78X93X56mm

TAMAÑO EN CARRIL DIN: (4 módulos, 71mm)

Voltaje positivo (+)

Masa (negativo) (-) Salidas digitales

Entradas analógicas

Salidas analógicas

LED de estado

Pulsador de rese t

Puente de terminación Modbus (120Ω)

Puerto RS485 Entradas

digitales

Ethernet

6


CTRL1

4. Instalación y cableado4.1. Entradas digitales

Para el cableado de una entrada digital, por ejemplo, un pulsador, llevaríamos el positivo de la fuente de alimentación que usemos para alimentar el equipo (CTRL1) al pulsador, desde la otra borna del pulsador acometeríamos directamente a una entrada digital del equipo. (Ver punto 4.5)

4.2. Salidas digitales

Para el cableado de una salida digital, por ejemplo, un piloto, llevaríamos el positivo de la fuente de alimentación que usemos para alimentar el equipo (CTRL1) a un borne del piloto. Desde la salida digital del equipo acometeríamos al otro extremo del piloto, es decir, desde el CTRL1 sacamos el negativo de la salida digital. (Ver punto 4.5)

En la siguiente figura podemos observar el conexionado interno del CTRL1 y como alimentaríamos una salida digital.

4.3. Entradas analógicas

Para el cableado de las entradas analógicas se debe diferenciar entre dos modos de operación: voltaje y corriente. Para el modo de operación en modo voltaje, se conectará el sensor en paralelo con la entrada analógica, como en el siguiente esquema.

Para el modo de operación en modo corriente, se conectará el sensor en serie con la entrada analógica, como se puede apreciar en el siguiente esquema. Como se puede apreciar, debemos tener en cuenta si el sensor a conectar tiene fuente de alimentación interna o es necesario alimentarlo con una fuente externa.

4.3. Salidas analógicas

Para el cableado de las salidas analógicas también es necesario diferenciar entre dos modos de operación: voltaje y corriente. En el siguiente esquema se observa las diferencias entre los dos modos de operación.

7


CTRL1

4.5. Ejemplo de cableado

En el siguiente esquema se puede observar un ejemplo de conexión tipo con una fuente de alimentación de 24 Vcc y cableado de diferentes entradas y salidas digitales y una salida analógica en modo tensión.

5. Acceso al CTRL1

En la primera conexión al CTRL1, lo más aconsejable es conectar el equipo directamente a un PC mediante un cable cruzado. (En algunos casos, se puede conectar mediante un cable de red de 4 pares normal, debido a que algunas tarjetas ethernet hacen el cambio automático internamente).

Una vez conectado el equipo, para acceder por primera vez a CTRL1 se debe usar la IP por defecto, que es la 169.254.0.1. Es decir, después de alimentar el dispositivo y conectarlo al ordenador, basta con acceder con un navegador con la siguiente URL:

http://169.254.0.1

(*) Nota: En caso de no acceder correctamente, borrar historial y cookies del navegador y volver a intentar la conexión. Puede haber incompatibilidad con las cookies guardadas en el navegador. Otra opción es abrir una ventana nueva en el navegador como “ventana de incognito”

Cuando se accede a través de la IP de fábrica, CTRL1 le pedirá un usuario y una contraseña. Sus valores por defecto son:

Usuario: userContraseña: control

A continuación, accederemos al módulo de configuración avanzada del Configurador, botón "Configurator" y nos volverá a solicitar un usuario y su respectiva contraseña. En este caso el usuario/contraseña por defecto será:

Usuario: adminContraseña: control

Una vez dentro del configurador, mediante la opción “Network configuration” (Ver punto 6.2 para más detalles), se deberá configurar adecuadamente el equipo, asignando los puertos de acceso a nuestro router y la nueva IP para un futuro acceso al equipo.

8


CTRL1

A continuación, mediante la opción “Security” cambiaremos las contraseñas del equipo. Una vez guardadas estas configuraciones, accederemos al equipo a través de la nueva IP y las contraseñas configuradas por el usuario.

La herramienta de configuración, además de permitir una configuración gráfica, también nos permite ejecutar comandos directamente (Ver punto 7).

5.1. Estado de los LEDS

En este punto se explica el comportamiento de los LEDs de estado del CTRL1.

5.1. Estado del LED general

La luz de encendido de la cubierta frontal proporciona información sobre el estado del producto, tanto mediante la secuencia de parpadeos como el color. Al conectar la alimentación o reiniciar el dispositivo, esta luz pasará de un color rojo hasta un verde intermitente que indicará actividad. Si pasados unos segundos la luz no se mantiene en verde intermitente, nos estará indicando algún tipo de problema:

Señal Diagnóstico

Apagada (no se ha encendido)

Revise la fuente de alimentación y las conexiones.

Roja intermitente Revise la conexión de red. Verifique que el cable Ethernet está bien conectado en ambos extremos. Pruebe el cable con otro dispositivo y verifique la comunicación.

Roja fija La configuración ha sido dañada y los valores de fábrica restaurados. Pulse durante 1 segundo el botón de reset para reiniciar el dispositivo.

Verde fija Problema en la configuración. Pulse durante 5 segundos el botón de reset para restaurar los valores de fábrica y reiniciar el dispositivo.

Apagada (después de encenderse)

Problema en la configuración o en el hardware. Pulse durante 5 segundos el botón de reset para restaurar los valores de fábrica y reiniciar el dispositivo.

Verde intermitente El dispositivo funciona correctamente.

Puerto Ethernet: Señal Diagnóstico

LED ETH Link, verde

Indica el estado de la conexión del cable de red RJ45. Si está apagado revise la conexión eléctrica del cable y/o si el cable es el correcto. Recuerde que existen terminaciones T568A y T568B y debe elegir la terminación correcta, siendo la conexión más habitual la de T568B-T568B (cable directo pin a pin).

LED ETH Activity, amarillo

Indica el tráfico del puerto Ethernet.

Puerto de terminación de bus (RS485): Señal Diagnóstico

Amarilla Indica el tráfico del puerto RS485.

5.1. Estado de los LEDS

9


CTRL1

5.2. Solución de problemasUna vez el equipo ha sido correctamente conectado a la fuente de alimentación y a la red, ya debería ser accesible desde cualquier ordenador o dispositivo conectado a la red. El LED principal (junto al logotipo) debería estar parpadeando en verde.

5.2.1. No se puede acceder desde la redSi su configuración de red no se ha modificado, la IP será la 169.254.0.1, tal como se indica en los puntos anteriores. Una vez conectado a la misma red que el CTRL1, puede verificar que tiene acceso a él en el programa “cmd” (En Windows) mediante el siguiente comando:

ping 169.254.0.1

(*) Nota: También se puede verificar en Linux y MAC en sus respectivos programas.

Si el resultado de este comando nos indica que no es posible acceder a la IP indicada, verifique la conexión de red del CTRL1 (el LED verde situado junto al conector debería estar encendido) y de su ordenador. Si el LED verde no se enciende, esto es síntoma de un fallo en el cableado o conectores. Si el LED verde está encendido y no puede acceder al equipo, restaure la configuración por defecto del equipo manteniendo pulsado el botón de “reset” durante más de 5 segundos; acto seguido el LED debería mantenerse en rojo, y pasados unos segundos volverá a estar parpadeando en verde.

Si después de restaurar la configuración sigue sin estar accesible, intentaremos comunicar de forma directa el CTRL1 con su ordenador. Para ello deberá emplear un cable de red cruzado para conexión directa PC-PC. Hecho esto, verifique que el LED verde junto al conector de red se enciende, y repita el comando anterior. Si en este caso el resultado del comando es satisfactorio, posiblemente se deba a que los elementos de red (enrutador o conmutador) están filtrando las conexiones a IPs de autoconfiguración. En caso contrario, póngase en contacto con nuestro servicio técnico Chint Electrics en España.

También es recomendable eliminar las “cookies” y el “historial” del navegador que vayamos a utilizar para acceder al CTRL1, ya que puede crear problemas con historiales o cookies guardadas en dicho navegador.

5.2.2. Configuración erróneaSi el comportamiento de su CTRL1 es errático, o está actuando de forma extraña, puede restaurar la configuración por defecto pulsando el botón de reset durante más de 5 segundos. Hecho esto podrá volver a aplicar la configuración deseada.

6. Programación/Configuración del CTRL1En este punto se explicará detalladamente como realizar una configuración del CTRL1.

6.1. Pantalla inicialLa pantalla de configuración del CTRL1 ha sido desarrollado como una aplicación on-line interactiva, fácil de usar y de acceder tanto desde PC, smartphone o tableta digital. Esto le proporciona una gran flexibilidad y facilidad de uso, aunque para su correcto funcionamiento es necesario disponer de una conexión a Internet. Al acceder, se muestra la pantalla inicial de la aplicación web, cuyo contenido por defecto nos especificará las opciones que tenemos para trabajar con el equipo.

Las OPCIONES que vemos en la pantalla inicial son:

· Home: Nos mostrará los puertos digitales yanalógicos de entrada y salida configurados para que sean visualizados.

· Settings: Nos mostrará los puertos asignados aesta sección, por ejemplo, puertos virtuales (temporizadores, condiciones, etc).

· Configurator: Aplicativo que permite realizar lasconfiguraciones en el dispositivo.

10


CTRL1

6.2. Opciones de "Configurator"

En el menú de “Configurator” del equipo CTRL1 veremos las siguientes opciones de configuración:

· LOAD CONFIGURATION: mediante esta función podremos cargar una plantilla sinnecesidad de cambiar de interfaz, para realizar dicha carga habrá que seguir los siguientes pasos:

Paso 1: Para Cargar una plantilla, vamos al configurador, sección "Configurator" y accedemos a la opción “Load Configuration”.

(*) Nota: las plantillas se cargan y exportan en archivos de texto.

Paso 2: Para poder cargar la plantilla, tendremos que copiar el texto de la misma y pegarlo en el recuadro Configuration: <copy commands here>.

Paso 3: Entonces presionaremos el botón “Load configuration”.

Paso 4: Automáticamente aparecerá una pantalla de carga que nos informará siel proceso de carga de las comandas es satisfactorio o existe algún problema indicando en la misma el código de error pertinente.

(**) Nota: es necesario que el dispositivo esté libre de configuraciones antes de realizar este proceso, podremos hacerlo con la opción "Clear configuration" en elmenú "Configurator".

· EXPORT CONFIGURATION: mediante esta función podremos guardar nuestraplantilla en un archivo .txt. Para exportar una plantilla se seguirán los siguientes pasos:

Paso 1: Localizamos en la sección "Configurator" la opción llamada "Export configuration". Esta opción nos permite exportar si lo deseamos, nuestra plantilla en comandos de texto.

Paso 2: Para exportar la plantilla tendremos que copiar el texto del cuadro y guardarlo o pegarlo en un fichero de texto y guardar dicho archivo.

Paso 3: Finalmente saldremos del menú presionando “exit”

· CONFIGURE PORTS: este menú nos permite configurar uno a uno los puertosdisponibles en CTRL1, como veremos a en el punto 6.3.

· CONFIGURE LINKS: este menú nos permitirá ver los enlaces creados, añadir nuevosy eliminar los existentes, como veremos punto 6.4.

· NETWORK CONFIGURATION: en este menú podremos configurar los puertos deacceso y de control de nuestro dispositivo mediante web. A parte de especificar qué puerto usaremos para poder cifrar todo nuestro tráfico de CTRL1. Además, en la misma sección podremos modificar los parámetros de red de nuestro equipo por los deseados.

(*) Nota: En caso de conectar nuestro CTRL1 a un router, el equipo necesita dos puertos de entrada, estos puertos los elegiremos en este campo (Ver imagen inferior). Además, en el router, es necesario abrir los dos puertos configurados (en este caso el 80 y 81) para poder acceder a él desde el exterior.

11


CTRL1

· CHANGE DEVICE NAME: mediante esta opción podemos cambiar el nombre a nuestro dispositivo por uno más intuitivo orelacionado con la empresa. Solamente se permiten letras y números, con una longitud total de 5 caracteres.

· TIME SETTING: esta opción permite configurar el dispositivo con una fecha y hora o sincronizar este parámetro mediante NTP siconectamos el equipo a un router con conexión a internet.

· SECURITY: este menú nos dará la posibilidad de cambiar o introducir contraseñas para nuestro Administrador, Usuario o Protocolo deCifrado.

· CLEAR CONFIGURATION: esta función restablecerá los valores de fábrica al CTRL1. Tiene el mismo efecto que pulsar el botón de resetdurante más de 5 segundos.

· CONSOLE: está sección nos permitirá configurar o programar nuestro dispositivo por medio de comandos. Esta configuración seexplica detalladamente en el punto 7.

6.3. Configuración de puertos

Para realizar la configuración del equipo, lo primero a realizar es configurar todas las entradas y salidas que sean de interés, así como los puertos virtuales necesarios (temporizadores, condiciones, operaciones lógicas, etc.).

En este punto aprenderemos a configurar los puertos disponibles en el equipo, entre los que se incluyen:- 8 puertos digitales de salida.- 8 puertos digitales de entrada.- 2 puertos analógicos de entrada- 2 puertos analógicos de salida- 61 puertos virtuales, por defecto deshabilitados menos los 10 primeros. En estos puertos, como veremos a continuación, es donde configuramos operaciones lógicas, condiciones, temporizadores, etc.

6.3.1. Puertos de salida digitalesHaciendo click en cualquier puerto digital de salida (por ejemplo "do000"), se nos abrirá la pantalla de configuración de este puerto dónde podremos modificar los siguientes campos:

- Port name: cambia el nombre en clave del puerto.- Visible: define si el puerto se muestra o no en la pantalla de control (home).- Show in config: define si el puerto se muestra en la pantalla de settings. (Si se selecciona la opción “Show in config” el puerto desaparecerá de la pantalla “home”).

Esto lo haremos con los 8 puertos disponibles.

Importante:- Los nombres asignados deben usar exclusivamente letras y números, y deben tener una longitud fija de 5 caracteres.- Por defecto las etiquetas de todos los puertos de un CTRL son nulas o “0” (cero).- Es necesario guardar los cambios después de configurar el puerto deseado.

Ejemplo

En la figura de la derecha tenemos un ejemplo de configuración de un puerto de salida digital (en este caso es una lámpara).

Se modifica el nombre del puerto por “lamp5”. Seguidamente, activamos el puerto haciéndolo visible “Visible” en el apartado principal “home”.

En este caso, dejamos inactivo el campo “Show in config” porque no deseamos visualizarlo en la pestaña “Settings”.

12


CTRL1

6.3.3. Puertos de salida analógicos

Haciendo click en un puerto analógico de salida (por ejemplo "ao000"), se nos abrirá la pantalla de configuración del puerto especificado y podremos modificar los siguientes campos:- Port name: cambia el nombre en clave del puerto.- Visible: define si el puerto se muestra o no en la pantalla de control (home).- Show in config: define si el puerto se muestra en la pantalla de settings. (Si se selecciona la opción “Show in config” el puerto desaparecerá de la pantalla “home”).- Port type: Modo de operación. Debemos seleccionar modo tensión o intensidad y los valores necesarios (Por ejemplo: 0-10V, 4-20mA).- Minimum, Maximum: en estos campos debemos indicar los valores máximo y mínimo de la variable exterior ( por ejemplo: 0% - 100%; -5ºC - 50ºC)- Tolerance: define la tolerancia en porcentaje del equipo conectado a la salida analógica. (*) Nota: Los valores a indicar en los campos “minimum”, “maximum” y “tolerance” deben ser facilitados por el fabricante del equipo a conectar con el CTRL1.Importante:- Los nombres asignados deben usar exclusivamente letras y números, y deben tener una longitud fija de 5 caracteres.- Es necesario guardar los cambios después de configurar el puerto deseado.

Ejemplo:En la figura inferior tenemos un ejemplo de configuración de un puerto de salida analógica (en este caso una luminaria led dimmeable).

Se modifica el nombre del puerto por “dimer”. En este caso, dejamos inactivos los campos “Visible” y “Show in config” porque no deseamos visualizarlo ni en la pestaña “home” ni “Settings”.

Se elige un modo de operación en voltaje de 0-10V. Indicamos el rango entre 0% (mínimo) y 100% (máximo). Por último, se indica tolerancia 0.

6.3.4. Puertos de entrada analógicos

Haciendo click en un puerto analógico de entrada (por ejemplo "ai000"), se nos abrirá la pantalla de configuración del puerto especificado y podremos modificar los siguientes campos:

‐ Port name: cambia el nombre en clave del puerto.

‐ Visible: define si el puerto se muestra o no en la pantalla de control (home).

‐ Show in config: define si el puerto se muestra en la pantalla de settings. (Si se selecciona la opción

“Show in config” el puerto desaparecerá de la pantalla “home”).

‐ Port type: Modo de operación. Debemos seleccionar modo tensión o intensidad y los valores

necesarios (Por ejemplo: 0-10V, 4-20mA).

‐ Minimum, Maximum: en estos campos debemos indicar los valores máximo y mínimo de la

variable exterior (por ejemplo: 0% - 100%; -5ºC - 50ºC)

‐ Tolerance: define la tolerancia en porcentaje del equipo conectado a la entrada analógica.

(*) Nota: Los valores a indicar en los campos “minimum”, “maximum” y “tolerance” deben ser facilitados por el fabricante del equipo a conectar con el CTRL1.

Importante:

‐ Los nombres asignados deben usar exclusivamente letras y números, y deben tener una longitud fija de 5 caracteres.

‐ Es necesario guardar los cambios después de configurar el puerto deseado.

Ejemplo:

En la figura inferior tenemos un ejemplo de configuración de un puerto de salida analógica (en este caso una fotocélula). Se modifica el nombre del puerto por “lumen”.

En este caso, dejamos inactivos los campos “Visible” y “Show in config” porque no deseamos visualizarlo ni en la pestaña “home” ni “Settings”.

Se elige un modo de operación en voltaje de 0-10V. Indicamos el rango entre 2 lux (mínimo) y 500 lux (máximo). Por último, se indica tolerancia 0.

13


CTRL1

6.3.5. Puertos virtuales

Los puertos virtuales son variables internas del CTRL1 que, aunque no son puertos reales se comportan de forma similar. Por defecto, tenemos 10 puertos virtuales habilitados y 51 deshabilitados.

A continuación, se detallan los tipos de puertos virtuales que existen y como configurarles:

COUNTDOWN (Temporizador)

Esta función actuaría como un temporizador con retardo a la conexión. Cuando se activa, este puerto empieza una cuenta atrás en segundos (configurable), cuando finaliza dicha cuenta atrás realiza la acción indicada.

En el ejemplo de la imagen, cuando se active el temporizador, empezará una cuenta atrás de 10 segundos, cuando llegue al final, la salida digital “lamp1” cambiará a estado ON.

VARIABLE o PERSISTENT (Asignar una variable)

Cualesquiera de estas dos funciones permiten asignar a un puerto virtual: ‐ una variable digital con estado ON o con estado OFF. ‐ una variable analógica con un valor configurado.

14


CTRL1

Esta función es útil para almacenar valores y para realizar diferentes operaciones lógicas, condiciones, etc.

Ejemplo:

En una aplicación de encendido ventilación artificial en función de las personas existentes en un edificio, por ejemplo, cuando la cantidad sea superior a 50 personas.

Con un detector de presencia conectado a una entrada digital, activamos un contador que sume en un puerto virtual del tipo “variable” analógica (Puerto A) la cantidad de personas que entran en el edificio. A continuación, creamos un segundo puerto virtual del tipo “variable” analógica con un valor pre-configurado de 50 (Puerto B). Para finalizar, hacemos una operación “group” entre estos dos puertos, de tal forma que, cuando el puerto B sea mayor al puerto A se activará una salida digital para el arranque de la ventilación artificial.

El número de personas puede ser modificable por el usuario final en la pantalla “settings” (figura inferior).

La diferencia entre la función “variable” y “persistent” es que el valor almacenado en un puerto virtual del tipo “persistent” permanecerá en caso de un reinicio del CTRL1.

TIME TRIGGER (Planificador)

Esta función permite configurar un puerto virtual como planificador. De esta manera la acción configurada en este puerto se realizará en la fecha y hora elegidas.

En el ejemplo de las figuras inferiores, se configura un puerto virtual del tipo “time trigger” con el nombre “la4on”.

Se configura para que se muestre en la pantalla de “settings” y se configura para que cuando este puerto virtual se active, la salida digital “lamp4” cambie a ON.

En la pantalla “settings”, el usuario elegirá el día, mes y hora en que desea activar este puerto (Ver imagen). (*) Nota: el usuario debe pulsar sobre “save” para que quede guardada la configuración.

Existen dos tipos de planificadores, del tipo “hora” y “día de la semana”

Para configurar un puerto virtual del tipo Schedule, realizaremos los siguientes pasos:

‐ Primero, accedemos a “Configurator” de nuestro

dispositivo y seleccionamos "Configure Ports".

‐ Una vez allí, escogemos el puerto virtual en el que deseamos aplicar la configuración.

‐ Seguidamente, escogeremos la opción Schedule y nos aparecerá una nueva ventana donde debemos escoger entre el tipo "hora" y losde tipo "día de la semana".

SCHEDULER (Planificador según calendario)

Esta función permite configurar un puerto virtual como planificador. De esta manera el puerto estará activado (ON) si se cumplen las condiciones configuradas, de lo contrario, el puerto estará desactivado (OFF).

15


CTRL1

‐ Escogemos donde deseamos que sea visible nuestro puerto de tipo planificador, mediante las opciones "Show in Config” (será visible en “setting”) o “Visible” (será visible en “home”).

‐ Finalmente, buscamos el puerto en la sección correspondiente y a través de un desplegable muy intuitivo podremos determinar la franja horaria y/o los días de actuación de nuestros puertos.

‐ Con este puerto, que estará ON u OFF según la programación del usuario final, podremos actuar cualquier otro puerto.

Ejemplo1:

El puerto virtual “la2on” estará en ON todos los martes y miércoles, el resto de días de la semana estará en OFF. Por otro lado, este puerto tiene un enlace directo con la salida digital “lamp2” (Ver punto 6.4) de tal forma, que cuando el puerto virtual se encuentre en ON, la salida digital “lamp2” estará a ON y viceversa.

Ejemplo2:

En esta imagen, el puerto virtual “la1on” estará en las horas marcadas en azul (10, 14, 15, 17, 18, 19 y en el resto de horas de la semana, estará en OFF.

Si se desea combinar día de la semana con horas, se puede realizar cómodamente realizando un “group” entre las dos variables. (Ver siguiente función)

GROUP (Operación lógica)

Esta función permite agrupar dos puertos de cualquier tipo mediante una operación lógica.

Las condiciones disponibles en esta función son las siguientes:

Para puertos del tipo digital:

‐ and: realiza una operación lógica AND (Ver imagen inferior)

16


CTRL1

‐ nand: realiza una operación lógica NAND (Ver imagen inferior)

‐ or: realiza una operación lógica OR (Ver imagen inferior)

‐ nor: realiza una operación lógica NOR (Ver imagen inferior)

‐ xor: realiza una operación lógica XOR (Ver imagen inferior)

‐ not: realiza una operación lógica NOT (Ver imagen inferior)

17


CTRL1

‐ -: realiza una operación de resta de puertos. Realiza una operación matemática donde resta las

variables o valores binarios de los puertos especificados.

‐ *: realiza una operación aritmética con la finalidad de multiplicar puertos. Multiplica los valores

que se recogen en ambos puertos, ya sean variables o binarios.

‐ /: realiza una operación de división de puertos. Divide los valores que se recogen en ambos

puertos, ya sean variables o binarios.

‐ max: obtiene el valor máximo entre los dos puertos. Obtiene el valor máximo de las variables

establecidas en ambos puertos.

‐ min: obtiene el valor mínimo entre los dos puertos. Obtiene el valor mínimo de las variables

establecidas en ambos puertos.

‐ =: Compara las variables de dos puertos, cuando el valor de dichas variables sea igual el puerto

virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

‐ !=: Compara las variables de dos puertos, cuando el valor de dichas variables sea distinto el

puerto virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

‐ >: Compara las variables de dos puertos, cuando el valor del puerto A sea mayor que el valor del

puerto B, puerto virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

‐ <: Compara las variables de dos puertos, cuando el valor del puerto A sea menor que el valor

del puerto B, puerto virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

‐ >=: Compara las variables de dos puertos, cuando el valor del puerto A sea mayor o igual que

el valor del puerto B, puerto virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

‐ <=: Compara las variables de dos puertos, cuando el valor del puerto A sea menor o igual que

el valor del puerto B, puerto virtual cambiará a ON, cuando no se cumpla esta condición se mantendrá en OFF.

CONDITIONAL (Condición)

Esta función permite activar o desactivar un puerto cuando se cumple una condición. Las funciones existentes son:

‐ ==: Los puertos SON iguales.

‐ !=: Los puertos NO son iguales

‐ >: El primero es más grande que el segundo puerto.

‐ <: El primero es más pequeño que el segundo puerto.

Para puertos del tipo analógico:

‐ +: realiza una operación de suma de puertos. Suma los valores o variables de los puertos especificados.

18


CTRL1

‐ >=: El primero es más grande o igual que el segundo

puerto.

‐ <=: El primero es más pequeño o igual que el segundo

puerto.

Ejemplo:

En la figura, cuando el valor de una entrada analógica “temp1” (en este caso un sensor de temperatura) sea igual o mayor al puerto “vt013” (este puerto se he fijado como 26ºC) la salida digital “lamp1” cambiará a estado ON.

MODBUS/RTU port (Puerto Modbus RS485)

Este puerto permite enlazar un puerto virtual con un puerto Modbus/RTU.

En esta configuración el CTRL1 se convierte en un dispositivo maestro (cliente) Modbus/RTU, es decir, se puede comunicar con otros dispositivos esclavos (servidores) compatibles con el protocolo Modbus/RTU. De esta forma el equipo puede ampliar sus entradas y salidas tanto analógicas como digitales en función de las características de los dispositivos conectados.

La configuración del puerto necesita los siguientes parámetros:

‐ Port type: Elegimos si el puerto es de entrada o salida y si es del

tipo analógico o digital. Analog Input (entrada analógica), Analog Output (salida analógica), Digital Input (entrada digital), Digital Output (salida digital).

‐ Address: Indicar la dirección del dispositivo conectado. Este debe

ser un valor decimal, entre 0 y 247.

‐ Registro: Indicar la dirección del registro en hexadecimal del dispositivo conectado. Este debe ser un valor hexadecimal.

‐ Baud rate: Indicar la velocidad del bus.

Los valores que soporta el CTRL1 son: 1200, 2400, 9600, 19200, 38400, 57600 y 115200.

‐ Parity: Indicar la paridad del equipo conectado.

Sin paridad (n), con paridad par (e) o con paridad impar (o).

‐ “Stop bits”: Indicar Bits de stop (1 o 2).

‐ “Function code”: Indicar el código de función (3, 4 o 5). (Ver nota *)

19


CTRL1

‐ Data type: Indicar el tipo del dato: i16, ui16, i32, ui32, i64, f32, i32msb, ui32msb, ui32msb, f32msb, i54msb, ui64msb (msb se usa para dispositivos que ordenan al revés de lo que se propone en la especificación de modbus). (Ver tabla inferior)

(*) Nota: Dependiendo del tipo de puerto que se quiere utilizar se debe elegir el código de función correspondiente. - Puertos digitales de entrada: Función 2, tipo de dato bool. - Puertos digitales de salida: Función 5, tipo de dato bool (internamente también utiliza la función 1 para la lectura del estado del registro). - Puertos analógicos de entrada: Función 3 o 4, cualquier tipo de dato menos bool. - Puertos analógicos de salida: Función 6, tipo de dato i16 o ui16 (internamente también utiliza la función 3 para la lectura del estado del registro).

La mayor parte de los datos deben ser proporcionados por el fabricante del equipo a conectar.

En el caso de configurar cualquier parámetro de forma incorrecta no obtendremos comunicación con el dispositivo Modbus o bien leeremos/enviaremos datos incorrectos.

REMOTE DEVICE y REMOTE PORT (Puertos remotos de otros equipos)

Esta función nos permite configurar un puerto remoto, es decir un puerto como copia de otro puerto de otro equipo CTRL1. Para configurar dicho puerto tenemos que seguir unos pasos determinados sino no funcionará y tendremos problemas para leer los datos del puerto deseado.

‐ Escogemos un puerto virtual disponible y

entramos “remote device”.

‐ Nos aparecerá una nueva ventana donde nos

indicará que especifiquemos un nombre.

IMPORTANTE: El nombre debemos poner al puerto debe corresponder con el nombre del dispositivo remoto.

6.4 Configuración de enlaces de puertos (LINK)

Como se ha dicho anteriormente, para realizar la configuración del CTRL1, lo primero a realizar es configurar todos los puertos, es decir entradas y salidas que sean de interés, así como las variables virtuales necesarias (explicado en el punto 6.3). A continuación, sería necesario enlazar todos los puertos configurados para realizar la acción necesaria.

Los enlaces se crean entre un puerto de entrada (primer argumento) y un puerto de salida (segundo argumento) indicando en tercer lugar el tipo de enlace.

20


CTRL1

Podemos realizar enlaces entre todos los tipos de puertos de nuestro CTRL1. A continuación, veremos un ejemplo esclarecedor de cada tipo de enlace (link) para que la configuración sea menos tediosa.

Recordemos que para configurar nuestros enlaces tenemos que ir a la sección "Configure links" dentro de nuestro "Configurator".

DIRECT (Enlace directo)

Cuando se ejecute este tipo de enlace, el puerto de destino tendrá el mismo valor que el puerto de Origen.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” en modo ON, la salida digital “lamp1” estará en modo ON y viceversa.

INVERS (Enlace inverso)

Cuando se ejecute este tipo de enlace el puerto de destino tendrá el valor opuesto del puerto de origen. Entrada y salida siempre tendrán valores opuestos.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” esté en modo ON, la salida digital “lamp1” estará en modo OFF y viceversa.

PULSE e INMEDIATE PULSE (Enlace tipo Pulso)

Tenemos dos tipos de enlace tipo pulso:

‐ Pulse: Si se recibe un pulso en el puerto de origen el puerto de destino cambiara de valor, y

viceversa.

‐ Inmediate pulse: Si se recibe un pulso en el puerto de origen el puerto de destino cambiara de

valor, y viceversa, la ventaja sobre “pulse” es su velocidad, dado que se propaga de forma inmediata. Equivalente a “pulse” pero no compatible con múltiples pulsaciones.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” active un pulso, la salida digital “lamp1” cambiará de estado (si está en modo ON pasará a OFF y viceversa).

21


CTRL1

CHANGE (Enlace tipo cambio)

Si se realiza un cambio en el puerto de origen, el puerto de destino cambiará de valor independientemente de su estado actual. Entrada y salida no tienen por qué tener el mismo valor.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” cambie el estado (si está en ON y cambia a OFF o viceversa), la salida digital “lamp1” cambiará su estado (si está en OFF cambiará a ON y viceversa).

RETURN (Enlace tipo retorno)

Si el puerto de origen cambia de valor, el puerto de destino cogerá dicho valor y al cabo de 500 ms regresará a su estado inicial.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” cambie el estado a ON, la salida digital “lamp1” cambiará su estado a ON y a los ms volverá a cambiar su estado a OFF.

T-RETURN (Enlace tipo retorno en subida)

El puerto de destino cogerá el valor del puerto de origen y al cabo de un pequeño tiempo el puerto de destino volverá al valor por defecto del puerto de origen, como los enlaces de tipo retorno.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” cambie el estado a ON, la salida digital “lamp1” cambiará su estado a ON, al poco tiempo cambiará de nuevo su estado a OFF por ser su estado por defecto del puerto de origen “puls1”.

SELF (Enlace tipo retorno en subida)

Este enlace se utiliza para crear un enlace con un mismo puerto origen y destino, con el objetivo de que siempre que el valor del puerto cambie vuelva a su estado por defecto (apagado).

Ejemplo:

En la imagen, cuando la salida digital “lamp1” cambie su estado a ON, al poco tiempo esta salida “lamp1” cambiará a su estado por defecto OFF.

22


CTRL1

DOUBLE (Enlace doble pulso)

Si recibimos dos pulsos continuos en el puerto de origen, el puerto de salida cambiará de valor. Si está en "ON" pasará a "OFF" y viceversa. Este tipo de enlace es incompatible con un enlace tipo “long” e “inmediate pulse”.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” realice dos pulsos consecutivos, la salida digital “lamp1” cambiará su estado (si está en ON cambiará a OFF y viceversa).

TRIPLE (Enlace triple pulso)

Si recibimos tres pulsos continuos en el puerto de origen, el puerto de salida cambiará de valor. Si está en "ON" pasará a "OFF" y viceversa. Este tipo de enlace es incompatible con un enlace tipo “long” e “inmediate pulse”.

Ejemplo:

En la imagen, cuando la entrada digital “puls1” realice tres pulsos consecutivos, la salida digital “lamp1” cambiará su estado (si está en ON cambiará a OFF y viceversa).

LONG (Enlace pulsación larga)

Se recomienda utilizar este enlace entre una entrada digital y un puerto analógico virtual de salida. Según el tiempo de pulsación en el puerto de origen aumentará el valor de consigna del puerto de destino. Una aplicación típica de este tipo de enlace son las regulaciones de potencia o de luminosidad.

Este tipo de enlace es incompatible con un enlace tipo “pulse” e “inmediate pulse”, “double” y “triple”.

Ejemplo:

En la imagen, la salida analógica “lamp4” cambiará su estado en porcentaje (entre 0% y 100%) en función del tiempo de pulsación en la entrada digital “puls1”.

BOOT (Enlace de arranque)

Este enlace solo se aplica después de reiniciar nuestro equipo CTRL1. Su finalidad es establecer un valor de inicialización al equipo.

INTERLINK (Enlace de interbloqueo)

Asocia dos puertos de manera que los puertos de destino nunca podrán tener el mismo valor a la vez, cuando uno coge un valor automáticamente el siguiente puerto de destino modifica el suyo para que no coincidan. Esta función solo puede usarse en puertos digitales de salida.

Ejemplo:

En la imagen, las entradas digitales “lamp1” y “lamp2” NUNCA podrán tener el mismo estado, cuando “lamp1” este en ON, “lamp2” estará en OFF.

23


CTRL1

UP-COUNTER y DOWN-COUNTER (Enlace tipo contador)

Tenemos dos tipos de enlace tipo contador:

‐ Up-counter (contador de subida): Cada vez que se active el puerto de origen incrementa el valor

del puerto de destino (el puerto de destino será un puerto virtual analógico).

‐ Down-counter (contador de bajada): Cada vez que se desactiva el puerto de origen incrementa el

valor del puerto de destino (el puerto de destino será un puerto virtual analógico).

Ejemplos típicos de estos enlaces son contadores de personas o contadores cíclicos.

Ejemplo:

En la imagen, cuando se active la entrada digital “di000” (por ejemplo, un sensor de proximidad) el puerto virtual analógico “vt013” aumentará su valor en una unidad. Mediante otro enlace, puedo hacer que cuando el puerto virtual llegue a un valor, desconecte una salida digital.

SET-ON y SET-OFF (Enlace para cambiar el estado a ON u OFF)

Tenemos dos tipos de enlace para cambiar el estado de salidas:

‐ Set-on (cambio de estado a ON): Cuando el puerto de origen cambia de valor, el puerto de destino se pone a ON.

‐ Set-off (cambio de estado a OFF): Cuando el puerto de origen cambia de valor, el puerto de destino se pone a OFF

Ejemplo:

En la imagen, cuando la entrada digital “puls1” cambie su valor (pase de ON a OFF o viceversa la salida digital cambiará su estado a OFF (en caso de estar a OFF no surtirá ningún efecto.

24


CTRL1

7. Programación/ Configuración mediante comandos

Además de la configuración que hemos visto en el punto anterior, CTRL1 dispone de un lenguaje de comandos que nos permite configurar y manipular el equipo. Puede usarse tanto desde una consola como usando un lenguaje de programación. Estos comandos son una herramienta para usuarios técnicos. Si usted no dispone de conocimientos técnicos o no tiene mucha experiencia con el equipo CTRL1 se recomienda usar el “Configurator”.

En este punto se explica los comandos para la programación con la consola.

Para acceder a la consola y poder comenzar con la configuración por comandos accedemos a “Configurator” y dentro de este “Console”.

CTRL1 dispone de una interfaz web (puerto 80) de usuario que permite controlar el equipo y consultar su estado, en función de cómo haya sido configurado. Como se ha comentado anteriormente, por defecto, el equipo tiene la IP 169.254.0.1, por lo que después de conectar correctamente el cableado de comunicaciones, puede acceder a dicha interfaz con un navegador web:

‐ http://169.254.0.1

CTRL1 le pedirá un usuario y una contraseña. Sus valores por defecto son:

‐ usuario: user ‐ contraseña: control

En la pestaña "Configuration", le dará acceso a una aplicación web (puerto 81) de configuración avanzada, desde donde el equipo puede ser configurado gráficamente. Para acceder a esta zona es necesario disponer de las credenciales de administrador, que por defecto son:

‐ usuario: admin ‐ contraseña: control

La herramienta de configuración, además de permitir una configuración gráfica, también permite ejecutar comandos directamente. En este punto se detallarán los comandos a utilizar para configurar mediante comandas nuestro CTRL1.

7.1 Comunicación con CTRL1

7.1.1 API de control HTTP

A través del puerto 81 (por defecto), o el puerto configurado para “configurator” pueden enviarse todos los comandos que veremos a continuación a CTRL1, de manera que el equipo puede ser controlado mediante lenguaje de programación.

Por ejemplo, puede enviar un comando ver en cualquier navegador mediante:

‐ http://169.254.0.1/ver (Comando para ver la versión actual del CTRL1)

El navegador nos dará el comando ver: cntrl versn 2.0.9 16:56:16 Feb 9 2017 DONE

ATENCIÓN: El tráfico de datos no va cifrado, use este sistema de comunicación únicamente en entornos locales controlados.

25


CTRL1

7.2 Comandos generales

VERSION (ver)

Este comando muestra la versión del software cargado en el CTRL1, así como el nombre del dispositivo y la fecha de creación del firmware.

LISTADO (lsc)

Este comando muestra un listado de todos los puertos del equipo, tanto entradas y salidas analógicas y digitales como todos los puertos virtuales.

La salida tiene diferentes tipos de campos separados por “:”.

‐ Primer campo: nombre del puerto. ‐ Segundo campo: describe algunas características del puerto y tiene cuatro letras.

Las dos primeras letras se muestran en parejas, son las siguientes:

• DO: Salida digital

• DI: Entrada digital

• AO: Salida analógica

• AI: Entrada analógica

• DV: Virtual digital (modificable)

• AV: Virtual analógico (modificable)

• Dv: Virtual digital no modificable

• Av: Virtual analógico (no modificable)

• TV: Virtual temporizador

• WV: Virtual programador por hora y día de la semana (DTG)

• CV: Virtual programador por fecha de calendario (TTG)

• Rv: Virtual dispositivo remoto (no modificable)

La tercera letra puede tener uno de los siguientes significados:

• M: Visible en la pestaña Home

• C: Visible en la pestaña Config

• H: Oculto

‐ Tercer campo: corresponde al valor del puerto. (OFF, ON, valor analógico)

‐ Cuarto campo: o en puertos analógicos indica el máximo y el mínimo (ver rng).

26


CTRL1

o en puertos virtuales nos indicará el tipo de puerto virtual:

• VAR: Variable

• PER: Variable Persistente

• GRP: Grupo

• TRG: Disparador de condición

• TTG: Disparador de tiempo

• DTG: Disparador de día

• ZTG: Timer

• RPT: Puerto remoto

• RDV: Dispositivo remoto

• MDB: Puerto de tipos modbus

• CNV: Puerto de conversión de datos

‐ Quinto campo:

o en puertos analógicos indica su tolerancia (ver tol)

o en puertos virtuales indica su valor o configuración.

Ejemplos:

Un puerto PER sería similar a: vt000:DVM_:OFF:PER:OFF Un puerto analógico serie: vt000:AVC_:+0040.0000:PER

Los puertos virtuales que disponen de campos de configuración tienen el valor de configuración como quinto parámetro. Por ejemplo, un puerto de tipo ztg tendría la siguiente configuración:

vt000:DVC_:OFF:ZTG:sec 00030 do000 on

La forma básica de uso de este comando es escribiendo simplemente 'lsc'. El resultado en un CTRL1 con configuración por defecto es el siguiente:

do000:DOM_:OFF do001:DOM_:OFF do002:DOM_:OFF do003:DOM_:OFF do004:DOM_:OFF do005:DOM_:OFF do006:DOM_:OFF do007:DOM_:OFF

di000:DIM_:OFF di001:DIM_:OFF di002:DIM_:OFF di003:DIM_:OFF di004:DIM_:OFF di005:DIM_:OFF di006:DIM_:OFF di007:DIM_:OFF

ao000:AOM_:+0000.0000:+00000|00020:a5:00255 ao001:AOM_:+0000.0000:+00000|00020:a5:00255 ai000:AIM_:+0000.0000:+00000|00020:a5:00255 ai001:AIM_:+0000.0000:+00000|00020:a5:00255

vt000:AvC_:OFF:VAR:OFF vt001:DVC_:OFF:VAR:OFF vt002:DVC_:OFF:VAR:OFF vt003:DVC_:OFF:VAR:OFF vt004:DVC_:OFF:VAR:OFF vt005:DVC_:OFF:VAR:OFF vt006:DVC_:OFF:VAR:OFF vt007:DVC_:OFF:VAR:OFF vt008:DVC_:OFF:VAR:OFF ...

27


CTRL1

PUERTOS VISIBLES EN CONFIG (lsc cfg)

Si únicamente queremos consultar los puertos que son visibles en la pestaña de “configurator”, podemos usar el comando 'lsc cfg'.

(*) Nota: Este comando retorna como máximo 24 puertos.

PUERTOS VISIBLES EN HOME (lsc hme)

Si únicamente queremos consultar los puertos que son visibles en la pestaña de “home”, podemos usar el comando 'lsc hme'.

(*) Nota: Este comando retorna como máximo 24 puertos.

EXTRACCION DE RANGOS DE PUERTOS (lsc $ini-$fin)

Si deseamos extraer un rango concreto de puertos podemos hacerlo pasando a “lsc” como parámetro el rango de inicio y de fin. Por ejemplo, para listar los puertos del 60 al 65 podemos ejecutar “lsc 60-65”.

(*) Nota: Hay que tener en cuenta que los primeros 8 puertos son digitales de salidas, los segundos ocho puertos son digitales de entrada, los siguientes 4 son analógicos de entrada/salida y el resto son virtuales. Por eso los puertos del 60 al 65 corresponden a los virtuales del 40 al 45.

CONSULTA DE UN SOLO PUERTO (lsc $port)

Si deseamos consultar únicamente un puerto podemos hacerlos pasando su nombre como parámetro. Por ejemplo, podemos consultar el puerto di000 con “lsc di000”.

28


CTRL1

ESTABLECER (set)

Establece el valor de un puerto. Solo puede efectuarse sobre puertos virtuales y puertos de salida. Por ejemplo, podemos asignar un valor a un puerto con:

‐ set do000 on

En caso de puertos virtuales, si son digitales lo haremos de la misma forma:

‐ set vt000 off

Pero si son analógicos tendremos que introducir los datos en diezmilésimas. Por ejemplo, para establecer el valor 4.5 haremos:

‐ set vt000 45000

o usando un punto para separar los decimales. El ejemplo anterior podría ser:

‐ set vt000 4.5

Esto puede ser confuso en el momento de enviar números enteros. Por lo que tenga en cuenta, que, si desea enviar, por ejemplo, el valor entero 5, puede hacerlo de dos maneras:

‐ set vt000 50000 ‐ set vt000 5.0

Los rangos aceptados van de 999999999 (correspondiente a +9999.9999) a -99999999 (correspondiente a -9999.9999).

TIEMPO DE FUNCIONAMIENTO (upt)

Este comando nos dice el tiempo que lleva encendido el CTRL1 desde el último reinicio.

DEPURAR (dbg)

Este comando controla la información que se muestra por el puerto serie, y se usa para depurar el sistema CTRL1. También se utiliza para activar el modo de simulación del equipo (ver modo de simulación en punto 8).

El comando soporta los siguientes parámetros:

• set: muestra información de la modificación del valor de un puerto.

• network: muestra información sobre temas de red.

• triggers: muestra información sobre el comportamiento de los disparadores.

• links: muestra información sobre el comportamiento de los enlaces.

• groups: muestra información sobre el comportamiento de los grupos.

• all: muestra toda la información de depuración.

• sim-on: activa el modo de simulación en el ODControl.

• sim-off: desactiva el modo de simulación en el ODControl.

• off: detiene la depuración, no actua sobre el modo de simulación.

RELOAD (rel)

Esta función reinicia el dispositivo. Hace la misma función que presionar el botón de reset un instante.

CLEAR (clr)

Borra la configuración de puertos y enlaces, conservando la IP, el nombre del dispositivo y las credenciales de usuario.

29


CTRL1

Asigna un nombre al dispositivo CTRL1. Solamente se permiten caracteres en minúscula y números, con una longitud fija de 5 caracteres.

‐ snm bname

7.3 Comandos configuración de puertos

RENOMBRAR UN PUERTO (lbl)

Asigna un nuevo nombre a un puerto. Los nombres deben usar exclusivamente letras en minúscula y números, y tienen una longitud fija de 5 caracteres:

‐ lbl port1 alias

CONFIGURAR UN PUERTO (cfg)

Configura el puerto especificado en el primer parámetro con las características definidas en el segundo:

‐ cfg port1 d

Las características se definen mediante caracteres, del siguiente modo:

• d: Digital, solo aplicable a puertos digitales.

• a: Analógico, solo aplicable a puertos analógicos.

• x: Puerto deshabilitado

• p: Pulso, solo aplicable a puertos digitales de salida.

• h: (hide) oculta el puerto, es decir, lo hace invisible en la interfaz web.

• s: (show in home) muestra el puerto, es decir, lo hace visible en la sección home interfaz web.

• S: (S mayúscula) muestra el puerto en la sección de configuración de la interfaz web. Los puertos

con esta opción aparecen a partir de la página 2 de la configuración.

Los puertos analógicos físicos usan los siguientes tipos:

• a1: 0-10V

• a2: 1-10V

• a5: 0-20mA

• a6: 4-20mA

7.4 Comandos especiales entradas analógicas

TOLERANCIA (tol)

Asigna una tolerancia determinada a un puerto analógico de entrada. Para valores inferiores al especificado, no se notificará cambio de estado.

DEFAULT (def)

Aplica la configuración por defecto.

CAMBIAR NOMBRE (snm)

- tol ai000 100

30


CTRL1

CONVERSION DE UNIDADES (rng)

El comando rng permite configurar los rangos que toma un puerto analógico físico (AO o AI), para poder realizar la conversión a las unidades necesarias. Por ejemplo, si es una entrada conectada a un sensor de temperatura cuyo valor mínimo es -20 ºC y cuyo valor máximo es 50 ºC, tendremos que ejecutar un comando como el del siguiente ejemplo:

‐ rng ai000 -20 50

De esta manera, el puerto ai000 podrá mostrar temperatura, directamente.

Si no se especifica la conversión de unidades, el puerto mostrará un valor u otro en función del sensor. Por ejemplo, si es un sensor 0-20 mA, se mostrarán mA, si es un sensor 0-10 V se mostrarán voltios, etc.

El rango de valores aceptado por el comando RNG es [-9999, 9999].

7.5 Comandos especiales puertos virtuales

PUERTO VIRTUAL DEL TIPO VARIABLE (car)

Es el tipo más sencillo. Simplemente almacena valores. ‐ var vt000

PUERTO VIRTUAL DEL TIPO PERSISTENTE (per)

Similar al puerto virtual de tipo "var", pero con la diferencia de que el valor almacenado persiste cuando el dispositivo se reinicia.

‐ per vt000

PUERTO VIRTUAL DEL TIPO GRUPO (grp)

Mediante este comando podemos asignar a un puerto virtual una función agrupamiento. Disponemos de las siguientes funciones de agrupamiento:

• add: suma los valores agrupados.

• sub: resta los valores agrupados.

• mul: multiplica los valores.

• div: divide los valores.

• max: obtiene el valor máximo entre los dos puertos.

• min: obtiene el valor mínimo entre los dos puertos.

• and: realiza una operación lógica AND.

• nand: realiza una operació lógica NAND.

• or: realiza una operación lógica OR.

• nor: negación de la operación OR.

• xor: realiza una operació lógica XOR.

• not: devuelve el valor opuesto al puerto indicado (el puerto debe indicarse dos veces).

• eq: true si son iguales.

• ne: true si son diferentes.

• gt: true si el primer puerto es mayor que el segundo.

• lt: true si el primer puerto es menor que el segundo.

• ge: true si el primer puerto es mayor o igual que el segundo.

• le: true si el primer puerto es menor o igual que el segundo.

‐ grp vt000 di002 di003 and

Al ejecutar el comando anterior, el puerto virtual vt000 toma el valor de (di002 AND di003).

31


CTRL1

PUERTO VIRTUAL DEL TIPO DISPARADOR DE CONDICION (trg)

Permite configurar condiciones sobre un puerto virtual. De manera que si la condición se cumple podamos actuar sobre un puerto. Existen los siguientes tipos de condiciones posibles:

• cmpeq: Son iguales.

• cmpne: No son iguales.

• cmpgt: El primero es más grande.

• cmplt: El primero es más pequeño.

• cmpge: El primero es más grande o igual.

• cmple: El primero es más pequeño o igual.

‐ trg vt000 cmpeq vt001 do000 on

Con el commando anterior, activamos el puerto do000 cuando el puerto virtual vt000 tiene el mismo valor que el puerto virtual vt001.

Las actuaciones permitidas sobre un puerto son: on, off o el valor de un puerto indicado.

PUERTO VIRTUAL DEL TIPO TEMPORIZADOR (ztg)

Programa un disparador de cuenta atrás. Ejecuta la acción indicada cuando el valor del puerto llega a cero.

El temporizador está activado cuando el puerto virtual está a on y se para cuando llega a cero o el puerto se pone en off. Por ejemplo, con la siguiente configuración:

‐ ztg vt000 sec 00020 do000 on

Si ponemos vt000 a on se activará el contador, y en 20 segundos pondrá do000 a off. Si antes de que esto suceda, se pone vt000 a off, el contador parará. Si se deja que el contador llegue a cero y ejecute do000=off, el mismo pondrá vt000 a off.

(*) Nota: La longitud del campo que indica los segundos debe tener 5 dígitos.

PUERTO VIRTUAL DEL TIPO DISPARADOR DE DIA (dtg)

Programa un disparador que se lanza en la hora y día especificados, cambiando el valor del puerto especificado. El formato de tiempo consiste en tres letras indicando el día en inglés (sun, mon, tue, wed, thu, fri, sat) seguidas de 6 dígitos indicando horas, minutos y segundos.

‐ dtg vt000 fri220000 do000 on

Si el puerto se hace visible, el usuario puede modificar el día y la hora desde la interfaz web.


PUERTO VIRTUAL DEL TIPO DISPARADOR DE FECHA (ttg)

Programa un disparador que se lanza en la fecha especificada, cambiando el valor del puerto especificado. Permite además usar comodines con el símbolo "*". El formato de tiempo es de cuatro dígitos para el año, dos dígitos para el mes, dos dígitos para el día, dos dígitos para la hora, dos dígitos para los minutos y dos dígitos para los segundos.

‐ ttg vt000 20130101000000 do000 on

Se pueden usar comodines para tomar un valor cualquiera. Los comodines solo sirven por grupos, por ejemplo, habría que usar dos comodines para cualquier hora, no serviría usar solo un comodín.

32


CTRL1

Por ejemplo, el comando siguiente pondría todos los años el puerto do000 a "on", el día uno de enero. Lo haría cada minuto, durante todo el día.

‐ ttg vt000 ****010100**00 do000 on


Aunque el comando necesita los cuatro primeros dígitos con el año, este se ignora. Por lo que un trigger de este tipo saltará, como mínimo, una vez al año.

PUERTO VIRTUAL DEL TIPO DISPOSITIVO REMOTO (rdv)

Permite configurar un dispositivo remoto. Es necesario para configurar puertos remotos con el comando (rpt).

Para configurar un dispositivo remoto con nombre ctr03, podemos hacer:

‐ lbl vt000 ctr03 ‐ rdv ctr03

El nombre que le ponemos al puerto debe corresponder al nombre del dispositivo remoto.

La respuesta del comando "lsc" a un puerto de tipo "rdv" es similar a la siguiente:

Ctrl1:DVC_:ON:RDV:0004A3AAAAAA

Donde el último parámetro muestro el UID del dispositivo remoto, si existe. El puerto aparece como ON cuando se ha encontrado el dispositivo remoto. En caso de no poder comunicar con él, aparece como OFF.

PUERTO VIRTUAL DEL TIPO PUERTO REMOTO (rpt)

Permite configurar un puerto remoto, es decir un puerto como copia de otro puerto de otro CTRL1.

‐ rpt vt001 ctr03 ai001

OJO: en este caso ctr03 debe ser un puerto virtual de tipo dispositivo remoto. Vea el comando "rdv".

Configuramos el puerto vt001 como copia del puerto ai001 del CTRL1 ctr03. De esta forma conseguiremos que vt001 tenga el mismo valor que el puerto ai001 de ctr03.

La respuesta del comando "lsc" a un puerto configurado con "rpt" es similar a la siguiente:

vt001:DVC_:OFF:RPT:ctrl1 do000

PUERTO VIRTUAL DEL TIPO PLANIFICADOR (sch)

Permite configurar un puerto virtual como planificador. De esta manera el puerto estará activado (ON) si se cumplen las condiciones configuradas, de lo contrario estará desactivado (OFF). Existen dos tipos de planificadores: los de tipo "hora" y los de tipo "día de la semana". Por ejemplo, podemos hacer que el puerto virtual vt000 sea un planificador de tipo hora con el comando:

‐ sch vt000 h

33


CTRL1

O hacer que sea un planificador de tipo "día de la semana".

‐ sch vt000 w

El planificador de tipo día de la semana es un valor de 8 bits. El bit de mayor peso (el de la izquierda) es ignorado, el resto indican si el día de la semana el puerto estará activado o no:

xSVJXMLD

Los valores del planificador se establecen mediante el comando "set" enviando su valor hexadecimal. Por ejemplo, si queremos que se active el domingo y el lunes haremos:

‐ set vt000 0x03

El planificador de tipo "horas" funciona de forma similar, pero en este caso usa un valor de 32 bits, del cual se ignora el byte de la izquierda. El resto de los bits indican si el puerto estará activado durante esa hora:

X X X X X X X X 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

Así pues, podremos hacer que el planificar se encienda de 10:00h a 17:00 horas con el siguiente comando:

‐ set vt000 0x0003FC00

PUERTO VIRTUAL DEL TIPO MODBUS/RTU (mdb)

Permite enlazar un puerto virtual con un puerto Modbus/RTU. En esta configuración el CTRL1 se convierte en un dispositivo maestro (cliente) Modbus/RTU, es decir, se puede comunicar con otros dispositivos esclavos (servidores) compatibles con el protocolo Modbus/RTU. De esta forma el CTRL1 puede ampliar sus entradas y salidas tanto analógicas como digitales en función de las características de los dispositivos conectados.

Ejemplo de comando Modbus:

‐ mdb vt000 ai 10 1000 9600 n 1 3 i16

Como se ve en el ejemplo, es necesario enviar los siguientes parámetros:

• ai/ao/di/do: indicando si el puerto es de entrada/salida y si es analógico/digital.

• Dirección del dispositivo en decimal, entre 0 y 247.

• Dirección del registro, entre 0 y 65535.

• Velocidad del bus (baudios), soportando: 1200, 2400, 9600, 19200, 38400, 57600 y 115200.

• Sin paridad (n), con paridad par (e) o con paridad impar (o).

• Bits de stop (1 o 2).

• Código de función (2, 3, 4, 5 y 6).

• Tipo del dato: bool, i16, ui16, i32, ui32, i64, f32, i32sw, ui32sw, ui32sw, f32sw, i64sw, ui64sw

("bool" se utiliza para los puertos digitales, "sw" se usa para dispositivos que ordenan al revés las palabras de datos respetola especificación oficial del protocolo Modbus/RTU).

34


CTRL1

(*) Nota: Dependiendo del tipo de puerto que se quiere utilizar se debe elegir el código de función correspondiente. - Puertos digitales de entrada: Función 2, tipo de dato bool. - Puertos digitales de salida: Función 5, tipo de dato bool (internamente también utiliza la función 1 para la lectura del estado del registro). - Puertos analógicos de entrada: Función 3 o 4, cualquier tipo de dato menos bool. - Puertos analógicos de salida: Función 6, tipo de dato i16 o ui16 (internamente también utiliza la función 3 para la lectura del estado del registro).

En el caso de configurar cualquier parámetro de forma incorrecta no obtendremos comunicación con el dispositivo Modbus o bien leeremos/enviaremos datos incorrectos.

PUERTO VIRTUAL DEL TIPO CONVERSION DE DATOS (cnv)

Este es un tipo especial de puerto virtual que solo puede trabajar juntamente con un puerto de tipo Modbus. La finalidad de este puerto es poder hacer conversiones entre un valor y una magnitud cuando el dispositivo Modbus nos ofrece solamente el valor en bruto. El puerto realiza una conversión de datos entre un rango de valor medido en bruto y un rango de una magnitud.

Por ejemplo, leemos un registro Modbus con un tipo de variable de 16 bits sin signo (valores entre 0 y 65535), estos valores corresponden a una temperatura de entre -40 y 120 ºC. El comando ejemplo sería:

‐ cnv vt000 vt001 0 65535 -40 120

En el ejemplo anterior podemos observar los siguientes campos:

• vt000: Puerto virtual de tipo conversión.

• vt001: Puerto virtual de tipo Modbus origen de los datos a convertir.

• valor mínimo: El valor mínimo del registro Modbus (-32768 ~ 32767).

• valor máximo: El valor máximo del registro Modbus (0 ~ 65535).

• magnitud mínima: La magnitud mínima de la variable (-32768 ~ 32767).

• magnitud máxima: La magnitud máxima de la variable (0 ~ 65535).

35


CTRL1

7.6 Comandos para crear enlaces (LINK)

Crea un enlace entre un puerto de entrada (primer argumento) y un puerto de salida (segundo argumento), indicando en tercer lugar el tipo de enlace. El tipo puede ser uno de los siguientes:

‐ d ( d i r e c t o ) : S i e l p u e r t o d e e n t r a d a s e p o n e a " on", el puerto de salida se pondrá también a "on". Entrada y salida siempre tendrán el mismo valor.

‐ i (inverso): Si el puerto de entrada se pone a "on" el de salida se pone a "off". Entrada y salida siempre tendrán valores opuestos.

‐ p (pulso): Si se recibe un pulso en la entrada (off -> on -> off) el puerto de salida cambiará de valor. Si está en "on" pasará "off" y viceversa.

‐ 2 (Multitap de doble pulso): Si se reciben dos pulsos consecutivos en la entrada el puerto de salida cambiará de valor. Si está en "on" pasará a "off" y viceversa.

‐ 3 (Multitap de triple pulso): Si se reciben tres pulsos consecutivos en la entrada el puerto de salida cambiará de valor. Si está en "on" pasará a "off" y viceversa.

‐ P (pulso) Si se recibe un pulso en la entrada (off -> on -> off) el puerto de salida cambiará de valor. Si está en "on" pasará "off" y viceversa. Equivalente a 'p' pero no compatible con múltiples pulsaciones. La ventaja sobre 'p' es su velocidad, dado que se propaga de forma inmediata.

‐ l (Pulsación larga): Regula una variable analógica según el tiempo se mantenga pulsado el pulsador.

‐ c (conmutado o cambio): Si se realiza un cambio en el puerto de entrada (on -> off, off -> on) el puerto de salida cambiará de valor independientemente de su estado actual (on, off). Si está en "on" pasará "off" y viceversa. Entrada y salida no tienen porqué tener el mismo valor

‐ r (retorno): Si el puerto de entrada cambia de valor, el puerto de salida se pone a "on" y después regresa a su estado "off", generando un pulso de unos 500ms.

‐ t (retorno en subida): Si el puerto de entrada se pone a "on", el puerto de salida se pone a "on" y después a "off", generando un pulso, igual que el enlace de tipo r.

‐ s (self, reflexivo): Si el puerto de entrada se pone a "off", el puerto de salida se pone a "on" y después a "off" (pulso). Si el puerto de entrada se pone a "on", el puerto de salida se pone a "off". Se utiliza para crear un enlace con un mismo puerto origen y destino, con el objetivo de que siempre que cambie vuelva a "off" (ej: lnk do000 do000 s).

‐ b (boot o arranque): Enlace que se aplica únicamente al reiniciar el CTRL1. Se utiliza para establecer un valor de inicialización. Por ejemplo, para que siempre que se reinicie CTRL1 un puerto do000 quede a "on" haríamos "lnk btrue do000 b". Donde btrue es un puerto virtual de tipo "per" establecido a 1.

‐ k (interlock o interbloqueo): Asocia dos puertos de manera que nunca puedan ponerse ambos a "on". En ese caso, si se intenta poner uno de los puertos a "on" el otro se pondría automáticamente a "off". Solo puede usarse en puertos digitales de salida.

‐ n (contador): Incrementará el destino en el flanco de bajada.

‐ N (contador): Incrementará el destino en el flanco de subida.

36


CTRL1

‐ o (ON): Cuando el origen cambia de valor el destino se pone a ON. ‐ f (OFF):

Cuando el origen cambia de valor el destino se pone a OFF

(*) Nota: Los puertos de entrada que participen en algún enlace de tipo p, 2 o 3 solamente podrán actuar como puertos de entrada en otros enlaces del mismo tipo p, 2 o 3 de forma indistinta.

Ejemplo de enlace (d)

Enlazamos el puerto de entrada di000 con el de salida do000, de manera que cuando cambie la entrada cambiará la salida. Es habitual para controlar una salida de CTRL1 con un interruptor.

‐ lnk di000 do000 d

El enlace inverso 'i' funciona exactamente igual, solo que cuando se pone la entrada a on, la salida se pone a off, y viceversa.

Ejemplo de enlace contador (n)

Configuramos dos puertos virtuales y los enlazamos con un enlace 'n', por lo que el contador incrementará en el flanco de bajada (cuando vt000 pase de on a off).

var vt000 var vt001 cfg vt001 a lnk vt000 vt001 n

Lo podemos probar forzando un flanco de bajada. Primero miramos su valor:

lsc vt001 vt001:AVC:VAR:VAR:+0000.0000

Forzamos dos flancos de bajada para que cuente hasta dos:

set vt000 on set vt000 off set vt000 on

set vt000 off

Verificamos que el contador ha funcionado.

lsc vt001 vt001:AVC:VAR:VAR:+0002.0000

Lo mismo puede hacerse con un contador de tipo 'N', solo que contará en el flanco de subida.

37


CTRL1

Los puertos se procesan en orden de creación y de "d", "i", "N", "n", "c", "r", "t", "l", "p", "2", "3".

ROMPER ENLACES (unl)

Elimina el enlace entre un puerto de entrada y uno de salida. Por ejemplo:

‐ unl port1 port2

LISTAR ENLACES (lln)

Lista los enlaces existentes.

‐ lln di000:water:d di001:do001:d di002:do002:d di003:do003:d di004:do004:d di005:do005:d di006:do006:p di007:do007:p

7.7 Comandos para configuración de red

Usaremos el comando "net" para configurar aspectos de la red de CTRL1.

VER PARAMETROS DE CONECTIVIDAD (net show)

Para ver los parámetros de conectividad de nuestro CTRL1 utilizaremos el siguiente comando:

‐ net show

CAMBIO DE IP (net ip)

Para cambiar la IP pasaremos una IP como parámetro al comando. Por ejemplo:

‐ net ip 192.168.1.178

CAMBIO DE MASCARA DE RED (net nm)

Para cambiar la máscara pasaremos una máscara como parámetro al comando. Por ejemplo:

‐ net nm 255.255.255.0

CAMBIO DE PUERTA DE ENLACE (net gw)

38


CTRL1

Para cambiar la puerta de enlace pasaremos una IP de puerta de enlace como parámetro al comando. Por ejemplo:

‐ net gw 192.168.1.1

CAMBIO DEL SERVIDOR NTP (net ntp)

Para cambiar el servidor NTP pasaremos una IP como parámetro al comando. Por ejemplo:

‐ net ntp 198.123.30.132

CAMBIO DEL DESTINO DE LOS EVENTOS (net ntp)

Para cambiar el destino de los eventos pasaremos una IP como parámetro al comando. Por ejemplo:

‐ net ev 192.168.1.50

Así los eventos se enviarán por UDP al puerto 1730 de la IP 192.168.1.50. Por defecto, esta dirección es la dirección de broadcast 255.255.255.255, de manera que se envía broadcast a toda la red.

Puede indicarse la IP especial 0.0.0.0 para deshabilitar el envío de paquetes de eventos.

CAMBIO DE LA MAC DEL DISPOSITIVO (net mc)

Para cambiar la dirección MAC pasaremos una mac como parámetro al comando. El dispositivo ya dispone de una dirección mac, por lo que este paso no debería ser necesario. Por ejemplo:

‐ net mc AA:BB:CC:DD:EE:FF

CAMBIO DEL PUERTO DE LOS SERVICIOS (net port)

Este comando permite cambiar el puerto de escucha de alguno de los servicios internos de CTRL1, que son los siguientes:

• webui: Para la interfaz web de usuario, que por defecto escucha en el puerto 80.

• webcf: Para la interfaz web de configuración, que por defecto escucha en el puerto 81.

• proto: Para la interfaz de comunicaciones cifradas, que por defecto escucha en el puerto 1729.

Por ejemplo, podríamos cambiar el puerto de la interfaz de usuario con:

‐ net port webui 8080

O incluso cerrar el puerto web de configuración:

‐ net port webcf 0

39


CTRL1

RESTRICCION DEL ACCESO A LOS SERVICIOS (net access)

Este comando permite controlar el acceso a los servicios por IP. Las opciones de servicios son:

• webui: Para la interfaz web de usuario.

• webcf: Para la interfaz web de configuración.

• proto: Para la interfaz de comunicaciones cifradas.

Por defecto el acceso está abierto a cualquier IP. Pero disponemos de tres opciones:

• any: Permite el acceso desde cualquier IP.

• local: Permite el acceso únicamente desde IPs locales.

• Permite especificar un IP de manera que únicamente se podrá acceder al servicio desde ella.

Por ejemplo, si queremos que se pueda acceder desde cualquier IP de internet al servicio web:

‐ net access webui any

Si queremos que al servicio de configuración solo se pueda acceder desde IPs locales, y no desde Internet:

‐ net access webcf local

Si queremos que solo puedan enviarse comandos de configuración cifrados desde una determinada IP:

‐ net access proto 192.168.1.3

Para que los cambios tengan efecto es necesario guardar la configuración y reiniciar.

7.8 Comandos para funciones de fecha y hora

CAMBIO DE FECHA (dte)

Cambia la fecha del sistema. El formato de tiempo es de cuatro dígitos para el año, dos dígitos para el mes, dos dígitos para el día, dos dígitos para la hora, dos dígitos para los minutos y dos dígitos para los segundos.

‐ dte 20120514100000

(*) Nota: al establecer la fecha del equipo se desactivará la sincronización por NTP.

CONSULTA DE FECHA (dte show)

Consulta la fecha del sistema.

‐ dte show ‐ years:02012 months:00005 days:00014 hours:00010 minutes:00000 seconds:00008, day:lun

40


CTRL1

CONFIGURACION DE FECHA POR NTP (dte ntp)

Configura la fecha por NTP. De esta manera CTRL1 irá consultando por NTP un servidor de tiempo para mantenerse sincronizado. Para que esta opción funcione correctamente debe tener la red bien configurada.

‐ dte ntp

CONFIGURACION DE ZONAS HORARIAS (dte tz)

Configura una zona horaria o un incremento/decremento en horas. Por ejemplo, si ejecutamos:

‐ dte tz CET

se configurará la zona horaria Central European Time. Lo que implica que se activará +2 en horario de verano y +1 en horario de invierno, cambiando automáticamente. Si no se soporta una zona horaria concreta, se puede configurar manualmente el incremento o decremento. Por ejemplo, podemos configurar un incremento de 3 con:

‐ dte tz +3

o un decremento de 1 con:

‐ dte tz -1

(*) Nota: Actualmente se soporta únicamente la zona horaria CET.

7.9 Comandos para funciones de seguridad (SEC)

Estos comandos permiten modificar la constraseña de la interfaz web. Tenga en cuenta que el puerto de administración 1729 no debe ser público. Si desea controlar el sistema desde Internet, hágalo mediante el protocolo de comunicación cifrado del CTRL1. Para un nivel de seguridad adicional se recomienda el uso de una pasarela de comunicación con cifrado TLS.

ESTABLECE LA CONTRASEÑA DE LA INTERFAZ WEB (sec webui)

Establece la constraseña "password" para el acceso desde a la interfaz web. - sec webui password

ESTABLECE LA CONTRASEÑA DE LA INTERFAZ WEB DE CONFIGURACION (sec webcf)

Establece la constraseña "password" para el acceso desde a la interfaz de configuración web avanzada.

‐ sec webcf password

CAMBIA EL PASSWORD DE CIFRADO (sec passw)

Mediante este comando podemos cambiar el password que se usa en las comunicaciones cifradas.

‐ sec passw password

(*) Nota: Limitado a nueve caracteres

DESHABILITA EL CIFRADO (sec proto clear)

Deshabilita el cifrado en el puerto de protocolo (por defecto 1729)

‐ sec proto clear

41


CTRL1

HABILITA EL CIFRADO (sec proto encrypter)

Habilita el cifrado en el puerto de protocolo (por defecto 1729)

‐ sec proto encrypted

MUESTRA EL ESTADO DEL PROTOCOLO (sec proto show)

Muestra si el protocolo está cifrado "encrypted" o no "clear".

‐ sec proto show

7.10 Códigos de error

En este punto se enumeran los códigos de error obtenidos como respuesta a los CTRL1, ya sea mediante la línea de comandos o cualquier otra herramienta que los utilice.

E001. Comando desconocido.

El último código introducido es inválido o no está soportado. Este error puede producirse cuando el comando ha sido mal introducido, o si la versión que está empleando no dispone de la funcionalidad solicitada.

E002. Error de formato de comando o comando incorrecto.

E022. No se ha podido guardar la configuración.

E030. Cadena de fecha de longitud incorrecta.

E040. Contraseña bloqueada.

E041. Longitud de cadena excesiva.

E042. Longitud de cadena incorrecta.

E050 - E069. Puerto o tipo de puerto inválido.

E070. El puerto no existe.

E071. El puerto es una entrada.

E072. El puerto virtual no existe.

E073. El valor debe ser "on" o "off".

E101. Parámetros de configuración incorrectos.

E102. Puerto no válido.

E103. No es un puerto virtual.

E104. No es un puerto modificable.

E106. Valor fuera de rango.

E107. Se requiere un puerto de salida o un puerto virtual.

42


CTRL1

E306. Tipo de enlace inválido. Debe especificar el tipo de enlace a usar.

E501. Alguno de los puertos no existe.

E530. Al exportar un trigger, exporta la salida como un valor analógico 00000 o 00001 en vez de un OFF o ON. Ejemplo: Uncontador.

E601. El puerto indicado no es un puerto analógico válido.Asegúrese que el puerto pasado como parámetro es del tipo esperado por el último comando.

E701. Parámetros de entrada Modbus inválidos.

E703. Dirección de dispositivo Modbus inválida. Opciones válidas: 0~247.

E203. El tipo de grupo no existe.

E301. No existe el nombre de puerto especificado o el nombre ya está siendo utilizado por otro puerto.

E303. Solo en enlaces tipo k: Se ha indicado algún puerto inválido, solo se aceptan entradas y salidas digitales.

E704. Número de baudios inválido o no soportado. Opciones disponibles: 1200, 2400, 4800, 9600, 19200, 38400, 57600 y115200.

E705. Tipo de paridad inválida. Opciones disponibles: n, e y o. (None, Even y Odd).

E706. Número de bits de parada inválido. Opciones disponibles: 1 y 2.

E707. Número de función Modbus inválida o no soportada. Opciones disponibles: 2, 3, 4, 5 y 6.

E708. Tipo de datos Modbus inválido.

E709. El puerto virtual no es de tipo Modbus.

E900. Error de cifrado.Posiblemente esté intentando enviar comandos sin el protocolo de cifrado. Para poder enviar comandos directamente,tendrá que deshabilitar el sistema de cifrado.

8. Modo simulación

En el CTRL1, es posible utilizar un modo de simulación para poder manipular desde la línea de comandos las entradas digitales y analógicas del dispositivo mientras que se evita que al activarse las salidas se actué sobre los relés o dispositivos conectados a las salidas del ODC.

En este modo, una vez activado, es posible indicarle al CTRL1 que su entrada digital 1 (di001) está en ON con el comando SET sin necesidad de que el dispositivo este conectado a ningún interruptor, pulsador o sensor físico real. De la misma forma se puede fijar un valor en un puerto de entrada analógico con el comando SET. El CTRL1 lo tomará como si lo hubiera recibido por el puerto analógico real. Hay que tener en cuenta que si no está el modo simulación activo estas acciones devuelven el código de error 104.

Este modo además es muy útil para evitar posibles incidentes debido a malas configuraciones o programaciones en los dispositivos donde actúa el CTRL1 ya que mientras esta activo el valor de las salidas no tiene un efecto real. Es decir, se aprecia en la pantalla, en los resultados de un “lst do001” pero no se activará el relé, válvula o actuador final al que está conectado.

En el modo simulación si se enviarán los comandos a CTRL1 remotos, por lo que si estos no están en simulación actuaran de forma normal.

43


CTRL1

8.1 Activar el modo de simulación

Para activar el modo de simulación debe enviarse el siguiente comando:

‐ dbg sim-on

En el momento que está activado el modo simulación aparece en el pie del webGUI indicado Archivo: WebGUI sim on.png Para desactivarlo hay que enviar el contra comando:

‐ dgb sim-off

Ejemplo:

Indicar un puerto de entrada como si se hubiera puesto a ON un interruptor.

‐ set di001 ON

Indicar que el valor de un sensor de temperatura es 35.

‐ set ai001 35

Este modo es muy útil para verificar el funcionamiento lógico de las plantillas sin necesidad de tener el CTRL1 instalado en su ubicación final. Permitiendo más flexibilidad. Siendo muy útil para asegurarse antes de instalarlo en entornos donde no haya despues ya conexión de red y el dispositivo funcione de forma aislada y autónoma.

Mientras el CTRL1 este en modo simulación no actualizará la hora por NTP. Esto puede ayudar a la hora de cargar en el sistema plantillas complejas y evitar cortes en la carga. No tiene ningún otro efecto sobre las configuraciones del CTRL por lo que no afecta en ningún modo a los puertos virtuales, enlaces o grupos que existan definidos en el aparato.

autómata programable chintcontrol ctrl1€¦ · 2.6. puerto de comunicaciones ethernet ctrl1 está...

Documents