Diferencia entre revisiones de «KiParameters»

Revisión del 08:19 3 nov 2022

kiParameters es una herramienta de escritorio para Windows que facilita la configuración de dispositivos Modbus de forma local o remota (aprovechando la potencia de las librerías kiconex).

Gestión de sesión

Para utilizar las funcionalidades que necesitan conexión con la plataforma mykiconex, deberá iniciar sesión con su nombre de usuario y contraseña. En el momento del arranque, kiParameters comprobará si hay una sesión activa. Si es positivo, se conectará automáticamente, de lo contrario, mostrará la siguiente ventana emergente. Si quiere utilizar las funcionalidades online, ponga sus credenciales y haga clic en el botón "Log in". También puedes marcar la casilla "Recúerdeme" para conservar la información para otras sesiones.

Si quieres utilizar el programa en modo offline, haz clic en el botón "Modo offline". Si quieres que el programa no te pida que te conectes permanentemente, selecciona la casilla "No volver a preguntar".

Ventana emergente de inicio de sesión para entrar en modo offline

Una vez que la sesión es (o no), usted tendrá el cuadro de información en la esquina superior derecha:

Cuando sea necesario un cambio en la sesión, vaya al menú superior y haga clic en Sesión.

Para cerrar la sesión y activar el modo offline, pulse en Cerrar sesión. Si desea iniciar la sesión con otro usuario, pulse en Iniciar sesión y el programa cerrará la sesión actual y se volverá a mostrar la ventana emergente.

Mapa de parámetros

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

Esta configuración podría descargarse para su modificación en un editor de hojas de cálculo y subirse de nuevo a la plataforma, permitiendo la modificación de configuraciones de forma remota o incluso la generación y restablecimiento de configuraciones de fábrica, aunque por sí mismo tiene dos inconvenientes:

Si modificamos un parámetro con metadatos, debemos conocer primero los valores que corresponden a las diferentes opciones.
No podemos cargar esa configuración a un mando que tengamos conectado directamente a nuestra red o a nuestro ordenador con un conversor USB/RS-485. Dependemos de un kibox o debemos hacerlo a mano en la máquina, parámetro a parámetro.

kiParameters pretende colmar estas lagunas haciendo el proceso más automático y sencillo.

Al cargar/leer un mapa de parámetros el resultado se mostrará como 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 realizar el cambio.
Las celdas en color azul son parámetros con opciones, haz clic sobre ellas para mostrar la lista y selecciona el valor al que quieres cambiarlo.
Las celdas en color rojo son parámetros que están fuera de rango.

Cuando realice un cambio en una celda, si está dentro del rango establecido en las columnas valormáximo y valormínimo, se volverá verde' lo que significa que la celda del valor ha cambiado correctamente.

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).

Cargar un mapa

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

Botón para leer un mapa de parámetros — 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.

Guardar un mapa

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

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.

Leer un mapa desde un control

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

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

Leer un mapa localmente

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”.

Leer un mapa a través de 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.

Escribir un mapa

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.

Escribir un mapa localmente

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:

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.
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).

Escribir un mapa a través de 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.

Exportar mapa a 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”.

Borrar mapa

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

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

Gestión de librerías

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.

Reporte de bugs

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:

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

@@ Línea 5: / Línea 5: @@
 kiParameters es una herramienta de escritorio para Windows que facilita la configuración de dispositivos Modbus de forma local o remota (aprovechando la potencia de las librerías kiconex).
-== Session management == <!--T:2-->
+== Gestión de sesión == <!--T:2-->
 Para utilizar las funcionalidades que necesitan conexión con la plataforma mykiconex, deberá iniciar sesión con su nombre de usuario y contraseña. En el momento del arranque, kiParameters comprobará si hay una sesión activa. Si es positivo, se conectará automáticamente, de lo contrario, mostrará la siguiente ventana emergente. Si quiere utilizar las funcionalidades online, ponga sus credenciales y haga clic en el botón '''''"Log in"'''''. También puedes marcar la casilla '''''"Recúerdeme"''''' para conservar la información para otras sesiones.
 [[Archivo:KiParameters - LogIn.png|centro|miniaturadeimagen|374x374px|Log in and save session]]
@@ Línea 19: / Línea 19: @@
 Para cerrar la sesión y activar el modo offline, pulse en Cerrar sesión. Si desea iniciar la sesión con otro usuario, pulse en Iniciar sesión y el programa cerrará la sesión actual y se volverá a mostrar la ventana emergente.
-== Parameter map == <!--T:3-->
+== Mapa de parámetros == <!--T:3-->
-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.
+Cuando hablamos de mapas de parámetros nos referimos a una configuración de funcionamiento aplicada a un control. Por ejemplo, en [[MainInterphase]] podemos consultar y modificar el mapa de parámetros mediante la pestaña "Parámetros".
 <!--T:4-->
-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:
+Esta configuración podría descargarse para su modificación en un editor de hojas de cálculo y subirse de nuevo a la plataforma, permitiendo la modificación de configuraciones de forma remota o incluso la generación y restablecimiento de configuraciones de fábrica, aunque por sí mismo tiene dos inconvenientes:
 <!--T:5-->
-# If we modify a parameter with metadata, we must first know the values that correspond to the different options.
+# Si modificamos un parámetro con metadatos, debemos conocer primero los valores que corresponden a las diferentes opciones.
-# 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.
+# No podemos cargar esa configuración a un mando que tengamos conectado directamente a nuestra red o a nuestro ordenador con un conversor USB/RS-485. Dependemos de un kibox o debemos hacerlo a mano en la máquina, parámetro a parámetro.
 <!--T:6-->
-kiParameters aims to fill these gaps by making the process more automatic and simple.
+kiParameters pretende colmar estas lagunas haciendo el proceso más automático y sencillo.
 <!--T:7-->
-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.
+Al cargar/leer un mapa de parámetros el resultado se mostrará como una tabla con los valores leídos del archivo o control, donde la única columna editable es la columna '''''label'''''.
 [[Archivo:KiParameters - Mapa de parametros.png|alt=Mapa de parámetros|centro|miniaturadeimagen|1022x1022px]]
 <!--T:8-->
-* The cells in '''white''' color are parameters with numerical values, double click on them to edit them and press Enter to make the change.
+* Las celdas en color '''blanco''' son parámetros con valores numéricos, haga doble clic sobre ellos para editarlos y pulse Enter para realizar el cambio.
-* 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.
+* Las celdas en color '''azul''' son parámetros con opciones, haz clic sobre ellas para mostrar la lista y selecciona el valor al que quieres cambiarlo.
-* Cells in red '''color''' are parameters that are out of range.
+* Las celdas en color '''rojo''' son parámetros que están fuera de rango.
 <!--T:9-->
-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.
+Cuando realice un cambio en una celda, si está dentro del rango establecido en las columnas valormáximo y valormínimo, se volverá '''verde'''' lo que significa que la celda del valor ha cambiado correctamente.
 <!--T:10-->
@@ Línea 48: / Línea 48: @@
 [[Archivo:KiParameters - Mapa ordenar.png|alt=Ordenar columna mapa|centro|miniaturadeimagen|350x350px]]
-=== Load a map === <!--T:11-->
+=== Cargar un mapa === <!--T:11-->
 <!--T:12-->
@@ Línea 63: / Línea 63: @@
 '''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 [https://wiki.kiconex.com/index.php?title=KiParameters#Librer%C3%ADas Librerias].'''
-=== Save a map === <!--T:16-->
+=== Guardar un mapa === <!--T:16-->
 <!--T:17-->
@@ Línea 70: / Línea 70: @@
 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 === <!--T:18-->
+=== Leer un mapa desde un control === <!--T:18-->
 <!--T:19-->
@@ Línea 76: / Línea 76: @@
 [[Archivo:Read map.png|alt=Botón para leer un mapa|Botón de lectura de mapa de parámetros desde un dispositivo.|centro|marco]]
-==== Read a map locally ==== <!--T:20-->
+==== Leer un mapa localmente ==== <!--T:20-->
 <!--T:21-->
@@ Línea 87: / Línea 87: @@
 Continúe seleccionando una librería de entre las que tenga descargadas. (para descargar una librería, consulte el apartado '''[https://wiki.kiconex.com/index.php?title=KiParameters#Librer%C3%ADas Librerias]''' y pulse en “'''''Leer dispositivo'''''”.
-==== Read a map through kiconex ==== <!--T:23-->
+==== Leer un mapa a través de kiconex ==== <!--T:23-->
 <!--T:24-->
@@ Línea 99: / Línea 99: @@
 [[Archivo:KiParameters - Lectura local kiconex.png|Ventana emergente para la lectura local del mapa de parámetros utilizando mykiconex.|centro|marco]]
-=== Write a map=== <!--T:27-->
+=== Escribir un mapa === <!--T:27-->
 <!--T:28-->
@@ Línea 105: / Línea 105: @@
 [[Archivo:KiParameters - Escribir mapa.png|Botón de escritura de mapa de parámetros a un dispositivo.|centro|marco]]
-==== Write a map locally ==== <!--T:29-->
+==== Escribir un mapa localmente ==== <!--T:29-->
 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:
@@ Línea 111: / Línea 111: @@
 #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 ==== <!--T:30-->
+==== Escribir un mapa a través de kiconex ==== <!--T:30-->
 <!--T:31-->
 '''''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 === <!--T:32-->
+=== Exportar mapa a PDF === <!--T:32-->
 [[Archivo:KiParameters - PDF.png|alt=Botón para exportar mapa a PDF|Botón para exportar el mapa de parámetros en PDF.|centro|marco]]
 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'''''”.
@@ Línea 123: / Línea 124: @@
 Se abrirá un diálogo para elegir el destino y nombre del archivo, pulse en “'''''Guardar'''''”.
-=== Clear the map === <!--T:34-->
+=== Borrar mapa === <!--T:34-->
 [[Archivo:KiParameters - Borrar mapa.png|alt=Botón para cerrar el mapa|Botón para eliminar el mapa de parámetros activo|centro|marco]]Reinicie la vista del programa haciendo clic en el botón “'''''Cerrar mapa'''''”
-== Library management ==
+== Gestión de librerías ==
 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.
@@ Línea 170: / Línea 172: @@
 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 == <!--T:48-->
+== Reporte de bugs == <!--T:48-->
 Para comunicar al equipo de kiconex problemas o sugerencias para el programa, envíen un mensaje a [mailto:support@kiconex.com nuestro equipo de Soporte] o generen una petición en [https://support.kiconex.com nuestra plataforma de soporte].