Integración de Frigate con reTerminal DM
Introducción
En la era actual de la integración perfecta de la tecnología inteligente en nuestra vida diaria, la demanda de una automatización del hogar inteligente y segura es más fuerte que nunca. Imagina un escenario en el que tu hogar no solo satisface tus necesidades, sino que además detecta y te alerta rápidamente sobre actividades sospechosas en tu patio trasero. Aquí es donde la combinación de hardware avanzado y software de código abierto toma el protagonismo. En este artículo, exploraremos la sinergia entre Seeed Studio reTerminal DM, Home Assistant OS y el complemento Frigate junto con el Coral AI USB TPU. Este trío ofrece una oportunidad única para una configuración centralizada, respetuosa con la privacidad y basada en IA, que mejora tu estilo de vida mientras garantiza la seguridad. Únete a nosotros para profundizar en las ventajas y el potencial ilimitado de esta fusión, a 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 la detección de objetos en tiempo real mediante IA. La característica distintiva de Frigate reside en su procesamiento localizado, lo que garantiza que todos los cálculos se realicen en tu propio hardware. Este enfoque asegura la máxima privacidad, ya que las transmisiones de tus cámaras nunca salen del perímetro de tu hogar. Con Frigate, obtienes una herramienta poderosa que te permite mejorar la seguridad y el monitoreo mediante 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 diversos dispositivos y servicios inteligentes en tu hogar.
Home Assistant OS ofrece un entorno optimizado y simplificado para ejecutar Home Assistant. Viene preinstalado con los componentes necesarios para configurar y gestionar tus dispositivos inteligentes, integrarse con diferentes protocolos y plataformas, y crear rutinas de automatización.
Primeros pasos
Antes de comenzar este proyecto, es posible que necesites preparar tu hardware y software con anticipación, como se describe aquí. Además, 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 DM | Coral USB Accelerator |
---|---|
![]() | ![]() |
Considerando los requerimientos de potencia del acelerador USB Coral, recomendamos encarecidamente invertir en un hub USB de alta calidad. Este hub proporcionará la energía suficiente para cubrir las necesidades del acelerador Coral, garantizando un rendimiento estable y óptimo.
Preparación del software
Se recomienda instalar la última versión del sistema operativo Raspberry Pi 64 bits desde su sitio oficial. Si prefieres instalar un nuevo sistema operativo Raspbian, sigue los pasos detallados en esta guía.
Instalación de Home Assistant Supervised OS en Raspberry Pi
Instalar Home Assistant Supervised en tu reTerminal DM basado en Raspberry Pi CM4 es un proceso integral que combina varios pasos críticos para asegurar una configuración exitosa.
En algunos pasos, si estás conectado a través de Wi-Fi, podrías perder la conexión. Se recomienda utilizar una conexión LAN en su lugar.
Paso 1: Mejorar el sistema
- Comienza ejecutando una actualización del sistema con el siguiente comando:
sudo apt update
- A continuación, 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
- Repara las instalaciones dañadas
sudo apt --fix-broken install
- Reinicia el reTerminal
sudo reboot
Paso 2: Integrar Docker
La instalación de Docker es fundamental. Es vital evitar la instalación de Portainer, ya que podría afectar negativamente el proceso general de instalación. Ejecuta los siguientes comandos:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
- Agrega el usuario Docker al sistema
sudo usermod -aG docker pi
- Verifica que Docker funcione correctamente
docker --version
Paso 3: Abordar la versión de CGroup
- La compatibilidad del Supervisor de Home Assistant depende de una versión específica de Docker CGroup v1. Para asegurar esta compatibilidad, es necesario realizar los siguientes cambios:
sudo nano /etc/default/grub
- Agrega esta línea y guarda los cambios.
systemd.unified_cgroup_hierarchy=false
- Abre este archivo
sudo nano /boot/cmdline.txt
- Agrega esta línea al final del contenido y guarda:
systemd.unified_cgroup_hierarchy=false apparmor=1 security=apparmor
Paso 4: Instalar OS-Agent (versión 1.3)
Descarga el OS-Agent adecuado según la arquitectura de tu CPU, y luego procede a instalarlo: Para Raspberry Pi 64 bits, el sistema es linux aarch64.
wget https://github.com/home-assistant/os-agent/releases/download/1.3.0/os-agent_1.3.0_linux_aarch64.deb
- Instala el agente de Home Assistant OS
sudo dpkg -i os-agent_1.3.0_linux_aarch64.deb
- Verifica que la instalación haya sido 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 la conexión Wi-Fi podría interrumpirse durante el proceso:
sudo dpkg -i homeassistant-supervised.deb
Paso 7: Solucionar errores de instalación
En caso de errores durante la instalación, corrígelos ejecutando:
sudo apt --fix-broken install
Una vez solucionados los errores, aparecerá una pantalla azul que te permitirá seleccionar el modelo Raspberry Pi4 64.

