CSL学习笔记第八章GPIO模块

1、第八章GPIO模块8.1概述通过GPIO模块的设计以允许对 C55x器件中可用的非复用和地址GPIO引脚的核心控制。以下三个表格列出了该模块有关的函数，寄存器和宏定义。表8-1 GPIO函数GPIO_pinDirection设置GPIO引脚为输入或者输出GPIO_pinDisable禁止一个引脚作为 GPIO引脚GPIO_pinEnable使能一个引脚作为 GPIO引脚GPIO_pinRead读GPIO引脚的值GPIO_pinWrite向GPIO引脚写值卜面的函数是 C5501和C5502器件所支持。GPIO_colse释放一个或多个 GPIO引脚GPIO_config配置GPIO引脚GPIO

2、_open分配一个或多个 GPIO引脚到当前进程中GPIO_pinReadAll读一个或多个引脚的值GPIO_pinWriteAll写一个或多个引脚GPIO_pinReset复位一个或多个引脚表8-2 GPIO寄存器IODIR IO7DIR, IO6DIR, IO5DIR, IO4DIR, IO3DIR, IO2DIR, IO1DIR, IO0DIRIODATA IO7D, IO6D, IO5D, IO4D, IO3D, IO2D, IO1D, IO0DC5509 and C5509A 支持以下.AGPIOENIO13, IO12, IO11, IO10, IO9, IO8AGPIODIR I

3、O13DIR, IO12DIR, IO11DIR, IO10DIR, IO9DIR, IO8DIRAGPIODATA IO13D, IO12D, IO11D, IO10D, IO9D, IO8DC5502和C5501支持以下.PGPIOEN0 IO15EN, IO14EN, IO13EN, IO12EN, IO11EN, IO10EN, IO9EN, IO8EN,IO7EN, IO6EN, IO5EN, IO4EN, IO3EN, IO2EN, IO1EN, IO0ENPGPIODIR0IO15DIR, IO14DIR, IO13DIR, IO12DIR, IO11DIR, IO10DIR,

4、IO9DIR, IO8DIR,IO7DIR, IO6DIR, IO5DIR, IO4DIR, IO3DIR, IO2DIR, IO1DIRPGPIODAT0IO15DA T, IO14DAT, IO13DAT, IO12DA T, IO11DAT, IO10DAT, IO9DAT, IO8DAT,IO7DAT, IO6DAT, IO5DAT, IO4DAT, IO3DAT, IO2DAT, IO1DAT, IO0DATPGPIOEN1IO31EN, IO30EN, IO29EN, IO28EN, IO27EN, IO26EN, IO25EN, IO24EN,IO23EN, IO22EN, IO

5、21EN, IO20EN, IO19EN, IO18EN, IO17EN, IO16ENPGPIODIR1IO31DIR, IO30DIR, IO29DIR, IO28DIR, IO27DIR, IO26DIR, IO25DIR,IO24DIR, IO23DIR, IO22DIR, IO21DIR, IO20DIR, IO19DIR, IO18DIR,IO17DIR, IO16DIRPGPIODAT1IO31DA T, IO30DAT, IO29DAT, IO28DA T, IO27DAT, IO26DAT, IO25DA T,IO24DA T, IO23DAT, IO22DAT, IO20D

6、A T, IO19DAT, IO18DAT, IO17DA T, IO16DATPGPIOEN2IO45EN, IO44EN, IO43EN, IO42EN, IO41EN, IO40EN, IO39EN, IO38EN,IO37EN, IO36EN, IO35EN, IO34EN, IO33EN, IO32ENPGPIODIR2IO45DIR, IO44DIR, IO43DIR, IO42DIR, IO41DIR, IO40DIR, IO39DIR,IO38DIR, IO37DIR, IO36DIR, IO35DIR, IO34DIR, IO33DIR, IO32DIRPGPIODAT2IO

