Diferencia entre revisiones de «KiWi»

De wiki-test.kiconex
mSin resumen de edición
Reestructuración y mejora completa de la documentación de KiWi (via update-page on MediaWiki MCP Server)
 
(No se muestran 46 ediciones intermedias de 5 usuarios)
Línea 1: Línea 1:
<translate>
<translate>
= kiWi =
= kiWi =
kiWi (o '''ki'''conex '''wi'''reless) es nuestra solución para transformar controles con comunicación modbus RTU a comunicación modbus TCP/IP. Esta comunicación permite conectar dispositivos de manera inalámbrica a la red ethernet local de la instalación donde se ubica el ''kiBox'' principal.
 
'''kiWi''' (''kiconex wireless'') es la solución de kiconex para convertir una comunicación '''Modbus RTU por RS-485''' en una comunicación '''Modbus TCP/IP''' a través de red local, ya sea por '''WiFi''' o por '''Ethernet'''.
 
Su función principal es permitir que uno o varios controles Modbus RTU puedan comunicarse con el ''kiBox'' principal sin necesidad de llevar el bus RS-485 físico hasta la ubicación del equipo. Para ello, el ''kiWi'' actúa como pasarela entre el puerto RS-485 del control y la red IP de la instalación.
 
Información sobre [[KiWi2023|versión kiWi 2023]].
 
__TOC__
__TOC__
=== Descripción de la solución kiWi ===
En una instalación convencional con comunicación Modbus RTU, todos los dispositivos se tienen que cablear directamente al maestro modbus (''kiBox'') utilizando un cable apantallado de 2 hilos. Dicha conexión se realiza mediante tipología de conexión daisy-chain. Se puede ver más en detalle en este [[ModbusRTU-RS485|enlace]].


La solución ''KiWi'' permite transformar la comunicación modbus RTU a una conexión inalámbrica modbus TCP/IP. De esta forma, se puede aprovechar la red WiFi local de la instalación para conectar los diferentes controles-dispositivos. Además, debido a que el dispositivo ''KiWi'' dispone también de un puerto RJ45, éste se puede conectar también a la red ethernet local mediante cable ethernet por el conector RJ45.
== Descripción general ==
Ejemplo de una instalación convencional con comunicación Modbus RTU:
 
[[Archivo:SP - ESQUEMA RS-485 SIMPLE.jpg|centro|miniaturadeimagen|800x800px|Esquema RS-485 simple]]
En una instalación convencional con comunicación Modbus RTU, los dispositivos se cablean directamente al maestro Modbus, normalmente el ''kiBox'', utilizando un cable apantallado de dos hilos. Esta conexión se realiza habitualmente mediante tipología ''daisy-chain'' o bus RS-485. Puede ampliarse información en [[ModbusRTU-RS485|Modbus RTU / RS-485]].
Ejemplo de una instalación a través de Modbus RTU haciendo uso del ''KiWi:''
 
[[Archivo:SP - ESQUEMA CONEXIONES KIWI.jpg|centro|miniaturadeimagen|800x800px|Esquema de conexionado kiWi]]
[[Archivo:Instalacion rj45 rs485.png|centro|miniaturadeimagen|392x392px|Esquema RS-485 simple]]
Cabe destacar que en un ''kiWi'' se pueden conectar hasta un máximo de dos equipos y la condiciones que deben cumplir son:
 
La solución ''kiWi'' permite sustituir parte de ese cableado por una conexión de red. El equipo se conecta al control mediante RS-485 y, a su vez, se comunica con la red local mediante WiFi o cable Ethernet. De esta forma, el ''kiBox'' puede acceder al equipo Modbus como si se tratase de un dispositivo Modbus TCP/IP dentro de la misma red.
 
[[Archivo:Instalación kiwi.png|centro|miniaturadeimagen|392x392px|Esquema de conexionado kiWi]]
 
El uso de ''kiWi'' resulta especialmente útil cuando no es viable instalar nuevo cableado RS-485 hasta el ''kiBox'', cuando los controles se encuentran alejados o cuando se quiere aprovechar una red local existente.
 
'''Importante:''' un ''kiWi'' está diseñado para trabajar con una cantidad reducida de equipos. Como criterio general, no se recomienda superar los '''800 parámetros''' entre todos los dispositivos conectados al mismo ''kiWi''.
 
== Función dentro de la instalación ==


* No exceder de los 800 parámetros entre los dos dispositivos.
El ''kiWi'' no sustituye al ''kiBox'' ni actúa como plataforma de supervisión. Su papel es exclusivamente de pasarela de comunicación:
* Poder trabajar con la velocidad 9600bps.


