S3C2440 温度传感器ds18b20的驱动编写与测试--比较详细的1-wire

ds18b20的详细信息百度百科都有比较详细的介绍：

http://www.baidu.com/link?url=tgDW0RZumyv2JQbC7ohrnKj_jtFZmqkrnJd7vp3V24KCiG8bkOHqD7vRoQev3OjBPFgIGUvUyVpfdtgSzJUwm_&wd=&eqid=cb79eb5b0000da5a0000000555e061f4

再有就是特别感谢这位提供datasheet时序的博主：http://www.cnblogs.com/wangyuezhuiyi/archive/2012/10/12/2721839.html

=================================================================================================

因为Linux内核3.0自带Dallas 1-wires设备驱动，路径为：drivers/w1，所以在写驱动之前我首先进行了内核自带的单总线设备通用驱动移植（其实主要原因是温度传感器是我自己刚刚焊接上去的，想确认下其能否正常工作）；此类驱动为Master/Slave模式：Master目录下为主控制器驱动，我们用到的是w1-gpio.c；Slave目录下是从设备驱动，我们使用的DS18B20属于温度传感器，所以使用w1_therm.c这个驱动。w1-gpio.c是单总线的IO操作方法，用于模拟单总线时序；w1_therm.c是DS18B20的内部操作方法（读写寄存器），和IO时序无关；我们可以将驱动结构看成是将“w1_therm”挂接到“w1-gpio”总线上，由w1-gpio控制w1_therm工作。

=================================================================================================

一、在mach-smdk2440.c中添加对设备DS18B20的支持：

加入w1-gpio.h头文件，以使用w1_gpio_platform_data结构体：
#include <linux/w1-gpio.h>
smdk2440_devices[ ]结构体中加入：
&s3c_ds18b20_device,
构建DS18B20设备的平台数据结构：

[objc]  view plain  copy

 print ?

1. #if 1   
2. /* DS1820B add by Handy 2015.8.17*/  
3. static void w1_enable_external_pullup(int enable)  
4. {  
5.     if(enable)  
6.         s3c_gpio_setpull(S3C2410_GPG(0), S3C_GPIO_PULL_UP);  
7.     else  
8.         s3c_gpio_setpull(S3C2410_GPG(0), S3C_GPIO_PULL_NONE);  
9. }  
10.   
11.   
12. static struct w1_gpio_platform_data ds18b20_w1_gpio = {  
13.     .pin = S3C2410_GPG(0),  
14.     .is_open_drain = 0,  
15.     .enable_external_pullup = w1_enable_external_pullup,  
16. };  
17.   
18.   
19. static struct platform_device s3c_ds18b20_device ={  
20.     .name     = "w1-gpio",  
21.     .id       = -1,  
22.     .dev      = {  
23.         .platform_data  = &ds18b20_w1_gpio,  
24.     },  
25. };  
26. #endif  

说明：设备名称是“w1-gpio”，这个和w1-gpio.c驱动中的驱动名称一致，才能注册这个设备驱动。通过FL2440开发板底板原理图可以看到只用到了GPG（0）这个管脚。

好了我们接下来配置内核，支持W1-gpio和ds18b20驱动：

好了，重新加载内核。启动target,可以测试温度了：

上述工作表明我焊接的温度传感器可用，下面就是自写的驱动模块代码以及测试程序（参考了网上不少前辈的代码，感谢你们的分享）

[objc]  view plain  copy

 print ?

