Integración de Frigate con reTerminal
Introducción
En la era actual de integración fluida de tecnología inteligente en nuestras vidas diarias, la demanda de automatización del hogar inteligente y segura es más fuerte que nunca. Imagina un escenario donde tu hogar no solo satisface tus necesidades, sino que también detecta y te alerta sobre actividades sospechosas en tu jardín. Aquí es donde la combinación de hardware avanzado y software de código abierto juega un papel fundamental. En este artículo, exploraremos la sinergia entre Seeed Studio reTerminal, Home Assistant OS y el complemento Frigate con Coral AI USB TPU. Este trío ofrece una oportunidad única para una configuración centralizada, consciente de la privacidad y dirigida por IA para la automatización del hogar, mejorando tu estilo de vida mientras asegura tu seguridad. Acompáñanos a explorar las ventajas y el potencial ilimitado de esta fusión en la vanguardia de la vida inteligente moderna.
Frigate
Frigate surge como un notable grabador de video en red (NVR) de código abierto, diseñado para detección de objetos en tiempo real impulsada por IA. La característica distintiva de Frigate radica en su procesamiento localizado, asegurando que todos los cálculos se realicen en tu hardware personal. Este enfoque garantiza la máxima privacidad, ya que las transmisiones de tus cámaras nunca salen fuera de los límites de tu hogar. Con Frigate, obtienes una herramienta poderosa que te permite mejorar la seguridad y el monitoreo a través de tecnología avanzada de reconocimiento de objetos, manteniendo el control total sobre tus datos.
Home Assistant
Home Assistant OS es un sistema operativo diseñado específicamente para ejecutar Home Assistant, una plataforma de automatización del hogar de código abierto. Home Assistant te permite controlar y automatizar varios dispositivos inteligentes y servicios en tu hogar. Home Assistant OS proporciona un entorno optimizado para ejecutar Home Assistant. Viene preinstalado con los componentes necesarios para configurar y gestionar tus dispositivos inteligentes, integrar diferentes protocolos y plataformas, y crear rutinas de automatización.
Empezando
Antes de comenzar con este proyecto, es posible que necesites preparar tu hardware y software de antemano, tal como se describe aquí. También necesitarás cámaras IP compatibles con este proyecto. Puedes ver las cámaras compatibles en el sitio oficial de Frigate.
Preparación del hardware
reTerminal | Coral USB Accelerator |
---|---|
![]() | ![]() |
Teniendo en cuenta los requisitos de potencia del acelerador USB Coral, recomendamos encarecidamente invertir en un hub USB de alta calidad. Este hub proporcionará la potencia suficiente para satisfacer las necesidades del acelerador Coral, asegurando un rendimiento estable y óptimo.
Preparación del software
Recomendamos instalar la última versión de Raspberry Pi 64 bit OS desde su sitio web oficial. Si prefieres instalar un nuevo sistema operativo Raspbian, por favor sigue los pasos descritos en esta guía.
Instalar Home Assistant Supervised OS en Raspberry Pi.
Instalar Home Assistant Supervised en tu Raspberry Pi 4 es un proceso completo que abarca varios pasos clave para asegurar una instalación exitosa.
En algunos pasos, si estás conectado a través de Wi-Fi, puedes perder la conexión. Se recomienda utilizar una conexión LAN en su lugar.
Paso 1: Mejora tu sistema
- Comienza ejecutando un registro de actualización del sistema con el siguiente comando:
sudo apt update
- Luego, procede a instalar las siguientes dependencias:
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y
- Arregla las instalaciones rotas
sudo apt --fix-broken install
- Reinicia el reTerminal
sudo reboot
Paso 2: Integrar Docker
Instalar Docker es fundamental. Es importante evitar instalar Portainer, ya que podría afectar negativamente el proceso de instalación en general. Ejecuta los siguientes comandos:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
- Añade el usuario de Docker al sistema
sudo usermod -aG docker pi
- Verifica si Docker está funcionando correctamente
docker --version
Paso 3: Abordando la versión de CGroup
- La compatibilidad del Supervisor de Home Assistant depende de un CGroup v1 específico de Docker. Para asegurar esta compatibilidad, se deben realizar los siguientes cambios:
sudo nano /etc/default/grub
- Añade esta línea y guárdala.
systemd.unified_cgroup_hierarchy=false
- Abre este archivo
sudo nano /boot/cmdline.txt
- Añade esta línea al final de la frase y guárdala.
systemd.unified_cgroup_hierarchy=false apparmor=1 security=apparmor
Paso 4: Instalar OS-Agent (ver. 1.3)
Descarga el OS-Agent adecuado según la arquitectura de tu CPU y luego procede a instalarlo: Para Raspberry Pi 64 bit OS es linux aarch64.
wget https://github.com/home-assistant/os-agent/releases/download/1.3.0/os-agent_1.3.0_linux_aarch64.deb
- Instalar el agente de Home Assistant
sudo dpkg -i os-agent_1.3.0_linux_aarch64.deb
- Asegúrate de que la instalación fue exitosa ejecutando
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
Paso 5: Adquirir Home Assistant Supervised
- Descarga el paquete más reciente de Home Assistant Supervised:
wget https://github.com/home-assistant/supervised-installer/releases/download/1.3.0/homeassistant-supervised.deb
Paso 6: Instalación de Home Assistant Supervised
Importante: Este paso requiere una conexión LAN, ya que el Wi-Fi podría interrumpirse durante el proceso:
sudo dpkg -i homeassistant-supervised.deb
Paso 7: Abordar errores de instalación
En caso de errores de instalación, corrígelos ejecutando:
sudo apt --fix-broken install
Una vez corregidos los errores, aparecerá una pantalla azul que te permitirá seleccionar el modelo Raspberry Pi4 64.

