[笔记]：简单的globalmem字符设备驱动移植过程

总算成功的把《Linux设备驱动开发详解》中简单的字符设备驱动程序globalmem移植到虚拟机上的Ubuntu10.10上了，下面记录一下移植的过程和遇到的问题。

我在虚拟机上安装了Ubuntu10.10系统，内核是2.6.35版本，内存512M。采用的Vim工具编程。

1.在移植globalmem驱动程序之前，我先更新了一下Ubuntu10.10的内核（完全是出于学习内核的目的，移植驱动不需要先更新内核版本）。

（1）首先在www.kernel.org网站上下载了Linux2.6.36的内核。然后再/home/username/目录（用户的家目录）下解压linux-2.6.36.tar.bz2，命令是：tar xvfj linux-2.6.36.tar.bz2。
（2）进入解压后的目录中，首先执行make clean和make mrproper命令（新下载的内核可以不必执行此命令）。
（3）然后执行make menuconfig配置内核选项，获得.config文件。由于make menuconfig命令依赖libncurse库，必须先执行命令sudo apt-get install libncurse，下载安装libncurse库文件。
（4）配置好内核选项之后保存退出，在源码目录(例如：/home/username/linux_src)中执行make bzImage命令，编译内核。过程有点长，需要耐心等待。
（5）然后再执行命令sudo make modules，编译模块。过程也有点长，需要耐心~~~。
（6）编译完内核和模块之后，执行命令：sudo make modules_install，安装模块。
（7）然后执行命令：make install，完成内核的安装。
（8）最后更新一下grub文件，采用命令：sudo update grub。重启之后查看内核的版本号为2.6.36，表示内核更新成功。查看内核版本的命令是：uname -r。

2.更新完内核之后，开始移植globalmem字符驱动程序。

（1）编写好驱动代码，可以参考《Linux设备驱动开发详解》字符设备驱动一节的内容（内核版本2.6时，代码需要修改才能编译通过）。也可以看看我提供的globalmem.c文件（见文件末尾）。

值得注意的是，由于内核版本是2.6版的，fileoperation结构中的.ioctl发生变化，需要改成.unlocked_ioctl。否则在编译成模块globalmem.ko的时候，编译器会报错：ioctl找不到。

在文件头添加两个头文件：#include <linux/slab.h>和#include <linux/ioctl.h>。否则，编译报错：找不到kmalloc和kfree函数。

（2）编译模块globalmem.ko。编写Makefile文件：obj-m:=globalmem.o。然后在命令行中执行命令：make -C /lib/modules/2.6.36/bulid M=/home/username/globalmem/ modules。说明，/lib/modules/2.6.36/bulid为更新内核之后，安装得到的模块及代码，M=/home/username/globalmem/为globalmem.c文件所在目录。

（3）在/home/username/globalmem/目录下执行命令：sudo insmod globalmem.ko，安装模块到内核之中。

（4）执行命令：sudo mknod /dev/globalmem c 301 0，创建一个设备节点/dev/globalmem，其中301为主设备号。

（5）用命令lsmod和cat /proc/devices/查看模块和设备节点的信息。

（6）可以在命令行中测试字符驱动程序。命令如下：
#echo ’hello world‘ > /dev/globalmem  //写字符设备
#cat /dev/globalmem                   //读字符设备

3.为了进一步测试globalmem字符设备驱动程序的功能，需要编写一个测试程序test_globalmem.c文件（见文件末尾）。globalmem字符设备驱动程序中包含了open，release，ioctl，read，write，llseek函数。它们是字符设备驱动与内核的接口，是用户空间对Linux进行系统调用最终的落实者（例如：在用户程序中调用Linux的open，read，write，ioctl等系统调用时，最终会落实到驱动程序中对应编写的open，read，write，ioctl函数中）。想通了这些，测试程序就很容易编写了。具体代码可以见我提供的test_globalmem.c文件。

小结：这是第一次成功的移植一个简单的字符驱动程序，虽然书上看着很简单的问题，但是等自己实际动手编写和移植的过程中，往往不是那么容易，会遇到各种各样的问题。遇到问题了可以到网上搜搜，同时要自己多思考多尝试，当问题解决的时候你也就又进步了一点点。当困扰很久的问题被自己想通和解决之后，那种豁然开朗的感觉会让自己的心里多多少少会有一点点成就感，同时又有了坚持下去的动力~~

 

 

附件1：globalmem.c

 

#include <linux/module.h>
#include <linux/types.h>
#include <linux/fs.h>
#include <linux/errno.h>
#include <linux/mm.h>
#include <linux/sched.h>
#include <linux/init.h>
#include <linux/cdev.h>
#include <asm/io.h>
#include <asm/system.h>
#include <asm/uaccess.h>
#include <linux/slab.h>  
#include <linux/ioctl.h>

#define GLOBALMEM_SIZE 0x1000 
#define MEM_CLEAR 0x01
#define GLOBALMEM_MAJOR 301

static int globalmem_major = GLOBALMEM_MAJOR;

struct globalmem_dev
{
	struct cdev cdev;
	unsigned char mem[GLOBALMEM_SIZE];
};


struct globalmem_dev *globalmem_devp;


int globalmem_open(struct inode *inode, struct file *filp)
{
	filp->private_data = globalmem_devp;
	return 0;
}


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