1. /********************************************************************************* 
2.  *      Copyright:  (C) 2015 songyong<handy_skyoutlook.com> 
3.  *                  All rights reserved. 
4.  * 
5.  *       Filename:  ds18b20.c 
6.  *    Description:  This file  
7.  *                  
8.  *        Version:  1.0.0(2015年08月25日) 
9.  *         Author:  sky <handy_sky@outlook.com> 
10.  *      ChangeLog:  1, Release initial version on "2015年08月25日 09时12分04秒" 
11.  *                  
12.  ********************************************************************************/  
13. #include<linux/module.h>  
14. #include<linux/kernel.h>  
15. #include<linux/fs.h>  
16. #include<linux/init.h>  
17. #include<linux/delay.h>  
18. #include<linux/gpio.h>  
19. #include<linux/types.h>  
20. #include<asm/irq.h>  
21. #include<mach/regs-gpio.h>  
22. #include<mach/hardware.h>  
23. #include<linux/device.h>  
24. #include<linux/kdev_t.h>  
25. #include<linux/cdev.h>  
26. #include<linux/errno.h>  
27. #include<asm/uaccess.h>  
28.   
29. #define DQ S3C2410_GPG(0)  
30. #define INPUT S3C2410_GPIO_INPUT  
31. #define OUTPUT S3C2410_GPIO_OUTPUT  
32.   
33. #define D_MAJOR 0  
34. #define D_MINOR 0  
35. #define DEV_NAME "ds18b20"   
36.   
37.   
38. static int ds18b20_major = D_MAJOR;  
39. static int ds18b20_minor = D_MINOR;  
40.   
41. struct ds18b20_device  
42. {  
43.     struct class    *sy_class;  
44.     struct cdev     cdev;  
45. };  
46. static struct ds18b20_device   dev;//若使用指针，记得给指针开辟空间。  
47.   
48. static unsigned int ds18b20_reset(void)  
49. {  
50.     int err;  
51.   
52.     s3c2410_gpio_cfgpin(DQ, OUTPUT);  
53.     s3c2410_gpio_pullup(DQ, 0);  
54.   
55.     s3c2410_gpio_setpin(DQ, 1);  
56.         udelay(10);  
57.     s3c2410_gpio_setpin(DQ, 0);  
58.         udelay(600);  
59.   
60.     s3c2410_gpio_setpin(DQ, 1);  
61.         udelay(60);  
62.   
63.     s3c2410_gpio_cfgpin(DQ, INPUT);  
64.         udelay(400);  
65.     err = s3c2410_gpio_getpin(DQ);  
66.     return err;  
67. }  
68.   
69. static unsigned int ds18b20_write(unsigned char data)  
70. {  
71.     unsigned int i;  
72.     s3c2410_gpio_cfgpin(DQ, OUTPUT);  
73.     for (i = 0; i < 8; i++)   //只能一位一位的读写  
74.     {  
75.         s3c2410_gpio_setpin(DQ, 0);  
76.         udelay(5);  
77.         if(data & 0x01)  
78.         {  
79.             s3c2410_gpio_setpin(DQ ,1);  
80.                 udelay(60);  
81.         }  
82.         else udelay(60);  
83.         data >>= 1;     //从最低位开始判断；每比较完一次便把数据向右移，获得新的最低位状态  
84.         s3c2410_gpio_setpin(DQ, 1);  
85.         udelay(1);  
86.     }  
87.     return 2;  
88. }  
89.   
90. static unsigned int ds18b20_read(void)  
91. {  
92.     unsigned int i ;  
93.     unsigned char data = 0x00;  
94.   
95.     for (i =0; i < 8 ; i++)  
96.     {  
97.         s3c2410_gpio_cfgpin(DQ, OUTPUT);  
98.         s3c2410_gpio_setpin(DQ, 1);  
99.         udelay(1);  
100.         s3c2410_gpio_setpin(DQ, 0);  
101.         udelay(2);  
102.         s3c2410_gpio_setpin(DQ, 1);  
103.         s3c2410_gpio_cfgpin(DQ, INPUT);  
104.         data >>= 1;  
105.         if(0 != s3c2410_gpio_getpin(DQ))  
106.             data |= 0x80;   //最低位数据从data的最高位放起，边放边右移直到读取位完毕。  
107.         udelay(60);  
108.     }  
109.     return data;  
110. }  
111.   
112. static ssize_t read_ds18b20(struct file *filp, char __user *buf, size_t count, loff_t *f_pos)  
113. {  
114.     unsigned char Data[2] = {0x00, 0x00};  
115.     unsigned long err;   
116.     int flag;  
117.   
118.     flag = ds18b20_reset();  
119.     if(flag <= 0)  
120.     {  
121.         printk("ds18b20 init fail!\n");  
122.         return -1;  
123.     }  
124.   
125.     ds18b20_write(0xcc);  
126.     ds18b20_write(0x44);  
127.   
128.     ds18b20_reset();  
129.     if(flag <= 0)  
130.     {  
131.         printk("ds18b20 init fail!\n");  
132.         return -1;  
133.     }  
134.   
135.     ds18b20_write(0xcc);  
136.     ds18b20_write(0xbe);  
137.   
138.     Data[0] = ds18b20_read();  
139.     Data[1] = ds18b20_read();  
140.     ds18b20_reset();  
141.     err = copy_to_user(buf, Data, sizeof(Data));  
142.     return err? -EFAULT:count;  
143. }  
144. #if 1   
145. static int open_ds18b20(struct inode *inode, struct file *filp)  
146. {  
147.     int flag = 0;  
148.   
149.     flag = ds18b20_reset();  
150.     if(flag)  
151.     {  
152.         printk("open ds18b20 successful!\n");  
153.     }  
154.     else printk("open ds18b20 failed!\n");  
155.     return 0;  
156. }  
157. #endif  
158.   
159. static int release_ds18b20(struct inode *inode, struct file *filp)  
160. {  
161.     return 0;  
162. }  
163.   
164. static struct file_operations fops={  
165.     .owner  = THIS_MODULE,  
166.     .read   = read_ds18b20,  
167.     .open   = open_ds18b20,  
168.     .release = release_ds18b20,  
169. };  
170.   
171. static int __init ds18b20_init(void)  
172. {  
173.     int result,err;  
174.     dev_t devno = 0;  
175.   
176.     if(ds18b20_major)  
177.     {  
178.         devno = MKDEV(ds18b20_major, ds18b20_minor);  
179.         result = register_chrdev_region(devno, 1, DEV_NAME);  
180.     }  
181.     else{  
182.         result = alloc_chrdev_region(&devno, ds18b20_minor, 1, DEV_NAME);  
183.         ds18b20_major = MAJOR(devno);  
184.     }  
185.     if(result < 0)  
186.     {  
187.         printk(KERN_ERR "%s can't use major %d\n",DEV_NAME, ds18b20_major);  
188.     }  
189.     printk("%s use major %d\n",DEV_NAME, ds18b20_major);  
190.   
191.     cdev_init(&dev.cdev,&fops);  
192.     dev.cdev.owner = THIS_MODULE;  
193.     err = cdev_add(&dev.cdev, devno, 1);  
194.     if(err)  
195.     {  
196.         printk(KERN_NOTICE"ERROR %d add ds18b20\n",err);  
197.         goto ERROR;  
198.     }  
199.     dev.sy_class   = class_create(THIS_MODULE, DEV_NAME);  
200.     device_create(dev.sy_class, NULL, MKDEV(ds18b20_major, ds18b20_minor), NULL, DEV_NAME);  
201.     printk(KERN_NOTICE"Ds18b20 is ok!\n");  
202.     return 0;  
203. ERROR:  
204.     printk(KERN_ERR"%s driver installed failure.\n",DEV_NAME);  
205.     cdev_del(&dev.cdev);  
206.     unregister_chrdev_region(devno, 1);  
207.     return err;  
208.   
209. }  
210. static void __exit ds18b20_exit(void)  
211. {  
212.     dev_t devno = MKDEV(ds18b20_major, 0);  
213.   
214.     cdev_del(&dev.cdev);  
215.     device_destroy(dev.sy_class,devno);  
216.     class_destroy(dev.sy_class);  
217.   
218.     unregister_chrdev_region(devno, 1);  
219.     printk(KERN_NOTICE"bye ds18b20!\n");  
220. }  
221.   
222. module_init(ds18b20_init);  
223. module_exit(ds18b20_exit);  
224. MODULE_LICENSE("Dual BSD/GPL");  
225. MODULE_AUTHOR("handy_sky@outlook.com");  

