Koenkk / Koenkk/zigbee2mqtt

Energy meter SPM02V _TZE284_wjk6rurm wrong names in HA

Open
#32,958 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

problem
Dominant language
TypeScript
Stars
15.7k
Forks
2k
Avg merge
18h 55m
Merged PRs (30d)
35

Description

What happened?

Device _TZE284_wjk6rurm show in HA just bunch of "Energy" (Energia), "Current" (Prud) or "Power"(Vykon) as entities name, for example "sensor.0xd878f0fffeaffaa9_produced_energy" have a friendly name as ""0xd878f0fffeaffaa9 Energy" and not "Energy produced" or so, screenshot attached.
And also, device reporting AC frequency but that is not reported at all in Z2M (State in Notes section)

Image
What did you expect to happen?

Correct names in HA

How to reproduce it (minimal and precise)

No response

Zigbee2MQTT version

2.13.0

Adapter firmware version

20250321

Adapter

UZG-01

Setup

as docker

Device database.db entry

No response

Debug log
"device": {
  "id": "164ede100971fabe4c4693e6a95f9c5e",
  "name": "0xd878f0fffeaffaa9",
  "name_by_user": null,
  "disabled": false,
  "disabled_by": null,
  "entities": [
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_a",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_a",
        "state": "228",
        "attributes": {
          "unit_of_measurement": "V",
          "friendly_name": "0xd878f0fffeaffaa9 Voltage a"
        },
        "last_changed": "2026-08-28T15:21:05.849108+00:00",
        "last_reported": "2026-08-28T15:21:05.849108+00:00",
        "last_updated": "2026-08-28T15:21:05.849108+00:00"
      },
      "unit_of_measurement": "V"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_b",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_b",
        "state": "0.4",
        "attributes": {
          "unit_of_measurement": "V",
          "friendly_name": "0xd878f0fffeaffaa9 Voltage b"
        },
        "last_changed": "2026-08-28T11:14:23.041831+00:00",
        "last_reported": "2026-08-28T11:14:23.041831+00:00",
        "last_updated": "2026-08-28T11:14:23.041831+00:00"
      },
      "unit_of_measurement": "V"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_c",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_voltage_c",
        "state": "0.2",
        "attributes": {
          "unit_of_measurement": "V",
          "friendly_name": "0xd878f0fffeaffaa9 Voltage c"
        },
        "last_changed": "2026-08-28T15:01:32.837160+00:00",
        "last_reported": "2026-08-28T15:01:32.837160+00:00",
        "last_updated": "2026-08-28T15:01:32.837160+00:00"
      },
      "unit_of_measurement": "V"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_a",
      "icon": null,
      "original_device_class": "power",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_a",
        "state": "2",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "W",
          "device_class": "power",
          "friendly_name": "0xd878f0fffeaffaa9 V\u00fdkon"
        },
        "last_changed": "2026-08-28T15:05:07.363152+00:00",
        "last_reported": "2026-08-28T15:05:07.363152+00:00",
        "last_updated": "2026-08-28T15:05:07.363152+00:00"
      },
      "unit_of_measurement": "W"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_b",
      "icon": null,
      "original_device_class": "power",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_b",
        "state": "0",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "W",
          "device_class": "power",
          "friendly_name": "0xd878f0fffeaffaa9 V\u00fdkon"
        },
        "last_changed": "2026-08-28T07:07:58.602576+00:00",
        "last_reported": "2026-08-28T07:07:58.602576+00:00",
        "last_updated": "2026-08-28T07:07:58.602576+00:00"
      },
      "unit_of_measurement": "W"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_c",
      "icon": null,
      "original_device_class": "power",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_c",
        "state": "0",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "W",
          "device_class": "power",
          "friendly_name": "0xd878f0fffeaffaa9 V\u00fdkon"
        },
        "last_changed": "2026-08-28T07:07:58.716265+00:00",
        "last_reported": "2026-08-28T07:07:58.716265+00:00",
        "last_updated": "2026-08-28T07:07:58.716265+00:00"
      },
      "unit_of_measurement": "W"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_current_a",
      "icon": null,
      "original_device_class": "current",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_current_a",
        "state": "0.027",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "A",
          "device_class": "current",
          "friendly_name": "0xd878f0fffeaffaa9 Pr\u00fad"
        },
        "last_changed": "2026-08-28T15:20:05.955591+00:00",
        "last_reported": "2026-08-28T15:20:05.955591+00:00",
        "last_updated": "2026-08-28T15:20:05.955591+00:00"
      },
      "unit_of_measurement": "A"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_current_b",
      "icon": null,
      "original_device_class": "current",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_current_b",
        "state": "0",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "A",
          "device_class": "current",
          "friendly_name": "0xd878f0fffeaffaa9 Pr\u00fad"
        },
        "last_changed": "2026-08-28T07:07:58.600788+00:00",
        "last_reported": "2026-08-28T07:07:58.600788+00:00",
        "last_updated": "2026-08-28T07:07:58.600788+00:00"
      },
      "unit_of_measurement": "A"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_current_c",
      "icon": null,
      "original_device_class": "current",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_current_c",
        "state": "0",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "A",
          "device_class": "current",
          "friendly_name": "0xd878f0fffeaffaa9 Pr\u00fad"
        },
        "last_changed": "2026-08-28T07:07:58.715351+00:00",
        "last_reported": "2026-08-28T07:07:58.715351+00:00",
        "last_updated": "2026-08-28T07:07:58.715351+00:00"
      },
      "unit_of_measurement": "A"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power",
      "icon": null,
      "original_device_class": "power",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power",
        "state": "-2",
        "attributes": {
          "state_class": "measurement",
          "unit_of_measurement": "W",
          "device_class": "power",
          "friendly_name": "0xd878f0fffeaffaa9 V\u00fdkon"
        },
        "last_changed": "2026-08-28T15:05:07.477622+00:00",
        "last_reported": "2026-08-28T15:05:07.477622+00:00",
        "last_updated": "2026-08-28T15:05:07.477622+00:00"
      },
      "unit_of_measurement": "W"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy",
        "state": "0.82",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T11:58:20.241514+00:00",
        "last_reported": "2026-08-28T11:58:20.241514+00:00",
        "last_updated": "2026-08-28T11:58:20.241514+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_produced_energy",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_produced_energy",
        "state": "0.03",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:47:37.626685+00:00",
        "last_reported": "2026-08-28T07:47:37.626685+00:00",
        "last_updated": "2026-08-28T07:47:37.626685+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_a",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_a",
        "state": "0.28",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T11:58:20.861713+00:00",
        "last_reported": "2026-08-28T11:58:20.861713+00:00",
        "last_updated": "2026-08-28T11:58:20.861713+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_b",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_b",
        "state": "0.27",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:07:59.527255+00:00",
        "last_reported": "2026-08-28T07:07:59.527255+00:00",
        "last_updated": "2026-08-28T07:07:59.527255+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_c",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_c",
        "state": "0.27",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:07:59.827643+00:00",
        "last_reported": "2026-08-28T07:07:59.827643+00:00",
        "last_updated": "2026-08-28T07:07:59.827643+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_a",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_a",
        "state": "0.03",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:47:38.041723+00:00",
        "last_reported": "2026-08-28T07:47:38.041723+00:00",
        "last_updated": "2026-08-28T07:47:38.041723+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_b",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_b",
        "state": "0",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:07:59.697229+00:00",
        "last_reported": "2026-08-28T07:07:59.697229+00:00",
        "last_updated": "2026-08-28T07:07:59.697229+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_c",
      "icon": null,
      "original_device_class": "energy",
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_energy_produced_c",
        "state": "0",
        "attributes": {
          "state_class": "total_increasing",
          "unit_of_measurement": "kWh",
          "device_class": "energy",
          "friendly_name": "0xd878f0fffeaffaa9 Energia"
        },
        "last_changed": "2026-08-28T07:07:59.935863+00:00",
        "last_reported": "2026-08-28T07:07:59.935863+00:00",
        "last_updated": "2026-08-28T07:07:59.935863+00:00"
      },
      "unit_of_measurement": "kWh"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_a",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_a",
        "state": "-99",
        "attributes": {
          "unit_of_measurement": "%",
          "friendly_name": "0xd878f0fffeaffaa9 Power factor a"
        },
        "last_changed": "2026-08-28T15:20:06.739383+00:00",
        "last_reported": "2026-08-28T15:20:06.739383+00:00",
        "last_updated": "2026-08-28T15:20:06.739383+00:00"
      },
      "unit_of_measurement": "%"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_b",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_b",
        "state": "99",
        "attributes": {
          "unit_of_measurement": "%",
          "friendly_name": "0xd878f0fffeaffaa9 Power factor b"
        },
        "last_changed": "2026-08-28T07:08:01.008437+00:00",
        "last_reported": "2026-08-28T07:08:01.008437+00:00",
        "last_updated": "2026-08-28T07:08:01.008437+00:00"
      },
      "unit_of_measurement": "%"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_c",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "sensor.0xd878f0fffeaffaa9_power_factor_c",
        "state": "99",
        "attributes": {
          "unit_of_measurement": "%",
          "friendly_name": "0xd878f0fffeaffaa9 Power factor c"
        },
        "last_changed": "2026-08-28T07:08:01.127120+00:00",
        "last_reported": "2026-08-28T07:08:01.127120+00:00",
        "last_updated": "2026-08-28T07:08:01.127120+00:00"
      },
      "unit_of_measurement": "%"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "number.0xd878f0fffeaffaa9_update_frequency",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "number.0xd878f0fffeaffaa9_update_frequency",
        "state": "30",
        "attributes": {
          "min": 30.0,
          "max": 3600.0,
          "step": 1.0,
          "mode": "auto",
          "unit_of_measurement": "s",
          "friendly_name": "0xd878f0fffeaffaa9 Update frequency"
        },
        "last_changed": "2026-08-28T07:08:34.676705+00:00",
        "last_reported": "2026-08-28T07:08:34.676705+00:00",
        "last_updated": "2026-08-28T07:08:34.676705+00:00"
      },
      "unit_of_measurement": "s"
    },
    {
      "device_class": null,
      "disabled_by": null,
      "disabled": false,
      "entity_category": null,
      "entity_id": "switch.0xd878f0fffeaffaa9_device_locating",
      "icon": null,
      "original_device_class": null,
      "original_icon": null,
      "state": {
        "entity_id": "switch.0xd878f0fffeaffaa9_device_locating",
        "state": "off",
        "attributes": {
          "friendly_name": "0xd878f0fffeaffaa9 Device locating"
        },
        "last_changed": "2026-08-28T07:08:00.212613+00:00",
        "last_reported": "2026-08-28T07:08:00.212613+00:00",
        "last_updated": "2026-08-28T07:08:00.212613+00:00"
      },
      "unit_of_measurement": null
    }
  ]
},
Notes

