linux驱动开发之蜂鸣器驱动源码分析

Posted 2020-09-23

    蜂鸣器的驱动源码在/driver/char/buzzer/x210-buzzer.c文件中，源码如下

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/fs.h>
#include <linux/init.h>
#include <linux/delay.h>
#include <linux/poll.h>
#include <asm/irq.h>
#include <asm/io.h>
#include <linux/interrupt.h>
#include <asm/uaccess.h>
#include <mach/hardware.h>
#include <plat/regs-timer.h>
#include <mach/regs-irq.h>
#include <asm/mach/time.h>
#include <linux/clk.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/miscdevice.h>

#include <linux/gpio.h>

#include <plat/gpio-cfg.h>
//#include <plat/regs-clock.h>
//#include <plat/regs-gpio.h>

//#include <plat/gpio-bank-e.h>
//#include <plat/gpio-bank-f.h>
//#include <plat/gpio-bank-k.h>

#define DEVICE_NAME     "buzzer"

#define PWM_IOCTL_SET_FREQ		1
#define PWM_IOCTL_STOP			0

static struct semaphore lock;

// TCFG0在Uboot中设置，这里不再重复设置
// Timer0输入频率Finput=pclk/(prescaler1+1)/MUX1
//                     =66M/16/16
// TCFG0 = tcnt = (pclk/16/16)/freq;
// PWM0输出频率Foutput =Finput/TCFG0= freq
static void PWM_Set_Freq( unsigned long freq )
{
	unsigned long tcon;
	unsigned long tcnt;
	unsigned long tcfg1;

	struct clk *clk_p;
	unsigned long pclk;

	//unsigned tmp;
	
	//设置GPD0_2为PWM输出
	s3c_gpio_cfgpin(S5PV210_GPD0(2), S3C_GPIO_SFN(2));

	tcon = __raw_readl(S3C2410_TCON);
	tcfg1 = __raw_readl(S3C2410_TCFG1);

	//mux = 1/16
	tcfg1 &= ~(0xf<<8);
	tcfg1 |= (0x4<<8);
	__raw_writel(tcfg1, S3C2410_TCFG1);
	
	clk_p = clk_get(NULL, "pclk");
	pclk  = clk_get_rate(clk_p);

	tcnt  = (pclk/16/16)/freq;
	
	__raw_writel(tcnt, S3C2410_TCNTB(2));
	__raw_writel(tcnt/2, S3C2410_TCMPB(2));//占空比为50%

	tcon &= ~(0xf<<12);
	tcon |= (0xb<<12);		//disable deadzone, auto-reload, inv-off, update TCNTB0&TCMPB0, start timer 0
	__raw_writel(tcon, S3C2410_TCON);
	
	tcon &= ~(2<<12);			//clear manual update bit
	__raw_writel(tcon, S3C2410_TCON);
}

void PWM_Stop( void )
{
	//将GPD0_2设置为input
	s3c_gpio_cfgpin(S5PV210_GPD0(2), S3C_GPIO_SFN(0));	
}

static int x210_pwm_open(struct inode *inode, struct file *file)
{
	if (!down_trylock(&lock))
		return 0;
	else
		return -EBUSY;
	
}


static int x210_pwm_close(struct inode *inode, struct file *file)
{
	up(&lock);
	return 0;
}

// PWM:GPF14->PWM0
static int x210_pwm_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsigned long arg)
{
	switch (cmd) 
	{
		case PWM_IOCTL_SET_FREQ:
			printk("PWM_IOCTL_SET_FREQ:\r\n");
			if (arg == 0)
				return -EINVAL;
			PWM_Set_Freq(arg);
			break;

		case PWM_IOCTL_STOP:
		default:
			printk("PWM_IOCTL_STOP:\r\n");
			PWM_Stop();
			break;
	}

	return 0;
}


static struct file_operations dev_fops = {
    .owner   =   THIS_MODULE,
    .open    =   x210_pwm_open,
    .release =   x210_pwm_close, 
    .ioctl   =   x210_pwm_ioctl,
};

static struct miscdevice misc = {
	.minor = MISC_DYNAMIC_MINOR,
	.name = DEVICE_NAME,
	.fops = &dev_fops,
};

static int __init dev_init(void)
{
	int ret;

	init_MUTEX(&lock);
	ret = misc_register(&misc);
	
	/* GPD0_2 (PWMTOUT2) */
	ret = gpio_request(S5PV210_GPD0(2), "GPD0");
	if(ret)
		printk("buzzer-x210: request gpio GPD0(2) fail");
		
	s3c_gpio_setpull(S5PV210_GPD0(2), S3C_GPIO_PULL_UP);
	s3c_gpio_cfgpin(S5PV210_GPD0(2), S3C_GPIO_SFN(1));
	gpio_set_value(S5PV210_GPD0(2), 0);

	printk ("x210 "DEVICE_NAME" initialized\n");
    	return ret;
}

static void __exit dev_exit(void)
{
	misc_deregister(&misc);
}

