Skip to content

KWS-306WF 3-Phase Energy Meter: only switch entity exposed, all energy/voltage/current/power sensors missing #1060

@AmaralVini

Description

@AmaralVini

Device Information

  • Model: KWS-306WF (also sold as GE304WF / KOWSI KWS-306WF / DEWIN KWS-306WF)
  • Type: 3-Phase 4-Wire Smart Energy Meter with WiFi (Tuya)
  • Category: likely cz or dlq
  • Firmware: Tuya protocol v3.5

Problem

When added to Home Assistant via the official Tuya Cloud integration, only the switch entity is exposed. No energy monitoring sensors appear:

  • No voltage (per phase A/B/C)
  • No current (per phase A/B/C)
  • No power (per phase A/B/C + total)
  • No energy consumption (kWh)
  • No frequency, power factor, or temperature

The device does report all of these values — they are visible in the SmartLife/Tuya Smart app and accessible via local protocol (tuya-local project confirmed 139+ DPS in issue make-all/tuya-local#3531).

Root Cause

The Tuya Cloud API standard instruction set for the device's category does not include energy-related DPS. The device status endpoint only returns {"switch": true} through the cloud schema, even though the device firmware sends all energy data points.

Expected Behavior

The integration should expose all DPS reported by the device, including at minimum:

  • voltage_a, voltage_b, voltage_c
  • current_a, current_b, current_c
  • power_a, power_b, power_c, total_power
  • total_forward_energy
  • frequency, power_factor, temperature

Related Issues

Impact

This is a popular and widely sold 3-phase energy meter on AliExpress/Amazon. Without energy sensors, the Tuya integration is unusable for its primary purpose (energy monitoring). Users are forced to use third-party integrations (tuya-local) which only work on the same LAN — making remote monitoring impossible through the official integration.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions