Re: [PATCH 5/9] dt-bindings: msm/dsi: Some binding doc cleanups

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 






On 05/03/2016 07:35 PM, Philipp Zabel wrote:
Am Dienstag, den 03.05.2016, 16:27 +0530 schrieb Archit Taneja:
Some cleanups:

- Use simpler names for DT nodes in the example
- Fix phandle for specifying data lane mapping in the example.
- Use references instead of dumping Document links everywhere

Signed-off-by: Archit Taneja <architt@xxxxxxxxxxxxxx>
---
  .../devicetree/bindings/display/msm/dsi.txt        | 23 +++++++++++-----------
  1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/Documentation/devicetree/bindings/display/msm/dsi.txt b/Documentation/devicetree/bindings/display/msm/dsi.txt
index f5948c4..bf41d7c 100644
--- a/Documentation/devicetree/bindings/display/msm/dsi.txt
+++ b/Documentation/devicetree/bindings/display/msm/dsi.txt
@@ -11,8 +11,7 @@ Required properties:
    be 0 or 1, since we have 2 DSI controllers at most for now.
  - interrupts: The interrupt signal from the DSI block.
  - power-domains: Should be <&mmcc MDSS_GDSC>.
-- clocks: device clocks
-  See Documentation/devicetree/bindings/clocks/clock-bindings.txt for details.
+- clocks: Phandles to device clocks as descirbed in [1]

s/descirbed/described/

  - clock-names: the following clocks are required:
    * "mdp_core_clk"
    * "iface_clk"
@@ -31,8 +30,7 @@ Required properties:

  Optional properties:
  - panel@0: Node of panel connected to this DSI controller.
-  See files in Documentation/devicetree/bindings/display/panel/ for each supported
-  panel.
+  See files in [2] for each supported panel.
  - qcom,dual-dsi-mode: Boolean value indicating if the DSI controller is
    driving a panel which needs 2 DSI links.
  - qcom,master-dsi: Boolean value indicating if the DSI controller is driving
@@ -48,7 +46,7 @@ Optional properties:

    DSI Endpoint properties:
    - remote-endpoint: set to phandle of the connected panel's endpoint.
-    See Documentation/devicetree/bindings/graph.txt for device graph info.
+    See [3] for device graph info.
    - qcom,data-lane-map: this describes how the logical DSI lanes are mapped
      to the physical lanes on the given platform. The value contained in
      index n describes what logical data lane is mapped to the physical data
@@ -89,8 +87,7 @@ Required properties:
  - qcom,dsi-phy-index: The ID of DSI PHY hardware instance. This should
    be 0 or 1, since we have 2 DSI PHYs at most for now.
  - power-domains: Should be <&mmcc MDSS_GDSC>.
-- clocks: device clocks
-  See Documentation/devicetree/bindings/clocks/clock-bindings.txt for details.
+- clocks: Phandles to device clocks as descirbed in [1]

s/descirbed/described/

Thanks, will fix these.


  - clock-names: the following clocks are required:
    * "iface_clk"
  - vddio-supply: phandle to vdd-io regulator device node
@@ -99,8 +96,12 @@ Optional properties:
  - qcom,dsi-phy-regulator-ldo-mode: Boolean value indicating if the LDO mode PHY
    regulator is wanted.

+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+[2] Documentation/devicetree/bindings/display/panel/
+[3] Documentation/devicetree/bindings/graph.txt
+
  Example:
-	mdss_dsi0: qcom,mdss_dsi@fd922800 {
+	dsi0: dsi@fd922800 {
  		compatible = "qcom,mdss-dsi-ctrl";
  		qcom,dsi-host-index = <0>;
  		interrupt-parent = <&mdss_mdp>;
@@ -128,7 +129,7 @@ Example:
  		vdd-supply = <&pma8084_l22>;
  		vddio-supply = <&pma8084_l12>;

-		qcom,dsi-phy = <&mdss_dsi_phy0>;
+		qcom,dsi-phy = <&dsi_phy0>;


  		qcom,dual-dsi-mode;
  		qcom,master-dsi;
@@ -156,12 +157,12 @@ Example:
  		port {
  			dsi0_out: endpoint {
  				remote-endpoint = <&panel_in>;
-				lanes = <0 1 2 3>;
+				qcom,data-lane-map = <0 1 2 3>;

See my comment about the CSI-2 data-lanes binding in the other mail,
could the existing binding be reused?

Yes, I'll incorporate the existing binding.

Thanks for the review.

Archit

--
The Qualcomm Innovation Center, Inc. is a member of the Code Aurora Forum, hosted by The Linux Foundation
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]
  Powered by Linux