Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-06 Thread Krzysztof Kozlowski
On 07/10/2022 05:18, allen.c...@ite.com.tw wrote:
> hi
> 
> -Original Message-
> From: Krzysztof Kozlowski  
> Sent: Thursday, October 6, 2022 4:17 PM
> To: Allen Chen (陳柏宇) 
> Cc: Jau-Chih Tseng (曾昭智) ; Kenneth Hung (洪家倫) 
> ; Hermes Wu (吳佳宏) ; Pin-yen 
> Lin ; Andrzej Hajda ; Neil 
> Armstrong ; Robert Foss ; 
> Laurent Pinchart ; Jonas Karlman 
> ; Jernej Skrabec ; David Airlie 
> ; Daniel Vetter ; Rob Herring 
> ; Krzysztof Kozlowski 
> ; open list:DRM DRIVERS 
> ; open list:OPEN FIRMWARE AND FLATTENED 
> DEVICE TREE BINDINGS ; open list 
> 
> Subject: Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict 
> output bandwidth
> 
> On 06/10/2022 04:04, allen wrote:
>> From: allen chen 
>>
>> Add properties to restrict dp output data-lanes and clock.
>>
>> Signed-off-by: Pin-Yen Lin 
>> Signed-off-by: Allen Chen 
>> ---
>>  .../bindings/display/bridge/ite,it6505.yaml  | 12 
>>  1 file changed, 12 insertions(+)
>>
>> diff --git 
>> a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml 
>> b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
>> index 833d11b2303a..f5482a614d05 100644
>> --- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
>> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
>> @@ -52,6 +52,16 @@ properties:
>>  maxItems: 1
>>  description: extcon specifier for the Power Delivery
>>  
>> +  ite,dp-output-data-lane-count:
>> +description: restrict the dp output data-lanes with value of 1-4
> 
> Drop "with value of 1-4" because it is redundant, but instead explain what 
> this property is about. "Restrict output" is not yet enough.
> Restrict the number? Or choose specific lanes? Why it cannot be data-lanes 
> from video-interfaces?
> 
> ==> DP output bandwidth depends on data-lane-count, so the number of output 
> data-lane-count will restrict output bandwidth.
> In this dt-binding we don't have output endpoint, so use another property 
> name to configure.
> If need to use data-lanes, where can we put in this dt-binding?

I see you got review in v2 to rename it, but it still should be the same
property, if it has similar/same meaning. It can be put here. You just
need to define its type or reference other schema (e.g. video-interfaces
if applicable) which defines it.

Best regards,
Krzysztof



RE: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-06 Thread allen.chen
hi

-Original Message-
From: Krzysztof Kozlowski  
Sent: Thursday, October 6, 2022 4:17 PM
To: Allen Chen (陳柏宇) 
Cc: Jau-Chih Tseng (曾昭智) ; Kenneth Hung (洪家倫) 
; Hermes Wu (吳佳宏) ; Pin-yen Lin 
; Andrzej Hajda ; Neil 
Armstrong ; Robert Foss ; 
Laurent Pinchart ; Jonas Karlman 
; Jernej Skrabec ; David Airlie 
; Daniel Vetter ; Rob Herring 
; Krzysztof Kozlowski ; 
open list:DRM DRIVERS ; open list:OPEN 
FIRMWARE AND FLATTENED DEVICE TREE BINDINGS ; open 
list 
Subject: Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict 
output bandwidth

On 06/10/2022 04:04, allen wrote:
> From: allen chen 
> 
> Add properties to restrict dp output data-lanes and clock.
> 
> Signed-off-by: Pin-Yen Lin 
> Signed-off-by: Allen Chen 
> ---
>  .../bindings/display/bridge/ite,it6505.yaml  | 12 
>  1 file changed, 12 insertions(+)
> 
> diff --git 
> a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml 
> b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> index 833d11b2303a..f5482a614d05 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> @@ -52,6 +52,16 @@ properties:
>  maxItems: 1
>  description: extcon specifier for the Power Delivery
>  
> +  ite,dp-output-data-lane-count:
> +description: restrict the dp output data-lanes with value of 1-4

Drop "with value of 1-4" because it is redundant, but instead explain what this 
property is about. "Restrict output" is not yet enough.
Restrict the number? Or choose specific lanes? Why it cannot be data-lanes from 
video-interfaces?

==> DP output bandwidth depends on data-lane-count, so the number of output 
data-lane-count will restrict output bandwidth.
In this dt-binding we don't have output endpoint, so use another property name 
to configure.
If need to use data-lanes, where can we put in this dt-binding?

> +$ref: /schemas/types.yaml#/definitions/uint32
> +enum: [ 1, 2, 4 ]
> +
> +  ite,dp-output-max-pixel-clock-mhz:

Test your patches before sending.