7、45DA T, IO44DAT, IO43DAT, IO42DA T, IO41DAT, IO40DAT, IO39DA T,IO38DA T, IO37DAT, IO36DAT, IO35DA T, IO34DAT, IO33DAT, IO32DA T8.2 配置结构体以下是建立GPIO的配置结构体GPIO_Config(非并行GPIO引脚配置结构体)成员列表： Uint16 ioen引脚使能寄存器 IOENUint16 iodir引脚方向寄存器 IODIR说明 ：建立非并行 GPIO引脚的GPIO配置结构体.创建并初始化该结构体，接着向GPIO_config()函数船体其地址。你可以通过使

8、用文本值或者GPIO_RMK宏来创建结构体成员值。GPIO_ConfigAll (并行和非并行 GPIO引脚的配置结构体)说明 ： GPIO配置结构体是用于建立并行和非并行GPIO弓I脚，.创建并初始化该结构体，接着向GPIO_configAll()函数船体其地址。你可以通过使用文本值或者GPIO_RMK宏来创建结构体成员值。 成员列表：Uint16 ioen非并行引脚使能寄存器IOENUint16 iodir非并行GPIO引脚方向寄存器IODIRUint16 pgpioen并行GPIO引脚使能寄存器0PGPIOEN0Uint16 pgpiodir并行GPIO引脚方向寄存器0PGPIODIR0