module_init(dev_init);
module_exit(dev_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("www.9tripod.com");
MODULE_DESCRIPTION("x210 PWM Driver");

    蜂鸣器的驱动模块代码如上。和其他驱动模块代码一样，module_init中的函数为驱动模块被加载的时候（insmd）时运行的函数，module_exit中的函数为驱动模块被卸载时（rmmod）运行的函数，

    首先看下module_Init驱动被加载时执行的函数dev_init函数，代码分析如下

static int __init dev_init(void)
{
	int ret;

	init_MUTEX(&lock);
	ret = misc_register(&misc);
	
	/* GPD0_2 (PWMTOUT2) */
	ret = gpio_request(S5PV210_GPD0(2), "GPD0");
	if(ret)
		printk("buzzer-x210: request gpio GPD0(2) fail");
		
	s3c_gpio_setpull(S5PV210_GPD0(2), S3C_GPIO_PULL_UP);
	s3c_gpio_cfgpin(S5PV210_GPD0(2), S3C_GPIO_SFN(1));
	gpio_set_value(S5PV210_GPD0(2), 0);

	printk ("x210 "DEVICE_NAME" initialized\n");
    	return ret;
}

     上面代码中的init_MUTEX(&lock),这个lock是在本文件全局定义的，定义如下，init_MUTEXH函数是初始化信号量的，将信号量的计数值初始化为1。计数值初始化为1的信号量其实就是互斥锁，由这个代码可以知道，编写者的本意是想用的互斥锁的，但可能那个时候并没有互斥锁，只有信号量，所以用信号量来实现了互斥锁。因为信号量的计数值为1，其实跟互斥锁就是类似的了。因为信号量没有互斥锁优化的好，所以这里使用信号量其实并不是现在主流的。

static struct semaphore lock;

struct semaphore是一个信号量结构体，信号量和互斥锁的不同前面已经讲过。结构体内容如下

struct semaphore {
	spinlock_t		lock;
	unsigned int		count;
	struct list_head	wait_list;    //信号量的等待队列
};

    在dev_init函数中，接着代码是

ret = misc_register(&misc);

    misc_register是注册misc杂散类设备的函数，参数misc是被定义在全局并且填充好的结构体变量，内容如下

static struct miscdevice misc = {    //这里定义miscdevice结构体并填充了三个成员，根据实际情况进行填充
	.minor = MISC_DYNAMIC_MINOR,    //次设备号minor成员被赋值为MISC_DYNAMIC_MINOR宏的值（255）,前面说过该值表示让内核为我们自动分配次设备                                        //号。
	.name = DEVICE_NAME,    //该设备的名字，这个设备的名字并不像platform平台总线机制中的名字那么重要（因为是用来macth函数匹配设备和驱动的//）。这里这个name作用只是用来记录的。
	.fops = &dev_fops,    //该设备的操作方法
};

    上面定义的strcut miscdevice结构体中的fops成员被绑定成dev_fops，dev_fops也是被定义在本文件的全局的，该结构体包含的是操作这个驱动的操作而方法，内容如下

static struct file_operations dev_fops = {
    .owner   =   THIS_MODULE,
    .open    =   x210_pwm_open,    //应用层open操作该设备文件时执行的函数
    .release =   x210_pwm_close,     //应用层close操作该设备文件时执行的函数
    .ioctl   =   x210_pwm_ioctl,    //应用层ioctl操作该设备文件时执行的函数
};

    经过misc_register(&misc)后，就会将该misc设备和其驱动的操作方法进行注册，完成杂散类设备的注册。

    在dev_init函数中接下来的代码就是对蜂鸣器硬件相关的设置，根据硬件原理图来看蜂鸣器对应的GPIO，操作设置如下

	/* GPD0_2 (PWMTOUT2) */
	ret = gpio_request(S5PV210_GPD0(2), "GPD0");    //向内核申请GPIOD0_2引脚资源
	if(ret)
		printk("buzzer-x210: request gpio GPD0(2) fail");
		
	s3c_gpio_setpull(S5PV210_GPD0(2), S3C_GPIO_PULL_UP);    //向内核申请后，设置GPIOD0_2引脚为上拉
	s3c_gpio_cfgpin(S5PV210_GPD0(2), S3C_GPIO_SFN(1));    //将该GPIOD0_2引脚的模式设置成S3C_GPIO_SFN(1)模式（特殊模式1，根据手册是输出
	                                                      //模式，详细情况看数据手册）
	gpio_set_value(S5PV210_GPD0(2), 0);    //设置该引脚初始输出0低电平，因为是初始化为0低电平，所以蜂鸣器开始是不会响的。

	printk ("x210 "DEVICE_NAME" initialized\n");    //DEVICE_NAME宏是设备名字，这种方式的打印信息，编译会将宏代表的字符串一起打印出来。
    	return ret;

    上面的分析已经将蜂鸣器驱动模块被装载时发生的事情（dev_init）分析完了。dev_init函数执行成功表示驱动已经安装好了，此时驱动代码为待命状态。等待应用层去操作。

    

    应用层用open代开蜂鸣器设备文件时，对应的驱动执行函数是x210_pwm_open，代码如下

static int x210_pwm_open(struct inode *inode, struct file *file)
{
	if (!down_trylock(&lock))    //因为蜂鸣器这种设备很简单，所以open函数是空的，这里只是执行了这么一个上锁操作，防止蜂鸣器设备被打开多次
		return 0;            //使用非阻塞的方式去尝试上锁
	else
		return -EBUSY;
	
}

本文出自 “whylinux” 博客，谢绝转载！