state of device in Z2M:

{
"device": {
"applicationVersion": 74,
"dateCode": "",
"friendlyName": "0xd878f0fffeaffaa9",
"hardwareVersion": 1,
"ieeeAddr": "0xd878f0fffeaffaa9",
"manufacturerID": 4098,
"manufacturerName": "_TZE284_wjk6rurm",
"model": "SPM02V1-GT",
"networkAddress": 15327,
"powerSource": "Mains (single phase)",
"stackVersion": 0,
"type": "Router",
"zclVersion": 3
},
"last_seen": 1787931395602,
"linkquality": 105,
"current_a": 0.023,
"current_b": 0,
"current_c": 0,
"device_locating": "OFF",
"energy": 0.82,
"energy_a": 0.28,
"energy_b": 0.27,
"energy_c": 0.27,
"energy_produced_a": 0.03,
"energy_produced_b": 0,
"energy_produced_c": 0,
"power": -1,
"power_a": 1,
"power_b": 0,
"power_c": 0,
"power_factor": -99,
"power_factor_a": -99,
"power_factor_b": 99,
"power_factor_c": 99,
"produced_energy": 0.03,
"update_frequency": 30,
"voltage_a": 228.9,
"voltage_b": 0.4,
"voltage_c": 0.2,
"ac_frequency": 50
}

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file or test is named in the report. Start by locating the Zigbee2MQTT device definition for SPM02V _TZE284_wjk6rurm and compare its exposed entities with the Home Assistant names and the device's reported AC frequency. Done means the relevant entities have distinct correct names and the AC frequency is exposed when the device reports it.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.