#Linux五、 Framebuffer应用编程

1LCD操作原理

在Linux系统中通过Framebuffer驱动程序来控制LCD。Frame是帧的意思，buffer是缓冲的意思，这意味着Framebuffer就是一块内存，里面保存着一帧图像。Framebuffer中保存着一帧图像的每一个像素颜色值，假设LCD的分辨率是1024x768，每一个像素的颜色用32位来表示，那么Framebuffer的大小就是：1024x768x32/8=3145728字节。
① 驱动程序设置好LCD控制器：
根据LCD的参数设置LCD控制器的时序、信号极性；
根据LCD分辨率、BPP分配Framebuffer。
② APP使用ioctl获得LCD分辨率、BPP
③ APP通过mmap映射Framebuffer，在Framebuffer中写入数据

地址计算

假设需要设置LCD中坐标(x,y)处像素的颜色，首要要找到这个像素对应的内存，然后根据它的BPP值设置颜色。假设fb_base是APP执行mmap后得到的Framebuffer地址，如下图所示：

可以用以下公式算出(x,y)坐标处像素对应的Framebuffer地址
(x，y)像素起始地址=fb_base+(xres*bpp/8)y + xbpp/8
（注意在这里是以字节算的）

像素的表示

对于32BPP，一般只设置其中的低24位，高8位表示透明度，一般的LCD都不支持。
对于24BPP，硬件上为了方便处理，在Framebuffer中也是用32位来表示，效果跟32BPP是一样的。
对于16BPP，常用的是RGB565；很少的场合会用到RGB555，这可以通过ioctl读取驱动程序中的RGB位偏移来确定使用哪一种格式。

用到的API

1、open
头文件：
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
函数原型：
int open(const char *pathname, int flags);
int open(const char *pathname, int flags, mode_t mode);
	函数说明：
① pathname 表示打开文件的路径；
② Flags表示打开文件的方式，常用的有以下6种，
a. O_RDWR表示可读可写方式打开;
b. O_RDONLY表示只读方式打开;
c. O_WRONLY表示只写方式打开;
d. O_APPEND 表示如果这个文件中本来是有内容的，则新写入的内容会接续到原来内容的后面;
e. O_TRUNC表示如果这个文件中本来是有内容的，则原来的内容会被丢弃，截断；
f. O_CREAT表示当前打开文件不存在，我们创建它并打开它，通常与O_EXCL结合使用，当没有文件时创建文件，有这个文件时会报错提醒我们；
③ Mode表示创建文件的权限，只有在flags中使用了O_CREAT时才有效，否则忽略。
④ 返回值：打开成功返回文件描述符，失败将返回-1。
2、ioctl

头文件：
#include <sys/ioctl.h>
函数原型：
int ioctl(int fd, unsigned long request, ...);

函数说明：
① fd 表示文件描述符；
② request表示与驱动程序交互的命令，用不同的命令控制驱动程序输出我们需要的数据；
③ … 表示可变参数arg，根据request命令，设备驱动程序返回输出的数据。
④ 返回值：打开成功返回文件描述符，失败将返回-1。

ioctl的作用非常强大、灵活。不同的驱动程序内部会实现不同的ioctl，APP可以使用各种ioctl跟驱动程序交互：可以传数据给驱动程序，也可以从驱动程序中读出数据。
3、mmp
	头文件：
#include <sys/mman.h>
函数原型：
void *mmap(void *addr, size_t length, int prot, int flags,int fd, off_t offset);
	函数说明：
① addr表示指定映射的內存起始地址，通常设为 NULL表示让系统自动选定地址，并在成功映射后返回该地址；
② length表示将文件中多大的内容映射到内存中；
③ prot 表示映射区域的保护方式，可以为以下4种方式的组合
a. PROT_EXEC 映射区域可被执行
b. PROT_READ 映射区域可被读出
c. PROT_WRITE 映射区域可被写入
d. PROT_NONE 映射区域不能存取
④ Flags 表示影响映射区域的不同特性，常用的有以下两种
a. MAP_SHARED 表示对映射区域写入的数据会复制回文件内，原来的文件会改变。
b. MAP_PRIVATE 表示对映射区域的操作会产生一个映射文件的复制，对此区域的任何修改都不会写回
⑤ 返回值：若成功映射，将返回指向映射的区域的指针，失败将返回-1。

代码

#include <sys/mman.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <linux/fb.h>
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <sys/ioctl.h>

static int fd_fb;
static struct fb_var_screeninfo var;	/* Current var */
static int screen_size;
static unsigned char *fb_base;
static unsigned int line_width;
static unsigned int pixel_width;

/**********************************************************************
 * 函数名称： lcd_put_pixel
 * 功能描述： 在LCD指定位置上输出指定颜色（描点）
 * 输入参数： x坐标，y坐标，颜色
 * 输出参数： 无
 * 返 回 值： 会
 * 修改日期        版本号     修改人	      修改内容
 * -----------------------------------------------
 * 2020/05/12	     V1.0	  zh(angenao)	      创建
 ***********************************************************************/ 
