解析mini2440的LED驱动

//定义LED设备的名称，这里是leds，这个模块加载后，会自动在/dev目录里创建该名字的设备文件。
#define DEVICE_NAME "leds"

//mini2440开发板上有4个LED（发光二极管）;
//这4个LED分别与S3C2440A的4个GPIO（通用可编程输入输出端口）的PIN（引脚）相连接；
//这4个GPIO应该被配置为输出模式，当GPIO设为0时，PIN输出低电平，LED将被点亮，
//而当GPIO设为1时，PIN输出高电平，LED将被熄灭。






//这里定义静态的全局的长整型数组，用于储存与这4个LED相连接的GPIO号。
static unsigned long led_table [] = {
    S3C2410_GPB5,
    S3C2410_GPB6,
    S3C2410_GPB7,
    S3C2410_GPB8,
};

//这里定义静态的全局的整型数组，用于储存这4个GPIO的配置，这里为输出模式。
static unsigned int led_cfg_table [] = {
    S3C2410_GPB5_OUTP,
    S3C2410_GPB6_OUTP,
    S3C2410_GPB7_OUTP,
    S3C2410_GPB8_OUTP,
};

//当应用层的ioctl(fd, cmd, arg)被调用时，系统将处理它能识别的命令；
//如果系统不能识别该命令，那么驱动层的ioctl将会被调用；
//如果驱动层的ioctl也不能识别该命令，应该返回-EINVAL。
static int sbc2440_leds_ioctl(
    struct inode *inode,
    struct file *file,
    unsigned int cmd,    //命令号
    unsigned long arg)  //参数
{
    switch(cmd) { //通过switch（分支选择）对cmd（命令）进行识别
    case 0:            //熄灭LED命令
    case 1:            //点亮LED命令
        if (arg > 4) {         //这里的arg（参数）是LED号，因为mini2440开发板上只有4个LED，所以arg只能取0、1、2、3
            return -EINVAL; //输入不合法，返回-EINVAL
        }
        s3c2410_gpio_setpin(          //s3c2410_gpio_setpin()函数用于设置GPIO的PIN的电平
                            led_table[arg], //把LED号转换为GPIO号
                            !cmd                //0是熄灭LED命令，PIN输出高电平，LED将被熄灭
                            );                      //1是点亮LED命令，PIN输出低电平，LED将被点亮
        return 0;                              //成功操作，应该返回0
    default:
        return -EINVAL;                    //不能识别该命令，应该返回-EINVAL
    }
}

//struct file_operations是文件操作结构体，
//用于存放设备能进行的各种操作的函数指针。
static struct file_operations dev_fops = {
    .owner    =    THIS_MODULE,            //为了防止设备在使用的过程中，模块被缷载掉，owner应该设置为THIS_MODULE
    .ioctl    =    sbc2440_leds_ioctl,         //ioctl函数指针指向上面的sbc2440_leds_ioctl()函数
};

//struct miscdevice是混杂设备结构体
static struct miscdevice misc = {
    .minor = MISC_DYNAMIC_MINOR,    //动态分配LED设备的次设备号
    .name = DEVICE_NAME,                  //name是设备名，在上面定义了DEVICE_NAME
    .fops = &dev_fops,                           //文件操作结构体指针fops指向上面的dev_fops
};

//设备初始化函数，加上__init，模块加载时，dev_init()函数将被调用
static int __init dev_init(void)
{
    int ret;

    int i;
   
    for (i = 0; i < 4; i++) {                   //4个LED
        s3c2410_gpio_cfgpin(                //s3c2410_gpio_cfgpin()函数用于配置GPIO的功能  
        led_table[i],                                //把LED号转换为GPIO号 
        led_cfg_table[i]                          //输出模式
        );
       
        s3c2410_gpio_setpin(                //s3c2410_gpio_setpin()函数用于设置GPIO的PIN的电平
                            led_table[i],            //把LED号转换为GPIO号 
                            0);                          //PIN输出低电平，LED将被点亮
    }

    //注册混杂设备misc
    ret = misc_register(&misc);

    //输出LED设备初始化完成
    printk (DEVICE_NAME"\tinitialized\n");

    return ret;
}

//设备移除函数，加上__exit，模块缷载时，dev_exit()函数将被调用
static void __exit dev_exit(void)
{
    //取消注册混杂设备misc
    misc_deregister(&misc);
}

module_init(dev_init);                             //模块加载时，dev_init()函数将被调用
module_exit(dev_exit);                           //模块缷载时，dev_exit()函数将被调用
MODULE_LICENSE("GPL");                      //模块的许可权限，这里是GPL协议
MODULE_AUTHOR("FriendlyARM Inc."); //模块的作者－－友善之臂公司