Kiconex: Nueva documentación completa de Box Management System basada en la interfaz actual, la versión legacy y las capturas del rol OEM.

2026-07-16T14:05:44Z

Nueva documentación completa de Box Management System basada en la interfaz actual, la versión legacy y las capturas del rol OEM.

Página nueva

{{DISPLAYTITLE:Box Management System}}

'''Box Management System''' es la interfaz local de administración y diagnóstico de determinados Box kiconex. Permite consultar el estado del equipo, comprobar la conectividad, realizar pruebas Modbus, revisar los servicios en ejecución, configurar la red y consultar registros y actualizaciones.

Esta página describe únicamente las opciones disponibles para el rol '''OEM'''. Este rol puede consultar y utilizar las funciones mostradas en la interfaz, pero no puede crear usuarios ni acceder a las funciones reservadas a perfiles superiores.

<div style="border-left:5px solid #fc3; background:#fff4ce; padding:12px 16px; margin:16px 0;">
'''Compatibilidad pendiente'''

Está previsto desplegar Box Management System en Box 2 kiconex y Box 4 kiconex.

'''Pendiente de validación interna:''' indicar la fecha de despliegue y la versión mínima compatible.
</div>

__TOC__

== Versiones anteriores ==

Box Management System sustituye a las interfaces locales anteriores. La documentación histórica se mantiene separada para evitar mezclar procedimientos incompatibles:

* [[KiAdmin v2025.1|Versión v2025.1 de kiAdmin]] — página pendiente de crear.
* [[KiAdmin legacy|Versión legacy de kiAdmin]] — documentación obsoleta conservada como referencia histórica.

No utilice las instrucciones de las versiones anteriores para configurar esta interfaz.

== Acceder a Box Management System ==

=== Preparar la conexión ===

El ordenador debe estar conectado a la misma red local que el Box kiconex. La conexión puede realizarse a través de la red de la instalación o directamente al puerto de red del equipo, cuando el modelo y la configuración lo permitan.

Si se realiza una conexión directa, configure temporalmente el ordenador en una red compatible con la dirección local del Box.



=== Abrir la interfaz ===

# Abra un navegador web desde el ordenador conectado al Box.
# Introduzca la dirección [http://100.100.100.100 http://100.100.100.100].
# En '''Username''' introduzca el nombre de usuario indicado en la matrícula del Box kiconex.
# En '''Password''' introduzca la contraseña indicada en la matrícula.
# Pulse '''Sign in''' para iniciar sesión.

Las credenciales son específicas de cada equipo. No deben incluirse en capturas, incidencias o documentación pública.



== Navegación general ==

La barra superior organiza las funciones en cuatro áreas:

* '''Overview''' — resumen general del Box.
* '''Health''' — diagnóstico de conectividad y herramientas Modbus.
* '''Services''' — estado y control de los servicios de supervisión, Zigbee y actualizaciones OTA.
* '''System''' — red, VPN, usuarios, registros, identificador y actualización manual.

La interfaz está disponible únicamente en inglés. En esta página se conserva la etiqueta exacta en inglés y se explica su función en castellano.

== Overview: resumen general ==

La página '''Overview''' muestra el estado general del equipo en tiempo real.

=== System resources ===

El bloque '''System resources''' muestra:

* '''CPU''' — porcentaje de uso del procesador.
* '''RAM''' — porcentaje de memoria utilizada.
* '''Flash''' — porcentaje de almacenamiento utilizado.
* '''Uptime''' — tiempo transcurrido desde el último arranque.
* '''Local time''' — fecha, hora y zona horaria configuradas en el Box.
* '''Device identifier''' — identificador único utilizado por Cloud kiconex para reconocer el equipo.



=== VPN connection ===

El bloque '''VPN connection''' indica si el túnel VPN está conectado. También muestra la interfaz y la dirección asignada.

=== Network interfaces ===

El bloque '''Network interfaces''' enumera las interfaces detectadas y, cuando corresponde, su dirección de red.

=== Services ===

El bloque '''Services''' resume el estado de los servicios principales:

* '''Supervision System''' — servicio de procesamiento y sincronización de datos.
* '''OTA System''' — servicio de comprobación automática de actualizaciones.

