CSL學(xué)習(xí)筆記--第八章GPIO模塊

1、第八章GPIO 模塊8.1 概述通過 GPIO 模塊的設(shè)計以允許對 C55x 器件中可用的非復(fù)用和地址 GPIO 引腳的核心控制。以下三個表格列出了該模塊有關(guān)的函數(shù)，寄存器和宏定義。表 8-1 GPIO 函數(shù)GPIO_pinDirection設(shè)置 GPIO 引腳為輸入或者輸出GPIO_pinDisable禁止一個引腳作為GPIO 引腳GPIO_pinEnable使能一個引腳作為GPIO 引腳GPIO_pinRead讀 GPIO 引腳的值GPIO_pinWrite向 GPIO 引腳寫值下面的函數(shù)是C5501 和 C5502 器件所支持。GPIO_colse釋放一個或多個GPIO 引腳GPIO_c

2、onfig配置 GPIO 引腳GPIO_open分配一個或多個GPIO 引腳到當(dāng)前進程中GPIO_pinReadAll讀一個或多個引腳的值GPIO_pinWriteAll寫一個或多個引腳GPIO_pinReset復(fù)位一個或多個引腳表 8-2 GPIO 寄存器IODIRIO7DIR, IO6DIR, IO5DIR, IO4DIR, IO3DIR, IO2DIR, IO1DIR, IO0DIRIODATAIO7D, IO6D, IO5D, IO4D, IO3D, IO2D, IO1D, IO0DC5509 and C5509A 支持以下 .AGPIOENIO13, IO12, IO11, IO10

3、, IO9, IO8AGPIODIRIO13DIR, IO12DIR, IO11DIR, IO10DIR, IO9DIR, IO8DIRAGPIODATAIO13D, IO12D, IO11D, IO10D, IO9D, IO8DC5502 和 C5501 支持以下 .PGPIOEN0IO15EN, IO14EN, IO13EN, IO12EN, IO11EN, IO10EN, IO9EN, IO8EN,PGPIODIR0PGPIODA T0PGPIOEN1PGPIODIR1PGPIODA T1PGPIOEN2PGPIODIR2PGPIODA T2IO7EN, IO6EN, IO5EN, IO

4、4EN, IO3EN, IO2EN, IO1EN, IO0ENIO15DIR, IO14DIR, IO13DIR, IO12DIR, IO11DIR, IO10DIR, IO9DIR, IO8DIR,IO7DIR, IO6DIR, IO5DIR, IO4DIR, IO3DIR, IO2DIR, IO1DIRIO15DA T, IO14DAT, IO13DAT, IO12DA T, IO11DAT, IO10DAT, IO9DAT, IO8DAT,IO7DAT, IO6DAT, IO5DAT, IO4DAT, IO3DAT, IO2DAT, IO1DAT, IO0DATIO31EN, IO30E

5、N, IO29EN, IO28EN, IO27EN, IO26EN, IO25EN, IO24EN,IO23EN, IO22EN, IO21EN, IO20EN, IO19EN, IO18EN, IO17EN, IO16ENIO31DIR, IO30DIR, IO29DIR, IO28DIR, IO27DIR, IO26DIR, IO25DIR,IO24DIR, IO23DIR, IO22DIR, IO21DIR, IO20DIR, IO19DIR, IO18DIR,IO17DIR, IO16DIRIO31DA T, IO30DAT, IO29DAT, IO28DA T, IO27DAT, I

6、O26DAT, IO25DA T,IO24DA T, IO23DAT, IO22DAT, IO20DA T, IO19DAT, IO18DAT, IO17DA T,IO16DA TIO45EN, IO44EN, IO43EN, IO42EN, IO41EN, IO40EN, IO39EN, IO38EN,IO37EN, IO36EN, IO35EN, IO34EN, IO33EN, IO32ENIO45DIR, IO44DIR, IO43DIR, IO42DIR, IO41DIR, IO40DIR, IO39DIR,IO38DIR, IO37DIR, IO36DIR, IO35DIR, IO3

