技术支持
本文档由 AI 翻译。如您发现内容有误或有改进建议,欢迎通过页面下方的评论区,或在以下 Issue 页面中告诉我们:https://github.com/Seeed-Studio/wiki-documents/issues
简介
在当前智能技术无缝融入我们日常生活的时代,对智能和安全家庭自动化的需求比以往任何时候都更加强烈。想象一个场景:您的家不仅满足您的需求,还能及时检测并提醒您后院的可疑活动。这就是先进硬件与开源软件结合的魅力所在。在本文中,我们将探讨 Seeed Studio reTerminal、Home Assistant OS 和 Frigate 插件与 Coral AI USB TPU 的协同作用。这三者的结合提供了一个独特的机会,打造一个集中化、注重隐私且由 AI 驱动的家庭自动化设置,既提升您的生活品质,又确保安全性。加入我们,深入了解这一现代智能生活前沿融合的优势和无限潜力。
Frigate
Frigate 是一个出色的开源网络视频记录器 (NVR),专为实时 AI 驱动的对象检测而设计。Frigate 的独特之处在于其本地化处理,确保所有计算都在您的个人硬件上完成。这种方法保证了最高的隐私性,因为您的摄像头视频流不会离开您的家庭网络范围。通过 Frigate,您可以利用先进的对象识别技术增强安全性和监控,同时完全掌控您的数据。
Home Assistant
Home Assistant OS 是专为运行 Home Assistant 而设计的操作系统,Home Assistant 是一个开源的家庭自动化平台。Home Assistant 允许您控制和自动化家中的各种智能设备和服务。 Home Assistant OS 提供了一个简化且优化的环境,用于运行 Home Assistant。它预装了设置和管理智能家居设备所需的组件,支持与不同协议和平台的集成,并创建自动化流程。
入门指南
在开始这个项目之前,您需要提前准备好硬件和软件,如下所述。此外,您还需要支持该项目的 IP 摄像头。您可以在 Frigate 官方网站 查看支持的摄像头列表。
硬件准备
考虑到 USB Coral 加速器的功耗需求,我们强烈建议投资一个高质量的 USB 供电集线器。该集线器将提供足够的电力以满足 Coral 加速器的需求,确保稳定和最佳性能。
软件准备
我们建议从官方网站安装最新版本的 Raspberry Pi 64 位操作系统。如果您希望安装新的 Raspbian 操作系统,请按照此 指南 中的步骤操作。
安装 Home Assistant Supervised OS 到 Raspberry Pi
在 Raspberry Pi 4 上安装 Home Assistant Supervised 是一个综合性的过程,包含多个关键步骤以确保成功设置。
在某些步骤中,如果您通过 Wi-Fi 连接,可能会失去连接。建议使用 LAN 连接。
第一步:增强您的系统
- 首先通过以下命令执行系统更新日志:
sudo apt update
- 接下来安装以下依赖项:
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y
- 修复损坏的安装
sudo apt --fix-broken install
- 重启 reTerminal
sudo reboot
第二步:集成 Docker
安装 Docker 是至关重要的。请务必避免安装 Portainer,因为它可能会对整体安装过程产生负面影响。执行以下命令:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
- 将 Docker 用户添加到系统
sudo usermod -aG docker pi
- 检查 Docker 是否正常工作
docker --version
第三步:处理 CGroup 版本
- Home Assistant Supervisor 的兼容性取决于特定的 Docker CGroup v1。为了确保这种兼容性,需要进行以下更改:
sudo nano /etc/default/grub
- 添加以下行并保存。
systemd.unified_cgroup_hierarchy=false
- 打开以下文件
sudo nano /boot/cmdline.txt
- 在短语末尾添加以下行并保存。
systemd.unified_cgroup_hierarchy=false apparmor=1 security=apparmor
第四步:安装 OS-Agent (版本 1.3)
根据您的 CPU 架构下载适合的 OS-Agent,然后继续安装:对于 Raspberry Pi 64 位操作系统,选择 linux aarch64。
wget https://github.com/home-assistant/os-agent/releases/download/1.3.0/os-agent_1.3.0_linux_aarch64.deb
- 安装 Home Assistant OS Agent
sudo dpkg -i os-agent_1.3.0_linux_aarch64.deb
- 通过运行以下命令确保安装成功
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
第五步:获取 Home Assistant Supervised
- 下载最新的 Home Assistant Supervised 包:
wget https://github.com/home-assistant/supervised-installer/releases/download/1.3.0/homeassistant-supervised.deb
第六步:安装 Home Assistant Supervised
重要提示:此步骤需要 LAN 连接,因为在安装过程中 Wi-Fi 可能会中断:
sudo dpkg -i homeassistant-supervised.deb
第七步:解决安装错误
如果出现安装错误,通过运行以下命令进行修复:
sudo apt --fix-broken install
修复成功后,将出现一个蓝屏,您可以选择 Raspberry Pi4 64 模型。