El estado puede mostrarse como '''Running''', '''Enabled''' u otro valor según el servicio.

== Health: diagnóstico y conectividad ==

El menú '''Health''' contiene las herramientas '''Ping Tool''', '''Connectivity Tools''' y '''Modbus Tools'''.

=== Ping Tool ===

'''Ping Tool''' comprueba si el Box puede alcanzar una dirección IP o un nombre de host y permite observar la latencia de las respuestas.

# Acceda a '''Health''' y seleccione '''Ping Tool'''.
# Introduzca la dirección IP o el nombre del equipo en '''Target host'''.
# Active '''Loop''' solo cuando necesite repetir la prueba de forma continua.
# Pulse '''Ping'''.
# Revise las respuestas en el panel inferior.
# Detenga la prueba continua cuando haya terminado.

Un resultado sin respuesta puede deberse a falta de conectividad, dirección incorrecta, reglas de red o a que el equipo de destino no responda a ICMP.



=== Connectivity Tools ===

'''Connectivity Tools''' ejecuta comprobaciones independientes para verificar si el Box alcanza los servicios necesarios.

Las pruebas disponibles son:

* '''Internet Connection''' — conectividad general con Internet.
* '''Server Kiconex''' — conexión con el servidor de kiconex mediante el puerto mostrado por la interfaz.
* '''VPN Kiconex''' — conexión con el servidor VPN mediante el puerto mostrado por la interfaz.
* '''OTA Server''' — acceso al servidor de actualizaciones.

Para ejecutar las comprobaciones:

# Acceda a '''Health''' y seleccione '''Connectivity Tools'''.
# Pulse '''Run all''' para ejecutar todas las pruebas o '''Check''' en una prueba concreta.
# Revise el estado y la hora de la última comprobación.
# Si una prueba falla, revise la red, la puerta de enlace, los DNS y las reglas de salida antes de reiniciar servicios.



=== Modbus Tools ===

'''Modbus Tools''' permite probar, consultar de forma continua y escanear equipos Modbus mediante '''RTU''' o '''TCP'''.

<div style="border-left:5px solid #fc3; background:#fff4ce; padding:12px 16px; margin:16px 0;">
'''Importante'''

Los valores mostrados en las capturas son ejemplos. Configure siempre el protocolo, la dirección, la función y el registro de acuerdo con la documentación del equipo que se está comprobando.
</div>

==== Seleccionar la operación y el protocolo ====

En '''Operation''' seleccione una de estas opciones:

* '''Test''' — realiza una única lectura o escritura.
* '''Poll''' — realiza lecturas continuas.
* '''Scan''' — busca direcciones que respondan.

En '''Protocol''' seleccione:

* '''RTU''' — comunicación serie RS-485.
* '''TCP''' — comunicación Modbus a través de red Ethernet.

==== Test: realizar una solicitud única ====

# Seleccione '''Test'''.
# Seleccione '''RTU''' o '''TCP'''.
# Para RTU, configure '''Port''', '''Baudrate''', '''Databits''', '''Parity''', '''Stopbits''' y '''Address'''.
# Para TCP, introduzca los datos de red solicitados por la interfaz.
# En '''Register''' indique el registro inicial.
# En '''Function''' seleccione la función Modbus.
# En '''Count''' indique el número de registros.
# Abra '''Data treatments''' solo si necesita aplicar una conversión a la respuesta.
# Revise todos los valores y pulse '''Send request'''.

Cuando la solicitud finaliza correctamente, la ventana de respuesta puede mostrar:

* Valor en decimal, hexadecimal y binario.
* Número de registros recibidos.
* Valor individual de cada registro.
* Opción '''Retry''' para repetir la solicitud.



==== Poll: realizar lecturas continuas ====

# Seleccione '''Poll'''.
# Configure el protocolo y los parámetros de comunicación.
# Indique el registro, la función y el número de registros.
# Inicie la lectura continua.
# Revise '''Real-time data''' para consultar el último valor en decimal, hexadecimal y binario.
# Utilice la gráfica para observar la evolución de la lectura.
# Use los controles disponibles para pausar, reanudar, reiniciar o detener la consulta.

Detenga el sondeo cuando finalice la comprobación para no mantener tráfico de diagnóstico innecesario.



