//定義LED設備的名稱，這里是leds，這個模塊加載后，會自動在/dev目錄里創(chuàng)建該名字的設備文件。
#define DEVICE_NAME "leds"

//mini2440開發(fā)板上有4個LED（發(fā)光二極管）;
//這4個LED分別與S3C2440A的4個GPIO（通用可編程輸入輸出端口）的PIN（引腳）相連接；
//這4個GPIO應該被配置為輸出模式，當GPIO設為0時，PIN輸出低電平，LED將被點亮，
//而當GPIO設為1時，PIN輸出高電平，LED將被熄滅。






//這里定義靜態(tài)的全局的長整型數(shù)組，用于儲存與這4個LED相連接的GPIO號。
static unsigned long led_table [] = {
S3C2410_GPB5,
S3C2410_GPB6,
S3C2410_GPB7,
S3C2410_GPB8,
};

//這里定義靜態(tài)的全局的整型數(shù)組，用于儲存這4個GPIO的配置，這里為輸出模式。
static unsigned int led_cfg_table [] = {
S3C2410_GPB5_OUTP,
S3C2410_GPB6_OUTP,
S3C2410_GPB7_OUTP,
S3C2410_GPB8_OUTP,
};

//當應用層的ioctl(fd, cmd, arg)被調(diào)用時，系統(tǒng)將處理它能識別的命令；
//如果系統(tǒng)不能識別該命令，那么驅(qū)動層的ioctl將會被調(diào)用；
//如果驅(qū)動層的ioctl也不能識別該命令，應該返回-EINVAL。
static int sbc2440_leds_ioctl(
struct inode *inode,
struct file *file,
unsigned int cmd, //命令號
unsigned long arg) //參數(shù)
{
switch(cmd) { //通過switch（分支選擇）對cmd（命令）進行識別
case 0: //熄滅LED命令
case 1: //點亮LED命令
if (arg > 4) { //這里的arg（參數(shù)）是LED號，因為mini2440開發(fā)板上只有4個LED，所以arg只能取0、1、2、3
return -EINVAL; //輸入不合法，返回-EINVAL
}
s3c2410_gpio_setpin( //s3c2410_gpio_setpin()函數(shù)用于設置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是文件操作結構體，
//用于存放設備能進行的各種操作的函數(shù)指針。
static struct file_operations dev_fops = {
.owner = THIS_MODULE, //為了防止設備在使用的過程中，模塊被缷載掉，owner應該設置為THIS_MODULE
.ioctl = sbc2440_leds_ioctl, //ioctl函數(shù)指針指向上面的sbc2440_leds_ioctl()函數(shù)
};

//struct miscdevice是混雜設備結構體
static struct miscdevice misc = {
.minor = MISC_DYNAMIC_MINOR, //動態(tài)分配LED設備的次設備號
.name = DEVICE_NAME, //name是設備名，在上面定義了DEVICE_NAME
.fops = &dev_fops, //文件操作結構體指針fops指向上面的dev_fops
};

//設備初始化函數(shù)，加上__init，模塊加載時，dev_init()函數(shù)將被調(diào)用
static int __init dev_init(void)
{
int ret;

int i;

for (i = 0; i < 4; i++) { //4個LED
s3c2410_gpio_cfgpin( //s3c2410_gpio_cfgpin()函數(shù)用于配置GPIO的功能
led_table[i], //把LED號轉換為GPIO號
led_cfg_table[i] //輸出模式
);

s3c2410_gpio_setpin( //s3c2410_gpio_setpin()函數(shù)用于設置GPIO的PIN的電平
led_table[i], //把LED號轉換為GPIO號
0); //PIN輸出低電平，LED將被點亮
}

//注冊混雜設備misc
ret = misc_register(&misc);

//輸出LED設備初始化完成
printk (DEVICE_NAME"tinitializedn");

return ret;
}

//設備移除函數(shù)，加上__exit，模塊缷載時，dev_exit()函數(shù)將被調(diào)用
static void __exit dev_exit(void)
{
//取消注冊混雜設備misc
misc_deregister(&misc);
}

module_init(dev_init); //模塊加載時，dev_init()函數(shù)將被調(diào)用
module_exit(dev_exit); //模塊缷載時，dev_exit()函數(shù)將被調(diào)用
MODULE_LICENSE("GPL"); //模塊的許可權限，這里是GPL協(xié)議
MODULE_AUTHOR("FriendlyARM Inc."); //