Home Automation System · v2.0

DOMOTEC

Sistema de domótica distribuido sobre Raspberry Pi 5 y VirtualBox, interconectado mediante ZeroTier con control centralizado en Home Assistant.

2 Casas
HA Plataforma
ZT Red VPN
24/7 Monitoreo
Ver Arquitectura Documentación
SCROLL

Dos casas. Un ecosistema.

Arquitectura distribuida con dos instancias de Home Assistant sincronizadas via ZeroTier SDN.

🏠 CASA 1 · PRINCIPAL
Raspberry Pi 5
Home Assistant OS · Nativo
Hardware RPi 5 · 4GB RAM
SO HAOS · ARM64
Almacenamiento SD Card 32GB
Estado ● ONLINE
IP Local 192.168.1.210
IP ZeroTier 172.29.254.219
ZeroTier
SDN
VPN
P2P
🏡 CASA 2 · SECUNDARIA
VirtualBox VM
Home Assistant OS · Virtualizado
Hypervisor VirtualBox 7.x
SO Huésped HAOS · x86_64
RAM asignada 4GB
Estado ● ONLINE
IP Local 192.168.1.76
IP ZeroTier 172.29.179.54
🧠
Capa de Control
Home Assistant como núcleo de automatización. Gestión de entidades, automatizaciones, scripts y dashboards.
🔗
Capa de Red
ZeroTier crea una red virtual P2P entre ambas instancias. Sin necesidad de VPN tradicional ni apertura de puertos.
📡
Capa de Dispositivos
Dispositivos Tuya integrados via integración oficial, dispositivos creados virtualmente para pruebas, y sensores comunitarios de uso público. Cada entidad expuesta en el bus de HA.
🔐
Capa de Seguridad
Acceso remoto cifrado via ZeroTier. Autenticación MFA en HA. Backups automáticos programados.
📊
Capa de Datos
InfluxDB + Grafana para telemetría histórica. Recorder de HA para estados. Alertas configurables.
🤖
Capa de Automatización
Blueprints personalizados. Condiciones temporales, de presencia y de estado.

Ecosistema conectado

Dispositivos integrados en el sistema, organizados por protocolo y función.

🚶
ACTIVO
Sensor de movimiento
Detector de movimiento + notificación
Tuya Binary Sensor Notificación
💡
ACTIVO
Sensor de luz ambiental
Medidor de la luz del entorno
Tuya HA Sensor Lux
📹
ACTIVO
Cámara IP · Detección mov.
Cam_ función detección de movimiento
Tuya HA Camera Motion
🎥
ACTIVO
Cámara IP · Grabación
Cam_ función grabación de imagen
Tuya HA Camera Recording
🎯
ACTIVO
Cámara IP · Seguimiento
Cam_ función seguir al objetivo detectado
Tuya HA Camera Tracking
🌡️
ACTIVO
Sensor Temp. y Humedad
Sensor ambiental con Wifi
Tuya Wi-Fi HA Sensor
🔌
ACTIVO
Enchufe inteligente
Enchufe Wifi con medición de consumo
Tuya Wi-Fi Energía
📶
ACTIVO
Router Movistar
Gateway principal · Red local
Wi-Fi IP
📡
ACTIVO
Router Zyxel
Punto de acceso secundario
Wi-Fi IP
🔗
ACTIVO
ZeroTier
Red SDN distribuida · VPN P2P
Add-on HA VPN Cifrado
🗄️
ACTIVO
InfluxDB
Base de datos de series temporales
Docker HA Integration TimeSeries
📊
ACTIVO
Dashboards de HA
Paneles de visualización nativos
Lovelace HA Nativo
📈
ACTIVO
Grafana
Visualización avanzada de métricas
Docker InfluxDB
🤖
ACTIVO
IA complementaria
IA para automatización más sencilla
AI HA Integration
💾
ACTIVO
NAS
Almacenamiento en red
Red local HA Integration
🔊
ACTIVO
Echo · Alexa
Asistente de voz Amazon
Wi-Fi Alexa TTS
🌐
ACTIVO
Google
Asistente Google Home integrado
Wi-Fi Google TTS

Interconexión ZeroTier

Red virtual SDN que conecta ambas instancias de Home Assistant sin exposición pública de puertos.

// MAPA DE RED · DOMOTEC
🏠 CASA 1 · Raspberry Pi 5
Sensores y dispositivos USB Passthrough
Puerto por defecto :8123
ZeroTier Client 172.29.254.219
Dispositivos de red Router M 2,4GHz
SDN · E2E Encrypted
Network ID
ebe7fbd44519d454
🏡 CASA 2 · VirtualBox
Home Assistant OS 192.168.1.76
ZeroTier Client 172.29.179.54
Sensores Comunitarios Openweathermap
VirtualBox Host NAT / Bridged
 La comunicación entre instancias se realiza sobre la red ZeroTier (ID: ebe7fbd44519d454). Casa 1 en 172.29.254.219 · Casa 2 en 172.29.179.54. El tráfico viaja cifrado extremo a extremo sin necesidad de abrir puertos en el router.

