Skip to content

Latest commit

 

History

History
108 lines (78 loc) · 3.67 KB

README.zh-cn.md

File metadata and controls

108 lines (78 loc) · 3.67 KB
Raw

homeassistant-terncy-component

小燕系统支持 Home Assistant 插件

Readme in English

hacs_badge

插件信息

  • ha_iot_class: Local Push
  • home assistant 版本要求: '2022.12.0'
  • ha_config_flow: true
  • ha_domain: terncy

使用本插件可以在 Home Assistant 中控制小燕智能家居系统设备。

支持的设备类型如下：

  • 灯
  • 开关
  • 窗帘电机
  • 无线开关
  • 智能插座
  • 旋钮开关（仅支持按键点击事件）
  • 人体传感器
  • 门磁传感器
  • 温度传感器
  • 湿度传感器
  • 照度传感器
  • 存在传感器
  • 空调

手动安装方法

  1. 从 Releases 页下载插件最新版本
  2. 将插件解压安装到 home assistant 配置目录下的 custom_components 目录中。安装后，目录结构如下：
homeassistant_configuration_root
├── automations.yaml
├── blueprints
├── configuration.yaml
├── custom_components
│   └── terncy
│       ├── translations
│       ├── __init__.py
│       ├── binary_sensor.py
│       ├── config_flow.py
│       ├── const.py
│       ├── cover.py
│       ├── ...
  1. 重启 home assistant

通过HACS安装

  • 在当前 HA 中安装 HACS。
  • 在 HA 中打开 HACS 管理页面。
  • 点击页面右上角的三个点图标，选择 Custom repositories 入口.
  • 在 Repository 输入框输入 https://github.com/rxwen/homeassistant-terncy-component，在类别中选择 Integration。点击添加。
  • 在 HACS 的 Integration 管理页面点击右下角添加按钮。
  • 在搜索框输入 "terncy" 搜索小燕插件，点击搜索结果进入详情页。
  • 点击页面右下角的下载按钮，查看下载详情。
  • 选择最新版本，点击下载安装插件。
  • 重启HA。

通过 git 及 docker/podman 安装运行

  • 将本项目 git clone 到本地目录
  • docker pull homeassistant/home-assistant:stable
  • docker run -it --rm --name ha --network=host -v PATH_TO_LOCAL_CLONED_GIT_REPOSITORY:/config/ homeassistant/home-assistant:stable

配置流程

插件安装完成后，home assistant 可以自动发现网络中的小燕家庭中心。

连接小燕设备之前，请先使用小燕在家 App 完成系统配置。

  • 在 home assistant 的配置-集成 页面上，点击自动发现的小燕家庭中心图标的配置按钮，启动初始化流程。（如未自动发现，点击添加集成并选择 Terncy 进行查找。）
  • 在弹出窗口点击提交。
  • 此时在小燕在家 App 中可收到 home assistant 请求连接的提醒，点击同意。（如未发现提示框，请查看家庭中心配置页，进入局域网访问授权栏查看）
  • 回到 home assistant 页面再次点击提交，完成配置

配置完成后，即可在 home assistant 中看到小燕设备。

调试

启用及查看小燕插件日志的方法

在 home assistant 配置目录下的 configuration.yaml 文件中添加以下内容：

default_config:

logger:
  default: warning
  logs:
    custom_components.terncy: debug

重启 home assistant 后，可在 http://{ip_of_home_assistant}:8123/config/logs 页查看日志。如果通过 docker 运行 home assistant，也可用 docker logs -f --tail 0 {docker_instantce_name} 命令查看。

注意事项

  • 当通过 docker 运行 ha 时，需运行在 host 网络模式下（添加--network host参数启动 docker）。