Linux设备驱动之mmap设备操作(memdev.c字符设备驱动分析)

from: 

http://blog.csdn.net/mirkerson/article/details/8232422

http://blog.chinaunix.net/uid-25906157-id-1754499.html

http://blog.csdn.net/bg2bkk/article/details/8946562

1.mmap系统调用

void *mmap(void *addr, size_t len, int prot, int flags, int fd, off_t offset);

功能：负责把文件内容映射到进程的虚拟地址空间，通过对这段内存的读取和修改来实现对文件的读取和修改，而不需要再调用read和write；
参数：addr：映射的起始地址，设为NULL由系统指定；
len：映射到内存的文件长度；
prot：期望的内存保护标志，不能与文件的打开模式冲突。PROT_EXEC,PROT_READ,PROT_WRITE等；
flags：指定映射对象的类型，映射选项和映射页是否可以共享。MAP_SHARED，MAP_PRIVATE等；
fd：由open返回的文件描述符，代表要映射的文件；
offset：开始映射的文件的偏移。
返回值：成功执行时，mmap()返回被映射区的指针。失败时，mmap()返回MAP_FAILED。

mmap映射图：

 

 

2.解除映射：
　int munmap(void *start, size_t length); 

3.虚拟内存区域：
虚拟内存区域是进程的虚拟地址空间中的一个同质区间，即具有同样特性的连续地址范围。一个进程的内存映象由下面几个部分组成：程序代码、数据、BSS和栈区域，以及内存映射的区域。
linux内核使用vm_area_struct结构来描述虚拟内存区。其主要成员：

unsigned long vm_start; /* Our start address within vm_mm. */
unsigned long vm_end; /* The first byte after our end address within vm_mm. */
unsigned long vm_flags; /* Flags, see mm.h. 该区域的标记。如VM_IO（该VMA标记为内存映射的IO区域,会阻止系统将该区域包含在进程的存放转存中）和VM_RESERVED（标志内存区域不能被换出）。*/

4.mmap设备操作：
映射一个设备是指把用户空间的一段地址（虚拟地址区间）关联到设备内存上，当程序读写这段用户空间的地址时，它实际上是在访问设备。
mmap方法是file_operations结构的成员，在mmap系统调用的发出时被调用。在此之前，内核已经完成了很多工作。
mmap设备方法所需要做的就是建立虚拟地址到物理地址的页表（虚拟地址和设备的物理地址的关联通过页表）。

static int mmap(struct file *file, struct vm_area_struct *vma)；

mmap如何完成页表的建立？（两种方法）
（1）使用remap_pfn_range一次建立所有页表。

int remap_pfn_range(struct vm_area_struct *vma, unsigned long addr, unsigned long pfn, unsigned long size, pgprot_t prot)；
/**
* remap_pfn_range - remap kernel memory to userspace
* @vma: user vma to map to：内核找到的虚拟地址区间
* @addr: target user address to start at：要关联的虚拟地址
* @pfn: physical address of kernel memory：要关联的设备的物理地址，也即要映射的物理地址所在的物理帧号，可将物理地址>>PAGE_SHIFT
* @size: size of map area
* @prot: page protection flags for this mapping
*
* Note: this is only safe if the mm semaphore is held when called.
*/

（2）使用nopage VMA方法每次建立一个页表；

 

5.源码分析：

（1）memdev.h

 

1. #ifndef _MEMDEV_H_

2. #define _MEMDEV_H_

3. #ifndef MEMDEV_MAJOR

4. #define MEMDEV_MAJOR 452

5. /*预设的mem的主设备号*/

6. #endif

7. #ifndef MEMDEV_NR_DEVS

8. #define MEMDEV_NR_DEVS 2 /*设备数*/

9. #endif

10. #ifndef MEMDEV_SIZE

11. #define MEMDEV_SIZE 4096//分配内存的大小

12. #endif

13. /*mem设备描述结构体*/

14. struct mem_dev

15. {

16. char *data; //分配到的内存的起始地址

17. unsigned long size; //内存的大小

18. };

19. #endif /* _MEMDEV_H_ */

（2）memdev.c

 

 

1. #include <linux/module.h>

2. #include <linux/types.h>

3. #include <linux/fs.h>

4. #include <linux/errno.h>

5. #include <linux/mm.h>

6. #include <linux/sched.h>

