Una vez creado el primer administrador, el panel de administración ofrece el asistente de configuración en el cuadro de diálogo Your setup wizard is ready: haga clic en Start setup. El asistente le guía por la puesta en marcha: qué tipo de proyecto es, dónde está, cómo llega al bus KNX, qué servicios se ejecutan y qué contiene el edificio. También puede abrirlo más tarde con el botón Setup wizard de la página System.
Cómo funciona el asistente
- No se escribe nada en el servidor hasta la aplicación final. Cada paso anterior solo prepara un borrador.
- El borrador sobrevive a las recargas: se guarda en el navegador que está usando, por lo que puede cerrar la página y volver en el mismo ordenador; sus respuestas siguen ahí.
- Save & exit, en la cabecera, abandona el asistente y conserva el borrador para más tarde. Skip setup — configure later, bajo la lista de pasos, abandona el asistente y descarta el borrador. Ambos llevan a la página System.
- Navegue con Back y Continue. La cabecera muestra su avance («Step 2 of 7»: la ruta ETS tiene un paso más, por lo que cuenta hasta 8).
Paso 1 — Modo de configuración
«How do you want to build this project?» Tres opciones:
- Import an ETS project (Fastest route): suba el archivo
.knxprojde la instalación y HyperVisu reconstruye la visualización a partir de lo que ETS ya conoce: los edificios y las estancias se convierten en plantas y estancias, las direcciones de grupo llegan con nombre y tipo, las funciones ETS se convierten en dispositivos con sus objetos de grupo ya asignados. - Configure manually (No file needed): describa usted mismo el edificio. Lo mejor cuando no hay un proyecto ETS a mano, o cuando la visualización no debe seguirlo.
- Restore a HyperVisu backup instead: una copia de seguridad recupera un servidor completo (estancias, dispositivos, usuarios y servicios), por lo que no hace falta el resto del asistente. Choose a file no abre un selector de archivos: abandona el asistente y abre la página Backup & Restore, donde se restaura el archivo en Restore from file (véase «Backup & Restore»). Allí no se le pide contraseña ni una selección de servicios: se restaura el archivo completo y sustituye lo que hay en el servidor, incluido el administrador que acaba de crear.
📘 Nota: Puede cambiar de opinión más tarde: cambiar de modo le devuelve al paso 4, porque las dos pantallas siguientes pertenecen a la otra ruta. Lo que introdujo en la ruta abandonada se conserva por si vuelve a ella.
Paso 2 — Proyecto y ubicación
«Name the project and place it on the map.»
| Campo | Finalidad |
|---|---|
| Project name | Cómo se identifica esta instalación |
| Installer reference | Su propio número de proyecto |
| App language | El idioma en que se abren las apps móvil y web; cada usuario puede cambiarlo |
| City → Get coordinates | Escriba la ciudad y deje que el servidor busque la latitud y la longitud |
| Latitude / Longitude | Rellenadas por la búsqueda, o escritas a mano |
| Timezone | El reloj con el que funciona el servidor |
Las coordenadas y la zona horaria determinan las horas de salida y puesta del sol, las automatizaciones programadas y cada marca de tiempo que escribe el servidor: ajuste estos valores con precisión.
Paso 3 — Interfaz del bus KNX
«Connect to the bus.» El asistente analiza la red una vez, al abrirse el paso, en busca de interfaces KNX/IP y muestra las que han respondido como tarjetas con el nombre de la interfaz, el tipo (Interface o Router), la dirección y el número de serie. Haga clic en Scan again para repetir el análisis.
Si no responde nada, o la interfaz está en otra subred o detrás de una VPN, use Enter an address manually: escriba la dirección y el puerto en el único campo, por ejemplo 192.168.1.20:3671. Sin puerto se usa 3671.
También debe definir:
- Connection type: Tunnel (UDP, para una interfaz KNX/IP) o Multicast (para un router KNX/IP). Al seleccionar una tarjeta detectada se define por usted; para una dirección escrita a mano, defínalo usted.
- HyperVisu physical address: la dirección individual que el propio servidor adopta en el bus. Viene rellenada con
1.1.250y debe estar libre en el bus.
La prueba de conexión. Haga clic en Run connection test para ver hasta dónde llega la conexión. Aparecen cinco resultados:
| Resultado | Qué le indica |
|---|---|
| Host reachable | La interfaz responde en la red (yes, con el tiempo de respuesta, o no). |
| Port 3671 / UDP | Si la interfaz respondió a una solicitud de descripción. Puede indicar not answered mientras el túnel está abierto: algunas interfaces solo responden a una conexión real. No es una avería. |
| Tunnel | Si se pudo abrir un túnel (yes o no). |
| Assigned address | La dirección que la interfaz asignó al túnel de prueba. |
| Telegrams seen | Cuántos telegramas llegaron mientras la prueba escuchaba el bus. |
Cuando el túnel se abre, el panel muestra Tunnel open y el pie dice «Tunnel open — the bus answers.»
Un túnel abierto demuestra la conexión; solo Telegrams seen demuestra tráfico real en el bus. Una vez abierto el túnel, la prueba escucha unos cinco segundos, por lo que 0 en un bus tranquilo no es una avería. Para ver tráfico, haga clic en Test again y accione de inmediato un pulsador de pared mientras se ejecuta la prueba.
📘 Nota: Cuando vuelve a ejecutar el asistente en un servidor que ya está conectado al bus, la prueba no abre un segundo túnel, porque eso podría interrumpir la conexión en curso. Informa de la conexión activa y no cuenta telegramas.
Si el túnel no se abre, el panel muestra No response y el asistente sugiere comprobar tres cosas: el tunelado habilitado en la interfaz, ningún otro cliente ETS ocupando todos los canales, y el servidor y la interfaz en la misma VLAN.
Este paso nunca bloquea: puede continuar sin probar, o tras una prueba fallida, y corregir la conexión más tarde.
¿Aún no hay bus en la instalación? Haga clic en I'll configure KNX later. El asistente se aplica sin conexión al bus: las estancias, los dispositivos y los servicios se crean con normalidad, y todo lo vinculado a KNX permanece en silencio hasta que se defina una interfaz en Connections (véase «Connections»).
Paso 4 — Servicios
«Which services should run?» Los interruptores se agrupan en tres secciones, las mismas que en la página Services. Cada sección lleva una etiqueta que indica lo que cuesta un cambio en ella:
| Sección | Etiqueta | Significado |
|---|---|---|
| Services | Changes need a restart | Los servicios opcionales que ofrece este servidor, como la base de datos de historial, los paneles de control, Node-RED, el streaming de cámaras y Home Assistant. Solo se inician o se detienen al reiniciar el servidor: el asistente ofrece el reinicio tras la aplicación (véase «Final step — Review & apply» más abajo). |
| Communication protocols | Applied immediately | Los protocolos con los que el servidor se comunica con los dispositivos. |
| Application services | no restart needed | Tiempo meteorológico, precios de la energía y correo electrónico. |
Activados por defecto: los protocolos KNX y Virtual, e InfluxDB (la base de datos de historial). El botón situado sobre las tarjetas muestra cuántos están habilitados y los restablece a estos valores por defecto.
Una tarjeta con la insignia API key needed requiere además una clave o credenciales: complételas en la página Services después del asistente (véase «Services & Protocols»).
Habilite solo lo que usa este proyecto: cada servicio consume memoria y tiempo de arranque. Todo puede activarse más tarde desde Services & protocols.
Ruta manual — Estructura del edificio
(Los pasos 5–6 dependen del modo de configuración. Esta pantalla y la siguiente aparecen en la ruta manual.)
«List the floors and their rooms.»
- El asistente empieza con una Ground floor (nivel 0). Para añadir otra planta, escriba su nombre en la línea Add a floor y pulse Enter.
- Escriba el nombre de una estancia y pulse Enter para añadir la siguiente: una estancia por línea, tan rápido como pueda escribir.
- Para añadir muchas a la vez, use Add several rooms at once: elija la planta, escriba los nombres separados por comas («Bedroom 2, Bedroom 3, Dressing») y haga clic en el botón de añadir.
- Los iconos son opcionales por ahora: la app usa el nombre de la estancia hasta que defina uno.
- Haga clic en Continue to categories. El botón permanece deshabilitado hasta que haya al menos una estancia.
📘 Nota: El asistente no puede definir el nivel de una planta. Las plantas se numeran 0, 1, 2… en el orden en que las añade, por lo que un sótano añadido aquí recibe un nivel positivo. Para darle después un nivel negativo, abra Building → Floors, edite la planta y cambie su Floor Number (véase «Building Structure & Categories»).
Ruta manual — Categorías
«Decide how the app groups devices.» Las categorías se convierten en los mosaicos de la pantalla de inicio de la app y en los filtros de cada estancia; un dispositivo pertenece a una categoría y a una estancia.
El asistente crea siete categorías por defecto: Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Haga clic en un nombre para cambiarlo.
- Elimine una categoría que el proyecto no necesite.
- Add a category propia (nombre + icono), por ejemplo «Home cinema».
A continuación, haga clic en Review everything para ir al paso final (véase «Final step — Review & apply» más abajo).
📘 Nota: La ruta manual no crea dispositivos. Los añade por estancia desde la página Devices después de la configuración (véase «The Devices Workspace»).
Ruta ETS — Selección de importación
(Esta pantalla sustituye a este artículo cuando ha elegido «Import an ETS project».)
«Choose what to import.»
- Arrastre el archivo
.knxproj(exportación de proyecto de ETS 5 o ETS 6) a la zona Drop the .knxproj file here, o haga clic en esa zona para elegir el archivo. No hay un botón de examinar aparte. - Si el proyecto está protegido con contraseña en ETS, introduzca la Project password y haga clic en Unlock and read. La contraseña se usa para leer el archivo y nunca se guarda.
- El asistente lee el proyecto y ofrece tres partes seleccionables, cada una con los recuentos reales de su archivo:
- Building structure: las plantas y estancias que describe el proyecto ETS («3 floors · 14 rooms»).
- Group addresses: la tabla completa de direcciones, para que el monitor de bus y el selector de direcciones conozcan cada dirección por su nombre; se muestran los recuentos de direcciones con y sin tipo.
- Devices from ETS functions: cada función ETS se convierte en un dispositivo, ya vinculado a sus direcciones de grupo.
- Desmarque lo que no desee y haga clic en Continue to categories. Mantenga marcada Building structure: sin ella no hay estancias donde archivar los dispositivos y no se crea nada a partir del proyecto.
La ruta ETS muestra a continuación la pantalla Categories con las categorías que ha producido el proyecto: una por tipo de dispositivo que describe. Renómbrelas, cambie los iconos o añada una que el proyecto no cubra, como en la pantalla Categories de la ruta manual. Una categoría que todavía usan dispositivos no puede eliminarse hasta que esos dispositivos se muevan a otra categoría en la pantalla de revisión. Haga clic en Review rooms and devices para pasar a la revisión (véase «ETS branch — Review import» más abajo).
Ruta ETS — Revisión de la importación
«Check what we found.» Es la pasada de corrección sobre todo lo que va a crear la importación, organizada como un árbol de plantas, estancias y dispositivos. Antes de aplicar puede:
- Renombrar estancias y dispositivos que todavía parecen etiquetas de ETS: el nombre ETS original sigue visible («was … in ETS»), con una acción Revert.
- Cambiar el tipo de widget de un dispositivo donde la importación acertó mal: las direcciones vinculadas limitan qué tipos encajan.
- Mover dispositivos a otra estancia o categoría, o Exclude los que la app no deba mostrar.
- Confirmar los tipos de punto de datos deducidos: las direcciones sin DPT en ETS reciben uno deducido, marcado para confirmación.
- Trabajar el grupo «No room found»: dispositivos reales cuya estancia no se pudo determinar. Mueva cada uno a una estancia; lo que quede se crea sin ella.
📘 Nota: Si el proyecto no declara funciones ETS, el asistente deduce los dispositivos a partir de los canales de los actuadores y marca cada uno como guessed: compruebe estancias, nombres y tipos antes de continuar.
Los filtros («Needs attention», «Renamed»), la búsqueda y un acceso directo «Next room with an issue» le ayudan a recorrer rápidamente los proyectos grandes. Puede aplicar con problemas pendientes y corregirlos después en Devices. Cuando termine, haga clic en Review everything.
Paso final — Revisar y aplicar
«Project Review» resume todo en seis tarjetas (modo de configuración y proyecto, ubicación y hora, bus KNX, servicios, edificio, dispositivos y direcciones), cada una con un enlace Edit que salta a su paso.
Los problemas bloqueantes se listan sobre las tarjetas (por ejemplo, «No coordinates — the apply will stop on the settings stage», «No rooms — the app will open empty»). Corríjalos, o confirme que son intencionados.
Qué hace la aplicación, por orden:
- Escribir los ajustes del servidor: ubicación, zona horaria, interfaz de bus y los servicios que habilitó.
- Crear la estructura: plantas, estancias, categorías y (en la ruta ETS) dispositivos y direcciones de grupo.
- Reiniciar el puente KNX: una reconexión; el bus en sí no se toca.
Haga clic en Apply and finish. Un panel de progreso en vivo sigue las fases y muestra el tiempo transcurrido. Cuando indica Setup complete, el asistente se cierra y se abre la página System.
📘 Nota: Si activó o desactivó un servicio de la sección Services (véase «Paso 4 — Servicios» más arriba), aparece en su lugar el cuadro de diálogo Reboot to finish setup: estos servicios solo se inician o se detienen al reiniciar el servidor, lo que tarda unos dos minutos. Haga clic en Reboot now, o en Later y reinicie desde la página System cuando le convenga.
Si algo sale mal: la ejecución se detiene en la fase que falla y se lo indica. Lo que escribieron las fases anteriores permanece; Retry vuelve a ejecutar todas las fases, así que compruebe primero el edificio en la página System si el fallo ocurrió tarde. Si el servidor se reinició durante la aplicación, el asistente indica que se perdió el trabajo: compruebe el resultado en la página System y vuelva a ejecutar el asistente si falta la estructura.