eWeLink add-on V1.3.1 for Home Assistant and sync ZigBee end-sensors bridged by NSPanle Pro to Home Assistant supported

易微联 HA 插件 V1.3.1 安装与使用说明

  • 更新一些设备 API
  • 修复一些 API 问题

通过 Home Assistant 控制你的易微联设备，支持局域网控制和远程控制。

出于对开放源码社区的尊重，我们也公开了前端和后端的源代码供你参考。

- [前端] GitHub - CoolKit-Technologies/ha-addon-frontEnd
- [后端] GitHub - CoolKit-Technologies/ha-addon-backEnd

准备

  • 按照 HA 官方网站的指导，在你选择的系统上安装 HA，建议在 Raspberry Pi 或本地服务器上运行 HA 操作系统。
  • 你的易微联账号和密码。
  • 已通过易微联APP添加到账号下的易微联设备
  • 本教程基于运行在树莓派3B (32位)上的 HA (2022.8.7)系统，其他版本类似，请自行测试。
  • 若你安装在 Docker 中，本文的末尾有些小提示可能有帮助。

开始

· 安装易微联插件

(若已成功安装，请跳过这部分)

Start up the Home Assistant and log in with the account you created, install eWeLink add-on by following the steps,

启动 HA 并登录，按照以下步骤安装易微联插件

On the homepage of Home Assistant, left sidebar, settings —> Add-ons —> add-on store (on the bottom right corner) —> top right corner to manage add-on repositories —> add eWeLink add-on from GitHub by using the link below and following the guidance steps to finish the installation.

在 HA 主页的左侧边栏，设置 —> 插件  —> 插件商店（右下角） —> 右上角添加源 —> 粘贴以下链接 并根据提示操作

https://github.com/CoolKit-Technologies/Home Assistant-addon.git 

设置 —> 插件

image

—> 插件商店（右下角）

image

—> 右上角添加源 —> 粘贴以下链接 并根据提示操作

image

image

image

关闭窗口即可看到易微联插件出现在商店页面，点击进入安装

image

image

· 运行插件并控制设备

安装完成后启动插件，推荐启用“自动更新”和“显示在侧边栏”

image

点击“访问Web UI” 或点击侧边栏的‘eWeLink smart home’ ，登录你的易微联账号来同步设备。

image
  • 和 HA 在同一路由器下且启用LAN模式的设备可能会被自动发现。
  • 某些设备可能无法控制，因为插件暂不支持。

· Sync eWeLink supported devices to Home Assistant entities and dashboard

· 将易微联设备同步到HA实体和主页面板

登录后，支持的设备会自动同步到HA实体，需要手动点击右上角的“同步 lovelace 卡片” 来让实体显示在主页面板，实体会按照类型自动归类排列。

image

插件支持墙壁开关，插座，灯泡，灯带，以及 Zigbee 传感器，由于HA插件的限制，一些多功能设备的部分功能暂不支持，此外，使用易微联方案的第三方厂家所生产的设备我们无法一一验证以及测试是否支持。

我们整理了一些支持的设备列表供参考：列表

更多信息

· Only the devices in the currently selected home in the eWeLink APP will be shown in the add-on WebUI and Home Assistant dashboard after login.

· Shared devices in the supported types will be pulled into Home Assistant entities also， which means those entities are controllable from the dashboard.

· Entities will be added in the default or first dashboard of your Home Assistant Lovelace, customizing them as you like.

· Entities can’t be edited like change entity ID, and can’t be removed due to the limitations of the add-on way.

·There hasn’t REST API for entity delete, hoping Home Assistant adds this part later.

· 登录HA和易微联插件后，APP中只有当前选定的家庭下的设备会被同步。

· 支持的被分享的设备也会被同步到 HA 实体，意味着可以在 HA 面板上控制。

· 实体会被默认添加到 HA 的第一个 lovelace 面板，你也可以自定义。

· 无法对实体进行编辑，比如修改实体ID，也无法移除。

· 暂时没有可删除实体的API，需要 HA 官方添加这部分功能才能实现。

问题排查

· 设备不显示在 HA 主页面板

· 点击主页右上角的 ‘同步 Lovelace Card’ 来手动同步

· 设备在WebUI上无法控制

· 请尝试重新登录插件，或重启插件。

· 如何使用 HA 的场景和自动化

由于 HA 的限制，通过 REST API 和WebSocket API 集成的设备只能被映射为实体而不是设备，所以需要额外一些步骤。

· 1 **）**启动 HA 的“高级模式” （左侧边栏→用户信息→高级模式）

· 2 **）**用易微联实体创建一个“场景”，在“自动化”中的 动作→动作类型，选择 “激活场景”

· Docker相关提示

- 目前不支持端口转发，请确保 3000 端口空闲

  1. git clone https://github.com/CoolKit-Technologies/ha-addon.git
  2. cd ha-addon/eWeLink_Smart_Home/
  3. docker build . -t ewelink_smart_home
  4. 运行下列命令， 替换 yourHomeAssistantUrl 为你的 HA 地址
docker run -d \
    --restart=always \
    --network host \
    -e HA_URL=yourHomeAssistantUrl \
    -e SUPERVISOR_TOKEN=yourHomeAssitantLongLivedAccessToken \
    ewelink_smart_home
  • 示例:
  docker run -d \
  --restart=always \
  --network host \
  -e HA_URL=http://192.168.1.100:8123 \
  -e SUPERVISOR_TOKEN=eyJ~iJ9.eyJ~jF9.CkQ~Lho
  ewelink_smart_home
  1. 端口 3000.