KiParameters

kiParameters is a desktop tool for Windows that eases the configuration of Modbus devices locally or remotely (taking advantages of the power of the kiconex libraries).

Session management

To use the functionalities that need connection with the mykiconex platform, you will need to log in with your username and password. At boot time, kiParameters will check if theres an active session. If positive it will log in automatically, otherwise, it will show the following pop-up window:

If you want to use the online functionalities, put your credentials and click the "Log in" button. You can also check de "Remember me" box to keep the info for other sessions.

In case you want to use the program in offline mode, click the "Offline mode" button. If you want the program to not ask you for log in permanently, select the "Don't ask again" box.

Once the session is (or not), you will have the information box in the upper-right corner:

• 
• 

When a change in the session is needed, go to the top menu and click in Session.

To log out and activate the offline mode, click in Log out. If you want to log in with other user, click in Log in and the program will close the current session and the popup will be shown again.

Parameter map

Cuando hablamos de mapas de parámetros nos referimos a una configuración de funcionamiento aplicada a un control. Por ejemplo, en mykiconex podemos consultar y modificar el mapa de parámetros utilizando la pestaña “Parámetros”.

Esta configuración se podría descargar para su modificación en un editor de hojas de cálculo y volverla a cargar a plataforma, lo que permite la modificación de configuraciones remotamente o incluso la generación y restablecimiento de configuraciones de fábrica, aunque tiene dos inconvenientes:

1. Si modificamos un parámetro con metadatos, debemos de saber previamente los valores que corresponden a las distintas opciones.
2. No podemos cargar esa configuración a un control que tengamos conectado directamente en nuestra red o a nuestro ordenador con un conversor USB/RS-485. Deberíamos hacerlo a mano, parámetro por parámetro.

kiParameters pretende cubrir dichas carencias haciendo el proceso más automático y sencillo.

Cuando carguemos/leamos un mapa de parámetros el resultado se mostrará en forma de una tabla con los valores leídos del archivo o control, donde la única columna editable es la columna label.

Las celdas en color blanco son parámetros con valores numéricos, haga doble clic sobre ellos para editarlos y pulse Enter para efectuar el cambio.

Las celdas en color azul son parámetros con opciones, haga clic sobre ellos para desplegar la lista y seleccione el valor al que quiera cambiarlos.

Las celdas en color rojo son parámetros que están fuera de rango.

Cuando efectúe un cambio sobre una celda, si esta está dentro del rango establecido en las columnas maxvalue y minvalue, se pondrá en verde, en caso contrario en rojo.

Inicialmente, el mapa viene ordenado alfabéticamente, primero por la categoría y, dentro de esta, por el nombre del parámetro. Aun así, es posible ordenar el mapa haciendo clic derecho en el nombre de una columna y seleccionando el orden ascendente o descendente (se recomienda no utilizar ninguna de las otras opciones).

Load a map

Para cargar un mapa a partir de un archivo de mapa de parámetros, basta con pulsar en "Cargar mapa".

Botón de carga de mapa de parámetros desde un archivo.

Se abrirá un diálogo para seleccionar el archivo. Una vez localizado, pulse "Abrir".

Inicialmente, kiParameters buscará la librería correspondiente al mapa entre las que se encuentren descargadas y, si no la encuentra y dispone de conexión, entre las que se encuentras alojadas en la plataforma mykiconex.

Para una operación lo más eficiente posible, descargue o importe previamente las librerías que utilice con más frecuencia. Vea cómo hacerlo en el apartado Librerias.

Save a map

Una vez cargado y modificado un mapa, podrá generar un archivo de hoja de cálculo pulsando en “Guardar mapa”.

Botón de guardado de mapa de parámetros a un archivo.

Ese archivo podrá volver a cargarlo a kiParameters para modificarlo de nuevo, o subirlo a mykiconex para aplicar la configuración a una instalación remota.

Read a map from a control

Pulse en “Leer dispositivo” para cargar un mapa de parámetros a partir de un dispositivo, no de un archivo.

Botón de lectura de mapa de parámetros desde un dispositivo.

Read a map locally

Seleccione la opción “Local” y la modalidad Modbus en la que quiere realizar la lectura (Modbus RTU o Modbus TCP). Deberá de rellenar la configuración de la comunicación para continuar:

• Si selecciona "RTU", elija el puerto serie (consulte cual es el correcto en “Administrador de dispositivos” de Windows), la dirección Modbus del control, la velocidad, el tamaño del mensaje, el tipo de paridad y el número de bits de parada.

Ventana emergente para la lectura local del mapa de parámetros utilizando Modbus TCP.

• Si selecciona "TCP", incluya la dirección IP y puerto.

