]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | #ifndef _LINUX_FB_H |
3 | #define _LINUX_FB_H | |
4 | ||
d219adc1 | 5 | #include <linux/kgdb.h> |
607ca46e | 6 | #include <uapi/linux/fb.h> |
1da177e4 | 7 | |
1da177e4 | 8 | #define FBIO_CURSOR _IOWR('F', 0x08, struct fb_cursor_user) |
1da177e4 LT |
9 | |
10 | #include <linux/fs.h> | |
11 | #include <linux/init.h> | |
1da177e4 | 12 | #include <linux/workqueue.h> |
1da177e4 LT |
13 | #include <linux/notifier.h> |
14 | #include <linux/list.h> | |
2b257425 | 15 | #include <linux/backlight.h> |
1471ca9a | 16 | #include <linux/slab.h> |
1da177e4 LT |
17 | #include <asm/io.h> |
18 | ||
19 | struct vm_area_struct; | |
20 | struct fb_info; | |
21 | struct device; | |
22 | struct file; | |
2db54c72 | 23 | struct videomode; |
79089044 | 24 | struct device_node; |
1da177e4 LT |
25 | |
26 | /* Definitions below are used in the parsed monitor specs */ | |
27 | #define FB_DPMS_ACTIVE_OFF 1 | |
28 | #define FB_DPMS_SUSPEND 2 | |
29 | #define FB_DPMS_STANDBY 4 | |
30 | ||
31 | #define FB_DISP_DDI 1 | |
32 | #define FB_DISP_ANA_700_300 2 | |
33 | #define FB_DISP_ANA_714_286 4 | |
34 | #define FB_DISP_ANA_1000_400 8 | |
35 | #define FB_DISP_ANA_700_000 16 | |
36 | ||
37 | #define FB_DISP_MONO 32 | |
38 | #define FB_DISP_RGB 64 | |
39 | #define FB_DISP_MULTI 128 | |
40 | #define FB_DISP_UNKNOWN 256 | |
41 | ||
42 | #define FB_SIGNAL_NONE 0 | |
43 | #define FB_SIGNAL_BLANK_BLANK 1 | |
44 | #define FB_SIGNAL_SEPARATE 2 | |
45 | #define FB_SIGNAL_COMPOSITE 4 | |
46 | #define FB_SIGNAL_SYNC_ON_GREEN 8 | |
47 | #define FB_SIGNAL_SERRATION_ON 16 | |
48 | ||
49 | #define FB_MISC_PRIM_COLOR 1 | |
50 | #define FB_MISC_1ST_DETAIL 2 /* First Detailed Timing is preferred */ | |
e6853aaf | 51 | #define FB_MISC_HDMI 4 |
1da177e4 LT |
52 | struct fb_chroma { |
53 | __u32 redx; /* in fraction of 1024 */ | |
54 | __u32 greenx; | |
55 | __u32 bluex; | |
56 | __u32 whitex; | |
57 | __u32 redy; | |
58 | __u32 greeny; | |
59 | __u32 bluey; | |
60 | __u32 whitey; | |
61 | }; | |
62 | ||
63 | struct fb_monspecs { | |
64 | struct fb_chroma chroma; | |
65 | struct fb_videomode *modedb; /* mode database */ | |
66 | __u8 manufacturer[4]; /* Manufacturer */ | |
67 | __u8 monitor[14]; /* Monitor String */ | |
68 | __u8 serial_no[14]; /* Serial Number */ | |
69 | __u8 ascii[14]; /* ? */ | |
70 | __u32 modedb_len; /* mode database length */ | |
71 | __u32 model; /* Monitor Model */ | |
72 | __u32 serial; /* Serial Number - Integer */ | |
73 | __u32 year; /* Year manufactured */ | |
74 | __u32 week; /* Week Manufactured */ | |
75 | __u32 hfmin; /* hfreq lower limit (Hz) */ | |
76 | __u32 hfmax; /* hfreq upper limit (Hz) */ | |
77 | __u32 dclkmin; /* pixelclock lower limit (Hz) */ | |
78 | __u32 dclkmax; /* pixelclock upper limit (Hz) */ | |
79 | __u16 input; /* display type - see FB_DISP_* */ | |
80 | __u16 dpms; /* DPMS support - see FB_DPMS_ */ | |
81 | __u16 signal; /* Signal Type - see FB_SIGNAL_* */ | |
82 | __u16 vfmin; /* vfreq lower limit (Hz) */ | |
83 | __u16 vfmax; /* vfreq upper limit (Hz) */ | |
84 | __u16 gamma; /* Gamma - in fractions of 100 */ | |
85 | __u16 gtf : 1; /* supports GTF */ | |
86 | __u16 misc; /* Misc flags - see FB_MISC_* */ | |
87 | __u8 version; /* EDID version... */ | |
88 | __u8 revision; /* ...and revision */ | |
89 | __u8 max_x; /* Maximum horizontal size (cm) */ | |
90 | __u8 max_y; /* Maximum vertical size (cm) */ | |
91 | }; | |
92 | ||
93 | struct fb_cmap_user { | |
94 | __u32 start; /* First entry */ | |
95 | __u32 len; /* Number of entries */ | |
96 | __u16 __user *red; /* Red values */ | |
97 | __u16 __user *green; | |
98 | __u16 __user *blue; | |
99 | __u16 __user *transp; /* transparency, can be NULL */ | |
100 | }; | |
101 | ||
102 | struct fb_image_user { | |
103 | __u32 dx; /* Where to place image */ | |
104 | __u32 dy; | |
105 | __u32 width; /* Size of image */ | |
106 | __u32 height; | |
107 | __u32 fg_color; /* Only used when a mono bitmap */ | |
108 | __u32 bg_color; | |
109 | __u8 depth; /* Depth of the image */ | |
110 | const char __user *data; /* Pointer to image data */ | |
111 | struct fb_cmap_user cmap; /* color map info */ | |
112 | }; | |
113 | ||
114 | struct fb_cursor_user { | |
115 | __u16 set; /* what to set */ | |
116 | __u16 enable; /* cursor on/off */ | |
117 | __u16 rop; /* bitop operation */ | |
118 | const char __user *mask; /* cursor mask bits */ | |
119 | struct fbcurpos hot; /* cursor hot spot */ | |
120 | struct fb_image_user image; /* Cursor image */ | |
121 | }; | |
122 | ||
123 | /* | |
124 | * Register/unregister for framebuffer events | |
125 | */ | |
126 | ||
127 | /* The resolution of the passed in fb_info about to change */ | |
128 | #define FB_EVENT_MODE_CHANGE 0x01 | |
3d910ef7 | 129 | /* The display on this fb_info is being suspended, no access to the |
1da177e4 LT |
130 | * framebuffer is allowed any more after that call returns |
131 | */ | |
132 | #define FB_EVENT_SUSPEND 0x02 | |
133 | /* The display on this fb_info was resumed, you can restore the display | |
134 | * if you own it | |
135 | */ | |
136 | #define FB_EVENT_RESUME 0x03 | |
137 | /* An entry from the modelist was removed */ | |
138 | #define FB_EVENT_MODE_DELETE 0x04 | |
139 | /* A driver registered itself */ | |
140 | #define FB_EVENT_FB_REGISTERED 0x05 | |
e614b18d AD |
141 | /* A driver unregistered itself */ |
142 | #define FB_EVENT_FB_UNREGISTERED 0x06 | |
e4fc2761 | 143 | /* CONSOLE-SPECIFIC: get console to framebuffer mapping */ |
e614b18d | 144 | #define FB_EVENT_GET_CONSOLE_MAP 0x07 |
e4fc2761 | 145 | /* CONSOLE-SPECIFIC: set console to framebuffer mapping */ |
e614b18d | 146 | #define FB_EVENT_SET_CONSOLE_MAP 0x08 |
25985edc | 147 | /* A hardware display blank change occurred */ |
e614b18d | 148 | #define FB_EVENT_BLANK 0x09 |
1da177e4 | 149 | /* Private modelist is to be replaced */ |
e614b18d | 150 | #define FB_EVENT_NEW_MODELIST 0x0A |
7726e9e1 AD |
151 | /* The resolution of the passed in fb_info about to change and |
152 | all vc's should be changed */ | |
e614b18d | 153 | #define FB_EVENT_MODE_CHANGE_ALL 0x0B |
25985edc | 154 | /* A software display blank change occurred */ |
994efacd | 155 | #define FB_EVENT_CONBLANK 0x0C |
38a3dc51 AD |
156 | /* Get drawing requirements */ |
157 | #define FB_EVENT_GET_REQ 0x0D | |
cfafca80 JB |
158 | /* Unbind from the console if possible */ |
159 | #define FB_EVENT_FB_UNBIND 0x0E | |
f15a66e6 | 160 | /* CONSOLE-SPECIFIC: remap all consoles to new fb - for vga_switcheroo */ |
6a9ee8af | 161 | #define FB_EVENT_REMAP_ALL_CONSOLE 0x0F |
3d910ef7 | 162 | /* A hardware display blank early change occurred */ |
bf05929f | 163 | #define FB_EARLY_EVENT_BLANK 0x10 |
3d910ef7 | 164 | /* A hardware display blank revert early change occurred */ |
bf05929f | 165 | #define FB_R_EARLY_EVENT_BLANK 0x11 |
1da177e4 LT |
166 | |
167 | struct fb_event { | |
168 | struct fb_info *info; | |
169 | void *data; | |
170 | }; | |
171 | ||
38a3dc51 AD |
172 | struct fb_blit_caps { |
173 | u32 x; | |
174 | u32 y; | |
175 | u32 len; | |
176 | u32 flags; | |
177 | }; | |
1da177e4 | 178 | |
5ec96538 | 179 | #ifdef CONFIG_FB_NOTIFY |
1da177e4 LT |
180 | extern int fb_register_client(struct notifier_block *nb); |
181 | extern int fb_unregister_client(struct notifier_block *nb); | |
256154fb | 182 | extern int fb_notifier_call_chain(unsigned long val, void *v); |
5ec96538 EG |
183 | #else |
184 | static inline int fb_register_client(struct notifier_block *nb) | |
185 | { | |
186 | return 0; | |
187 | }; | |
188 | ||
189 | static inline int fb_unregister_client(struct notifier_block *nb) | |
190 | { | |
191 | return 0; | |
192 | }; | |
193 | ||
194 | static inline int fb_notifier_call_chain(unsigned long val, void *v) | |
195 | { | |
196 | return 0; | |
197 | }; | |
198 | #endif | |
199 | ||
1da177e4 LT |
200 | /* |
201 | * Pixmap structure definition | |
202 | * | |
203 | * The purpose of this structure is to translate data | |
204 | * from the hardware independent format of fbdev to what | |
205 | * format the hardware needs. | |
206 | */ | |
207 | ||
208 | #define FB_PIXMAP_DEFAULT 1 /* used internally by fbcon */ | |
209 | #define FB_PIXMAP_SYSTEM 2 /* memory is in system RAM */ | |
210 | #define FB_PIXMAP_IO 4 /* memory is iomapped */ | |
211 | #define FB_PIXMAP_SYNC 256 /* set if GPU can DMA */ | |
212 | ||
213 | struct fb_pixmap { | |
214 | u8 *addr; /* pointer to memory */ | |
215 | u32 size; /* size of buffer in bytes */ | |
216 | u32 offset; /* current offset to buffer */ | |
217 | u32 buf_align; /* byte alignment of each bitmap */ | |
218 | u32 scan_align; /* alignment per scanline */ | |
f5a9951c | 219 | u32 access_align; /* alignment per read/write (bits) */ |
1da177e4 | 220 | u32 flags; /* see FB_PIXMAP_* */ |
bf26ad72 AD |
221 | u32 blit_x; /* supported bit block dimensions (1-32)*/ |
222 | u32 blit_y; /* Format: blit_x = 1 << (width - 1) */ | |
223 | /* blit_y = 1 << (height - 1) */ | |
224 | /* if 0, will be set to 0xffffffff (all)*/ | |
1da177e4 | 225 | /* access methods */ |
f5a9951c JS |
226 | void (*writeio)(struct fb_info *info, void __iomem *dst, void *src, unsigned int size); |
227 | void (*readio) (struct fb_info *info, void *dst, void __iomem *src, unsigned int size); | |
1da177e4 LT |
228 | }; |
229 | ||
60b59bea JK |
230 | #ifdef CONFIG_FB_DEFERRED_IO |
231 | struct fb_deferred_io { | |
232 | /* delay between mkwrite and deferred handler */ | |
233 | unsigned long delay; | |
234 | struct mutex lock; /* mutex that protects the page list */ | |
235 | struct list_head pagelist; /* list of touched pages */ | |
236 | /* callback */ | |
1f45f9db | 237 | void (*first_io)(struct fb_info *info); |
60b59bea JK |
238 | void (*deferred_io)(struct fb_info *info, struct list_head *pagelist); |
239 | }; | |
240 | #endif | |
1da177e4 LT |
241 | |
242 | /* | |
243 | * Frame buffer operations | |
244 | * | |
245 | * LOCKING NOTE: those functions must _ALL_ be called with the console | |
b3c2ffd5 | 246 | * semaphore held, this is the only suitable locking mechanism we have |
1da177e4 | 247 | * in 2.6. Some may be called at interrupt time at this point though. |
d219adc1 JB |
248 | * |
249 | * The exception to this is the debug related hooks. Putting the fb | |
250 | * into a debug state (e.g. flipping to the kernel console) and restoring | |
251 | * it must be done in a lock-free manner, so low level drivers should | |
252 | * keep track of the initial console (if applicable) and may need to | |
253 | * perform direct, unlocked hardware writes in these hooks. | |
1da177e4 LT |
254 | */ |
255 | ||
256 | struct fb_ops { | |
257 | /* open/release and usage marking */ | |
258 | struct module *owner; | |
259 | int (*fb_open)(struct fb_info *info, int user); | |
260 | int (*fb_release)(struct fb_info *info, int user); | |
261 | ||
262 | /* For framebuffers with strange non linear layouts or that do not | |
263 | * work with normal memory mapped access | |
264 | */ | |
3f9b0880 AD |
265 | ssize_t (*fb_read)(struct fb_info *info, char __user *buf, |
266 | size_t count, loff_t *ppos); | |
267 | ssize_t (*fb_write)(struct fb_info *info, const char __user *buf, | |
268 | size_t count, loff_t *ppos); | |
1da177e4 LT |
269 | |
270 | /* checks var and eventually tweaks it to something supported, | |
271 | * DO NOT MODIFY PAR */ | |
272 | int (*fb_check_var)(struct fb_var_screeninfo *var, struct fb_info *info); | |
273 | ||
274 | /* set the video mode according to info->var */ | |
275 | int (*fb_set_par)(struct fb_info *info); | |
276 | ||
277 | /* set color register */ | |
278 | int (*fb_setcolreg)(unsigned regno, unsigned red, unsigned green, | |
279 | unsigned blue, unsigned transp, struct fb_info *info); | |
280 | ||
71494376 BH |
281 | /* set color registers in batch */ |
282 | int (*fb_setcmap)(struct fb_cmap *cmap, struct fb_info *info); | |
283 | ||
1da177e4 LT |
284 | /* blank display */ |
285 | int (*fb_blank)(int blank, struct fb_info *info); | |
286 | ||
287 | /* pan display */ | |
288 | int (*fb_pan_display)(struct fb_var_screeninfo *var, struct fb_info *info); | |
289 | ||
290 | /* Draws a rectangle */ | |
291 | void (*fb_fillrect) (struct fb_info *info, const struct fb_fillrect *rect); | |
292 | /* Copy data from area to another */ | |
293 | void (*fb_copyarea) (struct fb_info *info, const struct fb_copyarea *region); | |
294 | /* Draws a image to the display */ | |
295 | void (*fb_imageblit) (struct fb_info *info, const struct fb_image *image); | |
296 | ||
297 | /* Draws cursor */ | |
298 | int (*fb_cursor) (struct fb_info *info, struct fb_cursor *cursor); | |
299 | ||
1da177e4 LT |
300 | /* wait for blit idle, optional */ |
301 | int (*fb_sync)(struct fb_info *info); | |
302 | ||
303 | /* perform fb specific ioctl (optional) */ | |
67a6680d CH |
304 | int (*fb_ioctl)(struct fb_info *info, unsigned int cmd, |
305 | unsigned long arg); | |
1da177e4 LT |
306 | |
307 | /* Handle 32bit compat ioctl (optional) */ | |
67a6680d CH |
308 | int (*fb_compat_ioctl)(struct fb_info *info, unsigned cmd, |
309 | unsigned long arg); | |
1da177e4 LT |
310 | |
311 | /* perform fb specific mmap */ | |
216d526c | 312 | int (*fb_mmap)(struct fb_info *info, struct vm_area_struct *vma); |
47434847 | 313 | |
38a3dc51 AD |
314 | /* get capability given var */ |
315 | void (*fb_get_caps)(struct fb_info *info, struct fb_blit_caps *caps, | |
316 | struct fb_var_screeninfo *var); | |
4410f391 DA |
317 | |
318 | /* teardown any resources to do with this framebuffer */ | |
319 | void (*fb_destroy)(struct fb_info *info); | |
d219adc1 JB |
320 | |
321 | /* called at KDB enter and leave time to prepare the console */ | |
322 | int (*fb_debug_enter)(struct fb_info *info); | |
323 | int (*fb_debug_leave)(struct fb_info *info); | |
1da177e4 LT |
324 | }; |
325 | ||
326 | #ifdef CONFIG_FB_TILEBLITTING | |
1da177e4 LT |
327 | #define FB_TILE_CURSOR_NONE 0 |
328 | #define FB_TILE_CURSOR_UNDERLINE 1 | |
329 | #define FB_TILE_CURSOR_LOWER_THIRD 2 | |
330 | #define FB_TILE_CURSOR_LOWER_HALF 3 | |
331 | #define FB_TILE_CURSOR_TWO_THIRDS 4 | |
332 | #define FB_TILE_CURSOR_BLOCK 5 | |
333 | ||
334 | struct fb_tilemap { | |
335 | __u32 width; /* width of each tile in pixels */ | |
336 | __u32 height; /* height of each tile in scanlines */ | |
337 | __u32 depth; /* color depth of each tile */ | |
338 | __u32 length; /* number of tiles in the map */ | |
2f4516db | 339 | const __u8 *data; /* actual tile map: a bitmap array, packed |
1da177e4 LT |
340 | to the nearest byte */ |
341 | }; | |
342 | ||
343 | struct fb_tilerect { | |
344 | __u32 sx; /* origin in the x-axis */ | |
345 | __u32 sy; /* origin in the y-axis */ | |
346 | __u32 width; /* number of tiles in the x-axis */ | |
347 | __u32 height; /* number of tiles in the y-axis */ | |
348 | __u32 index; /* what tile to use: index to tile map */ | |
349 | __u32 fg; /* foreground color */ | |
350 | __u32 bg; /* background color */ | |
351 | __u32 rop; /* raster operation */ | |
352 | }; | |
353 | ||
354 | struct fb_tilearea { | |
355 | __u32 sx; /* source origin in the x-axis */ | |
356 | __u32 sy; /* source origin in the y-axis */ | |
357 | __u32 dx; /* destination origin in the x-axis */ | |
358 | __u32 dy; /* destination origin in the y-axis */ | |
359 | __u32 width; /* number of tiles in the x-axis */ | |
360 | __u32 height; /* number of tiles in the y-axis */ | |
361 | }; | |
362 | ||
363 | struct fb_tileblit { | |
364 | __u32 sx; /* origin in the x-axis */ | |
365 | __u32 sy; /* origin in the y-axis */ | |
366 | __u32 width; /* number of tiles in the x-axis */ | |
367 | __u32 height; /* number of tiles in the y-axis */ | |
368 | __u32 fg; /* foreground color */ | |
369 | __u32 bg; /* background color */ | |
370 | __u32 length; /* number of tiles to draw */ | |
371 | __u32 *indices; /* array of indices to tile map */ | |
372 | }; | |
373 | ||
374 | struct fb_tilecursor { | |
375 | __u32 sx; /* cursor position in the x-axis */ | |
376 | __u32 sy; /* cursor position in the y-axis */ | |
377 | __u32 mode; /* 0 = erase, 1 = draw */ | |
378 | __u32 shape; /* see FB_TILE_CURSOR_* */ | |
379 | __u32 fg; /* foreground color */ | |
380 | __u32 bg; /* background color */ | |
381 | }; | |
382 | ||
383 | struct fb_tile_ops { | |
384 | /* set tile characteristics */ | |
385 | void (*fb_settile)(struct fb_info *info, struct fb_tilemap *map); | |
386 | ||
387 | /* all dimensions from hereon are in terms of tiles */ | |
388 | ||
389 | /* move a rectangular region of tiles from one area to another*/ | |
390 | void (*fb_tilecopy)(struct fb_info *info, struct fb_tilearea *area); | |
391 | /* fill a rectangular region with a tile */ | |
392 | void (*fb_tilefill)(struct fb_info *info, struct fb_tilerect *rect); | |
393 | /* copy an array of tiles */ | |
394 | void (*fb_tileblit)(struct fb_info *info, struct fb_tileblit *blit); | |
395 | /* cursor */ | |
396 | void (*fb_tilecursor)(struct fb_info *info, | |
397 | struct fb_tilecursor *cursor); | |
11f11d52 AD |
398 | /* get maximum length of the tile map */ |
399 | int (*fb_get_tilemax)(struct fb_info *info); | |
1da177e4 LT |
400 | }; |
401 | #endif /* CONFIG_FB_TILEBLITTING */ | |
402 | ||
403 | /* FBINFO_* = fb_info.flags bit flags */ | |
376b3ff5 | 404 | #define FBINFO_DEFAULT 0 |
1da177e4 LT |
405 | #define FBINFO_HWACCEL_DISABLED 0x0002 |
406 | /* When FBINFO_HWACCEL_DISABLED is set: | |
407 | * Hardware acceleration is turned off. Software implementations | |
408 | * of required functions (copyarea(), fillrect(), and imageblit()) | |
409 | * takes over; acceleration engine should be in a quiescent state */ | |
410 | ||
411 | /* hints */ | |
7164bb43 | 412 | #define FBINFO_VIRTFB 0x0004 /* FB is System RAM, not device. */ |
1da177e4 LT |
413 | #define FBINFO_PARTIAL_PAN_OK 0x0040 /* otw use pan only for double-buffering */ |
414 | #define FBINFO_READS_FAST 0x0080 /* soft-copy faster than rendering */ | |
415 | ||
416 | /* hardware supported ops */ | |
417 | /* semantics: when a bit is set, it indicates that the operation is | |
418 | * accelerated by hardware. | |
419 | * required functions will still work even if the bit is not set. | |
420 | * optional functions may not even exist if the flag bit is not set. | |
421 | */ | |
422 | #define FBINFO_HWACCEL_NONE 0x0000 | |
423 | #define FBINFO_HWACCEL_COPYAREA 0x0100 /* required */ | |
424 | #define FBINFO_HWACCEL_FILLRECT 0x0200 /* required */ | |
425 | #define FBINFO_HWACCEL_IMAGEBLIT 0x0400 /* required */ | |
426 | #define FBINFO_HWACCEL_ROTATE 0x0800 /* optional */ | |
427 | #define FBINFO_HWACCEL_XPAN 0x1000 /* optional */ | |
428 | #define FBINFO_HWACCEL_YPAN 0x2000 /* optional */ | |
429 | #define FBINFO_HWACCEL_YWRAP 0x4000 /* optional */ | |
430 | ||
431 | #define FBINFO_MISC_USEREVENT 0x10000 /* event request | |
432 | from userspace */ | |
433 | #define FBINFO_MISC_TILEBLITTING 0x20000 /* use tile blitting */ | |
434 | ||
39942fd8 KP |
435 | /* A driver may set this flag to indicate that it does want a set_par to be |
436 | * called every time when fbcon_switch is executed. The advantage is that with | |
7f927fcc | 437 | * this flag set you can really be sure that set_par is always called before |
25985edc | 438 | * any of the functions dependent on the correct hardware state or altering |
39942fd8 KP |
439 | * that state, even if you are using some broken X releases. The disadvantage |
440 | * is that it introduces unwanted delays to every console switch if set_par | |
441 | * is slow. It is a good idea to try this flag in the drivers initialization | |
442 | * code whenever there is a bug report related to switching between X and the | |
443 | * framebuffer console. | |
444 | */ | |
445 | #define FBINFO_MISC_ALWAYS_SETPAR 0x40000 | |
446 | ||
b26c9497 DA |
447 | /* where the fb is a firmware driver, and can be replaced with a proper one */ |
448 | #define FBINFO_MISC_FIRMWARE 0x80000 | |
e4c690e0 AV |
449 | /* |
450 | * Host and GPU endianness differ. | |
451 | */ | |
452 | #define FBINFO_FOREIGN_ENDIAN 0x100000 | |
453 | /* | |
454 | * Big endian math. This is the same flags as above, but with different | |
455 | * meaning, it is set by the fb subsystem depending FOREIGN_ENDIAN flag | |
456 | * and host endianness. Drivers should not use this flag. | |
457 | */ | |
458 | #define FBINFO_BE_MATH 0x100000 | |
da6c7707 DV |
459 | /* |
460 | * Hide smem_start in the FBIOGET_FSCREENINFO IOCTL. This is used by modern DRM | |
461 | * drivers to stop userspace from trying to share buffers behind the kernel's | |
462 | * back. Instead dma-buf based buffer sharing should be used. | |
463 | */ | |
464 | #define FBINFO_HIDE_SMEM_START 0x200000 | |
465 | ||
e4c690e0 | 466 | |
1da177e4 | 467 | struct fb_info { |
698b3682 | 468 | atomic_t count; |
1da177e4 LT |
469 | int node; |
470 | int flags; | |
c9e6a364 HG |
471 | /* |
472 | * -1 by default, set to a FB_ROTATE_* value by the driver, if it knows | |
473 | * a lcd is not mounted upright and fbcon should rotate to compensate. | |
474 | */ | |
475 | int fbcon_rotate_hint; | |
3e680aae | 476 | struct mutex lock; /* Lock for open/release/ioctl funcs */ |
537a1bf0 | 477 | struct mutex mm_lock; /* Lock for fb_mmap and smem_* fields */ |
1da177e4 LT |
478 | struct fb_var_screeninfo var; /* Current var */ |
479 | struct fb_fix_screeninfo fix; /* Current fix */ | |
480 | struct fb_monspecs monspecs; /* Current Monitor specs */ | |
481 | struct work_struct queue; /* Framebuffer event queue */ | |
482 | struct fb_pixmap pixmap; /* Image hardware mapper */ | |
483 | struct fb_pixmap sprite; /* Cursor hardware mapper */ | |
484 | struct fb_cmap cmap; /* Current cmap */ | |
485 | struct list_head modelist; /* mode list */ | |
486 | struct fb_videomode *mode; /* current mode */ | |
5474c120 | 487 | |
b4a1ed0c | 488 | #if IS_ENABLED(CONFIG_FB_BACKLIGHT) |
5474c120 | 489 | /* assigned backlight device */ |
37ce69a5 RP |
490 | /* set before framebuffer registration, |
491 | remove after unregister */ | |
5474c120 MH |
492 | struct backlight_device *bl_dev; |
493 | ||
494 | /* Backlight level curve */ | |
37ce69a5 | 495 | struct mutex bl_curve_mutex; |
5474c120 MH |
496 | u8 bl_curve[FB_BACKLIGHT_LEVELS]; |
497 | #endif | |
60b59bea JK |
498 | #ifdef CONFIG_FB_DEFERRED_IO |
499 | struct delayed_work deferred_work; | |
500 | struct fb_deferred_io *fbdefio; | |
501 | #endif | |
5474c120 | 502 | |
1da177e4 | 503 | struct fb_ops *fbops; |
78cde088 GKH |
504 | struct device *device; /* This is the parent */ |
505 | struct device *dev; /* This is this fb device */ | |
1a6600be | 506 | int class_flag; /* private sysfs flags */ |
1da177e4 LT |
507 | #ifdef CONFIG_FB_TILEBLITTING |
508 | struct fb_tile_ops *tileops; /* Tile Blitting */ | |
509 | #endif | |
17a7b0b4 LS |
510 | union { |
511 | char __iomem *screen_base; /* Virtual address */ | |
512 | char *screen_buffer; | |
513 | }; | |
1da177e4 LT |
514 | unsigned long screen_size; /* Amount of ioremapped VRAM or 0 */ |
515 | void *pseudo_palette; /* Fake palette of 16 colors */ | |
516 | #define FBINFO_STATE_RUNNING 0 | |
517 | #define FBINFO_STATE_SUSPENDED 1 | |
518 | u32 state; /* Hardware state i.e suspend */ | |
519 | void *fbcon_par; /* fbcon use-only private area */ | |
520 | /* From here on everything is device dependent */ | |
4410f391 | 521 | void *par; |
25985edc | 522 | /* we need the PCI or similar aperture base/size not |
4410f391 DA |
523 | smem_start/size as smem_start may just be an object |
524 | allocated inside the aperture so may not actually overlap */ | |
1471ca9a MS |
525 | struct apertures_struct { |
526 | unsigned int count; | |
527 | struct aperture { | |
528 | resource_size_t base; | |
529 | resource_size_t size; | |
530 | } ranges[0]; | |
531 | } *apertures; | |
3cf2667b JB |
532 | |
533 | bool skip_vt_switch; /* no VT switch on suspend/resume required */ | |
1da177e4 LT |
534 | }; |
535 | ||
1471ca9a MS |
536 | static inline struct apertures_struct *alloc_apertures(unsigned int max_num) { |
537 | struct apertures_struct *a = kzalloc(sizeof(struct apertures_struct) | |
538 | + max_num * sizeof(struct aperture), GFP_KERNEL); | |
772a2f9b DC |
539 | if (!a) |
540 | return NULL; | |
1471ca9a MS |
541 | a->count = max_num; |
542 | return a; | |
543 | } | |
544 | ||
1da177e4 LT |
545 | #define FBINFO_FLAG_DEFAULT FBINFO_DEFAULT |
546 | ||
547 | /* This will go away | |
548 | * fbset currently hacks in FB_ACCELF_TEXT into var.accel_flags | |
549 | * when it wants to turn the acceleration engine on. This is | |
550 | * really a separate operation, and should be modified via sysfs. | |
551 | * But for now, we leave it broken with the following define | |
552 | */ | |
553 | #define STUPID_ACCELF_TEXT_SHIT | |
554 | ||
555 | // This will go away | |
556 | #if defined(__sparc__) | |
557 | ||
558 | /* We map all of our framebuffers such that big-endian accesses | |
559 | * are what we want, so the following is sufficient. | |
560 | */ | |
561 | ||
562 | // This will go away | |
563 | #define fb_readb sbus_readb | |
564 | #define fb_readw sbus_readw | |
565 | #define fb_readl sbus_readl | |
566 | #define fb_readq sbus_readq | |
567 | #define fb_writeb sbus_writeb | |
568 | #define fb_writew sbus_writew | |
569 | #define fb_writel sbus_writel | |
570 | #define fb_writeq sbus_writeq | |
571 | #define fb_memset sbus_memset_io | |
f11b478d JH |
572 | #define fb_memcpy_fromfb sbus_memcpy_fromio |
573 | #define fb_memcpy_tofb sbus_memcpy_toio | |
1da177e4 | 574 | |
f1b95b71 JZ |
575 | #elif defined(__i386__) || defined(__alpha__) || defined(__x86_64__) || \ |
576 | defined(__hppa__) || defined(__sh__) || defined(__powerpc__) || \ | |
e3ed8b43 | 577 | defined(__arm__) || defined(__aarch64__) |
1da177e4 LT |
578 | |
579 | #define fb_readb __raw_readb | |
580 | #define fb_readw __raw_readw | |
581 | #define fb_readl __raw_readl | |
582 | #define fb_readq __raw_readq | |
583 | #define fb_writeb __raw_writeb | |
584 | #define fb_writew __raw_writew | |
585 | #define fb_writel __raw_writel | |
586 | #define fb_writeq __raw_writeq | |
587 | #define fb_memset memset_io | |
f11b478d JH |
588 | #define fb_memcpy_fromfb memcpy_fromio |
589 | #define fb_memcpy_tofb memcpy_toio | |
1da177e4 LT |
590 | |
591 | #else | |
592 | ||
593 | #define fb_readb(addr) (*(volatile u8 *) (addr)) | |
594 | #define fb_readw(addr) (*(volatile u16 *) (addr)) | |
595 | #define fb_readl(addr) (*(volatile u32 *) (addr)) | |
596 | #define fb_readq(addr) (*(volatile u64 *) (addr)) | |
597 | #define fb_writeb(b,addr) (*(volatile u8 *) (addr) = (b)) | |
598 | #define fb_writew(b,addr) (*(volatile u16 *) (addr) = (b)) | |
599 | #define fb_writel(b,addr) (*(volatile u32 *) (addr) = (b)) | |
600 | #define fb_writeq(b,addr) (*(volatile u64 *) (addr) = (b)) | |
601 | #define fb_memset memset | |
f11b478d JH |
602 | #define fb_memcpy_fromfb memcpy |
603 | #define fb_memcpy_tofb memcpy | |
1da177e4 | 604 | |
be0d9b6c AD |
605 | #endif |
606 | ||
e4c690e0 AV |
607 | #define FB_LEFT_POS(p, bpp) (fb_be_math(p) ? (32 - (bpp)) : 0) |
608 | #define FB_SHIFT_HIGH(p, val, bits) (fb_be_math(p) ? (val) >> (bits) : \ | |
609 | (val) << (bits)) | |
610 | #define FB_SHIFT_LOW(p, val, bits) (fb_be_math(p) ? (val) << (bits) : \ | |
611 | (val) >> (bits)) | |
1da177e4 LT |
612 | |
613 | /* | |
614 | * `Generic' versions of the frame buffer device operations | |
615 | */ | |
616 | ||
617 | extern int fb_set_var(struct fb_info *info, struct fb_var_screeninfo *var); | |
618 | extern int fb_pan_display(struct fb_info *info, struct fb_var_screeninfo *var); | |
619 | extern int fb_blank(struct fb_info *info, int blank); | |
1da177e4 LT |
620 | extern void cfb_fillrect(struct fb_info *info, const struct fb_fillrect *rect); |
621 | extern void cfb_copyarea(struct fb_info *info, const struct fb_copyarea *area); | |
622 | extern void cfb_imageblit(struct fb_info *info, const struct fb_image *image); | |
68648ed1 AD |
623 | /* |
624 | * Drawing operations where framebuffer is in system RAM | |
625 | */ | |
626 | extern void sys_fillrect(struct fb_info *info, const struct fb_fillrect *rect); | |
627 | extern void sys_copyarea(struct fb_info *info, const struct fb_copyarea *area); | |
628 | extern void sys_imageblit(struct fb_info *info, const struct fb_image *image); | |
09aaf268 AD |
629 | extern ssize_t fb_sys_read(struct fb_info *info, char __user *buf, |
630 | size_t count, loff_t *ppos); | |
631 | extern ssize_t fb_sys_write(struct fb_info *info, const char __user *buf, | |
632 | size_t count, loff_t *ppos); | |
1da177e4 LT |
633 | |
634 | /* drivers/video/fbmem.c */ | |
635 | extern int register_framebuffer(struct fb_info *fb_info); | |
636 | extern int unregister_framebuffer(struct fb_info *fb_info); | |
ce880cb8 | 637 | extern int unlink_framebuffer(struct fb_info *fb_info); |
4d18975c MM |
638 | extern int remove_conflicting_pci_framebuffers(struct pci_dev *pdev, int res_id, |
639 | const char *name); | |
46eeb2c1 CW |
640 | extern int remove_conflicting_framebuffers(struct apertures_struct *a, |
641 | const char *name, bool primary); | |
9c44e5f6 AD |
642 | extern int fb_prepare_logo(struct fb_info *fb_info, int rotate); |
643 | extern int fb_show_logo(struct fb_info *fb_info, int rotate); | |
1da177e4 | 644 | extern char* fb_get_buffer_offset(struct fb_info *info, struct fb_pixmap *buf, u32 size); |
f1ab5dac | 645 | extern void fb_pad_unaligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 idx, |
1da177e4 | 646 | u32 height, u32 shift_high, u32 shift_low, u32 mod); |
f1ab5dac | 647 | extern void fb_pad_aligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 s_pitch, u32 height); |
1da177e4 | 648 | extern void fb_set_suspend(struct fb_info *info, int state); |
b8c90945 AD |
649 | extern int fb_get_color_depth(struct fb_var_screeninfo *var, |
650 | struct fb_fix_screeninfo *fix); | |
a66e62ae | 651 | extern int fb_get_options(const char *name, char **option); |
1da177e4 LT |
652 | extern int fb_new_modelist(struct fb_info *info); |
653 | ||
654 | extern struct fb_info *registered_fb[FB_MAX]; | |
655 | extern int num_registered_fb; | |
890d14d2 | 656 | extern bool fb_center_logo; |
9db71a18 | 657 | extern struct class *fb_class; |
1da177e4 | 658 | |
10ac8688 YX |
659 | #define for_each_registered_fb(i) \ |
660 | for (i = 0; i < FB_MAX; i++) \ | |
661 | if (!registered_fb[i]) {} else | |
662 | ||
6a7f2829 | 663 | extern int lock_fb_info(struct fb_info *info); |
1f5e31d7 AR |
664 | |
665 | static inline void unlock_fb_info(struct fb_info *info) | |
666 | { | |
667 | mutex_unlock(&info->lock); | |
668 | } | |
669 | ||
829e79b6 AD |
670 | static inline void __fb_pad_aligned_buffer(u8 *dst, u32 d_pitch, |
671 | u8 *src, u32 s_pitch, u32 height) | |
672 | { | |
ee346873 | 673 | u32 i, j; |
829e79b6 AD |
674 | |
675 | d_pitch -= s_pitch; | |
676 | ||
677 | for (i = height; i--; ) { | |
678 | /* s_pitch is a few bytes at the most, memcpy is suboptimal */ | |
679 | for (j = 0; j < s_pitch; j++) | |
680 | *dst++ = *src++; | |
681 | dst += d_pitch; | |
682 | } | |
683 | } | |
684 | ||
60b59bea | 685 | /* drivers/video/fb_defio.c */ |
ba026334 | 686 | int fb_deferred_io_mmap(struct fb_info *info, struct vm_area_struct *vma); |
60b59bea | 687 | extern void fb_deferred_io_init(struct fb_info *info); |
d847471d IC |
688 | extern void fb_deferred_io_open(struct fb_info *info, |
689 | struct inode *inode, | |
690 | struct file *file); | |
60b59bea | 691 | extern void fb_deferred_io_cleanup(struct fb_info *info); |
02c24a82 JB |
692 | extern int fb_deferred_io_fsync(struct file *file, loff_t start, |
693 | loff_t end, int datasync); | |
60b59bea | 694 | |
e4c690e0 AV |
695 | static inline bool fb_be_math(struct fb_info *info) |
696 | { | |
697 | #ifdef CONFIG_FB_FOREIGN_ENDIAN | |
698 | #if defined(CONFIG_FB_BOTH_ENDIAN) | |
699 | return info->flags & FBINFO_BE_MATH; | |
700 | #elif defined(CONFIG_FB_BIG_ENDIAN) | |
701 | return true; | |
702 | #elif defined(CONFIG_FB_LITTLE_ENDIAN) | |
703 | return false; | |
704 | #endif /* CONFIG_FB_BOTH_ENDIAN */ | |
705 | #else | |
706 | #ifdef __BIG_ENDIAN | |
707 | return true; | |
708 | #else | |
709 | return false; | |
710 | #endif /* __BIG_ENDIAN */ | |
711 | #endif /* CONFIG_FB_FOREIGN_ENDIAN */ | |
712 | } | |
713 | ||
1da177e4 LT |
714 | /* drivers/video/fbsysfs.c */ |
715 | extern struct fb_info *framebuffer_alloc(size_t size, struct device *dev); | |
716 | extern void framebuffer_release(struct fb_info *info); | |
78cde088 GKH |
717 | extern int fb_init_device(struct fb_info *fb_info); |
718 | extern void fb_cleanup_device(struct fb_info *head); | |
5474c120 | 719 | extern void fb_bl_default_curve(struct fb_info *fb_info, u8 off, u8 min, u8 max); |
1da177e4 LT |
720 | |
721 | /* drivers/video/fbmon.c */ | |
722 | #define FB_MAXTIMINGS 0 | |
723 | #define FB_VSYNCTIMINGS 1 | |
724 | #define FB_HSYNCTIMINGS 2 | |
725 | #define FB_DCLKTIMINGS 3 | |
726 | #define FB_IGNOREMON 0x100 | |
727 | ||
728 | #define FB_MODE_IS_UNKNOWN 0 | |
729 | #define FB_MODE_IS_DETAILED 1 | |
730 | #define FB_MODE_IS_STANDARD 2 | |
731 | #define FB_MODE_IS_VESA 4 | |
732 | #define FB_MODE_IS_CALCULATED 8 | |
733 | #define FB_MODE_IS_FIRST 16 | |
734 | #define FB_MODE_IS_FROM_VAR 32 | |
735 | ||
1da177e4 LT |
736 | extern int fbmon_dpms(const struct fb_info *fb_info); |
737 | extern int fb_get_mode(int flags, u32 val, struct fb_var_screeninfo *var, | |
738 | struct fb_info *info); | |
739 | extern int fb_validate_mode(const struct fb_var_screeninfo *var, | |
740 | struct fb_info *info); | |
741 | extern int fb_parse_edid(unsigned char *edid, struct fb_var_screeninfo *var); | |
5e518d76 AD |
742 | extern const unsigned char *fb_firmware_edid(struct device *device); |
743 | extern void fb_edid_to_monspecs(unsigned char *edid, | |
744 | struct fb_monspecs *specs); | |
9fbbdde9 EG |
745 | extern void fb_edid_add_monspecs(unsigned char *edid, |
746 | struct fb_monspecs *specs); | |
1da177e4 | 747 | extern void fb_destroy_modedb(struct fb_videomode *modedb); |
96fe6a21 | 748 | extern int fb_find_mode_cvt(struct fb_videomode *mode, int margins, int rb); |
fc5891c8 | 749 | extern unsigned char *fb_ddc_read(struct i2c_adapter *adapter); |
1da177e4 | 750 | |
79089044 ST |
751 | extern int of_get_fb_videomode(struct device_node *np, |
752 | struct fb_videomode *fb, | |
753 | int index); | |
2db54c72 ST |
754 | extern int fb_videomode_from_videomode(const struct videomode *vm, |
755 | struct fb_videomode *fbmode); | |
756 | ||
1da177e4 | 757 | /* drivers/video/modedb.c */ |
37715f55 | 758 | #define VESA_MODEDB_SIZE 43 |
8f5ee77b DU |
759 | #define DMT_SIZE 0x50 |
760 | ||
1da177e4 | 761 | extern void fb_var_to_videomode(struct fb_videomode *mode, |
9791d763 | 762 | const struct fb_var_screeninfo *var); |
1da177e4 | 763 | extern void fb_videomode_to_var(struct fb_var_screeninfo *var, |
9791d763 GU |
764 | const struct fb_videomode *mode); |
765 | extern int fb_mode_is_equal(const struct fb_videomode *mode1, | |
766 | const struct fb_videomode *mode2); | |
767 | extern int fb_add_videomode(const struct fb_videomode *mode, | |
768 | struct list_head *head); | |
769 | extern void fb_delete_videomode(const struct fb_videomode *mode, | |
1da177e4 | 770 | struct list_head *head); |
9791d763 GU |
771 | extern const struct fb_videomode *fb_match_mode(const struct fb_var_screeninfo *var, |
772 | struct list_head *head); | |
773 | extern const struct fb_videomode *fb_find_best_mode(const struct fb_var_screeninfo *var, | |
774 | struct list_head *head); | |
775 | extern const struct fb_videomode *fb_find_nearest_mode(const struct fb_videomode *mode, | |
776 | struct list_head *head); | |
1da177e4 | 777 | extern void fb_destroy_modelist(struct list_head *head); |
9791d763 | 778 | extern void fb_videomode_to_modelist(const struct fb_videomode *modedb, int num, |
1da177e4 | 779 | struct list_head *head); |
9791d763 GU |
780 | extern const struct fb_videomode *fb_find_best_display(const struct fb_monspecs *specs, |
781 | struct list_head *head); | |
1da177e4 LT |
782 | |
783 | /* drivers/video/fbcmap.c */ | |
784 | extern int fb_alloc_cmap(struct fb_cmap *cmap, int len, int transp); | |
1e7c7804 | 785 | extern int fb_alloc_cmap_gfp(struct fb_cmap *cmap, int len, int transp, gfp_t flags); |
1da177e4 | 786 | extern void fb_dealloc_cmap(struct fb_cmap *cmap); |
adf6b206 HD |
787 | extern int fb_copy_cmap(const struct fb_cmap *from, struct fb_cmap *to); |
788 | extern int fb_cmap_to_user(const struct fb_cmap *from, struct fb_cmap_user *to); | |
1da177e4 LT |
789 | extern int fb_set_cmap(struct fb_cmap *cmap, struct fb_info *fb_info); |
790 | extern int fb_set_user_cmap(struct fb_cmap_user *cmap, struct fb_info *fb_info); | |
adf6b206 | 791 | extern const struct fb_cmap *fb_default_cmap(int len); |
1da177e4 LT |
792 | extern void fb_invert_cmaps(void); |
793 | ||
794 | struct fb_videomode { | |
795 | const char *name; /* optional */ | |
796 | u32 refresh; /* optional */ | |
797 | u32 xres; | |
798 | u32 yres; | |
799 | u32 pixclock; | |
800 | u32 left_margin; | |
801 | u32 right_margin; | |
802 | u32 upper_margin; | |
803 | u32 lower_margin; | |
804 | u32 hsync_len; | |
805 | u32 vsync_len; | |
806 | u32 sync; | |
807 | u32 vmode; | |
808 | u32 flag; | |
809 | }; | |
810 | ||
8f5ee77b DU |
811 | struct dmt_videomode { |
812 | u32 dmt_id; | |
813 | u32 std_2byte_code; | |
814 | u32 cvt_3byte_code; | |
815 | const struct fb_videomode *mode; | |
816 | }; | |
817 | ||
9a054fba | 818 | extern const char *fb_mode_option; |
1da177e4 | 819 | extern const struct fb_videomode vesa_modes[]; |
6080a893 | 820 | extern const struct fb_videomode cea_modes[65]; |
8f5ee77b | 821 | extern const struct dmt_videomode dmt_modes[]; |
1da177e4 LT |
822 | |
823 | struct fb_modelist { | |
824 | struct list_head list; | |
825 | struct fb_videomode mode; | |
826 | }; | |
827 | ||
828 | extern int fb_find_mode(struct fb_var_screeninfo *var, | |
829 | struct fb_info *info, const char *mode_option, | |
830 | const struct fb_videomode *db, | |
831 | unsigned int dbsize, | |
832 | const struct fb_videomode *default_mode, | |
833 | unsigned int default_bpp); | |
834 | ||
f51a07d0 JP |
835 | /* Convenience logging macros */ |
836 | #define fb_err(fb_info, fmt, ...) \ | |
837 | pr_err("fb%d: " fmt, (fb_info)->node, ##__VA_ARGS__) | |
838 | #define fb_notice(info, fmt, ...) \ | |
839 | pr_notice("fb%d: " fmt, (fb_info)->node, ##__VA_ARGS__) | |
840 | #define fb_warn(fb_info, fmt, ...) \ | |
841 | pr_warn("fb%d: " fmt, (fb_info)->node, ##__VA_ARGS__) | |
842 | #define fb_info(fb_info, fmt, ...) \ | |
843 | pr_info("fb%d: " fmt, (fb_info)->node, ##__VA_ARGS__) | |
844 | #define fb_dbg(fb_info, fmt, ...) \ | |
845 | pr_debug("fb%d: " fmt, (fb_info)->node, ##__VA_ARGS__) | |
846 | ||
1da177e4 | 847 | #endif /* _LINUX_FB_H */ |