Paso 8: Finalizar la instalación y configurar Wi-Fi
Espera unos minutos para que Home Assistant sea accesible en http://[tu_raspberry_IP]:8123.
Si encuentras problemas de conectividad Wi-Fi después de reiniciar, sigue estos pasos:
- Para habilitar 'dhcpcd', ejecuta el siguiente comando:
sudo systemctl enable dhcpcd
- Deshabilita el servicio de red con el comando:
sudo systemctl disable networking
- Reinicia el Raspberry Pi para aplicar los cambios:
sudo reboot
Para resolver los "problemas del Administrador de Red," (encuéntralo en la configuración) puedes solucionar el problema iniciando y luego habilitando el Administrador de Red. Utiliza el siguiente comando para hacerlo:
sudo systemctl enable NetworkManager
Instalar MQTT Broker
Navega a Configuración > Complemento > Haz clic en MQTT Broker.
Haz clic en instalar y, después de la instalación, habilita el inicio automático al arrancar.
Navega a Configuración > Dispositivos y Servicios > Configura MQTT Broker.
Instalar Frigate (Acceso Completo)
Paso 1: Clonar el Repositorio
Navega a Configuración > Complemento > Tienda de complementos > Menú > Repositorios
Añade la URL del repositorio: https://github.com/blakeblackshear/frigate-hass-addons. Entonces verás el complemento Frigate en la Tienda de complementos.
Paso 2: Instalar el complemento NVR Frigate de Acceso Completo.
Paso 3: Crear frigate.yml
- Para continuar con este paso, necesitarás un editor de archivos. Accede a la opción "Explorar sistema de archivos" ubicada en la esquina superior izquierda del editor de archivos.

- Crea un nuevo archivo llamado frigate.yml

- Luego, puedes usar el siguiente fragmento de código para evaluar si puedes recuperar correctamente las transmisiones de video RTSP de tus cámaras IP. Copia el código proporcionado y pégalo en tu archivo
frigate.yml
. Se recomienda seguir las pautas proporcionadas en el sitio oficial de Frigate para instrucciones completas. Recuerda reemplazar los marcadores de posición con el nombre de tu cámara, resolución y IP del flujo de cámara. Esta personalización garantizará una integración precisa con tu configuración de cámaras.
mqtt:
enabled: False
cameras:
RPIcam: # <------ Nombre de la cámara
ffmpeg:
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- El flujo que deseas usar para detección
roles:
- detect
detect:
enabled: False # <---- desactiva la detección hasta que tengas un flujo de cámara funcional
width: 1280 # <---- actualiza según la resolución de tu cámara
height: 720 # <---- actualiza según la resolución de tu cámara
fps: 5
Paso 4: Iniciar Frigate
- Antes de iniciar Frigate, asegúrate de que el modo de protección esté desactivado.
- Una vez que inicies Frigate, es importante monitorear el registro de posibles problemas. Si no surgen problemas, procede a hacer clic en el ícono de Frigate en la barra lateral. Esto te dará acceso a la interfaz y funcionalidades de Frigate.
Paso 5: Verifica el flujo
Si todo funciona correctamente, verás el flujo.

Paso 6: Habilitar la detección de objetos
Para lograr esto, es esencial el Coral USB Accelerator Edge TPU. Mientras que puedes conectarlo directamente a un puerto USB, podría no funcionar como se espera debido a sus mayores requerimientos de energía. Por lo tanto, recomendamos encarecidamente utilizar un hub USB confiable. Esto asegurará un suministro de energía estable y un rendimiento óptimo para el Coral USB Accelerator, mejorando su compatibilidad y efectividad.
- Modifica el archivo frigate.yml con el siguiente código fuente
mqtt:
enabled: False
detectors: # <---- agrega detectores
coral:
type: edgetpu
device: usb
cameras:
RPIcam: # <------ Nombre de la cámara
ffmpeg:
input_args: preset-rtsp-udp
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- El flujo que deseas usar para detección
roles:
- detect
detect:
enabled: True # <---- habilita la detección
width: 1280 # <---- actualiza según la resolución de tu cámara
height: 720 # <---- actualiza según la resolución de tu cámara
fps: 5
- Reinicia el complemento Frigate. Luego haz clic en el ícono de Frigate en la barra lateral. Luego haz clic en el flujo y tendrás la vista completa del flujo. Por defecto puedes detectar personas y dibujar un cuadro delimitador.


Y aquí está la demo

Puedes detectar muchos objetos diferentes y también enviar notificaciones a tu teléfono móvil. Para eso, necesitarás cambiar el archivo frigate.yml. Te recomendamos que eches un vistazo a las siguientes guías.
Recursos
[Página Web] Documentación oficial de Frigate
[Página Web] Foro de Home Assistant
Soporte técnico
¡Gracias por elegir nuestros productos! Estamos aquí para brindarte diferentes tipos de soporte para asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.