linux[x86]字符设备驱动qemu开发环境搭建和调试

原创已于 2026-06-22 16:48:42 修改 · 326 阅读

本内容遵循CC 4.0 BY-SA版权协议

于 2026-05-08 17:12:57 首次发布

下载源码

内核：https://mirrors.edge.kernel.org/pub/linux/kernel/
本文使用的是linux-6.17
busybox：wget https://busybox.net/downloads/busybox-1.37.0.tar.bz2
目录结构如下：
├── busybox-1.37.0
├── busybox-1.37.0.tar.bz2
├── fs
├── linux-6.17
├── linux-6.17.tar.gz
└── rootfs.img

简单的字符设备驱动

在内核的如下路径下增加 mychar.c文件(drivers\char\mychar.c)，内容如下：

#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/fs.h>
#include <linux/uaccess.h>
#include <linux/device.h>

#define CHRDEVBASE_MAJOR	200
#define CHRDEVBASE_NAME		"mychar"

static struct class *mychar_class;  // 类
static struct device *mychar_dev;    // 设备

static char readbuf[100];
static char kerneldata[] = "kernel data!";

static int chrdevbase_open(struct inode *inode, struct file *filp)
{
	return 0;
}

static ssize_t chrdevbase_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
{
	int retvalue = 0;

	memcpy(readbuf, kerneldata, sizeof(kerneldata));
	retvalue = copy_to_user(buf, readbuf, cnt);
	if (retvalue == 0)
		printk("kernel read data ok!\n");
	else
		printk("kernel read data failed!\n");

	return 0;
}

static ssize_t chrdevbase_write(struct file *filp, const char __user *buf, size_t cnt, loff_t *offt)
{
	int retvalue = 0;

	retvalue = copy_from_user(readbuf, buf, cnt);
	if (retvalue == 0)
		printk("kernel write data:%s\n", readbuf);
	else
		printk("kernel write data failed!\n");

	return 0;
}

static int chrdevbase_release(struct inode *inode, struct file *filp)
{
	return 0;
}

static struct file_operations chrdevbase_fops = {
	.owner = THIS_MODULE,
	.open = chrdevbase_open,
	.read = chrdevbase_read,
	.write = chrdevbase_write,
	.release = chrdevbase_release,
};

static int __init chrdevbase_init(void)
{
	int retvalue = 0;

	/* 注册字符设备驱动 */
	retvalue = register_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME, &chrdevbase_fops);
	if (retvalue < 0) {
		printk("chrdevbase register failed\n");
		return -1;
	}

	// ------------------- 自动创建设备文件 -------------------
	// 1. 创建类
	mychar_class = class_create("mychar_class");
	if (IS_ERR(mychar_class)) {
		unregister_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME);
		return -1;
	}

	// 2. 创建设备，自动生成 /dev/mychar
	mychar_dev = device_create(mychar_class, NULL, MKDEV(CHRDEVBASE_MAJOR, 0), NULL, "mychar");
	if (IS_ERR(mychar_dev)) {
		class_destroy(mychar_class);
		unregister_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME);
		return -1;
	}

	printk("----------------------chrdevbase init!\n");
	return 0;
}

static void __exit chrdevbase_exit(void)
{
	device_destroy(mychar_class, MKDEV(CHRDEVBASE_MAJOR, 0));
	class_destroy(mychar_class);
	unregister_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME);
	printk("----------------------chrdevbase exit!\n");
}

