Tuya PJ-1203A MatSeePlus Energy Meter (TS0601 _TZE204_81yrt3lo/_TZE284_81yrt3lo) v2 quirk

[jeverley]

Proposed change

Adds support for MatSeePlus PJ-1203A 2 CT clamp Energy Meter.

Addresses Device Support Requests

• [Device Support Request] _TZE204_81yrt3lo TS0601 Zigbee power meter with clamp #2549
• [Device Support Request] TS0601 _TZE284_81yrt3lo Tuya Smart Life Dual channel energy meter #3658

Simplifies original pull requests

• ts0601_energy_meter quirk for Tuya power meter devices (v1 quirk) #2961
• ts0601_energy_meter quirk for Tuya power meter devices (v2 quirk) #3824

Separated from other Tuya devices to isolate logic handling the late flow reporting behaviour summarised below:

There is a known issue on the _TZE204_81yrt3lo (with appVersion 74, stackVersion 0 and hwVersion 1).
The energy_flow datapoints are (incorrectly) emitted during the next update. This is quite problematic
because that means that the direction can be inverted for up to update_frequency seconds.

More detail in the Zigbee2MQTT tuya.ts device handler

The quirk makes use of common power value signing logic for both device variations (combining power and energy flow DP values), however the mitigation for the late energy flow bug is disabled by default.

This is because it is not required in the _TZE284 device revision (sharing the same data points, but reporting the correct direction in the current interval), nor is it required if the _TZE204 device is used to measure power that always flows in the same direction.

Exposes Electrical Measurement entities

• Power A
• Power B
• Total Power
• Current A
• Current B
• Power Factor A
• Power Factor B
• Voltage (measured from device power source)
• AC Frequency (measured from device power source)

Exposes Metering entities

• Current Summation Delivered A
• Current Summation Delivered B
• Current Summation Received A
• Current Summation Received B

Exposes configuration entities

• Calibrate reported values, occurs on device (0-200% adjustment)
• Reporting interval (5-60 seconds)
• Energy flow report delay mitigation (disabled by default)

Additional information

• Users of the original draft v1/v2 quirks will need to remove and re-add devices to remove redundant entities.

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: zha-ae94357e53af2d13d0ee1c425ddd864e-_TZE204_81yrt3lo TS0601-bc41e64265aaa00cab79028802fb739b.json

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.32%. Comparing base (1e5953b) to head (cad3859).
⚠️ Report is 3 commits behind head on dev.

Additional details and impacted files

@@            Coverage Diff             @@
##              dev    #4498      +/-   ##
==========================================
+ Coverage   92.24%   92.32%   +0.08%     
==========================================
  Files         369      372       +3     
  Lines       12094    12228     +134     
==========================================
+ Hits        11156    11290     +134     
  Misses        938      938              

☔ View full report in Codecov by Sentry.
📢 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.

[jeverley]

Quirk itself validated working in all scenarios with the last commit - will update the validate the tests cases tomorrow prior to making a final commit (haven't got access to my dev container today to automate testing these).

[jeverley]

Ready for review, let me know of any issues👍