==== Scan: buscar direcciones Modbus ====

# Seleccione '''Scan'''.
# Configure el protocolo y los parámetros de comunicación.
# En RTU, seleccione el puerto y los parámetros serie.
# Indique el registro y la función utilizados para comprobar la respuesta.
# Inicie el escaneo.
# Revise el progreso y la lista '''Responses'''.
# Utilice los controles para pausar, reiniciar o detener el escaneo.

Una dirección mostrada en '''Responses''' indica que se ha recibido una respuesta durante la prueba. Esto no confirma por sí solo que el equipo esté configurado correctamente para la integración.



Consulte también [[Modbus-protocol|Protocolo Modbus]].

== Services: servicios del Box ==

El menú '''Services''' permite consultar y controlar los servicios disponibles para el rol OEM.

=== Supervision System ===

'''Supervision System''' es el servicio encargado del procesamiento en segundo plano y de la sincronización de datos.

La página muestra:

* Estado actual del servicio.
* Hora de la última comprobación.
* Acceso a '''Service logs'''.
* Acciones '''Start''', '''Restart''', '''Stop service''' y '''Purge data''', según el estado.

==== Iniciar el servicio ====

# Pulse '''Start'''.
# Revise la ventana de confirmación.
# Pulse de nuevo '''Start'''.
# Espere a que el estado cambie a '''Running'''.

==== Reiniciar el servicio ====

# Pulse '''Restart'''.
# Confirme la operación si la interfaz lo solicita.
# Espere a que el servicio vuelva a mostrar el estado '''Running'''.
# Compruebe los registros si el servicio no se recupera.

==== Detener el servicio ====

# Pulse '''Stop service'''.
# Lea el aviso de confirmación.
# Pulse '''Stop'''.
# Tenga en cuenta que no se procesarán datos hasta que el servicio se inicie de nuevo.

==== Purgar los datos del servicio ====

<div style="border-left:5px solid #d33; background:#fee7e6; padding:12px 16px; margin:16px 0;">
'''Advertencia de seguridad'''

'''Purge data''' detiene el servicio y elimina permanentemente los archivos JSON asociados. La operación no se puede deshacer. Utilícela únicamente cuando exista una indicación técnica expresa.
</div>

# Pulse '''Purge data'''.
# Revise el aviso y confirme que el servicio correcto aparece en la ventana.
# Pulse '''Purge data''' para confirmar.
# Inicie de nuevo el servicio cuando corresponda.
# Compruebe su estado y los registros.





=== Zigbee ===

La página '''Zigbee''' muestra el estado del coordinador Zigbee2MQTT y los equipos asociados.

El resumen incluye:

* Estado del coordinador.
* Canal Zigbee.
* PAN ID y Extended PAN ID.
* Versión de Zigbee2MQTT.
* Estado del emparejamiento.
* Número de equipos detectados.
* Listado de equipos, tipo, modelo, disponibilidad y alimentación cuando la información está disponible.

Los identificadores de red y los nombres reales de los equipos no deben publicarse en capturas de una instalación.



==== Emparejar un equipo ====

# Abra la pestaña '''Pairing'''.
# Active el modo de emparejamiento desde la opción disponible.
# Ponga el equipo Zigbee en modo de emparejamiento siguiendo las instrucciones de su fabricante.
# Espere a que el equipo aparezca en la lista '''Devices'''.
# Compruebe su estado y modelo.
# Cierre el emparejamiento cuando finalice.



==== Coordinator settings ====

Pulse '''Configure''' en '''Coordinator settings''' para abrir la configuración del servicio. Las opciones se organizan en varias pestañas.

===== General =====

La pestaña '''General''' agrupa opciones de:

* Nivel, ruta y rotación de registros.
* Formato de salida y marcas de tiempo.
* Caché de estado.
* Envío de estado durante el arranque.
* Opciones de compatibilidad y ajuste avanzado.

No modifique las opciones de compatibilidad sin una indicación técnica.

===== Availability =====

La pestaña '''Availability''' permite configurar el seguimiento de disponibilidad y los tiempos utilizados para considerar un equipo activo o pasivo.

===== Integrations =====

La pestaña '''Integrations''' reúne las opciones de integración disponibles, como los temas utilizados por Home Assistant y la comprobación OTA de los equipos Zigbee.