测试程序：

[objc]  view plain  copy

 print ?

1. /********************************************************************************* 
2.  *      Copyright:  (C) 2015 songyong<handy_skyoutlook.com> 
3.  *                  All rights reserved. 
4.  * 
5.  *       Filename:  ds18_test.c 
6.  *    Description:  This file  
7.  *                  
8.  *        Version:  1.0.0(2015年08月24日) 
9.  *         Author:  sky <handy_sky@outlook.com> 
10.  *      ChangeLog:  1, Release initial version on "2015年08月24日 15时24分47秒" 
11.  *                  
12.  ********************************************************************************/  
13. #include <stdio.h>  
14. #include <stdlib.h>  
15. #include <sys/types.h>  
16. #include <sys/stat.h>  
17. #include <fcntl.h>  
18. #include <unistd.h>  
19.   
20. /******************************************************************************** 
21.  *  Description: 
22.  *   Input Args: 
23.  *  Output Args: 
24.  * Return Value: 
25.  ********************************************************************************/  
26.   
27. int main (int argc, charchar **argv)  
28. {  
29.     int fd;  
30.     int i = 0;  
31.     int data = 0;  
32.     unsigned char result[2];  
33.     float temperature = 0;  
34.   
35.     printf("will open fd... \n");  
36.     if((fd = open("/dev/ds18b20",O_RDWR|O_NONBLOCK)) < 0 )  
37.     {  
38.         perror("open device fail.\n");  
39.         return -1;  
40.     }  
41.     else printf("Open Device Ds18b20 Successful!!\n");  
42.   
43.     while(1)  
44.     {  
45.         int ret;  
46.   
47.         printf("\nWill read temperature...\n");  
48.         usleep(100);  
49.         ret = read(fd, result, sizeof(result));  
50.         if(ret != 2)  
51.         {  
52.             printf("read wrong\n");  
53.             exit(0);  
54.         }  
55.         else printf("read success !\n");  
56.   
57.         data = (int)result[1];   
58.         data <<=8;  
59.         data = data | result[0];  
60.         temperature =data * 0.0625 ;  
61.         printf("Temperature = %.2f ℃\n",temperature);  
62.         fflush(stdout);  
63.         sleep(1);  
64.     }  
65.     close(fd);  
66.     return 0;  
67. } /* ----- End of main() ----- */  

