2  *  linux/drivers/video/vfb.c -- Virtual frame buffer device
 
   4  *      Copyright (C) 2002 James Simmons
 
   6  *      Copyright (C) 1997 Geert Uytterhoeven
 
   8  *  This file is subject to the terms and conditions of the GNU General Public
 
   9  *  License. See the file COPYING in the main directory of this archive for
 
  13 #include <linux/module.h>
 
  14 #include <linux/kernel.h>
 
  15 #include <linux/errno.h>
 
  16 #include <linux/string.h>
 
  18 #include <linux/slab.h>
 
  19 #include <linux/vmalloc.h>
 
  20 #include <linux/delay.h>
 
  21 #include <linux/interrupt.h>
 
  22 #include <linux/platform_device.h>
 
  24 #include <asm/uaccess.h>
 
  26 #include <linux/init.h>
 
  29      *  RAM we reserve for the frame buffer. This defines the maximum screen
 
  32      *  The default can be overridden if the driver is compiled as a module
 
  35 #define VIDEOMEMSIZE    (1*1024*1024)   /* 1 MB */
 
  37 static void *videomemory;
 
  38 static u_long videomemorysize = VIDEOMEMSIZE;
 
  39 module_param(videomemorysize, ulong, 0);
 
  41 static struct fb_var_screeninfo vfb_default __initdata = {
 
  50         .activate =     FB_ACTIVATE_TEST,
 
  60         .vmode =        FB_VMODE_NONINTERLACED,
 
  63 static struct fb_fix_screeninfo vfb_fix __initdata = {
 
  65         .type =         FB_TYPE_PACKED_PIXELS,
 
  66         .visual =       FB_VISUAL_PSEUDOCOLOR,
 
  70         .accel =        FB_ACCEL_NONE,
 
  73 static int vfb_enable __initdata = 0;   /* disabled by default */
 
  74 module_param(vfb_enable, bool, 0);
 
  76 static int vfb_check_var(struct fb_var_screeninfo *var,
 
  77                          struct fb_info *info);
 
  78 static int vfb_set_par(struct fb_info *info);
 
  79 static int vfb_setcolreg(u_int regno, u_int red, u_int green, u_int blue,
 
  80                          u_int transp, struct fb_info *info);
 
  81 static int vfb_pan_display(struct fb_var_screeninfo *var,
 
  82                            struct fb_info *info);
 
  83 static int vfb_mmap(struct fb_info *info,
 
  84                     struct vm_area_struct *vma);
 
  86 static struct fb_ops vfb_ops = {
 
  87         .fb_read        = fb_sys_read,
 
  88         .fb_write       = fb_sys_write,
 
  89         .fb_check_var   = vfb_check_var,
 
  90         .fb_set_par     = vfb_set_par,
 
  91         .fb_setcolreg   = vfb_setcolreg,
 
  92         .fb_pan_display = vfb_pan_display,
 
  93         .fb_fillrect    = sys_fillrect,
 
  94         .fb_copyarea    = sys_copyarea,
 
  95         .fb_imageblit   = sys_imageblit,
 
 103 static u_long get_line_length(int xres_virtual, int bpp)
 
 107         length = xres_virtual * bpp;
 
 108         length = (length + 31) & ~31;
 
 114      *  Setting the video mode has been split into two parts.
 
 115      *  First part, xxxfb_check_var, must not write anything
 
 116      *  to hardware, it should only verify and adjust var.
 
 117      *  This means it doesn't alter par but it does use hardware
 
 118      *  data from it to check this var. 
 
 121 static int vfb_check_var(struct fb_var_screeninfo *var,
 
 122                          struct fb_info *info)
 
 127          *  FB_VMODE_CONUPDATE and FB_VMODE_SMOOTH_XPAN are equal!
 
 128          *  as FB_VMODE_SMOOTH_XPAN is only used internally
 
 131         if (var->vmode & FB_VMODE_CONUPDATE) {
 
 132                 var->vmode |= FB_VMODE_YWRAP;
 
 133                 var->xoffset = info->var.xoffset;
 
 134                 var->yoffset = info->var.yoffset;
 
 138          *  Some very basic checks
 
 144         if (var->xres > var->xres_virtual)
 
 145                 var->xres_virtual = var->xres;
 
 146         if (var->yres > var->yres_virtual)
 
 147                 var->yres_virtual = var->yres;
 
 148         if (var->bits_per_pixel <= 1)
 
 149                 var->bits_per_pixel = 1;
 
 150         else if (var->bits_per_pixel <= 8)
 
 151                 var->bits_per_pixel = 8;
 
 152         else if (var->bits_per_pixel <= 16)
 
 153                 var->bits_per_pixel = 16;
 
 154         else if (var->bits_per_pixel <= 24)
 
 155                 var->bits_per_pixel = 24;
 
 156         else if (var->bits_per_pixel <= 32)
 
 157                 var->bits_per_pixel = 32;
 
 161         if (var->xres_virtual < var->xoffset + var->xres)
 
 162                 var->xres_virtual = var->xoffset + var->xres;
 
 163         if (var->yres_virtual < var->yoffset + var->yres)
 
 164                 var->yres_virtual = var->yoffset + var->yres;
 
 170             get_line_length(var->xres_virtual, var->bits_per_pixel);
 
 171         if (line_length * var->yres_virtual > videomemorysize)
 
 175          * Now that we checked it we alter var. The reason being is that the video
 
 176          * mode passed in might not work but slight changes to it might make it 
 
 177          * work. This way we let the user know what is acceptable.
 
 179         switch (var->bits_per_pixel) {
 
 184                 var->green.offset = 0;
 
 185                 var->green.length = 8;
 
 186                 var->blue.offset = 0;
 
 187                 var->blue.length = 8;
 
 188                 var->transp.offset = 0;
 
 189                 var->transp.length = 0;
 
 191         case 16:                /* RGBA 5551 */
 
 192                 if (var->transp.length) {
 
 195                         var->green.offset = 5;
 
 196                         var->green.length = 5;
 
 197                         var->blue.offset = 10;
 
 198                         var->blue.length = 5;
 
 199                         var->transp.offset = 15;
 
 200                         var->transp.length = 1;
 
 201                 } else {        /* RGB 565 */
 
 204                         var->green.offset = 5;
 
 205                         var->green.length = 6;
 
 206                         var->blue.offset = 11;
 
 207                         var->blue.length = 5;
 
 208                         var->transp.offset = 0;
 
 209                         var->transp.length = 0;
 
 212         case 24:                /* RGB 888 */
 
 215                 var->green.offset = 8;
 
 216                 var->green.length = 8;
 
 217                 var->blue.offset = 16;
 
 218                 var->blue.length = 8;
 
 219                 var->transp.offset = 0;
 
 220                 var->transp.length = 0;
 
 222         case 32:                /* RGBA 8888 */
 
 225                 var->green.offset = 8;
 
 226                 var->green.length = 8;
 
 227                 var->blue.offset = 16;
 
 228                 var->blue.length = 8;
 
 229                 var->transp.offset = 24;
 
 230                 var->transp.length = 8;
 
 233         var->red.msb_right = 0;
 
 234         var->green.msb_right = 0;
 
 235         var->blue.msb_right = 0;
 
 236         var->transp.msb_right = 0;
 
 241 /* This routine actually sets the video mode. It's in here where we
 
 242  * the hardware state info->par and fix which can be affected by the 
 
 243  * change in par. For this driver it doesn't do much. 
 
 245 static int vfb_set_par(struct fb_info *info)
 
 247         info->fix.line_length = get_line_length(info->var.xres_virtual,
 
 248                                                 info->var.bits_per_pixel);
 
 253      *  Set a single color register. The values supplied are already
 
 254      *  rounded down to the hardware's capabilities (according to the
 
 255      *  entries in the var structure). Return != 0 for invalid regno.
 
 258 static int vfb_setcolreg(u_int regno, u_int red, u_int green, u_int blue,
 
 259                          u_int transp, struct fb_info *info)
 
 261         if (regno >= 256)       /* no. of hw registers */
 
 264          * Program hardware... do anything you want with transp
 
 267         /* grayscale works only partially under directcolor */
 
 268         if (info->var.grayscale) {
 
 269                 /* grayscale = 0.30*R + 0.59*G + 0.11*B */
 
 271                     (red * 77 + green * 151 + blue * 28) >> 8;
 
 275          *   var->{color}.offset contains start of bitfield
 
 276          *   var->{color}.length contains length of bitfield
 
 277          *   {hardwarespecific} contains width of RAMDAC
 
 278          *   cmap[X] is programmed to (X << red.offset) | (X << green.offset) | (X << blue.offset)
 
 279          *   RAMDAC[X] is programmed to (red, green, blue)
 
 282          *    uses offset = 0 && length = RAMDAC register width.
 
 283          *    var->{color}.offset is 0
 
 284          *    var->{color}.length contains widht of DAC
 
 286          *    RAMDAC[X] is programmed to (red, green, blue)
 
 288          *    does not use DAC. Usually 3 are present.
 
 289          *    var->{color}.offset contains start of bitfield
 
 290          *    var->{color}.length contains length of bitfield
 
 291          *    cmap is programmed to (red << red.offset) | (green << green.offset) |
 
 292          *                      (blue << blue.offset) | (transp << transp.offset)
 
 293          *    RAMDAC does not exist
 
 295 #define CNVT_TOHW(val,width) ((((val)<<(width))+0x7FFF-(val))>>16)
 
 296         switch (info->fix.visual) {
 
 297         case FB_VISUAL_TRUECOLOR:
 
 298         case FB_VISUAL_PSEUDOCOLOR:
 
 299                 red = CNVT_TOHW(red, info->var.red.length);
 
 300                 green = CNVT_TOHW(green, info->var.green.length);
 
 301                 blue = CNVT_TOHW(blue, info->var.blue.length);
 
 302                 transp = CNVT_TOHW(transp, info->var.transp.length);
 
 304         case FB_VISUAL_DIRECTCOLOR:
 
 305                 red = CNVT_TOHW(red, 8);        /* expect 8 bit DAC */
 
 306                 green = CNVT_TOHW(green, 8);
 
 307                 blue = CNVT_TOHW(blue, 8);
 
 308                 /* hey, there is bug in transp handling... */
 
 309                 transp = CNVT_TOHW(transp, 8);
 
 313         /* Truecolor has hardware independent palette */
 
 314         if (info->fix.visual == FB_VISUAL_TRUECOLOR) {
 
 320                 v = (red << info->var.red.offset) |
 
 321                     (green << info->var.green.offset) |
 
 322                     (blue << info->var.blue.offset) |
 
 323                     (transp << info->var.transp.offset);
 
 324                 switch (info->var.bits_per_pixel) {
 
 328                         ((u32 *) (info->pseudo_palette))[regno] = v;
 
 332                         ((u32 *) (info->pseudo_palette))[regno] = v;
 
 341      *  Pan or Wrap the Display
 
 343      *  This call looks only at xoffset, yoffset and the FB_VMODE_YWRAP flag
 
 346 static int vfb_pan_display(struct fb_var_screeninfo *var,
 
 347                            struct fb_info *info)
 
 349         if (var->vmode & FB_VMODE_YWRAP) {
 
 351                     || var->yoffset >= info->var.yres_virtual
 
 355                 if (var->xoffset + var->xres > info->var.xres_virtual ||
 
 356                     var->yoffset + var->yres > info->var.yres_virtual)
 
 359         info->var.xoffset = var->xoffset;
 
 360         info->var.yoffset = var->yoffset;
 
 361         if (var->vmode & FB_VMODE_YWRAP)
 
 362                 info->var.vmode |= FB_VMODE_YWRAP;
 
 364                 info->var.vmode &= ~FB_VMODE_YWRAP;
 
 369      *  Most drivers don't need their own mmap function 
 
 372 static int vfb_mmap(struct fb_info *info,
 
 373                     struct vm_area_struct *vma)
 
 379 static int __init vfb_setup(char *options)
 
 385         if (!options || !*options)
 
 388         while ((this_opt = strsep(&options, ",")) != NULL) {
 
 391                 if (!strncmp(this_opt, "disable", 7))
 
 402 static int __init vfb_probe(struct platform_device *dev)
 
 404         struct fb_info *info;
 
 405         int retval = -ENOMEM;
 
 408          * For real video cards we use ioremap.
 
 410         if (!(videomemory = vmalloc(videomemorysize)))
 
 414          * VFB must clear memory to prevent kernel info
 
 415          * leakage into userspace
 
 416          * VGA-based drivers MUST NOT clear memory if
 
 417          * they want to be able to take over vgacon
 
 419         memset(videomemory, 0, videomemorysize);
 
 421         info = framebuffer_alloc(sizeof(u32) * 256, &dev->dev);
 
 425         info->screen_base = (char __iomem *)videomemory;
 
 426         info->fbops = &vfb_ops;
 
 428         retval = fb_find_mode(&info->var, info, NULL,
 
 431         if (!retval || (retval == 4))
 
 432                 info->var = vfb_default;
 
 434         info->pseudo_palette = info->par;
 
 436         info->flags = FBINFO_FLAG_DEFAULT;
 
 438         retval = fb_alloc_cmap(&info->cmap, 256, 0);
 
 442         retval = register_framebuffer(info);
 
 445         platform_set_drvdata(dev, info);
 
 448                "fb%d: Virtual frame buffer device, using %ldK of video memory\n",
 
 449                info->node, videomemorysize >> 10);
 
 452         fb_dealloc_cmap(&info->cmap);
 
 454         framebuffer_release(info);
 
 460 static int vfb_remove(struct platform_device *dev)
 
 462         struct fb_info *info = platform_get_drvdata(dev);
 
 465                 unregister_framebuffer(info);
 
 467                 framebuffer_release(info);
 
 472 static struct platform_driver vfb_driver = {
 
 474         .remove = vfb_remove,
 
 480 static struct platform_device *vfb_device;
 
 482 static int __init vfb_init(void)
 
 489         if (fb_get_options("vfb", &option))
 
 497         ret = platform_driver_register(&vfb_driver);
 
 500                 vfb_device = platform_device_alloc("vfb", 0);
 
 503                         ret = platform_device_add(vfb_device);
 
 508                         platform_device_put(vfb_device);
 
 509                         platform_driver_unregister(&vfb_driver);
 
 516 module_init(vfb_init);
 
 519 static void __exit vfb_exit(void)
 
 521         platform_device_unregister(vfb_device);
 
 522         platform_driver_unregister(&vfb_driver);
 
 525 module_exit(vfb_exit);
 
 527 MODULE_LICENSE("GPL");