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 information for other sessions.

Log in and save session

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

When we talk about parameter maps we refer to an operating configuration applied to a control. For example, in MainInterphase we can consult and modify the parameter map using the "Parameters" tab.

This configuration could be downloaded for modification in a spreadsheet editor and uploaded back to the platform, allowing the modification of configurations remotely or even the generation and resetting of factory configurations, although by its own it has two drawbacks:

1. If we modify a parameter with metadata, we must first know the values that correspond to the different options.
2. We cannot load that configuration to a control that we have directly connected to our network or to our computer with a USB/RS-485 converter. We rely on a kibox or should do it by hand into the machine, parameter by parameter.

kiParameters aims to fill these gaps by making the process more automatic and simple.

When loading/reading a parameter map the result will be displayed as a table with the values read from the file or control, where the only editable column is the label column.

• The cells in white color are parameters with numerical values, double click on them to edit them and press Enter to make the change.
• The cells in blue color are parameters with options, click on them to display the list and select the value you want to change them to.
• Cells in red color are parameters that are out of range.

When you make a change in a cell, if it is within the range set in the maxvalue and minvalue columns, it will turn green which means that the cell of the value has correctly changed.

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.