Makefile:

[objc]  view plain  copy

 print ?

1. obj-m := ds18b20.o  
2. KERNELDIR ?=/home/pikaqiu/minefl2440/kernel/linux-3.0_song  
3. PWD := $(shell pwd)  
4. CC := /opt/buildroot-2012.08/arm920t/usr/bin/arm-linux-gcc  
5. CLEAN := rm -rf  
6.   
7. all : ds18b20.c ds18_test  
8.         $(MAKE) -C $(KERNELDIR) M=$(PWD) modules  
9. ds18b20 : ds18b20.c  
10.         $(CC) ds18_test.c -o ds18_test  
11. clobber :  
12.         $(CLEAN) ds18_test ds18b20.ko  
13. clean :  
14.         $(CLEAN) *.mod.* *.o *~ modules.order Module.symvers  

在做完之后我的终端时不时还会打印出：

WARNING: at drivers/gpio/gpiolib.c:101 gpio_ensure_requested+0x54/0xd4()
autorequest GPIO-192
Modules linked in: ds18b20

在网上找了资料之后怀疑是GPIO端口复用所致，在内核配置里面关闭了自带的单线设备通用驱动 

<> Dallas's 1-wire support  --->，即可解决。

小结：

一、

首先这次写完驱动后对比之前所学的驱动代码，知道了操纵GPIO管脚的方式有两种：一种是像之前LED灯的驱动里面那样通过对寄存器地址的操作来控制，另一种便是直接通过调用内核中提供的相关函数来操纵具体的硬件GPIO管脚。本文的驱动便是直接使用了内核中的函数来操控GPIO管脚。

这些函数在linux内核源代码的/arch/arm/plat_s3c24xx/gpio.c中实现：

