Diferencia entre revisiones de «KiWi»

De wiki-test.kiconex
Reestructuración y mejora completa de la documentación de KiWi (via update-page on MediaWiki MCP Server)
 
(No se muestran 2 ediciones intermedias de otro usuario)
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.


Información sobre [[KiWi2023|versión kiWi 2023.]]
'''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 ===
== Descripción general ==
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]].
 
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]].


<!--T:2-->
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 local mediante cable ethernet por el conector RJ45.
Ejemplo de una instalación convencional con comunicación Modbus RTU:
[[Archivo:Instalacion rj45 rs485.png|centro|miniaturadeimagen|392x392px|Esquema RS-485 simple]]
[[Archivo:Instalacion rj45 rs485.png|centro|miniaturadeimagen|392x392px|Esquema RS-485 simple]]
Ejemplo de una instalación a través de Modbus RTU haciendo uso del ''KiWi:''
 
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]]
[[Archivo:Instalación kiwi.png|centro|miniaturadeimagen|392x392px|Esquema de conexionado kiWi]]
Cabe destacar que en un ''kiWi'' está diseñado para trabajar con una reducida cantidad de equipos que no excedan los 800 parámetros entre ellos.


=== Características técnicas === <!--T:4-->
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:
 
{| 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 ==


<!--T:5-->
{| class="wikitable"
|1xETH
|+
| 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
|300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
| 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600 y 115200
|-
|-
|Bits de datos
| Bits de datos
|8
| 8
|-
|-
|Bits de parada
| Bits de parada
|7, 8
| 7 u 8
|-
|-
|Paridad
| Paridad
|Ninguna, Par, Impar
| 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
 
<!--T:6-->
(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
 
<!--T:7-->
|-
|-
|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
|-
| SSID WiFi
| '''KIWI_XXXXXX'''
|-
|-
|Dimensiones
| Contraseña WiFi
|13.64mm x 3.30mm x 2.95mm (largo-ancho-alto)
| '''12345678'''
|-
|-
|Peso
| IP del portal de configuración
|100 g
| '''192.168.4.1'''
|-
| Contraseña del portal
| '''00#Kiconex'''
|}
|}


=== Configuración del ''KiWi'' === <!--T:8-->
== Conexión física ==
Configuración por defecto:


<!--T:9-->
=== Partes del ''kiWi'' ===
* WiFi: '''KIWI_XXXXXX'''
* WiFi Password: '''12345678'''
* IP portal de configuración: '''192.168.4.1'''
* Contraseña portal: '''00#Kiconex'''


==== Conexión Puerto RS485 ==== <!--T:10-->
[[Archivo:Esquema kiwi.png|centro|miniaturadeimagen|370x370px|Partes de un kiWi]]