void lcd_put_pixel(int x, int y, unsigned int color)
{
	unsigned char *pen_8 = fb_base+y*line_width+x*pixel_width;
	unsigned short *pen_16;	
	unsigned int *pen_32;	

	unsigned int red, green, blue;	

	pen_16 = (unsigned short *)pen_8;
	pen_32 = (unsigned int *)pen_8;

	switch (var.bits_per_pixel)
	{
		case 8:
		{
			*pen_8 = color;
			break;
		}
		case 16:
		{
			/* 565 */
			red   = (color >> 16) & 0xff;
			green = (color >> 8) & 0xff;
			blue  = (color >> 0) & 0xff;
			color = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3);
			*pen_16 = color;
			break;
		}
		case 32:
		{
			*pen_32 = color;
			break;
		}
		default:
		{
			printf("can't surport %dbpp\n", var.bits_per_pixel);
			break;
		}
	}
}

int main(int argc, char **argv)
{
	int i;
	
	fd_fb = open("/dev/fb0", O_RDWR);
	if (fd_fb < 0)
	{
		printf("can't open /dev/fb0\n");
		return -1;
	}
	if (ioctl(fd_fb, FBIOGET_VSCREENINFO, &var))
	{
		printf("can't get var\n");
		return -1;
	}

	line_width  = var.xres * var.bits_per_pixel / 8;
	pixel_width = var.bits_per_pixel / 8;
	screen_size = var.xres * var.yres * var.bits_per_pixel / 8;
	fb_base = (unsigned char *)mmap(NULL , screen_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd_fb, 0);
	if (fb_base == (unsigned char *)-1)
	{
		printf("can't mmap\n");
		return -1;
	}

	/* 清屏: 全部设为白色 */
	memset(fb_base, 0xff, screen_size);

	/* 随便设置出100个为红色 */
	for (i = 0; i < 100; i++)
		lcd_put_pixel(var.xres/2+i, var.yres/2, 0xFF0000);
	
	munmap(fb_base , screen_size);
	close(fd_fb);
	
	return 0;	
}

代码分析
fd_fb = open(“/dev/fb0”, O_RDWR);//打开驱动文件返回一个int的文件描述符
if (ioctl(fd_fb, FBIOGET_VSCREENINFO, &var))
{
printf(“can’t get var\n”);
return -1;
}
注意到ioctl里用的参数是：FBIOGET_VSCREENINFO，它表示get var screen info，获得屏幕的可变信息；当然也可以使用FBIOPUT_VSCREENINFO来调整这些参数，但是很少用到。
注意到ioctl里用的参数是：FBIOGET_VSCREENINFO，它表示get var screen info，获得屏幕的可变信息；当然也可以使用FBIOPUT_VSCREENINFO来调整这些参数，但是很少用到。

对于固定的参数fb_fix_screeninfo，在应用编程中很少用到。它的结构体定义如下：

可以使用ioctl FBIOGET_FSCREENINFO来读出这些信息，但是很少用到。

/* 计算参数转换为字节 /
line_width = var.xres * var.bits_per_pixel / 8;//一行x列bpp/8
pixel_width = var.bits_per_pixel / 8;//每个bpp大小
screen_size = var.xres * var.yres * var.bits_per_pixel / 8;//屏幕尺寸大小
fb_base = (unsigned char *)mmap(NULL , screen_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd_fb, 0);//

for (i = 0; i < 100; i++)
	lcd_put_pixel(var.xres/2+i, var.yres/2, 0xFF0000);/* 从屏幕中点位置向右画100个点 */
void lcd_put_pixel(int x, int y, unsigned int color)
{
	unsigned char *pen_8 = fb_base+y*line_width+x*pixel_width;/* 计算(x，y）的偏移地址 */
	unsigned short *pen_16;	
	unsigned int *pen_32;	

	unsigned int red, green, blue;	

	pen_16 = (unsigned short *)pen_8;
	pen_32 = (unsigned int *)pen_8;

	switch (var.bits_per_pixel)/* 根据bpp设置不同模式 */
	{
		case 8:
		{
			*pen_8 = color;/*只取高位*/
			break;
		}
		case 16://
		{
			/* 565 */
			red   = (color >> 16) & 0xff;/* 高8位 */
			green = (color >> 8) & 0xff;/* 中间8位 */
			blue  = (color >> 0) & 0xff;/* 低8位 */
			color = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3);/* r高5位做15：11，G高6位做10：5,B高5位 4：0 */
			*pen_16 = color;
			break;
		}
		case 32:
		{
			*pen_32 = color;//32位
			break;
		}
		default:
		{
			printf("can't surport %dbpp\n", var.bits_per_pixel);
			break;
		}
	}
}
munmap(fb_base , screen_size);/* munmap执行相反的操作，删除特定地址区域的对象映射。 */
close(fd_fb);