How do I display the X,Y,Z axis angles of a private cluster in the Sensor block?

[hwzolin]

@TheJulianJES @puddly
Hello, our company's vibration sensor has a set of private clusters, the function is to report the angle of the X, Y, Z axis of the sensor at the moment.
I would like the reported data to be displayed in the red box in the image below. How do I set this up in my code?

Below is a screenshot of the data reported by this private cluster:

The following is my code, please give me some suggestions for modification, thank you!

"""Third Reality vibration sensor devices."""

from typing import Final

from zigpy.quirks import CustomCluster
from zigpy.quirks.v2 import QuirkBuilder
from zigpy.quirks.v2.homeassistant import UnitOfTime
import zigpy.types as t
from zigpy.zcl.clusters.measurement import Cluster
from zigpy.zcl.foundation import BaseAttributeDefs, ZCLAttributeDef


class ThirdRealityVibrationSensorCluster(Cluster):
    """Third Reality's plug private cluster."""

    cluster_id: Final[t.uint16_t] = 0xFFF1
    name: Final = "Third Reality Vibration Sensor Cluster"
    ep_attribute: Final = "vibration_sensor_cluster"

    class AttributeDefs(BaseAttributeDefs):
        """Define the attributes of a private cluster."""

        cool_down_time: Final = ZCLAttributeDef(
            id=0x0004,
            type=t.uint16_t,
            is_manufacturer_specific=True,
        )
        angle_x: Final = ZCLAttributeDef(
            id=0x0005,
            type=t.int16s,
            access="p",
            mandatory=True,
            is_manufacturer_specific=True,
        )
        angle_y: Final = ZCLAttributeDef(
            id=0x0006,
            type=t.int16s,
            access="p",
            mandatory=True,
            is_manufacturer_specific=True,
        )
        angle_z: Final = ZCLAttributeDef(
            id=0x0007,
            type=t.int16s,
            access="p",
            mandatory=True,
            is_manufacturer_specific=True,
        )


(
    QuirkBuilder("Third Reality, Inc", "3RVS01031Z")
    .replaces(ThirdRealityVibrationSensorCluster)
    .number(
        attribute_name=ThirdRealityVibrationSensorCluster.AttributeDefs.cool_down_time.name,
        min_value=0,
        max_value=7200,
        step=1,
        unit=UnitOfTime.SECONDS,
        cluster_id=ThirdRealityVibrationSensorCluster.cluster_id,
        translation_key="detection_interval",
        fallback_name="Detection interval",
    )
    .add_to_registry()
)

[Hedda]

Hello, our company's vibration sensor has a set of private clusters, the function is to report the angle of the X, Y, Z axis of the sensor at the moment.
I would like the reported data to be displayed in the red box in the image below. How do I set this up in my code?

@hwzolin @3reality-support I am not a quirk developer but believe that if it is not a standard "cover" device (e.g. an orientation or "tilt" sensor for detect angular movement/changes in example windows and garage doors, or slats angle control for venetian blinds and control the tilt position of venetian blinds slats to adjust the amount of light in a room) so that you can just not create quirk device handler to translate those angles into a standard "tilt" entities for how "closures" cluster is exposed for standard cover device in Home Assistant then you probably want to expose it as a a state, for which you might need to extend the sensor device in the zha component of zigpy and the zha code inside Home Assistant core to expose a new device type for "tilt"? Covers also include all different closure devices; awnings, barriers, blinds, cabinets, curtains, doors, garage doors, gates, pergolas, screens, shades, shutters, and windows.

Suspect though that if your product is not actually a "cover" by deffinition but instead only a stand-alone swnslr then you would instead make sense that you rather want to use the sensor device type and extend that to show tates and/or conditions of the sensor

• https://github.com/home-assistant/core/blob/dev/homeassistant/components/zha/sensor.py

• https://www.home-assistant.io/integrations/sensor/

A lot of device classes are supported for sensors but not yet angle, orientation, position, or tilt:

• https://www.home-assistant.io/integrations/sensor/#device-class

Again, note that the ZHA in Home Assistant do not support every device class available and as far as I can tell the cover device type in Home Assistant core is the only type of device that. So if you want to expose tilt in the UI then you need to submit a patch for above linked sensor code that could proably copy part the tilt code from the cover so that it is exposed similarly in the zha UI?

• https://www.home-assistant.io/integrations/cover/

• https://github.com/zigpy/zigpy/blob/dev/zigpy/zcl/clusters/closures.py

• https://github.com/home-assistant/core/blob/dev/homeassistant/components/zha/cover.py

Another one is otherwise the Screen Orientation Sensor and/or Screen Rotation Sensor

• https://companion.home-assistant.io/docs/core/sensors/

PS: The zha integration currently supports the following device types within Home Assistant:

• Alarm control panel
• Binary sensor
• Button
• Climate (beta)
• Cover
• Device tracker
• Fan
• Light
• Lock
• Number (i.e. analog input/output)
• Select
• Sensor
• Siren
• Switch
• Update