===== Partes de ''KiWi'' ===== <!--T:11-->
# Puerto RS-485
[[Archivo:Esquema kiwi.png|centro|miniaturadeimagen|370x370px|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 ===== <!--T:12-->
=== 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 ==== <!--T:13-->
== 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.


===== Parámetros de configuración ===== <!--T:14-->
== Notas de funcionamiento ==


<!--T:15-->
El ''kiWi'' crea una red WiFi propia, del tipo '''KIWI_XXXXXX''', en los siguientes casos:
* SSID de la red WiFi
* Contraseña de la red WiFi
* IP libre para el kiwi
* Puerta de enlace
* Máscara de red
* DNS1 y DNS2


===== Notas de funcionamiento ===== <!--T:16-->
* El equipo todavía no ha sido configurado.
''KiWi'' crea una red WiFi propia, del tipo KIWI_58AEB3J2, en los siguientes casos:
* La configuración guardada es incorrecta.
* No puede conectarse a la red configurada.
* La red WiFi configurada no está disponible.


<!--T:17-->
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.
* No configurado
* Configuración errónea
* Red desconectada


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


<!--T:18-->
== Acceso al portal de configuración ==
Si ya ha configurado el ''KiWi'' , puede acceder conectándose a su misma red y escribiendo su IP en el navegador.


<!--T:19-->
=== Acceso a un ''kiWi'' no configurado ===
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.


<!--T:20-->
# 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.
Puede verificar la versión en la ventana de información del portal web de ''KiWi''.
# 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'''.


==== Acceso al portal de configuración de ''KiWi'' ==== <!--T:21-->
[[Archivo:WIFIS.jpg|centro|Ejemplo de visualización de la red wifi del kiwi|miniaturadeimagen|400x400px]]


===== Acceso a ''KiWi'' no configurado ===== <!--T:22-->
[[Archivo:SP - Captura de pantalla IP del kiwi.jpg|centro|Acceso a kiWi por IP|miniaturadeimagen|384x384px]]


<!--T:23-->
=== Acceso a un ''kiWi'' ya configurado ===
# Buscamos la red WiFi del kiwi con un portátil o un smartphone. Accedemos a ella. Tanto la red  (SSID) como la contraseña (PASS) están indicadas en la matrícula (pegatina plateada) del kiwi.  [[Archivo:WIFIS.jpg|centro|Ejemplo de visualización de la red wifi del kiwi|miniaturadeimagen|400x400px]]
# Acceder a la IP indicada en la matrícula con cualquier navegador; por defecto, esta IP es 192.168.4.1
# [[Archivo:SP - Captura de pantalla IP del kiwi.jpg|centro|Acceso a KiWi por IP|miniaturadeimagen|384x384px]]


===== Acceso a ''KiWi'' ya configurado ===== <!--T:24-->
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.
Se repite el proceso del apartado anterior. Si el kiwi ya había sido configurado previamente, nos conectaremos a la red wifi en la que está conectado.


Si por cualquier circunstancia el kiwi no puede conectarse a la red WiFi configurada, éste volverá a activar su WiFi "KIWI_XXXXX" para poder hacer la configuración.
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 de ''KiWi'' ==== <!--T:25-->
== Configuración del ''kiWi'' ==


<!--T:27-->
=== Acceso mediante contraseña ===
# Acceso mediante contraseña.
## Primera vez: la contraseña está indicada en la matrícula como "Conf. pswd". Acto seguido, solicita un cambio de contraseña.
## Si ya se ha accedido previamente, esta Conf. pswd deja de usarse para dar paso a la contraseña introducida por el usuario.  [[Archivo:Acceso a configuración.jpg|centro|miniaturadeimagen|580x580px|Captura de pantalla del campo contraseña en configuración del KiWi]]
# La primera vez que accedamos a la configuración nos pedirá modificar la contraseña para maximizar la seguridad de la instalación. Rellenamos con la contraseña anterior y posteriormente su nueva contraseña de forma duplicada para confirmar que está correcta.  [[Archivo:Cambio de contraseña.jpg|centro|miniaturadeimagen|768x768px|Cambio de contraseña en el primer acceso]]
# Nos recordará la importancia de recordar la contraseña nueva, ya que si la olvidamos no podremos acceder a la configuración a no ser que le reseteemos de fábrica el dispositivo.  [[Archivo:Confirmar cambio.jpg|centro|miniaturadeimagen|769x769px|Mensaje para recordar la nueva contraseña]]
# Una vez modificada la contraseña, aparede el mensaje de contraseña modificada con éxito  [[Archivo:Confirmación de cambio de contraseña.jpg|centro|miniaturadeimagen|772x772px|Contraseña modificada con éxito]]
# Para configurar el kiwi, accedemos a la primera opción: "Configure KiWi".  [[Archivo:Menú configuración.jpg|centro|miniaturadeimagen|599x599px|Configuración RS-485 en configuración del KiWi]]
## Buscamos la red wifi a la que queremos conectarnos. Esta debe de ser la misma red en la que esté conectado el kibox. Podemos usar la opción de WiFi Auto, quie escaneará las redes disponibles o podemos introducir la red manualmente. Si se desea conectar el kiwi por LAN, seleccionar la opción ethernet. Marcar siempre la opción de habilitar IP estática ("Enable static IP), necesaria para un correcto funcionamiento.
## Introducir la IP estática del kiwi.
## Introducirt la puerta de enlace (Gateway). Ha de estar en el mismo rango de trabajo que el kibox.
## Introducir la máscara (normalmente 255.255.255.0)
## Introducir los DNS1 y DNS2. Nosotros usamos 8.8.8.8 y 8.8.4.4[[Archivo:Parametros de la red.jpg|centro|miniaturadeimagen|777x777px|Configuración de la red de comunicación.]]Pulsamos en "next". Nos aparece la pantalla avisando de que la configuración se ha guardado y que esperemos unos segundos en lo que se conecta con la red del router.
## En la siguiente pantalla, nos pide indicar cuál será la configuración modbus del equipo que vamos a conectar al kiwi. Debemos indicar su TPC port, baudrate, bitesize, parity y stop bit.
## En cuanto esta configuración esté correctamente integrada, el botón de "Finish" (Finalizar) se habilitará cambiando su color a azul.


[[Archivo:Configuración en proceso.jpg|miniaturadeimagen|Configuración en proceso.|centro|601x601px]]
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:Configuración terminada 2.jpg|miniaturadeimagen|alt=Configuración terminada|Configuración terminada|centro|601x601px]]La configuración está finalizada correctamente; el kiwi nos muestra un resumen de ésta.[[Archivo:Confirmación de la configuración.png|centro|miniaturadeimagen|583x583px|Fin de la configuración del KiWi]][[Archivo:Confirmación de la configuración 2.png|centro|miniaturadeimagen|589x589px|Fin de la configuración del KiWi]]
[[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.


Tras confirmar, es posible que no podamos trabajar desde la IP que estábamos trabajando: la 192.168.4.1. Esto es normal ya que acabamos de configurarle una nueva IP estática en otra red de internet.
[[Archivo:Cambio de contraseña.jpg|centro|miniaturadeimagen|768x768px|Cambio de contraseña en el primer acceso]]


Así pues nos conectamos por cable o wifi a la red del kibox y podremos acceder al kiwi con la IP estática configurada.
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.


Cuando la configuración está completa, el menú del kiwi muestra nuevas opciones.
[[Archivo:Confirmar cambio.jpg|centro|miniaturadeimagen|769x769px|Aviso para recordar la nueva contraseña]]


[[Archivo:Menú de kiwi configurado.png|centro|miniaturadeimagen|589x589px|Menú del Kiwi configurado]]
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]]


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.<!--T:29-->
=== Configuración de red y Modbus ===


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


