Linux核心的framebuffer相關的核心程式碼註釋
版權宣告：您好，轉載請留下本人部落格的地址，謝謝 https://blog.csdn.net/hongbochen1223/article/details/49259589
由於現在正在進行framebuffer的一個專案開發，所以需要學習framebuffer的核心程式碼，今天現在這裡上傳我的相關注釋，後面再將我的學習內容和相關framebuffer的操作提交上來．
位置：原始碼根目錄/include/linux/fb.h
#ifndef _LINUX_FB_H
#define _LINUX_FB_H
#include <linux/types.h>
#include <linux/i2c.h>
struct dentry;
/* Definitions of frame buffers frame buffer的定義 */
#define FB_MAX 32 /* sufficient for now 對於現在來說足夠了 */
/* ioctls
0x46 is `F` */
#define FBIOGET_VSCREENINFO 0x4600
#define FBIOPUT_VSCREENINFO 0x4601
#define FBIOGET_FSCREENINFO 0x4602
#define FBIOGETCMAP 0x4604
#define FBIOPUTCMAP 0x4605
#define FBIOPAN_DISPLAY 0x4606
#ifdef __KERNEL__
#define FBIO_CURSOR _IOWR(`F`, 0x08, struct fb_cursor_user)
#else
#define FBIO_CURSOR _IOWR(`F`, 0x08, struct fb_cursor)
#endif
/* 0x4607-0x460B are defined below */
/* #define FBIOGET_MONITORSPEC 0x460C */
/* #define FBIOPUT_MONITORSPEC 0x460D */
/* #define FBIOSWITCH_MONIBIT 0x460E */
#define FBIOGET_CON2FBMAP 0x460F
#define FBIOPUT_CON2FBMAP 0x4610
#define FBIOBLANK 0x4611 /* arg: 0 or vesa level + 1 */
#define FBIOGET_VBLANK _IOR(`F`, 0x12, struct fb_vblank)
#define FBIO_ALLOC 0x4613
#define FBIO_FREE 0x4614
#define FBIOGET_GLYPH 0x4615
#define FBIOGET_HWCINFO 0x4616
#define FBIOPUT_MODEINFO 0x4617
#define FBIOGET_DISPINFO 0x4618
#define FB_TYPE_PACKED_PIXELS 0 /* Packed Pixels 填充的畫素 */
#define FB_TYPE_PLANES 1 /* Non interleaved planes 非交錯平面 */
#define FB_TYPE_INTERLEAVED_PLANES 2 /* Interleaved planes 交錯的平面 */
#define FB_TYPE_TEXT 3 /* Text/attributes 文字/屬性 */
#define FB_TYPE_VGA_PLANES 4 /* EGA/VGA planes EGA/VGA 平面 */
#define FB_AUX_TEXT_MDA 0 /* Monochrome text 單色文字 */
#define FB_AUX_TEXT_CGA 1 /* CGA/EGA/VGA Color text CGA/EGA/VGA色彩文字 */
#define FB_AUX_TEXT_S3_MMIO 2 /* S3 MMIO fasttext */
#define FB_AUX_TEXT_MGA_STEP16 3 /* MGA Millenium I: text, attr, 14 reserved bytes */
#define FB_AUX_TEXT_MGA_STEP8 4 /* other MGAs: text, attr, 6 reserved bytes */
#define FB_AUX_TEXT_SVGA_GROUP 8 /* 8-15: SVGA tileblit compatible modes */
#define FB_AUX_TEXT_SVGA_MASK 7 /* lower three bits says step */
#define FB_AUX_TEXT_SVGA_STEP2 8 /* SVGA text mode: text, attr */
#define FB_AUX_TEXT_SVGA_STEP4 9 /* SVGA text mode: text, attr, 2 reserved bytes */
#define FB_AUX_TEXT_SVGA_STEP8 10 /* SVGA text mode: text, attr, 6 reserved bytes */
#define FB_AUX_TEXT_SVGA_STEP16 11 /* SVGA text mode: text, attr, 14 reserved bytes */
#define FB_AUX_TEXT_SVGA_LAST 15 /* reserved up to 15 */
#define FB_AUX_VGA_PLANES_VGA4 0 /* 16 color planes (EGA/VGA) */
#define FB_AUX_VGA_PLANES_CFB4 1 /* CFB4 in planes (VGA) */
#define FB_AUX_VGA_PLANES_CFB8 2 /* CFB8 in planes (VGA) */
#define FB_VISUAL_MONO01 0 /* Monochr. 1=Black 0=White 1=黑色，２＝白色*/
#define FB_VISUAL_MONO10 1 /* Monochr. 1=White 0=Black 1=白色，２＝黑色*/
#define FB_VISUAL_TRUECOLOR 2 /* True color 真實的顏色 */
#define FB_VISUAL_PSEUDOCOLOR 3 /* Pseudo color (like atari) 偽顏色*/
#define FB_VISUAL_DIRECTCOLOR 4 /* Direct color 直接顏色 */
#define FB_VISUAL_STATIC_PSEUDOCOLOR 5 /* Pseudo color readonly 只讀偽顏色*/
#define FB_ACCEL_NONE 0 /* no hardware accelerator 沒有硬體加速 */
#define FB_ACCEL_ATARIBLITT 1 /* Atari Blitter */
#define FB_ACCEL_AMIGABLITT 2 /* Amiga Blitter */
#define FB_ACCEL_S3_TRIO64 3 /* Cybervision64 (S3 Trio64) */
#define FB_ACCEL_NCR_77C32BLT 4 /* RetinaZ3 (NCR 77C32BLT) */
#define FB_ACCEL_S3_VIRGE 5 /* Cybervision64/3D (S3 ViRGE) */
#define FB_ACCEL_ATI_MACH64GX 6 /* ATI Mach 64GX family */
#define FB_ACCEL_DEC_TGA 7 /* DEC 21030 TGA */
#define FB_ACCEL_ATI_MACH64CT 8 /* ATI Mach 64CT family */
#define FB_ACCEL_ATI_MACH64VT 9 /* ATI Mach 64CT family VT class */
#define FB_ACCEL_ATI_MACH64GT 10 /* ATI Mach 64CT family GT class */
#define FB_ACCEL_SUN_CREATOR 11 /* Sun Creator/Creator3D */
#define FB_ACCEL_SUN_CGSIX 12 /* Sun cg6 */
#define FB_ACCEL_SUN_LEO 13 /* Sun leo/zx */
#define FB_ACCEL_IMS_TWINTURBO 14 /* IMS Twin Turbo */
#define FB_ACCEL_3DLABS_PERMEDIA2 15 /* 3Dlabs Permedia 2 */
#define FB_ACCEL_MATROX_MGA2064W 16 /* Matrox MGA2064W (Millenium) */
#define FB_ACCEL_MATROX_MGA1064SG 17 /* Matrox MGA1064SG (Mystique) */
#define FB_ACCEL_MATROX_MGA2164W 18 /* Matrox MGA2164W (Millenium II) */
#define FB_ACCEL_MATROX_MGA2164W_AGP 19 /* Matrox MGA2164W (Millenium II) */
#define FB_ACCEL_MATROX_MGAG100 20 /* Matrox G100 (Productiva G100) */
#define FB_ACCEL_MATROX_MGAG200 21 /* Matrox G200 (Myst, Mill, ...) */
#define FB_ACCEL_SUN_CG14 22 /* Sun cgfourteen */
#define FB_ACCEL_SUN_BWTWO 23 /* Sun bwtwo */
#define FB_ACCEL_SUN_CGTHREE 24 /* Sun cgthree */
#define FB_ACCEL_SUN_TCX 25 /* Sun tcx */
#define FB_ACCEL_MATROX_MGAG400 26 /* Matrox G400 */
#define FB_ACCEL_NV3 27 /* nVidia RIVA 128 */
#define FB_ACCEL_NV4 28 /* nVidia RIVA TNT */
#define FB_ACCEL_NV5 29 /* nVidia RIVA TNT2 */
#define FB_ACCEL_CT_6555x 30 /* C&T 6555x */
#define FB_ACCEL_3DFX_BANSHEE 31 /* 3Dfx Banshee */
#define FB_ACCEL_ATI_RAGE128 32 /* ATI Rage128 family */
#define FB_ACCEL_IGS_CYBER2000 33 /* CyberPro 2000 */
#define FB_ACCEL_IGS_CYBER2010 34 /* CyberPro 2010 */
#define FB_ACCEL_IGS_CYBER5000 35 /* CyberPro 5000 */
#define FB_ACCEL_SIS_GLAMOUR 36 /* SiS 300/630/540 */
#define FB_ACCEL_3DLABS_PERMEDIA3 37 /* 3Dlabs Permedia 3 */
#define FB_ACCEL_ATI_RADEON 38 /* ATI Radeon family */
#define FB_ACCEL_I810 39 /* Intel 810/815 */
#define FB_ACCEL_SIS_GLAMOUR_2 40 /* SiS 315, 650, 740 */
#define FB_ACCEL_SIS_XABRE 41 /* SiS 330 ("Xabre") */
#define FB_ACCEL_I830 42 /* Intel 830M/845G/85x/865G */
#define FB_ACCEL_NV_10 43 /* nVidia Arch 10 */
#define FB_ACCEL_NV_20 44 /* nVidia Arch 20 */
#define FB_ACCEL_NV_30 45 /* nVidia Arch 30 */
#define FB_ACCEL_NV_40 46 /* nVidia Arch 40 */
#define FB_ACCEL_XGI_VOLARI_V 47 /* XGI Volari V3XT, V5, V8 */
#define FB_ACCEL_XGI_VOLARI_Z 48 /* XGI Volari Z7 */
#define FB_ACCEL_OMAP1610 49 /* TI OMAP16xx */
#define FB_ACCEL_TRIDENT_TGUI 50 /* Trident TGUI */
#define FB_ACCEL_TRIDENT_3DIMAGE 51 /* Trident 3DImage */
#define FB_ACCEL_TRIDENT_BLADE3D 52 /* Trident Blade3D */
#define FB_ACCEL_TRIDENT_BLADEXP 53 /* Trident BladeXP */
#define FB_ACCEL_CIRRUS_ALPINE 53 /* Cirrus Logic 543x/544x/5480 */
#define FB_ACCEL_NEOMAGIC_NM2070 90 /* NeoMagic NM2070 */
#define FB_ACCEL_NEOMAGIC_NM2090 91 /* NeoMagic NM2090 */
#define FB_ACCEL_NEOMAGIC_NM2093 92 /* NeoMagic NM2093 */
#define FB_ACCEL_NEOMAGIC_NM2097 93 /* NeoMagic NM2097 */
#define FB_ACCEL_NEOMAGIC_NM2160 94 /* NeoMagic NM2160 */
#define FB_ACCEL_NEOMAGIC_NM2200 95 /* NeoMagic NM2200 */
#define FB_ACCEL_NEOMAGIC_NM2230 96 /* NeoMagic NM2230 */
#define FB_ACCEL_NEOMAGIC_NM2360 97 /* NeoMagic NM2360 */
#define FB_ACCEL_NEOMAGIC_NM2380 98 /* NeoMagic NM2380 */
#define FB_ACCEL_PXA3XX 99 /* PXA3xx */
#define FB_ACCEL_SAVAGE4 0x80 /* S3 Savage4 */
#define FB_ACCEL_SAVAGE3D 0x81 /* S3 Savage3D */
#define FB_ACCEL_SAVAGE3D_MV 0x82 /* S3 Savage3D-MV */
#define FB_ACCEL_SAVAGE2000 0x83 /* S3 Savage2000 */
#define FB_ACCEL_SAVAGE_MX_MV 0x84 /* S3 Savage/MX-MV */
#define FB_ACCEL_SAVAGE_MX 0x85 /* S3 Savage/MX */
#define FB_ACCEL_SAVAGE_IX_MV 0x86 /* S3 Savage/IX-MV */
#define FB_ACCEL_SAVAGE_IX 0x87 /* S3 Savage/IX */
#define FB_ACCEL_PROSAVAGE_PM 0x88 /* S3 ProSavage PM133 */
#define FB_ACCEL_PROSAVAGE_KM 0x89 /* S3 ProSavage KM133 */
#define FB_ACCEL_S3TWISTER_P 0x8a /* S3 Twister */
#define FB_ACCEL_S3TWISTER_K 0x8b /* S3 TwisterK */
#define FB_ACCEL_SUPERSAVAGE 0x8c /* S3 Supersavage */
#define FB_ACCEL_PROSAVAGE_DDR 0x8d /* S3 ProSavage DDR */
#define FB_ACCEL_PROSAVAGE_DDRK 0x8e /* S3 ProSavage DDR-K */
/**
* 該結構體用於描述顯示卡自身的屬性
* 包括識別符，快取地址，顯示卡型別等
*
*/
struct fb_fix_screeninfo {
char id[16]; /* identification string eg "TT Builtin" 識別符號字串*/
unsigned long smem_start; /* Start of frame buffer mem frame buffer所佔記憶體的開始地址 */
/* (physical address) 這裡說的是實體地址 */
__u32 smem_len; /* Length of frame buffer mem frame buffer所佔記憶體的長度 */
__u32 type; /* see FB_TYPE_* 檢視FB_BYTE_* */
__u32 type_aux; /* Interleave for interleaved Planes 交織交錯的平面 */
__u32 visual; /* see FB_VISUAL_* 檢視FB_VISUAL_* */
__u16 xpanstep; /* zero if no hardware panning 如何沒有硬體支援的話為0 */
__u16 ypanstep; /* zero if no hardware panning 如果沒有硬體支援的話為０*/
__u16 ywrapstep; /* zero if no hardware ywrap 如果沒有硬體ywrap的話為０ */
__u32 line_length; /* length of a line in bytes 一行的長度，以byte為單位 */
unsigned long mmio_start; /* Start of Memory Mapped I/O 對映到I/O的記憶體的開始地址 */
/* (physical address) 實體地址*/
__u32 mmio_len; /* Length of Memory Mapped I/O 對映到I/O的記憶體長度*/
__u32 accel; /* Indicate to driver which 指示到驅動程式 */
/* specific chip/card we have 特別是我們擁有的晶片/卡*/
__u16 reserved[3]; /* Reserved for future compatibility 為後來的相容性保留*/
};
/* Interpretation of offset for color fields: All offsets are from the right,
* inside a "pixel" value, which is exactly `bits_per_pixel` wide (means: you
* can use the offset as right argument to <<). A pixel afterwards is a bit
* stream and is written to video memory as that unmodified.
*
* 色域偏移的解釋：所有的偏移量都來自於右邊，在一個＂畫素＂值裡面，實際上是`bits_per_pixel`
* 的寬度（也就是說：你可以使用該偏移量作為 << 的右引數）．一個畫素之後是一個位流，並且
* 作為未被修改而被寫到視訊記憶體中．
*
* For pseudocolor: offset and length should be the same for all color
* components. Offset specifies the position of the least significant bit
* of the pallette index in a pixel value. Length indicates the number
* of available palette entries (i.e. # of entries = 1 << length).
*
* 對於偽色彩來說：對於所有的顏色部分，偏移量和長度應該是相同的．偏移量指定了
* 在一個畫素值裡的調色盤索引的最低有效位的位置．長度指明瞭可用的調色盤入口的
* 數量．
*/
struct fb_bitfield {
__u32 offset; /* 位域的開始 */
__u32 length; /* length of bitfield 位域的長度 */
__u32 msb_right; /* != 0 : Most significant bit is 不等於０，大多數重要的位是右邊的 */
/* right */
};
#define FB_NONSTD_HAM 1 /* Hold-And-Modify (HAM) 保持和修改 */
#define FB_NONSTD_REV_PIX_IN_B 2 /* order of pixels in each byte is reversed 在每一個位元組中的畫素的順序被保留下來 */
#define FB_ACTIVATE_NOW 0 /* set values immediately (or vbl) 立即設定顏色 */
#define FB_ACTIVATE_NXTOPEN 1 /* activate on next open 在下一個開啟的時候啟用 */
#define FB_ACTIVATE_TEST 2 /* don`t set, round up impossible 不設定 */
#define FB_ACTIVATE_MASK 15
/* values */
#define FB_ACTIVATE_VBL 16 /* activate values on next vbl 在下一個vbl的時候啟用值 */
#define FB_CHANGE_CMAP_VBL 32 /* change colormap on vbl 在vbl的時候改變色彩對映 */
#define FB_ACTIVATE_ALL 64 /* change all VCs on this fb 在這個fb中改變所有的VC */
#define FB_ACTIVATE_FORCE 128 /* force apply even when no change */
#define FB_ACTIVATE_INV_MODE 256 /* invalidate videomode 即使在沒有改變無效視訊模式的時候強制應用 */
#define FB_ACCELF_TEXT 1 /* (OBSOLETE) see fb_info.flags and vc_mode 已過時 */
#define FB_SYNC_HOR_HIGH_ACT 1 /* horizontal sync high active 高活性水平同步 */
#define FB_SYNC_VERT_HIGH_ACT 2 /* vertical sync high active 高活性垂直同步 */
#define FB_SYNC_EXT 4 /* external sync 外部同步 */
#define FB_SYNC_COMP_HIGH_ACT 8 /* composite sync high active 高活性複合同步 */
#define FB_SYNC_BROADCAST 16 /* broadcast video timings 廣播視訊時序 */
/* vtotal = 144d/288n/576i => PAL */
/* vtotal = 121d/242n/484i => NTSC */
#define FB_SYNC_ON_GREEN 32 /* sync on green 在綠色下同步 */
#define FB_VMODE_NONINTERLACED 0 /* non interlaced 非交錯模式 */
#define FB_VMODE_INTERLACED 1 /* interlaced 交錯模式 */
#define FB_VMODE_DOUBLE 2 /* double scan 雙掃描模式 */
#define FB_VMODE_ODD_FLD_FIRST 4 /* interlaced: top line first 交錯的：頂行優先 */
#define FB_VMODE_MASK 255
#define FB_VMODE_YWRAP 256 /* ywrap instead of panning ywrap而不是panning */
#define FB_VMODE_SMOOTH_XPAN 512 /* smooth xpan possible (internally used) 平滑的xpan(內部使用) */
#define FB_VMODE_CONUPDATE 512 /* don`t update x/yoffset 不要更新 x/yoffset*/
/*
* Display rotation support
*
* 旋轉支援顯示
*/
#define FB_ROTATE_UR 0
#define FB_ROTATE_CW 1
#define FB_ROTATE_UD 2
#define FB_ROTATE_CCW 3
#define PICOS2KHZ(a) (1000000000UL/(a))
#define KHZ2PICOS(a) (1000000000UL/(a))
/**
* 用於描述顯示卡的一般特性，比如實際解析度，虛擬解析度，實際解析度和虛擬
* 解析度之間的位移等
*/
struct fb_var_screeninfo {
__u32 xres; /* visible resolution 可見解析度 */
__u32 yres;
__u32 xres_virtual; /* virtual resolution 虛擬解析度 */
__u32 yres_virtual;
__u32 xoffset; /* offset from virtual to visible 虛擬到可見的偏移量 */
__u32 yoffset; /* resolution */
__u32 bits_per_pixel; /* guess what BPP : 每個畫素的位數 */
__u32 grayscale; /* != 0 Graylevels instead of colors !=０指灰度而不是顏色 */
//如果是真實的顏色的話表示在fb記憶體中的位域，如果不是顏色的話，僅僅就是長度
//在這裡儲存的是fb快取的R/G/B位域
struct fb_bitfield red; /* bitfield in fb mem if true color, */
struct fb_bitfield green; /* else only length is significant */
struct fb_bitfield blue;
struct fb_bitfield transp; /* transparency 透明度 */
__u32 nonstd; /* != 0 Non standard pixel format !=0 非標準畫素格式 */
__u32 activate; /* see FB_ACTIVATE_* 檢視FB_ACTIVATE_* */
__u32 height; /* height of picture in mm 在記憶體中圖片的高度 */
__u32 width; /* width of picture in mm 在記憶體中圖片的寬度 */
__u32 accel_flags; /* (OBSOLETE) see fb_info.flags 已過時*/
/* Timing: All values in pixclocks, except pixclock (of course) */
/* 除了pixclock本身外，其他的都已pixclock為單位*/
__u32 pixclock; /* pixel clock in ps (pico seconds) 畫素時鐘（皮秒）*/
__u32 left_margin; /* time from sync to picture 行切換：從繪圖到同步之間的延遲 */
__u32 right_margin; /* time from picture to sync 行切換：從繪圖到同步之間的延遲 */
__u32 upper_margin; /* time from sync to picture 幀切換：從同步到繪圖之間的延遲 */
__u32 lower_margin; // 幀切換，從繪圖到同步之間的延遲
__u32 hsync_len; /* length of horizontal sync 水平同步的長度 */
__u32 vsync_len; /* length of vertical sync 垂直同步的長度 */
__u32 sync; /* see FB_SYNC_* 檢視FB_SYNC_* */
__u32 vmode; /* see FB_VMODE_* 檢視 FB_VMODE_* */
__u32 rotate; /* angle we rotate counter clockwise 順時針旋轉的角度 */
__u32 reserved[5]; /* Reserved for future compatibility 保留 */
};
/**
* 用於描述裝置無關的顏色對映資訊
*/
struct fb_cmap {
__u32 start; /* First entry 第一個元素入口 */
__u32 len; /* Number of entries 元素的數量*/
//R,G,B,透明度
__u16 *red; /* Red values */
__u16 *green;
__u16 *blue;
__u16 *transp; /* transparency, can be NULL 透明度，可以為空 */
};
struct fb_con2fbmap {
__u32 console;
__u32 framebuffer;
};
/* VESA Blanking Levels */
#define VESA_NO_BLANKING 0
#define VESA_VSYNC_SUSPEND 1
#define VESA_HSYNC_SUSPEND 2
#define VESA_POWERDOWN 3
enum {
/* screen: unblanked, hsync: on, vsync: on */
FB_BLANK_UNBLANK = VESA_NO_BLANKING,
/* screen: blanked, hsync: on, vsync: on */
FB_BLANK_NORMAL = VESA_NO_BLANKING + 1,
/* screen: blanked, hsync: on, vsync: off */
FB_BLANK_VSYNC_SUSPEND = VESA_VSYNC_SUSPEND + 1,
/* screen: blanked, hsync: off, vsync: on */
FB_BLANK_HSYNC_SUSPEND = VESA_HSYNC_SUSPEND + 1,
/* screen: blanked, hsync: off, vsync: off */
FB_BLANK_POWERDOWN = VESA_POWERDOWN + 1
};
#define FB_VBLANK_VBLANKING 0x001 /* currently in a vertical blank */
#define FB_VBLANK_HBLANKING 0x002 /* currently in a horizontal blank */
#define FB_VBLANK_HAVE_VBLANK 0x004 /* vertical blanks can be detected */
#define FB_VBLANK_HAVE_HBLANK 0x008 /* horizontal blanks can be detected */
#define FB_VBLANK_HAVE_COUNT 0x010 /* global retrace counter is available */
#define FB_VBLANK_HAVE_VCOUNT 0x020 /* the vcount field is valid */
#define FB_VBLANK_HAVE_HCOUNT 0x040 /* the hcount field is valid */
#define FB_VBLANK_VSYNCING 0x080 /* currently in a vsync */
#define FB_VBLANK_HAVE_VSYNC 0x100 /* verical syncs can be detected */
struct fb_vblank {
__u32 flags; /* FB_VBLANK flags FB_VBLANK標誌 */
__u32 count; /* counter of retraces since boot 啟動之後追溯的次數 */
__u32 vcount; /* current scanline position 當前掃描行位置 */
__u32 hcount; /* current scandot position 當前掃描點位置 */
__u32 reserved[4]; /* reserved for future compatibility 保留 */
};
/* Internal HW accel 內部硬體加速 */
#define ROP_COPY 0
#define ROP_XOR 1
//複製區域
struct fb_copyarea {
__u32 dx;
__u32 dy;
__u32 width;
__u32 height;
__u32 sx;
__u32 sy;
};
//回執矩形
struct fb_fillrect {
__u32 dx; /* screen-relative 螢幕相關 */
__u32 dy;
__u32 width;
__u32 height;
__u32 color;
__u32 rop;
};
struct fb_image {
__u32 dx; /* Where to place image 影像放在哪裡 */
__u32 dy;
__u32 width; /* Size of image 影像的寬度和高度 */
__u32 height;
__u32 fg_color; /* Only used when a mono bitmap 僅僅是單色影像的時候使用 */
__u32 bg_color;
__u8 depth; /* Depth of the image 影像的深度 */
const char *data; /* Pointer to image data 指向影像資料的指標 */
struct fb_cmap cmap; /* color map info 顏色對映資訊 */
};
/*
* hardware cursor control
* 硬體游標控制
*/
#define FB_CUR_SETIMAGE 0x01
#define FB_CUR_SETPOS 0x02
#define FB_CUR_SETHOT 0x04
#define FB_CUR_SETCMAP 0x08
#define FB_CUR_SETSHAPE 0x10
#define FB_CUR_SETSIZE 0x20
#define FB_CUR_SETALL 0xFF
// 游標位置
struct fbcurpos {
__u16 x, y;
};
struct fb_cursor {
__u16 set; /* what to set 設定成什麼 */
__u16 enable; /* cursor on/off 游標開啟/關閉 */
__u16 rop; /* bitop operation 位操作 */
const char *mask; /* cursor mask bits 游標掩碼位 */
struct fbcurpos hot; /* cursor hot spot 游標熱點 */
struct fb_image image; /* Cursor image 游標影像 */
};
#ifdef CONFIG_FB_BACKLIGHT
/* Settings for the generic backlight code */
#define FB_BACKLIGHT_LEVELS 128
#define FB_BACKLIGHT_MAX 0xFF
#endif
#ifdef __KERNEL__
#include <linux/fs.h>
#include <linux/init.h>
#include <linux/device.h>
#include <linux/workqueue.h>
#include <linux/notifier.h>
#include <linux/list.h>
#include <linux/backlight.h>
#include <asm/io.h>
struct vm_area_struct;
struct fb_info;
struct device;
struct file;
/* Definitions below are used in the parsed monitor specs */
#define FB_DPMS_ACTIVE_OFF 1
#define FB_DPMS_SUSPEND 2
#define FB_DPMS_STANDBY 4
#define FB_DISP_DDI 1
#define FB_DISP_ANA_700_300 2
#define FB_DISP_ANA_714_286 4
#define FB_DISP_ANA_1000_400 8
#define FB_DISP_ANA_700_000 16
#define FB_DISP_MONO 32
#define FB_DISP_RGB 64
#define FB_DISP_MULTI 128
#define FB_DISP_UNKNOWN 256
#define FB_SIGNAL_NONE 0
#define FB_SIGNAL_BLANK_BLANK 1
#define FB_SIGNAL_SEPARATE 2
#define FB_SIGNAL_COMPOSITE 4
#define FB_SIGNAL_SYNC_ON_GREEN 8
#define FB_SIGNAL_SERRATION_ON 16
#define FB_MISC_PRIM_COLOR 1
#define FB_MISC_1ST_DETAIL 2 /* First Detailed Timing is preferred 第一次詳細的時間是首選 */
struct fb_chroma {
__u32 redx; /* in fraction of 1024 1024的一小部分 */
__u32 greenx;
__u32 bluex;
__u32 whitex;
__u32 redy;
__u32 greeny;
__u32 bluey;
__u32 whitey;
};
struct fb_monspecs {
struct fb_chroma chroma;
struct fb_videomode *modedb; /* mode database 模式資料庫 */
__u8 manufacturer[4]; /* Manufacturer 製造商 */
__u8 monitor[14]; /* Monitor String 監視字串 */
__u8 serial_no[14]; /* Serial Number 序列號 */
__u8 ascii[14]; /* ? */
__u32 modedb_len; /* mode database length 模式資料庫長度 */
__u32 model; /* Monitor Model 監視模型 */
__u32 serial; /* Serial Number - Integer 序列號－整數 */
__u32 year; /* Year manufactured 製造年*/
__u32 week; /* Week Manufactured 製造周 */
__u32 hfmin; /* hfreq lower limit (Hz) hfreq最低限制*/
__u32 hfmax; /* hfreq upper limit (Hz) hfreq最高限制*/
__u32 dclkmin; /* pixelclock lower limit (Hz) pixelclock最低限制*/
__u32 dclkmax; /* pixelclock upper limit (Hz) pixelclock最高限制*/
__u16 input; /* display type - see FB_DISP_* 顯示型別 - 檢視FB_DISP_* */
__u16 dpms; /* DPMS support - see FB_DPMS_ DPMS支援－檢視FB_DPMS_ */
__u16 signal; /* Signal Type - see FB_SIGNAL_* 訊號型別 － 檢視FB_SIGNAL_* */
__u16 vfmin; /* vfreq lower limit (Hz) vfreq最低限制 */
__u16 vfmax; /* vfreq upper limit (Hz) vfreq最高限制 */
__u16 gamma; /* Gamma - in fractions of 100 100的分數 */
__u16 gtf : 1; /* supports GTF 支援 GTF */
__u16 misc; /* Misc flags - see FB_MISC_* Misc標識 － 檢視FB_MISC_* */
__u8 version; /* EDID version... EDID版本 */
__u8 revision; /* ...and revision 修訂版本 */
__u8 max_x; /* Maximum horizontal size (cm) 最大水平大小 */
__u8 max_y; /* Maximum vertical size (cm) 最大垂直大小 */
};
struct fb_cmap_user {
__u32 start; /* First entry 第一元素入口 */
__u32 len; /* Number of entries 元素的數量 */
//R,G,B和透明度
__u16 __user *red; /* Red values */
__u16 __user *green;
__u16 __user *blue;
__u16 __user *transp; /* transparency, can be NULL */
};
struct fb_image_user {
__u32 dx; /* Where to place image */
__u32 dy;
__u32 width; /* Size of image */
__u32 height;
__u32 fg_color; /* Only used when a mono bitmap */
__u32 bg_color;
__u8 depth; /* Depth of the image */
const char __user *data; /* Pointer to image data */
struct fb_cmap_user cmap; /* color map info */
};
struct fb_cursor_user {
__u16 set; /* what to set */
__u16 enable; /* cursor on/off */
__u16 rop; /* bitop operation */
const char __user *mask; /* cursor mask bits */
struct fbcurpos hot; /* cursor hot spot */
struct fb_image_user image; /* Cursor image */
};
/*
* Register/unregister for framebuffer events
* framebuffer事件的註冊/登出
*/
/* The resolution of the passed in fb_info about to change */
// 在fb_info中通過的解析度將要改變
#define FB_EVENT_MODE_CHANGE 0x01
/* The display on this fb_info is beeing suspended, no access to the
* framebuffer is allowed any more after that call returns
* 在這個fb_info的顯示是被懸掛著的，在那個呼叫返回之後的對framebuffer
* 的訪問是不被允許的．
*/
#define FB_EVENT_SUSPEND 0x02
/* The display on this fb_info was resumed, you can restore the display
* if you own it
* 在這個fb_info中的顯示恢復了，如果你擁有他，你可以恢復顯示
*
*/
#define FB_EVENT_RESUME 0x03
/* An entry from the modelist was removed */
// 模式列表中的一個元素被移走了
#define FB_EVENT_MODE_DELETE 0x04
/* A driver registered itself */
// 一個驅動註冊了他自己
#define FB_EVENT_FB_REGISTERED 0x05
/* A driver unregistered itself */
// 一個驅動登出了他自己
#define FB_EVENT_FB_UNREGISTERED 0x06
/* CONSOLE-SPECIFIC: get console to framebuffer mapping */
// 獲取framebuffer對映的控制檯
#define FB_EVENT_GET_CONSOLE_MAP 0x07
/* CONSOLE-SPECIFIC: set console to framebuffer mapping */
// 設定framebuffer對映的控制檯
#define FB_EVENT_SET_CONSOLE_MAP 0x08
/* A hardware display blank change occured */
// 一個硬體顯示空改變發生了
#define FB_EVENT_BLANK 0x09
/* Private modelist is to be replaced */
// 內部的模式列表將被替換
#define FB_EVENT_NEW_MODELIST 0x0A
/* The resolution of the passed in fb_info about to change and
all vc`s should be changed */
// 在fb_info中通過的解析度將要改變，並且所有的vc應該被改變
#define FB_EVENT_MODE_CHANGE_ALL 0x0B
/* A software display blank change occured */
// 一個軟體顯示空改變發生了
#define FB_EVENT_CONBLANK 0x0C
/* Get drawing requirements */
// 獲取畫圖需求
#define FB_EVENT_GET_REQ 0x0D
/* Unbind from the console if possible */
// 如果可能的話從控制檯中接觸繫結
#define FB_EVENT_FB_UNBIND 0x0E
/* CONSOLE-SPECIFIC: remap all consoles to new fb - for vga switcheroo */
// 重新將所有的控制檯對映到新的fb -- 對於vga switcheroo來說的
#define FB_EVENT_REMAP_ALL_CONSOLE 0x0F
struct fb_event {
struct fb_info *info;
void *data;
};
struct fb_blit_caps {
u32 x;
u32 y;
u32 len;
u32 flags;
};
extern int fb_register_client(struct notifier_block *nb);
extern int fb_unregister_client(struct notifier_block *nb);
extern int fb_notifier_call_chain(unsigned long val, void *v);
/*
* Pixmap structure definition
* Pixmap 結構體定義
* The purpose of this structure is to translate data
* from the hardware independent format of fbdev to what
* format the hardware needs.
* 該結構體的目的就是將資料從fbdev的硬體獨立的格式轉換成
* 硬體需要的格式
*
*/
#define FB_PIXMAP_DEFAULT 1 /* used internally by fbcon 被fvbcon內部使用*/
#define FB_PIXMAP_SYSTEM 2 /* memory is in system RAM 記憶體在系統RAM中*/
#define FB_PIXMAP_IO 4 /* memory is iomapped 記憶體被io對映了*/
#define FB_PIXMAP_SYNC 256 /* set if GPU can DMA 如果GPU能夠使用DMA的話設定*/
struct fb_pixmap {
u8 *addr; /* pointer to memory 指向記憶體的指標 */
u32 size; /* size of buffer in bytes 緩衝的位元組數大小 */
u32 offset; /* current offset to buffer 當前到buffer的偏移量 */
u32 buf_align; /* byte alignment of each bitmap 每一個點陣圖的位元組對齊 */
u32 scan_align; /* alignment per scanline 每一個掃描行的對齊 */
u32 access_align; /* alignment per read/write (bits) 每一個讀寫位的對齊 */
u32 flags; /* see FB_PIXMAP_* 檢視FB_PIXMAP_* */
u32 blit_x; /* supported bit block dimensions (1-32) 支援位塊尺寸(1-32) */
u32 blit_y; /* Format: blit_x = 1 << (width - 1) */
/* blit_y = 1 << (height - 1) */
/* if 0, will be set to 0xffffffff (all) 如果是０，則被設定為0xffffffff */
/* access methods 訪問方法 */
void (*writeio)(struct fb_info *info, void __iomem *dst, void *src, unsigned int size);
void (*readio) (struct fb_info *info, void *dst, void __iomem *src, unsigned int size);
};
#ifdef CONFIG_FB_DEFERRED_IO
struct fb_deferred_io {
/* delay between mkwrite and deferred handler 在mkwrite和延期的處理程式的時間 */
unsigned long delay;
struct mutex lock; /* mutex that protects the page list 保護頁列表的互斥鎖 */
struct list_head pagelist; /* list of touched pages 被建立的頁的列表*/
/* callback 回撥函式*/
void (*deferred_io)(struct fb_info *info, struct list_head *pagelist);
};
#endif
/*
* Frame buffer operations
* Frame buffer 的操作
* LOCKING NOTE: those functions must _ALL_ be called with the console
* semaphore held, this is the only suitable locking mechanism we have
* in 2.6. Some may be called at interrupt time at this point though.
* 這些函式必須要使用semaphore鎖．
*/
struct fb_ops {
/* open/release and usage marking */
// 開啟/釋放和使用標記
struct module *owner;
int (*fb_open)(struct fb_info *info, int user);
int (*fb_release)(struct fb_info *info, int user);
/* For framebuffers with strange non linear layouts or that do not
* work with normal memory mapped access
* 對於擁有陌生的非線性佈局的framebuffer來說，不能使用普通的記憶體
* 對映訪問來工作
*/
ssize_t (*fb_read)(struct fb_info *info, char __user *buf,
size_t count, loff_t *ppos);
ssize_t (*fb_write)(struct fb_info *info, const char __user *buf,
size_t count, loff_t *ppos);
/* checks var and eventually tweaks it to something supported,
* DO NOT MODIFY PAR */
// 檢查var並且事件性的調整到可支援狀態．不要修改PAR
int (*fb_check_var)(struct fb_var_screeninfo *var, struct fb_info *info);
/* set the video mode according to info->var */
// 通過info->var設定視訊模式
int (*fb_set_par)(struct fb_info *info);
/* set color register */
// 設定顏色暫存器
int (*fb_setcolreg)(unsigned regno, unsigned red, unsigned green,
unsigned blue, unsigned transp, struct fb_info *info);
/* set color registers in batch */
// 批處理設定顏色暫存器
int (*fb_setcmap)(struct fb_cmap *cmap, struct fb_info *info);
/* blank display */
// 空顯示
int (*fb_blank)(int blank, struct fb_info *info);
/* pan display */
// pan 顯示
int (*fb_pan_display)(struct fb_var_screeninfo *var, struct fb_info *info);
/* Draws a rectangle */
// 繪製一個矩形
void (*fb_fillrect) (struct fb_info *info, const struct fb_fillrect *rect);
/* Copy data from area to another */
// 從一個區域複製資料到另外一個區域
void (*fb_copyarea) (struct fb_info *info, const struct fb_copyarea *region);
/* Draws a image to the display */
// 在顯示器上繪製一個影像
void (*fb_imageblit) (struct fb_info *info, const struct fb_image *image);
/* Draws cursor */
// 繪製游標
int (*fb_cursor) (struct fb_info *info, struct fb_cursor *cursor);
/* Rotates the display */
// 旋轉顯示
void (*fb_rotate)(struct fb_info *info, int angle);
/* wait for blit idle, optional */
// 等待blit空閒，可選
int (*fb_sync)(struct fb_info *info);
/* perform fb specific ioctl (optional) */
// 執行fb指定的ioctl(可選)
int (*fb_ioctl)(struct fb_info *info, unsigned int cmd,
unsigned long arg);
/* Handle 32bit compat ioctl (optional) */
// 處理３２位相容的ioctl
int (*fb_compat_ioctl)(struct fb_info *info, unsigned cmd,
unsigned long arg);
/* perform fb specific mmap */
// 執行fb指定的mmap
int (*fb_mmap)(struct fb_info *info, struct vm_area_struct *vma);
/* get capability given var */
// 獲取給定的var的能力
void (*fb_get_caps)(struct fb_info *info, struct fb_blit_caps *caps,
struct fb_var_screeninfo *var);
/* teardown any resources to do with this framebuffer */
// 解除安裝與該framebuffer相關的任何資源
void (*fb_destroy)(struct fb_info *info);
};
#ifdef CONFIG_FB_TILEBLITTING
#define FB_TILE_CURSOR_NONE 0
#define FB_TILE_CURSOR_UNDERLINE 1
#define FB_TILE_CURSOR_LOWER_THIRD 2
#define FB_TILE_CURSOR_LOWER_HALF 3
#define FB_TILE_CURSOR_TWO_THIRDS 4
#define FB_TILE_CURSOR_BLOCK 5
struct fb_tilemap {
__u32 width; /* width of each tile in pixels 畫素的寬度 */
__u32 height; /* height of each tile in scanlines 掃描行的高度 */
__u32 depth; /* color depth of each tile 顏色深度 */
__u32 length; /* number of tiles in the map 在對映中的數量 */
const __u8 *data; /* actual tile map: a bitmap array, packed
to the nearest byte 實際對映：一個點陣圖陣列，被打包到最近的位 */
};
struct fb_tilerect {
__u32 sx; /* origin in the x-axis 在x軸中原點*/
__u32 sy; /* origin in the y-axis 在y軸中的原點*/
__u32 width; /* number of tiles in the x-axis 在x-axis 中的數量 */
__u32 height; /* number of tiles in the y-axis 在y-axis中的數量 */
__u32 index; /* what tile to use: index to tile map 使用哪一個tile:到tile對映的索引 */
__u32 fg; /* foreground color 前景色 */
__u32 bg; /* background color 後景色 */
__u32 rop; /* raster operation 光柵操作 */
};
struct fb_tilearea {
__u32 sx; /* source origin in the x-axis 在X軸的源原點 */
__u32 sy; /* source origin in the y-axis 在y軸的源原點 */
__u32 dx; /* destination origin in the x-axis 在x軸的目的原點 */
__u32 dy; /* destination origin in the y-axis 在y軸的目的原點 */
__u32 width; /* number of tiles in the x-axis 在x軸中的tiles的數量 */
__u32 height; /* number of tiles in the y-axis 在y軸中的tiles的數量 */
};
struct fb_tileblit {
__u32 sx; /* origin in the x-axis 在x軸的原點 */
__u32 sy; /* origin in the y-axis 在y軸的原點*/
__u32 width; /* number of tiles in the x-axis 在x軸上的tiles的數量 */
__u32 height; /* number of tiles in the y-axis 在y軸上的tiles的數量 */
__u32 fg; /* foreground color 前景色*/
__u32 bg; /* background color 後景色*/
__u32 length; /* number of tiles to draw 要繪製的tiles的數量 */
__u32 *indices; /* array of indices to tile map 到tile對映的指數陣列 */
};
struct fb_tilecursor {
__u32 sx; /* cursor position in the x-axis 在x軸的游標位置*/
__u32 sy; /* cursor position in the y-axis 在y軸的游標位置 */
__u32 mode; /* 0 = erase, 1 = draw 0 = 擦除，１＝繪製*/
__u32 shape; /* see FB_TILE_CURSOR_* 檢視FB_TILE_CURSOR_* */
__u32 fg; /* foreground color 前景色*/
__u32 bg; /* background color 後景色*/
};
struct fb_tile_ops {
/* set tile characteristics 設定tile的特徵*/
void (*fb_settile)(struct fb_info *info, struct fb_tilemap *map);
/* all dimensions from hereon are in terms of tiles */
// 從現在起，所有尺寸都在tiles方面
/* move a rectangular region of tiles from one area to another*/
// 移動一個矩形區域從一個地方到另外一個地方
void (*fb_tilecopy)(struct fb_info *info, struct fb_tilearea *area);
/* fill a rectangular region with a tile */
// 使用一個tile填充一個矩形區域
void (*fb_tilefill)(struct fb_info *info, struct fb_tilerect *rect);
/* copy an array of tiles */
// 複製一個tile陣列
void (*fb_tileblit)(struct fb_info *info, struct fb_tileblit *blit);
/* cursor */
// 游標
void (*fb_tilecursor)(struct fb_info *info,
struct fb_tilecursor *cursor);
/* get maximum length of the tile map */
// 獲取tile對映的最大長度
int (*fb_get_tilemax)(struct fb_info *info);
};
#endif /* CONFIG_FB_TILEBLITTING */
/* FBINFO_* = fb_info.flags bit flags FBINFO_* ＝ fb_info.flags 位標識 */
#define FBINFO_MODULE 0x0001 /* Low-level driver is a module 底層驅動是一個模組 */
#define FBINFO_HWACCEL_DISABLED 0x0002
/* When FBINFO_HWACCEL_DISABLED is set:
* Hardware acceleration is turned off. Software implementations
* of required functions (copyarea(), fillrect(), and imageblit())
* takes over; acceleration engine should be in a quiescent state */
/* 當FBINFO_HWACCEL_DISABLED被設定的時候：
* 硬體加速被關掉．所需功能的軟體實現(copyarea(),fillrect()和imageblit())
* 接管．加速引擎應該位域靜態狀態
*
/* hints 提示*/
#define FBINFO_VIRTFB 0x0004 /* FB is System RAM, not device. FB是系統RAM，不是裝置*/
#define FBINFO_PARTIAL_PAN_OK 0x0040 /* otw use pan only for double-buffering otw使用pan僅僅用於雙緩衝 */
#define FBINFO_READS_FAST 0x0080 /* soft-copy faster than rendering 軟拷貝快於渲染 */
/* hardware supported ops */
/* semantics: when a bit is set, it indicates that the operation is
* accelerated by hardware.
* 支援的硬體操作
* 語義：當一個位被設定，意味著操作被硬體加速了
*
* required functions will still work even if the bit is not set.
* 即使位沒有被設定，所需的功能依舊工作．
* optional functions may not even exist if the flag bit is not set.
* 如果標識位沒有被設定，可選的功能可能甚至不存在
*/
#define FBINFO_HWACCEL_NONE 0x0000
#define FBINFO_HWACCEL_COPYAREA 0x0100 /* required 需要*/
#define FBINFO_HWACCEL_FILLRECT 0x0200 /* required 需要*/
#define FBINFO_HWACCEL_IMAGEBLIT 0x0400 /* required 需要*/
#define FBINFO_HWACCEL_ROTATE 0x0800 /* optional 可選*/
#define FBINFO_HWACCEL_XPAN 0x1000 /* optional 可選*/
#define FBINFO_HWACCEL_YPAN 0x2000 /* optional */
#define FBINFO_HWACCEL_YWRAP 0x4000 /* optional */
#define FBINFO_MISC_USEREVENT 0x10000 /* event request
from userspace 從使用者空間時間需要*/
#define FBINFO_MISC_TILEBLITTING 0x20000 /* use tile blitting 使用tile blitting*/
#define FBINFO_MISC_FIRMWARE 0x40000 /* a replaceable firmware
inited framebuffer 一個可替換的韌體初始化的framebuffer*/
/* A driver may set this flag to indicate that it does want a set_par to be
* called every time when fbcon_switch is executed. The advantage is that with
* this flag set you can really be sure that set_par is always called before
* any of the functions dependant on the correct hardware state or altering
* that state, even if you are using some broken X releases. The disadvantage
* is that it introduces unwanted delays to every console switch if set_par
* is slow. It is a good idea to try this flag in the drivers initialization
* code whenever there is a bug report related to switching between X and the
* framebuffer console.
* 一個驅動可能會設定這個標識來表明每次當fbcon_switch被執行的時候，他不想呼叫set_par()．
* 他的優點就是伴隨著這個標識的設定，你可以確定set_par在任何依賴於正確的硬體狀態
* 或者是改變那個狀態之前被一直呼叫，即使你整在使用一些x發行版．他的缺點就是如果
* set_par太慢的話，在顯示在每一個控制檯的時候，會導致不希望的延遲．
*
*
*/
#define FBINFO_MISC_ALWAYS_SETPAR 0x40000
/*
* Host and GPU endianness differ.
* 主機和GPU端不同
*/
#define FBINFO_FOREIGN_ENDIAN 0x100000
/*
* Big endian math. This is the same flags as above, but with different
* meaning, it is set by the fb subsystem depending FOREIGN_ENDIAN flag
* and host endianness. Drivers should not use this flag.
* 大端數學．這個是和上面一樣的標識，但是意義卻是不一樣的，他是被依賴於FOREIGN_ENDIAN端
* 和主機端的fb子系統所設定的．驅動不應該使用這個標識
*
*/
#define FBINFO_BE_MATH 0x100000
struct fb_info {
int node;
int flags;
struct mutex lock; /* Lock for open/release/ioctl funcs 用於open/release/ioctl函式的鎖 */
struct mutex mm_lock; /* Lock for fb_mmap and smem_* fields 用於fb_mmap和smem_* 域的鎖 */
struct fb_var_screeninfo var; /* Current var 可變引數*/
struct fb_fix_screeninfo fix; /* Current fix 固定引數 */
struct fb_monspecs monspecs; /* Current Monitor specs 顯示器標準 */
struct work_struct queue; /* Framebuffer event queue 幀緩衝事件佇列 */
struct fb_pixmap pixmap; /* Image hardware mapper 影像硬體mapper */
struct fb_pixmap sprite; /* Cursor hardware mapper 游標硬體mapper */
struct fb_cmap cmap; /* Current cmap 目前的顏色表 */
struct list_head modelist; /* mode list 模式列表 */
struct fb_videomode *mode; /* current mode 當前的video模式 */
#ifdef CONFIG_FB_BACKLIGHT
/* assigned backlight device 對應的背光裝置*/
/* set before framebuffer registration,
remove after unregister 在framebuffer註冊之前被設定，在登出之後移走 */
struct backlight_device *bl_dev;
/* Backlight level curve 背光調整 */
struct mutex bl_curve_mutex;
u8 bl_curve[FB_BACKLIGHT_LEVELS];
#endif
#ifdef CONFIG_FB_DEFERRED_IO
struct delayed_work deferred_work;
struct fb_deferred_io *fbdefio;
#endif
struct fb_ops *fbops; // 幀緩衝操作
struct device *device; /* This is the parent 輻射被*/
struct device *dev; /* This is this fb device fb裝置 */
int class_flag; /* private sysfs flags 私有sysfs標識 */
#ifdef CONFIG_FB_TILEBLITTING
struct fb_tile_ops *tileops; /* Tile Blitting 圖塊blitting */
#endif
char __iomem *screen_base; /* Virtual address 虛擬基地址 */
unsigned long screen_size; /* Amount of ioremapped VRAM or 0 ioremapped的虛擬記憶體大小 或者是 ０*/
void *pseudo_palette; /* Fake palette of 16 colors 偽１６色顏色表 */
#define FBINFO_STATE_RUNNING 0
#define FBINFO_STATE_SUSPENDED 1
u32 state; /* Hardware state i.e suspend 硬體狀態，如掛起 */
void *fbcon_par; /* fbcon use-only private area fbcon僅僅用於私有區域*/
/* From here on everything is device dependent 從這裡開始所有的事物都是裝置依賴的 */
void *par;
/* we need the PCI or similiar aperture base/size not
smem_start/size as smem_start may just be an object
allocated inside the aperture so may not actually overlap */
resource_size_t aperture_base;
resource_size_t aperture_size;
};
#ifdef MODULE
#define FBINFO_DEFAULT FBINFO_MODULE
#else
#define FBINFO_DEFAULT 0
#endif
// This will go away 這將會走開
#define FBINFO_FLAG_MODULE FBINFO_MODULE
#define FBINFO_FLAG_DEFAULT FBINFO_DEFAULT
/* This will go away
* fbset currently hacks in FB_ACCELF_TEXT into var.accel_flags
* when it wants to turn the acceleration engine on. This is
* really a separate operation, and should be modified via sysfs.
* But for now, we leave it broken with the following define
* 這將會走開．當他想要開啟加速引擎的時候，fbset會到var.accel_falgs.
* 這個事實上是一個分離的操作，並且應該有sysfs修改．但是，對於現在來說，
* 我們把他打破與下面的定義．
*/
#define STUPID_ACCELF_TEXT_SHIT
// This will go away
// 這個將走開
#if defined(__sparc__)
/* We map all of our framebuffers such that big-endian accesses
* are what we want, so the following is sufficient.
*
* 我們對映所有的framebuffers，例如大端訪問是我們需要的，所以下面的就足夠了
*/
// This will go away
#define fb_readb sbus_readb
#define fb_readw sbus_readw
#define fb_readl sbus_readl
#define fb_readq sbus_readq
#define fb_writeb sbus_writeb
#define fb_writew sbus_writew
#define fb_writel sbus_writel
#define fb_writeq sbus_writeq
#define fb_memset sbus_memset_io
#elif defined(__i386__) || defined(__alpha__) || defined(__x86_64__) || defined(__hppa__) || defined(__sh__) || defined(__powerpc__) || defined(__avr32__) || defined(__bfin__)
#define fb_readb __raw_readb
#define fb_readw __raw_readw
#define fb_readl __raw_readl
#define fb_readq __raw_readq
#define fb_writeb __raw_writeb
#define fb_writew __raw_writew
#define fb_writel __raw_writel
#define fb_writeq __raw_writeq
#define fb_memset memset_io
#else
#define fb_readb(addr) (*(volatile u8 *) (addr))
#define fb_readw(addr) (*(volatile u16 *) (addr))
#define fb_readl(addr) (*(volatile u32 *) (addr))
#define fb_readq(addr) (*(volatile u64 *) (addr))
#define fb_writeb(b,addr) (*(volatile u8 *) (addr) = (b))
#define fb_writew(b,addr) (*(volatile u16 *) (addr) = (b))
#define fb_writel(b,addr) (*(volatile u32 *) (addr) = (b))
#define fb_writeq(b,addr) (*(volatile u64 *) (addr) = (b))
#define fb_memset memset
#endif
#define FB_LEFT_POS(p, bpp) (fb_be_math(p) ? (32 - (bpp)) : 0)
#define FB_SHIFT_HIGH(p, val, bits) (fb_be_math(p) ? (val) >> (bits) :
(val) << (bits))
#define FB_SHIFT_LOW(p, val, bits) (fb_be_math(p) ? (val) << (bits) :
(val) >> (bits))
/*
* `Generic` versions of the frame buffer device operations
* framebuffer的`Generis`版本的裝置操作
*
*/
extern int fb_set_var(struct fb_info *info, struct fb_var_screeninfo *var);
extern int fb_pan_display(struct fb_info *info, struct fb_var_screeninfo *var);
extern int fb_blank(struct fb_info *info, int blank);
extern void cfb_fillrect(struct fb_info *info, const struct fb_fillrect *rect);
extern void cfb_copyarea(struct fb_info *info, const struct fb_copyarea *area);
extern void cfb_imageblit(struct fb_info *info, const struct fb_image *image);
/*
* Drawing operations where framebuffer is in system RAM
* 在framebuffer所在的系統RAM繪製操作
*
*/
extern void sys_fillrect(struct fb_info *info, const struct fb_fillrect *rect);
extern void sys_copyarea(struct fb_info *info, const struct fb_copyarea *area);
extern void sys_imageblit(struct fb_info *info, const struct fb_image *image);
extern ssize_t fb_sys_read(struct fb_info *info, char __user *buf,
size_t count, loff_t *ppos);
extern ssize_t fb_sys_write(struct fb_info *info, const char __user *buf,
size_t count, loff_t *ppos);
/* drivers/video/fbmem.c */
extern int register_framebuffer(struct fb_info *fb_info);
extern int unregister_framebuffer(struct fb_info *fb_info);
extern int fb_prepare_logo(struct fb_info *fb_info, int rotate);
extern int fb_show_logo(struct fb_info *fb_info, int rotate);
extern char* fb_get_buffer_offset(struct fb_info *info, struct fb_pixmap *buf, u32 size);
extern void fb_pad_unaligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 idx,
u32 height, u32 shift_high, u32 shift_low, u32 mod);
extern void fb_pad_aligned_buffer(u8 *dst, u32 d_pitch, u8 *src, u32 s_pitch, u32 height);
extern void fb_set_suspend(struct fb_info *info, int state);
extern int fb_get_color_depth(struct fb_var_screeninfo *var,
struct fb_fix_screeninfo *fix);
extern int fb_get_options(char *name, char **option);
extern int fb_new_modelist(struct fb_info *info);
extern struct fb_info *registered_fb[FB_MAX];
extern int num_registered_fb;
extern struct class *fb_class;
extern int lock_fb_info(struct fb_info *info);
static inline void unlock_fb_info(struct fb_info *info)
{
mutex_unlock(&info->lock);
}
static inline void __fb_pad_aligned_buffer(u8 *dst, u32 d_pitch,
u8 *src, u32 s_pitch, u32 height)
{
int i, j;
d_pitch -= s_pitch;
for (i = height; i--; ) {
/* s_pitch is a few bytes at the most, memcpy is suboptimal */
for (j = 0; j < s_pitch; j++)
*dst++ = *src++;
dst += d_pitch;
}
}
/* drivers/video/fb_defio.c */
extern void fb_deferred_io_init(struct fb_info *info);
extern void fb_deferred_io_open(struct fb_info *info,
struct inode *inode,
struct file *file);
extern void fb_deferred_io_cleanup(struct fb_info *info);
extern int fb_deferred_io_fsync(struct file *file, struct dentry *dentry,
int datasync);
static inline bool fb_be_math(struct fb_info *info)
{
#ifdef CONFIG_FB_FOREIGN_ENDIAN
#if defined(CONFIG_FB_BOTH_ENDIAN)
return info->flags & FBINFO_BE_MATH;
#elif defined(CONFIG_FB_BIG_ENDIAN)
return true;
#elif defined(CONFIG_FB_LITTLE_ENDIAN)
return false;
#endif /* CONFIG_FB_BOTH_ENDIAN */
#else
#ifdef __BIG_ENDIAN
return true;
#else
return false;
#endif /* __BIG_ENDIAN */
#endif /* CONFIG_FB_FOREIGN_ENDIAN */
}
/* drivers/video/fbsysfs.c */
extern struct fb_info *framebuffer_alloc(size_t size, struct device *dev);
extern void framebuffer_release(struct fb_info *info);
extern int fb_init_device(struct fb_info *fb_info);
extern void fb_cleanup_device(struct fb_info *head);
extern void fb_bl_default_curve(struct fb_info *fb_info, u8 off, u8 min, u8 max);
/* drivers/video/fbmon.c */
#define FB_MAXTIMINGS 0
#define FB_VSYNCTIMINGS 1
#define FB_HSYNCTIMINGS 2
#define FB_DCLKTIMINGS 3
#define FB_IGNOREMON 0x100
#define FB_MODE_IS_UNKNOWN 0
#define FB_MODE_IS_DETAILED 1
#define FB_MODE_IS_STANDARD 2
#define FB_MODE_IS_VESA 4
#define FB_MODE_IS_CALCULATED 8
#define FB_MODE_IS_FIRST 16
#define FB_MODE_IS_FROM_VAR 32
extern int fbmon_dpms(const struct fb_info *fb_info);
extern int fb_get_mode(int flags, u32 val, struct fb_var_screeninfo *var,
struct fb_info *info);
extern int fb_validate_mode(const struct fb_var_screeninfo *var,
struct fb_info *info);
extern int fb_parse_edid(unsigned char *edid, struct fb_var_screeninfo *var);
extern const unsigned char *fb_firmware_edid(struct device *device);
extern void fb_edid_to_monspecs(unsigned char *edid,
struct fb_monspecs *specs);
extern void fb_destroy_modedb(struct fb_videomode *modedb);
extern int fb_find_mode_cvt(struct fb_videomode *mode, int margins, int rb);
extern unsigned char *fb_ddc_read(struct i2c_adapter *adapter);
/* drivers/video/modedb.c */
#define VESA_MODEDB_SIZE 34
extern void fb_var_to_videomode(struct fb_videomode *mode,
const struct fb_var_screeninfo *var);
extern void fb_videomode_to_var(struct fb_var_screeninfo *var,
const struct fb_videomode *mode);
extern int fb_mode_is_equal(const struct fb_videomode *mode1,
const struct fb_videomode *mode2);
extern int fb_add_videomode(const struct fb_videomode *mode,
struct list_head *head);
extern void fb_delete_videomode(const struct fb_videomode *mode,
struct list_head *head);
extern const struct fb_videomode *fb_match_mode(const struct fb_var_screeninfo *var,
struct list_head *head);
extern const struct fb_videomode *fb_find_best_mode(const struct fb_var_screeninfo *var,
struct list_head *head);
extern const struct fb_videomode *fb_find_nearest_mode(const struct fb_videomode *mode,
struct list_head *head);
extern void fb_destroy_modelist(struct list_head *head);
extern void fb_videomode_to_modelist(const struct fb_videomode *modedb, int num,
struct list_head *head);
extern const struct fb_videomode *fb_find_best_display(const struct fb_monspecs *specs,
struct list_head *head);
/* drivers/video/fbcmap.c */
extern int fb_alloc_cmap(struct fb_cmap *cmap, int len, int transp);
extern void fb_dealloc_cmap(struct fb_cmap *cmap);
extern int fb_copy_cmap(const struct fb_cmap *from, struct fb_cmap *to);
extern int fb_cmap_to_user(const struct fb_cmap *from, struct fb_cmap_user *to);
extern int fb_set_cmap(struct fb_cmap *cmap, struct fb_info *fb_info);
extern int fb_set_user_cmap(struct fb_cmap_user *cmap, struct fb_info *fb_info);
extern const struct fb_cmap *fb_default_cmap(int len);
extern void fb_invert_cmaps(void);
struct fb_videomode {
const char *name; /* optional */
u32 refresh; /* optional */
u32 xres;
u32 yres;
u32 pixclock;
u32 left_margin;
u32 right_margin;
u32 upper_margin;
u32 lower_margin;
u32 hsync_len;
u32 vsync_len;
u32 sync;
u32 vmode;
u32 flag;
};
extern const char *fb_mode_option;
extern const struct fb_videomode vesa_modes[];
struct fb_modelist {
struct list_head list;
struct fb_videomode mode;
};
extern int fb_find_mode(struct fb_var_screeninfo *var,
struct fb_info *info, const char *mode_option,
const struct fb_videomode *db,
unsigned int dbsize,
const struct fb_videomode *default_mode,
unsigned int default_bpp);
#endif /* __KERNEL__ */
#endif /* _LINUX_FB_H */
相關文章
- Linux 核心相關命令Linux
- oracle相關的linux核心引數OracleLinux
- 《Linux核心完全註釋》學習筆記：2.7 Linux核心原始碼的目錄結構Linux筆記原始碼
- Linux核心原始碼的閱讀及相關工具介紹(轉)Linux原始碼
- linux 跟oracle相關的系統核心引數?LinuxOracle
- 關於vim看linux 核心原始碼時的程式碼補全Linux原始碼
- Linux 檢視核心版本命令的相關說明Linux
- 與oracle緊密相關的unix/linux核心引數OracleLinux
- [轉帖]Redis相關的核心引數解釋與設定Redis
- Linux核心優化之TCP相關引數Linux優化TCP
- oracle sga配置相關的os 核心引數Oracle
- 快速上手Linux核心命令（八）：網路相關命令Linux
- 認識linux核心（linux核心的作用）Linux
- 檢視linux系統版本,核心,CPU,MEM,位數的相關命令Linux
- Java Thread 類相關的幾個核心方法Javathread
- Laravel核心程式碼學習--HTTP核心LaravelHTTP
- 快速上手Linux核心命令（十一）：Linux使用者相關命令Linux
- 快速上手Linux核心命令（七）：Linux系統資訊相關命令Linux
- Linux 核心引數 和 Oracle相關引數調整LinuxOracle
- Linux核心模組相關命令彙總及使用說明Linux
- Linux 核心引數及Oracle相關引數調整LinuxOracle
- 有趣的程式碼註釋
- Linux系統中與記憶體相關的幾個核心引數Linux記憶體
- LINUX 核心程式管理Linux
- Linux核心3.13正式釋出Linux
- 快速上手Linux核心命令（四）：檔案內容相關命令Linux
- (轉)Linux 核心引數及Oracle相關引數調整LinuxOracle
- Linux系統優化部分核心引數調優中文註釋Linux優化
- 程式碼·--四則運算的主要核心程式碼
- Android核心和Linux核心的區別AndroidLinux
- Linux 核心的故事Linux
- 程式碼才是最好的註釋
- 註釋程式碼的13技巧
- Linus關於核心標頭檔案與核心原始碼關係的論述(轉)原始碼
- 【移植Linux 3.4.2核心之四】修改核心程式碼支援YAFFS檔案系統Linux
- Linux核心筆記003 - Linux核心程式碼裡面的C語言和組合語言Linux筆記C語言組合語言
- Linux核心之 核心同步Linux
- oracle安裝linux時的核心引數解釋OracleLinux