BorradoresIA/Box Management System

Box Management System es la interfaz local de administración y diagnóstico de los Box 2 y 4 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.

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.

Versiones anteriores

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

• Versión v2025.1 de kiAdmin
• Versión legacy de kiAdmin

Utilice las instrucciones de la versión de su hardware 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.

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

Configuración de red desde el pc.

Opción de conexión del ordenador y el Box kiconex en la misma red.

Opción de conexión directa entre Box kiconex y ordenador.

Abrir la interfaz

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

Las credenciales son específicas de cada equipo.

Pantalla de login.

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.

Menú superior de Box Management System.

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

Vista del menú Overview con sus diferentes secciones.

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.

1. Acceda a Health y seleccione Ping Tool.
2. Introduzca la dirección IP o el nombre del equipo en Target host.
3. Active Loop solo cuando necesite repetir la prueba de forma continua.
4. Pulse Ping.
5. Revise las respuestas en el panel inferior.
6. 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.

BMS Ping tool

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:

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

   

   Comprobaciones de conectividad del Box.

Modbus Tools

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

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.

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

1. Seleccione Test.
2. Seleccione RTU o TCP.
3. Para RTU, configure Port, Baudrate, Databits, Parity, Stopbits y Address.
4. Para TCP, introduzca los datos de red solicitados por la interfaz.
5. En Register indique el registro inicial.
6. En Function seleccione la función Modbus.
7. En Count indique el número de registros.
8. Abra Data treatments solo si necesita aplicar una conversión a la respuesta.
9. 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.

Ejemplo de solicitud Modbus.

Ejemplo de respuesta test Modbus

Poll: realizar lecturas continuas

1. Seleccione Poll.
2. Configure el protocolo y los parámetros de comunicación.
3. Indique el registro, la función y el número de registros.
4. Inicie la lectura continua.
5. Revise Real-time data para consultar el último valor en decimal, hexadecimal y binario.
6. Utilice la gráfica para observar la evolución de la lectura.
7. 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.

Detener el sondeo (botón Stop) implica la desaparición de la gráfica.

Lectura continua Modbus y representación gráfica de los valores.

Scan: buscar direcciones Modbus

1. Seleccione Scan.
2. Configure el protocolo y los parámetros de comunicación.
3. En RTU, seleccione el puerto y los parámetros serie.
4. Indique el registro y la función utilizados para comprobar la respuesta.
5. Inicie el escaneo.
6. Revise el progreso y la lista Responses.
7. 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.

Escaneo de direcciones Modbus y resultados obtenidos.

Consulte también 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.

Vista general de Supervision System Service.

Iniciar el servicio

1. Pulse Start.
2. Revise la ventana de confirmación.
3. Pulse de nuevo Start.
4. Espere a que el estado cambie a Running.

Reiniciar el servicio

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

Detener el servicio

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

Purgar los datos del servicio

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.

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

Confirmaciones para iniciar, detener o purgar los datos de un servicio.

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.

Resumen del coordinador Zigbee y de los equipos asociados.

Emparejar un equipo

1. Abra la pestaña Pairing.
2. Active el modo de emparejamiento desde la opción Enable pairing.
3. Ponga el equipo Zigbee en modo de emparejamiento siguiendo las instrucciones de su fabricante.
4. Espere a que el equipo aparezca en la lista Discovery log.
5. Compruebe su estado y modelo.
6. Indique el código de instalación en Install code si así lo requiere su dispositivo.
7. Cierre el emparejamiento cuando finalice.

Emparejamiento Zigbee.

Coordinator settings

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

Apartados de configuración del coordinador Zigbee.

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

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.

1. Abra Network.
2. Lea el aviso de configuración protegida.
3. Active la confirmación de riesgos para desbloquear los campos.
4. Modifique únicamente los valores indicados para la instalación.
5. Pulse Save.
6. Reinicie el servicio si la interfaz o el cambio realizado lo requieren.
7. 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.

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.

1. Abra MQTT.
2. Desbloquee la edición protegida.
3. Modifique únicamente los datos validados para el proyecto.
4. Si no desea cambiar una contraseña existente, deje el campo correspondiente vacío cuando la interfaz así lo indique.
5. Pulse Save.
6. 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. La instalación manual se realiza desde System Update cuando existe una versión disponible.

OTA System.

System: configuración y registros

Network Configuration

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

Network configuration.

Cambiar entre DHCP e IP estática

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

Configuración de IP estática.

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.

Añadir un servidor DNS

1. Pulse Add DNS.
2. Introduzca la dirección IP del servidor en DNS server IP.
3. Pulse Confirm.
4. 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.

Modificación de la configuración DNS.

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.

Filtros y opciones de exportación de los registros del sistema.

Device Identifier

Device Identifier (UUID) muestra el identificador único que Cloud kiconex utiliza para reconocer el Box. La modificación está bloqueada.

System Update

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

Comprobar actualizaciones

1. Acceda a System Update.
2. Revise el canal, el objetivo y la versión actual.
3. Pulse Check now o Check again.
4. Espere al resultado.
5. 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.

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

Problemas frecuentes

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

• Protocolo Modbus
• Versión v2025.1 de kiAdmin
• Versión legacy de kiAdmin