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