安装正式版 Home Assistant Tuya 插件

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

限制条件

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

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

前提条件

• 您需要安装 Python 3.8（包含 python3-dev）或更高版本。
• 您需要在 涂鸦 IoT 开发平台 创建全屋智能云开发项目，关于如何创建云开发项目，请参考 涂鸦 IoT 开发平台配置指南（全屋智能 PaaS 开发方式）。并且：

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

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

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

操作步骤

安装 Home Assistant Core

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

安装 Home Assistant Tuya 插件

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

2. 创建账号并登录。

3. 选择 配置 > 集成。

   

4. 在 集成 页签中，单击 添加集成。
   

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

   

6. 在弹出的窗口中，参考下表填写参数。

   

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

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

7. 单击 提交.

   在 概览 页面中，您可以找到并控制在 涂鸦 IoT 开发平台 上创建的云开发项目中的设备。
   

常见问题

一：在 Home Assistant 中安装 Tuya 插件时，出现“无法加载配置向导”的报错时，该如何解决？

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

二：在通过 App 扫描二维码将设备关联到云开发项目时出现以下报错，该如何解决？

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

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

   

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

3. （可选）如果云开发项目数据中心选项中不存在您 App 所在地对应的数据中心，需要您在云开发项目的概况中添加该数据中心。

   

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

   

5. 在 App 上重新进行扫码。

三：涂鸦云开发项目的 API 产品试用到期后，是否要收费？

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

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

     

  2. 填写申请表格并提交。

     

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

     

• 您在开通云开发体验版账号后可以试用所有免费 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 账号登录插件，并选择您的国家区域所在数据中心。更多信息，请查看 国家地区所在数据中心。 确认 涂鸦 IoT 开发平台 上的云项目是否创建于 2022 年 5 月 25 号以后。若创建时间早于该日期，请参考 涂鸦 IoT 开发平台操作 新建一个云开发项目。 尝试解除 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 服务）：

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

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

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

     

• 方法二（可以直接导出文本格式日志，更为便捷）：

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

     

  2. 找到涂鸦插件并选择 ⋮ > 下载诊断信息，即可在浏览器中下载到日志的文本文件。
     

六：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