Continúe seleccionando una librería de entre las que tenga descargadas. (para descargar una librería, consulte el apartado Librerias y pulse en “Leer dispositivo”.

Read a map through kiconex

Esta opción permite cargar un mapa de parámetros sin necesidad de descargar una hoja de cálculo desde mykiconex.

Seleccione “kiconex” y haga clic en la entrada de instalaciones, aparecerá un listado con todas la instalaciones a las que tiene acceso el usuario, seleccione la deseada.

Haga clic en la entrada de controles y, de igual modo, seleccione del listado el control del que quiere leer el mapa de parámetros y pulse el botón “Leer dispositivo”.

Ventana emergente para la lectura local del mapa de parámetros utilizando mykiconex.

Write a map

Para enviar un mapa de parámetros a un control, deberá de cargar o leer un mapa de parámetros y pulsa el botón “Escribir dispositivo”.

Botón de escritura de mapa de parámetros a un dispositivo.

Write a map locally

Al igual que en la funcionalidad de lectura del mapa, seleccione la modalidad Modbus en la que quiere realizar la lectura (Modbus RTU o Modbus TCP). Deberá de rellenar la configuración de la comunicación para continuar:

1. Si selecciona RTU, elija el puerto serie (consulte cual es el correcto en “Administrador de dispositivos” de Windows), la dirección Modbus del control, la velocidad, el tamaño del mensaje, el tipo de paridad y el número de bits de parada.

   

   Ventana emergente para la escritura local del mapa de parámetros utilizando Modbus RTU.

2. Si selecciona TCP, incluya la dirección IP y puerto.

Tendrá la posibilidad de enviar todos los parámetros o sólo los sobre los que se han hecho cambios (las celdas en verde).

Write a map through kiconex

Lamentablemente esta opción no esta disponible actualmente, aunque puede guardar el mapa y subirlo al control remotamente utilizando mykiconex y su funcionalidad de importación de parámetros.

Export the map to PDF

Botón para exportar el mapa de parámetros en PDF.

Es posible generar un archivo de texto PDF con el mapa de parámetros. Una vez haya cargado un mapa, pulse en “Exportar a PDF”.

Se abrirá un diálogo para elegir el destino y nombre del archivo, pulse en “Guardar”.

Clear the map

Botón para eliminar el mapa de parámetros activo

Reinicie la vista del programa haciendo clic en el botón “Cerrar mapa”

Library management

En la pestaña “Librerías” se realiza la gestión de librerías de kiconex que están cargadas en la aplicación kiParameters.

Si tiene una sesión de kiconex activa y acceso a las librerías, podrá ver el listado de las librerías que hay disponibles en kiconex a la derecha. En caso contrario, esta estará deshabilitada. Podrá descargarlas seleccionándolas y pulsando el botón de descarga. Aparecerá en el listado de la derecha cuando la descarga finalice.

En este listado aparecen las librerías que kiParameters tiene disponibles. Los botones de la derecha se utilizan para gestionarlas, entre los que destacan los de exportación (genera un archivo en formato JSON con todos los datos de la librería) y el de importación (que admite dicho tipo de archivos y lo incluye en kiParameters).

Las librerías que estén descargadas serán las que estén disponibles para la lectura y carga de mapa de parámetros.

Test Modbus

Esta pestaña, como su propio nombre indica, se utiliza para realizar peticiones Modbus, ya sea local o remotamente. Primero, deberá de configurar los parámetros de comunicación:

• En caso de conectarse de forma local:
  • RTU: puerto (consulte el correcto en “Administrador de dispositivos”), dirección Modbus, velocidad, bits de datos, tipo de paridad y número de bits de parada.

• TCP: dirección IP y puerto.

• A través de kiconex, seleccione la instalación y para:
  • RTU: El índice del puerto y la dirección Modbus.

• TCP: dirección IP y puerto.

Después, configure la petición: registro Modbus donde se inicia la consulta, número de registros a consultar y función Modbus que se utilizará. En caso de que la función sea de escritura, se habilitará el campo “Valor” para indicar el valor a escribir.

Una vez lista la petición, pulse en enviar, si todo ha ido bien se mostrará la respuesta en distintos formatos. En caso contrario, se mostrará que ha habido un error en la lectura. Esta funcionalidad replica a la funcionalidad de Informes de mykiconex, para poder exportar en hojas de cálculo los datos recogidos y guardados en la plataforma. Seleccione el rango de tiempo que desea consultar.

Seleccione instalación, control y añada las variables de las que quiere obtener datos. Podrá seleccionar varias a la vez e incluso varias de distintos controles e instalaciones, pero no de distintos rangos temporales.

Las variables añadidas aparecerán en la tabla inferior, podrá seleccionar y eliminar en caso de equivocación o exportar los datos. Aparecerá un dialogo para localizar y nombrar el archivo.

En esta pestaña se podrá modificar la configuración por defecto de las comunicaciones Modbus. La configuración que guarde será la que aparecerá en los pop-ups de la pestaña Mapa o en la pestaña de Test Modbus.

Bug report

Para comunicar al equipo de kiconex problemas o sugerencias para el programa, envíen un mensaje a nuestro equipo de Soporte o generen una petición en nuestra plataforma de soporte.

Incluyan lo siguiente en el mensaje:

1. Pestaña donde ocurrió.
2. Pasos que se hicieron para generar el error (si es posible).
3. Si se utilizó alguna funcionalidad de mykiconex, indiquen librería o instalación y control.
4. Captura de la ventana de terminal que se abre cuando se ejecuta el programa.