7. #include <linux/init.h>

8. #include <linux/cdev.h>

9. #include <asm/io.h>

10. //#include <asm/system.h>

11. #include <linux/slab.h>

12. #include <asm/uaccess.h>

13. #include "memdev.h"

14. static int mem_major = MEMDEV_MAJOR;

15. module_param(mem_major, int, S_IRUGO);

16. struct mem_dev *mem_devp; /*设备结构体指针*/

17. struct cdev cdev;

18. /*文件打开函数*/

19. int mem_open(struct inode *inode, struct file *filp)

20. {

21. struct mem_dev *dev;

22.  

23. /*获取次设备号*/

24. int num = MINOR(inode->i_rdev);// inode->i_rdev包含实际的设备编号

25. if (num >= MEMDEV_NR_DEVS)

26. return -ENODEV;

27. dev = &mem_devp[num];

28.  

29. /*将设备描述结构指针赋值给文件私有数据指针*/

30. filp->private_data = dev;//使用这个成员来指向分配的数据

31.  

32. return 0;

33. }

34. /*文件释放函数*/

35. int mem_release(struct inode *inode, struct file *filp)

36. {

37. return 0;

38. }

39. /*读函数*/

40. static ssize_t mem_read(struct file *filp, char __user *buf, size_t size, loff_t *ppos)//buf缓存区，size读取文件大小，ppos当前读写位置

41. {

42. unsigned long p = *ppos;//p为当前读写位置

43. unsigned int count = size;//一次读取的大小

44. int ret = 0;

45. struct mem_dev *dev = filp->private_data; /*获得设备结构体指针*/

46. /*判断读位置是否有效*/

47. if (p >= MEMDEV_SIZE)//是否超出读取获围

48. return 0;

49. if (count > MEMDEV_SIZE - p)

50. count = MEMDEV_SIZE - p;//count大于可读取的范围，则缩小读取范围。

51. /*读数据到用户空间*/

52. if (copy_to_user(buf, (void*)(dev->data + p), count))//返回buf,读取位置，读取数量

53. {

54. ret = - EFAULT;

55. }

56. else

57. {

58. *ppos += count;//将文件当前位置向后移

59. ret = count;//返回实际读取字节数

60.  

61. printk(KERN_INFO "read %d bytes(s) from %ld\n", count, p);

62. }

63. return ret;//返回实际读取字节数，判断读取是否成功

64. }

65. /*写函数*/

66. static ssize_t mem_write(struct file *filp, const char __user *buf, size_t size, loff_t *ppos)//write和read类似，直接参考read

67. {

68. unsigned long p = *ppos;

69. unsigned int count = size;

70. int ret = 0;

71. struct mem_dev *dev = filp->private_data; /*获得设备结构体指针*/

72.  

73. /*分析和获取有效的写长度*/

74. if (p >= MEMDEV_SIZE)

75. return 0;

76. if (count > MEMDEV_SIZE - p)

77. count = MEMDEV_SIZE - p;

78.  

79. /*从用户空间写入数据*/

80. if (copy_from_user(dev->data + p, buf, count))

81. ret = - EFAULT;

82. else

83. {

84. *ppos += count;

85. ret = count;

86.  

87. printk(KERN_INFO "written %d bytes(s) from %ld\n", count, p);

88. }

89. return ret;

90. }

91. /* seek文件定位函数 */

92. static loff_t mem_llseek(struct file *filp, loff_t offset, int whence)//作改变文件中的当前读/写位置, 并且新位置作为(正的)返回值在测试程序中要重新定位文件位置，whence这里被设置为 SEEK_SET

93. {

94. loff_t newpos;

95. switch(whence) {

96. case 0: /* SEEK_SET */

97. newpos = offset;//从文件头开始定位

98. break;

99. case 1: /* SEEK_CUR */

100. newpos = filp->f_pos + offset;//从文件中间定位

101. break;

102. case 2: /* SEEK_END */

103. newpos = MEMDEV_SIZE -1 + offset;//从文件尾开始定位，由于是从0开始，所以要减1

104. break;

105. default: /* can't happen */

106. return -EINVAL;

107. }

108. if ((newpos<0) || (newpos>MEMDEV_SIZE))

109. return -EINVAL;

110.  

111. filp->f_pos = newpos;//返回当前文件位置

112. return newpos;

113. }

