EEPW论坛

【树莓派Zero 2W】Home Assistant 智能家居平台的板端部署

本文介绍了树莓派 Zero 2W 实现 Home Assistant 物联网智能家居平台板端部署的项目设计，包括 Docker 安装、软件源更换、镜像拉取、HA 容器运行、HACS 安装、设备接入等。

项目介绍

通过 Docker 软件实现 Home Assistant 智能家居平台在树莓派 Zero 2W 的本地部署。

• Docker 安装：软件获取、更换软件源、版本检测等；

• Home Assistant 部署：版本选取、更换镜像源、镜像获取、容器启动、参数配置等。

• HACS 安装：为了快速将物联网终端设备接入 HA，安装 HACS 插件，并连接周围设备。

包装

外观

Top view

Bottom view

硬件连接

这里采用 SSH 远程登录操作，则仅需连接电源供电即可；

环境搭建

Micro-SD 卡需烧录 RaspberryPi 官方操作系统；

详见：【树莓派Zero2W】介绍、系统安装、人脸检测 .

Docker

开发板部署 Docker 容器。

软件源

终端执行如下指令，增加软件源（加速下载）

 # 添加 Docker 官方 GPG key:
 sudo apt-get update
 sudo apt-get install ca-certificates curl
 sudo install -m 0755 -d /etc/apt/keyrings
 sudo curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
 sudo chmod a+r /etc/apt/keyrings/docker.asc
 
 # 添加仓库到 Apt 源:
 echo \
   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] http://mirrors.aliyun.com/docker-ce/linux/debian \
   $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
   sudo tee /etc/apt/sources.list.d/docker_aliyun.list > /dev/null
 sudo apt-get update

详见：https://pidoc.cn/docs/pidoc/install_docker/

脚本安装

终端执行指令

 curl -fsSL https://get.docker.com -o get-docker.sh
 sudo sh get-docker.sh

安装完成后，docker -v 查询 Docker 版本号。

Home Assistant

通过 Docker 部署 Home Assistant 智能家居平台。

软件源

终端执行如下代码，添加镜像源，加速拉取镜像

 sudo tee /etc/docker/daemon.json <<-'EOF'
 {
     "registry-mirrors": [
      "https://docker.m.daocloud.io",
      "https://docker.imgdb.de",
      "https://docker-0.unsee.tech",
      "https://docker.hlmirror.com",
      "https://docker.1ms.run",
      "https://func.ink",
      "https://lispy.org",
      "https://docker.xiaogenban1993.com"
     ]
 }
 EOF

终端执行如下指令，重启 Docker 软件

 sudo systemctl daemon-reload
 sudo systemctl restart docker

镜像获取

终端执行如下指令，拉取 HA 镜像

 sudo docker pull homeassistant/homeassistant:stable

启动容器

镜像拉取完成后，终端执行如下代码，启动容器

 sudo docker run -d --name hass \
   --restart unless-stopped \
   -v /srv/homeassistant:/config \
   -v /etc/localtime:/etc/localtime:ro \
   --network host \
   homeassistant/homeassistant:stable

启动后进入初始化，需等待两分钟。

访问主页

浏览器输入网址 http://<树莓派IP>:8123，如 192.168.1.112:8123 ；

进入 HA 主界面（首次打开需进行注册，配置相关个性化参数，包括 HA 名称、地区、语言、时区、海拔、单位、货币等）；

HACS

给出了 Home Assistant 安装 HACS 集成的方案设计。

获取集成

终端执行如下指令，进入 HA 容器命令行

sudo docker exec -it hass bash

接着执行指令，下载 HACS 极速版集成文件

 cd /config
 mkdir -p custom_components
 cd custom_components
 wget -O- https://get.hacs.vip | bash -

执行 exit 指令退出；

执行 sudo docker restart hass 重启 HA .

添加集成

HA 主页依次进入设置 → 设备与服务 → 添加集成 → 搜索 HACS 并添加；

左侧标签页出现 HACS 标签；

Xiaomi Home

基于 HACS 安装 Xiaomi Home （米家）集成：

HACS > 在搜索框中输入 Xiaomi Home；

点击 Xiaomi Home ，进入集成详情页 > DOWNLOAD；

设置 > 设备与服务 > 添加集成；

搜索 Xiaomi Home > 下一步；

点击此处进行登录 > 使用小米账号登录；

添加设备

登录成功后，会弹出会话框 选择家庭与设备；

米家所有或选择部分设备即可导入 Home Assistant ；

总结

本文介绍了树莓派 Zero 2W 开发板安装 Docker 容器并实现 Home Assistant 的本地部署，进一步安装 HACS 集成并添加 Xiaomi Home 插件，实现 IoT 智能设备终端的快速接入，为树莓派相关产品在物联网 IoT 领域的快速开发和应用设计提供了参考。