9、Uint16 pgpioen1并行GPIO引脚使能寄存器1PGPIOEN1Uint16 pgpiodir1并行GPIO引脚方向寄存器1PGPIODIR1Uint16 pgpioen2并行GPIO引脚使能寄存器 2PGPIOEN2Uint16 pgpiodir2并行GPIO引脚方向寄存器2PGPIODIR28.3 函数以下的函数被 C5502和C5501支持。GPIO_close(释放先前被 GPIO_open所占用的GPIO弓I脚)函数Void GPIO_(GPIO_Handle hGpio);参数hGpio GPIO引脚句柄(参见 GPIO_open()返回值 None说明释放先前被GPIO

10、_open所占用的GPIO弓I脚。实例GPIO_close(hGpio);GPIO_open(为单独使用占用 GPIO)函数 GPIO_Handle GPIO_open(Uint32 allocMask,Uint32 flags);参数 allocMask 占用的GPIO弓I脚，可以参见 GPIO_pinDirection查看可用的引 脚。flags打开标志，当前未指定。返回值 GPIO_Handle器件句柄说明 在一个GPIO引脚被使用前，必须要被该应用程序占用，一旦被占用了，就不 会在响应其他的请求，直到被GPIO_close()关闭。返回值是一个唯一的器件句 柄，该句柄用于随后的API调

11、用中的GPIO中。如果函数出错返回INV(-1)。对于 C5502 和 C5501,有四组 GPIO 弓 I脚(见 GPIO_pinDirection()在调用了 GPIO_open()的同一时刻只能打开一组中的一个或几个引脚，在不 同组中多次调用引脚的allocMask会产生未知结果。例如：GPIO_open()第一个参数是同一组的(GPIO_GPIO_PIN4 GPIO_GPIO_PIN2 )，但是(GPIO_GPIO_PIN4 | GPIO_PGPIO_PIN2)就会产生未 知结果。如果GPIO_open()在一个组中被调用了，在 GPIO_close被调用前，它就不能 再次调用来打开同

12、组的其他引脚。然而，GPIO_open()可以在此时被调用来打开其他组的引脚。例如：如果GPIO_open()第一次调用了 GPIO_GPIO_PIN4 ,他就不能再被调用 打开同组的的 GPIO_GPIO_PIN2,但是可以打开GPIO_PGPIO_PIN2.实例 GPIO_Handle hGpio;hGpio = GPIO_open(GPIO_PGPIO_PIN1,0);GPIO_config (向非并行寄存器写入值)函数void GPIO_config(GPIO_Handle hGpio,GPIO_Config *cfg);参数hGpio GPIO器件句柄Cfg初始化配置寄存器的指针返回

13、值无说明使用配置结构体向非并行GPIO控制寄存器写入值。注意：GPIO_Config 结构体对于 GPIOhe PGPIO 是通用的， 但 GPIO_config() 函数只对使能的 GPIO0:7.( The GPIO_config() function just discards the enable field in case of GPIO 0:7 pins.)实例 GPIO_Handle hGpio ;GPIO_Config myConfig = GPIO_PIN1_OUTPUT | GPIO_PIN3_OUTPUT 对5501和5502的配置hGpio = GPIO_open (G

14、PIO_GPIO_PIN1|GPIO_GPIO_PIN3,0) GPIO_config(hGpio &myconfig);GPIO_con巾gAll(向并行和非并行 GPIO控制寄存器写入值)函数void GPIO_config(GPIO_Con的All&gCfg)参数 gCfg上电和掉电非复用 GPIO引脚的配置结构体返回值无说明向并行和非并行 GPIO控制寄存器写入值，用法参见GPIO_ConfigAll实例 GPIO_ConfigAll gCfg = GPIO_PIN1_OUTPUT|GPIO_PIN3_OUTPUT, /*IODIR*/0,/*PGPIOEN0*/0,/

15、*PGPIODIR0*/0,/*PGPIOEN1*/0,/*PGPIODIR1*/0,/*PGPIOEN2*/0,/*PGPIODIR2*/ ;/*5501 和 5502 的 gpio 配置 */GPIO_configAll(&gCfg);GPIO_pinDirection(设置GPIO为输入或者输出)函数对于C5501和C5502void GPIO_pinDirection(GPIO_Handle hGpio,Uint32 pinMask,Uint16 direction);对于 C5509/A 和 C5510void GPIO_pinDirection(Uint32 pinMask

16、,Uint16 direction);参数 hGpio之前调用 GPIO_open()返回的GPIO句柄。(此参数只对 C5501/2)pinMask受方向影响的GPIO引脚 对于5501/2, pinMask可以是以下的： GPIO PinGroup 0 (非并行)：GPIO_GPIO_PIN0GPIO_GPIO_PIN1GPIO_GPIO_PIN2GPIO_GPIO_PIN3GPIO_GPIO_PIN4GPIO_GPIO_PIN5GPIO_GPIO_PIN6GPIO_GPIO_PIN7GPIO Pin Group 1 (并行 GPIO Pins 0-15):GPIO_PGPIO_PIN0G

17、PIO_PGPIO_PIN1GPIO_PGPIO_PIN2GPIO_PGPIO_PIN3GPIO_PGPIO_PIN4GPIO_PGPIO_PIN5GPIO_PGPIO_PIN6GPIO_PGPIO_PIN7GPIO_PGPIO_PIN8GPIO_PGPIO_PIN9GPIO_PGPIO_PIN10GPIO_PGPIO_PIN11GPIO_PGPIO_PIN12GPIO_PGPIO_PIN13GPIO_PGPIO_PIN14GPIO_PGPIO_PIN15GPIO Pin Group 2 （并行 GPIO Pins 16-31）:GPIO_PGPIO_PIN16GPIO_PGPIO_PIN17

18、GPIO_PGPIO_PIN18GPIO_PGPIO_PIN19GPIO_PGPIO_PIN20GPIO_PGPIO_PIN21GPIO_PGPIO_PIN22GPIO_PGPIO_PIN23GPIO_PGPIO_PIN24GPIO_PGPIO_PIN25GPIO_PGPIO_PIN26GPIO_PGPIO_PIN27GPIO_PGPIO_PIN28GPIO_PGPIO_PIN29GPIO_PGPIO_PIN30GPIO_PGPIO_PIN31GPIO Pin Group 3 （并行 GPIO Pins 32-45）:GPIO_PGPIO_PIN32GPIO_PGPIO_PIN33GPIO_P

19、GPIO_PIN34GPIO_PGPIO_PIN35GPIO_PGPIO_PIN36GPIO_PGPIO_PIN37GPIO_PGPIO_PIN38GPIO_PGPIO_PIN39GPIO_PGPIO_PIN40GPIO_PGPIO_PIN41GPIO_PGPIO_PIN42GPIO_PGPIO_PIN43GPIO_PGPIO_PIN44GPIO_PGPIO_PIN45pinMask可以是单独的某个引脚或者是同组几个引脚的组合（例如：GPIO_PGPIO_PIN23| GPIO_PGPIO_PIN30 ）。direction pinMask选定的引脚的方向标记GPIO Pin Group 0

20、（非并行 GPIO Pins）:GPIO_GPIO_PIN0_OUTPUT GPIO_GPIO_PIN1_OUTPUT GPIO_GPIO_PIN2_OUTPUT GPIO_GPIO_PIN3_OUTPUT GPIO_GPIO_PIN4_OUTPUT GPIO_GPIO_PIN5_OUTPUT GPIO_GPIO_PIN6_OUTPUT GPIO_GPIO_PIN7_OUTPUT GPIO_GPIO_PIN0_INPUT GPIO_GPIO_PIN1_INPUT GPIO_GPIO_PIN2_INPUT GPIO_GPIO_PIN3_INPUTGPIO_GPIO_PIN4_INPUT GPIO

21、_GPIO_PIN5_INPUT GPIO_GPIO_PIN6_INPUT GPIO_GPIO_PIN7_INPUTGPIO Pin Group 1 （并行 GPIO Pins 0-15）:GPIO_PGPIO_PIN0_OUTPUT GPIO_PGPIO_PIN1_OUTPUT GPIO_PGPIO_PIN2_OUTPUT GPIO_PGPIO_PIN3_OUTPUT GPIO_PGPIO_PIN4_OUTPUT GPIO_PGPIO_PIN5_OUTPUT GPIO_PGPIO_PIN6_OUTPUT GPIO_PGPIO_PIN7_OUTPUT GPIO_PGPIO_PIN8_OUTPU

22、T GPIO_PGPIO_PIN9_OUTPUT GPIO_PGPIO_PIN10_OUTPUT GPIO_PGPIO_PIN11_OUTPUT GPIO_PGPIO_PIN12_OUTPUT GPIO_PGPIO_PIN13_OUTPUT GPIO_PGPIO_PIN14_OUTPUTGPIO_PGPIO_PIN15_OUTPUT GPIO_PGPIO_PIN0_INPUT GPIO_PGPIO_PIN1_INPUT GPIO_PGPIO_PIN2_INPUT GPIO_PGPIO_PIN3_INPUT GPIO_PGPIO_PIN4_INPUT GPIO_PGPIO_PIN5_INPUT

23、GPIO_PGPIO_PIN6_INPUT GPIO_PGPIO_PIN7_INPUT GPIO_PGPIO_PIN8_INPUTGPIO_PGPIO_PIN9_INPUTGPIO_PGPIO_PIN10_INPUTGPIO_PGPIO_PIN11_INPUTGPIO_PGPIO_PIN12_INPUTGPIO_PGPIO_PIN13_INPUTGPIO_PGPIO_PIN14_INPUTGPIO_PGPIO_PIN15_INPUTGPIO Pin Group 2 （并行 GPIO Pins 16-31）:GPIO_PGPIO_PIN16_OUTPUTGPIO_PGPIO_PIN17_OUTP

24、UTGPIO_PGPIO_PIN18_OUTPUTGPIO_PGPIO_PIN19_OUTPUTGPIO_PGPIO_PIN20_OUTPUTGPIO_PGPIO_PIN21_OUTPUTGPIO_PGPIO_PIN22_OUTPUTGPIO_PGPIO_PIN23_OUTPUTGPIO_PGPIO_PIN24_OUTPUTGPIO_PGPIO_PIN25_OUTPUTGPIO_PGPIO_PIN26_OUTPUTGPIO_PGPIO_PIN27_OUTPUTGPIO_PGPIO_PIN28_OUTPUTGPIO_PGPIO_PIN29_OUTPUTGPIO_PGPIO_PIN30_OUTPU

25、TGPIO_PGPIO_PIN31_OUTPUTGPIO_PGPIO_PIN16_INPUTGPIO_PGPIO_PIN17_INPUTGPIO_PGPIO_PIN18_INPUTGPIO_PGPIO_PIN19_INPUTGPIO_PGPIO_PIN20_INPUTGPIO_PGPIO_PIN21_INPUTGPIO_PGPIO_PIN22_INPUTGPIO_PGPIO_PIN23_INPUTGPIO_PGPIO_PIN24_INPUTGPIO_PGPIO_PIN25_INPUTGPIO_PGPIO_PIN26_INPUTGPIO_PGPIO_PIN27_INPUTGPIO_PGPIO_P

26、IN28_INPUTGPIO_PGPIO_PIN29_INPUTGPIO_PGPIO_PIN30_INPUTGPIO_PGPIO_PIN31_INPUTGPIO Pin Group 3 （并行 GPIO Pins 32-45）:GPIO_PGPIO_PIN32_OUTPUTGPIO_PGPIO_PIN33_OUTPUTGPIO_PGPIO_PIN34_OUTPUTGPIO_PGPIO_PIN35_OUTPUTGPIO_PGPIO_PIN36_OUTPUTGPIO_PGPIO_PIN37_OUTPUTGPIO_PGPIO_PIN38_OUTPUTGPIO_PGPIO_PIN39_OUTPUTGP

27、IO_PGPIO_PIN40_OUTPUTGPIO_PGPIO_PIN41_OUTPUTGPIO_PGPIO_PIN42_OUTPUTGPIO_PGPIO_PIN43_OUTPUTGPIO_PGPIO_PIN44_OUTPUTGPIO_PGPIO_PIN45_OUTPUTGPIO_PGPIO_PIN32_INPUTGPIO_PGPIO_PIN33_INPUTGPIO_PGPIO_PIN34_INPUTGPIO_PGPIO_PIN35_INPUTGPIO_PGPIO_PIN36_INPUTGPIO_PGPIO_PIN37_INPUTGPIO_PGPIO_PIN38_INPUTGPIO_PGPIO

28、_PIN39_INPUTGPIO_PGPIO_PIN40_INPUTGPIO_PGPIO_PIN41_INPUTGPIO_PGPIO_PIN42_INPUTGPIO_PGPIO_PIN43_INPUTGPIO_PGPIO_PIN44_INPUTGPIO_PGPIO_PIN45_INPUT方向可以由任何上面定义过的符号常量来设置，同组的多个引脚可以用或操作进行设置比如：GPIO_PGPIO_PIN45_INPUT | GPIO_PGPIO_PIN40_OUTPUT返回值无说明设置一个或多个GPIO的方向实例/*设置pgpio为输入*/GPIO_handle hGpio = GPIO_openGP

29、IO_PGPIO_PIN1|GPIO_PGPIO_PIN15; GPIO_pinDirection(hGpio,GPIO_PGPIO_PIN1_INPUT);GPIO_pinDisable.(禁止一个引脚作为 GPIO弓I脚)函数对于5501/2:Void GPIO_pinDisable(GPIO_Handle hGpio,Uint32 pinId)对于 5509/a, 5510:Void GPIO_pinDisable(Uint32 pinId)参数 hGpio 由GPIO_open返回的GPIO句柄(仅对 5501/2 CSL) pinId禁止的引脚，参见 GPIO_pinDirectio

30、n()查看引脚号。返回值无说明禁止一个或多个 GPIO引脚实例/*禁止PGPIO1作为GPIO*/GPIO_handle hGpio = GPIO_open (GPIO_GPIO_PIN1|GPIO_GPIO_PIN15);GPIO_pinDisable(hGpio,GPIO_GPIO_PIN1);GPIO_pinEnable(使能一个引脚作为 GPIO)函数对于5501/2:Void GPIO_pinEnable(GPIO_Handle hGpio,Uint32 pinld)对于 5509/A,5510 :Void GPIO_pinEnable(Uint32 pinId)参数 hGpio 由

31、GPIO_open返回的GPIO句柄(仅对 5501/2 CSL) pinId 使能的引脚，参见 GPIO_pinDirection()查看引脚号。返回值无说明使能一个GPIO引脚实例GPIO_pinEnable(hGpio,GPIO_GPIO_PIN1)GPIO_pinRead (读 GPIO 引脚值)函数对于5501/2:int GPIO_pinRead(GPIO_Handle hGpio,Uint32 pinId)对于 5509/A,5510:int GPIO_pinRead(Uint32 pinId)参数 hGpio 由GPIO_open返回的GPIO句柄(仅对 5501/2 CSL)

32、pinId 要读的引脚返回值读出的值(0或1)说明读输入引脚的值实例int val;val = GPIO_pinRead(hGpio,GPIO_GPIO_PIN1);GPIO_pinReadAll(从一个或多个GPIO引脚上读回值)函数对于5501/5502:Int GPIO_pinReadAll(GPIO_Handle hGpio,Uint32 pinMask);对于 5509/A,5510 :Int GPIO_pinReadAll(Uint32 pinMask)参数 hGpio由GPIO_open返回的GPIO句柄(仅对 5501/2 CSL) pinMask要读的GPIO引脚号，参见 G

33、PIO_pinDirection()查看引脚号 返回值 value读出的GPIO引脚值说明 读出pinMask指定的GPIO引脚的值。(该函数返回代替引脚的值，.Thefunction returnsthe value in place of the pins. It does not right-justify the value to return a rawresult.)实例 int val;/*读IO0和IO7引脚的值*/val = GPIO_pinReadAll(hGpio,GPIO_GPIO_PIN0|GPIO_GPIO_PIN7); GPIO_pinWrite(向一个GPIO引

34、脚写入值) 函数对于5501/2 :Void GPIO_pinWrite(GPIO_Handle hGpio ,Uint32 pinMask ,Uint16 val)对于 5509/A,5510 :Void GPIO_pinWrite(Uint32 pinMask,Uint16 val)参数 hGpio 由GPIO_open返回的GPIO句柄(仅对 5501/2 CSL ) pinMask要写的GPIO引脚号，参见 GPIO_pinDirection()查看引脚号 val 向GPIO引脚写入的值(0或1)返回值无说明向GPIO输出引脚写入值。实例/*向pin0和pin5写入1*/GPIO_pi

35、nWrite (hGpio,GPIO_GPIO_PIN0|GPIO_GPIO_PIN5,1) GPIO_pinWriteAll (向一个或者多个 GPIO引脚写入值) 函数对于 C5502 and C5501:void GPIO_pinWriteAll(GPIO_Handle hGpio,Uint32 pinMask, Uint16 val) 对于 C5509/C5509A/C5510:void GPIO_pinWriteAll(Uint32 pinMask, Uint16 val)参数 hGpio 由GPIO_open返回的GPIO句柄(仅对 5501/2 CSL) pinMask要写的GPIO引脚号，参见 GPIO_pinDirection()查看引脚号。 val 向GPIO引脚写入的值(0或1)返回值无说明向一个或多个输出 GPIO引脚写入值， (Ths function assumes anin-place value mask for writing to the GPIO pins. It will not left-justify values.)实例 /*向pin0和pin5写入1*/GPIO_pinWrite All(hGpio,GPIO_GPIO_PIN0|GPIO_GPIO_PIN5,1)GPIO_pinReset (复位G