Hi All,
The following is an attempt to come up with a devicetree binding for DRM graphics on i.MX SoCs. I'm posting this seperate from the actual code to not bury this in big patches.
The bindings should cover most of the problems we had while implementing the possible IPU <-> (LVDS, HDMI, parallel) Display connections.
Contrary to some other devicetree bindings I have seen we decided not to make the displays subnodes of the graphics unit because the (LVDS, HDMI) encoders are outside the graphics units and also on i.MX6 there are 2 IPUs and displays can be muxed between these IPUs.
Comments and suggestions welcome.
Sascha
8<--------------------------------------
DRM i.MX: Add devicetree binding documentation
Signed-off-by: Philipp Zabel p.zabel@pengutronix.de Signed-off-by: Sascha Hauer s.hauer@pengutronix.de --- .../devicetree/bindings/drm/fsl-imx-drm.txt | 126 ++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 Documentation/devicetree/bindings/drm/fsl-imx-drm.txt
diff --git a/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt b/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt new file mode 100644 index 0000000..6766e03 --- /dev/null +++ b/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt @@ -0,0 +1,126 @@ +Freescale i.MX IPUv3 +==================== + +Required properties: +- compatible: Should be "fsl,<chip>-ipu" +- reg: should be register base and length as documented in the + datasheet +- interrupts: Should contain sync interrupt and error interrupt, + in this order. +- #crtc-cells: 1, See below + +example: + +ipu: ipu@18000000 { + #crtc-cells = <1>; + compatible = "fsl,imx53-ipu"; + reg = <0x18000000 0x080000000>; + interrupts = <11 10>; +}; + +Freescale i.MX LCDC controller +============================== + +Required properties: +- compatible: Should be "fsl,<chip>-lcdc" +- reg: should be register base and length as documented in the + datasheet +- interrupts: Should contain interrupt +- #crtc-cells: 0, See below + +example: + +lcdc: lcdc@10021000 { + #crtc-cells = <0>; + compatible = "fsl,imx27-lcdc", "fsl,imx21-lcdc"; + reg = <0x10021000 0x4000>; + interrupts = <61>; +}; + +Parallel display support +======================== + +Required properties: +- compatible: Should be "fsl,imx-parallel-display" +- crtc: the crtc this display is connected to, see below +Optional properties: +- interface_pix_fmt: How this display is connected to the + crtc. Currently supported types: "rgb24", "rgb565" +- edid: verbatim EDID data block describing attached display. +- ddc: phandle describing the i2c bus handling the display data + channel + +example: + +display@di0 { + compatible = "fsl,imx-parallel-display"; + edid = [edid-data]; + crtc = <&ipu 0>; + interface_pix_fmt = "rgb24"; +}; + +LVDS display bridge (LDB) +========================= + +Required properties: +- compatible: Should be "fsl,<chip>-ldb" +- channel0-crtcs, channel1-crtcs: the crtcs the ldb is connected to, see + below +Optional properties: +- channel0-edid, channel1-edid: verbatim EDID data blocks describing the + displays attached to channel0 and channel1. +- channel0-ddc, channel1-ddc: phandles describing the i2c busses handling + the display data channels for channel0 and channel1. + +lvds@53fa8008 { + compatible = "fsl,imx6q-ldb"; + channel0-edid = [edid-data]; + channel1-ddc = <&i2c0>; + channel0-crtcs = <&ipu0 0>, <&ipu0 1>, <&ipu1 0>, <&ipu1 1>; + channel1-crtcs = <&ipu0 0>, <&ipu0 1>, <&ipu1 0>, <&ipu1 1>; +}; + +Specifying CRTCs connected to display output devices +==================================================== + +Display output device nodes should specify which CRTCs they can be +connected to in their crtcs property, containing a 'crtc-list': + + crtc-list ::= <single-crtc> [crtc-list] + single-crtc ::= <crtc-phandle> <crtc-specifier> + crtc-phandle : phandle to device node providing the crtc + crtc-specifier : Array of #crtc-cells specifying specific crtc + (controller specific, 1 on imx-ipuv3) + +In the following example, two image processing units ipu0 and ipu1 +provide two CRTCs each, indexed with a single cell. The hdmi connector +can be connected to either CRTC of ipu1, and the lvds connector is +fixed to the second CRTC of ipu0. + + ipu0: ipu0 { + #crtc-cells = <1>; + }; + ipu1: ipu1 { + #crtc-cells = <1>; + }; + [...] + hdmi: hdmi { + ddc = <&i2c2>; + crtcs = <&ipu1 0 &ipu1 1>; + }; + lvds: lvds { + edid = [edid-data]; + crtcs = <&ipu0 1>; + }; + +Note that the crtc-specifier length is controller dependent. A simple +lcdc controller with a single CRTC should use #crtc-cells = <0>: + + lcdc: lcdc { + #crtc-cells = <0>; + }; + [...] + parallel-display { + crtcs = <&lcdc> + }; +
On Thu, 14 Jun 2012 15:07:56 +0200 Sascha Hauer s.hauer@pengutronix.de wrote:
Hi All,
The following is an attempt to come up with a devicetree binding for DRM graphics on i.MX SoCs. I'm posting this seperate from the actual code to not bury this in big patches.
The bindings should cover most of the problems we had while implementing the possible IPU <-> (LVDS, HDMI, parallel) Display connections.
Contrary to some other devicetree bindings I have seen we decided not to make the displays subnodes of the graphics unit because the (LVDS, HDMI) encoders are outside the graphics units and also on i.MX6 there are 2 IPUs and displays can be muxed between these IPUs.
Sounds great!
Comments and suggestions welcome.
Here you are:
Sascha
8<--------------------------------------
DRM i.MX: Add devicetree binding documentation
Signed-off-by: Philipp Zabel p.zabel@pengutronix.de Signed-off-by: Sascha Hauer s.hauer@pengutronix.de
.../devicetree/bindings/drm/fsl-imx-drm.txt | 126 ++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 Documentation/devicetree/bindings/drm/fsl-imx-drm.txt
diff --git a/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt b/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt new file mode 100644 index 0000000..6766e03 --- /dev/null +++ b/Documentation/devicetree/bindings/drm/fsl-imx-drm.txt @@ -0,0 +1,126 @@ +Freescale i.MX IPUv3 +====================
+Required properties: +- compatible: Should be "fsl,<chip>-ipu" +- reg: should be register base and length as documented in the
- datasheet
+- interrupts: Should contain sync interrupt and error interrupt,
- in this order.
+- #crtc-cells: 1, See below
+example:
+ipu: ipu@18000000 {
- #crtc-cells = <1>;
- compatible = "fsl,imx53-ipu";
- reg = <0x18000000 0x080000000>;
- interrupts = <11 10>;
+};
+Freescale i.MX LCDC controller +==============================
+Required properties: +- compatible: Should be "fsl,<chip>-lcdc" +- reg: should be register base and length as documented in the
- datasheet
+- interrupts: Should contain interrupt +- #crtc-cells: 0, See below
+example:
+lcdc: lcdc@10021000 {
- #crtc-cells = <0>;
- compatible = "fsl,imx27-lcdc", "fsl,imx21-lcdc";
- reg = <0x10021000 0x4000>;
- interrupts = <61>;
+};
+Parallel display support +========================
+Required properties: +- compatible: Should be "fsl,imx-parallel-display" +- crtc: the crtc this display is connected to, see below +Optional properties: +- interface_pix_fmt: How this display is connected to the
- crtc. Currently supported types: "rgb24", "rgb565"
+- edid: verbatim EDID data block describing attached display.
I never really understood why one should put EDID data in a device-tree. It carries a lot of irrelevant information and is in a quite hostile format. The only reason it exists actually is historically grown "intelligency" built into VESA compatible CRT monitors for PC's.... what do _we_ have to do with that? There isn't even a decent tool to generate this data on linux. On top of that, the examples I have seen of EDID blobs in device-trees so far are just plain wrong and even contain device id's from "Samsung SyncMaster" and other such stuff that IMHO has no place here.
But we need an alternative way of communicating timing parameters. Can't we use something more ad-hoc, like the data one would give to DRM_MODE() in drm_crtc.h?
+- ddc: phandle describing the i2c bus handling the display data
- channel
+example:
+display@di0 {
- compatible = "fsl,imx-parallel-display";
- edid = [edid-data];
- crtc = <&ipu 0>;
- interface_pix_fmt = "rgb24";
+};
+LVDS display bridge (LDB) +=========================
+Required properties: +- compatible: Should be "fsl,<chip>-ldb" +- channel0-crtcs, channel1-crtcs: the crtcs the ldb is connected to, see
- below
+Optional properties: +- channel0-edid, channel1-edid: verbatim EDID data blocks describing the
- displays attached to channel0 and channel1.
+- channel0-ddc, channel1-ddc: phandles describing the i2c busses handling
- the display data channels for channel0 and channel1.
Same rant here... missing a humane way of specifying timing data.
+lvds@53fa8008 {
- compatible = "fsl,imx6q-ldb";
- channel0-edid = [edid-data];
- channel1-ddc = <&i2c0>;
- channel0-crtcs = <&ipu0 0>, <&ipu0 1>, <&ipu1 0>, <&ipu1 1>;
- channel1-crtcs = <&ipu0 0>, <&ipu0 1>, <&ipu1 0>, <&ipu1 1>;
+};
+Specifying CRTCs connected to display output devices +====================================================
+Display output device nodes should specify which CRTCs they can be +connected to in their crtcs property, containing a 'crtc-list':
- crtc-list ::= <single-crtc> [crtc-list]
- single-crtc ::= <crtc-phandle> <crtc-specifier>
- crtc-phandle : phandle to device node providing the crtc
- crtc-specifier : Array of #crtc-cells specifying specific crtc
(controller specific, 1 on imx-ipuv3)+In the following example, two image processing units ipu0 and ipu1 +provide two CRTCs each, indexed with a single cell. The hdmi connector +can be connected to either CRTC of ipu1, and the lvds connector is +fixed to the second CRTC of ipu0.
- ipu0: ipu0 {
#crtc-cells = <1>;- };
- ipu1: ipu1 {
#crtc-cells = <1>;- };
- [...]
- hdmi: hdmi {
ddc = <&i2c2>;crtcs = <&ipu1 0 &ipu1 1>;- };
- lvds: lvds {
edid = [edid-data];crtcs = <&ipu0 1>;- };
+Note that the crtc-specifier length is controller dependent. A simple +lcdc controller with a single CRTC should use #crtc-cells = <0>:
- lcdc: lcdc {
#crtc-cells = <0>;- };
- [...]
- parallel-display {
crtcs = <&lcdc>- };
Best regards,
On Thu, Jun 14, 2012 at 04:10:16PM +0200, David Jander wrote:
On Thu, 14 Jun 2012 15:07:56 +0200 Sascha Hauer s.hauer@pengutronix.de wrote:
+Required properties: +- compatible: Should be "fsl,imx-parallel-display" +- crtc: the crtc this display is connected to, see below +Optional properties: +- interface_pix_fmt: How this display is connected to the
- crtc. Currently supported types: "rgb24", "rgb565"
+- edid: verbatim EDID data block describing attached display.
I never really understood why one should put EDID data in a device-tree. It carries a lot of irrelevant information and is in a quite hostile format. The only reason it exists actually is historically grown "intelligency" built into VESA compatible CRT monitors for PC's.... what do _we_ have to do with that? There isn't even a decent tool to generate this data on linux. On top of that, the examples I have seen of EDID blobs in device-trees so far are just plain wrong and even contain device id's from "Samsung SyncMaster" and other such stuff that IMHO has no place here.
But we need an alternative way of communicating timing parameters. Can't we use something more ad-hoc, like the data one would give to DRM_MODE() in drm_crtc.h?
Generally +1 for this.
I Just don't want to open up another front for now, but I am willing to support a generic (not i.MX specific) format to describe display timings in devicetree.
The only discussion I know about was here:
https://lists.ozlabs.org/pipermail/linuxppc-dev/2010-February/080683.html
The outcome was that the suggested format was not entirely generic and that it would be better to use some existing format rather than inventing something new. I disagree here. The thing called modeline, drm_display_mode or fb_videomode is well established and it is known which parameters (most) displays need, so it should be possible to have a generic display description in the devicetree.
However, we need EDID data parsing anyway in the kernel and being able to overwrite the (maybe broken monitor supplied) EDID data in the devicetree might become handy. So having this way of supplying EDID data is good to have even if there is a generic display description.
Sascha
On Thu, 14 Jun 2012 16:45:33 +0200 Sascha Hauer s.hauer@pengutronix.de wrote:
On Thu, Jun 14, 2012 at 04:10:16PM +0200, David Jander wrote:
On Thu, 14 Jun 2012 15:07:56 +0200 Sascha Hauer s.hauer@pengutronix.de wrote:
+Required properties: +- compatible: Should be "fsl,imx-parallel-display" +- crtc: the crtc this display is connected to, see below +Optional properties: +- interface_pix_fmt: How this display is connected to the
- crtc. Currently supported types: "rgb24", "rgb565"
+- edid: verbatim EDID data block describing attached display.
I never really understood why one should put EDID data in a device-tree. It carries a lot of irrelevant information and is in a quite hostile format. The only reason it exists actually is historically grown "intelligency" built into VESA compatible CRT monitors for PC's.... what do _we_ have to do with that? There isn't even a decent tool to generate this data on linux. On top of that, the examples I have seen of EDID blobs in device-trees so far are just plain wrong and even contain device id's from "Samsung SyncMaster" and other such stuff that IMHO has no place here.
But we need an alternative way of communicating timing parameters. Can't we use something more ad-hoc, like the data one would give to DRM_MODE() in drm_crtc.h?
Generally +1 for this.
Thanks ;-)
I Just don't want to open up another front for now, but I am willing to support a generic (not i.MX specific) format to describe display timings in devicetree.
I understand.
The only discussion I know about was here:
https://lists.ozlabs.org/pipermail/linuxppc-dev/2010-February/080683.html
Oh yeah. I remember vaguely having dealt with that one. I think we actually use the code being discussed there on another boards, and also remember feeling acute pain from tying to figure out how to cough up some useful EDID data blob for our LCD panels. It felt wrong on all ends, and I think I ended up hacking something around this in order to avoid having to deal with EDID.
The outcome was that the suggested format was not entirely generic and that it would be better to use some existing format rather than inventing something new. I disagree here. The thing called modeline, drm_display_mode or fb_videomode is well established and it is known which parameters (most) displays need, so it should be possible to have a generic display description in the devicetree.
Right! It really can't be that complicated.
However, we need EDID data parsing anyway in the kernel and being able
Why? This also feels almost entirely wrong, specially on an embedded system. IMHO, encoders that actually receive EDID data via legacy DDC interfaces, should convert this data immediately to generic timing data, and the kernel should use that instead. But I agree that this is a different discussion and should be held elsewhere.
to overwrite the (maybe broken monitor supplied) EDID data in the devicetree might become handy. So having this way of supplying EDID data is good to have even if there is a generic display description.
I don't see why it would be good to have, but I agree that since it is optional, it can perfectly well be ignored and we can use something else instead. In fact, once there is "something else", I doubt anyone would want to use EDID in a device-tree. EVK's like Babbage and LOCO have DDC interfaces, and all other real embedded systems I can think of would rather benefit from more straight-forward timing information, which can probably be copied almost verbatim from the datasheet of the LCD panel.
Best regards,
dri-devel@lists.freedesktop.org
-
David Jander -
Sascha Hauer