刚刚开始学习Linux下设备驱动程序,可能很多新手现在和毛毛一样对这个文件(arch/arm/mach-s3c2410/include/mach/gpio-nrs.h)有很多的不理解,在理解这个文件的同时,毛毛建议和linux/arch/arm/plat-s3c24xx/gpio.c这个文件一起理解。好吧,下面就和毛毛一起来学习吧!
1:首先毛毛将gpio-nrs.h的源码贴出来。
/* arch/arm/mach-s3c2410/include/mach/gpio-nrs.h
*
* Copyright (c) 2008 Simtec Electronics
* http://armlinux.simtec.co.uk/
* Ben Dooks <ben@simtec.co.uk>
*
* S3C2410 - GPIO bank numbering
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation.
*/
#ifndef __MACH_GPIONRS_H
#define __MACH_GPIONRS_H
#define S3C2410_GPIONO(bank,offset) ((bank) + (offset))
#define S3C2410_GPIO_BANKA (32*0)
#define S3C2410_GPIO_BANKB (32*1)
#define S3C2410_GPIO_BANKC (32*2)
#define S3C2410_GPIO_BANKD (32*3)
#define S3C2410_GPIO_BANKE (32*4)
#define S3C2410_GPIO_BANKF (32*5)
#define S3C2410_GPIO_BANKG (32*6)
#define S3C2410_GPIO_BANKH (32*7)
/* GPIO bank sizes */
#define S3C2410_GPIO_A_NR (32)
#define S3C2410_GPIO_B_NR (32)
#define S3C2410_GPIO_C_NR (32)
#define S3C2410_GPIO_D_NR (32)
#define S3C2410_GPIO_E_NR (32)
#define S3C2410_GPIO_F_NR (32)
#define S3C2410_GPIO_G_NR (32)
#define S3C2410_GPIO_H_NR (32)
#if CONFIG_S3C_GPIO_SPACE != 0
#error CONFIG_S3C_GPIO_SPACE cannot be zero at the moment
#endif
#define S3C2410_GPIO_NEXT(__gpio) \
((__gpio##_START) + (__gpio##_NR) + CONFIG_S3C_GPIO_SPACE + 0)
#ifndef __ASSEMBLY__
enum s3c_gpio_number {
S3C2410_GPIO_A_START = 0,
S3C2410_GPIO_B_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_A),
S3C2410_GPIO_C_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_B),
S3C2410_GPIO_D_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_C),
S3C2410_GPIO_E_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_D),
S3C2410_GPIO_F_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_E),
S3C2410_GPIO_G_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_F),
S3C2410_GPIO_H_START = S3C2410_GPIO_NEXT(S3C2410_GPIO_G),
};
#endif /* __ASSEMBLY__ */
/* S3C2410 GPIO number definitions. */
#define S3C2410_GPA(_nr) (S3C2410_GPIO_A_START + (_nr))
#define S3C2410_GPB(_nr) (S3C2410_GPIO_B_START + (_nr))
#define S3C2410_GPC(_nr) (S3C2410_GPIO_C_START + (_nr))
#define S3C2410_GPD(_nr) (S3C2410_GPIO_D_START + (_nr))
#define S3C2410_GPE(_nr) (S3C2410_GPIO_E_START + (_nr))
#define S3C2410_GPF(_nr) (S3C2410_GPIO_F_START + (_nr))
#define S3C2410_GPG(_nr) (S3C2410_GPIO_G_START + (_nr))
#define S3C2410_GPH(_nr) (S3C2410_GPIO_H_START + (_nr))
/* compatibility until drivers can be modified */
#define S3C2410_GPA0 S3C2410_GPA(0)
#define S3C2410_GPA1 S3C2410_GPA(1)
#define S3C2410_GPA3 S3C2410_GPA(3)
#define S3C2410_GPA7 S3C2410_GPA(7)
#define S3C2410_GPE0 S3C2410_GPE(0)
#define S3C2410_GPE1 S3C2410_GPE(1)
#define S3C2410_GPE2 S3C2410_GPE(2)
#define S3C2410_GPE3 S3C2410_GPE(3)
#define S3C2410_GPE4 S3C2410_GPE(4)
#define S3C2410_GPE5 S3C2410_GPE(5)
#define S3C2410_GPE6 S3C2410_GPE(6)
#define S3C2410_GPE7 S3C2410_GPE(7)
#define S3C2410_GPE8 S3C2410_GPE(8)
#define S3C2410_GPE9 S3C2410_GPE(9)
#define S3C2410_GPE10 S3C2410_GPE(10)
#define S3C2410_GPH10 S3C2410_GPH(10)
#endif /* __MACH_GPIONRS_H */
2:我们开始来解析这个源程序。
毛毛发现这个源程序基本上全部是宏定义,其中有一个宏定义毛毛不太明白
#define S3C2410_GPIO_NEXT(__gpio) \
((__gpio##_START) + (__gpio##_NR) + CONFIG_S3C_GPIO_SPACE + 0)
#ifndef __ASSEMBLY__
毛毛是个努力的小孩,通过查阅资料毛毛发现这段宏定义中的##表示把前后程序连接起来,
也就是这样的:S3C2410_GPIO_NEXT(S3C2410_GPIO_B)就等同于
((S3C2410_GPIO_B_START)+(S3C2410_GPIO_B_NR)+CONFIG_S3C_GPIO_SPACE + 0)
在阅读程序的过程中毛毛还发现,S3C2410_GPx(_nr)这个宏是一个很重要的宏,在接下来的IO控制程序中都有应用。
毛毛是比较乖的,他尝试把这个宏展开是什么样子的,最后展开得到是:
S3C2410_GPx(_nr)=(S3C2410_GPIO_x_START + (_nr))
S3C2410_GPx(_nr)=(S3C2410_GPIO_NEXT(S3C2410_GPIO_x) + (_nr))
S3C2410_GPx(_nr)=(((S3C2410_GPIO_(x-1)_START)+(S3C2410_GPIO_x_NR)+CONFIG_S3C_GPIO_SPACE + 0) + (_nr))
说明:(x-1)是毛毛个人的意思。即D-1=C,C-1=B,B-1=A;大家懂意思即可。
这个就是最后展开的宏:S3C2410_GPB(5)=0+32+0+0+5=37
最后我们最最想问的问题是Linux这样做是为了什么呢?
毛毛他说,在他的下一篇文章“Linux下arch/arm/mach-s3c2410/include/mach/gpio-nrs.h的理解”里面会讲到的。
细心的毛毛还发现,程序里面也这么一句
#define S3C2410_GPIONO(bank,offset) ((bank) + (offset))
我们按相同的方法将宏拆开S3C2410_GPIONO(S3C2410_GPIO_BANKA ,offset)=((S3C2410_GPIO_BANKA)+(offset))
S3C2410_GPB(5)=37,在上面我们已经得到啦。
S3C2410_GPIONO(S3C2410_GPIO_BANKB ,5)=S3C2410_GPIO_BANKB+5=32*1+5=37
在这里我们可以发现,S3C2410_GPx(_nr)和S3C2410_GPIONO(S3C2410_GPIO_BANKx ,_nr)是一样的作用。
毛毛个人估计是Linux系统在升级的过程中为了向下兼容才这样实现的