目录
- 1. Framebuffer概念
- 2. LCD操作原理
- 3. 源码分析
- 3.1 打开设备
- 3.2 获取LCD参数
- 3.3 映射Framebuffer
- 3.4 描点实现
基于韦东山IMX6ULL开发板学习
参考教程:
韦东山老师教程
1. Framebuffer概念
Framebuffer,可以译作“帧缓冲”,有时简称为fbdrv,是一种在Linux系统中广泛使用的图形设备接口。
Framebuffer是一个视频输出设备,它从包含完整帧数据的一个内存缓冲区中驱动视频显示设备。简而言之,它是Linux内核为显示设备提供的一个接口,将显存抽象化后,允许上层应用程序在图形模式下直接对显示缓冲区进行读写操作。这种机制屏蔽了图像硬件的底层差异,使得上层应用不必关心物理显存的具体位置和存放方式。
Framebuffer 通常由以下几个部分组成:
- Framebuffer 设备文件:在 Linux 系统中,Framebuffer 设备通常以
/dev/fb0
、/dev/fb1
等形式存在。应用程序可以通过这些设备文件来访问和控制 framebuffer。 - Framebuffer 内存:Framebuffer 内存是一块连续的物理内存区域,用于存储像素数据。每个像素在内存中占用一定的位数(例如 8 位、16 位、24 位或 32 位),具体取决于显示模式。
- 显示控制器:负责将 framebuffer 中的数据传输到显示器上。显示控制器可以是硬件的一部分,也可以是软件模拟的。
2. LCD操作原理
在Linux系统中通过Framebuffer驱动程序来控制LCD。Frame是帧的意思,buffer是缓冲的意思,这意味着Framebuffer就是一块内存,里面保存着一帧图像。Framebuffer中保存着一帧图像的每一个像素颜色值,假设LCD的分辨率是1024x768,每一个像素的颜色用32位来表示,那么Framebuffer的大小就是:1024x768x32/8=3145728字节。
LCD操作原理:
- 驱动程序设置好 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+x*bpp/8
颜色是用RGB三原色(红、绿、蓝)来表示的,在不同的BPP格式中,用不同的位来分别表示R、G、B,一般有3中表示颜色的方式:
- 对于32BPP,一般只设置其中的低24位,高8位表示透明度,一般的LCD都不支持。
- 对于24BPP,硬件上为了方便处理,在Framebuffer中也是用32位来表示,效果跟32BPP是一样的。
- 对于16BPP,常用的是RGB565;很少的场合会用到RGB555,这可以通过ioctl读取驱动程序中的RGB位偏移来确定使用哪一种格式。
3. 源码分析
在IM6ULL开发板上操作LCD像素点的源码:
#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;
}
操作LCD的步骤大致分为:
- 打开设备
- 获取LCD参数
- 映射Framebuffer
- 描点
3.1 打开设备
在 Linux 系统中,Framebuffer 设备通常以 /dev/fb0
、/dev/fb1
等形式存在。因此打开/dev/fb0
设备:
73 fd_fb = open("/dev/fb0", O_RDWR);
74 if (fd_fb < 0)
75 {
76 printf("can't open /dev/fb0\n");
77 return -1;
78 }
open
函数
函数原型:
int open(const char *pathname, int flags);
int open(const char *pathname, int flags, mode_t mode);
参数说明:
- pathname:表示打开文件的路径
- flags:表示打开文件的方式,常用的有以下6种方式:
- O_RDWR表示可读可写方式打开;
- O_RDONLY表示只读方式打开;
- O_WRONLY表示只写方式打开;
- O_APPEND表示如果这个文件中本来是有内容的,则新写入的内容会接续到原来内容的后面;
- O_TRUNC表示如果这个文件中本来是有内容的,则原来的内容会被丢弃,截断;
- O_CREAT表示当前打开文件不存在,我们创建它并打开它,通常与O_EXCL结合使用,当没有文件时创建文件,有这个文件时会报错提醒我们;
- mode:表示创建文件的权限,只有在flags使用了O_CREAT时才有效,否则忽略。
- 返回值:打开成功返回文件描述符,失败返回-1。
3.2 获取LCD参数
参考fb.h
文件中,Framebuffer主要定义了2类参数:可变的参数fb_var_screeninfo
、固定的参数fb_fix_screeninfo
。编写应用程序时主要关心可变参数,可以用FBIOGET_VSCREENINFO
来读出这些信息,同样也可以使用FBIOPUT_VSCREENINFO
来设置或调整这些参数,一般很少会设置或调整:
对于固定的参数fb_fix_screeninfo
,在应用编程中很少用到,可以使用ioctl
的FBIOGET_FSCREENINFO
来读出这些信息:
获取fb_var_screeninfo信息:
12 static struct fb_var_screeninfo var; /* Current var */
……
79 if (ioctl(fd_fb, FBIOGET_VSCREENINFO, &var))
80 {
81 printf("can't get var\n");
82 return -1;
83 }
将获取到的fb_var_screeninfo
信息保存到var
变量中:
ioctl
函数
函数原型:
int ioctl(int fd, unsigned long request, ...);
参数说明:
- fd:表示文件描述符;
- request:表示与驱动程序交互的命令,用不同的命令控制驱动程序输出我们需要的数据;
- …:表示可变参数arg,根据request命令,设备驱动程序返回输出的数据。
- 返回值:打开成功返回文件描述符,失败返回-1。
ioctl的作用非常强大、灵活。不同的驱动程序内部会实现不同的ioctl,APP可以使用各种ioctl跟驱动程序交互:可以传数据给驱动程序,也可以从驱动程序中读出数据。
3.3 映射Framebuffer
要映射一块内存,需要知道它的地址──这由驱动程序来设置,需要知道它的大小──这由应用程序决定:
85 line_width = var.xres * var.bits_per_pixel / 8; /* 一行有多少个字节(一行宽度) */
86 pixel_width = var.bits_per_pixel / 8; /* 一个像素点占多少个字节(一个像素点宽度) */
87 screen_size = var.xres * var.yres * var.bits_per_pixel / 8; /* 整个屏幕占多少字节 */
88 fb_base = (unsigned char *)mmap(NULL , screen_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd_fb, 0);
89 if (fb_base == (unsigned char *)-1)
90 {
91 printf("can't mmap\n");
92 return -1;
93 }
mmap
函数
函数原型:
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表示对映射区域的操作会产生一个映射文件的复制,对此区域的任何修改都不会写回原来的文件内容中。
- offset:文件或设备中的偏移量,映射区域将从该偏移量开始。偏移量必须是页面大小的整数倍。
- 返回值:若成功映射,将返回指向映射的区域的指针,失败将返回-1。
3.4 描点实现
在LCD上描绘指定像素后,就可以写字、画图,描点函数是基础:
28 void lcd_put_pixel(int x, int y, unsigned int color) /* 传入的color表示颜色,它的格式永远是0x00RRGGBB,即RGB888。当LCD是16bpp时,要把color变量中的R、G、B抽出来再合并成RGB565格式。 */
29 {
30 unsigned char *pen_8 = fb_base+y*line_width+x*pixel_width; /* 计算(x,y)坐标上像素对应的Framebuffer地址。 */
31 unsigned short *pen_16;
32 unsigned int *pen_32;
33
34 unsigned int red, green, blue;
35
36 pen_16 = (unsigned short *)pen_8;
37 pen_32 = (unsigned int *)pen_8;
38
39 switch (var.bits_per_pixel)
40 {
41 case 8:
42 {
43 *pen_8 = color; /* 对于8bpp,color就不再表示RBG三原色了,这涉及调色板的概念,color是调色板的值。 */
44 break;
45 }
46 case 16:
47 {
48 /* 565 */
49 red = (color >> 16) & 0xff; /* 先从color变量中把R、G、B抽出来。 */
50 green = (color >> 8) & 0xff;
51 blue = (color >> 0) & 0xff;
52 color = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3); /* 把red、green、blue这三种8位颜色值,根据RGB565的格式,只保留red中的高5位、green中的高6位、blue中的高5位,组合成一个新的16位颜色值。 */
53 *pen_16 = color; /* 把新的16位颜色值写入Framebuffer。 */
54 break;
55 }
56 case 32:
57 {
58 *pen_32 = color; /* 对于32bpp,颜色格式跟color参数一致,可以直接写入Framebuffer。 */
59 break;
60 }
61 default:
62 {
63 printf("can't surport %dbpp\n",var.bits_per_pixel);
64 break;
65 }
66 }
67 }
最终在main函数中调用描点函数画一条红色的线:
95 /* 清屏: 全部设为白色 */
96 memset(fbmem, 0xff, screen_size);
97
98 /* 随便设置出 100 个为红色 */
99 for (i = 0; i < 100; i++)
100 lcd_put_pixel(var.xres/2+i, var.yres/2, 0xFF0000);
其中白色是0xFFFFFF:
红色是0xFF0000:
使用工具链交叉编译后生成可执行程序拷贝到IMX6ULL开发板后运行效果:
100个红色像素点生成的1条红线。