static int globalmem_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
	struct globalmem_dev *dev = filp->private_data;

	switch(cmd)
	{
		case MEM_CLEAR:
			memset(dev->mem, 0, GLOBALMEM_SIZE);
			printk(KERN_INFO "globalmem is set zero\n");
			break;

		default:
			return -EINVAL;
	}
	return 0;
}


static ssize_t globalmem_read(struct file *filp, char __user *buf, size_t size, loff_t *ppos)
{
	unsigned long p = *ppos;
	unsigned int count = size;
	int ret = 0;
	struct globalmem_dev *dev = filp->private_data;

	if(p >= GLOBALMEM_SIZE)
	{
		return count ? -ENXIO : 0;
	}
	if(count > GLOBALMEM_SIZE - p)
	{
		count = GLOBALMEM_SIZE - p;
	}

	if(copy_to_user(buf, (void*)(dev->mem + p), count))
	{
		ret = -EFAULT;
	}
	else
	{
		*ppos += count;
		ret = count;
		printk(KERN_INFO "read %d bytes form %ld\n", count, p);
	}

	return ret;
}


static ssize_t globalmem_write(struct file *filp, const char __user *buf, size_t size, loff_t *ppos)
{
	unsigned long p = *ppos;
	unsigned int count = size;
	int ret = 0;
	struct globalmem_dev *dev = filp->private_data;

	if(p >= GLOBALMEM_SIZE)
	{
		return count ? -ENXIO : 0;
	}
	if(count > GLOBALMEM_SIZE - p)
	{
		count = GLOBALMEM_SIZE - p;
	}

	if(copy_from_user(dev->mem, buf, count))
	{
		ret = -EFAULT;
	}
	else
	{
		*ppos += count;
		ret = count;
		printk(KERN_INFO "write %d bytes from %ld\n", count, p);
	}

	return ret;
}


static loff_t globalmem_llseek(struct file *filp, loff_t offset, int orig)
{
	loff_t ret = 0;
	
	switch(orig)
	{
		case 0:
			if(offset < 0)
			{
				ret = -EINVAL;
				break;
			}
			if((unsigned int)offset > GLOBALMEM_SIZE)
			{
				ret = -EINVAL;
				break;
			}
			filp->f_pos = (unsigned int)offset;
			ret = filp->f_pos;
			break;
		case 1:
			if((filp->f_pos + offset) > GLOBALMEM_SIZE)
			{
				ret = -EINVAL;
				break;
			}
			if((filp->f_pos + offset) < 0)
			{
				ret = -EINVAL;
				break;
			}
			filp->f_pos += offset;
			ret = filp->f_pos;
			break;
		default:
			ret = -EINVAL;
			break;
	}

	return ret;
}


static const struct file_operations globalmem_fops = 
{
	.owner = THIS_MODULE,
	.llseek = globalmem_llseek,
	.read = globalmem_read,
	.write = globalmem_write,
	.unlocked_ioctl = globalmem_ioctl,
	//.ioctl = globalmem_ioctl,
	.open = globalmem_open,
	.release = globalmem_release,
};


static void globalmem_setup_cdev(struct globalmem_dev *dev, int index)
{
	int err;
	int devno = MKDEV(globalmem_major, index);

	cdev_init(&dev->cdev, &globalmem_fops);
	dev->cdev.owner = THIS_MODULE;
	dev->cdev.ops = &globalmem_fops;
	err = cdev_add(&dev->cdev, devno, 1);
	if(err)
	{
		printk(KERN_NOTICE "Error %d adding LED%d\n", err, index);
	}
}


int globalmem_init(void)
{
	int result = 0;
	dev_t devno = MKDEV(globalmem_major, 0);

	if(globalmem_major)
	{
		result = register_chrdev_region(devno, 1, "globalmem");
	}
	else
	{
		result = alloc_chrdev_region(&devno, 0, 1, "globalmem");
		globalmem_major = MAJOR(devno); 
	}
	if(result < 0)
	{
		return result;
	}

	globalmem_devp = kmalloc(sizeof(struct globalmem_dev), GFP_KERNEL);
	if(!globalmem_devp)
	{
		result = -ENOMEM;
		goto fail_malloc;
	}
	memset(globalmem_devp, 0, sizeof(struct globalmem_dev));

	globalmem_setup_cdev(globalmem_devp, 0);
	return 0;

fail_malloc:
	unregister_chrdev_region(devno, 1);
	return result;
}


void globalmem_exit(void)
{
	cdev_del(&globalmem_devp->cdev);
	kfree(globalmem_devp);
	unregister_chrdev_region(MKDEV(globalmem_major, 0), 1);
}

MODULE_LICENSE("Dual BSD/GPL");
module_param(globalmem_major, int, S_IRUGO);
module_init(globalmem_init);
module_exit(globalmem_exit);

 

 

附件2：test_globalmem.c

#include <sys/types.h>
#include <sys/stat.h>
#include <sys/ioctl.h>
#include <stdio.h>
#include <fcntl.h>
#include <string.h>

int main()
{
	int fd;
	char num[128];
	char str[128] = "hello world\n";

	fd = open("/dev/globalmem", O_RDWR, S_IRUSR | S_IWUSR);
	if(fd == -1)
	{
		printf("open /dev/globalmem failure\n");
		return -1;
	}
/*
	read(fd, num, 128);
	printf("read the string:\n %s\n", num);
*/
	ioctl(fd, 0x01, 0);
	printf("clean /dev/globalmem\n");

	write(fd, str, strlen(str));
	printf("write the string into /dev/globalmem\n");
	
	return 0;
}