第八步:完成安装并设置 Wi-Fi
等待几分钟后,Home Assistant 将可以通过 http://[your_raspberry_IP]:8123 访问。
如果在重启后遇到 Wi-Fi 连接问题,请按照以下步骤操作:
- 要启用 'dhcpcd',执行以下命令:
sudo systemctl enable dhcpcd
- 使用以下命令禁用网络服务:
sudo systemctl disable networking
- 重启 Raspberry Pi 以应用更改:
sudo reboot
为解决 "网络管理器问题"(在设置中找到),您可以通过启动并启用网络管理器来解决问题。使用以下命令完成此操作:
sudo systemctl enable NetworkManager
安装 MQTT Broker
导航至设置 > 插件 > 点击 MQTT Broker。
点击安装,安装完成后启用开机启动。
导航至设置 > 设备和服务 > 配置 MQTT Broker。
安装 Frigate(完全访问权限)
第一步:克隆仓库
导航至设置 > 插件 > 插件商店 > 菜单 > 仓库。
添加仓库 URL:https://github.com/blakeblackshear/frigate-hass-addons。然后你可以在插件商店中看到 Frigate 插件。
第二步:安装完全访问权限的 Frigate NVR 插件。
第三步:创建 frigate.yml 文件
- 要完成此步骤,你需要一个文件编辑器。访问文件编辑器左上角的“浏览文件系统”选项。

- 创建一个名为 frigate.yml 的新文件。

- 接下来,你可以使用以下代码片段来测试是否能够成功从 IP 摄像头获取 RTSP 视频流。将提供的代码复制并粘贴到
frigate.yml
文件中。强烈建议遵循 Frigate 官方网站 上提供的指南以获取详细说明。记得将占位符替换为你的具体摄像头名称、分辨率和摄像头流 IP。这种定制将确保与你的摄像头设置准确集成。
mqtt:
enabled: False
cameras:
RPIcam: # <------ 摄像头名称
ffmpeg:
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- 用于检测的流地址
roles:
- detect
detect:
enabled: False # <---- 禁用检测,直到摄像头流正常工作
width: 1280 # <---- 根据摄像头分辨率更新
height: 720 # <---- 根据摄像头分辨率更新
fps: 5
第四步:启动 Frigate
- 在启动 Frigate 之前,请确保禁用保护模式。
- 启动 Frigate 后,务必密切监控日志以检查是否有潜在问题。如果没有问题出现,请点击侧边栏中的 Frigate 图标。这将使你能够访问 Frigate 的界面和功能。
第五步:检查视频流
如果所有设置正确,你将能够看到视频流。

第六步:启用对象检测
为实现此功能,Coral USB Accelerator Edge TPU 是必需的。虽然可以直接插入 USB 端口,但由于其较高的功耗需求,有时可能无法正常工作。因此,我们强烈建议使用可靠的 USB 供电集线器。这将确保稳定的电力供应和 Coral USB Accelerator 的最佳性能,从而提高其兼容性和效果。
- 使用以下代码更新 frigate.yml 文件:
mqtt:
enabled: False
detectors: # <---- 添加检测器
coral:
type: edgetpu
device: usb
cameras:
RPIcam: # <------ 摄像头名称
ffmpeg:
input_args: preset-rtsp-udp
inputs:
- path: rtsp://192.168.8.151:8554/stream # <----- 用于检测的流地址
roles:
- detect
detect:
enabled: True # <---- 启用检测,确保摄像头流正常工作
width: 1280 # <---- 根据摄像头分辨率更新
height: 720 # <---- 根据摄像头分辨率更新
fps: 5
- 重启 Frigate 插件。然后点击侧边栏中的 Frigate 图标。接着点击视频流,你将能够看到完整的视频流。默认情况下,你可以检测到人并绘制边界框。


以下是演示:

你可以检测许多不同的对象并将通知发送到你的手机。为此,你需要修改 frigate.yml 文件。因此,我们强烈建议快速浏览以下指南。
资源
[网页] Frigate 官方文档
[网页] Home Assistant 论坛
感谢您选择我们的产品!我们致力于为您提供多种支持,以确保您使用我们的产品时体验顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。