7、4DIR, IO33DIR, IO32DIRIO45DA T, IO44DAT, IO43DAT, IO42DA T, IO41DAT, IO40DAT, IO39DA T,IO38DA T, IO37DAT, IO36DAT, IO35DA T, IO34DAT, IO33DAT, IO32DA T8.2 配置結(jié)構(gòu)體以下是建立GPIO 的配置結(jié)構(gòu)體GPIO_Config( 非并行 GPIO 引腳配置結(jié)構(gòu)體)成員列表：Uint16 ioen引腳使能寄存器IOENUint16 iodir引腳方向寄存器IODIR說明：建立非并行GPIO 引腳的 GPIO 配置結(jié)構(gòu)體.創(chuàng)建并初始化該結(jié)構(gòu)體，接著向G

8、PIO_config() 函數(shù)船體其地址。 你可以通過使用文本值或者GPIO_RMK宏來創(chuàng)建結(jié)構(gòu)體成員值。GPIO_ConfigAll （并行和非并行 GPIO 引腳的配置結(jié)構(gòu)體）說明:GPIO 配置結(jié)構(gòu)體是用于建立并行和非并行GPIO 引腳， .創(chuàng)建并初始化該結(jié)構(gòu)體，接著向GPIO_configAll() 函數(shù)船體其地址。你可以通過使用文本值或者GPIO_RMK 宏來創(chuàng)建結(jié)構(gòu)體成員值。成員列表：Uint16 ioen非并行引腳使能寄存器IOENUint16 iodir非并行 GPIO 引腳方向寄存器IODIRUint16 pgpioen并行 GPIO 引腳使能寄存器 0PGPIOEN0Uin

9、t16 pgpiodir并行 GPIO 引腳方向寄存器 0PGPIODIR0Uint16 pgpioen1并行 GPIO 引腳使能寄存器 1PGPIOEN1Uint16 pgpiodir1并行 GPIO 引腳方向寄存器 1PGPIODIR1Uint16 pgpioen2并行 GPIO 引腳使能寄存器 2PGPIOEN2Uint16 pgpiodir2并行 GPIO 引腳方向寄存器 2PGPIODIR28.3 函數(shù)以下的函數(shù)被C5502和C5501支持。GPIO_close(釋放先前被GPIO_open所占用的GPIO 引腳)函數(shù)Void GPIO_(GPIO_Handle hGpio);參數(shù)h

10、GpioGPIO引腳句柄（參見GPIO_open() ）返回值None說明釋放先前被GPIO_open所占用的GPIO引腳。實例GPIO_close(hGpio);GPIO_open (為單獨使用占用 GPIO)函數(shù)GPIO_Handle GPIO_open(Uint32 allocMask,Uint32 flags);參數(shù)allocMask占用的 GPIO 引腳，可以參見GPIO_pinDirection 查看可用的引腳。flags打開標(biāo)志，當(dāng)前未指定。返回值GPIO_Handle 器件句柄說明在一個 GPIO 引腳被使用前，必須要被該應(yīng)用程序占用，一旦被占用了，就不會在響應(yīng)其他的請求，直到

11、被 GPIO_close() 關(guān)閉。 返回值是一個唯一的器件句柄，該句柄用于隨后的API 調(diào)用中的 GPIO 中。如果函數(shù)出錯返回INV(-1) 。對于 C5502和 C5501，有四組 GPIO 引腳（見 GPIO_pinDirection() ）在調(diào)用了 GPIO_open()的同一時刻只能打開一組中的一個或幾個引腳，在不同組中多次調(diào)用引腳的allocMask 會產(chǎn)生未知結(jié)果。例 如 ： GPIO_open() 第 一 個 參 數(shù) 是 同 一 組 的 （ GPIO_GPIO_PIN4|GPIO_GPIO_PIN2 ），但是 (GPIO_GPIO_PIN4 | GPIO_PGPIO_PIN2

12、)就會產(chǎn)生未知結(jié)果。如果 GPIO_open() 在一個組中被調(diào)用了，在GPIO_close 被調(diào)用前，它就不能再次調(diào)用來打開同組的其他引腳。然而，GPIO_open() 可以在此時被調(diào)用來打開其他組的引腳。例如：如果 GPIO_open() 第一次調(diào)用了 GPIO_GPIO_PIN4 ，他就不能再被調(diào)用打開同組的的 GPIO_GPIO_PIN2, 但是可以打開 GPIO_PGPIO_PIN2.實例GPIO_Handle hGpio;hGpio = GPIO_open(GPIO_PGPIO_PIN1,0);GPIO_config(向非并行寄存器寫入值)函數(shù)void GPIO_config(GP

13、IO_Handle hGpio,GPIO_Config *cfg);參數(shù)hGpioGPIO 器件句柄Cfg初始化配置寄存器的指針返回值無實例GPIO注意： GPIO_Config 結(jié)構(gòu)體對于GPIOhe PGPIO 是通用的， 但 GPIO_config()函數(shù)只對使能的GPIO0:7.( The GPIO_config() function just discards theenable field in case of GPIO 0:7 pins.)GPIO_Handle hGpio ;GPIO_Config myConfig = GPIO_PIN1_OUTPUT | GPIO_PIN3_

