From d95b7c4e642662d3a38d55b535eb80ee51a26ca5 Mon Sep 17 00:00:00 2001
From: Alain Volmat <alain.volmat@foss.st.com>
Date: Tue, 6 May 2025 21:08:46 +0200
Subject: [PATCH] dts: bindings: stm32: add div-q and div-r on stm32mp13 plls

Depending on the PLL, all DIV-P / DIV-Q and DIV-R are available
on STM32MP13 PLLs.
Adjust valid range in order to be able to set for all 4 PLLs.
Clarify DT properties description.

Signed-off-by: Alain Volmat <alain.volmat@foss.st.com>
---
 .../clock/st,stm32mp13-pll-clock.yaml         | 29 +++++++++++++++----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/dts/bindings/clock/st,stm32mp13-pll-clock.yaml b/dts/bindings/clock/st,stm32mp13-pll-clock.yaml
index 5128ea05f0d..c8bacc6d453 100644
--- a/dts/bindings/clock/st,stm32mp13-pll-clock.yaml
+++ b/dts/bindings/clock/st,stm32mp13-pll-clock.yaml
@@ -28,6 +28,14 @@ description: |
   than 1000 MHz or program the mpuss_ck mux to use the MPUDIV
   (refer to the stm32mp13 reference manual for details)
 
+  div-m (aka DIVM1 + 1), div-p (aka DIVP + 1), div-q (aka DIVQ + 1),
+  div-r (aka DIVR + 1) have identical valid ranges for all 4 PLLs.
+  mul-n (aka DIVN + 1) valid range depends on the PLL
+    PLL1: 31 - 125
+    PLL2: 25 - 100
+    PLL3: 25 - 200
+    PLL4: 25 - 200
+
 compatible: "st,stm32mp13-pll-clock"
 
 include: [clock-controller.yaml, base.yaml]
@@ -44,21 +52,32 @@ properties:
     type: int
     required: true
     description: |
-        Prescaler for PLLx
-        input clock
+        PLLx division factor (aka DIVM1 + 1) of the input clock divider
         Valid range: 1 - 64
 
   mul-n:
     type: int
     required: true
     description: |
-        PLLx multiplication factor for VCO
-        Valid range: 31 - 125
+        PLLx multiplication factor (aka DIVN + 1) for VCO
+        Valid range: 25 - 200
 
   div-p:
     type: int
     description: |
-        PLLx DIVP division factor
+        PLLx_P division factor (aka DIVP + 1)
+        Valid range: 1 - 128
+
+  div-q:
+    type: int
+    description: |
+        PLLx_Q division factor (aka DIVQ + 1)
+        Valid range: 1 - 128
+
+  div-r:
+    type: int
+    description: |
+        PLLx_R division factor (aka DIVR + 1)
         Valid range: 1 - 128
 
   frac-v: