Home Assistant on OpenWrt 技术文档

Home Assistant on OpenWrt 技术文档

homeassistant_on_openwrt Install Home Assistant on your OpenWrt device with a single command 项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant_on_openwrt

安装指南

系统要求

• 256 MB 存储空间
• 256 MB RAM
• 已安装 OpenWrt 23.05.0 或更新版本

安装步骤

1. 下载并运行安装脚本：

   wget https://raw.githubusercontent.com/openlumi/homeassistant_on_openwrt/23.05/ha_install.sh -O - | sh
   

2. 脚本执行完毕后，Home Assistant 将安装完成。启动服务或重启设备以自动启动 Home Assistant。
3. 安装完成后，Home Assistant 的 Web 界面将在 8123 端口上运行。

项目使用说明

启动与访问

• 安装完成后，Home Assistant 会自动启动。您可以通过浏览器访问 http://<设备IP>:8123 来访问 Home Assistant 的 Web 界面。

组件使用

• 默认情况下，Home Assistant 仅包含 MQTT、ESPHome 和 ZHA 组件。其他组件未经过测试，可能需要手动调整依赖版本或 Python 库。
• 如果在界面中添加组件后，Home Assistant 无法找到依赖项，尝试重启 Home Assistant。

ZHA 使用说明

• ZHA 组件使用内部 UART 与 ZigBee 芯片通信。芯片需要刷入适当的固件（推荐 v3.23）。
• 使用 /dev/ttymxc1 端口进行 ZHA 配置。
• 在添加新设备之前，必须擦除 Persistent Data Manager (PDM)。可以使用 luci zigbee 工具子菜单发送擦除 PDM 命令，或在控制台中执行：

  jntool erase_pdm
  

• 确保 Zigbee 端口未被任何程序锁定，如 ZHA 或 zigbee2mqtt。

项目API使用文档

默认组件API

• MQTT: 提供 MQTT 协议支持，用于与 MQTT 代理通信。
• ZHA: 提供 Zigbee Home Automation 支持，用于与 Zigbee 设备通信。
• ESPHome: 提供 ESPHome 支持，用于与 ESP8266/ESP32 设备通信。

自定义组件API

• 如果需要添加更多组件，可以从 PyPI 下载 tar.gz 文件，解压后将所需组件复制到 /usr/lib/python3.11/site-packages/homeassistant/components 目录中。
• 如果组件使用前端向导，可能需要在 /usr/lib/python3.11/site-packages/homeassistant/generated/config_flows.py 中取消注释相应的行。
• 也可以在 /etc/homeassistant 目录中创建 custom_components 目录，并将组件复制到该目录中。

项目安装方式

自动安装

• 使用提供的 shell 脚本进行自动安装：

  wget https://raw.githubusercontent.com/openlumi/homeassistant_on_openwrt/23.05/ha_install.sh -O - | sh
  

手动安装

• 如果需要手动安装，可以从 PyPI 下载 Home Assistant 的 tar.gz 文件，解压后将内容复制到相应目录。
• 确保手动安装的组件的依赖项已正确安装，必要时进行交叉编译。

通过以上步骤，您可以顺利安装并使用 Home Assistant on OpenWrt 项目。

homeassistant_on_openwrt Install Home Assistant on your OpenWrt device with a single command 项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant_on_openwrt