Adding Tuya Smart Switches to Home Assistant: Three Paths and What Breaks

说明与用途

在 Home Assistant 中可靠地控制 Tuya 智能开关需要选择合适的集成路径：云、局域网或固件刷写，每种方法都有其关于固件更新、安全性和兼容性的限制。

问题

Integrating Tuya smart switches into Home Assistant can be unreliable due to varying firmware, cloud dependence, and local access limitations.

结果

By selecting the appropriate integration path and understanding each method’s limitations, users can achieve reliable local control of Tuya switches while maintaining remote access via cloud when necessary.

工作流

• Identify the Tuya device type (cloud, local, ZigBee).
• Choose integration path: 1) Cloud integration, 2) Local Tuya, or 3) Reflash firmware.
• For cloud: add Tuya integration in Home Assistant; no local setup needed.
• For local: obtain device ID, local IP, and local key from Tuya IoT console or Android backup; configure Local Tuya component; block internet access after pairing.
• For reflashing: verify device is ESP8266/ESP32; flash ESPHome or Tasmota; avoid mains wall switches; use ZigBee devices with local coordinator.
• Test switch operation and monitor for firmware updates that may break local connections.
• If ZigBee: pair with Zigbee2MQTT or ZHA; note that manufacturer-specific clusters may not map fully.
• Document any changes in entity count after firmware updates and target specific switch entities in automations.
• Use cloud integration as fallback for remote access.
• Re-pair devices if they become unreachable after updates.

证据

The Tuya integration talks to the Tuya cloud, not to your device.

来源

Local Tuya talks to the device directly over LAN, on TCP port 6668, using the same protocol the app uses locally.

来源

Plugs and a few low-cost devices are built on ESP8266 or ESP32 and can be flashed with ESPHome or Tasmota.

来源

Tuya ZigBee devices cannot be reflashed in place at all — they are not ESP-based.

来源