Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt

   1 Device-Tree bindings for tilcdc DRM driver
   2
   3 Required properties:
   4  - compatible: value should be one of the following:
   5     - "ti,am33xx-tilcdc" for AM335x based boards
   6     - "ti,da850-tilcdc" for DA850/AM18x/OMAP-L138 based boards
   7  - interrupts: the interrupt number
   8  - reg: base address and size of the LCDC device
   9
  10 Recommended properties:
  11  - interrupt-parent: the phandle for the interrupt controller that
  12    services interrupts for this device.
  13  - ti,hwmods: Name of the hwmod associated to the LCDC
  14
  15 Optional properties:
  16  - max-bandwidth: The maximum pixels per second that the memory
  17    interface / lcd controller combination can sustain
  18  - max-width: The maximum horizontal pixel width supported by
  19    the lcd controller.
  20  - max-pixelclock: The maximum pixel clock that can be supported
  21    by the lcd controller in KHz.
  22  - blue-and-red-wiring: Recognized values "straight" or "crossed".
  23    This property deals with the LCDC revision 2 (found on AM335x)
  24    color errata [1].
  25     - "straight" indicates normal wiring that supports RGB565,
  26       BGR888, and XBGR8888 color formats.
  27     - "crossed" indicates wiring that has blue and red wires
  28       crossed. This setup supports BGR565, RGB888 and XRGB8888
  29       formats.
  30     - If the property is not present or its value is not recognized
  31       the legacy mode is assumed. This configuration supports RGB565,
  32       RGB888 and XRGB8888 formats. However, depending on wiring, the red
  33       and blue colors are swapped in either 16 or 24-bit color modes.
  34
  35 Optional nodes:
  36
  37  - port/ports: to describe a connection to an external encoder. The
  38    binding follows Documentation/devicetree/bindings/graph.txt and
  39    suppors a single port with a single endpoint.
  40
  41  - See also Documentation/devicetree/bindings/display/tilcdc/panel.txt and
  42    Documentation/devicetree/bindings/display/tilcdc/tfp410.txt for connecting
  43    tfp410 DVI encoder or lcd panel to lcdc
  44
  45 [1] There is an errata about AM335x color wiring. For 16-bit color mode
  46     the wires work as they should (LCD_DATA[0:4] is for Blue[3:7]),
  47     but for 24 bit color modes the wiring of blue and red components is
  48     crossed and LCD_DATA[0:4] is for Red[3:7] and LCD_DATA[11:15] is
  49     for Blue[3-7]. For more details see section 3.1.1 in AM335x
  50     Silicon Errata:
  51     http://www.ti.com/general/docs/lit/getliterature.tsp?baseLiteratureNumber=sprz360
  52
  53 Example:
  54
  55         fb: fb@4830e000 {
  56                 compatible = "ti,am33xx-tilcdc", "ti,da850-tilcdc";
  57                 reg = <0x4830e000 0x1000>;
  58                 interrupt-parent = <&intc>;
  59                 interrupts = <36>;
  60                 ti,hwmods = "lcdc";
  61
  62                 blue-and-red-wiring = "crossed";
  63
  64                 port {
  65                         lcdc_0: endpoint@0 {
  66                                 remote-endpoint = <&hdmi_0>;
  67                         };
  68                 };
  69         };
  70
  71         tda19988: tda19988 {
  72                 compatible = "nxp,tda998x";
  73                 reg = <0x70>;
  74
  75                 pinctrl-names = "default", "off";
  76                 pinctrl-0 = <&nxp_hdmi_bonelt_pins>;
  77                 pinctrl-1 = <&nxp_hdmi_bonelt_off_pins>;
  78
  79                 port {
  80                         hdmi_0: endpoint@0 {
  81                                 remote-endpoint = <&lcdc_0>;
  82                         };
  83                 };
  84         };