安装正式版 Home Assistant Tuya 插件

您所在的位置:网站首页 涂鸦如何和米家同步 安装正式版 Home Assistant Tuya 插件

安装正式版 Home Assistant Tuya 插件

2024-07-12 19:23| 来源: 网络整理| 查看: 265

本文介绍如何安装 Home Assistant(HA)官方 Tuya 插件。

限制条件

本插件仅支持基础的设备品类如:开关、灯、风扇、温湿度计等。更多信息,请前往 GitHub 查看 支持的品类列表。

本插件不承诺涂鸦所有品类设备都支持在 HA 插件中使用。如您的设备还未支持,请参照 此教程 自行开发新设备驱动。

前提条件 您需要安装 Python 3.8(包含 python3-dev)或更高版本。 您需要在 涂鸦开发者平台 创建全屋智能云开发项目,关于如何创建云开发项目,请参考 涂鸦开发者平台配置指南(全屋智能 PaaS 开发方式)。并且:

云项目中至少已添加 1 台设备或 1 台虚拟设备。

为云项目订阅相关智能家庭授权 API。

如果您创建的云开发项目日期,早于 2021 年 5 月 25 日,则需要迁移旧项目,详细操作请参考 涂鸦开发者平台操作 - 从旧项目迁移。

操作步骤 安装 Home Assistant Core

安装 Home Assistant Core(v2021.10.4 及以上版本)后,您可以直接搜索安装 Home Assistant Tuya 插件。

安装正式版 Home Assistant Tuya 插件 安装 Home Assistant Tuya 插件

在浏览器中输入 localhost:8123 ,并按回车键。

创建账号并登录。

选择 配置 > 集成。

安装正式版 Home Assistant Tuya 插件

在 集成 页签中,单击 添加集成。 安装正式版 Home Assistant Tuya 插件

搜索 Tuya,然后单击插件图标进行安装。

安装正式版 Home Assistant Tuya 插件

在弹出的窗口中,参考下表填写参数。

安装正式版 Home Assistant Tuya 插件 参数项 描述 您的账户国家(地区)代码 在下拉框中选择智能生活 App 账户所在地区。说明:在 App 中轻按 我的 > 设置 > 账号与安全 > 账号所在地 即可查询所在地信息。 Tuya IoT Access ID 和 Tuya IoT Access Secret 访问 Tuya开发者平台云开发项目,在对应项目的 授权密钥 区域中找到 Access ID 和 Access Secret。 用户名 智能生活 App 账户。 密码 智能生活 App 密码。

表格中提到的 App 必须为在涂鸦开发者平台上用来接入设备的 App。

单击 提交.

在 概览 页面中,您可以找到并控制在 涂鸦开发者平台 上创建的云开发项目中的设备。 安装正式版 Home Assistant Tuya 插件

常见问题 一:在 Home Assistant 中安装 Tuya 插件时,出现“无法加载配置向导”的报错时,该如何解决? 安装正式版 Home Assistant Tuya 插件

需要您先在 Home Assistant 配置目录的 custom_components 文件夹中将 tuya_v2 文件夹删除,再重启 Home Assistant 服务后重新进行安装。

安装正式版 Home Assistant Tuya 插件 二:在通过 App 扫描二维码将设备关联到云开发项目时出现以下报错,该如何解决? 安装正式版 Home Assistant Tuya 插件

出现该报错的原因为 App 账号所在区域和云开发项目数据中心不一致。需要您切换至正确的数据中心之后再重新扫码。

在智能生活 App 中轻按 我的 > 设置 > 账号与安全 > 账号所在地 即可查询所在区域信息。

安装正式版 Home Assistant Tuya 插件

访问 OEM App 账号所在数据中心参考,找到 App 账号所在区域对应的数据中心。

(可选)如果云开发项目数据中心选项中不存在您 App 所在地对应的数据中心,需要您在云开发项目的概况中添加该数据中心。

安装正式版 Home Assistant Tuya 插件

在云开发项目中,选择 设备 > 关联 APP 账号 ,然后在右上角选择正确的数据中心后,单击 添加 App 账号。

安装正式版 Home Assistant Tuya 插件

在 App 上重新进行扫码。

三:涂鸦云开发项目的 API 产品试用到期后,是否要收费?

到期后,您可以访问 涂鸦开发者平台,进入左侧导航栏 云开发 > 我的服务 中进行延期操作,可申请最多 6 个月的延长体验期。

单击到期时间后的 申请延长体验期。

安装正式版 Home Assistant Tuya 插件

填写申请表格并提交。

安装正式版 Home Assistant Tuya 插件

等待审核结果。涂鸦将会在 1 天之内返回审核结果。

安装正式版 Home Assistant Tuya 插件

您在开通云开发体验版账号后可以试用所有免费 API 产品,但会有用量限制,详细用量限制请参考 产品定价。

四:出现以下报错,该如何解决?

报错信息示例:

[tuya-openapi] Response: { "code": 2406, "msg": "skill id invalid", "success": false, "t": 1624477851701 } 错误码 错误信息 解决办法 1004 sign invalid 未正确填写 Access ID 和 Access Secret。填写方法参考 配置参数 。 1106 permission deny App 账号和云开发项目未关联:确保智能生活 App 和云开发项目关联,关联方法参考 通过 App 账号添加设备。 用户名或密码错误: 使用您关联云开发项目对应智能生活 App 的用户名和密码.国家地区选择错误:需要选择智能生活 App 账号所在的国家或地区。 2406 skill id invalid 确认您使用了 智能生活 App 账号登录插件,并选择您的国家区域所在数据中心。更多信息,请查看 国家地区所在数据中心。确认 涂鸦开发者平台 上的云项目是否创建于 2022 年 5 月 25 号以后。若创建时间早于该日期,请参考 涂鸦开发者平台操作 新建一个云开发项目。尝试解除 App 账号和云开发项目的关联,操作步骤请参考 关联设备,然后重新关联 App 账号。 28841105 No permissions. This project is not authorized to call this API API 授权不完整,请 开通云产品 并 为项目授权。本教程需要开通以下 API:授权管理设备连接全屋智能场景联动IoT 数据分析设备状态通知 28841002 No permissions. Your subscription to cloud development plan has expired 您订阅的涂鸦 IoT Core 连接服务已到期,请 申请延长体验期。 五:如何获取诊断日志?

可以通过以下两种方法。

方法一(日志信息全面,需要重启 Home Assistant 服务):

将以下代码复制到配置文件 configuration.yaml 中并保存:

logger: default: critical logs: custom_components.tuya_v2: debug

重启 Home Assistant 服务后,就可以在终端中,或者 home-assistant.log 文件中查看到涂鸦插件的日志。

安装正式版 Home Assistant Tuya 插件

方法二(可以直接导出文本格式日志,更为便捷):

在 Home Assistant 主页中,选择 配置 > 设备与服务。

安装正式版 Home Assistant Tuya 插件

找到涂鸦插件并选择 ⋮ > 下载诊断信息,即可在浏览器中下载到日志的文本文件。 安装正式版 Home Assistant Tuya 插件

六:Tuya Home Assistant 插件支持的品类包含哪些?

品类支持列表如下所示:

大类 品类码 品类 HA 支持版本 HA 平台 大家电 kt 空调 Release 2021.10 Climate, Switch, Light 小家电 cwysj 宠物喂食器 Release 2021.10 Switch qn 取暖器 Release 2021.10 Climate, Switch, Select, Sensor sd 扫地机器人 Release 2021.11 Vacuum fs 风扇 Release 2021.10 Fan cl 窗帘电机 Release 2021.11 Cover kj 抽湿机 Release 2021.10 Fan, Switch cs 除湿机 Release 2021.11 Humidifier xxj 香薰机 Release 2021.11 Switch cwwsq 宠物喂食器 / Sensor, Binary Sensor rs 热水器 / Climate, Switch szjqr 手指机器人 / Number 电工 kg 开关 Release 2021.10 Sensor, Switch, Light, Select cz 插座 Release 2021.10 Sensor, Switch pc 排插 Release 2021.10 Sensor, Switch clkg 窗帘开关 Release 2021.11 Cover jdcljqr 窗帘机器人 Release 2021.11 Cover wk 温控器 Release 2021.10 Climate dlq 断路器 Release 2021.10 Switch ckmkzq 车库门控制器 Release 2021.11 Cover, Switch fskg Fan wall switch / Switch, Fan xxj Diffuser / Switch 安防 & 传感 wsdcg 温湿度传感器 Release 2021.11 Binary Sensor, Sensor mc 门窗控制器 / Sensor, Binary Sensor mcs 门窗传感器 Release 2021.10 Sensor, Binary Sensor ywbj 烟雾报警器 Release 2021.11 Sensor, Binary Sensor rqbj 燃气报警器 Release 2021.11 Sensor, Binary Sensor pir 被动红外检测 Release 2021.10 Sensor, Binary Sensor sj 水浸检测 Release 2021.11 Sensor, Binary Sensor pm25 PM2.5 传感器 Release 2021.11 Binary Sensor, Sensor hps 人体存在传感器 Release 2021.11 Binary Sensor, Number sos 紧急按钮 Release 2021.10 Binary Sensor, Sensor ldcg 亮度传感器 Release 2021.10 Binary Sensor, Sensor sp 云台相机 Release 2021.11 Camera, Siren, Switch, Light, Number, Select, Sensor sgbj 声光报警 Release 2021.11 Number, Siren, Switch, Select zd 震动传感器 Release 2021.11 Sensor, Binary Sensor, Number co2bj CO2 传感器 Release 2021.11 Binary Sensor, Sensor cobj CO 传感器 Release 2021.11 Binary Sensor, Sensor jqbj 甲醛检测仪 Release 2021.11 Binary Sensor, Sensor jwbj 甲烷检测仪 Release 2021.11 Binary Sensor, Sensor voc 挥发性有机化合物传感器 Release 2021.11 Binary Sensor, Sensor ylcg 压力传感器 Release 2021.11 Binary Sensor, Sensor pm2.5 PM2.5 检测仪 / Sensor, Binary Sensor wkf 温控阀 / Sensor, Binary Sensor hjjcy 环境检测仪 / Sensor 照明 dj 灯具 Release 2021.10 Light, Switch dd 灯带 Release 2021.10 Light fwl 氛围灯 Release 2021.10 Light dc 灯串 Release 2021.10 Light xdd 吸顶灯 Release 2021.10 Light, Switch fsd 风扇灯 Release 2021.11 Light fwd 氛围灯 Release 2021.11 Light gyd 感应灯 Release 2021.11 Light jsq 加湿器 Release 2021.10 Light, humidifier tgkg 调光开关 Release 2021.11 Light, Number, Select tgq 调光器 Release 2021.11 Light, Number, Select tyndj 太阳能灯 Release 2021.11 Light, Sensor, Switch ykq 遥控器 Release 2021.11 Light 厨房电器 bh 智能电茶壶 Release 2021.10 Switch, Number, Sensor kfj 咖啡机 Release 2021.10 Number, Select


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3