114.  

115. static int memdev_mmap(struct file*filp, struct vm_area_struct *vma)

116. {

117. struct mem_dev *dev = filp->private_data; /*获得设备结构体指针*/

118.  

119. vma->vm_flags |= VM_IO;

120. vma->vm_flags |= (VM_DONTEXPAND | VM_DONTDUMP);

121.  
122.  

123. if (remap_pfn_range(vma,vma->vm_start,virt_to_phys(dev->data)>>PAGE_SHIFT, vma->vm_end - vma->vm_start, vma->vm_page_prot))

124. return -EAGAIN;

125.  

126. return 0;

127. }

128.  

129. /*文件操作结构体*/

130. static const struct file_operations mem_fops =

131. {

132. .owner = THIS_MODULE,

133. .llseek = mem_llseek,

134. .read = mem_read,

135. .write = mem_write,

136. .open = mem_open,

137. .release = mem_release,

138. .mmap = memdev_mmap,

139. };

140. /*设备驱动模块加载函数*/

141. static int memdev_init(void) //初始化模块

142. {

143. int result;

144. int i;

145. dev_t devno = MKDEV(mem_major, 0);//MKDEV是将主设备号和次设备号转换为dev_t类型数据,参数mem_major在头文件中预设为254

146.  

147. /* 静态申请设备号*/

148. if (mem_major)//memdev.h 中定义了为254。所以本例为静态分配主设备号254

149. result = register_chrdev_region(devno, 2, "memdev");//devno为主设备号，共申请两个连续的设备，设备名为"memdev"

150. else /* 动态分配设备号 */

151. {

152. result = alloc_chrdev_region(&devno, 0, 2, "memdev");//&devno作为一个输出参数，次设备号从0开始分配，申请2个设备，设备名为"memdev"

153. mem_major = MAJOR(devno);//获取动态分配到的主设备号。

154. }

155.  

156. if (result < 0)//result返回0时为申请成功，反加负值为申请失败。

157. return result;

158. /*初始化cdev结构*/

159. cdev_init(&cdev, &mem_fops);//初始化cdev结构，将结构体cdev和mem_fops绑定起来

160. cdev.owner = THIS_MODULE;//驱动引用计数，作用是这个驱动正在使用的时候，你再次用inmod命令时，出现警告提示

161. cdev.ops = &mem_fops;

162.  

163. /* 注册字符设备 */

164. cdev_add(&cdev, MKDEV(mem_major, 0), MEMDEV_NR_DEVS);//MEMDEV_NR_DEVS=2，分配2个设备

165.  

166. /* 为设备描述结构分配内存*/

167. mem_devp = kmalloc(MEMDEV_NR_DEVS * sizeof(struct mem_dev), GFP_KERNEL);//kmalloc函数返回的是虚拟地址(线性地址).

168. if (!mem_devp) /*申请失败*/

169. {

170. result = - ENOMEM;

171. goto fail_malloc;

172. }

173. memset(mem_devp, 0, sizeof(struct mem_dev));//新申请的内存做初始化工作

174.  

175. /*为设备分配内存*/

176. for (i=0; i < MEMDEV_NR_DEVS; i++)

177. {

178. mem_devp[i].size = MEMDEV_SIZE;//#define MEMDEV_SIZE 4096

179. mem_devp[i].data = kmalloc(MEMDEV_SIZE, GFP_KERNEL);//分配内存给两个设备

180. memset(mem_devp[i].data, 0, MEMDEV_SIZE);//初始化新分配到的内存

181. }

182.  

183. return 0;

184. fail_malloc:

185. unregister_chrdev_region(devno, 1);//如果申请失败，注销设备

186.  

187. return result;

188. }

189. /*模块卸载函数*/

190. static void memdev_exit(void)

191. {

192. cdev_del(&cdev); /*注销设备*/

193. kfree(mem_devp); /*释放设备结构体内存*/

194. unregister_chrdev_region(MKDEV(mem_major, 0), 2); /*释放设备号*/

195. }

196. MODULE_AUTHOR("David Xie");

197. MODULE_LICENSE("GPL");

198. module_init(memdev_init);

199. module_exit(memdev_exit);

200.  

 

(3)test.c:

 

1. #include <stdio.h>

2. #include<sys/types.h>

3. #include<sys/stat.h>

4. #include<fcntl.h>

