Documentation/devicetree/bindings/staging/imx-drm/ldb.txt

   1 Device-Tree bindings for LVDS Display Bridge (ldb)
   2
   3 LVDS Display Bridge
   4 ===================
   5
   6 The LVDS Display Bridge device tree node contains up to two lvds-channel
   7 nodes describing each of the two LVDS encoder channels of the bridge.
   8
   9 Required properties:
  10  - #address-cells : should be <1>
  11  - #size-cells : should be <0>
  12  - compatible : should be "fsl,imx53-ldb" or "fsl,imx6q-ldb".
  13                 Both LDB versions are similar, but i.MX6 has an additional
  14                 multiplexer in the front to select any of the four IPU display
  15                 interfaces as input for each LVDS channel.
  16  - gpr : should be <&gpr> on i.MX53 and i.MX6q.
  17          The phandle points to the iomuxc-gpr region containing the LVDS
  18          control register.
  19 - clocks, clock-names : phandles to the LDB divider and selector clocks and to
  20                         the display interface selector clocks, as described in
  21                         Documentation/devicetree/bindings/clock/clock-bindings.txt
  22         The following clocks are expected on i.MX53:
  23                 "di0_pll" - LDB LVDS channel 0 mux
  24                 "di1_pll" - LDB LVDS channel 1 mux
  25                 "di0" - LDB LVDS channel 0 gate
  26                 "di1" - LDB LVDS channel 1 gate
  27                 "di0_sel" - IPU1 DI0 mux
  28                 "di1_sel" - IPU1 DI1 mux
  29         On i.MX6q the following additional clocks are needed:
  30                 "di2_sel" - IPU2 DI0 mux
  31                 "di3_sel" - IPU2 DI1 mux
  32         The needed clock numbers for each are documented in
  33         Documentation/devicetree/bindings/clock/imx5-clock.txt, and in
  34         Documentation/devicetree/bindings/clock/imx6q-clock.txt.
  35
  36 Optional properties:
  37  - pinctrl-names : should be "default" on i.MX53, not used on i.MX6q
  38  - pinctrl-0 : a phandle pointing to LVDS pin settings on i.MX53,
  39                not used on i.MX6q
  40  - fsl,dual-channel : boolean. if it exists, only LVDS channel 0 should
  41    be configured - one input will be distributed on both outputs in dual
  42    channel mode
  43
  44 LVDS Channel
  45 ============
  46
  47 Each LVDS Channel has to contain a display-timings node that describes the
  48 video timings for the connected LVDS display. For detailed information, also
  49 have a look at Documentation/devicetree/bindings/video/display-timing.txt.
  50
  51 Required properties:
  52  - reg : should be <0> or <1>
  53  - fsl,data-mapping : should be "spwg" or "jeida"
  54                       This describes how the color bits are laid out in the
  55                       serialized LVDS signal.
  56  - fsl,data-width : should be <18> or <24>
  57  - port: A port node with endpoint definitions as defined in
  58    Documentation/devicetree/bindings/media/video-interfaces.txt.
  59    On i.MX6, there should be four ports (port@[0-3]) that correspond
  60    to the four LVDS multiplexer inputs.
  61
  62 example:
  63
  64 gpr: iomuxc-gpr@53fa8000 {
  65         /* ... */
  66 };
  67
  68 ldb: ldb@53fa8008 {
  69         #address-cells = <1>;
  70         #size-cells = <0>;
  71         compatible = "fsl,imx53-ldb";
  72         gpr = <&gpr>;
  73         clocks = <&clks 122>, <&clks 120>,
  74                  <&clks 115>, <&clks 116>,
  75                  <&clks 123>, <&clks 85>;
  76         clock-names = "di0_pll", "di1_pll",
  77                       "di0_sel", "di1_sel",
  78                       "di0", "di1";
  79
  80         lvds-channel@0 {
  81                 reg = <0>;
  82                 fsl,data-mapping = "spwg";
  83                 fsl,data-width = <24>;
  84
  85                 display-timings {
  86                         /* ... */
  87                 };
  88
  89                 port {
  90                         lvds0_in: endpoint {
  91                                 remote-endpoint = <&ipu_di0_lvds0>;
  92                         };
  93                 };
  94         };
  95
  96         lvds-channel@1 {
  97                 reg = <1>;
  98                 fsl,data-mapping = "spwg";
  99                 fsl,data-width = <24>;
 100
 101                 display-timings {
 102                         /* ... */
 103                 };
 104
 105                 port {
 106                         lvds1_in: endpoint {
 107                                 remote-endpoint = <&ipu_di1_lvds1>;
 108                         };
 109                 };
 110         };
 111 };