荔枝派Zero(全志V3S)驱动开发之RGB LCD屏幕显示bmp图片


前言

  • 了解 framebuffer 字符设备
  • 了解 bmp图片格式
  • 通过操作 /dev/fb0 字符设备来实现在 RGB LCD 屏幕上显示 bmp 图片。

一、如何在 linux 下驱动 LCD

显示设备例如 LCD,在 Linux 中用 Framebuffer 来表征, Framebuffer 翻译过来就是帧缓冲,简称 fb,在 /dev 目录下显示设备一般表示成这样:/dev/fbn,应用程序通过访问这个设备来访问 LCD,实际上应用程序通过操作显存来操作显示设备,显存由驱动程序设置。说白了,我们要在 linux 下操作屏幕进行显示那么直接对 /dev/fbn 进行操作即可

1、什么是 Framebuffer 设备

Framebuffer 是用一个视频输出设备从包含完整的帧数据的一个内存缓冲区中来驱动一个视频显示设备。也就是说 Framebuffer 是一块内存保存着一帧的图像,向这块内存写入数据就相当于向屏幕中写入数据,如果使用 32 位的数据来表示一个像素点(使用 BBP 表示),假设屏幕的显示频分辨率为 1920x1080,那么 Framebuffer 所需要的内存为 1920x1080x32/8=8,294,400 字节约等于 7.9M。简单来说 Framebuffer 把屏幕上的每个点映射成一段线性内存空间,程序可以简单的改变这段内存的值来改变屏幕上某一点的颜色。Framebuffer 子系统为用户空间操作显示设备提供了统一的接口,屏蔽了底层硬件之间的差异,用户只需要操作一块内存缓冲区即可把需要的图像显示到 LCD 设备上。

2、如何确保 Framebuffer 设备已存在

官方的 Linux 内核默认已经开启了 LCD 驱动。
在这里插入图片描述
因此在系统下我们是可以看到 /dev/fb0 这样一个设备,如图:
在这里插入图片描述
/dev/fb0 就是 LCD 对应的设备文件,/dev/fb0 是个字符设备,因此肯定有file_operations 操作集,fb 的 file_operations 操作集定义在 drivers/video/fbdev/core/fbmem.c 文件中,如下所示:

static const struct file_operations fb_fops = {
    .owner =    THIS_MODULE,
    .read =     fb_read,
    .write =    fb_write,
    .unlocked_ioctl = fb_ioctl,
#ifdef CONFIG_COMPAT
    .compat_ioctl = fb_compat_ioctl,
#endif
    .mmap =     fb_mmap,
    .open =     fb_open,
    .release =  fb_release,
#if defined(HAVE_ARCH_FB_UNMAPPED_AREA) || \
    (defined(CONFIG_FB_PROVIDE_GET_FB_UNMAPPED_AREA) && \
     !defined(CONFIG_MMU))
    .get_unmapped_area = get_fb_unmapped_area,
#endif
#ifdef CONFIG_FB_DEFERRED_IO
    .fsync =    fb_deferred_io_fsync,
#endif
    .llseek =   default_llseek,
};

3、Frame_buffer 设备结构体

<1>、fb_info 详解

Linux 中使用 fb_info 结构体来表示 Framebuffer 设备,其内容如下:

struct fb_info {
	atomic_t count;
	int node;
	int flags;
	struct mutex lock; /* 互斥锁 */
	struct mutex mm_lock; /* 互斥锁,用于 fb_mmap 和 smem_*域*/
	struct fb_var_screeninfo var; /* 当前可变参数 */
	struct fb_fix_screeninfo fix; /* 当前固定参数 */
	struct fb_monspecs monspecs; /* 当前显示器特性 */
	struct work_struct queue; /* 帧缓冲事件队列 */
	struct fb_pixmap pixmap; /* 图像硬件映射 */
	struct fb_pixmap sprite; /* 光标硬件映射 */
	struct fb_cmap cmap; /* 当前调色板 */
	struct list_head modelist; /* 当前模式列表 */
	struct fb_videomode *mode; /* 当前视频模式 */
	#ifdef CONFIG_FB_BACKLIGHT /* 如果 LCD 支持背光的话 */
	/* assigned backlight device */
	/* set before framebuffer registration,
	remove after unregister */
	struct backlight_device *bl_dev;  /* 背光设备 */
	/* Backlight level curve */
	struct mutex bl_curve_mutex;
	u8 bl_curve[FB_BACKLIGHT_LEVELS];
	#endif
	......
	struct fb_ops *fbops; /* 帧缓冲操作函数集 */
	struct device *device; /* 父设备 */
	struct device *dev; /* 当前 fb 设备 */
	int class_flag; /* 私有 sysfs 标志 */
	......
	char __iomem *screen_base; /* 虚拟内存基地址(屏幕显存) */
	unsigned long screen_size; /* 虚拟内存大小(屏幕显存大小) */
	void *pseudo_palette; /* 伪 16 位调色板 */
	......
};