5. #include<unistd.h>

6. #include<sys/mman.h>

7.  

8. int main()

9. {

10. int fd;

11. char *start;

12. //char buf[100];

13. char *buf;

14.  

15. /*打开文件*/

16. fd = open("/dev/memdev0",O_RDWR);

17.  

18. buf = (char *)malloc(100);

19. memset(buf, 0, 100);

20. start=mmap(NULL,100,PROT_READ|PROT_WRITE,MAP_SHARED,fd,0);

21.  

22. /* 读出数据 */

23. strcpy(buf,start);

24. sleep (1);

25. printf("buf 1 = %s\n",buf);

26.  

27. /* 写入数据 */

28. strcpy(start,"Buf Is Not Null!");

29.  

30. memset(buf, 0, 100);

31. strcpy(buf,start);

32. sleep (1);

33. printf("buf 2 = %s\n",buf);

34.  
35.  

36. munmap(start,100); /*解除映射*/

37. free(buf);

38. close(fd);

39. return 0;

40. }

 

 

测试步骤：

（1）编译安装内核模块：insmod memdev.ko; 

（2）查看设备名、主设备号：cat /proc/devices

（3）手工创建设备节点：mknod /dev/memdev0 c 452 0; mknod /dev/memdev0 c 452 1

　　查看设备文件是否存在：ls -l /dev/* | grep memdev*

（4）编译下载运行应用程序：sudo ./test 最好用超级用户权限运行，否则有时会出现权限问题，有时不出现权限的提示；

　　结果：buf 1 = 

　　　　　buf 2 = Buf Is Not Null!

 

总结：

1. mmap设备方法实现将用户空间的一段内存关联到设备内存上，对用户空间的读写就相当于对字符设备的读写；不是所有的设备都能进行mmap抽象，比如像串口和其他面向流的设备就不能做mmap抽象。

2. 设备号要确保唯一，不与当前系统中设备号冲突，否则会出现device busy的提示；

3. 用户空间调用mmap函数，要确保驱动中实现了对应的mmap函数；

用c函数测试(此时要用sudo运行test，否则会提示Open Memdev0 Error!）

// test.c:

 

1. #include <stdio.h>

2.  

3. int main()

4. {

5. FILE *fp0 = NULL;

6. char Buf[4096];

7.  

8. /*初始化Buf*/

9. strcpy(Buf,"Mem is char dev!");

10. printf("BUF: %s\n",Buf);

11.  

12. /*打开设备文件*/

13. fp0 = fopen("/dev/memdev0","r+");

14. if (fp0 == NULL)

15. {

16. printf("Open Memdev0 Error!\n");

17. return -1;

18. }

19.  

20. /*写入设备*/

21. fwrite(Buf, sizeof(Buf), 1, fp0);

22.  

23. /*重新定位文件位置（思考没有该指令，会有何后果)*/

24. fseek(fp0,0,SEEK_SET);//调用mem_llseek（）定位

25.  

26. /*清除Buf*/

27. strcpy(Buf,"Buf is NULL!");

28. printf("BUF: %s\n",Buf);

29.  
30.  

31. /*读出设备*/

32. fread(Buf, sizeof(Buf), 1, fp0);

33.  

34. /*检测结果*/

35. printf("BUF: %s\n",Buf);

36.  

37. return 0;

38. }

用系统调用测试:

 

 

1. #include <sys/stat.h>

2. #include <fcntl.h>

3. #include <stdio.h>

4. #include <stdlib.h>

5.  

6. void main(void)

7. {

8. int fd;

9. int i;

10. char data[256];

11. int retval;

12. fd = open("/dev/memdev1",O_RDWR);

13. if(fd==-1)

14. {

15. perror("erroropen\n");

16. exit(-1);

17. }

18. printf("open/dev/memdev1 successfully\n");

19. //写数据

20. retval = write(fd,"test",4);

21. if(retval==-1)

22. {

23. perror("write error\n");

24. exit(-1);

25. }

26. printf("write successfully\n");

27. //读数据

28. lseek( fd, 0, SEEK_SET );

29. retval=read(fd,data,4);

30. if(retval==-1)

31. {

32. perror("read error\n");

33. exit(-1);

34. }

35. data[retval]=0;

36. printf("read successfully:%s\n",data);

37. //关闭设备

38. close(fd);

39. }