diff mbox series

dt-bindings: display: stm32: add pixel clock mandatory property

Message ID 1509034356-23885-1-git-send-email-philippe.cornu@st.com
State Changes Requested, archived
Headers show
Series dt-bindings: display: stm32: add pixel clock mandatory property | expand

Commit Message

Philippe CORNU Oct. 26, 2017, 4:12 p.m. UTC
Add the DPI/RGB input pixel clock in mandatory properties
because it really offers a better preciseness for timing
computations.
Note: Fix also the DSI panel example where "ref" & "pclk"
clocks were swapped.

Signed-off-by: Philippe Cornu <philippe.cornu@st.com>
---
 Documentation/devicetree/bindings/display/st,stm32-ltdc.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

Comments

Rob Herring (Arm) Oct. 27, 2017, 2:38 p.m. UTC | #1
On Thu, Oct 26, 2017 at 06:12:36PM +0200, Philippe Cornu wrote:
> Add the DPI/RGB input pixel clock in mandatory properties
> because it really offers a better preciseness for timing
> computations.
> Note: Fix also the DSI panel example where "ref" & "pclk"
> clocks were swapped.
> 
> Signed-off-by: Philippe Cornu <philippe.cornu@st.com>
> ---
>  Documentation/devicetree/bindings/display/st,stm32-ltdc.txt | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
> index 0292522..99823fb 100644
> --- a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
> +++ b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
> @@ -28,6 +28,7 @@ Mandatory properties specific to STM32 DSI:
>  - #size-cells: Should be <0>.
>  - compatible: "st,stm32-dsi".
>  - clock-names:
> +  - DPI/RGB input pixel clock string name, must be "px_clk".
>    - phy pll reference clock string name, must be "ref".

Where's pclk?

The new clock should be last to be backwards compatible.

>  - resets: see [5].
>  - reset-names: see [5].
> @@ -97,8 +98,9 @@ Example 2: DSI panel
>  			#size-cells = <0>;
>  			compatible = "st,stm32-dsi";
>  			reg = <0x40016c00 0x800>;
> -			clocks = <&rcc 1 CLK_F469_DSI>, <&clk_hse>;
> -			clock-names = "ref", "pclk";
> +			clocks = <&rcc 1 CLK_F469_DSI>, <&rcc 1 CLK_LCD>,
> +				 <&clk_hse>;
> +			clock-names = "pclk", "px_clk", "ref";
>  			resets = <&rcc STM32F4_APB2_RESET(DSI)>;
>  			reset-names = "apb";
>  
> -- 
> 1.9.1
> 
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Philippe CORNU Oct. 27, 2017, 2:52 p.m. UTC | #2
Hi Rob,

On 10/27/2017 04:38 PM, Rob Herring wrote:
> On Thu, Oct 26, 2017 at 06:12:36PM +0200, Philippe Cornu wrote:

>> Add the DPI/RGB input pixel clock in mandatory properties

>> because it really offers a better preciseness for timing

>> computations.

>> Note: Fix also the DSI panel example where "ref" & "pclk"

>> clocks were swapped.

>>

>> Signed-off-by: Philippe Cornu <philippe.cornu@st.com>

>> ---

>>   Documentation/devicetree/bindings/display/st,stm32-ltdc.txt | 6 ++++--

>>   1 file changed, 4 insertions(+), 2 deletions(-)

>>

>> diff --git a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt

>> index 0292522..99823fb 100644

>> --- a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt

>> +++ b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt

>> @@ -28,6 +28,7 @@ Mandatory properties specific to STM32 DSI:

>>   - #size-cells: Should be <0>.

>>   - compatible: "st,stm32-dsi".

>>   - clock-names:

>> +  - DPI/RGB input pixel clock string name, must be "px_clk".

>>     - phy pll reference clock string name, must be "ref".

> 

> Where's pclk?


pclk is described in the generic part 
(Documentation/devicetree/bindings/display/bridge/dw_mipi_dsi.txt) as 
mandatory.

In st,stm32-ltdc.txt (specific part), I have documented that "For all 
mandatory properties & nodes, please refer to the related documentation 
in [5]".

Do you think it is clear enough?

> 

> The new clock should be last to be backwards compatible.

> 


ok.

Many thanks for your review and your support,

Philippe :-)

>>   - resets: see [5].

>>   - reset-names: see [5].

>> @@ -97,8 +98,9 @@ Example 2: DSI panel

>>   			#size-cells = <0>;

>>   			compatible = "st,stm32-dsi";

>>   			reg = <0x40016c00 0x800>;

>> -			clocks = <&rcc 1 CLK_F469_DSI>, <&clk_hse>;

>> -			clock-names = "ref", "pclk";

>> +			clocks = <&rcc 1 CLK_F469_DSI>, <&rcc 1 CLK_LCD>,

>> +				 <&clk_hse>;

>> +			clock-names = "pclk", "px_clk", "ref";

>>   			resets = <&rcc STM32F4_APB2_RESET(DSI)>;

>>   			reset-names = "apb";

>>   

>> -- 

>> 1.9.1

>>
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
index 0292522..99823fb 100644
--- a/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
+++ b/Documentation/devicetree/bindings/display/st,stm32-ltdc.txt
@@ -28,6 +28,7 @@  Mandatory properties specific to STM32 DSI:
 - #size-cells: Should be <0>.
 - compatible: "st,stm32-dsi".
 - clock-names:
+  - DPI/RGB input pixel clock string name, must be "px_clk".
   - phy pll reference clock string name, must be "ref".
 - resets: see [5].
 - reset-names: see [5].
@@ -97,8 +98,9 @@  Example 2: DSI panel
 			#size-cells = <0>;
 			compatible = "st,stm32-dsi";
 			reg = <0x40016c00 0x800>;
-			clocks = <&rcc 1 CLK_F469_DSI>, <&clk_hse>;
-			clock-names = "ref", "pclk";
+			clocks = <&rcc 1 CLK_F469_DSI>, <&rcc 1 CLK_LCD>,
+				 <&clk_hse>;
+			clock-names = "pclk", "px_clk", "ref";
 			resets = <&rcc STM32F4_APB2_RESET(DSI)>;
 			reset-names = "apb";