=== Características técnicas ===
{| class="wikitable"
{| class="wikitable"
|+
! Elemento
| colspan="2" |'''RED'''
! Función
|-
| Control o dispositivo Modbus
| Equipo de campo que comunica mediante Modbus RTU por RS-485.
|-
| ''kiWi''
| Convierte la comunicación Modbus RTU del equipo en comunicación Modbus TCP/IP.
|-
|-
|WiFi
| Red local
|IEEE 802.11 b/g/n  2.4GHz RF
| Medio de comunicación entre el ''kiWi'' y el ''kiBox'', mediante WiFi o Ethernet.
|-
|-
|Ethernet
| ''kiBox''
| Maestro Modbus TCP/IP que consulta los registros del equipo a través del ''kiWi''.
|}


== Características técnicas ==


|1xETH
{| class="wikitable"
|+
| colspan="2" |'''Red'''
|-
| WiFi
| IEEE 802.11 b/g/n 2.4 GHz RF
|-
| Ethernet
| 1 x ETH
|-
|-
| colspan="2" |'''Modbus'''
| colspan="2" |'''Modbus'''
|-
|-
|Protocolos Modbus
| Protocolos Modbus
|Modbus TCP via WiFi o ETH/ Modbus RTU via puerto RS485
| Modbus TCP mediante WiFi o Ethernet / Modbus RTU mediante puerto RS-485
|-
|-
|Baudrates
| Baudrates soportados
|9600
| 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600 y 115200
|-
|-
|Bits de datos
| Bits de datos
|8
| 8
|-
|-
|Bits de parada
| Bits de parada
|1
| 7 u 8
|-
|-
|Paridad
| Paridad
|Ninguna
| Ninguna, par o impar
|-
|-
|Duplex
| Dúplex
|Half-Duplex
| Half-Duplex
|-
|-
|Formatos de datos soportados
| Formatos de datos soportados
|8 bit: INT, UINT; 16 bit: INT, UINT (MSB o LSB); 32 bit: float, INT, UINT (ABCD (big-endian), DCBA (little-endian), CDAB, BADC)
| 8 bit: INT, UINT; 16 bit: INT, UINT (MSB o LSB); 32 bit: float, INT, UINT (ABCD big-endian, DCBA little-endian, CDAB, BADC)
|-
|-
| colspan="2" |'''Sistema'''
| colspan="2" |'''Sistema'''
|-
|-
|CPU
| CPU
|Dual core Tensilica LX6 microcontroller with 600 DMIPS and 240MHz
| Dual core Tensilica LX6 microcontroller with 600 DMIPS and 240 MHz
 
(360 MHz)
|-
|-
|RAM
| RAM
|520 KiB
| 520 KiB
|-
|-
|Memoria FLASH
| Memoria FLASH
|4 MB
| 4 MB
|-
|-
| colspan="2" |'''Alimentación'''
| colspan="2" |'''Alimentación'''
|-
|-
|Conector
| Conector
|Conector micro-USB
| Micro-USB
 
|-
|-
|Voltaje de alimentación
| Voltaje de alimentación
|5 VDC
| 5 VDC
|-
|-
|Consumo de potencia
| Consumo de potencia
|< 5 W
| < 5 W
|-
|-
| colspan="2" |'''Temperatura'''
| colspan="2" |'''Temperatura'''
|-
|-
|Rango de temperatura
| Rango de temperatura
|<nowiki>-40ºC a 125ºC</nowiki>
| <nowiki>-40 ºC a 125 ºC</nowiki>
|-
|-
| colspan="2" |'''Material'''
| colspan="2" |'''Material'''
|-
|-
|Material
| Material
|Carcasa de impresa en 3D con PLA
| Carcasa impresa en 3D con PLA
|-
| Dimensiones
| 13.64 mm x 3.30 mm x 2.95 mm (largo x ancho x alto)
|-
| Peso
| 100 g
|}
 
== Configuración por defecto ==
 
Cuando el equipo está sin configurar o no consigue conectarse a la red configurada, genera su propio punto de acceso WiFi para poder acceder al portal de configuración.
 
{| class="wikitable"
! Parámetro
! Valor por defecto
|-
|-
|Dimensiones
| SSID WiFi
|95x30mm
| '''KIWI_XXXXXX'''
|-
|-
|Peso
| Contraseña WiFi
|100 g
| '''12345678'''
|-
| IP del portal de configuración
| '''192.168.4.1'''
|-
| Contraseña del portal
| '''00#Kiconex'''
|}
|}


=== Configuración del ''KiWi'' ===
== Conexión física ==
Configuración por defecto:


* WiFi: '''KIWI_XXXXXX'''
=== Partes del ''kiWi'' ===
* WiFi Password: '''12345678'''
* IP portal de configuración: '''192.168.4.1'''
* Contraseña portal: '''12345678'''


