feat: Pump Configuration and Control (0x0200)

[simons-plugins]

What

Add a PumpHandler for the Matter Pump Configuration and Control cluster (0x0200). This enables pool/spa pumps, circulation pumps, and irrigation pumps that expose Matter to appear as Indigo devices.

Matter details

• Cluster 0x0200 — Pump Configuration and Control
• Key attributes: EffectiveOperationMode (0x0011), EffectiveControlMode (0x0012), Capacity (0x0013, typically RPM or % flow), Speed (0x0014)
• Operation modes: Normal, Minimum, Maximum, Local
• Control modes: ConstantSpeed, ConstantPressure, ProportionalPressure, ConstantFlow, ConstantTemperature, Automatic
• Pump runs/stops are driven by OnOff (0x0006) co-located on the same endpoint — PumpHandler would be non-primary; OnOffHandler (or LevelControlHandler if speed is mapped) owns the device

Proposed Indigo mapping

• Device type: matterPump — Relay subtype (on/off = run/stop)
• State pumpSpeed (0–100 %) from Capacity or Speed attribute when available
• Action: TurnOn/TurnOff drives the co-located OnOff cluster
• PluginConfig option for unit (RPM vs %) if firmware exposes both

Why now

Hayward, Jandy, and Pentair are all moving pool equipment to Matter. Given the existing pentair-pool plugin in this workspace, having native Matter support for future-generation pool pumps is a natural fit.

Pattern

Additive non-primary handler (like ElectricalPowerHandler): registers on 0x0200, is_primary_for returns False (shares endpoint with OnOff), merges pump speed into the relay device created by OnOffHandler.