xref: /freebsd/sys/contrib/device-tree/Bindings/display/atmel,lcdc.txt (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1Atmel LCDC Framebuffer
2-----------------------------------------------------
3
4Required properties:
5- compatible :
6	"atmel,at91sam9261-lcdc" ,
7	"atmel,at91sam9263-lcdc" ,
8	"atmel,at91sam9g10-lcdc" ,
9	"atmel,at91sam9g45-lcdc" ,
10	"atmel,at91sam9g45es-lcdc" ,
11	"atmel,at91sam9rl-lcdc" ,
12- reg : Should contain 1 register ranges(address and length).
13	Can contain an additional register range(address and length)
14	for fixed framebuffer memory. Useful for dedicated memories.
15- interrupts : framebuffer controller interrupt
16- display: a phandle pointing to the display node
17
18Required nodes:
19- display: a display node is required to initialize the lcd panel
20	This should be in the board dts.
21- default-mode: a videomode within the display with timing parameters
22	as specified below.
23
24Optional properties:
25- lcd-supply: Regulator for LCD supply voltage.
26
27Example:
28
29	fb0: fb@00500000 {
30		compatible = "atmel,at91sam9g45-lcdc";
31		reg = <0x00500000 0x1000>;
32		interrupts = <23 3 0>;
33		pinctrl-names = "default";
34		pinctrl-0 = <&pinctrl_fb>;
35		display = <&display0>;
36		#address-cells = <1>;
37		#size-cells = <1>;
38
39	};
40
41Example for fixed framebuffer memory:
42
43	fb0: fb@00500000 {
44		compatible = "atmel,at91sam9263-lcdc";
45		reg = <0x00700000 0x1000 0x70000000 0x200000>;
46		[...]
47	};
48
49Atmel LCDC Display
50-----------------------------------------------------
51Required properties (as per of_videomode_helper):
52
53 - atmel,dmacon: dma controller configuration
54 - atmel,lcdcon2: lcd controller configuration
55 - atmel,guard-time: lcd guard time (Delay in frame periods)
56 - bits-per-pixel: lcd panel bit-depth.
57
58Optional properties (as per of_videomode_helper):
59 - atmel,lcdcon-backlight: enable backlight
60 - atmel,lcdcon-backlight-inverted: invert backlight PWM polarity
61 - atmel,lcd-wiring-mode: lcd wiring mode "RGB" or "BRG"
62 - atmel,power-control-gpio: gpio to power on or off the LCD (as many as needed)
63
64Example:
65	display0: display {
66		bits-per-pixel = <32>;
67		atmel,lcdcon-backlight;
68		atmel,dmacon = <0x1>;
69		atmel,lcdcon2 = <0x80008002>;
70		atmel,guard-time = <9>;
71		atmel,lcd-wiring-mode = <1>;
72
73		display-timings {
74			native-mode = <&timing0>;
75			timing0: timing0 {
76				clock-frequency = <9000000>;
77				hactive = <480>;
78				vactive = <272>;
79				hback-porch = <1>;
80				hfront-porch = <1>;
81				vback-porch = <40>;
82				vfront-porch = <1>;
83				hsync-len = <45>;
84				vsync-len = <1>;
85			};
86		};
87	};
88