/*
 ================================================
 Name        : my2440_pwm.c
 Author      : Huang Gang
 Date        : 25/11/09
 Copyright   : GPL
 Description : my2440 pwm driver
 ================================================
 */

#include <linux/module.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/fs.h>
#include <linux/errno.h>
#include <linux/clk.h>
#include <linux/device.h>
#include <asm/io.h>
#include <mach/hardware.h>
#include <mach/regs-gpio.h>
#include <plat/regs-timer.h>

#define PWM_MAJOR 0                  //主裝置號
#define PWM_NAME "my2440_pwm"        //裝置名稱

static int device_major = PWM_MAJOR; //系統動態生成的主裝置號

//開啟裝置
static int pwm_open(struct inode *inode, struct file *file)
{
    //對GPB0複用口進行復用功能設定，設定為TOUT0 PWM輸出
    s3c2410_gpio_cfgpin(S3C2410_GPB0, S3C2410_GPB0_TOUT0);

    return 0;
}

//關閉裝置
static int pwm_close(struct inode *inode, struct file *file)
{
    return 0;
}

//對裝置進行控制
static int pwm_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsignedlong arg)
{
    if(cmd <= 0)//如果輸入的引數小於或等於0的話，就讓蜂鳴器停止工作
    {
        //這裡又恢復GPB0口為IO口輸出功能，由原理圖可知直接給低電平可讓蜂鳴器停止工作
        s3c2410_gpio_cfgpin(S3C2410_GPB0, S3C2410_GPB0_OUTP);
        s3c2410_gpio_setpin(S3C2410_GPB0, 0);
    }
    else//如果輸入的引數大於0，就讓蜂鳴器開始工作，不同的引數，蜂鳴器的頻率也不一樣
    {
        //定義一些區域性變數
        unsigned long tcon;
        unsigned long tcnt;
        unsigned long tcfg1;
        unsigned long tcfg0;

        struct clk *clk_p;
        unsigned long pclk;

        //以下對各暫存器的操作結合上面講的開始一個PWM定時器的步驟和2440手冊PWM暫存器操作部分來看就比較容易理解
        tcfg1 = __raw_readl(S3C2410_TCFG1);     //讀取定時器配置暫存器1的值
        tcfg0 = __raw_readl(S3C2410_TCFG0);     //讀取定時器配置暫存器0的值

        tcfg0 &= ~S3C2410_TCFG_PRESCALER0_MASK; 
        tcfg0 |= (50 - 1);                      //設定tcfg0的值為49

        tcfg1 &= ~S3C2410_TCFG1_MUX0_MASK;
        tcfg1 |= S3C2410_TCFG1_MUX0_DIV16;      //設定tcfg1的值為0x0011即：1/16

        __raw_writel(tcfg1, S3C2410_TCFG1);     //將值tcfg1寫入定時器配置暫存器1中
        __raw_writel(tcfg0, S3C2410_TCFG0);     //將值tcfg0寫入定時器配置暫存器0中

        clk_p = clk_get(NULL, "pclk"); 
        pclk = clk_get_rate(clk_p);   //從系統平臺時鐘佇列中獲取pclk的時鐘頻率，在include/linux/clk.h中定義
        tcnt = (pclk/50/16)/cmd;      //計算定時器0的輸出時鐘頻率(pclk/{prescaler0 + 1}/divider value)

        __raw_writel(tcnt, S3C2410_TCNTB(0));   //設定定時器0計數快取暫存器的值
        __raw_writel(tcnt/2, S3C2410_TCMPB(0)); //設定定時器0比較快取暫存器的值

        tcon = __raw_readl(S3C2410_TCON);       //讀取定時器控制暫存器的值
                   
        tcon &= ~0x1f;
        tcon |= 0xb;  //關閉死區、自動過載、關反相器、更新TCNTB0&TCMPB0、啟動定時器0
        __raw_writel(tcon, S3C2410_TCON);  //設定定時器控制暫存器的0-4位，即對定時器0進行控制
        
        tcon &= ~2;
        __raw_writel(tcon, S3C2410_TCON); //清除定時器0的手動更新位
    }

    return 0;
}

//裝置操作結構體
static struct file_operations pwm_fops = 
{
    .owner   = THIS_MODULE,
    .open    = pwm_open,
    .release = pwm_close,
    .ioctl   = pwm_ioctl,
};

//定義一個裝置類
static struct class *pwm_class;

static int __init pwm_init(void)
{
    //註冊為字元裝置，主裝置號為0讓系統自動分配，裝置名為my2440_pwm，註冊成功返回動態生成的主裝置號
    device_major = register_chrdev(PWM_MAJOR, PWM_NAME, &pwm_fops);

    if(device_major < 0)
    {
        printk(PWM_NAME " register falid!\n");
        return device_major;
    }

    //註冊一個裝置類，使mdev可以在/dev/目錄下自動建立裝置節點
    pwm_class = class_create(THIS_MODULE, PWM_NAME);

    if(IS_ERR(pwm_class))
    {
        printk(PWM_NAME " register class falid!\n");
        return -1;
    }

    //建立一個裝置節點，裝置名為PWM_NAME，即：my2440_pwm
    device_create(pwm_class, NULL, MKDEV(device_major, 0), NULL, PWM_NAME);

    return 0;
}

static void __exit pwm_exit(void)
{
    //登出裝置
    unregister_chrdev(device_major, PWM_NAME);

    //刪除裝置節點
    device_destroy(pwm_class, MKDEV(device_major, 0));

    //登出裝置類
    class_destroy(pwm_class);
}

module_init(pwm_init);
module_exit(pwm_exit);

MODULE_LICENSE("PGL");
MODULE_AUTHOR("Huang Gang");
MODULE_DESCRIPTION("my2440 pwm driver");

#cp -f my2440_pwm.c /linux-2.6.30.4/drivers/char //把驅動原始碼複製到核心驅動的字元裝置下

#gedit /linux-2.6.30.4/drivers/char/Kconfig //新增PWM蜂鳴器裝置配置

config MY2440_PWM_BEEP
    tristate "My2440 PWM Beep Device"
    depends on ARCH_S3C2440
    default y
    ---help---
      My2440 PWM Beep

#gedit /linux-2.6.30.4/drivers/char/Makefile //新增PWM蜂鳴器裝置配置

obj-$(CONFIG_MY2440_PWM_BEEP) += my2440_pwm.o

#make menuconfig

Device Drivers --->
    Character devices ---> 
        <*> My2440 PWM Beep Device (NEW)

/*
 ==============================================
 Name        : pwm_test.c
 Author      : Huang Gang
 Date        : 25/11/2009
 Copyright   : GPL
 Description : my2440 pwm driver test
 ==============================================
 */

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/ioctl.h>

int main(int argc, char **argv)
{
    int tmp;
    int fd;
    int i;

    //開啟蜂鳴器裝置
    fd = open("/dev/my2440_pwm", O_RDWR);

    if(fd < 0)
    {
        printf("Open PWM Device Faild!\n");
        exit(1);
    }

    //提示使用者輸入一個引數來對蜂鳴器進行調頻，0表示停止工作
    printf("please enter the times number(0 is stop):\n");

    while(1)
    {
        //輸入引數
        scanf("%d", &tmp);
        printf("times = %d\n", tmp);
        
        //IO控制
        ioctl(fd, tmp);

        if(tmp <= 0)
        {
            break;
        }
    }

    //關閉裝置
    close(fd);

    return 0;
}

#arm-linux-gcc -o pwm_test pwm_test.c