Framebuffer

LCD 操作原理

在 Linux 系统中通过 Framebuffer 驱动程序来控制 LCD。Frame 是帧的意思，buffer 是缓冲的意思，这意味着 Framebuffer 就是一块内存，里面保存着一帧图像。Framebuffer 中保存着一帧图像的每一个像素颜色值，假设 LCD的分辨率是 1024x768，每一个像素的颜色用 32 位来表示，那么 Framebuffer的大小就是：1024x768x32/8=3145728 字节。

简单介绍 LCD 的操作原理：

1. 驱动程序设置好 LCD 控制器：

   • 根据 LCD 的参数设置 LCD 控制器的时序、信号极性；
   • 根据 LCD 分辨率、BPP 分配 Framebuffer。

2. APP 使用 ioctl 获得 LCD 分辨率、BPP

3. APP 通过 mmap 映射 Framebuffer，在 Framebuffer 中写入数据
   

假设需要设置 LCD 中坐标(x,y)处像素的颜色，首要要找到这个像素对应的内存，然后根据它的 BPP 值（每个像素用多少位来表示颜色）设置颜色。假设 fb_base 是 APP 执行 mmap 后得到的 Framebuffer 地址（基地址）。可以用以下公式算出(x,y)坐标处像素对应的 Framebuffer 地址：(x，y)像素起始地址=fb_base+(xres*bpp/8)*y + x*bpp/8

fb_base为首地址
xres为x方向的分辨率
bpp的单位是位，除以8后得到的是字节数

最后一个要解决的问题就是像素的颜色怎么表示？它是用 RGB 三原色(红、绿、蓝)来表示的，在不同的 BPP 格式中，用不同的位来分别表示 R、G、B；

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

涉及的 API 函数

open 函数

略

ioctl函数

头文件：

#include <sys/ioctl.h>

函数原型：

int ioctl(int fd, unsigned long request, ...);

参数说明：

• ① fd 表示文件描述符；
• ② request 表示与驱动程序交互的命令，用不同的命令控制驱动程序输出我们需要的数据；
  • FBIOGET_VSCREENINFO：它表示 get var screen info，获得屏幕的可变信息；
  • FBIOPUT_VSCREENINFO：来调整这些参数，但是很少用到。
• ③ … 表示可变参数 arg，根据 request 命令，设备驱动程序返回输出的数据。

返回值：

• 打开成功返回文件描述符，失败将返回-1。

ioctl 的作用非常强大、灵活。不同的驱动程序内部会实现不同的 ioctl，APP 可以使用各种 ioctl 跟驱动程序交互：可以传数据给驱动程序，也可以从驱动程序中读出数据。

mmap 函数

Framebuffer 是驱动程序分配的，在用户空间态使用需要用该函数进行映射

头文件：

#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 种方式的组合

  • ◼ PROT_EXEC 映射区域可被执行
  • ◼ PROT_READ 映射区域可被读出
  • ◼ PROT_WRITE 映射区域可被写入
  • ◼ PROT_NONE 映射区域不能存取

• ④ Flags 表示影响映射区域的不同特性，常用的有以下两种

  • ◼ MAP_SHARED 表示对映射区域写入的数据会复制回文件内，原来的文件会改变。
  • ◼ MAP_PRIVATE 表示对映射区域的操作会产生一个映射文件的复制，对此区域的任何修改都不会写回原来的文件内容中。

返回值：

• 若成功映射，将返回指向映射的区域的指针（显存的基地址）
• 失败将返回-1。

Framebuffer 程序分析

本节程序的目的是：打开 LCD 设备节点，获取分辨率等参数，映射Framebuffer，最后实现描点函数。

#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 ：根据内核申请到的在用户空间态可以使用的基地址
	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;	
}

获取 LCD 参数

LCD 驱动程序给 APP 提供 2 类参数：可变的参数 fb_var_screeninfo、固定的参数 fb_fix_screeninfo。编写应用程序时主要关心可变参数，它的结构体定义如下(#include <linux/fb.h>)：

fb_bitfield结构体表示一个颜色的信息

映射 Framebuffer

要映射一块内存，需要知道它的地址──这由驱动程序来设置，需要知道它的大小──这由应用程序决定。代码如下：

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;
}

• PROT_READ |PROT_WRITE 表示该区域可读、可写；
• MAP_SHARED 表示该区域是共享的，APP写入数据时，会直达驱动程序

描点函数

能够在 LCD 上描绘指定像素后，就可以写字、画图，描点函数是基础。代码如下：

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;
	//如果bpp是16位就需要转换
	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;
			//红色取5位，绿色取6位，蓝色取5位
			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;
		}
	}
}

颜色转换

测试

步骤：

1. 交叉编译
2. 通过NFS网络文件系统传输到开发板
3. 关闭开发板GUI：systemctl stop myir
4. 运行测试程序
5. 恢复开发板GUI：systemctl start myir

开发板有fb-test测试程序可以使用

fb-test -r //lcd 显示红色
fb-test//lcd 显示多种颜色：

参考博文：STM32mp157开发板LCD 显示测试&触摸屏测试