xref: /rk3399_rockchip-uboot/doc/device-tree-bindings/video/displaymode.txt (revision da77a0e593c370c9ed79ea22c1df321d5f4e4bbf)
1*eefe3e59SSimon Glassvideomode bindings
2*eefe3e59SSimon Glass==================
3*eefe3e59SSimon Glass
4*eefe3e59SSimon Glass(from http://lists.freedesktop.org/archives/dri-devel/2012-July/024875.html)
5*eefe3e59SSimon Glass
6*eefe3e59SSimon GlassRequired properties:
7*eefe3e59SSimon Glass - xres, yres: Display resolution
8*eefe3e59SSimon Glass - left-margin, right-margin, hsync-len: Horizontal Display timing
9*eefe3e59SSimon Glass   parameters in pixels
10*eefe3e59SSimon Glass - upper-margin, lower-margin, vsync-len: Vertical display timing
11*eefe3e59SSimon Glass   parameters in lines
12*eefe3e59SSimon Glass - clock: display clock in Hz
13*eefe3e59SSimon Glass
14*eefe3e59SSimon GlassOptional properties:
15*eefe3e59SSimon Glass - width-mm, height-mm: Display dimensions in mm
16*eefe3e59SSimon Glass - hsync-active-high (bool): Hsync pulse is active high
17*eefe3e59SSimon Glass - vsync-active-high (bool): Vsync pulse is active high
18*eefe3e59SSimon Glass - interlaced (bool): This is an interlaced mode
19*eefe3e59SSimon Glass - doublescan (bool): This is a doublescan mode
20*eefe3e59SSimon Glass
21*eefe3e59SSimon GlassThere are different ways of describing a display mode. The devicetree
22*eefe3e59SSimon Glassrepresentation corresponds to the one used by the Linux Framebuffer
23*eefe3e59SSimon Glassframework described here in Documentation/fb/framebuffer.txt. This
24*eefe3e59SSimon Glassrepresentation has been chosen because it's the only format which does
25*eefe3e59SSimon Glassnot allow for inconsistent parameters. Unlike the Framebuffer framework
26*eefe3e59SSimon Glassthe devicetree has the clock in Hz instead of ps.
27*eefe3e59SSimon Glass
28*eefe3e59SSimon GlassExample:
29*eefe3e59SSimon Glass
30*eefe3e59SSimon Glass	display@0 {
31*eefe3e59SSimon Glass		/* 1920x1080p24 */
32*eefe3e59SSimon Glass		clock = <52000000>;
33*eefe3e59SSimon Glass		xres = <1920>;
34*eefe3e59SSimon Glass		yres = <1080>;
35*eefe3e59SSimon Glass		left-margin = <25>;
36*eefe3e59SSimon Glass		right-margin = <25>;
37*eefe3e59SSimon Glass		hsync-len = <25>;
38*eefe3e59SSimon Glass		lower-margin = <2>;
39*eefe3e59SSimon Glass		upper-margin = <2>;
40*eefe3e59SSimon Glass		vsync-len = <2>;
41*eefe3e59SSimon Glass		hsync-active-high;
42*eefe3e59SSimon Glass	};
43