Skip to main content

在 reTerminal 上开始使用 Home Assistant

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

简介​

本指南将逐步引导您如何仅使用 reTerminal 将您的普通房屋变成智能家居！在完成本指南后，您将能够在 reTerminal 的 LCD 上查看一个美观的仪表盘，并能够控制您的家用电器以及查看其他信息，例如传感器数据，触手可及。让我们开始吧！

什么是 Home Assistant？​

Home Assistant 是一个免费的开源家庭自动化软件，旨在成为智能家居设备的中央控制系统，也可以称为智能家居中心。它为您提供无需云的家庭自动化，这意味着您的家庭自动化系统不依赖于远程服务器或互联网连接。这种本地控制意味着您可以获得比云连接设备更好的安全性。此外，它在保持 24x7 运行方面提供了更高的可靠性。

它使用灵活且非常容易上手，即使是初学者也可以通过 Home Assistant 提供的优秀文档轻松开始。此外，Home Assistant 论坛 上有一个活跃的社区，许多成员会在您构建和运行 Home Assistant 时遇到问题时提供帮助。 设置 Home Assistant 后，可以通过基于 Web 的用户界面访问，也可以使用适用于 Android 和 iOS 的配套应用程序，或者通过支持的虚拟助手（如 Google Assistant 或 Amazon Alexa）进行语音命令访问。 如果您想快速在您的网络浏览器上体验一个演示，请点击这里。

不同的安装方法​

Home Assistant 支持在不同硬件上运行，例如 Raspberry Pi、ODROID、ASUS Tinkerboard、Intel NUC、Windows/Linux/Mac PC。随着这些硬件的不同，也有不同的安装方法。要了解所有这些安装方法，请访问此页面。 如您所见，下面有 4 种主要的安装方法，并不是所有 Home Assistant 功能都支持所有安装方法。

reTerminal 的安装方法​

根据 Home Assistant 的建议，两个推荐的 Home Assistant 安装方法是 OS 和 Container 方法。然而，我们不会使用这两种方法在 reTerminal 上安装。为什么呢？

为什么不选择 Home Assistant 操作系统？​

如果我们在 reTerminal 上安装 Home Assistant 操作系统，我们无法在 reTerminal LCD 上查看 Home Assistant Dashboard UI。这是因为 Home Assistant OS 只会向任何连接的显示器输出 CLI 界面，如下所示。

因此，仪表盘 UI 只能通过 homeassistant.local:8123 在其他设备上访问。然而，如果您希望以这种方式安装并且不希望在 reTerminal LCD 上查看仪表盘，您可以遵循此指南。它遵循与 Raspberry Pi 相同的安装方法，因为 reTerminal 基于 Raspberry Pi Compute Module 4。

为什么不选择 Home Assistant 容器？​

如果我们在 reTerminal 上安装 Home Assistant 容器，我们将错过几个 Home Assistant 功能。因此我们将跳过这种安装方法。然而，如果您想探索这种安装方法，可以遵循此指南。它遵循与 Raspberry Pi 相同的安装方法，因为 reTerminal 基于 Raspberry Pi Compute Module 4。

为什么选择 Home Assistant Supervised？​

如果我们在 reTerminal 上安装 Home Assistant Supervised，我们将能够使用 Home Assistant 的所有功能，并能够在 reTerminal LCD 上查看仪表盘 UI！但与 OS 和 Container 方法相比，这种安装方法涉及更多步骤。然而，如果您仔细按照本指南操作，您将能够成功实现它！

开始构建​

note

在某些步骤中，如果您通过 Wi-Fi 连接，可能会失去连接。建议使用 LAN 连接代替。

现在让我们一起完成在 reTerminal 上安装 Home Assistant Supervised 的过程。

  • 步骤 1. 准备一个已经安装了 Raspberry Pi OS 的 reTerminal。reTerminal 自带预装的 RPi OS 32 位版本。如果您需要重新安装，请参考 此维基。

注意： 请确保使用 32 位版本，因为在 reTerminal LCD 上运行 Home Assistant Dashboard UI 时，32 位版本会更加流畅。

  • 步骤 2. 更新包管理器列表
sudo apt update
  • 步骤 3. 安装依赖项
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y
  • 步骤 4. 修复损坏的安装
sudo apt --fix-broken install
  • 步骤 5. 重启 reTerminal
sudo reboot
  • 步骤 6. 下载官方 Docker 脚本
curl -fsSL https://get.docker.com -o get-docker.sh
  • 步骤 7. 运行 Docker 脚本
sudo sh get-docker.sh
  • 步骤 8. 将 Docker 用户添加到系统
sudo usermod -aG docker pi
  • 步骤 9. 检查 Docker 是否正常工作
docker --version

如果您看到如下输出，则说明 Docker 已正确安装：

Docker version 20.10.18, build b40c2f6
note

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
note

目前测试稳定且适用于 reTerminal(CM4) 的 Home Assistant Agent 版本是 V1.3.0。

  • 步骤 11. 使用以下格式下载文件
wget <copied_link>

例如：

wget https://github.com/home-assistant/os-agent/releases/download/1.3.0/os-agent_1.3.0_linux_armv7.deb
  • 步骤 12. 安装 Home Assistant OS Agent
sudo dpkg -i os-agent_<version_number>_linux_armv7.deb

例如：

sudo dpkg -i os-agent_1.3.0_linux_armv7.deb
  • 步骤 13. 下载 Home Assistant-Supervised 安装脚本
note

同样，目前测试稳定且适用于 reTerminal(CM4) 的 Home Assistant-Supervised 版本也是 V1.3.0。

wget https://github.com/home-assistant/supervised-installer/releases/download/1.3.0/homeassistant-supervised.deb
  • 步骤 14. 安装 Home Assistant-Supervised
sudo dpkg -i homeassistant-supervised.deb
  • 步骤 15. 如果安装过程中出现任何错误，请运行以下命令修复损坏的安装
sudo apt --fix-broken install
  • 步骤 16. 在 Package configuration 窗口中，选择 raspberrypi4 并按 ENTER

输出结果如下：

note

如果在重启后遇到 Wi-Fi 连接问题，请按照以下步骤操作：

  • 要启用 'dhcpcd'，执行以下命令：
sudo systemctl enable dhcpcd
  • 使用以下命令禁用网络服务：
sudo systemctl disable networking
  • 重启 Raspberry Pi 以应用更改：
sudo reboot
note

为解决 "Network Manager 问题"（在设置中找到），您可以通过启动并启用 Network Manager 来解决。使用以下命令完成此操作：

sudo systemctl enable NetworkManager

在网页浏览器中查看 Home Assistant Dashboard 用户界面​

  • 步骤 1. 在网页浏览器中输入以下 URL
homeassistant.local:8123

这将需要一些时间完成初始启动过程。

  • 步骤 2. 启动完成后，创建一个账户并按照初始设置说明进行操作。

之后，您将看到如下的欢迎仪表板。

在 reTerminal 上以 Kiosk 模式查看 Home Assistant Dashboard 用户界面​

为了在 reTerminal 的 LCD 上查看 Home Assistant Dashboard 用户界面，我们将使用 Raspberry Pi OS 中已包含的 Chromium 浏览器。我们将设置 Chromium，使其在 reTerminal 启动后自动以全屏模式启动。

  • 步骤 1. 导航到以下目录
cd /etc/xdg/lxsession/LXDE-pi/
  • 步骤 2. 使用 nano 文本编辑器 打开 autostart 文件
sudo nano autostart
  • 步骤 3. 在文件末尾添加以下行
@chromium-browser --kiosk --incognito --disable-pinch --overscroll-history-navigation=0 homeassistant.local:8123
  • 步骤 4. 重启 reTerminal
sudo reboot

现在，当 reTerminal 启动时，Home Assistant 仪表板用户界面将以全屏窗口打开！

额外内容​

在集成智能灯、温度和湿度传感器、CCTV 等设备后，Home Assistant 上的完整智能家居仪表板将如下所示：


技术支持

感谢您选择我们的产品！我们致力于为您提供多种支持，以确保您使用我们的产品时能够尽可能顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

Loading Comments...