Tuya 罩盖

tuya 罩盖平台根据 tuya 串行组件创建一个简单的位置罩盖。

在可以使用此平台之前，需要先设置 Tuya 组件。

以下是 Tuya M515EGWT（链条卷帘电机）的示例输出：

[21:50:28][C][tuya:024]: Tuya:
[21:50:28][C][tuya:031]:   Datapoint 2: int value (value: 53)
[21:50:28][C][tuya:029]:   Datapoint 5: switch (value: OFF)

在此罩盖上，位置控制是数据点 2。现在你可以创建罩盖了。

# 使用上面的数据点创建罩盖
cover:
  - platform: "tuya"
    name: "motor1"
    position_datapoint: 2

配置变量

control_datapoint (可选，整数)：用于发送控制命令的数据点 ID 编号。
position_datapoint (必填，整数)：罩盖位置值的数据点 ID 编号。
position_report_datapoint (可选，整数)：罩盖位置报告值的数据点 ID 编号（如果与 position_datapoint 不同）。
direction_datapoint (可选，整数)：用于设置移动方向的数据点 ID 编号。
min_value (可选，整数)：最低位置值，表示罩盖关闭。默认为 0。
max_value (可选，整数)：最高位置值，表示罩盖开启。默认为 255。
invert_position (可选，布尔值)：如果配置了 direction_datapoint，则将移动方向设为反转。
invert_position_report (可选，布尔值)：反转根据 min_value 和 max_value 计算得出的报告位置百分比，即 70% 变为 30%。默认为 false。
Cover 中的所有其他选项。

支持的设备

已知此组件支持的 Tuya 罩盖设备：

Tuya M515EGWT（珠链卷帘电机）
- 此设备仅使用 position 数据点（2）。
- 数据点 5 的功能目前未知。
Zemismart ZM79E-DT 和 YH002（窗帘电机）
- 支持的数据点：control（1）、position（2）、position_report（3）和 direction（5）。
- 移动方向已保存到 Tuya MCU，因此如果你已经通过遥控器配置过它，则无需设置。

如果你有一个上面未列出的 Tuya 罩盖设备，它可能仍然可以工作——但你需要自己确定它使用哪些数据点（以及它们的 ID 是什么）。

恢复模式

默认的恢复模式（RESTORE）尝试在启动时恢复状态，但不指示罩盖移动到该状态。

RESTORE_AND_CALL 还会指示罩盖移动到恢复的状态——但可能无法工作，具体取决于你的设备（见下文说明）。

Tuya MCU 通常在启动时报告其位置，因此 NO_RESTORE 也可能看起来恢复了其状态——但可能稍慢一些。

注意，如果你的 Tuya 罩盖设备使用相对位置传感（如 ZM79E-DT），它无法判断罩盖在未通电时是否被移动。这意味着在未通电时移动罩盖将导致其位置与报告/请求的状态不匹配。在这种情况下，下次尝试向一个方向移动时（因为它无法移动到自己想要的距离），它会进入错误/未校准状态，需要一次开启/关闭周期来重新校准。

Tuya 罩盖

配置变量

支持的设备

恢复模式

另请参见