如何安装 Tuya v2 插件（适用于 Beta 测试）

更新时间：2022-04-14 03:27:52下载pdf

本文介绍如何安装和使用 Tuya v2 插件。

前提条件

已在涂鸦 IoT 平台创建全屋智能云开发项目，至少已添加 1 台设备或 1 台虚拟设备，并且已经为项目订阅相关智能家庭授权 API。关于如何创建云开发项目，请参考涂鸦 IoT 平台配置指南（全屋智能 PaaS 开发方式）。

注意：如果创建的云开发项目日期早于 2021 年 5 月 25 日，则需要进行旧项目的迁移，详细操作请参考涂鸦 IoT 平台操作 - 从旧项目迁移。
已安装 Python 3.8（包含 python3-dev）或更高版本。

安装 Home Assistant Core 后，再把涂鸦 Home Assistant 插件拷贝至其配置目录。

参考 Home Assistant 官方安装文档安装 Home Assistant Core。

Tuya v2 插件可以和旧版本兼容，两个版本可以同时安装，您无需先卸载旧版本后再安装新版本。

下载 tuya-home-assistant 仓库。
解压仓库，并将 custom_components/tuya/ 文件夹拷贝至 Home Assistant 配置目录：比如 ~/.homeassistant。

参考 HACS 官方安装文档安装 HACS。
参考初始化配置文档完成初始化配置。
启动 HACS 后，在主窗口中选择 HACS > Integrations > ⋮ > Custom repositories。
在窗口左下角的地址栏中，输入 https://github.com/tuya/tuya-home-assistant。在 Category 下拉框中选择 Integration，并单击 ADD。
在弹出的对话框中，单击 INSTALL。

在弹出的窗口中填写参数，参数填写可参考下表。
如何安装 Tuya v2 插件（适用于 Beta 测试）

参数项	描述
Access ID 和 Access Secret	访问 Tuya IoT 平台云开发项目，在对应项目的授权密钥区域中找到 Access ID 和 Access Secret.
移动应用	必须为在涂鸦 IoT 平台上用来接入设备的 App。
国家码	登录涂鸦智能或智能生活 App 时选择的国家对应的国家码。
账号	涂鸦智能或智能生活 App 账户。
密码	涂鸦智能或智能生活 App 密码。

注意: 表格中提到的 App 必须为在涂鸦 IoT 平台上用来接入设备的 App。

问题一：旧插件中使用涂鸦智能/智能生活 App 配网的设备，能否无缝接入新插件？

可以。配网的设备信息都存储在涂鸦云，使用旧插件配网接入的设备无需重新进行配网操作，但是 Home Assistant 涂鸦插件的自动化配置需要进行重新设置。

问题二：涂鸦 Home Assistant 插件提示 “身份认证无效”，要如何解决？

如何安装 Tuya v2 插件（适用于 Beta 测试）
需要排查以下几点：

确认涂鸦 IoT 平台上的云项目是否创建于今年 5 月 25 号以后。若创建时间早于该日期，请参考 IoT 平台操作新建一个云开发项目，或者从旧项目迁移数据至新项目。
确认是否已经授权关联涂鸦智能/智能生活 App 账号到云开发项目中。
确认 Home Assistant 插件登录时输入的涂鸦智能/智能生活 App 用户账号和密码是否正确。App 账户取决于您在涂鸦 IoT 平台上接入设备时用了哪个 App（涂鸦智能或智能生活）。

问题三：涂鸦云开发项目的API产品有免费1年试用期，到期后是否要收费呢？

1 年到期后可以更新免费订阅功能，继续使用免费 API 产品。开发者在开通云开发体验版账号后可以试用所有免费 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 时所选的国家或地区的国家码。
1100	param is empty	用户名或者 App 参数为空，请填写用户名或选择一个 App。
2017	schema does not exist	App 选择错误，请选择在涂鸦 IoT 平台上用来接入设备的 App（涂鸦智能或智能生活）。
2406	skill id invalid	确认涂鸦 IoT 平台上的云项目是否创建于今年 5 月 25 号以后。若创建时间早于该日期，请参考 IoT 平台操作新建一个云开发项目。
28841105	No permissions. This project is not authorized to call this API	API 授权不完整，请开通云产品并为项目授权。本教程需要开通以下 API：授权管理设备连接服务全屋智能场景联动 IoT 数据分析设备状态通知

问题五：在通过 App 扫描二维码将设备关联到云开发项目时出现以下报错，该如何解决？ 如何安装 Tuya v2 插件（适用于 Beta 测试）

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