本地Tuya设备处理集成——LocalTuya

本地Tuya设备处理集成——LocalTuya

localtuya local handling for Tuya devices 项目地址: https://gitcode.com/gh_mirrors/lo/localtuya

1. 项目介绍

LocalTuya 是一个为 Home Assistant 定制的开源集成，用于本地处理基于 Tuya 的设备。该集成通过推送更新而非轮询来更新设备状态，使得状态更新迅速（即使是手动操作时）。此外，它还支持 Tuya IoT 云API，用于检索设备和设备 local_keys 的信息。虽然配置云API账户不是必需的（LocalTuya 也可以在没有它的情况下工作），但强烈建议配置，以便于轻松检索（以及设备重新配对后的自动更新）local_keys。云API调用仅在启动时以及需要更新 local_key 时执行。

目前支持的 Tuya 设备类型包括：开关、灯光、覆盖物、风扇、空调和吸尘器等。对于兼容的设备，还支持能量监控（电压、电流、功率等）。当前支持 Tuya 协议版本从 3.1 到 3.4。

2. 项目快速启动

以下是基于 LocalTuya 的快速启动指南：

首先，将 LocalTuya 文件夹及其所有内容复制到 Home Assistant 的 custom_components 文件夹中。通常，此文件夹位于您的 /config 文件夹内。如果您正在运行 Hass.io，请使用 SAMBA 来复制文件夹。如果运行的是 Home Assistant Supervised，custom_components 文件夹可能位于 /usr/share/hassio/homeassistant。

# 示例：将 LocalTuya 文件夹复制到 custom_components
cp -r /path/to/localtuya /config/custom_components/

在 Home Assistant 中配置集成：

• 打开 Home Assistant 的设置，选择“集成”。
• 点击“+添加集成”，从下拉菜单中选择 LocalTuya。
• 如果您想使用云API，请输入您的 Tuya IoT 平台账户凭证。否则，可以选择不配置云API账户。
• 提交后，集成将被添加。

3. 应用案例和最佳实践

配置设备

• 确保您已经关闭了设备上的 Tuya 应用程序。
• 选择要添加或编辑的设备，输入设备的友好名称和 localKey。
• 如果您已经配置了云API账户，这些值将自动检索。否则，您需要手动输入。
• 设置扫描间隔（可选），如果默认情况下能量/功率值更新不够频繁，则需要设置。
• 设置“手动 DPS 要添加”（可选），如果设备在实体初始化之前没有正确地广播 DPS，则需要设置。

保障设备安全性

• 如果您计划在具有互联网的网络中集成这些设备，并且阻止它们访问互联网，还必须阻止对本地DNS服务器的DNS请求。否则，设备会进入僵尸状态。

4. 典型生态项目

LocalTuya 作为 Home Assistant 的一个集成，可以与多个生态项目配合使用，例如：

• Home Assistant 的其他自定义集成，如 Tuya Smart、Tuya Climate 等。
• 使用 Node-RED 或其他自动化工具来创建更复杂的自动化流程。
• 集成智能家居设备，如智能插座、智能灯泡等，实现家庭自动化。

通过这些典型生态项目的配合，LocalTuya 能够为用户提供更加丰富和灵活的智能家居体验。

localtuya local handling for Tuya devices 项目地址: https://gitcode.com/gh_mirrors/lo/localtuya