[Device Support Request] Shelly 2PM Gen4

[daniel-sc]

Problem description

When connecting a Shelly 2PM Gen4 via Zigbee/ZHA, the device is recognized, but incorrectly shows "tilt" actions instead of "lift". The manual zigbee commands "up_upen", "down_close" and "stop" seem to work fine.

Solution description

The device should be correctly functioning and recognized.

Screenshots/Video

Diagnostics information

zha-aad025e989f015c4d39d595af107cda0-Shelly 2PM-5a1d859bd75f93849530f821dea04a39.json

Device signature

Device signature

{
  "node_descriptor": {
    "logical_type": 1,
    "complex_descriptor_available": 0,
    "user_descriptor_available": 0,
    "reserved": 0,
    "aps_flags": 0,
    "frequency_band": 8,
    "mac_capability_flags": 142,
    "manufacturer_code": 5264,
    "maximum_buffer_size": 108,
    "maximum_incoming_transfer_size": 1613,
    "server_mask": 11264,
    "maximum_outgoing_transfer_size": 1613,
    "descriptor_capability_field": 0
  },
  "endpoints": {
    "1": {
      "profile_id": "0x0104",
      "device_type": "0x0202",
      "input_clusters": [
        "0x0000",
        "0x0003",
        "0x0004",
        "0x0005",
        "0x0102"
      ],
      "output_clusters": []
    },
    "239": {
      "profile_id": "0xc001",
      "device_type": "0x2001",
      "input_clusters": [
        "0xfc01",
        "0xfc02"
      ],
      "output_clusters": []
    },
    "242": {
      "profile_id": "0xa1e0",
      "device_type": "0x0061",
      "input_clusters": [],
      "output_clusters": [
        "0x0021"
      ]
    }
  },
  "manufacturer": "Shelly",
  "model": "2PM",
  "class": "zigpy.device.Device"
}

Logs

Logs

[Paste the logs here]

Custom quirk

Custom quirk

[Paste your custom quirk here]

Additional information

No response

[Hedda]

FYI, you can find some documentation + more product infomation about the device here, which only mention "tilt" and not "lift":

• https://kb.shelly.cloud/knowledge-base/shelly-2pm-gen4

  • https://www.shelly.com/products/shelly-2pm-gen4

• "Control motorized blinds, roller shutters, or curtains."
• "Supports calibration for precise open/close/stop positioning."
• "Supports tilt control of slats for Venetian Blinds."
• "Automate based on time, sun elevation, or weather conditions."

By the way, while it does not sound related to your issue you still might to also be interested in this other Shelly device request:

• [Device Support Request] Shelly 1 (PM) Gen 4 Specific Clusters #4125

PS: Also check out this indirectly related zigpy/zha developers discussion where I collected some more general development information about this and more related to upstream zha and zigpy libraries needed to fully support these devices, however that discussion thread maybe needed be converted/moved into an zha issue instead to get more attention from zigpy/zha developers? See here:

• Shelly devices custom Zigbee clusters? Does all of Shelly's Zigbee devices require support for custom Shelly clusters + non-Zigbee OTA and should all those new features be fully exposed in ZHA? zha#470

[Hedda]

Tip is you can now also reference this device converter zigbee-herdsman-converters (for Zigbee2MQTT's zigbee-herdsman library):

• https://github.com/Koenkk/zigbee-herdsman-converters/blob/master/src/devices/shelly.ts

Noted there that they do mention both "lift" and "tilt" for windowCovering controls with the "2PM Gen4" device model.

There is however still only initial support for it there and there is futher discussion about what is missing (for Zigbee2MQTT) here:

• [New device support]: Shelly 2PM Gen 4 Koenkk/zigbee2mqtt#28012

[BernardoCBranco]

@daniel-sc I don't think you have the latest firmware, could it be related to this?

(https://shelly-api-docs.shelly.cloud/gen2/changelog/)

With HA 2025.8.2 and firmware version 1.7.0, it appears fine on mine.

[daniel-sc]

Quite possible - I'll check, upgrade and report back..

[shangri26199]

I can confirm this worked for me and fixed the buttons directly added by ZHA. Firmware 1.7.0 updatet today.
I'm still unable to set any percentage on lift or tilt, but this may be an me issue.

[BernardoCBranco]

@shangri26199 You should be able to set a percentage through the card or through an automation as you can see below. It doesn't work for you?

• Manual

• Automation

[Hedda]

@shangri26199 @daniel-sc after you upgraded the firmware then you might need to re-interview the device and to do that currently I am not sure if it is enough to reconfigre the device, so you might need to re-join/re-pair the device in order for ZHA to re-interview it. To do that you do not remove the device but you still put the device in joining/pairing-mode and then add it to ZHA as if it was a new device (again you should not need to remove it from ZHA at all, but if you do then it can get a new name so stop working in existing automations, scripts, and dashboards)

[shangri26199]

@BernardoCBranco @Hedda many thanks for your fast replies!
I removed and rejoined the device, it recognized the name i gave it in any way.

My shelly show a 50% open state. Moving the slider far up moves the cover completly up and then showing "open", moving the slider far down moves the cover to fully close and showing closed. I'm unable to use any percentage inbetween but the 50% shown in the picture, which means nothing in reality. I think there is some kind of calibration missing?

[BernardoCBranco]

@shangri26199 Have you calibrated the device through the shelly app?

[shangri26199]

@BernardoCBranco that was an easy fix. The cover now got steps in between 0% and 100% working in ZHA. Tyvm!

[daniel-sc]

I can confirm that after upgrading the firmware and re-pairing via zigbee and doing a calibration it works! 😃

[Gor-Lami]

Does anyone use Firmware 1.7.0 with actual blinds? I have a discrepancy between Shelly and ZHA integration. Reported this to Shelly support, but they seem unable to help. My blinds need to be lift closed first, then tilted open. However, the ZHA does not let me do this. Slat control in Shelly web app is enabled to use them as blinds.

The buttons are exact opposite of each other (Shelly is correct). Only upon initial Zigbee pairing, the button is sometimes enabled (permanently disaables after closing the next time however) Tilt and lift position aren't showing in ZHA either. To open the tilt with ZHA, I need to send a Zigbee cluster or group command with tilt percentage value 0. However, in 50% of cases it doesn't work and instead of opening, the device loses tilt calibration. Manually opening the tilt doesn't work, it needs to be fully closed to have tilt/slat back.

Any ideas?