14、OUTPUT 對 5501 和 5502 的配置hGpio = GPIO_open (GPIO_GPIO_PIN1|GPIO_GPIO_PIN3,0)GPIO_config(hGpio &myconfig);GPIO_configAll(向并行和非并行GPIO 控制寄存器寫入值 )函數(shù)void GPIO_config(GPIO_ConfigAll&gCfg)參數(shù)gCfg上電和掉電非復(fù)用GPIO 引腳的配置結(jié)構(gòu)體返回值無說明向并行和非并行 GPIO 控制寄存器寫入值，用法參見GPIO_ConfigAll實例GPIO_ConfigAll gCfg = GPIO_PIN1_OUTPU

15、T|GPIO_PIN3_OUTPUT,/*IODIR*/0,/*PGPIOEN0*/0,/*PGPIODIR0*/0,/*PGPIOEN1*/0,/*PGPIODIR1*/0,/*PGPIOEN2*/0,/*PGPIODIR2*/;/*5501和 5502 的 gpio 配置 */GPIO_configAll(&gCfg);GPIO_pinDirection( 設(shè)置 GPIO 為輸入或者輸出)函數(shù)對于 C5501 和 C5502void GPIO_pinDirection(GPIO_Handle hGpio,Uint32 pinMask,Uint16 direction); 對于 C5

16、509/A 和 C5510void GPIO_pinDirection(Uint32 pinMask,Uint16 direction);參數(shù)hGpio之前調(diào)用 GPIO_open() 返回的 GPIO 句柄。（此參數(shù)只對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_PI

17、N7GPIO Pin Group 1 ( 并行GPIO Pins 0-15):GPIO_PGPIO_PIN0GPIO_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

18、2 ( 并行GPIO Pins 16-31):GPIO_PGPIO_PIN16GPIO_PGPIO_PIN17GPIO_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 ( 并行

19、 GPIO Pins 32-45):GPIO_PGPIO_PIN32GPIO_PGPIO_PIN33GPIO_PGPIO_PIN34GPIO_PGPIO_PIN35GPIO_PGPIO_PIN36GPIO_PGPIO_PIN37GPIO_PGPIO_PIN38GPIO_PGPIO_PIN39GPIO_PGPIO_PIN40GPIO_PGPIO_PIN41GPIO_PGPIO_PIN42GPIO_PGPIO_PIN43GPIO_PGPIO_PIN44GPIO_PGPIO_PIN45pinMask可 以 是 單 獨 的 某 個引 腳 或 者 是 同 組 幾 個 引 腳 的 組 合 （ 例 如 ：G

20、PIO_PGPIO_PIN23| GPIO_PGPIO_PIN30）。direction pinMask 選定的引腳的方向標(biāo)記GPIO Pin Group 0 ( 非并行GPIO Pins):GPIO_GPIO_PIN0_OUTPUTGPIO_GPIO_PIN1_OUTPUTGPIO_GPIO_PIN2_OUTPUTGPIO_GPIO_PIN3_OUTPUTGPIO_GPIO_PIN4_OUTPUTGPIO_GPIO_PIN5_OUTPUTGPIO_GPIO_PIN6_OUTPUTGPIO_GPIO_PIN7_OUTPUTGPIO_GPIO_PIN0_INPUTGPIO_GPIO_PIN1_I

