ZHA Portable human presense device _TZE284_debczeci (iHseno)

[AMajor-C]

Describe the enhancement

I ask to add tuya human presense sensor

Device information

Model: TS0601
Manufacturer: _TZE284_debczeci

"endpoints": { "1": { "profile_id": "0x0104", "device_type": "0x0051", "input_clusters": [ "0x0000", "0x0004", "0x0005", "0xed00", "0xef00" ], "output_clusters": [ "0x000a", "0x0019" ] } }, "manufacturer": "_TZE284_debczeci", "model": "TS0601", "class": "zigpy.device.Device" }

Use cases

Its human presesense sense device working stable and from 2AAA batteries.

Anything else?

The device now working in z2m: Koenkk/zigbee2mqtt#27773

[gilfrade]

+1

[imeyer74]

+1

[Zizi3000]

[matthijs166]

I made a custom Quirk for this sensor:

"""Tuya TS0601 human presence sensor.

This is implemented as a Zigpy quirks v2 `TuyaQuirkBuilder` quirk so the Tuya
MCU datapoints are mapped and configuration settings are exposed as Home
Assistant entities.

Datapoints (from zigbee-herdsman):
- DP 1: presence (trueFalse0)
- DP 4: battery (raw percent)
- DP 9: PIR sensitivity enum (low/middle/high)
- DP 10: PIR delay time enum (15s/30s/60s)
"""

from __future__ import annotations

from enum import Enum
from typing import cast

from zigpy import types as t
from zigpy.profiles import zha
from zigpy.zcl.clusters.measurement import OccupancySensing

from zhaquirks.tuya import TuyaLocalCluster
from zhaquirks.tuya.builder import TuyaQuirkBuilder


def _true_false_0_to_occupancy(value: int) -> int:
    """Convert Tuya "trueFalse0" to ZCL OccupancySensing.occupancy.

    zigbee-herdsman "trueFalse0" typically means:
    - 0 => True
    - 1 => False
    OccupancySensing.occupancy is a bitmap; 1 means occupied.
    """

    return 1 if int(value) == 0 else 0


class PirSensitivity(t.enum8):
    """PIR sensor sensitivity."""

    low = 0
    middle = 1
    high = 2


class PirTime(t.enum8):
    """PIR delay time in seconds."""

    s15 = 0
    s30 = 1
    s60 = 2


class IhsenoPresenceOccupancy(OccupancySensing, TuyaLocalCluster):  # type: ignore[misc]
    """Occupancy cluster backed by Tuya presence datapoints."""


(
    TuyaQuirkBuilder()
    .applies_to("_TZE284_debczeci", "TS0601")
    # The device often reports itself as a SMART_PLUG. Don't override the
    # endpoint type; instead add an OccupancySensing cluster backed by Tuya
    # datapoints so Home Assistant exposes a presence entity reliably.
    .adds(IhsenoPresenceOccupancy)
    # DP 1: presence (trueFalse0)
    .tuya_dp(
        dp_id=1,
        ep_attribute=IhsenoPresenceOccupancy.ep_attribute,
        attribute_name=OccupancySensing.AttributeDefs.occupancy.name,
        converter=_true_false_0_to_occupancy,
    )
    # DP 4: battery percent (0-100) -> ZCL half-percent (0-200)
    .tuya_battery(
        dp_id=4,
        scale=2,
    )
    # DP 9/10: PIR configuration (expose as config selects)
    .tuya_enum(
        dp_id=9,
        attribute_name="pir_sensitivity",
        enum_class=cast(type[Enum], PirSensitivity),
        translation_key="pir_sensitivity",
        fallback_name="PIR sensitivity",
    )
    .tuya_enum(
        dp_id=10,
        attribute_name="pir_time",
        enum_class=cast(type[Enum], PirTime),
        translation_key="pir_time",
        fallback_name="PIR delay",
    )
    # The v2 builder will replace the Tuya MCU cluster with a mapping-aware
    # subclass and add HA entity metadata.
    .add_to_registry(force_add_cluster=True)
)

[magixx]

I'd also like to have this as a native Zigbee device.
I'll have to try out the quirk.

[Hedda]

I ask to add tuya human presense sensor

If you have a Zigbee and it connects but do not expose all entities in zha then submit an new "device support request" issue to zha-device-handlers if there is not already an issue started for it there (or if there already is one then help contribute info to it instead). Read and see:

• https://www.home-assistant.io/integrations/zha#how-to-add-support-for-new-and-unsupported-devices

  • https://github.com/zigpy/zha-device-handlers

    • https://community.home-assistant.io/t/zigbee-guide-how-to-add-setup-local-custom-zha-device-handlers-also-known-as-quirks-in-the-zha-integration/683473

In summery, this is the wrong place to submit device support requests for ZHA, instead request missing device features via zha-device-handlers:

• https://github.com/zigpy/zha-device-handlers/issues

Note that even if you feel that this is a bug and not a feature request then you should still submit it to the zha-device-handlers repo on GitHub.