[CONNECTOR]: Update documentation to match reality.
[linux-2.6/verdex.git] / include / linux / fb.h
blobc698055266d062b09fa7e19b447144c67fd82c22
1 #ifndef _LINUX_FB_H
2 #define _LINUX_FB_H
4 #include <asm/types.h>
6 /* Definitions of frame buffers */
8 #define FB_MAJOR 29
9 #define FB_MAX 32 /* sufficient for now */
11 /* ioctls
12 0x46 is 'F' */
13 #define FBIOGET_VSCREENINFO 0x4600
14 #define FBIOPUT_VSCREENINFO 0x4601
15 #define FBIOGET_FSCREENINFO 0x4602
16 #define FBIOGETCMAP 0x4604
17 #define FBIOPUTCMAP 0x4605
18 #define FBIOPAN_DISPLAY 0x4606
19 #ifdef __KERNEL__
20 #define FBIO_CURSOR _IOWR('F', 0x08, struct fb_cursor_user)
21 #else
22 #define FBIO_CURSOR _IOWR('F', 0x08, struct fb_cursor)
23 #endif
24 /* 0x4607-0x460B are defined below */
25 /* #define FBIOGET_MONITORSPEC 0x460C */
26 /* #define FBIOPUT_MONITORSPEC 0x460D */
27 /* #define FBIOSWITCH_MONIBIT 0x460E */
28 #define FBIOGET_CON2FBMAP 0x460F
29 #define FBIOPUT_CON2FBMAP 0x4610
30 #define FBIOBLANK 0x4611 /* arg: 0 or vesa level + 1 */
31 #define FBIOGET_VBLANK _IOR('F', 0x12, struct fb_vblank)
32 #define FBIO_ALLOC 0x4613
33 #define FBIO_FREE 0x4614
34 #define FBIOGET_GLYPH 0x4615
35 #define FBIOGET_HWCINFO 0x4616
36 #define FBIOPUT_MODEINFO 0x4617
37 #define FBIOGET_DISPINFO 0x4618
40 #define FB_TYPE_PACKED_PIXELS 0 /* Packed Pixels */
41 #define FB_TYPE_PLANES 1 /* Non interleaved planes */
42 #define FB_TYPE_INTERLEAVED_PLANES 2 /* Interleaved planes */
43 #define FB_TYPE_TEXT 3 /* Text/attributes */
44 #define FB_TYPE_VGA_PLANES 4 /* EGA/VGA planes */
46 #define FB_AUX_TEXT_MDA 0 /* Monochrome text */
47 #define FB_AUX_TEXT_CGA 1 /* CGA/EGA/VGA Color text */
48 #define FB_AUX_TEXT_S3_MMIO 2 /* S3 MMIO fasttext */
49 #define FB_AUX_TEXT_MGA_STEP16 3 /* MGA Millenium I: text, attr, 14 reserved bytes */
50 #define FB_AUX_TEXT_MGA_STEP8 4 /* other MGAs: text, attr, 6 reserved bytes */
52 #define FB_AUX_VGA_PLANES_VGA4 0 /* 16 color planes (EGA/VGA) */
53 #define FB_AUX_VGA_PLANES_CFB4 1 /* CFB4 in planes (VGA) */
54 #define FB_AUX_VGA_PLANES_CFB8 2 /* CFB8 in planes (VGA) */
56 #define FB_VISUAL_MONO01 0 /* Monochr. 1=Black 0=White */
57 #define FB_VISUAL_MONO10 1 /* Monochr. 1=White 0=Black */
58 #define FB_VISUAL_TRUECOLOR 2 /* True color */
59 #define FB_VISUAL_PSEUDOCOLOR 3 /* Pseudo color (like atari) */
60 #define FB_VISUAL_DIRECTCOLOR 4 /* Direct color */
61 #define FB_VISUAL_STATIC_PSEUDOCOLOR 5 /* Pseudo color readonly */
63 #define FB_ACCEL_NONE 0 /* no hardware accelerator */
64 #define FB_ACCEL_ATARIBLITT 1 /* Atari Blitter */
65 #define FB_ACCEL_AMIGABLITT 2 /* Amiga Blitter */
66 #define FB_ACCEL_S3_TRIO64 3 /* Cybervision64 (S3 Trio64) */
67 #define FB_ACCEL_NCR_77C32BLT 4 /* RetinaZ3 (NCR 77C32BLT) */
68 #define FB_ACCEL_S3_VIRGE 5 /* Cybervision64/3D (S3 ViRGE) */
69 #define FB_ACCEL_ATI_MACH64GX 6 /* ATI Mach 64GX family */
70 #define FB_ACCEL_DEC_TGA 7 /* DEC 21030 TGA */
71 #define FB_ACCEL_ATI_MACH64CT 8 /* ATI Mach 64CT family */
72 #define FB_ACCEL_ATI_MACH64VT 9 /* ATI Mach 64CT family VT class */
73 #define FB_ACCEL_ATI_MACH64GT 10 /* ATI Mach 64CT family GT class */
74 #define FB_ACCEL_SUN_CREATOR 11 /* Sun Creator/Creator3D */
75 #define FB_ACCEL_SUN_CGSIX 12 /* Sun cg6 */
76 #define FB_ACCEL_SUN_LEO 13 /* Sun leo/zx */
77 #define FB_ACCEL_IMS_TWINTURBO 14 /* IMS Twin Turbo */
78 #define FB_ACCEL_3DLABS_PERMEDIA2 15 /* 3Dlabs Permedia 2 */
79 #define FB_ACCEL_MATROX_MGA2064W 16 /* Matrox MGA2064W (Millenium) */
80 #define FB_ACCEL_MATROX_MGA1064SG 17 /* Matrox MGA1064SG (Mystique) */
81 #define FB_ACCEL_MATROX_MGA2164W 18 /* Matrox MGA2164W (Millenium II) */
82 #define FB_ACCEL_MATROX_MGA2164W_AGP 19 /* Matrox MGA2164W (Millenium II) */
83 #define FB_ACCEL_MATROX_MGAG100 20 /* Matrox G100 (Productiva G100) */
84 #define FB_ACCEL_MATROX_MGAG200 21 /* Matrox G200 (Myst, Mill, ...) */
85 #define FB_ACCEL_SUN_CG14 22 /* Sun cgfourteen */
86 #define FB_ACCEL_SUN_BWTWO 23 /* Sun bwtwo */
87 #define FB_ACCEL_SUN_CGTHREE 24 /* Sun cgthree */
88 #define FB_ACCEL_SUN_TCX 25 /* Sun tcx */
89 #define FB_ACCEL_MATROX_MGAG400 26 /* Matrox G400 */
90 #define FB_ACCEL_NV3 27 /* nVidia RIVA 128 */
91 #define FB_ACCEL_NV4 28 /* nVidia RIVA TNT */
92 #define FB_ACCEL_NV5 29 /* nVidia RIVA TNT2 */
93 #define FB_ACCEL_CT_6555x 30 /* C&T 6555x */
94 #define FB_ACCEL_3DFX_BANSHEE 31 /* 3Dfx Banshee */
95 #define FB_ACCEL_ATI_RAGE128 32 /* ATI Rage128 family */
96 #define FB_ACCEL_IGS_CYBER2000 33 /* CyberPro 2000 */
97 #define FB_ACCEL_IGS_CYBER2010 34 /* CyberPro 2010 */
98 #define FB_ACCEL_IGS_CYBER5000 35 /* CyberPro 5000 */
99 #define FB_ACCEL_SIS_GLAMOUR 36 /* SiS 300/630/540 */
100 #define FB_ACCEL_3DLABS_PERMEDIA3 37 /* 3Dlabs Permedia 3 */
101 #define FB_ACCEL_ATI_RADEON 38 /* ATI Radeon family */
102 #define FB_ACCEL_I810 39 /* Intel 810/815 */
103 #define FB_ACCEL_SIS_GLAMOUR_2 40 /* SiS 315, 650, 740 */
104 #define FB_ACCEL_SIS_XABRE 41 /* SiS 330 ("Xabre") */
105 #define FB_ACCEL_I830 42 /* Intel 830M/845G/85x/865G */
106 #define FB_ACCEL_NV_10 43 /* nVidia Arch 10 */
107 #define FB_ACCEL_NV_20 44 /* nVidia Arch 20 */
108 #define FB_ACCEL_NV_30 45 /* nVidia Arch 30 */
109 #define FB_ACCEL_NV_40 46 /* nVidia Arch 40 */
110 #define FB_ACCEL_XGI_VOLARI_V 47 /* XGI Volari V3XT, V5, V8 */
111 #define FB_ACCEL_XGI_VOLARI_Z 48 /* XGI Volari Z7 */
112 #define FB_ACCEL_NEOMAGIC_NM2070 90 /* NeoMagic NM2070 */
113 #define FB_ACCEL_NEOMAGIC_NM2090 91 /* NeoMagic NM2090 */
114 #define FB_ACCEL_NEOMAGIC_NM2093 92 /* NeoMagic NM2093 */
115 #define FB_ACCEL_NEOMAGIC_NM2097 93 /* NeoMagic NM2097 */
116 #define FB_ACCEL_NEOMAGIC_NM2160 94 /* NeoMagic NM2160 */
117 #define FB_ACCEL_NEOMAGIC_NM2200 95 /* NeoMagic NM2200 */
118 #define FB_ACCEL_NEOMAGIC_NM2230 96 /* NeoMagic NM2230 */
119 #define FB_ACCEL_NEOMAGIC_NM2360 97 /* NeoMagic NM2360 */
120 #define FB_ACCEL_NEOMAGIC_NM2380 98 /* NeoMagic NM2380 */
122 #define FB_ACCEL_SAVAGE4 0x80 /* S3 Savage4 */
123 #define FB_ACCEL_SAVAGE3D 0x81 /* S3 Savage3D */
124 #define FB_ACCEL_SAVAGE3D_MV 0x82 /* S3 Savage3D-MV */
125 #define FB_ACCEL_SAVAGE2000 0x83 /* S3 Savage2000 */
126 #define FB_ACCEL_SAVAGE_MX_MV 0x84 /* S3 Savage/MX-MV */
127 #define FB_ACCEL_SAVAGE_MX 0x85 /* S3 Savage/MX */
128 #define FB_ACCEL_SAVAGE_IX_MV 0x86 /* S3 Savage/IX-MV */
129 #define FB_ACCEL_SAVAGE_IX 0x87 /* S3 Savage/IX */
130 #define FB_ACCEL_PROSAVAGE_PM 0x88 /* S3 ProSavage PM133 */
131 #define FB_ACCEL_PROSAVAGE_KM 0x89 /* S3 ProSavage KM133 */
132 #define FB_ACCEL_S3TWISTER_P 0x8a /* S3 Twister */
133 #define FB_ACCEL_S3TWISTER_K 0x8b /* S3 TwisterK */
134 #define FB_ACCEL_SUPERSAVAGE 0x8c /* S3 Supersavage */
135 #define FB_ACCEL_PROSAVAGE_DDR 0x8d /* S3 ProSavage DDR */
136 #define FB_ACCEL_PROSAVAGE_DDRK 0x8e /* S3 ProSavage DDR-K */
138 struct fb_fix_screeninfo {
139 char id[16]; /* identification string eg "TT Builtin" */
140 unsigned long smem_start; /* Start of frame buffer mem */
141 /* (physical address) */
142 __u32 smem_len; /* Length of frame buffer mem */
143 __u32 type; /* see FB_TYPE_* */
144 __u32 type_aux; /* Interleave for interleaved Planes */
145 __u32 visual; /* see FB_VISUAL_* */
146 __u16 xpanstep; /* zero if no hardware panning */
147 __u16 ypanstep; /* zero if no hardware panning */
148 __u16 ywrapstep; /* zero if no hardware ywrap */
149 __u32 line_length; /* length of a line in bytes */
150 unsigned long mmio_start; /* Start of Memory Mapped I/O */
151 /* (physical address) */
152 __u32 mmio_len; /* Length of Memory Mapped I/O */
153 __u32 accel; /* Indicate to driver which */
154 /* specific chip/card we have */
155 __u16 reserved[3]; /* Reserved for future compatibility */
158 /* Interpretation of offset for color fields: All offsets are from the right,
159 * inside a "pixel" value, which is exactly 'bits_per_pixel' wide (means: you
160 * can use the offset as right argument to <<). A pixel afterwards is a bit
161 * stream and is written to video memory as that unmodified. This implies
162 * big-endian byte order if bits_per_pixel is greater than 8.
164 struct fb_bitfield {
165 __u32 offset; /* beginning of bitfield */
166 __u32 length; /* length of bitfield */
167 __u32 msb_right; /* != 0 : Most significant bit is */
168 /* right */
171 #define FB_NONSTD_HAM 1 /* Hold-And-Modify (HAM) */
173 #define FB_ACTIVATE_NOW 0 /* set values immediately (or vbl)*/
174 #define FB_ACTIVATE_NXTOPEN 1 /* activate on next open */
175 #define FB_ACTIVATE_TEST 2 /* don't set, round up impossible */
176 #define FB_ACTIVATE_MASK 15
177 /* values */
178 #define FB_ACTIVATE_VBL 16 /* activate values on next vbl */
179 #define FB_CHANGE_CMAP_VBL 32 /* change colormap on vbl */
180 #define FB_ACTIVATE_ALL 64 /* change all VCs on this fb */
181 #define FB_ACTIVATE_FORCE 128 /* force apply even when no change*/
182 #define FB_ACTIVATE_INV_MODE 256 /* invalidate videomode */
184 #define FB_ACCELF_TEXT 1 /* (OBSOLETE) see fb_info.flags and vc_mode */
186 #define FB_SYNC_HOR_HIGH_ACT 1 /* horizontal sync high active */
187 #define FB_SYNC_VERT_HIGH_ACT 2 /* vertical sync high active */
188 #define FB_SYNC_EXT 4 /* external sync */
189 #define FB_SYNC_COMP_HIGH_ACT 8 /* composite sync high active */
190 #define FB_SYNC_BROADCAST 16 /* broadcast video timings */
191 /* vtotal = 144d/288n/576i => PAL */
192 /* vtotal = 121d/242n/484i => NTSC */
193 #define FB_SYNC_ON_GREEN 32 /* sync on green */
195 #define FB_VMODE_NONINTERLACED 0 /* non interlaced */
196 #define FB_VMODE_INTERLACED 1 /* interlaced */
197 #define FB_VMODE_DOUBLE 2 /* double scan */
198 #define FB_VMODE_MASK 255
200 #define FB_VMODE_YWRAP 256 /* ywrap instead of panning */
201 #define FB_VMODE_SMOOTH_XPAN 512 /* smooth xpan possible (internally used) */
202 #define FB_VMODE_CONUPDATE 512 /* don't update x/yoffset */
204 #define PICOS2KHZ(a) (1000000000UL/(a))
205 #define KHZ2PICOS(a) (1000000000UL/(a))
207 struct fb_var_screeninfo {
208 __u32 xres; /* visible resolution */
209 __u32 yres;
210 __u32 xres_virtual; /* virtual resolution */
211 __u32 yres_virtual;
212 __u32 xoffset; /* offset from virtual to visible */
213 __u32 yoffset; /* resolution */
215 __u32 bits_per_pixel; /* guess what */
216 __u32 grayscale; /* != 0 Graylevels instead of colors */
218 struct fb_bitfield red; /* bitfield in fb mem if true color, */
219 struct fb_bitfield green; /* else only length is significant */
220 struct fb_bitfield blue;
221 struct fb_bitfield transp; /* transparency */
223 __u32 nonstd; /* != 0 Non standard pixel format */
225 __u32 activate; /* see FB_ACTIVATE_* */
227 __u32 height; /* height of picture in mm */
228 __u32 width; /* width of picture in mm */
230 __u32 accel_flags; /* (OBSOLETE) see fb_info.flags */
232 /* Timing: All values in pixclocks, except pixclock (of course) */
233 __u32 pixclock; /* pixel clock in ps (pico seconds) */
234 __u32 left_margin; /* time from sync to picture */
235 __u32 right_margin; /* time from picture to sync */
236 __u32 upper_margin; /* time from sync to picture */
237 __u32 lower_margin;
238 __u32 hsync_len; /* length of horizontal sync */
239 __u32 vsync_len; /* length of vertical sync */
240 __u32 sync; /* see FB_SYNC_* */
241 __u32 vmode; /* see FB_VMODE_* */
242 __u32 rotate; /* angle we rotate counter clockwise */
243 __u32 reserved[5]; /* Reserved for future compatibility */
246 struct fb_cmap {
247 __u32 start; /* First entry */
248 __u32 len; /* Number of entries */
249 __u16 *red; /* Red values */
250 __u16 *green;
251 __u16 *blue;
252 __u16 *transp; /* transparency, can be NULL */
255 struct fb_con2fbmap {
256 __u32 console;
257 __u32 framebuffer;
260 /* VESA Blanking Levels */
261 #define VESA_NO_BLANKING 0
262 #define VESA_VSYNC_SUSPEND 1
263 #define VESA_HSYNC_SUSPEND 2
264 #define VESA_POWERDOWN 3
267 enum {
268 /* screen: unblanked, hsync: on, vsync: on */
269 FB_BLANK_UNBLANK = VESA_NO_BLANKING,
271 /* screen: blanked, hsync: on, vsync: on */
272 FB_BLANK_NORMAL = VESA_NO_BLANKING + 1,
274 /* screen: blanked, hsync: on, vsync: off */
275 FB_BLANK_VSYNC_SUSPEND = VESA_VSYNC_SUSPEND + 1,
277 /* screen: blanked, hsync: off, vsync: on */
278 FB_BLANK_HSYNC_SUSPEND = VESA_HSYNC_SUSPEND + 1,
280 /* screen: blanked, hsync: off, vsync: off */
281 FB_BLANK_POWERDOWN = VESA_POWERDOWN + 1
284 #define FB_VBLANK_VBLANKING 0x001 /* currently in a vertical blank */
285 #define FB_VBLANK_HBLANKING 0x002 /* currently in a horizontal blank */
286 #define FB_VBLANK_HAVE_VBLANK 0x004 /* vertical blanks can be detected */
287 #define FB_VBLANK_HAVE_HBLANK 0x008 /* horizontal blanks can be detected */
288 #define FB_VBLANK_HAVE_COUNT 0x010 /* global retrace counter is available */
289 #define FB_VBLANK_HAVE_VCOUNT 0x020 /* the vcount field is valid */
290 #define FB_VBLANK_HAVE_HCOUNT 0x040 /* the hcount field is valid */
291 #define FB_VBLANK_VSYNCING 0x080 /* currently in a vsync */
292 #define FB_VBLANK_HAVE_VSYNC 0x100 /* verical syncs can be detected */
294 struct fb_vblank {
295 __u32 flags; /* FB_VBLANK flags */
296 __u32 count; /* counter of retraces since boot */
297 __u32 vcount; /* current scanline position */
298 __u32 hcount; /* current scandot position */
299 __u32 reserved[4]; /* reserved for future compatibility */
302 /* Internal HW accel */
303 #define ROP_COPY 0
304 #define ROP_XOR 1
306 struct fb_copyarea {
307 __u32 dx;
308 __u32 dy;
309 __u32 width;
310 __u32 height;
311 __u32 sx;
312 __u32 sy;
315 struct fb_fillrect {
316 __u32 dx; /* screen-relative */
317 __u32 dy;
318 __u32 width;
319 __u32 height;
320 __u32 color;
321 __u32 rop;
324 struct fb_image {
325 __u32 dx; /* Where to place image */
326 __u32 dy;
327 __u32 width; /* Size of image */
328 __u32 height;
329 __u32 fg_color; /* Only used when a mono bitmap */
330 __u32 bg_color;
331 __u8 depth; /* Depth of the image */
332 const char *data; /* Pointer to image data */
333 struct fb_cmap cmap; /* color map info */
337 * hardware cursor control
340 #define FB_CUR_SETIMAGE 0x01
341 #define FB_CUR_SETPOS 0x02
342 #define FB_CUR_SETHOT 0x04
343 #define FB_CUR_SETCMAP 0x08
344 #define FB_CUR_SETSHAPE 0x10
345 #define FB_CUR_SETSIZE 0x20
346 #define FB_CUR_SETALL 0xFF
348 struct fbcurpos {
349 __u16 x, y;
352 struct fb_cursor {
353 __u16 set; /* what to set */
354 __u16 enable; /* cursor on/off */
355 __u16 rop; /* bitop operation */
356 const char *mask; /* cursor mask bits */
357 struct fbcurpos hot; /* cursor hot spot */
358 struct fb_image image; /* Cursor image */
361 #ifdef __KERNEL__
363 #include <linux/fs.h>
364 #include <linux/init.h>
365 #include <linux/tty.h>
366 #include <linux/device.h>
367 #include <linux/workqueue.h>
368 #include <linux/devfs_fs_kernel.h>
369 #include <linux/notifier.h>
370 #include <linux/list.h>
371 #include <asm/io.h>
373 struct vm_area_struct;
374 struct fb_info;
375 struct device;
376 struct file;
378 /* Definitions below are used in the parsed monitor specs */
379 #define FB_DPMS_ACTIVE_OFF 1
380 #define FB_DPMS_SUSPEND 2
381 #define FB_DPMS_STANDBY 4
383 #define FB_DISP_DDI 1
384 #define FB_DISP_ANA_700_300 2
385 #define FB_DISP_ANA_714_286 4
386 #define FB_DISP_ANA_1000_400 8
387 #define FB_DISP_ANA_700_000 16
389 #define FB_DISP_MONO 32
390 #define FB_DISP_RGB 64
391 #define FB_DISP_MULTI 128
392 #define FB_DISP_UNKNOWN 256
394 #define FB_SIGNAL_NONE 0
395 #define FB_SIGNAL_BLANK_BLANK 1
396 #define FB_SIGNAL_SEPARATE 2
397 #define FB_SIGNAL_COMPOSITE 4
398 #define FB_SIGNAL_SYNC_ON_GREEN 8
399 #define FB_SIGNAL_SERRATION_ON 16
401 #define FB_MISC_PRIM_COLOR 1
402 #define FB_MISC_1ST_DETAIL 2 /* First Detailed Timing is preferred */
403 struct fb_chroma {
404 __u32 redx; /* in fraction of 1024 */
405 __u32 greenx;
406 __u32 bluex;
407 __u32 whitex;
408 __u32 redy;
409 __u32 greeny;
410 __u32 bluey;
411 __u32 whitey;
414 struct fb_monspecs {
415 struct fb_chroma chroma;
416 struct fb_videomode *modedb; /* mode database */
417 __u8 manufacturer[4]; /* Manufacturer */
418 __u8 monitor[14]; /* Monitor String */
419 __u8 serial_no[14]; /* Serial Number */
420 __u8 ascii[14]; /* ? */
421 __u32 modedb_len; /* mode database length */
422 __u32 model; /* Monitor Model */
423 __u32 serial; /* Serial Number - Integer */
424 __u32 year; /* Year manufactured */
425 __u32 week; /* Week Manufactured */
426 __u32 hfmin; /* hfreq lower limit (Hz) */
427 __u32 hfmax; /* hfreq upper limit (Hz) */
428 __u32 dclkmin; /* pixelclock lower limit (Hz) */
429 __u32 dclkmax; /* pixelclock upper limit (Hz) */
430 __u16 input; /* display type - see FB_DISP_* */
431 __u16 dpms; /* DPMS support - see FB_DPMS_ */
432 __u16 signal; /* Signal Type - see FB_SIGNAL_* */
433 __u16 vfmin; /* vfreq lower limit (Hz) */
434 __u16 vfmax; /* vfreq upper limit (Hz) */
435 __u16 gamma; /* Gamma - in fractions of 100 */
436 __u16 gtf : 1; /* supports GTF */
437 __u16 misc; /* Misc flags - see FB_MISC_* */
438 __u8 version; /* EDID version... */
439 __u8 revision; /* ...and revision */
440 __u8 max_x; /* Maximum horizontal size (cm) */
441 __u8 max_y; /* Maximum vertical size (cm) */
444 struct fb_cmap_user {
445 __u32 start; /* First entry */
446 __u32 len; /* Number of entries */
447 __u16 __user *red; /* Red values */
448 __u16 __user *green;
449 __u16 __user *blue;
450 __u16 __user *transp; /* transparency, can be NULL */
453 struct fb_image_user {
454 __u32 dx; /* Where to place image */
455 __u32 dy;
456 __u32 width; /* Size of image */
457 __u32 height;
458 __u32 fg_color; /* Only used when a mono bitmap */
459 __u32 bg_color;
460 __u8 depth; /* Depth of the image */
461 const char __user *data; /* Pointer to image data */
462 struct fb_cmap_user cmap; /* color map info */
465 struct fb_cursor_user {
466 __u16 set; /* what to set */
467 __u16 enable; /* cursor on/off */
468 __u16 rop; /* bitop operation */
469 const char __user *mask; /* cursor mask bits */
470 struct fbcurpos hot; /* cursor hot spot */
471 struct fb_image_user image; /* Cursor image */
475 * Register/unregister for framebuffer events
478 /* The resolution of the passed in fb_info about to change */
479 #define FB_EVENT_MODE_CHANGE 0x01
480 /* The display on this fb_info is beeing suspended, no access to the
481 * framebuffer is allowed any more after that call returns
483 #define FB_EVENT_SUSPEND 0x02
484 /* The display on this fb_info was resumed, you can restore the display
485 * if you own it
487 #define FB_EVENT_RESUME 0x03
488 /* An entry from the modelist was removed */
489 #define FB_EVENT_MODE_DELETE 0x04
490 /* A driver registered itself */
491 #define FB_EVENT_FB_REGISTERED 0x05
492 /* get console to framebuffer mapping */
493 #define FB_EVENT_GET_CONSOLE_MAP 0x06
494 /* set console to framebuffer mapping */
495 #define FB_EVENT_SET_CONSOLE_MAP 0x07
496 /* A display blank is requested */
497 #define FB_EVENT_BLANK 0x08
498 /* Private modelist is to be replaced */
499 #define FB_EVENT_NEW_MODELIST 0x09
500 /* The resolution of the passed in fb_info about to change and
501 all vc's should be changed */
502 #define FB_EVENT_MODE_CHANGE_ALL 0x0A
504 struct fb_event {
505 struct fb_info *info;
506 void *data;
510 extern int fb_register_client(struct notifier_block *nb);
511 extern int fb_unregister_client(struct notifier_block *nb);
514 * Pixmap structure definition
516 * The purpose of this structure is to translate data
517 * from the hardware independent format of fbdev to what
518 * format the hardware needs.
521 #define FB_PIXMAP_DEFAULT 1 /* used internally by fbcon */
522 #define FB_PIXMAP_SYSTEM 2 /* memory is in system RAM */
523 #define FB_PIXMAP_IO 4 /* memory is iomapped */
524 #define FB_PIXMAP_SYNC 256 /* set if GPU can DMA */
526 struct fb_pixmap {
527 u8 *addr; /* pointer to memory */
528 u32 size; /* size of buffer in bytes */
529 u32 offset; /* current offset to buffer */
530 u32 buf_align; /* byte alignment of each bitmap */
531 u32 scan_align; /* alignment per scanline */
532 u32 access_align; /* alignment per read/write (bits) */
533 u32 flags; /* see FB_PIXMAP_* */
534 /* access methods */
535 void (*writeio)(struct fb_info *info, void __iomem *dst, void *src, unsigned int size);
536 void (*readio) (struct fb_info *info, void *dst, void __iomem *src, unsigned int size);
541 * Frame buffer operations
543 * LOCKING NOTE: those functions must _ALL_ be called with the console
544 * semaphore held, this is the only suitable locking mecanism we have
545 * in 2.6. Some may be called at interrupt time at this point though.
548 struct fb_ops {
549 /* open/release and usage marking */
550 struct module *owner;
551 int (*fb_open)(struct fb_info *info, int user);
552 int (*fb_release)(struct fb_info *info, int user);
554 /* For framebuffers with strange non linear layouts or that do not
555 * work with normal memory mapped access
557 ssize_t (*fb_read)(struct file *file, char __user *buf, size_t count, loff_t *ppos);
558 ssize_t (*fb_write)(struct file *file, const char __user *buf, size_t count, loff_t *ppos);
560 /* checks var and eventually tweaks it to something supported,
561 * DO NOT MODIFY PAR */
562 int (*fb_check_var)(struct fb_var_screeninfo *var, struct fb_info *info);
564 /* set the video mode according to info->var */
565 int (*fb_set_par)(struct fb_info *info);
567 /* set color register */
568 int (*fb_setcolreg)(unsigned regno, unsigned red, unsigned green,
569 unsigned blue, unsigned transp, struct fb_info *info);
571 /* set color registers in batch */
572 int (*fb_setcmap)(struct fb_cmap *cmap, struct fb_info *info);
574 /* blank display */
575 int (*fb_blank)(int blank, struct fb_info *info);
577 /* pan display */
578 int (*fb_pan_display)(struct fb_var_screeninfo *var, struct fb_info *info);
580 /* Draws a rectangle */
581 void (*fb_fillrect) (struct fb_info *info, const struct fb_fillrect *rect);
582 /* Copy data from area to another */
583 void (*fb_copyarea) (struct fb_info *info, const struct fb_copyarea *region);
584 /* Draws a image to the display */
585 void (*fb_imageblit) (struct fb_info *info, const struct fb_image *image);
587 /* Draws cursor */
588 int (*fb_cursor) (struct fb_info *info, struct fb_cursor *cursor);
590 /* Rotates the display */
591 void (*fb_rotate)(struct fb_info *info, int angle);
593 /* wait for blit idle, optional */
594 int (*fb_sync)(struct fb_info *info);
596 /* perform fb specific ioctl (optional) */
597 int (*fb_ioctl)(struct inode *inode, struct file *file, unsigned int cmd,
598 unsigned long arg, struct fb_info *info);
600 /* Handle 32bit compat ioctl (optional) */
601 long (*fb_compat_ioctl)(struct file *f, unsigned cmd, unsigned long arg,
602 struct fb_info *info);
604 /* perform fb specific mmap */
605 int (*fb_mmap)(struct fb_info *info, struct file *file, struct vm_area_struct *vma);
608 #ifdef CONFIG_FB_TILEBLITTING
610 #define FB_TILE_CURSOR_NONE 0
611 #define FB_TILE_CURSOR_UNDERLINE 1
612 #define FB_TILE_CURSOR_LOWER_THIRD 2
613 #define FB_TILE_CURSOR_LOWER_HALF 3
614 #define FB_TILE_CURSOR_TWO_THIRDS 4
615 #define FB_TILE_CURSOR_BLOCK 5
617 struct fb_tilemap {
618 __u32 width; /* width of each tile in pixels */
619 __u32 height; /* height of each tile in scanlines */
620 __u32 depth; /* color depth of each tile */
621 __u32 length; /* number of tiles in the map */
622 const __u8 *data; /* actual tile map: a bitmap array, packed
623 to the nearest byte */
626 struct fb_tilerect {
627 __u32 sx; /* origin in the x-axis */
628 __u32 sy; /* origin in the y-axis */
629 __u32 width; /* number of tiles in the x-axis */
630 __u32 height; /* number of tiles in the y-axis */
631 __u32 index; /* what tile to use: index to tile map */
632 __u32 fg; /* foreground color */
633 __u32 bg; /* background color */
634 __u32 rop; /* raster operation */
637 struct fb_tilearea {
638 __u32 sx; /* source origin in the x-axis */
639 __u32 sy; /* source origin in the y-axis */
640 __u32 dx; /* destination origin in the x-axis */
641 __u32 dy; /* destination origin in the y-axis */
642 __u32 width; /* number of tiles in the x-axis */
643 __u32 height; /* number of tiles in the y-axis */
646 struct fb_tileblit {
647 __u32 sx; /* origin in the x-axis */
648 __u32 sy; /* origin in the y-axis */
649 __u32 width; /* number of tiles in the x-axis */
650 __u32 height; /* number of tiles in the y-axis */
651 __u32 fg; /* foreground color */
652 __u32 bg; /* background color */
653 __u32 length; /* number of tiles to draw */
654 __u32 *indices; /* array of indices to tile map */
657 struct fb_tilecursor {
658 __u32 sx; /* cursor position in the x-axis */
659 __u32 sy; /* cursor position in the y-axis */
660 __u32 mode; /* 0 = erase, 1 = draw */
661 __u32 shape; /* see FB_TILE_CURSOR_* */
662 __u32 fg; /* foreground color */
663 __u32 bg; /* background color */
666 struct fb_tile_ops {
667 /* set tile characteristics */
668 void (*fb_settile)(struct fb_info *info, struct fb_tilemap *map);
670 /* all dimensions from hereon are in terms of tiles */
672 /* move a rectangular region of tiles from one area to another*/
673 void (*fb_tilecopy)(struct fb_info *info, struct fb_tilearea *area);
674 /* fill a rectangular region with a tile */
675 void (*fb_tilefill)(struct fb_info *info, struct fb_tilerect *rect);
676 /* copy an array of tiles */
677 void (*fb_tileblit)(struct fb_info *info, struct fb_tileblit *blit);
678 /* cursor */
679 void (*fb_tilecursor)(struct fb_info *info,
680 struct fb_tilecursor *cursor);
682 #endif /* CONFIG_FB_TILEBLITTING */
684 /* FBINFO_* = fb_info.flags bit flags */
685 #define FBINFO_MODULE 0x0001 /* Low-level driver is a module */
686 #define FBINFO_HWACCEL_DISABLED 0x0002
687 /* When FBINFO_HWACCEL_DISABLED is set:
688 * Hardware acceleration is turned off. Software implementations
689 * of required functions (copyarea(), fillrect(), and imageblit())
690 * takes over; acceleration engine should be in a quiescent state */
692 /* hints */
693 #define FBINFO_PARTIAL_PAN_OK 0x0040 /* otw use pan only for double-buffering */
694 #define FBINFO_READS_FAST 0x0080 /* soft-copy faster than rendering */
696 /* hardware supported ops */
697 /* semantics: when a bit is set, it indicates that the operation is
698 * accelerated by hardware.
699 * required functions will still work even if the bit is not set.
700 * optional functions may not even exist if the flag bit is not set.
702 #define FBINFO_HWACCEL_NONE 0x0000
703 #define FBINFO_HWACCEL_COPYAREA 0x0100 /* required */
704 #define FBINFO_HWACCEL_FILLRECT 0x0200 /* required */
705 #define FBINFO_HWACCEL_IMAGEBLIT 0x0400 /* required */
706 #define FBINFO_HWACCEL_ROTATE 0x0800 /* optional */
707 #define FBINFO_HWACCEL_XPAN 0x1000 /* optional */
708 #define FBINFO_HWACCEL_YPAN 0x2000 /* optional */
709 #define FBINFO_HWACCEL_YWRAP 0x4000 /* optional */
711 #define FBINFO_MISC_USEREVENT 0x10000 /* event request
712 from userspace */
713 #define FBINFO_MISC_TILEBLITTING 0x20000 /* use tile blitting */
715 struct fb_info {
716 int node;
717 int flags;
718 struct fb_var_screeninfo var; /* Current var */
719 struct fb_fix_screeninfo fix; /* Current fix */
720 struct fb_monspecs monspecs; /* Current Monitor specs */
721 struct work_struct queue; /* Framebuffer event queue */
722 struct fb_pixmap pixmap; /* Image hardware mapper */
723 struct fb_pixmap sprite; /* Cursor hardware mapper */
724 struct fb_cmap cmap; /* Current cmap */
725 struct list_head modelist; /* mode list */
726 struct fb_videomode *mode; /* current mode */
727 struct fb_ops *fbops;
728 struct device *device;
729 struct class_device *class_device; /* sysfs per device attrs */
730 #ifdef CONFIG_FB_TILEBLITTING
731 struct fb_tile_ops *tileops; /* Tile Blitting */
732 #endif
733 char __iomem *screen_base; /* Virtual address */
734 unsigned long screen_size; /* Amount of ioremapped VRAM or 0 */
735 void *pseudo_palette; /* Fake palette of 16 colors */
736 #define FBINFO_STATE_RUNNING 0
737 #define FBINFO_STATE_SUSPENDED 1
738 u32 state; /* Hardware state i.e suspend */
739 void *fbcon_par; /* fbcon use-only private area */
740 /* From here on everything is device dependent */
741 void *par;
744 #ifdef MODULE
745 #define FBINFO_DEFAULT FBINFO_MODULE
746 #else
747 #define FBINFO_DEFAULT 0
748 #endif
750 // This will go away
751 #define FBINFO_FLAG_MODULE FBINFO_MODULE
752 #define FBINFO_FLAG_DEFAULT FBINFO_DEFAULT
754 /* This will go away
755 * fbset currently hacks in FB_ACCELF_TEXT into var.accel_flags
756 * when it wants to turn the acceleration engine on. This is
757 * really a separate operation, and should be modified via sysfs.
758 * But for now, we leave it broken with the following define
760 #define STUPID_ACCELF_TEXT_SHIT
762 // This will go away
763 #if defined(__sparc__)
765 /* We map all of our framebuffers such that big-endian accesses
766 * are what we want, so the following is sufficient.
769 // This will go away
770 #define fb_readb sbus_readb
771 #define fb_readw sbus_readw
772 #define fb_readl sbus_readl
773 #define fb_readq sbus_readq
774 #define fb_writeb sbus_writeb
775 #define fb_writew sbus_writew
776 #define fb_writel sbus_writel
777 #define fb_writeq sbus_writeq
778 #define fb_memset sbus_memset_io
780 #elif defined(__i386__) || defined(__alpha__) || defined(__x86_64__) || defined(__hppa__) || (defined(__sh__) && !defined(__SH5__)) || defined(__powerpc__)
782 #define fb_readb __raw_readb
783 #define fb_readw __raw_readw
784 #define fb_readl __raw_readl
785 #define fb_readq __raw_readq
786 #define fb_writeb __raw_writeb
787 #define fb_writew __raw_writew
788 #define fb_writel __raw_writel
789 #define fb_writeq __raw_writeq
790 #define fb_memset memset_io
792 #else
794 #define fb_readb(addr) (*(volatile u8 *) (addr))
795 #define fb_readw(addr) (*(volatile u16 *) (addr))
796 #define fb_readl(addr) (*(volatile u32 *) (addr))
797 #define fb_readq(addr) (*(volatile u64 *) (addr))
798 #define fb_writeb(b,addr) (*(volatile u8 *) (addr) = (b))
799 #define fb_writew(b,addr) (*(volatile u16 *) (addr) = (b))
800 #define fb_writel(b,addr) (*(volatile u32 *) (addr) = (b))
801 #define fb_writeq(b,addr) (*(volatile u64 *) (addr) = (b))
802 #define fb_memset memset
804 #endif
807 * `Generic' versions of the frame buffer device operations
810 extern int fb_set_var(struct fb_info *info, struct fb_var_screeninfo *var);
811 extern int fb_pan_display(struct fb_info *info, struct fb_var_screeninfo *var);
812 extern int fb_blank(struct fb_info *info, int blank);
813 extern int soft_cursor(struct fb_info *info, struct fb_cursor *cursor);
814 extern void cfb_fillrect(struct fb_info *info, const struct fb_fillrect *rect);
815 extern void cfb_copyarea(struct fb_info *info, const struct fb_copyarea *area);
816 extern void cfb_imageblit(struct fb_info *info, const struct fb_image *image);
818 /* drivers/video/fbmem.c */
819 extern int register_framebuffer(struct fb_info *fb_info);
820 extern int unregister_framebuffer(struct fb_info *fb_info);
821 extern int fb_prepare_logo(struct fb_info *fb_info);
822 extern int fb_show_logo(struct fb_info *fb_info);
823 extern char* fb_get_buffer_offset(struct fb_info *info, struct fb_pixmap *buf, u32 size);
824 extern void fb_pad_unaligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 idx,
825 u32 height, u32 shift_high, u32 shift_low, u32 mod);
826 extern void fb_pad_aligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 s_pitch, u32 height);
827 extern void fb_set_suspend(struct fb_info *info, int state);
828 extern int fb_get_color_depth(struct fb_var_screeninfo *var,
829 struct fb_fix_screeninfo *fix);
830 extern int fb_get_options(char *name, char **option);
831 extern int fb_new_modelist(struct fb_info *info);
833 extern struct fb_info *registered_fb[FB_MAX];
834 extern int num_registered_fb;
836 static inline void __fb_pad_aligned_buffer(u8 *dst, u32 d_pitch,
837 u8 *src, u32 s_pitch, u32 height)
839 int i, j;
841 d_pitch -= s_pitch;
843 for (i = height; i--; ) {
844 /* s_pitch is a few bytes at the most, memcpy is suboptimal */
845 for (j = 0; j < s_pitch; j++)
846 *dst++ = *src++;
847 dst += d_pitch;
851 /* drivers/video/fbsysfs.c */
852 extern struct fb_info *framebuffer_alloc(size_t size, struct device *dev);
853 extern void framebuffer_release(struct fb_info *info);
854 extern int fb_init_class_device(struct fb_info *fb_info);
855 extern void fb_cleanup_class_device(struct fb_info *head);
857 /* drivers/video/fbmon.c */
858 #define FB_MAXTIMINGS 0
859 #define FB_VSYNCTIMINGS 1
860 #define FB_HSYNCTIMINGS 2
861 #define FB_DCLKTIMINGS 3
862 #define FB_IGNOREMON 0x100
864 #define FB_MODE_IS_UNKNOWN 0
865 #define FB_MODE_IS_DETAILED 1
866 #define FB_MODE_IS_STANDARD 2
867 #define FB_MODE_IS_VESA 4
868 #define FB_MODE_IS_CALCULATED 8
869 #define FB_MODE_IS_FIRST 16
870 #define FB_MODE_IS_FROM_VAR 32
872 extern int fbmon_valid_timings(u_int pixclock, u_int htotal, u_int vtotal,
873 const struct fb_info *fb_info);
874 extern int fbmon_dpms(const struct fb_info *fb_info);
875 extern int fb_get_mode(int flags, u32 val, struct fb_var_screeninfo *var,
876 struct fb_info *info);
877 extern int fb_validate_mode(const struct fb_var_screeninfo *var,
878 struct fb_info *info);
879 extern int fb_parse_edid(unsigned char *edid, struct fb_var_screeninfo *var);
880 extern const unsigned char *fb_firmware_edid(struct device *device);
881 extern void fb_edid_to_monspecs(unsigned char *edid,
882 struct fb_monspecs *specs);
883 extern void fb_destroy_modedb(struct fb_videomode *modedb);
884 extern int fb_find_mode_cvt(struct fb_videomode *mode, int margins, int rb);
886 /* drivers/video/modedb.c */
887 #define VESA_MODEDB_SIZE 34
888 extern void fb_var_to_videomode(struct fb_videomode *mode,
889 struct fb_var_screeninfo *var);
890 extern void fb_videomode_to_var(struct fb_var_screeninfo *var,
891 struct fb_videomode *mode);
892 extern int fb_mode_is_equal(struct fb_videomode *mode1,
893 struct fb_videomode *mode2);
894 extern int fb_add_videomode(struct fb_videomode *mode, struct list_head *head);
895 extern void fb_delete_videomode(struct fb_videomode *mode,
896 struct list_head *head);
897 extern struct fb_videomode *fb_match_mode(struct fb_var_screeninfo *var,
898 struct list_head *head);
899 extern struct fb_videomode *fb_find_best_mode(struct fb_var_screeninfo *var,
900 struct list_head *head);
901 extern struct fb_videomode *fb_find_nearest_mode(struct fb_var_screeninfo *var,
902 struct list_head *head);
903 extern void fb_destroy_modelist(struct list_head *head);
904 extern void fb_videomode_to_modelist(struct fb_videomode *modedb, int num,
905 struct list_head *head);
907 /* drivers/video/fbcmap.c */
908 extern int fb_alloc_cmap(struct fb_cmap *cmap, int len, int transp);
909 extern void fb_dealloc_cmap(struct fb_cmap *cmap);
910 extern int fb_copy_cmap(struct fb_cmap *from, struct fb_cmap *to);
911 extern int fb_cmap_to_user(struct fb_cmap *from, struct fb_cmap_user *to);
912 extern int fb_set_cmap(struct fb_cmap *cmap, struct fb_info *fb_info);
913 extern int fb_set_user_cmap(struct fb_cmap_user *cmap, struct fb_info *fb_info);
914 extern struct fb_cmap *fb_default_cmap(int len);
915 extern void fb_invert_cmaps(void);
917 struct fb_videomode {
918 const char *name; /* optional */
919 u32 refresh; /* optional */
920 u32 xres;
921 u32 yres;
922 u32 pixclock;
923 u32 left_margin;
924 u32 right_margin;
925 u32 upper_margin;
926 u32 lower_margin;
927 u32 hsync_len;
928 u32 vsync_len;
929 u32 sync;
930 u32 vmode;
931 u32 flag;
934 extern const struct fb_videomode vesa_modes[];
936 struct fb_modelist {
937 struct list_head list;
938 struct fb_videomode mode;
941 extern int fb_find_mode(struct fb_var_screeninfo *var,
942 struct fb_info *info, const char *mode_option,
943 const struct fb_videomode *db,
944 unsigned int dbsize,
945 const struct fb_videomode *default_mode,
946 unsigned int default_bpp);
948 #endif /* __KERNEL__ */
950 #endif /* _LINUX_FB_H */