module_init(chrdevbase_init);
module_exit(chrdevbase_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("wl");

修改当前目录下Makefile 文件中原来的

obj-y               += mem.o random.o

修改为：

obj-y               += mem.o random.o mychar.o

busybox中增加测试命令

在busybox源码中增加test_mychar.c 测试代码(busybox-1.37.0/miscutils/test_mychar.c)，内容如下：

//---------------------------- 以下是 BusyBox 自动识别关键注释 -----------------------
//applet:IF_TEST_MYCHAR(APPLET(test_mychar, BB_DIR_USR_BIN, BB_SUID_DROP))
//config:config TEST_MYCHAR
//config:   bool "test_mychar"
//config:   default y
//config:   help
//config:     my char device test command.
//kbuild:lib-$(CONFIG_TEST_MYCHAR) += test_mychar.o

//usage:#define test_mychar_trivial_usage
//usage:    ""
//usage:#define test_mychar_full_usage "\n\n"
//usage:    "test my char device\n"
//-----------------------------------------------------------------------------------


#include <string.h>
#include <stdio.h>
#include <unistd.h>
#include "busybox.h"

int test_mychar_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;

int test_mychar_main(int argc,char*argv[])
{
    int fd;
    int ret;
    char buf[100] = "test data for mychar device";
    char out[100] = { 0 };

    fd = open("/dev/mychar", O_RDWR);
    if(fd < 0){
        printf("open device 'mychar' failed\n");
        return -1;
    }
    ret = write(fd, buf, strlen(buf)+1);
    if(ret < 0) {
        printf("write to device 'mychar' failed\n");
        return -1;
    }
    printf("write ret:%d\n",ret);
    ret = read(fd, out, sizeof(out));
    if(ret < 0) {
        printf("read from device 'mychar' failed\n");
        return -1;
    }
    printf("read ret:%d,data:%s\n", ret, out);

    return 0;
}

编译内核

在内核源码根目录下执行如下命令：
make defconfig
make -j8 bzImage

编译busybox并制作文件系统

在编译busybox前需要修改下默认的配置：
make menuconfig
在 Setting 里选中 Build static (静态编译)
在 Networking Utilities 里取消 tc (流量控制模块，会编译出错-出错原因是内核演进到高版本后部分宏定义被删除了)
然后保存配置

dd if=/dev/zero of=rootfs.img bs=1M count=100
mkfs.ext4 rootfs.img

mkdir fs
sudo mount -t ext4 -o loop rootfs.img ./fs
cd busybox-1.37.0
sudo make install -j8  CONFIG_PREFIX=../fs
#为文件系统创建一些必须的文件夹
cd ../fs
sudo mkdir proc dev etc home mnt
sudo cp -r ../busybox-1.37.0/examples/bootfloppy/etc/* etc/
cd ..
sudo chmod -R 777 fs/
sudo umount fs

启动模拟器

如果启动图形界面

qemu-system-x86_64 -kernel ./linux-6.17/arch/x86_64/boot/bzImage  -hda rootfs.img  -append "root=/dev/sda"

如果不启动图形界面

qemu-system-x86_64 -kernel ./linux-6.17/arch/x86_64/boot/bzImage  -hda rootfs.img  -append "root=/dev/sda console=ttyS0" -smp 1 -nographic

启动后在shell命令行可以在/dev/看到我们新增的mychar字符设备文件，然后执行test_mychar命令可以看到对/dev/mychar设备文件读写操作的结果。
挂载sysfs查看我们的设备和驱动文件，由于我们在制作文件系统时在根目录下未创建/sys目录，所以我们将sysfs挂载到/home下：

mount -t sysfs sysfs /home

然后通过如下命令查看对应的驱动和设备信息：

ls -l /home/class/mychar_class/
ls -l /home/devices/virtual/mychar_class/mychar/
ls -l ls -l /home/dev/char/200:0/

gdb调试

内核配置

首先确定内核配置包含如下配置
CONFIG_DEBUG_INFO=y
CONFIG_DEBUG_KERNEL=y
CONFIG_GDB_SCRIPTS=y

以及取消如下配置：
Processor type and features —>
[ ] EFI stub support
[ ] Randomize the address of the kernel image (KASLR)
没记错的话是对应下面两个配置
CONFIG_EFI_STUB is not set
CONFIG_RANDOMIZE_BASE is not set
完成的配置文件参考：https://download.csdn.net/download/weiw213/92859910
重新编译内核
make -j8 bzImage
还需要编译
make scripts_gdb

gdb配置

在内核源码根目录下新建.gdbinit文件，内容如下：

python import sys; sys.path.insert(0, './scripts/gdb')
python import sys; sys.path.insert(0, '.')
source scripts/gdb/vmlinux-gdb.py
add-auto-load-safe-path ~/work/opensource/linux/linux-6.17/

调试命令

窗口1执行：

qemu-system-x86_64 -kernel ./arch/x86_64/boot/bzImage -hda ../rootfs.img -append "root=/dev/sda console=ttyS0" -s -S -smp 1 -nographic

窗口2执行：

gdb vmlinux
(gdb) target remote:1234
(gdb) b start_kernel
(gdb) c

此时应该将在断点处停下来。

标签

#linux #c语言