其中最重要成员有:var,fix,fbops(LCD设备的操作集合),screen_base(显存基地址),screen_size(显存大小),pseudo_palette。

struct fb_fix_screeninfo 和 struct fb_var_screeninfo 都定义在系统的 /usr/include/linux/fb.h 文件内。下面分别结构体定义、结构体字段说明两部分来详细解释这两个结构体。

<2>、struct fb_fix_screeninfo 详解

struct fb_fix_screeninfo 主要用于获取 FrameBuffer 的固定信息, 这些信息无法在应用层被更改,只能通过 ioctl 函数使用 FBIOGET_FSCREENINFO 去获取。

①、struct fb_fix_screeninfo 定义:

struct fb_fix_screeninfo {
	char id[16];			/* identification string eg "TT Builtin" */
	unsigned long smem_start;	/* Start of frame buffer mem (physical address) */
	__u32 smem_len;			/* Length of frame buffer mem	*/
	__u32 type;				/* see FB_TYPE_*				*/
	__u32 type_aux;			/* Interleave for interleaved Planes */
	__u32 visual;			/* see FB_VISUAL_*				*/ 
	__u16 xpanstep;			/* zero if no hardware panning  */
	__u16 ypanstep;			/* zero if no hardware panning  */
	__u16 ywrapstep;		/* zero if no hardware ywrap    */
	__u32 line_length;		/* length of a line in bytes    */
	unsigned long mmio_start;/* Start of Memory Mapped I/O (physical address) */
	__u32 mmio_len;			/* Length of Memory Mapped I/O  */
	__u32 accel;			/* Indicate to driver which*//*specific chip/card we have	*/
	__u16 capabilities;		/* see FB_CAP_*					*/
	__u16 reserved[2];		/* Reserved for future compatibility */
};

②、struct fb_fix_screeninfo 字段说明:
表格中提到的宏如 FB_TYPE_PACKED_PIXELS、FB_VISUAL_TRUECOLOR、FB_ACCEL_NONE 请查看 /usr/include/linux/fb.h 的相关定义。

字段名称描述附加说明
id设备驱动名称
smem_start显存起始物理地址
smem_len显存大小
type显卡类型一般为 FB_TYPE_PACKED_PIXELS(值为0,表示像素值紧密排 列),查看fb.h的 FB_TYPE_*
type_aux附加类型查看fb.h的 FB_AUX_TEXT_MDA
visual色彩模式一般为 FB_VISUAL_TRUECOLOR(值为2,真彩色)
xpanstep支持水平方向上的 PAN 显示:
0:不支持
非 0:支持,此时该值用于表示在水平方向上每步进的像素值
默认为 1
ypanstep支持垂直方向上的 PAN 显示:
0:不支持。
非 0:支持,此时该值用于表示在垂直方向上每步进的像素值。
默认为 1
ywrapstep该方式类似于 ypanstep,不同之处在于:当其显示到底部时,能回到显存的开始处进行显示。默认为 0
line_length每行字节数
mmio_start显存映射 I/O 首地址默认为不支持
mmio_len显存映射 I/O 长度默认为不支持
accel显示所支持的硬件加速设备默认为 FB_ACCEL_NONE

<3>、struct fb_var_screeninfo 详解

struct fb_var_screeninfo 主要用于获取和设置 FrameBuffer 的可变屏幕信息,包括分辨率、像素位深、像素格式等。这些信息可以通过ioctl函数使用 FBIOGET_VSCREENINFO 获取,也可以通过 FBIOPUT_VSCREENINFO 修改。这些参数都是可以在设备树中进行修改的,具体的参数是多少要根据 LCD 的数据手册来进行修改,LCD 的驱动程序会从设备树中读取这些参数。

①、struct fb_var_screeninfo 定义:

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			*/
	__u32 grayscale;		/* 0 = color, 1 = grayscale,*//* >1 = FOURCC*/
	
	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 	*/
	__u32 activate;			/* see 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) */
	__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_*		*/
	__u32 vmode;			/* see FB_VMODE_*		*/
	__u32 rotate;			/* angle we rotate counter clockwise */
	__u32 reserved[5];		/* Reserved for future compatibility */
};

②、struct fb_var_screeninfo 字段说明:
表格中提到的宏和结构体请查看 /usr/include/linux/fb.h 的相关定义。

