传统 Hal 开发指南3 —— 驱动开发

本节的任务是在内核中完结一个简略的驱动，并完结一个应用层 Native 程序来测验咱们的驱动是否正常工作。

1 编写一个简略的 Linux 内核驱动

1.1 编写驱动

Linux 驱动实际便是一个 Linux 内核模块。

首先，咱们需求理解什么是内核模块？简略来说，内核模块是一段 “固定格式” 的代码，像一个“插件”一样，linux 内核能够动态的加载并履行这段代码，也能够把这段代码编译进内核，在内核发动的时候来履行这段代码。

下面咱们写一个简略的 linux 驱动：

在内核的 drivers/char 目录中添加 hello_driver.c

#include <linux/module.h>
#include <linux/fs.h>
#include <linux/errno.h>
#include <linux/miscdevice.h>
#include <linux/kernel.h>
#include <linux/major.h>
#include <linux/mutex.h>
#include <linux/proc_fs.h>
#include <linux/seq_file.h>
#include <linux/stat.h>
#include <linux/init.h>
#include <linux/device.h>
#include <linux/tty.h>
#include <linux/kmod.h>
#include <linux/gfp.h>
/* 1. 确认主设备号                                                                 */
static int major = 0;
static char kernel_buf[1024];
static struct class *hello_class;
#define MIN(a, b) (a < b ? a : b)
/* 3. 完结对应的open/read/write等函数，填入file_operations结构体                   */
static ssize_t hello_drv_read (struct file *file, char __user *buf, size_t size, loff_t *offset)
{
	int err;
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	err = copy_to_user(buf, kernel_buf, MIN(1024, size));
	return MIN(1024, size);
}
static ssize_t hello_drv_write (struct file *file, const char __user *buf, size_t size, loff_t *offset)
{
	int err;
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	err = copy_from_user(kernel_buf, buf, MIN(1024, size));
	return MIN(1024, size);
}
static int hello_drv_open (struct inode *node, struct file *file)
{
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	return 0;
}
static int hello_drv_close (struct inode *node, struct file *file)
{
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	return 0;
}
/* 2. 界说自己的file_operations结构体                                              */
static struct file_operations hello_drv = {
	.owner	 = THIS_MODULE,
	.open    = hello_drv_open,
	.read    = hello_drv_read,
	.write   = hello_drv_write,
	.release = hello_drv_close,
};
/* 4. 把file_operations结构体告诉内核：注册驱动程序                                */
/* 5. 谁来注册驱动程序啊？得有一个进口函数：安装驱动程序时，就会去调用这个进口函数 */
static int __init hello_init(void)
{
	int err;
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	major = register_chrdev(0, "hello", &hello_drv);  /* /dev/hello */
	//提供设备信息，自动创立设备节点。
	// /dev/hello
	hello_class = class_create(THIS_MODULE, "hello_class");
	err = PTR_ERR(hello_class);
	if (IS_ERR(hello_class)) {
		printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
		unregister_chrdev(major, "hello");
		return -1;
	}
	device_create(hello_class, NULL, MKDEV(major, 0), NULL, "hello"); /* /dev/hello */
	//到这儿咱们就能够经过 /dev/hello 文件来访问咱们的驱动程序了。
	return 0;
}
/* 6. 有进口函数就应该有出口函数：卸载驱动程序时，就会去调用这个出口函数           */
static void __exit hello_exit(void)
{
	printk("%s %s line %dn", __FILE__, __FUNCTION__, __LINE__);
	device_destroy(hello_class, MKDEV(major, 0));
	class_destroy(hello_class);
	unregister_chrdev(major, "hello");
}
/* 7. 其他完善：提供设备信息，自动创立设备节点                                     */
module_init(hello_init);
module_exit(hello_exit);
MODULE_LICENSE("GPL");

1.2 将模块编译进内核

接下来咱们修正 /drivers/char/Kconfig 文件，使得咱们的 hello_driver 模块，能出现在内核的编译选项中。

在 /drivers/char 中的 Kconfig 文件中添加：

config HELLO_DRIVER_MODULE
	bool "hello driver module support"
	default y

然后在 /drivers/char 下的 Makefile 文件中添加：

obj-$(CONFIG_HELLO_DRIVER_MODULE)       += hello_driver.o

当在 make menuconfig 编译菜单中选中了 hello module support， CONFIG_HELLO_MODULE 的值是 y，没有选中值是 m（咱们界说的默许值是 y）：

• obj-y += hello_driver.o 的意思是将 hello_driver.o 编译进内核
• obj-m += hello_driver.o 的意思是文件 hello_driver.o 作为”模块”进行编译，不会编译到内核，但是会生成一个独立的 “hello_driver.ko” 文件，能够使用 insmod 指令将模块加载到内核中

最后配置内核：

cp ./arch/x86/configs/x86_64_emu_defconfig .config
make menuconfig
cp .config ./arch/x86/configs/x86_64_emu_defconfig

进入 Device Drivers 选项：

进入 Character devices

这儿就能够看见咱们刚才添加的选项，默许是选上的。

然后履行编译：

# clean 一下，防止犯错
make clean
#履行之前的编译脚本
sh build.sh

进入 AOSP 源码发动模拟器：

source build/envsetup.sh
lunch aosp_x86_64-eng
emulator -kernel ~/kernel/goldfish/arch/x86_64/boot/bzImage

检查开机信息：

# dmesg 用于显现开机信息
adb shell dmesg | grep hello

2. 写一个 Native 程序，测验咱们的驱动程序

在 frameworks/base/native/ 目录下创立如下的目录结构：

hello_drv_test/
├── Android.mk
└── hello_drv_test.c

其中 hello_drv_test.c 的内容如下：

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <stdio.h>
#include <string.h>
/*
 * ./hello_drv_test -w abc
 * ./hello_drv_test -r
 */
int main(int argc, char **argv)
{
	int fd;
	char buf[1024];
	int len;
	/* 1. 判别参数 */
	if (argc < 2) 
	{
		printf("Usage: %s -w <string>n", argv[0]);
		printf("       %s -rn", argv[0]);
		return -1;
	}
	/* 2. 翻开文件 */
	fd = open("/dev/hello", O_RDWR);
	if (fd == -1)
	{
		printf("can not open file /dev/hellon");
		return -1;
	}
	/* 3. 写文件或读文件 */
	if ((0 == strcmp(argv[1], "-w")) && (argc == 3))
	{
		len = strlen(argv[2]) + 1;
		len = len < 1024 ? len : 1024;
		write(fd, argv[2], len);
	}
	else
	{
		len = read(fd, buf, 1024);
		buf[1023] = '';
		printf("APP read : %sn", buf);
	}
	close(fd);
	return 0;
}

测验程序的内容很简略，便是依据指令行参数读写 /dev/hello 文件。

接着编写 Android.mk 文件：

LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_SRC_FILES := 
    hello_drv_test.c
LOCAL_MODULE := hello_drv_test
include $(BUILD_EXECUTABLE)

编译程序并上传模拟器：

# 编译
cd frameworks/base/native/hello_drv_test
mm
# 翻开模拟器，流程略
# 上传可履行文件
cd -
adb push out/target/product/generic_x86_64/system/bin/hello_drv_test /data/local/tmp
# 进入到模拟器 shell
adb shell
# 履行程序
cd /data/local/tmp
# 加载驱动程序
insmod hello_drv_test.ko
./hello_drv_test -w "hello"
./hello_drv_test -r

履行程序的结果如下所示：