===== Proceso de borrado ===== <!--T:30-->
Durante el asistente de configuración se deben completar los siguientes apartados:
Si necesita borrar la configuración establecida en ''KiWi'' , puede hacerlo de dos formas:
 
# 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.
|}
 
== 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.
 
[[Archivo:Proceso de reseteo.png|centro|miniaturadeimagen|604x604px|Proceso de borrado del kiWi]]
 
[[Archivo:Kiwi reseteado.png|centro|miniaturadeimagen|601x601px|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'''.
 
[[Archivo:Reset kiwi.png|centro|miniaturadeimagen|388x388px|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: [[Controls#Crear y editar un control|Crear y editar un control]].


<!--T:31-->
# Accediendo al menú de configuración, si pulsamos la opción de Reset device aparecerá este mensaje:  [[Archivo:Proceso de reseteo.png|centro|miniaturadeimagen|604x604px|Proceso de borrado del KiWi]]Tras confirmar aparecerá el siguiente mensaje y el kiwi quedará con la configuración original:  [[Archivo:Kiwi reseteado.png|centro|miniaturadeimagen|601x601px|kiwi reseteado]]
# 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:Reset kiwi.png|centro|miniaturadeimagen|388x388px|Botón de reset del KiWi]]
</translate>
</translate>
[[Controls#Crear y editar un control|Crear un nuevo control en nuestra instalación.]]

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.