GNU Linux-libre 6.1.90-gnu
[releases.git] / Documentation / devicetree / bindings / display / atmel,lcdc.txt
1 Atmel LCDC Framebuffer
2 -----------------------------------------------------
3
4 Required 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
18 Required 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
24 Optional properties:
25 - lcd-supply: Regulator for LCD supply voltage.
26
27 Example:
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
41 Example for fixed framebuffer memory:
42
43         fb0: fb@00500000 {
44                 compatible = "atmel,at91sam9263-lcdc";
45                 reg = <0x00700000 0x1000 0x70000000 0x200000>;
46                 [...]
47         };
48
49 Atmel LCDC Display
50 -----------------------------------------------------
51 Required 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
58 Optional 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
64 Example:
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         };