Add quirk for SONOFF SNZB-03PR2 motion sensor

[viys]

• Add support for SONOFF SNZB-03PR2 occupancy and illuminance reporting
• Implement custom cluster for illuminance compensation

Proposed change

This PR adds a new quirk for the SONOFF SNZB-03PR2 motion sensor.

While the device identifies as a standard motion sensor, it requires specific cluster handling for:

• Occupancy (Motion) Reporting: Proper mapping of the occupancy cluster to ensure consistent state updates in Home Assistant.
• Illuminance Reporting: Implementation of the IlluminanceMeasurement cluster to provide real-time light level data.
• Custom Attributes: Added support for local configuration of Detection Interval and Illumination Offset.
• Attribute Synchronization: Implemented logic to ensure that when these values are adjusted physically or via other local methods, the ZHA UI (and underlying attributes) stay synchronized with the device's actual state.

Additional information

Device Type: Zigbee End Device (Motion & Light Sensor).

Testing: Verified that the motion entity resets correctly according to the defined "Detection Interval" and that the illuminance values reflect the "Illumination Offset" set in the attributes.

Dependencies: This quirk is compatible with recent zigpy versions (tested with 0.91.5+ style method signatures).

Device diagnostics

sonoff_snzb03pr2_diagnostics.json

Checklist

• The changes are tested and work correctly
• pre-commit checks pass / the code has been formatted using Black
• Tests have been added to verify that the new code works
• Device diagnostics data has been attached

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.60%. Comparing base (b139f81) to head (b82f757).

Additional details and impacted files

@@           Coverage Diff           @@
##              dev    #4714   +/-   ##
=======================================
  Coverage   92.60%   92.60%           
=======================================
  Files         424      425    +1     
  Lines       14667    14679   +12     
=======================================
+ Hits        13582    13594   +12     
  Misses       1085     1085           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[puddly]

This already exists in the ZCL on the normal OccupancySensing cluster as pir_o_to_u_delay.

[puddly]

We've moving from is_manufacturer_specific=True to explicit manufacturer codes per attribute/command. From your diagnostics, it looks like it should be manufacturer_code=0x1286.

[viys]

Logger: zhaquirks
Source: /usr/local/lib/python3.13/site-packages/zhaquirks/__init__.py:481
First appearance: 10:16:41 (1 occurrence)
Last record: 10:16:41

Unexpected exception importing custom quirk 'snzb03pr2'
Traceback (most recent call last):
  File "/usr/local/lib/python3.13/site-packages/zhaquirks/__init__.py", line 479, in setup
    spec.loader.exec_module(module)
    ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^
  File "<frozen importlib._bootstrap_external>", line 1023, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/config/zha_quirks/snzb03pr2.py", line 11, in <module>
    class SonoffPrivateCluster(CustomCluster):
    ...<13 lines>...
            )
  File "/config/zha_quirks/snzb03pr2.py", line 17, in SonoffPrivateCluster
    class AttributeDefs(BaseAttributeDefs):
    ...<7 lines>...
        )
  File "/config/zha_quirks/snzb03pr2.py", line 20, in AttributeDefs
    illumination_compensation = ZCLAttributeDef(
        id=0x2018,
    ...<2 lines>...
        manufacturer_code=None,
    )
TypeError: ZCLAttributeDef.__init__() got an unexpected keyword argument 'manufacturer_code'

Hello, I encountered an error after changing is_manufacturer_specific to manufacturer_code.

[puddly]

Make sure you're running the latest Home Assistant beta, it will be in the stable release in a few days.

[viys]

oki, i`ll check

[viys]

hello, I have made the changes and completed the testing.

[TheJulianJES]

This looks fine in general. I'll get back to you on whether we want to do the pir_o_to_u_delay number entity per v2 quirk or just generally in ZHA for all devices.

[viys]

I have completed the changes.

[viys]

This PR has completed code changes and testing, CI is all green, and all review comments have been addressed. Are there any further actions required? If everything is in order, when can this PR be merged into the dev branch?

[viys]

Hi,

I would like to ask about the current status of this PR. The driver has been tested and appears to work correctly, but it has not yet been merged into the main branch. Could you please let me know if there are any outstanding issues, required changes, or additional reviews needed before it can be accepted? I’m happy to make adjustments if necessary.

Thank you for your time and support!