Paso 8: Finalizar la instalación y configuración de Wi-Fi
Permite unos minutos para que Home Assistant sea accesible en http://[tu_IP_de_Raspberry]: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 la Raspberry Pi para aplicar los cambios:
sudo reboot
Para resolver los "problemas del Network Manager" (encontrados en la configuración), puedes corregir la situación iniciando y habilitando posteriormente el Network Manager. Utiliza el siguiente comando para hacerlo:
sudo systemctl enable NetworkManager
Instalar MQTT Broker
- Navega a Configuración > Complementos > Haz clic en MQTT Broker.

- Presiona instalar y, después de la instalación, habilita el inicio automático en el arranque.
- Navega a Configuración > Dispositivos y Servicios > Configurar MQTT Broker.
Instalar Frigate (Acceso Completo)
Paso 1: Clonar el repositorio
- Navega a Configuración > Complementos > Tienda de Complementos > Menú > repositorios

- Agrega la URL del repositorio: https://github.com/blakeblackshear/frigate-hass-addons. Luego, podrás ver el complemento Frigate en la Tienda de Complementos.
Paso 2: Instalar el complemento NVR Frigate de Acceso Completo
Paso 3: Crear frigate.yml
- Para proceder con este paso, necesitarás un editor de archivos. Accede a la opción "Browse File System" ubicada en la esquina superior izquierda del editor de archivos.

- Crea un nuevo archivo llamado
frigate.yml

- A continuación, puedes utilizar el siguiente fragmento de código para comprobar si puedes recuperar con éxito las transmisiones RTSP de tus cámaras IP. Copia el código proporcionado y pégalo en tu archivo
frigate.yml
. Se recomienda encarecidamente seguir las pautas indicadas en el sitio oficial de Frigate para obtener instrucciones completas. Recuerda reemplazar los marcadores de posición con el nombre específico de tu cámara, resolución y la IP del stream de la cámara. Esta personalización garantizará una integración precisa con tu configuración de cámaras.
mqtt:
enabled: False
cameras:
RPIcam: # <------ Nombra la cámara
ffmpeg:
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- La transmisión que deseas usar para la detección
roles:
- detect
detect:
enabled: False # <---- desactiva la detección hasta que tengas una transmisión 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é deshabilitado.
- Una vez inicies Frigate, es importante monitorear el registro de eventos para detectar cualquier posible inconveniente. Si no surge ningún problema, procede a hacer clic en el ícono de Frigate ubicado en la barra lateral. Esta acción te permitirá acceder a la interfaz y funcionalidades de Frigate.
Paso 5: Verificar la transmisión
Si todo funciona correctamente, verás la transmisión.

Paso 6: Habilitar la detección de objetos
Para lograrlo, es esencial el Coral USB Accelerator Edge TPU. Aunque puedes conectarlo directamente a un puerto USB, podrían ocurrir casos en los que no funcione como se espera debido a sus mayores requerimientos de potencia. Por ello, recomendamos encarecidamente utilizar un hub USB de alta calidad. Esto asegurará una entrega 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:
mqtt:
enabled: False
detectors: # <---- agrega detectores
coral:
type: edgetpu
device: usb
cameras:
RPIcam: # <------ Nombra la cámara
ffmpeg:
input_args: preset-rtsp-udp
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- La transmisión que deseas usar para la detección
roles:
- detect
detect:
enabled: True # <---- activa la detección una vez que tengas una transmisión 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
- Reinicia el complemento de Frigate. Luego, haz clic en el ícono de Frigate en la barra lateral. A continuación, haz clic en la transmisión para obtener una vista completa. Por defecto, se detecta la presencia de personas y se dibuja un recuadro delimitador.


Y aquí tienes la demostración:

Puedes detectar muchos objetos diferentes y enviar notificaciones a tu teléfono móvil. Para ello, es necesario modificar el archivo frigate.yml
. Por ello, te recomendamos encarecidamente que consultes 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 soporte en diversos canales, asegurando que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para satisfacer diferentes preferencias y necesidades.