Guía de instalación

Selecciona un paso para ver la documentación completa.


Memoria – Home Assistant

Documentación técnica completa del proyecto DOMOTEC. Autor: Pedro · Versión 1.0

Autor Pedro Y Daniel
Proyecto DOMOTEC
Tecnología Home Assistant
Tipo Memoria técnica
Versión 1.0 · BORRADOR
01 Introducción
09 Sensores y entidades
02 Objetivos
10 Automatizaciones
03 ¿Qué es HA?
11 Dashboard
04 Arquitectura
13 Base de datos
05 Instalación
14 Ampliaciones
07 YAML
15–16 Problemas / Conclusiones
01 📋 Introducción

El proyecto DOMOTEC nace con el objetivo de desarrollar un sistema domótico centralizado utilizando Home Assistant como plataforma principal. La idea es disponer de una única interfaz capaz de controlar sensores, dispositivos, automatizaciones y paneles de visualización para supervisar el estado de una vivienda o entorno.

Durante el desarrollo se trabajó en múltiples frentes que se combinan para dar lugar al sistema completo:

  • Configuración inicial del servidor
  • Integración de sensores
  • Creación del Dashboard
  • Automatización mediante YAML
  • Organización visual
  • Conexión entre componentes
Automatización Monitorización Diseño visual Escalabilidad Gestión centralizada
02 🎯 Objetivos del proyecto

Objetivo general:

Diseñar e implementar una plataforma domótica basada en Home Assistant capaz de centralizar dispositivos y automatizar tareas.

Objetivos específicos completados:

  • Comprender el funcionamiento de Home Assistant
  • Configurar el entorno de trabajo
  • Crear dashboards de visualización
  • Integrar sensores en el sistema
  • Aplicar automatizaciones YAML
  • Mejorar el sistema de almacenamiento
  • Escalar el sistema completo

Objetivos futuros:

  • Crear sistema totalmente autónomo
  • Añadir sistema de alertas
  • Integración con aplicación móvil
  • Generación de informes automáticos
03 🏠 ¿Qué es Home Assistant?

Home Assistant es una plataforma de automatización doméstica de código abierto orientada al control local, sin depender de servicios en la nube de terceros.

  • Software Open Source con comunidad activa
  • Compatible con cientos de integraciones y dispositivos
  • Configuración visual (UI) y mediante archivos YAML
  • Acceso desde navegador vía puerto 8123
  • Motor de automatización avanzado

Flujo de componentes principales:

Capa usuario
Dashboard UI
Core
Home Assistant
Integraciones
+3.000 add-ons
Base de datos
SQLite / MySQL
04 🏗️ Arquitectura general del sistema

El servidor central recibe datos de sensores y ejecuta acciones automáticas. La arquitectura distribuye la lógica en tres capas diferenciadas que se comunican entre sí:

Entrada
Sensores
Núcleo
HA Server
Salida
Dashboard
Lógica
Automatizaciones

Internet conecta el sistema al exterior, permitiendo acceso remoto a través del navegador sin necesidad de exponer puertos directamente gracias a la red ZeroTier.

05 ⚙️ Instalación y configuración inicial

Proceso de puesta en marcha del entorno DOMOTEC desde cero, incluyendo la instalación del sistema operativo hasta la configuración básica de usuario.

  • Instalación del entorno (HAOS sobre Raspberry Pi 5)
  • Primer acceso via navegador en puerto 8123
  • Configuración del usuario administrador
  • Detección automática de dispositivos en red
  • Configuración básica del sistema

Configuración del servidor:

Nombre
DOMOTEC
Zona horaria
Europe/Madrid
Idioma
Español
Puerto web
8123
06 🌐 Redes y funcionamiento del puerto 8123

Uno de los conceptos tratados fue por qué Home Assistant utiliza el puerto 8123 como interfaz web principal. Este puerto es el estándar de la plataforma para servir la interfaz de usuario.

Puerto
8123
Función
Interfaz web
Protocolo
HTTP / HTTPS
Ejemplo URL
IP_LOCAL:8123

El flujo de acceso sigue el camino: Usuario → Navegador → Puerto 8123 → Home Assistant. También se revisó el concepto de red virtual y cómo los servicios quedan aislados pero comunicados entre sí.

07 📝 YAML dentro de Home Assistant

