hass-unifi-access 的安装和配置教程

1. 项目基础介绍和主要编程语言

hass-unifi-access 是一个开源项目，旨在为 Home Assistant 集成 Ubiquiti Unifi 门禁系统。它允许用户通过 Home Assistant 控制和监控 Unifi 门禁设备。该项目主要使用 Python 编程语言开发。

2. 项目使用的关键技术和框架

该项目使用的关键技术包括：

• Python：作为主要的编程语言。
• Home Assistant：一个智能家居自动化平台，用于集成和控制各种智能家居设备。
• pyunifi：一个 Python 库，用于与 Unifi 设备进行通信。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您已经满足以下条件：

• 安装有 Home Assistant。
• 具有Ubiquiti Unifi门禁系统的访问权限。
• 确保您的 Home Assistant 系统可以运行 Python 脚本。

安装步骤

步骤 1：安装 pyunifi 库

首先，需要在 Home Assistant 的环境中安装 pyunifi 库。打开 Home Assistant 的终端，运行以下命令：

pip install pyunifi

步骤 2：克隆项目代码

接着，使用 Git 将项目代码克隆到 Home Assistant 的配置目录中。在终端中执行以下命令：

cd /path/to/your/homeassistant/config
git clone https://github.com/imhotep/hass-unifi-access.git

步骤 3：配置 Home Assistant

将以下内容添加到您的 Home Assistant 配置文件 configuration.yaml 中：

# configuration.yaml
custom_components:
  unifi_access:
    controller_ip: 'your_unifi_controller_ip'
    controller_port: 8443
    controller_user: 'your_unifi_username'
    controller_password: 'your_unifi_password'
    ssl: true
    verify_ssl: false

请将 'your_unifi_controller_ip'、'your_unifi_username' 和 'your_unifi_password' 替换为您的 Unifi 控制器的 IP 地址、用户名和密码。

步骤 4：重载 Home Assistant 配置

在 Home Assistant 的前端，进入配置 -> 服务器和位置，点击“检查配置”，然后点击“重载”按钮来应用更改。

步骤 5：验证安装

安装完成后，您可以在 Home Assistant 的日志中查看是否有相关的消息来确定是否成功集成。此外，您还可以通过 Home Assistant 的前端检查新的实体是否出现，例如门禁设备和门的状态。

按照以上步骤操作后，您应该能够成功安装和配置 hass-unifi-access，并在 Home Assistant 中控制您的 Unifi 门禁系统。