===== Network =====

<div style="border-left:5px solid #d33; background:#fee7e6; padding:12px 16px; margin:16px 0;">
'''Advertencia de seguridad'''

Cambiar el canal, el PAN ID, el Extended PAN ID o la potencia de transmisión puede desconectar equipos ya emparejados. Algunos equipos pueden necesitar un nuevo emparejamiento y el servicio puede requerir un reinicio. Descargue antes una copia de seguridad.
</div>

# Abra '''Network'''.
# Lea el aviso de configuración protegida.
# Active la confirmación de riesgos para desbloquear los campos.
# Modifique únicamente los valores indicados para la instalación.
# Pulse '''Save'''.
# Reinicie el servicio si la interfaz o el cambio realizado lo requieren.
# Compruebe el coordinador y todos los equipos.

===== MQTT =====

La pestaña '''MQTT''' configura el servidor, el tema base, el identificador de cliente, el keepalive, la versión MQTT y las credenciales.

<div style="border-left:5px solid #d33; background:#fee7e6; padding:12px 16px; margin:16px 0;">
'''Advertencia de seguridad'''

La interfaz se comunica con Zigbee2MQTT mediante el broker configurado. Un servidor MQTT incorrecto puede impedir el acceso al servicio y obligar a corregir la configuración fuera de esta interfaz.
</div>

# Abra '''MQTT'''.
# Desbloquee la edición protegida.
# Modifique únicamente los datos validados para el proyecto.
# Si no desea cambiar una contraseña existente, deje el campo correspondiente vacío cuando la interfaz así lo indique.
# Pulse '''Save'''.
# Reinicie el servicio y compruebe el estado.

===== Adapter =====

La pestaña '''Adapter''' define el puerto o adaptador utilizado por el coordinador y sus parámetros de comunicación.

Un puerto o adaptador incorrecto puede dejar el coordinador inaccesible hasta que se corrija manualmente.

===== Backup =====

La pestaña '''Backup''' permite descargar una copia de seguridad de la red del coordinador.

Descargue una copia antes de modificar ajustes críticos de red, MQTT o adaptador.



=== OTA System ===

'''OTA System''' muestra el estado de las comprobaciones automáticas de actualización del Box.

La página informa de:

* Si las comprobaciones automáticas están habilitadas.
* Estado actual de la actualización.
* Resultado y versión de la última actualización.
* Intervalo de comprobación configurado.

Esta página es informativa para el rol OEM. La instalación manual se realiza desde '''System Update''' cuando existe una versión disponible.

== System: configuración y registros ==

=== Network Configuration ===

'''Network Configuration''' muestra la configuración de las interfaces de red y de los servidores DNS.

==== Cambiar entre DHCP e IP estática ====

# Acceda a '''System''' y seleccione '''Network Configuration'''.
# Localice la interfaz que desea configurar.
# Pulse '''Modify'''.
# Desactive '''Static IP''' para obtener la dirección automáticamente mediante DHCP, o actívelo para configurar una dirección manual.
# Si utiliza una dirección estática, complete '''IP address''', '''Netmask''' y '''Gateway'''.
# Pulse '''Confirm'''.
# Compruebe que la interfaz muestra la configuración esperada.

<div style="border-left:5px solid #d33; background:#fee7e6; padding:12px 16px; margin:16px 0;">
'''Advertencia de seguridad'''

Una dirección, máscara o puerta de enlace incorrectas pueden dejar el Box sin conectividad o impedir el acceso local. Anote la configuración anterior antes de confirmar y no modifique la dirección de acceso local '''100.100.100.100'''.
</div>

==== Añadir un servidor DNS ====

# Pulse '''Add DNS'''.
# Introduzca la dirección IP del servidor en '''DNS server IP'''.
# Pulse '''Confirm'''.
# Compruebe que el servidor aparece en la lista.

Los valores mostrados en las capturas son ejemplos y no deben copiarse como configuración de la instalación.



=== VPN Configuration ===

'''VPN Configuration''' muestra el estado del cliente OpenVPN.

Cuando la conexión está activa, la página puede mostrar:

* Interfaz VPN.
* Dirección asignada.
* Tiempo de conexión.
* Datos transferidos.
* Hora de la última comprobación.

