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

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






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

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

//當(dāng)應(yīng)用層的ioctl(fd, cmd, arg)被調(diào)用時(shí)，系統(tǒng)將處理它能識(shí)別的命令；
//如果系統(tǒng)不能識(shí)別該命令，那么驅(qū)動(dòng)層的ioctl將會(huì)被調(diào)用；
//如果驅(qū)動(dòng)層的ioctl也不能識(shí)別該命令，應(yīng)該返回-EINVAL。
static int sbc2440_leds_ioctl(
struct inode *inode,
struct file *file,
unsigned int cmd, //命令號(hào)
unsigned long arg) //參數(shù)
{
switch(cmd) { //通過(guò)switch（分支選擇）對(duì)cmd（命令）進(jìn)行識(shí)別
case 0: //熄滅LED命令
case 1: //點(diǎn)亮LED命令
if (arg > 4) { //這里的arg（參數(shù)）是LED號(hào)，因?yàn)閙ini2440開(kāi)發(fā)板上只有4個(gè)LED，所以arg只能取0、1、2、3
return -EINVAL; //輸入不合法，返回-EINVAL
}
s3c2410_gpio_setpin( //s3c2410_gpio_setpin()函數(shù)用于設(shè)置GPIO的PIN的電平
led_table[arg], //把LED號(hào)轉(zhuǎn)換為GPIO號(hào)
!cmd //0是熄滅LED命令，PIN輸出高電平，LED將被熄滅
); //1是點(diǎn)亮LED命令，PIN輸出低電平，LED將被點(diǎn)亮
return 0; //成功操作，應(yīng)該返回0
default:
return -EINVAL; //不能識(shí)別該命令，應(yīng)該返回-EINVAL
}
}

//struct file_operations是文件操作結(jié)構(gòu)體，
//用于存放設(shè)備能進(jìn)行的各種操作的函數(shù)指針。
static struct file_operations dev_fops = {
.owner = THIS_MODULE, //為了防止設(shè)備在使用的過(guò)程中，模塊被缷載掉，owner應(yīng)該設(shè)置為T(mén)HIS_MODULE
.ioctl = sbc2440_leds_ioctl, //ioctl函數(shù)指針指向上面的sbc2440_leds_ioctl()函數(shù)
};

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

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

int i;

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

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

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

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

return ret;
}

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

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