2 * Xilinx TFT frame buffer driver
4 * Author: MontaVista Software, Inc.
7 * 2002-2007 (c) MontaVista Software, Inc.
8 * 2007 (c) Secret Lab Technologies, Ltd.
11 * This file is licensed under the terms of the GNU General Public License
12 * version 2. This program is licensed "as is" without any warranty of any
13 * kind, whether express or implied.
17 * This driver was based on au1100fb.c by MontaVista rewritten for 2.6
18 * by Embedded Alley Solutions <source@embeddedalley.com>, which in turn
19 * was based on skeletonfb.c, Skeleton for a frame buffer device by
23 #include <linux/device.h>
24 #include <linux/module.h>
25 #include <linux/kernel.h>
26 #include <linux/errno.h>
27 #include <linux/platform_device.h>
28 #include <linux/string.h>
31 #include <linux/init.h>
32 #include <linux/dma-mapping.h>
35 #include <linux/slab.h>
41 #define DRIVER_NAME "xilinxfb"
44 * Xilinx calls it "TFT LCD Controller" though it can also be used for
45 * the VGA port on the Xilinx ML40x board. This is a hardware display
46 * controller for a 640x480 resolution TFT or VGA screen.
48 * The interface to the framebuffer is nice and simple. There are two
49 * control registers. The first tells the LCD interface where in memory
50 * the frame buffer is (only the 11 most significant bits are used, so
51 * don't start thinking about scrolling). The second allows the LCD to
52 * be turned on or off as well as rotated 180 degrees.
54 * In case of direct BUS access the second control register will be at
55 * an offset of 4 as compared to the DCR access where the offset is 1
56 * i.e. REG_CTRL. So this is taken care in the function
57 * xilinx_fb_out32 where it left shifts the offset 2 times in case of
63 #define REG_CTRL_ENABLE 0x0001
64 #define REG_CTRL_ROTATE 0x0002
67 * The hardware only handles a single mode: 640x480 24 bit true
68 * color. Each pixel gets a word (32 bits) of memory. Within each word,
69 * the 8 most significant bits are ignored, the next 8 bits are the red
70 * level, the next 8 bits are the green level and the 8 least
71 * significant bits are the blue level. Each row of the LCD uses 1024
72 * words, but only the first 640 pixels are displayed with the other 384
73 * words being ignored. There are 480 rows.
75 #define BYTES_PER_PIXEL 4
76 #define BITS_PER_PIXEL (BYTES_PER_PIXEL * 8)
82 #define PALETTE_ENTRIES_NO 16 /* passed to fb_alloc_cmap() */
84 /* ML300/403 reference design framebuffer driver platform data struct */
85 struct xilinxfb_platform_data
{
86 u32 rotate_screen
; /* Flag to rotate display 180 degrees */
87 u32 screen_height_mm
; /* Physical dimensions of screen in mm */
89 u32 xres
, yres
; /* resolution of screen in pixels */
90 u32 xvirt
, yvirt
; /* resolution of memory buffer */
92 /* Physical address of framebuffer memory; If non-zero, driver
93 * will use provided memory address instead of allocating one from
94 * the consistent pool.
100 * Default xilinxfb configuration
102 static const struct xilinxfb_platform_data xilinx_fb_default_pdata
= {
110 * Here are the default fb_fix_screeninfo and fb_var_screeninfo structures
112 static const struct fb_fix_screeninfo xilinx_fb_fix
= {
114 .type
= FB_TYPE_PACKED_PIXELS
,
115 .visual
= FB_VISUAL_TRUECOLOR
,
116 .accel
= FB_ACCEL_NONE
119 static const struct fb_var_screeninfo xilinx_fb_var
= {
120 .bits_per_pixel
= BITS_PER_PIXEL
,
122 .red
= { RED_SHIFT
, 8, 0 },
123 .green
= { GREEN_SHIFT
, 8, 0 },
124 .blue
= { BLUE_SHIFT
, 8, 0 },
125 .transp
= { 0, 0, 0 },
127 .activate
= FB_ACTIVATE_NOW
130 #define BUS_ACCESS_FLAG 0x1 /* 1 = BUS, 0 = DCR */
131 #define LITTLE_ENDIAN_ACCESS 0x2 /* LITTLE ENDIAN IO functions */
133 struct xilinxfb_drvdata
{
134 struct fb_info info
; /* FB driver info record */
136 phys_addr_t regs_phys
; /* phys. address of the control
139 void __iomem
*regs
; /* virt. address of the control
142 #ifdef CONFIG_PPC_DCR
144 unsigned int dcr_len
;
146 void *fb_virt
; /* virt. address of the frame buffer */
147 dma_addr_t fb_phys
; /* phys. address of the frame buffer */
148 int fb_alloced
; /* Flag, was the fb memory alloced? */
150 u8 flags
; /* features of the driver */
152 u32 reg_ctrl_default
;
154 u32 pseudo_palette
[PALETTE_ENTRIES_NO
];
155 /* Fake palette of 16 colors */
158 #define to_xilinxfb_drvdata(_info) \
159 container_of(_info, struct xilinxfb_drvdata, info)
162 * The XPS TFT Controller can be accessed through BUS or DCR interface.
163 * To perform the read/write on the registers we need to check on
164 * which bus its connected and call the appropriate write API.
166 static void xilinx_fb_out32(struct xilinxfb_drvdata
*drvdata
, u32 offset
,
169 if (drvdata
->flags
& BUS_ACCESS_FLAG
) {
170 if (drvdata
->flags
& LITTLE_ENDIAN_ACCESS
)
171 iowrite32(val
, drvdata
->regs
+ (offset
<< 2));
173 iowrite32be(val
, drvdata
->regs
+ (offset
<< 2));
175 #ifdef CONFIG_PPC_DCR
177 dcr_write(drvdata
->dcr_host
, offset
, val
);
181 static u32
xilinx_fb_in32(struct xilinxfb_drvdata
*drvdata
, u32 offset
)
183 if (drvdata
->flags
& BUS_ACCESS_FLAG
) {
184 if (drvdata
->flags
& LITTLE_ENDIAN_ACCESS
)
185 return ioread32(drvdata
->regs
+ (offset
<< 2));
187 return ioread32be(drvdata
->regs
+ (offset
<< 2));
189 #ifdef CONFIG_PPC_DCR
191 return dcr_read(drvdata
->dcr_host
, offset
);
197 xilinx_fb_setcolreg(unsigned int regno
, unsigned int red
, unsigned int green
,
198 unsigned int blue
, unsigned int transp
, struct fb_info
*fbi
)
200 u32
*palette
= fbi
->pseudo_palette
;
202 if (regno
>= PALETTE_ENTRIES_NO
)
205 if (fbi
->var
.grayscale
) {
206 /* Convert color to grayscale.
207 * grayscale = 0.30*R + 0.59*G + 0.11*B
209 blue
= (red
* 77 + green
* 151 + blue
* 28 + 127) >> 8;
214 /* fbi->fix.visual is always FB_VISUAL_TRUECOLOR */
216 /* We only handle 8 bits of each color. */
220 palette
[regno
] = (red
<< RED_SHIFT
) | (green
<< GREEN_SHIFT
) |
221 (blue
<< BLUE_SHIFT
);
227 xilinx_fb_blank(int blank_mode
, struct fb_info
*fbi
)
229 struct xilinxfb_drvdata
*drvdata
= to_xilinxfb_drvdata(fbi
);
231 switch (blank_mode
) {
232 case FB_BLANK_UNBLANK
:
234 xilinx_fb_out32(drvdata
, REG_CTRL
, drvdata
->reg_ctrl_default
);
237 case FB_BLANK_NORMAL
:
238 case FB_BLANK_VSYNC_SUSPEND
:
239 case FB_BLANK_HSYNC_SUSPEND
:
240 case FB_BLANK_POWERDOWN
:
242 xilinx_fb_out32(drvdata
, REG_CTRL
, 0);
248 return 0; /* success */
251 static const struct fb_ops xilinxfb_ops
= {
252 .owner
= THIS_MODULE
,
253 FB_DEFAULT_IOMEM_OPS
,
254 .fb_setcolreg
= xilinx_fb_setcolreg
,
255 .fb_blank
= xilinx_fb_blank
,
258 /* ---------------------------------------------------------------------
259 * Bus independent setup/teardown
262 static int xilinxfb_assign(struct platform_device
*pdev
,
263 struct xilinxfb_drvdata
*drvdata
,
264 struct xilinxfb_platform_data
*pdata
)
267 struct device
*dev
= &pdev
->dev
;
268 int fbsize
= pdata
->xvirt
* pdata
->yvirt
* BYTES_PER_PIXEL
;
270 if (drvdata
->flags
& BUS_ACCESS_FLAG
) {
271 struct resource
*res
;
273 drvdata
->regs
= devm_platform_get_and_ioremap_resource(pdev
, 0, &res
);
274 if (IS_ERR(drvdata
->regs
))
275 return PTR_ERR(drvdata
->regs
);
277 drvdata
->regs_phys
= res
->start
;
280 /* Allocate the framebuffer memory */
281 if (pdata
->fb_phys
) {
282 drvdata
->fb_phys
= pdata
->fb_phys
;
283 drvdata
->fb_virt
= ioremap(pdata
->fb_phys
, fbsize
);
285 drvdata
->fb_alloced
= 1;
286 drvdata
->fb_virt
= dma_alloc_coherent(dev
, PAGE_ALIGN(fbsize
),
291 if (!drvdata
->fb_virt
) {
292 dev_err(dev
, "Could not allocate frame buffer memory\n");
296 /* Clear (turn to black) the framebuffer */
297 memset_io((void __iomem
*)drvdata
->fb_virt
, 0, fbsize
);
299 /* Tell the hardware where the frame buffer is */
300 xilinx_fb_out32(drvdata
, REG_FB_ADDR
, drvdata
->fb_phys
);
301 rc
= xilinx_fb_in32(drvdata
, REG_FB_ADDR
);
302 /* Endianness detection */
303 if (rc
!= drvdata
->fb_phys
) {
304 drvdata
->flags
|= LITTLE_ENDIAN_ACCESS
;
305 xilinx_fb_out32(drvdata
, REG_FB_ADDR
, drvdata
->fb_phys
);
308 /* Turn on the display */
309 drvdata
->reg_ctrl_default
= REG_CTRL_ENABLE
;
310 if (pdata
->rotate_screen
)
311 drvdata
->reg_ctrl_default
|= REG_CTRL_ROTATE
;
312 xilinx_fb_out32(drvdata
, REG_CTRL
, drvdata
->reg_ctrl_default
);
314 /* Fill struct fb_info */
315 drvdata
->info
.device
= dev
;
316 drvdata
->info
.screen_base
= (void __iomem
*)drvdata
->fb_virt
;
317 drvdata
->info
.fbops
= &xilinxfb_ops
;
318 drvdata
->info
.fix
= xilinx_fb_fix
;
319 drvdata
->info
.fix
.smem_start
= drvdata
->fb_phys
;
320 drvdata
->info
.fix
.smem_len
= fbsize
;
321 drvdata
->info
.fix
.line_length
= pdata
->xvirt
* BYTES_PER_PIXEL
;
323 drvdata
->info
.pseudo_palette
= drvdata
->pseudo_palette
;
324 drvdata
->info
.var
= xilinx_fb_var
;
325 drvdata
->info
.var
.height
= pdata
->screen_height_mm
;
326 drvdata
->info
.var
.width
= pdata
->screen_width_mm
;
327 drvdata
->info
.var
.xres
= pdata
->xres
;
328 drvdata
->info
.var
.yres
= pdata
->yres
;
329 drvdata
->info
.var
.xres_virtual
= pdata
->xvirt
;
330 drvdata
->info
.var
.yres_virtual
= pdata
->yvirt
;
332 /* Allocate a colour map */
333 rc
= fb_alloc_cmap(&drvdata
->info
.cmap
, PALETTE_ENTRIES_NO
, 0);
335 dev_err(dev
, "Fail to allocate colormap (%d entries)\n",
340 /* Register new frame buffer */
341 rc
= register_framebuffer(&drvdata
->info
);
343 dev_err(dev
, "Could not register frame buffer\n");
347 if (drvdata
->flags
& BUS_ACCESS_FLAG
) {
348 /* Put a banner in the log (for DEBUG) */
349 dev_dbg(dev
, "regs: phys=%pa, virt=%p\n",
350 &drvdata
->regs_phys
, drvdata
->regs
);
352 /* Put a banner in the log (for DEBUG) */
353 dev_dbg(dev
, "fb: phys=%llx, virt=%p, size=%x\n",
354 (unsigned long long)drvdata
->fb_phys
, drvdata
->fb_virt
, fbsize
);
356 return 0; /* success */
359 fb_dealloc_cmap(&drvdata
->info
.cmap
);
362 if (drvdata
->fb_alloced
)
363 dma_free_coherent(dev
, PAGE_ALIGN(fbsize
), drvdata
->fb_virt
,
366 iounmap(drvdata
->fb_virt
);
368 /* Turn off the display */
369 xilinx_fb_out32(drvdata
, REG_CTRL
, 0);
374 static void xilinxfb_release(struct device
*dev
)
376 struct xilinxfb_drvdata
*drvdata
= dev_get_drvdata(dev
);
378 #if !defined(CONFIG_FRAMEBUFFER_CONSOLE) && defined(CONFIG_LOGO)
379 xilinx_fb_blank(VESA_POWERDOWN
, &drvdata
->info
);
382 unregister_framebuffer(&drvdata
->info
);
384 fb_dealloc_cmap(&drvdata
->info
.cmap
);
386 if (drvdata
->fb_alloced
)
387 dma_free_coherent(dev
, PAGE_ALIGN(drvdata
->info
.fix
.smem_len
),
388 drvdata
->fb_virt
, drvdata
->fb_phys
);
390 iounmap(drvdata
->fb_virt
);
392 /* Turn off the display */
393 xilinx_fb_out32(drvdata
, REG_CTRL
, 0);
395 #ifdef CONFIG_PPC_DCR
396 /* Release the resources, as allocated based on interface */
397 if (!(drvdata
->flags
& BUS_ACCESS_FLAG
))
398 dcr_unmap(drvdata
->dcr_host
, drvdata
->dcr_len
);
402 /* ---------------------------------------------------------------------
406 static int xilinxfb_of_probe(struct platform_device
*pdev
)
410 struct xilinxfb_platform_data pdata
;
412 struct xilinxfb_drvdata
*drvdata
;
414 /* Copy with the default pdata (not a ptr reference!) */
415 pdata
= xilinx_fb_default_pdata
;
417 /* Allocate the driver data region */
418 drvdata
= devm_kzalloc(&pdev
->dev
, sizeof(*drvdata
), GFP_KERNEL
);
423 * To check whether the core is connected directly to DCR or BUS
424 * interface and initialize the tft_access accordingly.
426 of_property_read_u32(pdev
->dev
.of_node
, "xlnx,dcr-splb-slave-if",
430 * Fill the resource structure if its direct BUS interface
431 * otherwise fill the dcr_host structure.
434 drvdata
->flags
|= BUS_ACCESS_FLAG
;
435 #ifdef CONFIG_PPC_DCR
439 start
= dcr_resource_start(pdev
->dev
.of_node
, 0);
440 drvdata
->dcr_len
= dcr_resource_len(pdev
->dev
.of_node
, 0);
441 drvdata
->dcr_host
= dcr_map(pdev
->dev
.of_node
, start
, drvdata
->dcr_len
);
442 if (!DCR_MAP_OK(drvdata
->dcr_host
)) {
443 dev_err(&pdev
->dev
, "invalid DCR address\n");
449 prop
= of_get_property(pdev
->dev
.of_node
, "phys-size", &size
);
450 if ((prop
) && (size
>= sizeof(u32
) * 2)) {
451 pdata
.screen_width_mm
= prop
[0];
452 pdata
.screen_height_mm
= prop
[1];
455 prop
= of_get_property(pdev
->dev
.of_node
, "resolution", &size
);
456 if ((prop
) && (size
>= sizeof(u32
) * 2)) {
457 pdata
.xres
= prop
[0];
458 pdata
.yres
= prop
[1];
461 prop
= of_get_property(pdev
->dev
.of_node
, "virtual-resolution", &size
);
462 if ((prop
) && (size
>= sizeof(u32
) * 2)) {
463 pdata
.xvirt
= prop
[0];
464 pdata
.yvirt
= prop
[1];
467 pdata
.rotate_screen
= of_property_read_bool(pdev
->dev
.of_node
, "rotate-display");
469 platform_set_drvdata(pdev
, drvdata
);
470 return xilinxfb_assign(pdev
, drvdata
, &pdata
);
473 static void xilinxfb_of_remove(struct platform_device
*op
)
475 xilinxfb_release(&op
->dev
);
478 /* Match table for of_platform binding */
479 static const struct of_device_id xilinxfb_of_match
[] = {
480 { .compatible
= "xlnx,xps-tft-1.00.a", },
481 { .compatible
= "xlnx,xps-tft-2.00.a", },
482 { .compatible
= "xlnx,xps-tft-2.01.a", },
483 { .compatible
= "xlnx,plb-tft-cntlr-ref-1.00.a", },
484 { .compatible
= "xlnx,plb-dvi-cntlr-ref-1.00.c", },
487 MODULE_DEVICE_TABLE(of
, xilinxfb_of_match
);
489 static struct platform_driver xilinxfb_of_driver
= {
490 .probe
= xilinxfb_of_probe
,
491 .remove
= xilinxfb_of_remove
,
494 .of_match_table
= xilinxfb_of_match
,
498 module_platform_driver(xilinxfb_of_driver
);
500 MODULE_AUTHOR("MontaVista Software, Inc. <source@mvista.com>");
501 MODULE_DESCRIPTION("Xilinx TFT frame buffer driver");
502 MODULE_LICENSE("GPL");