1 实验程序编写
本实验例程路径:i.MX6UL终结者光盘资料/06_Linux驱动例程/05_gpiold_spinlock
创建gpioled_spinlock.c文件,具体内容如下:
1 #include <linux/types.h>
2 #include <linux/kernel.h>
3 #include <linux/delay.h>
4 #include <linux/ide.h>
5 #include <linux/init.h>
6 #include <linux/module.h>
7 #include <linux/errno.h>
8 #include <linux/gpio.h>
9 #include <linux/cdev.h>
10 #include <linux/device.h>
11 #include <linux/of.h>
12 #include <linux/of_address.h>
13 #include <linux/of_gpio.h>
14 #include <asm/mach/map.h>
15 #include <asm/uaccess.h>
16 #include <asm/io.h>
17
18 #define GPIOLED_CNT 1 /* 设备号个数 */
19 #define GPIOLED_NAME "gpioled" /* 名字 */
20 #define LEDOFF 0 /* 关灯 */
21 #define LEDON 1 /* 开灯 */
22
23 /* gpioled 设备结构体 */
24 struct gpioled_dev{
25 dev_t devid; /* 设备号 */
26 struct cdev cdev; /* cdev */
27 struct class *class; /* 类 */
28 struct device *device; /* 设备 */
29 int major; /* 主设备号 */
30 int minor; /* 次设备号 */
31 struct device_node *nd; /* 设备节点 */
32 int led_gpio; /* led 所使用的 GPIO 编号 */
33 int dev_stats; /* 设备状态,0,设备未使用;>0,设备已经被使用 */
34 spinlock_t lock; /* 自旋锁 */
35 };
36
37 struct gpioled_dev gpioled; /* led 设备 */
38
39 /*
40 * @description : 打开设备
41 * @param – inode : 传递给驱动的 inode
42 * @param - filp : 设备文件,file 结构体有个叫做 private_data 的成员变量
43 * 一般在 open 的时候将 private_data 指向设备结构体。
44 * @return : 0 成功;其他 失败
45 */
46 static int led_open(struct inode *inode, struct file *filp)
47 {
48 unsigned long flags;
49 filp->private_data = &gpioled; /* 设置私有数据 */
50
51 spin_lock_irqsave(&gpioled.lock, flags); /* 上锁 */
52 if (gpioled.dev_stats) { /* 如果设备被使用了 */
53 spin_unlock_irqrestore(&gpioled.lock, flags); /* 解锁 */
54 return -EBUSY;
55 }
56 gpioled.dev_stats++; /* 如果设备没有打开,那么就标记已经打开了 */
57 spin_unlock_irqrestore(&gpioled.lock, flags);/* 解锁 */
58
59 return 0;
60 }
61 /*
62 * @description : 从设备读取数据
63 * @param - filp : 要打开的设备文件(文件描述符)
64 * @param - buf : 返回给用户空间的数据缓冲区
65 * @param – cnt : 要读取的数据长度
66 * @param - offt : 相对于文件首地址的偏移
67 * @return : 读取的字节数,如果为负值,表示读取失败
68 */
69 static ssize_t led_read(struct file *filp, char __user *buf,
70 size_t cnt, loff_t *offt)
71 {
72 return 0;
73 }
74
75 /*
76 * @description : 向设备写数据
77 * @param – filp : 设备文件,表示打开的文件描述符
78 * @param - buf : 要写给设备写入的数据
79 * @param - cnt : 要写入的数据长度
80 * @param – offt : 相对于文件首地址的偏移
81 * @return : 写入的字节数,如果为负值,表示写入失败
82 */
83 static ssize_t led_write(struct file *filp, const char __user *buf,
84 size_t cnt, loff_t *offt)
85 {
86 int retvalue;
87 unsigned char databuf[1];
88 unsigned char ledstat;
89 struct gpioled_dev *dev = filp->private_data;
90
91 retvalue = copy_from_user(databuf, buf, cnt);
92 if(retvalue < 0) {
93 printk("kernel write failed!\r\n");
94 return -EFAULT;
95 }
96
97 ledstat = databuf[0]; /* 获取状态值 */
98
99 if(ledstat == LEDON) {
100 gpio_set_value(dev->led_gpio, 0); /* 打开 LED 灯 */
101 } else if(ledstat == LEDOFF) {
102 gpio_set_value(dev->led_gpio, 1); /* 关闭 LED 灯 */
103 }
104 return 0;
105 }
106 /*
107 * @description : 关闭/释放设备
108 * @param – filp : 要关闭的设备文件(文件描述符)
109 * @return : 0 成功;其他 失败
110 */
111 static int led_release(struct inode *inode, struct file *filp)
112 {
113 unsigned long flags;
114 struct gpioled_dev *dev = filp->private_data;
115
116 /* 关闭驱动文件的时候将 dev_stats 减 1 */
117 spin_lock_irqsave(&dev->lock, flags); /* 上锁 */
118 if (dev->dev_stats) {
119 dev->dev_stats--;
120 }
121 spin_unlock_irqrestore(&dev->lock, flags);/* 解锁 */
122
123 return 0;
124 }
125
126 /* 设备操作函数 */
127 static struct file_operations gpioled_fops = {
128 .owner = THIS_MODULE,
129 .open = led_open,
130 .read = led_read,
131 .write = led_write,
132 .release = led_release,
133 };
134
135 /*
136 * @description : 驱动入口函数
137 * @param : 无
138 * @return : 无
139 */
140 static int __init led_init(void)
141 {
142 int ret = 0;
143
144 /* 初始化自旋锁 */
145 spin_lock_init(&gpioled.lock);
146 /* 设置 LED 所使用的 GPIO */
147 /* 1、获取设备节点:gpioled */
148 gpioled.nd = of_find_node_by_path("/gpioled");
149 if(gpioled.nd == NULL) {
150 printk("gpioled node not find!\r\n");
151 return -EINVAL;
152 } else {
153 printk("gpioled node find!\r\n");
154 }
155
156 /* 2、 获取设备树中的 gpio 属性,得到 LED 所使用的 LED 编号 */
157 gpioled.led_gpio = of_get_named_gpio(gpioled.nd, "led-gpio", 0);
158 if(gpioled.led_gpio < 0) {
159 printk("can't get led-gpio");
160 return -EINVAL;
161 }
162 printk("led-gpio num = %d\r\n", gpioled.led_gpio);
163
164 /* 3、设置 GPIO1_IO03 为输出,并且输出高电平,默认关闭 LED 灯 */
165 ret = gpio_direction_output(gpioled.led_gpio, 1);
166 if(ret < 0) {
167 printk("can't set gpio!\r\n");
168 }
169
170 /* 注册字符设备驱动 */
171 /* 1、创建设备号 */
172 if (gpioled.major) { /* 定义了设备号 */
173 gpioled.devid = MKDEV(gpioled.major, 0);
174 register_chrdev_region(gpioled.devid, GPIOLED_CNT,
175 GPIOLED_NAME);
176 } else { /* 没有定义设备号 */
177 alloc_chrdev_region(&gpioled.devid, 0, GPIOLED_CNT,
178 GPIOLED_NAME); /* 申请设备号 */
179 gpioled.major = MAJOR(gpioled.devid);/* 获取分配号的主设备号 */
180 gpioled.minor = MINOR(gpioled.devid);/* 获取分配号的次设备号 */
181 }
182 printk("gpioled major=%d,minor=%d\r\n",gpioled.major,
183 gpioled.minor);
184
185 /* 2、初始化 cdev */
186 gpioled.cdev.owner = THIS_MODULE;
187 cdev_init(&gpioled.cdev, &gpioled_fops);
188
189 /* 3、添加一个 cdev */
190 cdev_add(&gpioled.cdev, gpioled.devid, GPIOLED_CNT);
191
192 /* 4、创建类 */
193 gpioled.class = class_create(THIS_MODULE, GPIOLED_NAME);
194 if (IS_ERR(gpioled.class)) {
195 return PTR_ERR(gpioled.class);
196 }
197
198 /* 5、创建设备 */
199 gpioled.device = device_create(gpioled.class, NULL,
200 gpioled.devid, NULL, GPIOLED_NAME);
201 if (IS_ERR(gpioled.device)) {
202 return PTR_ERR(gpioled.device);
203 }
204 return 0;
205 }
206
207 /*
208 * @description : 驱动出口函数
209 * @param : 无
210 * @return : 无
211 */
212 static void __exit led_exit(void)
213 {
214 /* 注销字符设备驱动 */
215 cdev_del(&gpioled.cdev);/* 删除 cdev */
216 unregister_chrdev_region(gpioled.devid, GPIOLED_CNT);
217
218 device_destroy(gpioled.class, gpioled.devid);
219 class_destroy(gpioled.class);
220 }
221
222 module_init(led_init);
223 module_exit(led_exit);
224 MODULE_LICENSE("GPL");
225 MODULE_AUTHOR("topeet");
第33行,dev_stats 表示设备状态,如果为 0 的话表示设备还没有被使用,如果大于 0 的话就表示设备已经被使用了。
第 34 行,在设备结构体中添加自旋锁变量 lock。
第46~60行,使用自旋锁实现对设备的互斥访问,第 51 行调用 spin_lock_irqsave 函数获取锁,为了考虑到驱动兼容性,这里并没有使用 spin_lock 函数来获取锁。第 52 行判断dev_stats 是否大于 0,如果是的话表示设备已经被使用了,那么就调用 spin_unlock_irqrestore函数释放锁,并且返回-EBUSY。如果设备没有被使用的话就在第 56 行将 dev_stats 加 1,表示设备要被使用了,然后调用 spin_unlock_irqrestore 函数释放锁。自旋锁的工作就是保护dev_stats 变量,真正实现对设备互斥访问的是 dev_stats。
第111~124行,在 release 函数中将 dev_stats 减 1,表示设备被释放了,可以被其他的应用程序使用。将 dev_stats 减 1 的时候需要自旋锁对其进行保护。
第145行,在驱动入口函数 led_init 中调用 spin_lock_init 函数初始化自旋锁。
2 编写应用测试程序
应用测试程序使用38.1.2中的应用测试程序即可。
3 运行测试
1、编译驱动程序
添加Makefile文件,修改obj-m的值为 gpioled_spinlock.o,内容如下:
KERNELDIR := /home/topeet/kernel/linux-imx-rel_imx_4.1.15_2.1.0_ga
CURRENT_PATH := $(shell pwd)
obj-m := gpioled_spinlock.o
build: kernel_modules
kernel_modules:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
clean:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean
首先我们在终端输入两个命令(设置两个环境变量):
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-
然后使用“make”命令进行编译,生成gpioled_spinlock.ko驱动模块文件。
2、运行测试
将编译好的gpioled_spinlock.ko驱动模块文件拷贝到/lib/modules/4.1.15目录下(检查开发板根文件系统中有没有“/lib/modules/4.1.15”这个目录,如果没有的话需要自行创建一下。开发板中使用的是光盘资料里面提供的busybox文件系统,光盘资料的“i.MX6UL终结者光盘资料\08_开发板系统镜像\03_文件系统镜像\01_Busybox文件系统”目录下)。输入下面命令加载模块:
depmod
modprobe gpioled_spinlock
驱动加载成功如图 3.1所示:
驱动模块加载成功后,使用gpioled_atomic_test应用测试程序进行测试,测试流程和原子变量测试一样。使用下面的命令打开LED灯:
./gpioled_atomic_test /dev/gpioled 1 &
然后紧接着输入LED灯关闭命令:
./gpioled_atomic_test /dev/gpioled 0
驱动正常情况下,因为打开LED灯的命令占用/dev/gpioled设备文件25s,关闭LED的命令不能正常执行,会提示你“file /dev/gpioled open failed!”,等待25s后,才可以正常执行。
卸载模块命令:
rmmod gpioled_spinlock