1.void s3c2410_gpio_cfgpin(unsigned int pin,unsigned int function)
第一个参数pin 是对应的io引脚（这里用宏S3C2410_GPG(0), 0不是固定的，看你需要引用的引脚而定）第二个参数是设置该引脚的功能的（由S3C2410_GPIO_INPUT,S3C2410_GPIO_OUTPUT,S3C2410_GPIO_SFN2,S3C2410_GPIO_SFN3这4个宏进行定义）

例如：s3c2410_gpio_cfgpin(S3C2410_GPG(5),S3C2410_GPIO_INPUT)设置GPG5引脚为输入。

2.void s3c2410_gpio_pullup(unsigned int pin,unsigned int to)

作用：设置相应的的GPIO的上拉电阻。第一个参数：相应的引脚，和1里面的用法一致。第二个参数：设置为1或者0，1表示上拉，0表示不上拉。

3.void s3c2410_gpio_setpin(unsigned int pin,unsigned int to)

作用：将相应的引脚输出为1或者0。第一个参数：相应的引脚第二个参数：1或者0

例子：s3c2410_gpio_setpin(S3C2410_GPB(5),1)将引脚GPB5输出为1

4.unsigned int s3c2410_gpio_getpin(unsigned int pin)功能：获取相应的引脚的状态  高为1，低为0

更多的gpio操作详见gpio.c中的源码。

二、

[objc]  view plain  copy

 print ?

1. struct cdev {  
2.         struct kobject kobj;  
3.         struct module *owner;  
4.         const struct file_operations *ops;  
5.         struct list_head list;  
6.         dev_t dev;  
7.         unsigned int count;  
8. };  

最大的收获的是更加熟悉相关结构与脉络。比如动静态申请设备号，通过struct class结构体变量对应的类来创建设备节点等。以前学的时候总是看到说必须要填充 fops 结构体，然后嵌入到 cdev 之中去。以前的理解是：常说用cdev来描述一个字符设备驱动，然后有关这个驱动的系统应用函数接口自然就需要填充进去。错虽然没错，但是直到找到 cdev 结构体之后才算是真正有了代码依据。 dev_t dev 就是设备号。还解释了每次都要写 owner=THIS_MODULE 。可以看到 owner 指针是 struct module 结构体类型。 struc module 在内核中 代表一个内核模块 ，我们插入一个内核模块，一般会使用工具 insmod ，该工具实际上调用了系统调用 init_module ，在该系统调用函数中，首先调用 load_module ， 把用户空间传入的整个内核模块文件创建成一个内核模块 ， 返回一个struct module结构体 。 内核中便以这个结构体代表这个内核模块。 对于 THIS_MODULE 来说，它是一个宏定义：
  #define THIS_MODULE (&__this_module)，__this_module是一个struct module变量，代表当前模块 。所以可以 通过THIS_MODULE宏来引用到struct module结构体进而来表示当前这个模块
结构体中其余的成员则是系统自动填充的。

cdev路径：linux-3.0_song/include/linux/cdev.h
资料链接：http://blog.csdn.net/jk110333/article/details/8563647 THIS_MODULE

三、

起初我看到WARNING上面的gpio_request误以为是操作GPIO之前没有为gpio管脚申请资源。然后使用了gpio_request申请后依旧没有效果；现在大概浅显的知道gpio_request是用在虚拟地址映射时需要申请资源。并不是在驱动正常使用gpio引脚时申请。后面还通过grep来查找GPG(0)在内核中的哪些地方有占用，发现在plat-s3c24xx/pm.c里面有用到，进去将GPG(0)短暂的Disable之后重新加载内核依旧没有解决。此时我又去看mach-smdk2440里面的GPG(0)，当然这是我自己添加的。然后我瞬间知道原因了：肯定是自带的通用驱动编译进内核后与自己编写的驱动IO端口偶尔冲突而引发的warning。自己之前在做wifi驱动的时候。也是内核提供的mac80211通用驱动与厂商提供的.ko驱动冲突。这次又是这种情况..囧。还有就是自己在使用结构体指针的时候，程序又跑飞了。再次提醒自己要知道此机器上指针所能存放的地址大小。驱动里牵扯到结构体操作，要么先给一个指针kmalloc一段内存后使用结构体指针操作，要么就直接使用结构体变量。