[v4,2/6] dt-bindings: display: Add Synopsys DW MIPI DSI DRM bridge driver

Commit Message

Philippe CORNU June 19, 2017, 4:28 p.m. UTC

This patch adds documentation of device tree bindings for the
Synopsys DesignWare MIPI DSI host DRM bridge driver.

Signed-off-by: Philippe CORNU <[e-mail]>
---
 .../bindings/display/bridge/dw_mipi_dsi.txt        | 30 ++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/display/bridge/dw_mipi_dsi.txt

Comments

Rob Herring (Arm) June 23, 2017, 9:25 p.m. UTC | #1

On Mon, Jun 19, 2017 at 06:28:01PM +0200, Philippe CORNU wrote:
> This patch adds documentation of device tree bindings for the
> Synopsys DesignWare MIPI DSI host DRM bridge driver.

You missed Archit's comment on v3. Bindings are for h/w, not drivers. 

Rob

Philippe CORNU June 26, 2017, 4:27 p.m. UTC | #2

On 06/23/2017 11:25 PM, Rob Herring wrote:
> On Mon, Jun 19, 2017 at 06:28:01PM +0200, Philippe CORNU wrote:
>> This patch adds documentation of device tree bindings for the
>> Synopsys DesignWare MIPI DSI host DRM bridge driver.
> 
> You missed Archit's comment on v3. Bindings are for h/w, not drivers.
> 
> Rob
> 
Dear Rob :-)
sorry to have miss that ones.
I have updated all bindings accordingly (including the optional dpi/rgb 
pixel clock). Everything is now ready for the coming v5 patchset (I am 
waiting for more comments before sending it).
Big thanks :-)
Philippe

Patch

diff --git a/Documentation/devicetree/bindings/display/bridge/dw_mipi_dsi.txt b/Documentation/devicetree/bindings/display/bridge/dw_mipi_dsi.txt
new file mode 100644
index 0000000..0ba2eb9
--- /dev/null
+++ b/Documentation/devicetree/bindings/display/bridge/dw_mipi_dsi.txt
@@ -0,0 +1,30 @@ 
+Synopsys DesignWare MIPI DSI host controller
+============================================
+
+This document defines device tree properties for the Synopsys DesignWare MIPI
+DSI host controller. It doesn't constitue a device tree binding specification
+by itself but is meant to be referenced by platform-specific device tree
+bindings.
+
+When referenced from platform device tree bindings the properties defined in
+this document are defined as follows. The platform device tree bindings are
+responsible for defining whether each optional property is used or not.
+
+- reg: Memory mapped base address and length of the DesignWare MIPI DSI
+  host controller registers. (mandatory)
+
+- clocks: References to all the clocks specified in the clock-names property
+  as specified in [1]. (mandatory)
+
+- clock-names: "pclk" is peripheral clock for either AHB and APB. (mandatory)
+
+- resets: References to all the resets specified in the reset-names property
+  as specified in [2]. (optional)
+
+- reset-names: string reset name, must be "apb" if used. (optional)
+
+- panel or bridge node: see [3]. (mandatory)
+
+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+[2] Documentation/devicetree/bindings/reset/reset.txt
+[3] Documentation/devicetree/bindings/display/mipi-dsi-bus.txt