xref: /linux-6.15/include/linux/fb.h (revision 776cfebb)
1 #ifndef _LINUX_FB_H
2 #define _LINUX_FB_H
3 
4 #include <asm/types.h>
5 
6 /* Definitions of frame buffers						*/
7 
8 #define FB_MAJOR		29
9 #define FB_MAX			32	/* sufficient for now */
10 
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
38 
39 
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	*/
45 
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 */
51 
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) */
55 
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 */
62 
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_NEOMAGIC_NM2070 90	/* NeoMagic NM2070              */
111 #define FB_ACCEL_NEOMAGIC_NM2090 91	/* NeoMagic NM2090              */
112 #define FB_ACCEL_NEOMAGIC_NM2093 92	/* NeoMagic NM2093              */
113 #define FB_ACCEL_NEOMAGIC_NM2097 93	/* NeoMagic NM2097              */
114 #define FB_ACCEL_NEOMAGIC_NM2160 94	/* NeoMagic NM2160              */
115 #define FB_ACCEL_NEOMAGIC_NM2200 95	/* NeoMagic NM2200              */
116 #define FB_ACCEL_NEOMAGIC_NM2230 96	/* NeoMagic NM2230              */
117 #define FB_ACCEL_NEOMAGIC_NM2360 97	/* NeoMagic NM2360              */
118 #define FB_ACCEL_NEOMAGIC_NM2380 98	/* NeoMagic NM2380              */
119 
120 #define FB_ACCEL_SAVAGE4        0x80	/* S3 Savage4                   */
121 #define FB_ACCEL_SAVAGE3D       0x81	/* S3 Savage3D                  */
122 #define FB_ACCEL_SAVAGE3D_MV    0x82	/* S3 Savage3D-MV               */
123 #define FB_ACCEL_SAVAGE2000     0x83	/* S3 Savage2000                */
124 #define FB_ACCEL_SAVAGE_MX_MV   0x84	/* S3 Savage/MX-MV              */
125 #define FB_ACCEL_SAVAGE_MX      0x85	/* S3 Savage/MX                 */
126 #define FB_ACCEL_SAVAGE_IX_MV   0x86	/* S3 Savage/IX-MV              */
127 #define FB_ACCEL_SAVAGE_IX      0x87	/* S3 Savage/IX                 */
128 #define FB_ACCEL_PROSAVAGE_PM   0x88	/* S3 ProSavage PM133           */
129 #define FB_ACCEL_PROSAVAGE_KM   0x89	/* S3 ProSavage KM133           */
130 #define FB_ACCEL_S3TWISTER_P    0x8a	/* S3 Twister                   */
131 #define FB_ACCEL_S3TWISTER_K    0x8b	/* S3 TwisterK                  */
132 #define FB_ACCEL_SUPERSAVAGE    0x8c    /* S3 Supersavage               */
133 #define FB_ACCEL_PROSAVAGE_DDR  0x8d	/* S3 ProSavage DDR             */
134 #define FB_ACCEL_PROSAVAGE_DDRK 0x8e	/* S3 ProSavage DDR-K           */
135 
136 struct fb_fix_screeninfo {
137 	char id[16];			/* identification string eg "TT Builtin" */
138 	unsigned long smem_start;	/* Start of frame buffer mem */
139 					/* (physical address) */
140 	__u32 smem_len;			/* Length of frame buffer mem */
141 	__u32 type;			/* see FB_TYPE_*		*/
142 	__u32 type_aux;			/* Interleave for interleaved Planes */
143 	__u32 visual;			/* see FB_VISUAL_*		*/
144 	__u16 xpanstep;			/* zero if no hardware panning  */
145 	__u16 ypanstep;			/* zero if no hardware panning  */
146 	__u16 ywrapstep;		/* zero if no hardware ywrap    */
147 	__u32 line_length;		/* length of a line in bytes    */
148 	unsigned long mmio_start;	/* Start of Memory Mapped I/O   */
149 					/* (physical address) */
150 	__u32 mmio_len;			/* Length of Memory Mapped I/O  */
151 	__u32 accel;			/* Indicate to driver which	*/
152 					/*  specific chip/card we have	*/
153 	__u16 reserved[3];		/* Reserved for future compatibility */
154 };
155 
156 /* Interpretation of offset for color fields: All offsets are from the right,
157  * inside a "pixel" value, which is exactly 'bits_per_pixel' wide (means: you
158  * can use the offset as right argument to <<). A pixel afterwards is a bit
159  * stream and is written to video memory as that unmodified. This implies
160  * big-endian byte order if bits_per_pixel is greater than 8.
161  */
162 struct fb_bitfield {
163 	__u32 offset;			/* beginning of bitfield	*/
164 	__u32 length;			/* length of bitfield		*/
165 	__u32 msb_right;		/* != 0 : Most significant bit is */
166 					/* right */
167 };
168 
169 #define FB_NONSTD_HAM		1	/* Hold-And-Modify (HAM)        */
170 
171 #define FB_ACTIVATE_NOW		0	/* set values immediately (or vbl)*/
172 #define FB_ACTIVATE_NXTOPEN	1	/* activate on next open	*/
173 #define FB_ACTIVATE_TEST	2	/* don't set, round up impossible */
174 #define FB_ACTIVATE_MASK       15
175 					/* values			*/
176 #define FB_ACTIVATE_VBL	       16	/* activate values on next vbl  */
177 #define FB_CHANGE_CMAP_VBL     32	/* change colormap on vbl	*/
178 #define FB_ACTIVATE_ALL	       64	/* change all VCs on this fb	*/
179 #define FB_ACTIVATE_FORCE     128	/* force apply even when no change*/
180 #define FB_ACTIVATE_INV_MODE  256       /* invalidate videomode */
181 
182 #define FB_ACCELF_TEXT		1	/* (OBSOLETE) see fb_info.flags and vc_mode */
183 
184 #define FB_SYNC_HOR_HIGH_ACT	1	/* horizontal sync high active	*/
185 #define FB_SYNC_VERT_HIGH_ACT	2	/* vertical sync high active	*/
186 #define FB_SYNC_EXT		4	/* external sync		*/
187 #define FB_SYNC_COMP_HIGH_ACT	8	/* composite sync high active   */
188 #define FB_SYNC_BROADCAST	16	/* broadcast video timings      */
189 					/* vtotal = 144d/288n/576i => PAL  */
190 					/* vtotal = 121d/242n/484i => NTSC */
191 #define FB_SYNC_ON_GREEN	32	/* sync on green */
192 
193 #define FB_VMODE_NONINTERLACED  0	/* non interlaced */
194 #define FB_VMODE_INTERLACED	1	/* interlaced	*/
195 #define FB_VMODE_DOUBLE		2	/* double scan */
196 #define FB_VMODE_MASK		255
197 
198 #define FB_VMODE_YWRAP		256	/* ywrap instead of panning     */
199 #define FB_VMODE_SMOOTH_XPAN	512	/* smooth xpan possible (internally used) */
200 #define FB_VMODE_CONUPDATE	512	/* don't update x/yoffset	*/
201 
202 #define PICOS2KHZ(a) (1000000000UL/(a))
203 #define KHZ2PICOS(a) (1000000000UL/(a))
204 
205 struct fb_var_screeninfo {
206 	__u32 xres;			/* visible resolution		*/
207 	__u32 yres;
208 	__u32 xres_virtual;		/* virtual resolution		*/
209 	__u32 yres_virtual;
210 	__u32 xoffset;			/* offset from virtual to visible */
211 	__u32 yoffset;			/* resolution			*/
212 
213 	__u32 bits_per_pixel;		/* guess what			*/
214 	__u32 grayscale;		/* != 0 Graylevels instead of colors */
215 
216 	struct fb_bitfield red;		/* bitfield in fb mem if true color, */
217 	struct fb_bitfield green;	/* else only length is significant */
218 	struct fb_bitfield blue;
219 	struct fb_bitfield transp;	/* transparency			*/
220 
221 	__u32 nonstd;			/* != 0 Non standard pixel format */
222 
223 	__u32 activate;			/* see FB_ACTIVATE_*		*/
224 
225 	__u32 height;			/* height of picture in mm    */
226 	__u32 width;			/* width of picture in mm     */
227 
228 	__u32 accel_flags;		/* (OBSOLETE) see fb_info.flags */
229 
230 	/* Timing: All values in pixclocks, except pixclock (of course) */
231 	__u32 pixclock;			/* pixel clock in ps (pico seconds) */
232 	__u32 left_margin;		/* time from sync to picture	*/
233 	__u32 right_margin;		/* time from picture to sync	*/
234 	__u32 upper_margin;		/* time from sync to picture	*/
235 	__u32 lower_margin;
236 	__u32 hsync_len;		/* length of horizontal sync	*/
237 	__u32 vsync_len;		/* length of vertical sync	*/
238 	__u32 sync;			/* see FB_SYNC_*		*/
239 	__u32 vmode;			/* see FB_VMODE_*		*/
240 	__u32 rotate;			/* angle we rotate counter clockwise */
241 	__u32 reserved[5];		/* Reserved for future compatibility */
242 };
243 
244 struct fb_cmap {
245 	__u32 start;			/* First entry	*/
246 	__u32 len;			/* Number of entries */
247 	__u16 *red;			/* Red values	*/
248 	__u16 *green;
249 	__u16 *blue;
250 	__u16 *transp;			/* transparency, can be NULL */
251 };
252 
253 struct fb_con2fbmap {
254 	__u32 console;
255 	__u32 framebuffer;
256 };
257 
258 /* VESA Blanking Levels */
259 #define VESA_NO_BLANKING        0
260 #define VESA_VSYNC_SUSPEND      1
261 #define VESA_HSYNC_SUSPEND      2
262 #define VESA_POWERDOWN          3
263 
264 
265 enum {
266 	/* screen: unblanked, hsync: on,  vsync: on */
267 	FB_BLANK_UNBLANK       = VESA_NO_BLANKING,
268 
269 	/* screen: blanked,   hsync: on,  vsync: on */
270 	FB_BLANK_NORMAL        = VESA_NO_BLANKING + 1,
271 
272 	/* screen: blanked,   hsync: on,  vsync: off */
273 	FB_BLANK_VSYNC_SUSPEND = VESA_VSYNC_SUSPEND + 1,
274 
275 	/* screen: blanked,   hsync: off, vsync: on */
276 	FB_BLANK_HSYNC_SUSPEND = VESA_HSYNC_SUSPEND + 1,
277 
278 	/* screen: blanked,   hsync: off, vsync: off */
279 	FB_BLANK_POWERDOWN     = VESA_POWERDOWN + 1
280 };
281 
282 #define FB_VBLANK_VBLANKING	0x001	/* currently in a vertical blank */
283 #define FB_VBLANK_HBLANKING	0x002	/* currently in a horizontal blank */
284 #define FB_VBLANK_HAVE_VBLANK	0x004	/* vertical blanks can be detected */
285 #define FB_VBLANK_HAVE_HBLANK	0x008	/* horizontal blanks can be detected */
286 #define FB_VBLANK_HAVE_COUNT	0x010	/* global retrace counter is available */
287 #define FB_VBLANK_HAVE_VCOUNT	0x020	/* the vcount field is valid */
288 #define FB_VBLANK_HAVE_HCOUNT	0x040	/* the hcount field is valid */
289 #define FB_VBLANK_VSYNCING	0x080	/* currently in a vsync */
290 #define FB_VBLANK_HAVE_VSYNC	0x100	/* verical syncs can be detected */
291 
292 struct fb_vblank {
293 	__u32 flags;			/* FB_VBLANK flags */
294 	__u32 count;			/* counter of retraces since boot */
295 	__u32 vcount;			/* current scanline position */
296 	__u32 hcount;			/* current scandot position */
297 	__u32 reserved[4];		/* reserved for future compatibility */
298 };
299 
300 /* Internal HW accel */
301 #define ROP_COPY 0
302 #define ROP_XOR  1
303 
304 struct fb_copyarea {
305 	__u32 dx;
306 	__u32 dy;
307 	__u32 width;
308 	__u32 height;
309 	__u32 sx;
310 	__u32 sy;
311 };
312 
313 struct fb_fillrect {
314 	__u32 dx;	/* screen-relative */
315 	__u32 dy;
316 	__u32 width;
317 	__u32 height;
318 	__u32 color;
319 	__u32 rop;
320 };
321 
322 struct fb_image {
323 	__u32 dx;		/* Where to place image */
324 	__u32 dy;
325 	__u32 width;		/* Size of image */
326 	__u32 height;
327 	__u32 fg_color;		/* Only used when a mono bitmap */
328 	__u32 bg_color;
329 	__u8  depth;		/* Depth of the image */
330 	const char *data;	/* Pointer to image data */
331 	struct fb_cmap cmap;	/* color map info */
332 };
333 
334 /*
335  * hardware cursor control
336  */
337 
338 #define FB_CUR_SETIMAGE 0x01
339 #define FB_CUR_SETPOS   0x02
340 #define FB_CUR_SETHOT   0x04
341 #define FB_CUR_SETCMAP  0x08
342 #define FB_CUR_SETSHAPE 0x10
343 #define FB_CUR_SETSIZE	0x20
344 #define FB_CUR_SETALL   0xFF
345 
346 struct fbcurpos {
347 	__u16 x, y;
348 };
349 
350 struct fb_cursor {
351 	__u16 set;		/* what to set */
352 	__u16 enable;		/* cursor on/off */
353 	__u16 rop;		/* bitop operation */
354 	const char *mask;	/* cursor mask bits */
355 	struct fbcurpos hot;	/* cursor hot spot */
356 	struct fb_image	image;	/* Cursor image */
357 };
358 
359 #ifdef __KERNEL__
360 
361 #include <linux/fs.h>
362 #include <linux/init.h>
363 #include <linux/tty.h>
364 #include <linux/device.h>
365 #include <linux/workqueue.h>
366 #include <linux/devfs_fs_kernel.h>
367 #include <linux/notifier.h>
368 #include <linux/list.h>
369 #include <asm/io.h>
370 
371 struct vm_area_struct;
372 struct fb_info;
373 struct device;
374 struct file;
375 
376 /* Definitions below are used in the parsed monitor specs */
377 #define FB_DPMS_ACTIVE_OFF	1
378 #define FB_DPMS_SUSPEND		2
379 #define FB_DPMS_STANDBY		4
380 
381 #define FB_DISP_DDI		1
382 #define FB_DISP_ANA_700_300	2
383 #define FB_DISP_ANA_714_286	4
384 #define FB_DISP_ANA_1000_400	8
385 #define FB_DISP_ANA_700_000	16
386 
387 #define FB_DISP_MONO		32
388 #define FB_DISP_RGB		64
389 #define FB_DISP_MULTI		128
390 #define FB_DISP_UNKNOWN		256
391 
392 #define FB_SIGNAL_NONE		0
393 #define FB_SIGNAL_BLANK_BLANK	1
394 #define FB_SIGNAL_SEPARATE	2
395 #define FB_SIGNAL_COMPOSITE	4
396 #define FB_SIGNAL_SYNC_ON_GREEN	8
397 #define FB_SIGNAL_SERRATION_ON	16
398 
399 #define FB_MISC_PRIM_COLOR	1
400 #define FB_MISC_1ST_DETAIL	2	/* First Detailed Timing is preferred */
401 struct fb_chroma {
402 	__u32 redx;	/* in fraction of 1024 */
403 	__u32 greenx;
404 	__u32 bluex;
405 	__u32 whitex;
406 	__u32 redy;
407 	__u32 greeny;
408 	__u32 bluey;
409 	__u32 whitey;
410 };
411 
412 struct fb_monspecs {
413 	struct fb_chroma chroma;
414 	struct fb_videomode *modedb;	/* mode database */
415 	__u8  manufacturer[4];		/* Manufacturer */
416 	__u8  monitor[14];		/* Monitor String */
417 	__u8  serial_no[14];		/* Serial Number */
418 	__u8  ascii[14];		/* ? */
419 	__u32 modedb_len;		/* mode database length */
420 	__u32 model;			/* Monitor Model */
421 	__u32 serial;			/* Serial Number - Integer */
422 	__u32 year;			/* Year manufactured */
423 	__u32 week;			/* Week Manufactured */
424 	__u32 hfmin;			/* hfreq lower limit (Hz) */
425 	__u32 hfmax;			/* hfreq upper limit (Hz) */
426 	__u32 dclkmin;			/* pixelclock lower limit (Hz) */
427 	__u32 dclkmax;			/* pixelclock upper limit (Hz) */
428 	__u16 input;			/* display type - see FB_DISP_* */
429 	__u16 dpms;			/* DPMS support - see FB_DPMS_ */
430 	__u16 signal;			/* Signal Type - see FB_SIGNAL_* */
431 	__u16 vfmin;			/* vfreq lower limit (Hz) */
432 	__u16 vfmax;			/* vfreq upper limit (Hz) */
433 	__u16 gamma;			/* Gamma - in fractions of 100 */
434 	__u16 gtf	: 1;		/* supports GTF */
435 	__u16 misc;			/* Misc flags - see FB_MISC_* */
436 	__u8  version;			/* EDID version... */
437 	__u8  revision;			/* ...and revision */
438 	__u8  max_x;			/* Maximum horizontal size (cm) */
439 	__u8  max_y;			/* Maximum vertical size (cm) */
440 };
441 
442 struct fb_cmap_user {
443 	__u32 start;			/* First entry	*/
444 	__u32 len;			/* Number of entries */
445 	__u16 __user *red;		/* Red values	*/
446 	__u16 __user *green;
447 	__u16 __user *blue;
448 	__u16 __user *transp;		/* transparency, can be NULL */
449 };
450 
451 struct fb_image_user {
452 	__u32 dx;			/* Where to place image */
453 	__u32 dy;
454 	__u32 width;			/* Size of image */
455 	__u32 height;
456 	__u32 fg_color;			/* Only used when a mono bitmap */
457 	__u32 bg_color;
458 	__u8  depth;			/* Depth of the image */
459 	const char __user *data;	/* Pointer to image data */
460 	struct fb_cmap_user cmap;	/* color map info */
461 };
462 
463 struct fb_cursor_user {
464 	__u16 set;			/* what to set */
465 	__u16 enable;			/* cursor on/off */
466 	__u16 rop;			/* bitop operation */
467 	const char __user *mask;	/* cursor mask bits */
468 	struct fbcurpos hot;		/* cursor hot spot */
469 	struct fb_image_user image;	/* Cursor image */
470 };
471 
472 /*
473  * Register/unregister for framebuffer events
474  */
475 
476 /*	The resolution of the passed in fb_info about to change */
477 #define FB_EVENT_MODE_CHANGE		0x01
478 /*	The display on this fb_info is beeing suspended, no access to the
479  *	framebuffer is allowed any more after that call returns
480  */
481 #define FB_EVENT_SUSPEND		0x02
482 /*	The display on this fb_info was resumed, you can restore the display
483  *	if you own it
484  */
485 #define FB_EVENT_RESUME			0x03
486 /*      An entry from the modelist was removed */
487 #define FB_EVENT_MODE_DELETE            0x04
488 /*      A driver registered itself */
489 #define FB_EVENT_FB_REGISTERED          0x05
490 /*      get console to framebuffer mapping */
491 #define FB_EVENT_GET_CONSOLE_MAP        0x06
492 /*      set console to framebuffer mapping */
493 #define FB_EVENT_SET_CONSOLE_MAP        0x07
494 /*      A display blank is requested       */
495 #define FB_EVENT_BLANK                  0x08
496 /*      Private modelist is to be replaced */
497 #define FB_EVENT_NEW_MODELIST           0x09
498 
499 struct fb_event {
500 	struct fb_info *info;
501 	void *data;
502 };
503 
504 
505 extern int fb_register_client(struct notifier_block *nb);
506 extern int fb_unregister_client(struct notifier_block *nb);
507 
508 /*
509  * Pixmap structure definition
510  *
511  * The purpose of this structure is to translate data
512  * from the hardware independent format of fbdev to what
513  * format the hardware needs.
514  */
515 
516 #define FB_PIXMAP_DEFAULT 1     /* used internally by fbcon */
517 #define FB_PIXMAP_SYSTEM  2     /* memory is in system RAM  */
518 #define FB_PIXMAP_IO      4     /* memory is iomapped       */
519 #define FB_PIXMAP_SYNC    256   /* set if GPU can DMA       */
520 
521 struct fb_pixmap {
522 	u8  *addr;		/* pointer to memory			*/
523 	u32 size;		/* size of buffer in bytes		*/
524 	u32 offset;		/* current offset to buffer		*/
525 	u32 buf_align;		/* byte alignment of each bitmap	*/
526 	u32 scan_align;		/* alignment per scanline		*/
527 	u32 access_align;	/* alignment per read/write		*/
528 	u32 flags;		/* see FB_PIXMAP_*			*/
529 	/* access methods */
530 	void (*outbuf)(struct fb_info *info, u8 *addr, u8 *src, unsigned int size);
531 	u8   (*inbuf) (struct fb_info *info, u8 *addr);
532 };
533 
534 
535 /*
536  * Frame buffer operations
537  *
538  * LOCKING NOTE: those functions must _ALL_ be called with the console
539  * semaphore held, this is the only suitable locking mecanism we have
540  * in 2.6. Some may be called at interrupt time at this point though.
541  */
542 
543 struct fb_ops {
544 	/* open/release and usage marking */
545 	struct module *owner;
546 	int (*fb_open)(struct fb_info *info, int user);
547 	int (*fb_release)(struct fb_info *info, int user);
548 
549 	/* For framebuffers with strange non linear layouts or that do not
550 	 * work with normal memory mapped access
551 	 */
552 	ssize_t (*fb_read)(struct file *file, char __user *buf, size_t count, loff_t *ppos);
553 	ssize_t (*fb_write)(struct file *file, const char __user *buf, size_t count, loff_t *ppos);
554 
555 	/* checks var and eventually tweaks it to something supported,
556 	 * DO NOT MODIFY PAR */
557 	int (*fb_check_var)(struct fb_var_screeninfo *var, struct fb_info *info);
558 
559 	/* set the video mode according to info->var */
560 	int (*fb_set_par)(struct fb_info *info);
561 
562 	/* set color register */
563 	int (*fb_setcolreg)(unsigned regno, unsigned red, unsigned green,
564 			    unsigned blue, unsigned transp, struct fb_info *info);
565 
566 	/* set color registers in batch */
567 	int (*fb_setcmap)(struct fb_cmap *cmap, struct fb_info *info);
568 
569 	/* blank display */
570 	int (*fb_blank)(int blank, struct fb_info *info);
571 
572 	/* pan display */
573 	int (*fb_pan_display)(struct fb_var_screeninfo *var, struct fb_info *info);
574 
575 	/* Draws a rectangle */
576 	void (*fb_fillrect) (struct fb_info *info, const struct fb_fillrect *rect);
577 	/* Copy data from area to another */
578 	void (*fb_copyarea) (struct fb_info *info, const struct fb_copyarea *region);
579 	/* Draws a image to the display */
580 	void (*fb_imageblit) (struct fb_info *info, const struct fb_image *image);
581 
582 	/* Draws cursor */
583 	int (*fb_cursor) (struct fb_info *info, struct fb_cursor *cursor);
584 
585 	/* Rotates the display */
586 	void (*fb_rotate)(struct fb_info *info, int angle);
587 
588 	/* wait for blit idle, optional */
589 	int (*fb_sync)(struct fb_info *info);
590 
591 	/* perform fb specific ioctl (optional) */
592 	int (*fb_ioctl)(struct inode *inode, struct file *file, unsigned int cmd,
593 			unsigned long arg, struct fb_info *info);
594 
595 	/* Handle 32bit compat ioctl (optional) */
596 	long (*fb_compat_ioctl)(struct file *f, unsigned cmd, unsigned long arg,
597 			       struct fb_info *info);
598 
599 	/* perform fb specific mmap */
600 	int (*fb_mmap)(struct fb_info *info, struct file *file, struct vm_area_struct *vma);
601 };
602 
603 #ifdef CONFIG_FB_TILEBLITTING
604 
605 #define FB_TILE_CURSOR_NONE        0
606 #define FB_TILE_CURSOR_UNDERLINE   1
607 #define FB_TILE_CURSOR_LOWER_THIRD 2
608 #define FB_TILE_CURSOR_LOWER_HALF  3
609 #define FB_TILE_CURSOR_TWO_THIRDS  4
610 #define FB_TILE_CURSOR_BLOCK       5
611 
612 struct fb_tilemap {
613 	__u32 width;                /* width of each tile in pixels */
614 	__u32 height;               /* height of each tile in scanlines */
615 	__u32 depth;                /* color depth of each tile */
616 	__u32 length;               /* number of tiles in the map */
617 	__u8  *data;                /* actual tile map: a bitmap array, packed
618 				       to the nearest byte */
619 };
620 
621 struct fb_tilerect {
622 	__u32 sx;                   /* origin in the x-axis */
623 	__u32 sy;                   /* origin in the y-axis */
624 	__u32 width;                /* number of tiles in the x-axis */
625 	__u32 height;               /* number of tiles in the y-axis */
626 	__u32 index;                /* what tile to use: index to tile map */
627 	__u32 fg;                   /* foreground color */
628 	__u32 bg;                   /* background color */
629 	__u32 rop;                  /* raster operation */
630 };
631 
632 struct fb_tilearea {
633 	__u32 sx;                   /* source origin in the x-axis */
634 	__u32 sy;                   /* source origin in the y-axis */
635 	__u32 dx;                   /* destination origin in the x-axis */
636 	__u32 dy;                   /* destination origin in the y-axis */
637 	__u32 width;                /* number of tiles in the x-axis */
638 	__u32 height;               /* number of tiles in the y-axis */
639 };
640 
641 struct fb_tileblit {
642 	__u32 sx;                   /* origin in the x-axis */
643 	__u32 sy;                   /* origin in the y-axis */
644 	__u32 width;                /* number of tiles in the x-axis */
645 	__u32 height;               /* number of tiles in the y-axis */
646 	__u32 fg;                   /* foreground color */
647 	__u32 bg;                   /* background color */
648 	__u32 length;               /* number of tiles to draw */
649 	__u32 *indices;             /* array of indices to tile map */
650 };
651 
652 struct fb_tilecursor {
653 	__u32 sx;                   /* cursor position in the x-axis */
654 	__u32 sy;                   /* cursor position in the y-axis */
655 	__u32 mode;                 /* 0 = erase, 1 = draw */
656 	__u32 shape;                /* see FB_TILE_CURSOR_* */
657 	__u32 fg;                   /* foreground color */
658 	__u32 bg;                   /* background color */
659 };
660 
661 struct fb_tile_ops {
662 	/* set tile characteristics */
663 	void (*fb_settile)(struct fb_info *info, struct fb_tilemap *map);
664 
665 	/* all dimensions from hereon are in terms of tiles */
666 
667 	/* move a rectangular region of tiles from one area to another*/
668 	void (*fb_tilecopy)(struct fb_info *info, struct fb_tilearea *area);
669 	/* fill a rectangular region with a tile */
670 	void (*fb_tilefill)(struct fb_info *info, struct fb_tilerect *rect);
671 	/* copy an array of tiles */
672 	void (*fb_tileblit)(struct fb_info *info, struct fb_tileblit *blit);
673 	/* cursor */
674 	void (*fb_tilecursor)(struct fb_info *info,
675 			      struct fb_tilecursor *cursor);
676 };
677 #endif /* CONFIG_FB_TILEBLITTING */
678 
679 /* FBINFO_* = fb_info.flags bit flags */
680 #define FBINFO_MODULE		0x0001	/* Low-level driver is a module */
681 #define FBINFO_HWACCEL_DISABLED	0x0002
682 	/* When FBINFO_HWACCEL_DISABLED is set:
683 	 *  Hardware acceleration is turned off.  Software implementations
684 	 *  of required functions (copyarea(), fillrect(), and imageblit())
685 	 *  takes over; acceleration engine should be in a quiescent state */
686 
687 /* hints */
688 #define FBINFO_PARTIAL_PAN_OK	0x0040 /* otw use pan only for double-buffering */
689 #define FBINFO_READS_FAST	0x0080 /* soft-copy faster than rendering */
690 
691 /* hardware supported ops */
692 /*  semantics: when a bit is set, it indicates that the operation is
693  *   accelerated by hardware.
694  *  required functions will still work even if the bit is not set.
695  *  optional functions may not even exist if the flag bit is not set.
696  */
697 #define FBINFO_HWACCEL_NONE		0x0000
698 #define FBINFO_HWACCEL_COPYAREA		0x0100 /* required */
699 #define FBINFO_HWACCEL_FILLRECT		0x0200 /* required */
700 #define FBINFO_HWACCEL_IMAGEBLIT	0x0400 /* required */
701 #define FBINFO_HWACCEL_ROTATE		0x0800 /* optional */
702 #define FBINFO_HWACCEL_XPAN		0x1000 /* optional */
703 #define FBINFO_HWACCEL_YPAN		0x2000 /* optional */
704 #define FBINFO_HWACCEL_YWRAP		0x4000 /* optional */
705 
706 #define FBINFO_MISC_USEREVENT          0x10000 /* event request
707 						  from userspace */
708 #define FBINFO_MISC_TILEBLITTING       0x20000 /* use tile blitting */
709 
710 struct fb_info {
711 	int node;
712 	int flags;
713 	struct fb_var_screeninfo var;	/* Current var */
714 	struct fb_fix_screeninfo fix;	/* Current fix */
715 	struct fb_monspecs monspecs;	/* Current Monitor specs */
716 	struct work_struct queue;	/* Framebuffer event queue */
717 	struct fb_pixmap pixmap;	/* Image hardware mapper */
718 	struct fb_pixmap sprite;	/* Cursor hardware mapper */
719 	struct fb_cmap cmap;		/* Current cmap */
720 	struct list_head modelist;      /* mode list */
721 	struct fb_videomode *mode;	/* current mode */
722 	struct fb_ops *fbops;
723 	struct device *device;
724 	struct class_device *class_device; /* sysfs per device attrs */
725 #ifdef CONFIG_FB_TILEBLITTING
726 	struct fb_tile_ops *tileops;    /* Tile Blitting */
727 #endif
728 	char __iomem *screen_base;	/* Virtual address */
729 	unsigned long screen_size;	/* Amount of ioremapped VRAM or 0 */
730 	void *pseudo_palette;		/* Fake palette of 16 colors */
731 #define FBINFO_STATE_RUNNING	0
732 #define FBINFO_STATE_SUSPENDED	1
733 	u32 state;			/* Hardware state i.e suspend */
734 	void *fbcon_par;                /* fbcon use-only private area */
735 	/* From here on everything is device dependent */
736 	void *par;
737 };
738 
739 #ifdef MODULE
740 #define FBINFO_DEFAULT	FBINFO_MODULE
741 #else
742 #define FBINFO_DEFAULT	0
743 #endif
744 
745 // This will go away
746 #define FBINFO_FLAG_MODULE	FBINFO_MODULE
747 #define FBINFO_FLAG_DEFAULT	FBINFO_DEFAULT
748 
749 /* This will go away
750  * fbset currently hacks in FB_ACCELF_TEXT into var.accel_flags
751  * when it wants to turn the acceleration engine on.  This is
752  * really a separate operation, and should be modified via sysfs.
753  *  But for now, we leave it broken with the following define
754  */
755 #define STUPID_ACCELF_TEXT_SHIT
756 
757 // This will go away
758 #if defined(__sparc__)
759 
760 /* We map all of our framebuffers such that big-endian accesses
761  * are what we want, so the following is sufficient.
762  */
763 
764 // This will go away
765 #define fb_readb sbus_readb
766 #define fb_readw sbus_readw
767 #define fb_readl sbus_readl
768 #define fb_readq sbus_readq
769 #define fb_writeb sbus_writeb
770 #define fb_writew sbus_writew
771 #define fb_writel sbus_writel
772 #define fb_writeq sbus_writeq
773 #define fb_memset sbus_memset_io
774 
775 #elif defined(__i386__) || defined(__alpha__) || defined(__x86_64__) || defined(__hppa__) || (defined(__sh__) && !defined(__SH5__)) || defined(__powerpc__)
776 
777 #define fb_readb __raw_readb
778 #define fb_readw __raw_readw
779 #define fb_readl __raw_readl
780 #define fb_readq __raw_readq
781 #define fb_writeb __raw_writeb
782 #define fb_writew __raw_writew
783 #define fb_writel __raw_writel
784 #define fb_writeq __raw_writeq
785 #define fb_memset memset_io
786 
787 #else
788 
789 #define fb_readb(addr) (*(volatile u8 *) (addr))
790 #define fb_readw(addr) (*(volatile u16 *) (addr))
791 #define fb_readl(addr) (*(volatile u32 *) (addr))
792 #define fb_readq(addr) (*(volatile u64 *) (addr))
793 #define fb_writeb(b,addr) (*(volatile u8 *) (addr) = (b))
794 #define fb_writew(b,addr) (*(volatile u16 *) (addr) = (b))
795 #define fb_writel(b,addr) (*(volatile u32 *) (addr) = (b))
796 #define fb_writeq(b,addr) (*(volatile u64 *) (addr) = (b))
797 #define fb_memset memset
798 
799 #endif
800 
801     /*
802      *  `Generic' versions of the frame buffer device operations
803      */
804 
805 extern int fb_set_var(struct fb_info *info, struct fb_var_screeninfo *var);
806 extern int fb_pan_display(struct fb_info *info, struct fb_var_screeninfo *var);
807 extern int fb_blank(struct fb_info *info, int blank);
808 extern int soft_cursor(struct fb_info *info, struct fb_cursor *cursor);
809 extern void cfb_fillrect(struct fb_info *info, const struct fb_fillrect *rect);
810 extern void cfb_copyarea(struct fb_info *info, const struct fb_copyarea *area);
811 extern void cfb_imageblit(struct fb_info *info, const struct fb_image *image);
812 
813 /* drivers/video/fbmem.c */
814 extern int register_framebuffer(struct fb_info *fb_info);
815 extern int unregister_framebuffer(struct fb_info *fb_info);
816 extern int fb_prepare_logo(struct fb_info *fb_info);
817 extern int fb_show_logo(struct fb_info *fb_info);
818 extern char* fb_get_buffer_offset(struct fb_info *info, struct fb_pixmap *buf, u32 size);
819 extern void fb_iomove_buf_unaligned(struct fb_info *info, struct fb_pixmap *buf,
820 				u8 *dst, u32 d_pitch, u8 *src, u32 idx,
821 				u32 height, u32 shift_high, u32 shift_low, u32 mod);
822 extern void fb_iomove_buf_aligned(struct fb_info *info, struct fb_pixmap *buf,
823 				u8 *dst, u32 d_pitch, u8 *src, u32 s_pitch,
824 				u32 height);
825 extern void fb_sysmove_buf_unaligned(struct fb_info *info, struct fb_pixmap *buf,
826 				u8 *dst, u32 d_pitch, u8 *src, u32 idx,
827 				u32 height, u32 shift_high, u32 shift_low, u32 mod);
828 extern void fb_sysmove_buf_aligned(struct fb_info *info, struct fb_pixmap *buf,
829 				u8 *dst, u32 d_pitch, u8 *src, u32 s_pitch,
830 				u32 height);
831 extern void fb_set_suspend(struct fb_info *info, int state);
832 extern int fb_get_color_depth(struct fb_var_screeninfo *var);
833 extern int fb_get_options(char *name, char **option);
834 extern int fb_new_modelist(struct fb_info *info);
835 
836 extern struct fb_info *registered_fb[FB_MAX];
837 extern int num_registered_fb;
838 
839 /* drivers/video/fbsysfs.c */
840 extern struct fb_info *framebuffer_alloc(size_t size, struct device *dev);
841 extern void framebuffer_release(struct fb_info *info);
842 extern int fb_init_class_device(struct fb_info *fb_info);
843 extern void fb_cleanup_class_device(struct fb_info *head);
844 
845 /* drivers/video/fbmon.c */
846 #define FB_MAXTIMINGS		0
847 #define FB_VSYNCTIMINGS		1
848 #define FB_HSYNCTIMINGS		2
849 #define FB_DCLKTIMINGS		3
850 #define FB_IGNOREMON		0x100
851 
852 #define FB_MODE_IS_UNKNOWN	0
853 #define FB_MODE_IS_DETAILED	1
854 #define FB_MODE_IS_STANDARD	2
855 #define FB_MODE_IS_VESA		4
856 #define FB_MODE_IS_CALCULATED	8
857 #define FB_MODE_IS_FIRST	16
858 #define FB_MODE_IS_FROM_VAR     32
859 
860 extern int fbmon_valid_timings(u_int pixclock, u_int htotal, u_int vtotal,
861 			       const struct fb_info *fb_info);
862 extern int fbmon_dpms(const struct fb_info *fb_info);
863 extern int fb_get_mode(int flags, u32 val, struct fb_var_screeninfo *var,
864 		       struct fb_info *info);
865 extern int fb_validate_mode(const struct fb_var_screeninfo *var,
866 			    struct fb_info *info);
867 extern int fb_parse_edid(unsigned char *edid, struct fb_var_screeninfo *var);
868 extern void fb_edid_to_monspecs(unsigned char *edid, struct fb_monspecs *specs);
869 extern void fb_destroy_modedb(struct fb_videomode *modedb);
870 
871 /* drivers/video/modedb.c */
872 #define VESA_MODEDB_SIZE 34
873 extern void fb_var_to_videomode(struct fb_videomode *mode,
874 				struct fb_var_screeninfo *var);
875 extern void fb_videomode_to_var(struct fb_var_screeninfo *var,
876 				struct fb_videomode *mode);
877 extern int fb_mode_is_equal(struct fb_videomode *mode1,
878 			    struct fb_videomode *mode2);
879 extern int fb_add_videomode(struct fb_videomode *mode, struct list_head *head);
880 extern void fb_delete_videomode(struct fb_videomode *mode,
881 				struct list_head *head);
882 extern struct fb_videomode *fb_match_mode(struct fb_var_screeninfo *var,
883 					  struct list_head *head);
884 extern struct fb_videomode *fb_find_best_mode(struct fb_var_screeninfo *var,
885 					      struct list_head *head);
886 extern struct fb_videomode *fb_find_nearest_mode(struct fb_var_screeninfo *var,
887 						 struct list_head *head);
888 extern void fb_destroy_modelist(struct list_head *head);
889 extern void fb_videomode_to_modelist(struct fb_videomode *modedb, int num,
890 				     struct list_head *head);
891 
892 /* drivers/video/fbcmap.c */
893 extern int fb_alloc_cmap(struct fb_cmap *cmap, int len, int transp);
894 extern void fb_dealloc_cmap(struct fb_cmap *cmap);
895 extern int fb_copy_cmap(struct fb_cmap *from, struct fb_cmap *to);
896 extern int fb_cmap_to_user(struct fb_cmap *from, struct fb_cmap_user *to);
897 extern int fb_set_cmap(struct fb_cmap *cmap, struct fb_info *fb_info);
898 extern int fb_set_user_cmap(struct fb_cmap_user *cmap, struct fb_info *fb_info);
899 extern struct fb_cmap *fb_default_cmap(int len);
900 extern void fb_invert_cmaps(void);
901 
902 struct fb_videomode {
903 	const char *name;	/* optional */
904 	u32 refresh;		/* optional */
905 	u32 xres;
906 	u32 yres;
907 	u32 pixclock;
908 	u32 left_margin;
909 	u32 right_margin;
910 	u32 upper_margin;
911 	u32 lower_margin;
912 	u32 hsync_len;
913 	u32 vsync_len;
914 	u32 sync;
915 	u32 vmode;
916 	u32 flag;
917 };
918 
919 extern const struct fb_videomode vesa_modes[];
920 
921 struct fb_modelist {
922 	struct list_head list;
923 	struct fb_videomode mode;
924 };
925 
926 extern int fb_find_mode(struct fb_var_screeninfo *var,
927 			struct fb_info *info, const char *mode_option,
928 			const struct fb_videomode *db,
929 			unsigned int dbsize,
930 			const struct fb_videomode *default_mode,
931 			unsigned int default_bpp);
932 
933 #endif /* __KERNEL__ */
934 
935 #endif /* _LINUX_FB_H */
936