21、NPUTGPIO_GPIO_PIN2_INPUTGPIO_GPIO_PIN3_INPUTGPIO_GPIO_PIN4_INPUTGPIO_GPIO_PIN5_INPUTGPIO_GPIO_PIN6_INPUTGPIO_GPIO_PIN7_INPUTGPIO Pin Group 1 ( 并行 GPIO Pins 0-15):GPIO_PGPIO_PIN0_OUTPUTGPIO_PGPIO_PIN1_OUTPUTGPIO_PGPIO_PIN2_OUTPUTGPIO_PGPIO_PIN3_OUTPUTGPIO_PGPIO_PIN4_OUTPUTGPIO_PGPIO_PIN5_OUTPUTGPIO_P

22、GPIO_PIN6_OUTPUTGPIO_PGPIO_PIN7_OUTPUTGPIO_PGPIO_PIN8_OUTPUTGPIO_PGPIO_PIN9_OUTPUTGPIO_PGPIO_PIN10_OUTPUTGPIO_PGPIO_PIN11_OUTPUTGPIO_PGPIO_PIN12_OUTPUTGPIO_PGPIO_PIN13_OUTPUTGPIO_PGPIO_PIN14_OUTPUTGPIO_PGPIO_PIN15_OUTPUTGPIO_PGPIO_PIN0_INPUTGPIO_PGPIO_PIN1_INPUTGPIO_PGPIO_PIN2_INPUTGPIO_PGPIO_PIN3_I

23、NPUTGPIO_PGPIO_PIN4_INPUTGPIO_PGPIO_PIN5_INPUTGPIO_PGPIO_PIN6_INPUTGPIO_PGPIO_PIN7_INPUTGPIO_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)

24、:GPIO_PGPIO_PIN16_OUTPUTGPIO_PGPIO_PIN17_OUTPUTGPIO_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_OUTPUT

25、GPIO_PGPIO_PIN29_OUTPUTGPIO_PGPIO_PIN30_OUTPUTGPIO_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_

26、PIN26_INPUTGPIO_PGPIO_PIN27_INPUTGPIO_PGPIO_PIN28_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_OUTPUTGP

27、IO_PGPIO_PIN38_OUTPUTGPIO_PGPIO_PIN39_OUTPUTGPIO_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_PGP

28、IO_PIN37_INPUTGPIO_PGPIO_PIN38_INPUTGPIO_PGPIO_PIN39_INPUTGPIO_PGPIO_PIN40_INPUTGPIO_PGPIO_PIN41_INPUTGPIO_PGPIO_PIN42_INPUTGPIO_PGPIO_PIN43_INPUTGPIO_PGPIO_PIN44_INPUTGPIO_PGPIO_PIN45_INPUT方向可以使用任何上面定義過的符號常量來設(shè)置， 同組的多個引腳可以用或操作進行設(shè)置比如：GPIO_PGPIO_PIN45_INPUT | GPIO_PGPIO_PIN40_OUTPUT返回值說明實例無設(shè)置一個或多個GPIO

29、/* 設(shè)置 pgpio 為輸入 */的方向GPIO_handle hGpio = GPIO_openGPIO_PGPIO_PIN1|GPIO_PGPIO_PIN15;GPIO_pinDirection(hGpio,GPIO_PGPIO_PIN1_INPUT) ;GPIO_pinDisable.(禁止一個引腳作為GPIO引腳 )函數(shù)對于 5501/2:Void GPIO_pinDisable(GPIO_Handle hGpio,Uint32 pinId)對于 5509/a，5510：Void GPIO_pinDisable(Uint32 pinId)參數(shù)hGpio由 GPIO_open 返回的

