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

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 — página pendiente de crear.
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.
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.

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

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

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.

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

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.

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.

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.

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.

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.

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

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