[PATCH v2 2/5] dt-bindings: arm: stm32: Add clock-controller sub-node to STM32MP2 SYSCFG

From: Gabriel Fernandez

Date: Tue Nov 10 2026 - 08:52:00 EST


The SYSCFG of the STM32MP23x and STM32MP25x SoCs is described as the
provider of the LTDC pixel clock, but the inputs of this mux (LTDC
kernel clock, LVDS PHY pixel clock and DSI PHY byte lane clock) can't
be described by the "clocks" property of the SYSCFG node: the SYSCFG is
a syscon, whose first clock is taken as the clock of its registers and
enabled around each register access.

Add a clock-controller sub-node to describe the mux with its own clock
inputs. It is required on STM32MP23x and STM32MP25x and not allowed on
the other SoCs.

Deprecate the '#clock-cells' property of the SYSCFG node, which is no
longer required. No driver ever registered a clock on the SYSCFG node,
so this doesn't change anything for existing devicetrees.

Signed-off-by: Gabriel Fernandez <gabriel.fernandez@xxxxxxxxxxx>
---
.../devicetree/bindings/arm/stm32/st,stm32-syscon.yaml | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/arm/stm32/st,stm32-syscon.yaml b/Documentation/devicetree/bindings/arm/stm32/st,stm32-syscon.yaml
index a559f8b03b84..13c02844a91f 100644
--- a/Documentation/devicetree/bindings/arm/stm32/st,stm32-syscon.yaml
+++ b/Documentation/devicetree/bindings/arm/stm32/st,stm32-syscon.yaml
@@ -38,6 +38,10 @@ properties:

"#clock-cells":
const: 0
+ deprecated: true
+ description:
+ The LTDC pixel clock multiplexer is described by the clock-controller
+ sub-node.

"#address-cells":
const: 1
@@ -45,6 +49,10 @@ properties:
"#size-cells":
const: 1

+ clock-controller:
+ type: object
+ $ref: /schemas/clock/st,stm32mp25-syscfg-clk.yaml#
+
patternProperties:
"^phy@2[48]00$":
type: object
@@ -78,8 +86,8 @@ allOf:
then:
required:
- "#address-cells"
- - "#clock-cells"
- "#size-cells"
+ - clock-controller
- phy@2400
- phy@2800
else:
@@ -87,6 +95,7 @@ allOf:
'#address-cells': false
'#clock-cells': false
'#size-cells': false
+ clock-controller: false
phy@2400: false
phy@2800: false


--
2.43.0