30、GPIO 句柄（僅對5501/2 CSL ）pinId禁止的引腳，參見 GPIO_pinDirection()查看引腳號。返回值無說明禁止一個或多個 GPIO 引腳實例/* 禁止 PGPIO1 作為 GPIO*/GPIO_handle hGpio = GPIO_open (GPIO_GPIO_PIN1|GPIO_GPIO_PIN15);GPIO_pinDisable(hGpio,GPIO_GPIO_PIN1);GPIO_pinEnable(使能一個引腳作為GPIO)函數(shù)對于 5501/2:Void GPIO_pinEnable(GPIO_Handle hGpio,Uint32 pinId)對于

31、 5509/A,5510 ：Void GPIO_pinEnable(Uint32 pinId)參數(shù)hGpio由 GPIO_open 返回的 GPIO 句柄（僅對5501/2 CSL ）pinId使能的引腳，參見 GPIO_pinDirection()查看引腳號。返回值無說明使能一個 GPIO 引腳實例GPIO_pinEnable(hGpio,GPIO_GPIO_PIN1)GPIO_pinRead ( 讀 GPIO 引腳值 )函數(shù)對于 5501/2:int GPIO_pinRead(GPIO_Handle hGpio,Uint32 pinId)對于 5509/A,5510:int GPIO_pi

32、nRead(Uint32 pinId)參數(shù)hGpio由 GPIO_open 返回的 GPIO 句柄（僅對 5501/2 CSL ）pinId要讀的引腳返回值讀出的值（ 0 或 1）說明讀輸入引腳的值實例int val ；val = GPIO_pinRead(hGpio,GPIO_GPIO_PIN1);GPIO_pinReadAll( 從一個或多個GPIO 引腳上讀回值)函數(shù)對于5501/5502:Int GPIO_pinReadAll(GPIO_Handle hGpio,Uint32 pinMask);對于 5509/A,5510 ：參數(shù)Int GPIO_pinReadAll(Uint32 p

33、inMask)hGpio 由 GPIO_open 返回的 GPIO 句柄（僅對5501/2 CSL ）pinMask 要讀的 GPIO 引腳號，參見GPIO_pinDirection() 查看引腳號返回值說明value 讀出讀出的 pinMaskGPIO 引腳值指定的 GPIO引腳的值。（該函數(shù)返回代替引腳的值，. Thefunction returnsthe value in place of the pins. It does not right-justify the value to return a raw result.）實例int val ；/* 讀 IO0 和 IO7 引腳的值

34、 */val = GPIO_pinReadAll(hGpio,GPIO_GPIO_PIN0|GPIO_GPIO_PIN7);GPIO_pinWrite( 向一個 GPIO 引腳寫入值 )函數(shù)對于 5501/2 ：Void GPIO_pinWrite(GPIO_Handle hGpio ,Uint32 pinMask ,Uint16 val)對于 5509/A,5510 ：Void GPIO_pinWrite(Uint32 pinMask,Uint16 val)返回值說明實例參數(shù)hGpio由 GPIO_open 返回的 GPIO 句柄（僅對 5501/2 CSL ）pinMask要寫的 GPIO

35、 引腳號，參見 GPIO_pinDirection() 查看引腳號val向 GPIO 引腳寫入的值（ 0 或 1）返回值無說明向 GPIO 輸出引腳寫入值。實例/* 向 pin0 和 pin5 寫入 1*/GPIO_pinWrite (hGpio,GPIO_GPIO_PIN0|GPIO_GPIO_PIN5,1)GPIO_pinWriteAll ( 向一個或者多個GPIO 引腳寫入值 )函數(shù)對于 C5502 and C5501:void GPIO_pinWriteAll(GPIO_Handle hGpio,Uint32 pinMask, Uint16 val)對于 C5509/C5509A/C5510:void GPIO_pinWriteAll(Uint32 pinMask, Uint16 val)參數(shù)hGpio pinMask val由 GPIO_open 返回的 GPIO 句柄（僅對5501/2 CSL ）要寫的 GPIO 引腳號，參見GPIO_pinDirection() 查看引腳號。向 GPIO 引腳寫入的值（0 或 1）返回值無說明實例向一個或多個輸出GPIO 引腳寫入值，（ Thsfunction assumesin-placevaluemaskforwritingtotheGPIOpins.Itwillnot left-justify values