Best regards,
Krzysztof



Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-06 Thread Rob Herring
On Wed, Oct 5, 2022 at 9:05 PM allen  wrote:
>
> From: allen chen 
>
> Add properties to restrict dp output data-lanes and clock.
>
> Signed-off-by: Pin-Yen Lin 
> Signed-off-by: Allen Chen 
> ---
>  .../bindings/display/bridge/ite,it6505.yaml  | 12 
>  1 file changed, 12 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml 
> b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> index 833d11b2303a..f5482a614d05 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> @@ -52,6 +52,16 @@ properties:
>  maxItems: 1
>  description: extcon specifier for the Power Delivery
>
> +  ite,dp-output-data-lane-count:
> +description: restrict the dp output data-lanes with value of 1-4
> +$ref: /schemas/types.yaml#/definitions/uint32
> +enum: [ 1, 2, 4 ]

We have a standard property for lanes: data-lanes

It goes in the endpoint.

> +
> +  ite,dp-output-max-pixel-clock-mhz:
> +description: restrict max pixel clock
> +$ref: /schemas/types.yaml#/definitions/uint32
> +default: 150

Also have a common property for this: 'link-frequencies'


Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-06 Thread Rob Herring
On Thu, 06 Oct 2022 10:04:43 +0800, allen wrote:
> From: allen chen 
> 
> Add properties to restrict dp output data-lanes and clock.
> 
> Signed-off-by: Pin-Yen Lin 
> Signed-off-by: Allen Chen 
> ---
>  .../bindings/display/bridge/ite,it6505.yaml  | 12 
>  1 file changed, 12 insertions(+)
> 

My bot found errors running 'make DT_CHECKER_FLAGS=-m dt_binding_check'
on your patch (DT_CHECKER_FLAGS is new in v5.13):

yamllint warnings/errors:

dtschema/dtc warnings/errors:
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml:
 properties:ite,dp-output-max-pixel-clock-mhz: '$ref' should not be valid under 
{'const': '$ref'}
hint: Standard unit suffix properties don't need a type $ref
from schema $id: http://devicetree.org/meta-schemas/core.yaml#

doc reference errors (make refcheckdocs):

See https://patchwork.ozlabs.org/patch/

This check can fail if there are any dependencies. The base for a patch
series is generally the most recent rc1.

If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:

pip3 install dtschema --upgrade

Please check and re-submit.



Re: [PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-06 Thread Krzysztof Kozlowski
On 06/10/2022 04:04, allen wrote:
> From: allen chen 
> 
> Add properties to restrict dp output data-lanes and clock.
> 
> Signed-off-by: Pin-Yen Lin 
> Signed-off-by: Allen Chen 
> ---
>  .../bindings/display/bridge/ite,it6505.yaml  | 12 
>  1 file changed, 12 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml 
> b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> index 833d11b2303a..f5482a614d05 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> @@ -52,6 +52,16 @@ properties:
>  maxItems: 1
>  description: extcon specifier for the Power Delivery
>  
> +  ite,dp-output-data-lane-count:
> +description: restrict the dp output data-lanes with value of 1-4

Drop "with value of 1-4" because it is redundant, but instead explain
what this property is about. "Restrict output" is not yet enough.
Restrict the number? Or choose specific lanes? Why it cannot be
data-lanes from video-interfaces?

> +$ref: /schemas/types.yaml#/definitions/uint32
> +enum: [ 1, 2, 4 ]
> +
> +  ite,dp-output-max-pixel-clock-mhz:

Test your patches before sending.

Best regards,
Krzysztof



[PATCH v3 1/2] dt-bindings: it6505: add properties to restrict output bandwidth

2022-10-05 Thread allen
From: allen chen 

Add properties to restrict dp output data-lanes and clock.

Signed-off-by: Pin-Yen Lin 
Signed-off-by: Allen Chen 
---
 .../bindings/display/bridge/ite,it6505.yaml  | 12 
 1 file changed, 12 insertions(+)

diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml 
b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
index 833d11b2303a..f5482a614d05 100644
--- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
@@ -52,6 +52,16 @@ properties:
 maxItems: 1
 description: extcon specifier for the Power Delivery
 
+  ite,dp-output-data-lane-count:
+description: restrict the dp output data-lanes with value of 1-4
+$ref: /schemas/types.yaml#/definitions/uint32
+enum: [ 1, 2, 4 ]
+
+  ite,dp-output-max-pixel-clock-mhz:
+description: restrict max pixel clock
+$ref: /schemas/types.yaml#/definitions/uint32
+default: 150
+
   port:
 $ref: /schemas/graph.yaml#/properties/port
 description: A port node pointing to DPI host port node
@@ -84,6 +94,8 @@ examples:
 pwr18-supply = <&it6505_pp18_reg>;
 reset-gpios = <&pio 179 1>;
 extcon = <&usbc_extcon>;
+ite,dp-output-data-lane-count = <2>;
+ite,dp-output-max-pixel-clock-mhz = <150>;
 
 port {
 it6505_in: endpoint {
-- 
2.25.1