1 /* 2 * linux/drivers/video/vfb.c -- Virtual frame buffer device 3 * 4 * Copyright (C) 2002 James Simmons 5 * 6 * Copyright (C) 1997 Geert Uytterhoeven 7 * 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 10 * more details. 11 */ 12 13 #include <linux/module.h> 14 #include <linux/kernel.h> 15 #include <linux/errno.h> 16 #include <linux/string.h> 17 #include <linux/mm.h> 18 #include <linux/vmalloc.h> 19 #include <linux/delay.h> 20 #include <linux/interrupt.h> 21 #include <linux/platform_device.h> 22 23 #include <linux/fb.h> 24 #include <linux/init.h> 25 26 /* 27 * RAM we reserve for the frame buffer. This defines the maximum screen 28 * size 29 * 30 * The default can be overridden if the driver is compiled as a module 31 */ 32 33 #define VIDEOMEMSIZE (1*1024*1024) /* 1 MB */ 34 35 static void *videomemory; 36 static u_long videomemorysize = VIDEOMEMSIZE; 37 module_param(videomemorysize, ulong, 0); 38 MODULE_PARM_DESC(videomemorysize, "RAM available to frame buffer (in bytes)"); 39 40 static char *mode_option = NULL; 41 module_param(mode_option, charp, 0); 42 MODULE_PARM_DESC(mode_option, "Preferred video mode (e.g. 640x480-8@60)"); 43 44 static const struct fb_videomode vfb_default = { 45 .xres = 640, 46 .yres = 480, 47 .pixclock = 20000, 48 .left_margin = 64, 49 .right_margin = 64, 50 .upper_margin = 32, 51 .lower_margin = 32, 52 .hsync_len = 64, 53 .vsync_len = 2, 54 .vmode = FB_VMODE_NONINTERLACED, 55 }; 56 57 static struct fb_fix_screeninfo vfb_fix = { 58 .id = "Virtual FB", 59 .type = FB_TYPE_PACKED_PIXELS, 60 .visual = FB_VISUAL_PSEUDOCOLOR, 61 .xpanstep = 1, 62 .ypanstep = 1, 63 .ywrapstep = 1, 64 .accel = FB_ACCEL_NONE, 65 }; 66 67 static bool vfb_enable __initdata = 0; /* disabled by default */ 68 module_param(vfb_enable, bool, 0); 69 MODULE_PARM_DESC(vfb_enable, "Enable Virtual FB driver"); 70 71 static int vfb_check_var(struct fb_var_screeninfo *var, 72 struct fb_info *info); 73 static int vfb_set_par(struct fb_info *info); 74 static int vfb_setcolreg(u_int regno, u_int red, u_int green, u_int blue, 75 u_int transp, struct fb_info *info); 76 static int vfb_pan_display(struct fb_var_screeninfo *var, 77 struct fb_info *info); 78 static int vfb_mmap(struct fb_info *info, 79 struct vm_area_struct *vma); 80 81 static const struct fb_ops vfb_ops = { 82 .fb_read = fb_sys_read, 83 .fb_write = fb_sys_write, 84 .fb_check_var = vfb_check_var, 85 .fb_set_par = vfb_set_par, 86 .fb_setcolreg = vfb_setcolreg, 87 .fb_pan_display = vfb_pan_display, 88 .fb_fillrect = sys_fillrect, 89 .fb_copyarea = sys_copyarea, 90 .fb_imageblit = sys_imageblit, 91 .fb_mmap = vfb_mmap, 92 }; 93 94 /* 95 * Internal routines 96 */ 97 98 static u_long get_line_length(int xres_virtual, int bpp) 99 { 100 u_long length; 101 102 length = xres_virtual * bpp; 103 length = (length + 31) & ~31; 104 length >>= 3; 105 return (length); 106 } 107 108 /* 109 * Setting the video mode has been split into two parts. 110 * First part, xxxfb_check_var, must not write anything 111 * to hardware, it should only verify and adjust var. 112 * This means it doesn't alter par but it does use hardware 113 * data from it to check this var. 114 */ 115 116 static int vfb_check_var(struct fb_var_screeninfo *var, 117 struct fb_info *info) 118 { 119 u_long line_length; 120 121 /* 122 * FB_VMODE_CONUPDATE and FB_VMODE_SMOOTH_XPAN are equal! 123 * as FB_VMODE_SMOOTH_XPAN is only used internally 124 */ 125 126 if (var->vmode & FB_VMODE_CONUPDATE) { 127 var->vmode |= FB_VMODE_YWRAP; 128 var->xoffset = info->var.xoffset; 129 var->yoffset = info->var.yoffset; 130 } 131 132 /* 133 * Some very basic checks 134 */ 135 if (!var->xres) 136 var->xres = 1; 137 if (!var->yres) 138 var->yres = 1; 139 if (var->xres > var->xres_virtual) 140 var->xres_virtual = var->xres; 141 if (var->yres > var->yres_virtual) 142 var->yres_virtual = var->yres; 143 if (var->bits_per_pixel <= 1) 144 var->bits_per_pixel = 1; 145 else if (var->bits_per_pixel <= 8) 146 var->bits_per_pixel = 8; 147 else if (var->bits_per_pixel <= 16) 148 var->bits_per_pixel = 16; 149 else if (var->bits_per_pixel <= 24) 150 var->bits_per_pixel = 24; 151 else if (var->bits_per_pixel <= 32) 152 var->bits_per_pixel = 32; 153 else 154 return -EINVAL; 155 156 if (var->xres_virtual < var->xoffset + var->xres) 157 var->xres_virtual = var->xoffset + var->xres; 158 if (var->yres_virtual < var->yoffset + var->yres) 159 var->yres_virtual = var->yoffset + var->yres; 160 161 /* 162 * Memory limit 163 */ 164 line_length = 165 get_line_length(var->xres_virtual, var->bits_per_pixel); 166 if (line_length * var->yres_virtual > videomemorysize) 167 return -ENOMEM; 168 169 /* 170 * Now that we checked it we alter var. The reason being is that the video 171 * mode passed in might not work but slight changes to it might make it 172 * work. This way we let the user know what is acceptable. 173 */ 174 switch (var->bits_per_pixel) { 175 case 1: 176 case 8: 177 var->red.offset = 0; 178 var->red.length = 8; 179 var->green.offset = 0; 180 var->green.length = 8; 181 var->blue.offset = 0; 182 var->blue.length = 8; 183 var->transp.offset = 0; 184 var->transp.length = 0; 185 break; 186 case 16: /* RGBA 5551 */ 187 if (var->transp.length) { 188 var->red.offset = 0; 189 var->red.length = 5; 190 var->green.offset = 5; 191 var->green.length = 5; 192 var->blue.offset = 10; 193 var->blue.length = 5; 194 var->transp.offset = 15; 195 var->transp.length = 1; 196 } else { /* RGB 565 */ 197 var->red.offset = 0; 198 var->red.length = 5; 199 var->green.offset = 5; 200 var->green.length = 6; 201 var->blue.offset = 11; 202 var->blue.length = 5; 203 var->transp.offset = 0; 204 var->transp.length = 0; 205 } 206 break; 207 case 24: /* RGB 888 */ 208 var->red.offset = 0; 209 var->red.length = 8; 210 var->green.offset = 8; 211 var->green.length = 8; 212 var->blue.offset = 16; 213 var->blue.length = 8; 214 var->transp.offset = 0; 215 var->transp.length = 0; 216 break; 217 case 32: /* RGBA 8888 */ 218 var->red.offset = 0; 219 var->red.length = 8; 220 var->green.offset = 8; 221 var->green.length = 8; 222 var->blue.offset = 16; 223 var->blue.length = 8; 224 var->transp.offset = 24; 225 var->transp.length = 8; 226 break; 227 } 228 var->red.msb_right = 0; 229 var->green.msb_right = 0; 230 var->blue.msb_right = 0; 231 var->transp.msb_right = 0; 232 233 return 0; 234 } 235 236 /* This routine actually sets the video mode. It's in here where we 237 * the hardware state info->par and fix which can be affected by the 238 * change in par. For this driver it doesn't do much. 239 */ 240 static int vfb_set_par(struct fb_info *info) 241 { 242 switch (info->var.bits_per_pixel) { 243 case 1: 244 info->fix.visual = FB_VISUAL_MONO01; 245 break; 246 case 8: 247 info->fix.visual = FB_VISUAL_PSEUDOCOLOR; 248 break; 249 case 16: 250 case 24: 251 case 32: 252 info->fix.visual = FB_VISUAL_TRUECOLOR; 253 break; 254 } 255 256 info->fix.line_length = get_line_length(info->var.xres_virtual, 257 info->var.bits_per_pixel); 258 259 return 0; 260 } 261 262 /* 263 * Set a single color register. The values supplied are already 264 * rounded down to the hardware's capabilities (according to the 265 * entries in the var structure). Return != 0 for invalid regno. 266 */ 267 268 static int vfb_setcolreg(u_int regno, u_int red, u_int green, u_int blue, 269 u_int transp, struct fb_info *info) 270 { 271 if (regno >= 256) /* no. of hw registers */ 272 return 1; 273 /* 274 * Program hardware... do anything you want with transp 275 */ 276 277 /* grayscale works only partially under directcolor */ 278 if (info->var.grayscale) { 279 /* grayscale = 0.30*R + 0.59*G + 0.11*B */ 280 red = green = blue = 281 (red * 77 + green * 151 + blue * 28) >> 8; 282 } 283 284 /* Directcolor: 285 * var->{color}.offset contains start of bitfield 286 * var->{color}.length contains length of bitfield 287 * {hardwarespecific} contains width of RAMDAC 288 * cmap[X] is programmed to (X << red.offset) | (X << green.offset) | (X << blue.offset) 289 * RAMDAC[X] is programmed to (red, green, blue) 290 * 291 * Pseudocolor: 292 * var->{color}.offset is 0 unless the palette index takes less than 293 * bits_per_pixel bits and is stored in the upper 294 * bits of the pixel value 295 * var->{color}.length is set so that 1 << length is the number of available 296 * palette entries 297 * cmap is not used 298 * RAMDAC[X] is programmed to (red, green, blue) 299 * 300 * Truecolor: 301 * does not use DAC. Usually 3 are present. 302 * var->{color}.offset contains start of bitfield 303 * var->{color}.length contains length of bitfield 304 * cmap is programmed to (red << red.offset) | (green << green.offset) | 305 * (blue << blue.offset) | (transp << transp.offset) 306 * RAMDAC does not exist 307 */ 308 #define CNVT_TOHW(val,width) ((((val)<<(width))+0x7FFF-(val))>>16) 309 switch (info->fix.visual) { 310 case FB_VISUAL_TRUECOLOR: 311 case FB_VISUAL_PSEUDOCOLOR: 312 red = CNVT_TOHW(red, info->var.red.length); 313 green = CNVT_TOHW(green, info->var.green.length); 314 blue = CNVT_TOHW(blue, info->var.blue.length); 315 transp = CNVT_TOHW(transp, info->var.transp.length); 316 break; 317 case FB_VISUAL_DIRECTCOLOR: 318 red = CNVT_TOHW(red, 8); /* expect 8 bit DAC */ 319 green = CNVT_TOHW(green, 8); 320 blue = CNVT_TOHW(blue, 8); 321 /* hey, there is bug in transp handling... */ 322 transp = CNVT_TOHW(transp, 8); 323 break; 324 } 325 #undef CNVT_TOHW 326 /* Truecolor has hardware independent palette */ 327 if (info->fix.visual == FB_VISUAL_TRUECOLOR) { 328 u32 v; 329 330 if (regno >= 16) 331 return 1; 332 333 v = (red << info->var.red.offset) | 334 (green << info->var.green.offset) | 335 (blue << info->var.blue.offset) | 336 (transp << info->var.transp.offset); 337 switch (info->var.bits_per_pixel) { 338 case 8: 339 break; 340 case 16: 341 ((u32 *) (info->pseudo_palette))[regno] = v; 342 break; 343 case 24: 344 case 32: 345 ((u32 *) (info->pseudo_palette))[regno] = v; 346 break; 347 } 348 return 0; 349 } 350 return 0; 351 } 352 353 /* 354 * Pan or Wrap the Display 355 * 356 * This call looks only at xoffset, yoffset and the FB_VMODE_YWRAP flag 357 */ 358 359 static int vfb_pan_display(struct fb_var_screeninfo *var, 360 struct fb_info *info) 361 { 362 if (var->vmode & FB_VMODE_YWRAP) { 363 if (var->yoffset >= info->var.yres_virtual || 364 var->xoffset) 365 return -EINVAL; 366 } else { 367 if (var->xoffset + info->var.xres > info->var.xres_virtual || 368 var->yoffset + info->var.yres > info->var.yres_virtual) 369 return -EINVAL; 370 } 371 info->var.xoffset = var->xoffset; 372 info->var.yoffset = var->yoffset; 373 if (var->vmode & FB_VMODE_YWRAP) 374 info->var.vmode |= FB_VMODE_YWRAP; 375 else 376 info->var.vmode &= ~FB_VMODE_YWRAP; 377 return 0; 378 } 379 380 /* 381 * Most drivers don't need their own mmap function 382 */ 383 384 static int vfb_mmap(struct fb_info *info, 385 struct vm_area_struct *vma) 386 { 387 return remap_vmalloc_range(vma, (void *)info->fix.smem_start, vma->vm_pgoff); 388 } 389 390 #ifndef MODULE 391 /* 392 * The virtual framebuffer driver is only enabled if explicitly 393 * requested by passing 'video=vfb:' (or any actual options). 394 */ 395 static int __init vfb_setup(char *options) 396 { 397 char *this_opt; 398 399 vfb_enable = 0; 400 401 if (!options) 402 return 1; 403 404 vfb_enable = 1; 405 406 if (!*options) 407 return 1; 408 409 while ((this_opt = strsep(&options, ",")) != NULL) { 410 if (!*this_opt) 411 continue; 412 /* Test disable for backwards compatibility */ 413 if (!strcmp(this_opt, "disable")) 414 vfb_enable = 0; 415 else 416 mode_option = this_opt; 417 } 418 return 1; 419 } 420 #endif /* MODULE */ 421 422 /* 423 * Initialisation 424 */ 425 426 static int vfb_probe(struct platform_device *dev) 427 { 428 struct fb_info *info; 429 unsigned int size = PAGE_ALIGN(videomemorysize); 430 int retval = -ENOMEM; 431 432 /* 433 * For real video cards we use ioremap. 434 */ 435 if (!(videomemory = vmalloc_32_user(size))) 436 return retval; 437 438 info = framebuffer_alloc(sizeof(u32) * 256, &dev->dev); 439 if (!info) 440 goto err; 441 442 info->screen_base = (char __iomem *)videomemory; 443 info->fbops = &vfb_ops; 444 445 if (!fb_find_mode(&info->var, info, mode_option, 446 NULL, 0, &vfb_default, 8)){ 447 fb_err(info, "Unable to find usable video mode.\n"); 448 retval = -EINVAL; 449 goto err1; 450 } 451 452 vfb_fix.smem_start = (unsigned long) videomemory; 453 vfb_fix.smem_len = videomemorysize; 454 info->fix = vfb_fix; 455 info->pseudo_palette = info->par; 456 info->par = NULL; 457 info->flags = FBINFO_FLAG_DEFAULT; 458 459 retval = fb_alloc_cmap(&info->cmap, 256, 0); 460 if (retval < 0) 461 goto err1; 462 463 retval = register_framebuffer(info); 464 if (retval < 0) 465 goto err2; 466 platform_set_drvdata(dev, info); 467 468 vfb_set_par(info); 469 470 fb_info(info, "Virtual frame buffer device, using %ldK of video memory\n", 471 videomemorysize >> 10); 472 return 0; 473 err2: 474 fb_dealloc_cmap(&info->cmap); 475 err1: 476 framebuffer_release(info); 477 err: 478 vfree(videomemory); 479 return retval; 480 } 481 482 static int vfb_remove(struct platform_device *dev) 483 { 484 struct fb_info *info = platform_get_drvdata(dev); 485 486 if (info) { 487 unregister_framebuffer(info); 488 vfree(videomemory); 489 fb_dealloc_cmap(&info->cmap); 490 framebuffer_release(info); 491 } 492 return 0; 493 } 494 495 static struct platform_driver vfb_driver = { 496 .probe = vfb_probe, 497 .remove = vfb_remove, 498 .driver = { 499 .name = "vfb", 500 }, 501 }; 502 503 static struct platform_device *vfb_device; 504 505 static int __init vfb_init(void) 506 { 507 int ret = 0; 508 509 #ifndef MODULE 510 char *option = NULL; 511 512 if (fb_get_options("vfb", &option)) 513 return -ENODEV; 514 vfb_setup(option); 515 #endif 516 517 if (!vfb_enable) 518 return -ENXIO; 519 520 ret = platform_driver_register(&vfb_driver); 521 522 if (!ret) { 523 vfb_device = platform_device_alloc("vfb", 0); 524 525 if (vfb_device) 526 ret = platform_device_add(vfb_device); 527 else 528 ret = -ENOMEM; 529 530 if (ret) { 531 platform_device_put(vfb_device); 532 platform_driver_unregister(&vfb_driver); 533 } 534 } 535 536 return ret; 537 } 538 539 module_init(vfb_init); 540 541 #ifdef MODULE 542 static void __exit vfb_exit(void) 543 { 544 platform_device_unregister(vfb_device); 545 platform_driver_unregister(&vfb_driver); 546 } 547 548 module_exit(vfb_exit); 549 550 MODULE_LICENSE("GPL"); 551 #endif /* MODULE */ 552