YAML es el lenguaje de configuración utilizado en Home Assistant para describir todos los componentes del sistema de manera declarativa y legible.

  • Automatizaciones y scripts
  • Definición de sensores personalizados
  • Configuración de integraciones
  • Plantillas y helpers
Basado en indentación Fácil lectura Declarativo
YAML · Ejemplo sensor MQTT
sensor:
  - platform: mqtt
    name: "Temperatura salón"
    state_topic: "home/salon/temperatura"
    unit_of_measurement: "°C"
08 🔗 Integración de dispositivos

El objetivo de esta sección es conectar dispositivos físicos al sistema para que sean representados como entidades dentro de Home Assistant y visibles en el Dashboard.

El flujo de integración sigue el camino: Dispositivo → Entidad → Dashboard

  • Detección automática de dispositivos en red local
  • Creación de entidades digitales (entity_id)
  • Configuración manual para dispositivos no detectados
09 📡 Sensores y entidades

Una entidad es la representación digital de un dispositivo físico dentro de Home Assistant. Cada sensor, interruptor o bombilla conectada se convierte en una entidad con estado, historial y acciones disponibles.

Tipo
sensor
Tipo
binary_sensor
Tipo
switch
Tipo
light

Ejemplo de entity_id de sensor de movimiento:

Entity ID · Ejemplo
binary_sensor.movimiento
# Acceso en dashboard:
# Estado | Historial | Acciones
10 🤖 Automatizaciones

Las automatizaciones son el núcleo funcional del sistema. Se definen mediante YAML con tres bloques principales: trigger (disparador), condition (condición) y action (acción).

Trigger
Detecta cambio
Condition
Verificación
Action
Ejecuta acción
Mode
Evita repeticiones
YAML · Automatización sensor movimiento
trigger:
  - platform: state
    entity_id:
      binary_sensor.sensor_de_movimiento_crepuscular_wifi_movimiento
    to: "on"
condition: []
action:
  - delay: "00:00:30"
mode: single
11 📊 Dashboard

El Dashboard es la interfaz principal de visualización y control. Su diseño busca claridad, accesibilidad y organización eficiente de la información.

  • Organización por áreas funcionales
  • Cabeceras y títulos descriptivos
  • Posicionamiento lógico de tarjetas
  • Diseño responsive para móvil y escritorio

Estructura básica del panel:

Sección 1
Sensores
Sección 2
Automatizaciones
Sección 3
Historial
12 🎨 Personalización visual

Mejoras visuales planificadas para aumentar la usabilidad y el atractivo del sistema. El objetivo es una mayor facilidad de uso mediante una interfaz más intuitiva.

  • Banner personalizado del proyecto
  • Tarjetas personalizadas por área
  • Esquema de colores coherente
  • Diseño completamente responsive
13 🗄️ Base de datos y almacenamiento

Se valoró una integración con MySQL para mejorar el rendimiento del historial de estados. Home Assistant usa SQLite por defecto, pero para proyectos más grandes se recomienda MySQL o MariaDB.

  • Historial completo de estados de entidades
  • Consultas avanzadas de datos temporales
  • Mayor rendimiento en entornos con muchos sensores
Pendiente: configurar la conexión con MySQL/MariaDB y migrar el historial existente.
14 🚀 Posibles ampliaciones

El sistema está diseñado con escalabilidad en mente. Las siguientes expansiones están identificadas como siguientes pasos lógicos del proyecto:

App móvil nativa Integración con IA Sistema de cámaras Alarmas y alertas Monitorización de energía Notificaciones push
15 🔧 Problemas encontrados y soluciones
Problema: Dashboard inestable. Posibles causas: tarjetas mal configuradas, caché del navegador o actualización parcial de HA. Solución: limpiar caché y revisar configuración de tarjetas.
Problema: Automatizaciones repetidas. El mismo trigger se ejecutaba múltiples veces. Solución aplicada: uso de delay + mode: single para evitar ejecuciones paralelas.
16 Conclusiones

El proyecto DOMOTEC permitió comprender el funcionamiento de Home Assistant desde la instalación inicial hasta la automatización avanzada de dispositivos.

  • Comprender la estructura completa de HA
  • Crear paneles de visualización funcionales
  • Integrar sensores físicos en el sistema
  • Automatizar procesos mediante YAML

Trabajo futuro:

  • Completar todas las integraciones planificadas
  • Mejorar el sistema de almacenamiento con MySQL
  • Finalizar y estabilizar el entorno productivo
// Valoración del proyecto

DOMOTEC demuestra que es posible construir un sistema domótico profesional, centralizado y escalable utilizando herramientas de código abierto como Home Assistant, con una curva de aprendizaje razonable y resultados muy satisfactorios.