==== Conexión Puerto RS485 ====
[[Archivo:Esquema kiwi.png|centro|miniaturadeimagen|370x370px|Partes de un kiWi]]


===== Partes de ''KiWi'' =====
# Puerto RS-485
[[Archivo:Partes de un KiWi.jpg|centro|marco|Partes de un KiWi]]
# Alimentación 5 V
# Puerto RS485
# Indicador luminoso ON/OFF
# Alimentación 5V
# Puerto Ethernet
# Luz indicador ON/OFF
# Puerto ethernet
# Botón de reset
# Botón de reset


===== Puerto RS485 =====
=== Puerto RS-485 ===
[[Archivo:SP - Bornas enumeradas.png|centro|marco|Numeración de las bornas en un KiWi]]
 
[[Archivo:SP - Bornas enumeradas.png|centro|marco|Numeración de las bornas en un kiWi]]
 
{| class="wikitable"
{| class="wikitable"
|+
! PIN
!PIN
! Uso
!USO
|-
|-
|1
| 1
|No usado
| No usado
|-
|-
|2
| 2
|No usado
| No usado
|-
|-
|3
| 3
|A (+)
| A (+)
|-
|-
|4
| 4
|B (-)
| B (-)
|}
|}


==== Antes de empezar ====
== Información necesaria antes de configurar ==
 
Antes de acceder al portal de configuración es recomendable recopilar los datos de red y comunicación Modbus que se van a utilizar.
 
=== Datos de red ===
 
* SSID de la red WiFi, si la conexión será inalámbrica.
* Contraseña de la red WiFi.
* IP libre que se asignará al ''kiWi''.
* Puerta de enlace.
* Máscara de red.
* DNS 1 y DNS 2.
 
=== Datos Modbus del equipo conectado ===


===== Parámetros de configuración =====
* Dirección Modbus del equipo o equipos conectados al bus RS-485.
* Baudrate.
* Bits de datos.
* Paridad.
* Bits de parada.
* Puerto TCP que utilizará el ''kiWi''.
* Número aproximado de variables o parámetros que se van a consultar.


* SSID de la red WiFi
== Notas de funcionamiento ==
* Contraseña de la red WiFi
* IP libre para el kiwi
* Puerta de enlace
* Máscara de red
* DNS1 y DNS2


===== Notas de funcionamiento =====
El ''kiWi'' crea una red WiFi propia, del tipo '''KIWI_XXXXXX''', en los siguientes casos:
''KiWi'' crea una red WiFi propia, del tipo KIWI_58AEB3J2, en los siguientes casos:


* No configurado
* El equipo todavía no ha sido configurado.
* Configuración errónea
* La configuración guardada es incorrecta.
* Red desconectada
* No puede conectarse a la red configurada.
* La red WiFi configurada no está disponible.


Si el ''kiWi'' ya está configurado y correctamente conectado a la red local, se puede acceder a su portal web desde un navegador introduciendo la IP estática configurada.


Las versiones anteriores a la '''v1.3.5''' solo soportan comunicación Modbus RTU a '''9600 baudios 8N1''' y comunicación Modbus TCP a través del puerto '''502'''.


Si ya ha configurado el ''KiWi'' , puede acceder conectándose a su misma red y escribiendo su IP en el navegador.
La versión instalada puede consultarse desde la ventana de información del portal web del ''kiWi''.


Versiones anteriores a la v1.3.5 solo soportan comunicaciones Modbus RTU de 9600 baudios 8N1 y Modbus TCP a través del puerto 502.
== Acceso al portal de configuración ==
 
=== Acceso a un ''kiWi'' no configurado ===
 
# Buscar desde un portátil o smartphone la red WiFi generada por el ''kiWi''. El nombre de la red y la contraseña se indican en la matrícula o pegatina del equipo.
# Conectarse a dicha red WiFi.
# Abrir un navegador web.
# Acceder a la IP indicada en la matrícula. Por defecto, la IP es '''192.168.4.1'''.
 
[[Archivo:WIFIS.jpg|centro|Ejemplo de visualización de la red wifi del kiwi|miniaturadeimagen|400x400px]]
 
[[Archivo:SP - Captura de pantalla IP del kiwi.jpg|centro|Acceso a kiWi por IP|miniaturadeimagen|384x384px]]
 
=== Acceso a un ''kiWi'' ya configurado ===
 
Si el ''kiWi'' ya ha sido configurado correctamente, el acceso se realiza desde la misma red local en la que se encuentra conectado el equipo. Para ello, se debe introducir en el navegador la IP estática configurada durante la puesta en marcha.
 