字段名称描述其他
xres可见屏幕宽度(每行像素数)分辨率
yres可见屏幕高度(每列像素数)分辨率
xres_virtual虚拟屏幕宽度(显存中图像宽度)每行像素数,一般会设置其与xres相等
yres_virtual虚拟屏幕高度(显存中图像高度),每像素数每列像素数,一般会设置其与yres相等虚拟屏幕
xoffset虚拟到可见(实际)之间的行方向偏移
yoffset虚拟到可见(实际)之间的列方向偏移
bits_per_pixel每个像素有多少bit这个值除以8,表示每个像素的字节数
grayscale灰度级默认为 0
red、green、blue、transp颜色分量中红色、绿色、蓝色、透明度的位域信息struct fb_bitfield{
__u32 offset;//颜色分量起始比特位
__u32 length;//颜色分量所占比特长度。
__u32 msb_right;//右边的比特是否为最高有效位
nonstd是否为标准像素格式
activate设置生效的时刻默认为 FB_ACTIVATE_NOW
height、width屏幕高、宽,单位为 mm默认为不支持(-1)
accel_flags加速标志默认不支持,查看fb_info.flags
pixclock显示一个点需要的时间,单位为ns
left_margin、right_margin、hsync_len分别是左消隐信号、右消隐信号、水平同步时长,这三个值之和等于水平回扫时间,单位为点时钟
upper_margin、lower_margin、vsync_len分别是上消隐信号、下消隐信号、垂直同步时长,这三个值之和等于垂直回扫时间,单位为点时钟
sync同步信号方式查看宏 FB_SYNC_*
vmodevmode查看宏 FB_VMODE_*
rotate顺时针旋转的角度
pixclock显示一个点需要的时间,单位为ns

4、设备树中有关 framebuffer 的信息

sun8i-v3s.dtsi
在这里插入图片描述
在这里插入图片描述

二、bmp 图片格式

1、bmp 文件组成部分

一个 bmp 文件由四部分组成:
在这里插入图片描述

2、代码表现形式

对应的代码表现形式如下:

//BMP文件头(14字节)
typedef struct
{
    char cfType[2];  //文件类型,"BM"(0x4D42)
    int  cfSize;     //文件大小(字节)
    int  cfReserved; //保留,值为0
    int  cfoffBits;  //数据区相对于文件头的偏移量(字节)
}__attribute__((packed)) BITMAPFILEHEADER;
//__attribute__((packed))的作用是告诉编译器取消结构在编译过程中的优化对齐

//位图信息头(40字节)
typedef struct
{
    char ciSize[4];          //BITMAPFILEHEADER所占的字节数
    int  ciWidth;            //宽度
    int  ciHeight;           //高度
    char ciPlanes[2];        //目标设备的位平面数,值为1
    int  ciBitCount;         //每个像素的位数
    char ciCompress[4];      //压缩说明
    char ciSizeImage[4];     //用字节表示的图像大小,该数据必须是4的倍数
    char ciXPelsPerMeter[4]; //目标设备的水平像素数/米
    char ciYPelsPerMeter[4]; //目标设备的垂直像素数/米
    char ciClrUsed[4];       //位图使用调色板的颜色数
    char ciClrImportant[4];  //指定重要的颜色数,当该域的值等于颜色数时(或者等于0时),表示所有颜色都一样重要
}__attribute__((packed)) BITMAPINFOHEADER;

3、bmp 图片的编码方式(存储格式)

54头字节,每个像素占3字节BGR顺序,上下颠倒存储,bmp图片的宽度占用的字节数如果不能被4整除,window系统会给每一行填充垃圾数凑够4字节整除。

图片的编码方式(存储格式)如下图:
在这里插入图片描述

bmp 图片的编码方式(存储格式)

4、bmp 图片数据与 LCD 屏幕对应的方式

bmp 图片数据与 LCD 屏幕对应的方式
在这里插入图片描述

bmp 图片数据与 LCD 屏幕对应的方式

由上述可以看到 bmp 图片数据和 LCD 屏幕所对应的关系是 第1行 -> 倒数第1行、第2行 -> 倒数第2行,以此类推

三、操作步骤

在应用层中,用户可以将 fb 设备看成是显存的一个映像,将其映射到进程空间后,就可以直接进行读写操作,写操作会直接反映在屏幕上。

在应用程序中,操作 /dev/fbn 的一般步骤如下:

  • 打开 /dev/fbn 设备文件;
  • 用 ioctl() 操作取得当前显示屏幕的参数,如屏幕分辨率、每个像素点的比特数。根据屏幕参数可计算屏幕缓冲区的大小;
  • 用 mmap() 函数,将屏幕缓冲区映射到用户空间;
  • 映射后就可以直接读/写屏幕缓冲区,进行绘图和图片显示;
  • 使用完帧缓冲设备后需要将其释放;
  • 关闭文件。

四、程序核心源码

以下为在 800 * 480 分辨率的 RGB LCD 屏幕上显示图片的 c 程序及 Makefile 文件

程序有读取 LCD 屏幕相关信息以及校验是否为 bmp 图片,具有良好的容错处理

完整代码文末自取
imageshow.c

int main(int argc, char **argv)
{
    char img_name[64];

    if (argc != 4) {
        printf("please input 4 args:\n");
        printf("./imageshow xx.bmp xpos ypos\n");
        return 0;
    }
    int x = atoi(argv[2]); // atoi()将字符型转换成整形
    int y = atoi(argv[3]);

    snprintf(img_name, sizeof(img_name), "%s", argv[1]);
    printf("img_name = %s\n", img_name);

    /************************第1步:打开设备**************************/
    fb_info.fbfd = open("/dev/fb0", O_RDWR);
    if (!fb_info.fbfd) {
        printf("Error: cannot open framebuffer device(/dev/fb0).\n");
        return -1;
    }
    show_picture(img_name, x, y);

    /***********************第六步:关闭文件************************/
    close(fb_info.fbfd);

    return 0;
}

Makefile

src = $(wildcard *.c)
obj = $(patsubst %.c, %.o, $(src))

CC=arm-linux-gnueabihf-gcc 
LD=arm-linux-gnueabihf-ld

ALL:imageshow

imageshow.o : imageshow.c
	$(CROSS_COMPILE)arm-linux-gnueabihf-gcc -c $< -o $@

clean:
	-rm -rf $(obj) imageshow

五、编译

make 后将 testshow 文件以及四张 bmp 图片通过 tftp 命令上传到板子上
在这里插入图片描述
其中 1.bmp 和 2.bmp 分辨率为 800 * 480,3.bmp 和 4.bmp 分辨率为 480 *272

六、效果展示

1、风景照(800 * 480,从(0,0)开始显示)

./testshow 1.bmp 0 0

在这里插入图片描述
在这里插入图片描述
2、马里奥(800 * 480,从(0,0)开始显示)

./testshow 2.bmp 0 0

在这里插入图片描述
在这里插入图片描述
2、宇航员(480* 272,从(0,0)开始显示)

./testshow 3.bmp 0 0

在这里插入图片描述
在这里插入图片描述
2、女孩和白狐(480* 272,从(100,100)开始显示)

./testshow 4.bmp 100 100

在这里插入图片描述
在这里插入图片描述

七、资源自取

链接:荔枝派Zero(全志V3S)驱动开发之RGB LCD屏幕显示bmp图片
在这里插入图片描述


我的qq:2442391036,欢迎交流!


  • 2
    点赞
  • 15
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
荔枝Zero是一款基于Allwinner H2+芯片的开发板,它支持串口通信。要使用串口功能,你需要安装相应的串口驱动程序。以下是安装串口驱动的步骤: 1. 首先,连接荔枝Zero到电脑上。你可以使用Micro USB线缆将其连接到电脑的USB接口。 2. 打开终端或命令提示符窗口,并执行以下命令以确定荔枝Zero在电脑上的串口设备名称: ``` ls /dev/tty* ``` 在输出中查找类似于"/dev/ttyUSB0"或"/dev/ttyACM0"的设备名称。这是荔枝Zero的串口设备名称。 3. 安装串口通信工具minicom。在终端或命令提示符窗口中执行以下命令: ``` sudo apt-get update sudo apt-get install minicom ``` 4. 打开minicom配置文件。在终端或命令提示符窗口中执行以下命令: ``` sudo minicom -s ``` 5. 在minicom配置界面中,选择"Serial port setup",然后按回车键。 6. 在串口设备设置中,将串口设备名称设置为上一步中找到的荔枝Zero的串口设备名称。例如,如果设备名称为"/dev/ttyUSB0",则在该选项中输入"/dev/ttyUSB0"。 7. 设置波特率为115200,数据位为8位,停止位为1位,校验位为无。 8. 保存并退出minicom配置界面。 9. 现在,你可以使用minicom来进行串口通信了。在终端或命令提示符窗口中执行以下命令: ``` sudo minicom ``` 这将打开minicom界面,并将你连接到荔枝Zero的串口。 以上是在荔枝Zero上安装串口驱动并进行串口通信的步骤。如果你有其他问题,请随时提问。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

须尽欢~~

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值