Pulse '''Refresh''' para actualizar el estado y abra '''VPN logs''' para revisar la actividad del cliente.

=== Users Management ===

'''Users Management''' muestra las cuentas y los roles visibles para el usuario conectado. El rol OEM puede buscar usuarios y filtrar el listado por rol, pero no puede crear nuevas cuentas.

La creación y la administración avanzada de usuarios están reservadas a perfiles superiores y no se documentan en esta página pública.

=== System Logs ===

'''System Logs''' permite consultar, filtrar y exportar la actividad registrada por el Box.

Puede utilizar:

* '''Search message''' — busca texto dentro de los mensajes.
* '''Service''' — filtra por servicio.
* '''Date range''' — limita los registros a un intervalo.
* '''Order''' — ordena los resultados.
* '''Per page''' — cambia el número de entradas por página.
* '''Refresh''' — actualiza la lista.
* '''Download > Raw''' — descarga el registro en formato syslog sin procesar.
* '''Download > JSON''' — descarga las entradas estructuradas en JSON.

Los registros pueden contener direcciones, nombres de equipos, identificadores y datos internos. Revise el archivo antes de compartirlo fuera del equipo de soporte.



=== Device Identifier ===

'''Device Identifier''' muestra el identificador único que Cloud kiconex utiliza para reconocer el Box.

El rol OEM puede consultar y copiar el valor. La modificación está bloqueada y solo debe realizarse en situaciones excepcionales y justificadas.

No publique el identificador real del equipo en documentación o capturas públicas.

=== System Update ===

'''System Update''' permite comprobar si existe una versión nueva e instalarla mediante el sistema OTA.

==== Comprobar actualizaciones ====

# Acceda a '''System Update'''.
# Revise el canal, el objetivo y la versión actual.
# Pulse '''Check now''' o '''Check again'''.
# Espere al resultado.
# Si la interfaz indica '''Up to date''', no hay ninguna actualización que instalar.

==== Instalar una actualización disponible ====

Cuando existe una versión disponible, el paso '''Install update''' se habilita.

# Revise la versión detectada y confirme que corresponde al canal del equipo.
# Inicie la instalación desde '''Install update'''.
# Confirme la operación cuando la interfaz lo solicite.
# No desconecte la alimentación ni la red mientras la actualización está en curso.
# Espere a que el Box complete el proceso.
# Vuelva a acceder a la interfaz y compruebe la versión, los servicios y la conectividad.





== Problemas frecuentes ==

{| class="wikitable"
! Problema
! Comprobaciones recomendadas
|-
| No se abre la dirección local
| Compruebe la conexión física, que el ordenador esté en una red compatible y que se esté utilizando [http://100.100.100.100 http://100.100.100.100].
|-
| Las credenciales no funcionan
| Verifique los datos de la matrícula, respete mayúsculas y minúsculas y compruebe que corresponden al Box correcto.
|-
| Una prueba de conectividad falla
| Revise la interfaz de red, la puerta de enlace, los DNS y las reglas de salida. Ejecute también una prueba de ping cuando resulte aplicable.
|-
| Un equipo Modbus no responde
| Compruebe protocolo, cableado, puerto, velocidad, paridad, bits de parada, dirección, función y registro.
|-
| El servicio de supervisión está detenido
| Inícielo desde '''Services'''. Si vuelve a detenerse, revise '''Service logs''' y '''System Logs'''.
|-
| El coordinador Zigbee aparece desconectado
| Revise el servicio, el adaptador, el broker MQTT y los cambios recientes. Restaure los valores validados o contacte con soporte.
|-
| El Box está actualizado pero la instalación no comunica
| Compruebe '''Connectivity Tools''', el estado de la VPN y el servicio de supervisión.
|}

== Enlaces relacionados ==

* [[Modbus-protocol|Protocolo Modbus]]
* [[KiAdmin v2025.1|Versión v2025.1 de kiAdmin]]
* [[KiAdmin legacy|Versión legacy de kiAdmin]]

BorradoresIA/Box Management System - Historial de revisiones

Bruiz: añadidas imágenes

Kiconex: Nueva documentación completa de Box Management System basada en la interfaz actual, la versión legacy y las capturas del rol OEM.