Si el ''kiWi'' no consigue conectarse a la red configurada, volverá a activar su punto de acceso WiFi '''KIWI_XXXXXX''' para permitir la revisión o modificación de la configuración.
 
== Configuración del ''kiWi'' ==
 
=== Acceso mediante contraseña ===
 
En el primer acceso, la contraseña de configuración está indicada en la etiqueta del equipo como '''Conf. pswd'''. Tras acceder por primera vez, el portal solicita cambiar la contraseña por motivos de seguridad.
 
[[Archivo:Acceso a configuración.jpg|centro|miniaturadeimagen|580x580px|Campo de contraseña en la configuración del kiWi]]
 
Al realizar el cambio, se debe introducir la contraseña anterior y, posteriormente, la nueva contraseña dos veces para confirmarla.
 
[[Archivo:Cambio de contraseña.jpg|centro|miniaturadeimagen|768x768px|Cambio de contraseña en el primer acceso]]
 
El portal muestra un aviso indicando la importancia de conservar la nueva contraseña. Si se pierde, será necesario restaurar el equipo a valores de fábrica.
 
[[Archivo:Confirmar cambio.jpg|centro|miniaturadeimagen|769x769px|Aviso para recordar la nueva contraseña]]
 
Una vez completado el proceso, se muestra la confirmación de que la contraseña se ha modificado correctamente.
 
[[Archivo:Confirmación de cambio de contraseña.jpg|centro|miniaturadeimagen|772x772px|Contraseña modificada correctamente]]
 
=== Configuración de red y Modbus ===
 
Para configurar el equipo, acceder a la opción '''Configure KiWi''' desde el menú principal.
 
[[Archivo:Menú configuración.jpg|centro|miniaturadeimagen|599x599px|Menú de configuración del kiWi]]
 
Durante el asistente de configuración se deben completar los siguientes apartados:
 
# Seleccionar el tipo de conexión de red:
#* '''WiFi''': permite buscar la red automáticamente mediante la opción WiFi Auto o introducirla manualmente.
#* '''Ethernet''': permite conectar el ''kiWi'' mediante cable de red al puerto RJ45.
# Habilitar siempre la opción de '''IP estática'''.
# Introducir la IP estática del ''kiWi''.
# Introducir la puerta de enlace. Debe estar en el mismo rango de red que el ''kiBox''.
# Introducir la máscara de red, normalmente '''255.255.255.0'''.
# Introducir los DNS, por ejemplo '''8.8.8.8''' y '''8.8.4.4'''.
# Pulsar '''Next''' para guardar los parámetros de red.
# Configurar los parámetros Modbus del equipo conectado al puerto RS-485:
#* Puerto TCP.
#* Baudrate.
#* Bits de datos.
#* Paridad.
#* Bits de parada.
# Revisar la pantalla de confirmación con el resumen de cambios.
# Confirmar la configuración.
# Pulsar '''Finish''' cuando el botón aparezca disponible.
 
[[Archivo:Parametros de la red.jpg|centro|miniaturadeimagen|777x777px|Configuración de la red de comunicación]]
 
[[Archivo:Confirmación de la configuración.png|centro|miniaturadeimagen|583x583px|Confirmación de los cambios de red]]
 
[[Archivo:Confirmación de la configuración 2.png|centro|miniaturadeimagen|589x589px|Confirmación de los cambios Modbus]]
 
[[Archivo:Configuración en proceso.jpg|centro|miniaturadeimagen|601x601px|Configuración en proceso]]
 
[[Archivo:Configuración terminada 2.jpg|centro|miniaturadeimagen|601x601px|Configuración terminada]]
 
Cuando la configuración finaliza correctamente, el portal muestra un resumen desde la IP de configuración inicial, normalmente '''192.168.4.1'''. Esto es normal, ya que el equipo acaba de recibir una nueva IP estática dentro de la red de la instalación.
 
A partir de ese momento, se debe conectar el ordenador o smartphone a la misma red que el ''kiBox'' y acceder al ''kiWi'' mediante la IP estática configurada.
 
[[Archivo:Menú de kiwi configurado.png|centro|miniaturadeimagen|589x589px|Menú del kiWi configurado]]
 
Si durante la vida útil del ''kiWi'' se modifica la red local, la contraseña WiFi, el direccionamiento IP o la ubicación del equipo, será necesario revisar y actualizar la configuración.
 
== Comprobaciones tras la configuración ==
 
Una vez configurado el ''kiWi'', se recomienda realizar las siguientes comprobaciones:
 
