dt-bindings: bridge: samsung-dsim: Make some flags optional

In the event a device is connected to the samsung-dsim controller that doesn't support the burst-clock, the driver is able to get the requested pixel clock from the attached device or bridge. In these instances, the samsung,burst-clock-frequency isn't needed, so remove it from the required list.

The pll-clock frequency can be set by the device tree entry for samsung,pll-clock-frequency, but in some cases, the pll-clock may have the same clock rate as sclk_mipi clock. If they are equal, this flag is not needed since the driver will use the sclk_mipi rate as a fallback.

Signed-off-by Adam Ford <[email protected]>

Reviewed-by Conor Dooley <[email protected]>

---
V2: Split from driver series. Re-word updates for burst and pll-clock frequency.

Documentation/devicetree/bindings/display/bridge/samsung,mipi-dsim.yaml +3 -1

index 9f61ebdfefa8..06b6c44d4641 100644
@@ -70,7 +70,9 @@ properties:
   samsung,burst-clock-frequency:
     $ref: /schemas/types.yaml#/definitions/uint32
     description:
-      DSIM high speed burst mode frequency.
+      DSIM high speed burst mode frequency.  If absent,
+      the pixel clock from the attached device or bridge
+      will be used instead.
 
   samsung,esc-clock-frequency:
     $ref: /schemas/types.yaml#/definitions/uint32

Quoted 33 lines · Adam Ford

In the event a device is connected to the samsung-dsim controller that doesn't support the burst-clock, the driver is able to get the requested pixel clock from the attached device or bridge. In these instances, the samsung,burst-clock-frequency isn't needed, so remove it from the required list.

The pll-clock frequency can be set by the device tree entry for samsung,pll-clock-frequency, but in some cases, the pll-clock may have the same clock rate as sclk_mipi clock. If they are equal, this flag is not needed since the driver will use the sclk_mipi rate as a fallback.

Signed-off-by Adam Ford <[email protected]>

Reviewed-by Conor Dooley <[email protected]>

---
V2: Split from driver series. Re-word updates for burst and pll-clock frequency.

Documentation/devicetree/bindings/display/bridge/samsung,mipi-dsim.yaml +3 -1

index 9f61ebdfefa8..06b6c44d4641 100644
@@ -70,7 +70,9 @@ properties:
   samsung,burst-clock-frequency:
     $ref: /schemas/types.yaml#/definitions/uint32
     description:
-      DSIM high speed burst mode frequency.
+      DSIM high speed burst mode frequency.  If absent,
+      the pixel clock from the attached device or bridge
+      will be used instead.
 

Documentation/devicetree/bindings/display/bridge/samsung,mipi-dsim.yaml properties: · line 86

Quoted 9 lines

Documentation/devicetree/bindings/display/bridge/samsung,mipi-dsim.yaml +2 -1

   samsung,esc-clock-frequency:
     $ref: /schemas/types.yaml#/definitions/uint32

@@ -80,7 +82,8 @@ properties:
   samsung,pll-clock-frequency:
     $ref: /schemas/types.yaml#/definitions/uint32
     description:
-      DSIM oscillator clock frequency.
+      DSIM oscillator clock frequency. If absent, the clock frequency
+      of sclk_mipi will be used instead.

Maybe this explicit comment won't require as it is not listed in "required"

Reviewed-by Jagan Teki <[email protected]>

In the event a device is connected to the samsung-dsim controller that doesn't support the burst-clock, the driver is able to get the requested pixel clock from the attached device or bridge. In these instances, the samsung,burst-clock-frequency isn't needed, so remove it from the required list.

The pll-clock frequency can be set by the device tree entry for samsung,pll-clock-frequency, but in some cases, the pll-clock may have the same clock rate as sclk_mipi clock. If they are equal, this flag is not needed since the driver will use the sclk_mipi rate as a fallback.

Signed-off-by Adam Ford <[email protected]>

Reviewed-by Conor Dooley <[email protected]>

---
V2: Split from driver series. Re-word updates for burst and pll-clock frequency.

In the event a device is connected to the samsung-dsim controller that doesn't support the burst-clock, the driver is able to get the requested pixel clock from the attached device or bridge. In these instances, the samsung,burst-clock-frequency isn't needed, so remove it from the required list.

[...]