{| class="wikitable"
! Comprobación
! Resultado esperado
|-
| Acceso al portal mediante la IP estática configurada
| El portal del ''kiWi'' responde desde la red local.
|-
| Conectividad entre ''kiBox'' y ''kiWi''
| El ''kiBox'' puede alcanzar la IP del ''kiWi''.
|-
| Parámetros Modbus
| Baudrate, paridad, bits de datos y bits de parada coinciden con los del equipo conectado.
|-
| Cableado RS-485
| Las bornas A (+) y B (-) están correctamente conectadas.
|-
| Lectura desde plataforma
| El control comunica y responde a las consultas Modbus.
|}
 
== Incidencias habituales ==
 
{| class="wikitable"
! Síntoma
! Posible causa
! Revisión recomendada
|-
| No aparece la red WiFi del ''kiWi''
| El equipo no está alimentado o ya está conectado correctamente a una red local.
| Comprobar alimentación y probar acceso por la IP estática configurada.
|-
| No se puede acceder a 192.168.4.1
| El ordenador o smartphone no está conectado al WiFi del ''kiWi''.
| Verificar que se está conectado a la red '''KIWI_XXXXXX'''.
|-
| El ''kiWi'' no conecta a la red WiFi
| SSID, contraseña o parámetros IP incorrectos.
| Revisar configuración de red y confirmar que la red es de 2.4 GHz.
|-
| El ''kiBox'' no comunica con el control
| IP, puerto TCP o parámetros Modbus incorrectos.
| Comprobar IP, puerto, baudrate, paridad, bits de datos y bits de parada.
|-
| Hay lecturas inestables o timeouts
| Cableado RS-485 incorrecto, exceso de variables o mala calidad de señal.
| Revisar bornas A/B, longitud del bus, número de parámetros y estabilidad de la red.
|}


Puede verificar la versión en la ventana de información del portal web de ''KiWi''.
== Proceso de borrado o restauración ==


==== Acceso al portal de configuración de ''KiWi'' ====
Si es necesario borrar la configuración del ''kiWi'', se puede realizar de dos formas.


===== Acceso a ''KiWi'' no configurado =====
=== Restauración desde el portal ===


# Conexión a la red WiFi de ''KiWi'' desde el smartphone.[[Archivo:SP - Captura red wifi del kiwi.jpg|centro|marco|Ejemplo de visualización de la red wifi del kiwi]]
Desde el menú de configuración, pulsar la opción '''Reset device'''. Tras confirmar la acción, el equipo volverá a los valores de fábrica.
# Si no ha sido redirigido al portal de configuración debe abrir navegador Chrome, Firefox o similar.[[Archivo:SP - Navegadores.jpg|centro|miniaturadeimagen|800x800px|Navegadores]]
# Acceder a la IP 192.168.4.1
[[Archivo:SP - Captura de pantalla IP del kiwi.jpg|centro|marco|Acceso a KiWi por IP]]


===== Acceso a ''KiWi'' ya configurado =====
[[Archivo:Proceso de reseteo.png|centro|miniaturadeimagen|604x604px|Proceso de borrado del kiWi]]
Se repite el proceso del apartado anterior, pero en este caso es necesario conectarse a la misma red WiFi que se configuró en el ''KiWi'' , y la IP a introducir en el navegador es la IP que se configuró en dicho kiwi.


==== Configuración de ''KiWi'' ====
[[Archivo:Kiwi reseteado.png|centro|miniaturadeimagen|601x601px|kiWi reseteado]]


===== Partes de ''KiWi'' =====
=== Restauración mediante botón físico ===


# Acceso mediante contraseña (en el primer acceso será redirigido a un portal para introducir una contraseña segura).[[Archivo:SP - Password en configuración del KiWi.png|centro|marco|Captura de pantalla del campo contraseña en configuración del KiWi]]
Si no se tiene acceso al portal web, se puede borrar la configuración manualmente mediante el botón de reset situado en el orificio de la cubierta superior del ''kiWi''.
# Ventana principal del portal. Click en Configurar ''KiWi''/Cambiar configuración, para comenzar.[[Archivo:SP - Ventana principal del portal.png|centro|marco|Ventana principal del portal en configuración del KiWi]]
# Selección del modo de conexión. Posibilidad de conexión inalámbrica o cableada.[[Archivo:SP - Opciones de red en configuración del KiWi.png|centro|marco|Opciones de red en configuración del KiWi]]
# Configuración de red. Indicar WiFi y contraseña a la que conectarse e indicar los parámetros necesarios.[[Archivo:SP - Configuración de red en configuración del KiWi.png|centro|marco|Configuración de red en configuración del KiWi]]
# Introducción de configuración Modbus. Indicar velocidad de la comunicación Modbus RTU y puerto para la comunicación Modbus TCP.[[Archivo:SP - Configuración RS-485 en configuración del KiWi.png|centro|marco|Configuración RS-485 en configuración del KiWi]]
# Confirmación de parámetros introducidos. Si se desea cambiar alguno es posible volver atrás.[[Archivo:SP - Confirmación de la configuración RS-485 en configuración del KiWi.png|centro|marco|Confirmación de la configuración RS-485 en configuración del KiWi]]
# Fin de la configuración. [[Archivo:SP - Fin de la configuración en connfiguración del KiWi.png|centro|marco|Fin de la configuración en configuración del KiWi]]


Para ello, introducir un elemento estrecho y mantener pulsado el botón durante aproximadamente '''10 segundos'''.


[[Archivo:Reset kiwi.png|centro|miniaturadeimagen|388x388px|Botón de reset del kiWi]]


Si durante la vida del ''KiWi'' , se modifica la red a la que está conectado, será necesario configurar de nuevo ''KiWi'' para los nuevos parámetros que  caracterizan a la red.
== Creación del control en plataforma ==


Cuando ''KiWi'' tiene problemas para conectarse a una red, lo reintenta de forma continua manteniendo abierto su punto de acceso WiFi al acceder para verificar la configuración que tiene y cambiarla de ser necesario.
Una vez que el ''kiWi'' está configurado y comunica correctamente con el ''kiBox'', se puede crear el control correspondiente en la instalación desde Cloud kiconex.


===== Proceso de borrado =====
Consultar: [[Controls#Crear y editar un control|Crear y editar un control]].
Si necesita borrar la configuración establecida en ''KiWi'' , puede hacerlo de dos formas:


# Si tiene acceso al portal de configuración, al final de la ventana de información existe la opción de borrado:[[Archivo:SP - Proceso de borrado del KiWi.png|centro|marco|Proceso de borrado del KiWi]]
# En caso de no tener acceso al portal, se puede borrar la configuración manualmente a través del botón de reset que se encuentra en el orificio de la cubierta superior del ''KiWi''. Es necesario introducir un elemento muy estrecho y mantener pulsado el botón durante 10 segundos aproximadamente.
[[Archivo:SP - Botón de reset del KiWi.jpg|centro|marco|Botón de reset del KiWi]]Puede descargar el manual en el siguiente enlace
</translate>
</translate>

Revisión actual - 08:07 30 jun 2026

kiWi

kiWi (kiconex wireless) es la solución de kiconex para convertir una comunicación Modbus RTU por RS-485 en una comunicación Modbus TCP/IP a través de red local, ya sea por WiFi o por Ethernet.

Su función principal es permitir que uno o varios controles Modbus RTU puedan comunicarse con el kiBox principal sin necesidad de llevar el bus RS-485 físico hasta la ubicación del equipo. Para ello, el kiWi actúa como pasarela entre el puerto RS-485 del control y la red IP de la instalación.

Información sobre versión kiWi 2023.

Descripción general

En una instalación convencional con comunicación Modbus RTU, los dispositivos se cablean directamente al maestro Modbus, normalmente el kiBox, utilizando un cable apantallado de dos hilos. Esta conexión se realiza habitualmente mediante tipología daisy-chain o bus RS-485. Puede ampliarse información en Modbus RTU / RS-485.

Esquema RS-485 simple

La solución kiWi permite sustituir parte de ese cableado por una conexión de red. El equipo se conecta al control mediante RS-485 y, a su vez, se comunica con la red local mediante WiFi o cable Ethernet. De esta forma, el kiBox puede acceder al equipo Modbus como si se tratase de un dispositivo Modbus TCP/IP dentro de la misma red.

Esquema de conexionado kiWi

El uso de kiWi resulta especialmente útil cuando no es viable instalar nuevo cableado RS-485 hasta el kiBox, cuando los controles se encuentran alejados o cuando se quiere aprovechar una red local existente.

Importante: un kiWi está diseñado para trabajar con una cantidad reducida de equipos. Como criterio general, no se recomienda superar los 800 parámetros entre todos los dispositivos conectados al mismo kiWi.

Función dentro de la instalación

El kiWi no sustituye al kiBox ni actúa como plataforma de supervisión. Su papel es exclusivamente de pasarela de comunicación:

Elemento Función
Control o dispositivo Modbus Equipo de campo que comunica mediante Modbus RTU por RS-485.
kiWi Convierte la comunicación Modbus RTU del equipo en comunicación Modbus TCP/IP.
Red local Medio de comunicación entre el kiWi y el kiBox, mediante WiFi o Ethernet.
kiBox Maestro Modbus TCP/IP que consulta los registros del equipo a través del kiWi.

Características técnicas

Red
WiFi IEEE 802.11 b/g/n 2.4 GHz RF
Ethernet 1 x ETH
Modbus
Protocolos Modbus Modbus TCP mediante WiFi o Ethernet / Modbus RTU mediante puerto RS-485
Baudrates soportados 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600 y 115200
Bits de datos 8
Bits de parada 7 u 8
Paridad Ninguna, par o impar
Dúplex Half-Duplex
Formatos de datos soportados 8 bit: INT, UINT; 16 bit: INT, UINT (MSB o LSB); 32 bit: float, INT, UINT (ABCD big-endian, DCBA little-endian, CDAB, BADC)
Sistema
CPU Dual core Tensilica LX6 microcontroller with 600 DMIPS and 240 MHz
RAM 520 KiB
Memoria FLASH 4 MB
Alimentación
Conector Micro-USB
Voltaje de alimentación 5 VDC
Consumo de potencia < 5 W
Temperatura
Rango de temperatura -40 ºC a 125 ºC
Material
Material Carcasa impresa en 3D con PLA
Dimensiones 13.64 mm x 3.30 mm x 2.95 mm (largo x ancho x alto)
Peso 100 g

Configuración por defecto

Cuando el equipo está sin configurar o no consigue conectarse a la red configurada, genera su propio punto de acceso WiFi para poder acceder al portal de configuración.

Parámetro Valor por defecto
SSID WiFi KIWI_XXXXXX
Contraseña WiFi 12345678
IP del portal de configuración 192.168.4.1
Contraseña del portal 00#Kiconex

Conexión física

Partes del kiWi

Partes de un kiWi
  1. Puerto RS-485
  2. Alimentación 5 V
  3. Indicador luminoso ON/OFF
  4. Puerto Ethernet
  5. Botón de reset

Puerto RS-485

Numeración de las bornas en un kiWi
PIN Uso
1 No usado
2 No usado
3 A (+)
4 B (-)

Información necesaria antes de configurar

Antes de acceder al portal de configuración es recomendable recopilar los datos de red y comunicación Modbus que se van a utilizar.

Datos de red

  • SSID de la red WiFi, si la conexión será inalámbrica.
  • Contraseña de la red WiFi.
  • IP libre que se asignará al kiWi.
  • Puerta de enlace.
  • Máscara de red.
  • DNS 1 y DNS 2.

Datos Modbus del equipo conectado

  • Dirección Modbus del equipo o equipos conectados al bus RS-485.
  • Baudrate.
  • Bits de datos.
  • Paridad.
  • Bits de parada.
  • Puerto TCP que utilizará el kiWi.
  • Número aproximado de variables o parámetros que se van a consultar.

Notas de funcionamiento

El kiWi crea una red WiFi propia, del tipo KIWI_XXXXXX, en los siguientes casos:

  • El equipo todavía no ha sido configurado.
  • La configuración guardada es incorrecta.
  • No puede conectarse a la red configurada.
  • La red WiFi configurada no está disponible.

Si el kiWi ya está configurado y correctamente conectado a la red local, se puede acceder a su portal web desde un navegador introduciendo la IP estática configurada.

Las versiones anteriores a la v1.3.5 solo soportan comunicación Modbus RTU a 9600 baudios 8N1 y comunicación Modbus TCP a través del puerto 502.

La versión instalada puede consultarse desde la ventana de información del portal web del kiWi.

Acceso al portal de configuración

Acceso a un kiWi no configurado

  1. Buscar desde un portátil o smartphone la red WiFi generada por el kiWi. El nombre de la red y la contraseña se indican en la matrícula o pegatina del equipo.
  2. Conectarse a dicha red WiFi.
  3. Abrir un navegador web.
  4. Acceder a la IP indicada en la matrícula. Por defecto, la IP es 192.168.4.1.
Ejemplo de visualización de la red wifi del kiwi
Acceso a kiWi por IP

Acceso a un kiWi ya configurado

Si el kiWi ya ha sido configurado correctamente, el acceso se realiza desde la misma red local en la que se encuentra conectado el equipo. Para ello, se debe introducir en el navegador la IP estática configurada durante la puesta en marcha.

Si el kiWi no consigue conectarse a la red configurada, volverá a activar su punto de acceso WiFi KIWI_XXXXXX para permitir la revisión o modificación de la configuración.

Configuración del kiWi

Acceso mediante contraseña

En el primer acceso, la contraseña de configuración está indicada en la etiqueta del equipo como Conf. pswd. Tras acceder por primera vez, el portal solicita cambiar la contraseña por motivos de seguridad.

Campo de contraseña en la configuración del kiWi

Al realizar el cambio, se debe introducir la contraseña anterior y, posteriormente, la nueva contraseña dos veces para confirmarla.

Cambio de contraseña en el primer acceso

El portal muestra un aviso indicando la importancia de conservar la nueva contraseña. Si se pierde, será necesario restaurar el equipo a valores de fábrica.

Aviso para recordar la nueva contraseña

Una vez completado el proceso, se muestra la confirmación de que la contraseña se ha modificado correctamente.

Contraseña modificada correctamente

Configuración de red y Modbus

Para configurar el equipo, acceder a la opción Configure KiWi desde el menú principal.

Menú de configuración del kiWi

Durante el asistente de configuración se deben completar los siguientes apartados:

  1. Seleccionar el tipo de conexión de red:
    • WiFi: permite buscar la red automáticamente mediante la opción WiFi Auto o introducirla manualmente.
    • Ethernet: permite conectar el kiWi mediante cable de red al puerto RJ45.
  2. Habilitar siempre la opción de IP estática.
  3. Introducir la IP estática del kiWi.
  4. Introducir la puerta de enlace. Debe estar en el mismo rango de red que el kiBox.
  5. Introducir la máscara de red, normalmente 255.255.255.0.
  6. Introducir los DNS, por ejemplo 8.8.8.8 y 8.8.4.4.
  7. Pulsar Next para guardar los parámetros de red.
  8. Configurar los parámetros Modbus del equipo conectado al puerto RS-485:
    • Puerto TCP.
    • Baudrate.
    • Bits de datos.
    • Paridad.
    • Bits de parada.
  9. Revisar la pantalla de confirmación con el resumen de cambios.
  10. Confirmar la configuración.
  11. Pulsar Finish cuando el botón aparezca disponible.
Configuración de la red de comunicación
Confirmación de los cambios de red
Confirmación de los cambios Modbus
Configuración en proceso
Configuración terminada

Cuando la configuración finaliza correctamente, el portal muestra un resumen desde la IP de configuración inicial, normalmente 192.168.4.1. Esto es normal, ya que el equipo acaba de recibir una nueva IP estática dentro de la red de la instalación.

A partir de ese momento, se debe conectar el ordenador o smartphone a la misma red que el kiBox y acceder al kiWi mediante la IP estática configurada.

Menú del kiWi configurado

Si durante la vida útil del kiWi se modifica la red local, la contraseña WiFi, el direccionamiento IP o la ubicación del equipo, será necesario revisar y actualizar la configuración.

Comprobaciones tras la configuración

Una vez configurado el kiWi, se recomienda realizar las siguientes comprobaciones:

Comprobación Resultado esperado
Acceso al portal mediante la IP estática configurada El portal del kiWi responde desde la red local.
Conectividad entre kiBox y kiWi El kiBox puede alcanzar la IP del kiWi.
Parámetros Modbus Baudrate, paridad, bits de datos y bits de parada coinciden con los del equipo conectado.
Cableado RS-485 Las bornas A (+) y B (-) están correctamente conectadas.
Lectura desde plataforma El control comunica y responde a las consultas Modbus.

Incidencias habituales

Síntoma Posible causa Revisión recomendada
No aparece la red WiFi del kiWi El equipo no está alimentado o ya está conectado correctamente a una red local. Comprobar alimentación y probar acceso por la IP estática configurada.
No se puede acceder a 192.168.4.1 El ordenador o smartphone no está conectado al WiFi del kiWi. Verificar que se está conectado a la red KIWI_XXXXXX.
El kiWi no conecta a la red WiFi SSID, contraseña o parámetros IP incorrectos. Revisar configuración de red y confirmar que la red es de 2.4 GHz.
El kiBox no comunica con el control IP, puerto TCP o parámetros Modbus incorrectos. Comprobar IP, puerto, baudrate, paridad, bits de datos y bits de parada.
Hay lecturas inestables o timeouts Cableado RS-485 incorrecto, exceso de variables o mala calidad de señal. Revisar bornas A/B, longitud del bus, número de parámetros y estabilidad de la red.

Proceso de borrado o restauración

Si es necesario borrar la configuración del kiWi, se puede realizar de dos formas.

Restauración desde el portal

Desde el menú de configuración, pulsar la opción Reset device. Tras confirmar la acción, el equipo volverá a los valores de fábrica.

Proceso de borrado del kiWi
kiWi reseteado

Restauración mediante botón físico

Si no se tiene acceso al portal web, se puede borrar la configuración manualmente mediante el botón de reset situado en el orificio de la cubierta superior del kiWi.

Para ello, introducir un elemento estrecho y mantener pulsado el botón durante aproximadamente 10 segundos.

Botón de reset del kiWi

Creación del control en plataforma

Una vez que el kiWi está configurado y comunica correctamente con el kiBox, se puede crear el control correspondiente en la instalación desde Cloud kiconex.

Consultar: Crear y editar un control.