极客工坊

 找回密码
 注册

QQ登录

只需一步,快速开始

楼主: liamjeal

coocox学习系列之CoX_GPIO篇

[复制链接]
发表于 2012-9-5 15:27:21 | 显示全部楼层 |阅读模式
本帖最后由 liamjeal 于 2012-9-13 11:30 编辑

附件的word文档,值得看。CoX统一ARM Cortex MCU软件接口标准, 这篇文章带你了解CoX是怎么诞生的,也可以帮助了解一些底层软件思想。

1.GPIO接口设计思想
1.1CoX.GPIO发展过程,历史版本
     CoX第一版从2009年开始,从CoX诞生开始,CoX的目标就是要做到在M系列的CPU上实现平滑移植。所以,GPIO的实现,第一版首先实现了,IO的模式配置(输入、输出)和管脚的上拉、下拉配置;然后,实现了IO管脚的状态读写。具体可以从接口定义清晰的看出来:
  1. typedef struct {
  2.   COX_Status (*Init) (COX_PIO_Dev pio);
  3.   COX_Status (*Dir)  (COX_PIO_Dev pio, uint8_t dir);
  4.   uint8_t     (*Out)  (COX_PIO_Dev pio, uint8_t level);
  5.   uint8_t     (*Read) (COX_PIO_Dev pio);
  6.   COX_Status (*Cfg)  (COX_PIO_Dev pio, uint8_t index, uint32_t arg, uint32_t *pre_arg);
  7. } COX_PIO_PI_Def;
  8. typedef const COX_PIO_PI_Def COX_PIO_PI;
复制代码
这样的实现,确实可以大大减小IO操作的移植,因为我们在每个厂商实现一套API,以新唐为例:
  1. COX_PIO_PI pi_pio =
  2. {
  3.         NUC_GPIO_Init,
  4.         NUC_GPIO_SetDir,
  5.         NUC_GPIO_Out,
  6.         NUC_GPIO_Read,
  7.         NUC_GPIO_Cfg  
  8. };
复制代码
在使用的时候,我们仅仅需要使用pi_pio的指针就可以调用GPIO的API操作了,而且这个指针还可以被驱动嵌套使用。有兴趣的可以参考NUC140-LB Board的CoOS例程,这个在www.coocox.org官网可以下载到。
然而,第一版有几个明显的不足:
1.        实现的功能很少,只有IO的基本配置和读写操作,没有外部中断实现,没有多功能配置实现,以及一些其他特殊的功能。
2.        采用了结构体的形式,代码的可读性大大降低,效率也不高。
3.        CoX代码不能搞定所有基本的事情,在使用CoX库的使用还必须和厂商库配套使用。
4.        CoX在第一版更多的注重外设模块的移植,而忽略了系统。
    所以,CoX需要改进、升级。经常一年多时间的积累,在2011年开始推出CoX 2.0版本,这个版本解决了上述所有的缺点的同时,保留了CoX设计的初衷——那就是在M系类CPU上面的通用性。下面,详细介绍2.0版的CoX.GPIO接口。
1.2通用强制接口
通用强制接口是提取的一套ARM Cortex M0/M3所有厂商系列MCU都具有的功能接口。本篇以新唐M051为例讲解CoX.GPIO,其他系列大同小异, 提取GPIO通用接口的时候,是从以下角度出发考虑的:
配置一个GPIO管脚线
  方向配置:
      输入   
      输出
      硬件功能
  外围功能配置:
  Pad配置:
      驱动能力大小(电流)
      开源/推挽
      弱上拉/下拉电阻
GPIO管脚数据控制
  输出高/低电平
  获取管脚输入值
输入中断(EXTI)
  上升沿检测
  下降沿检测
  上/下沿检测
  低电平检测
  高电平检测
APIs分组完成以下几大功能:
  1.         配置GPIO管脚线的函数:
  2.         xGPIODirModeSet
  3.         xGPIOSPinDirModeSet
  4.         xGPIOPinConfigure
  5.         读回GPIO管脚线模式配置的函数:
  6.         xGPIODirModeGet
  7.         还有很方便的函数,可以将GPIO配置成想要的功能:
  8.         xGPIOSPinTypeGPIOInput
  9.         xGPIOSPinTypeGPIOOutput
  10.         xSPinTypeADC
  11.         xSPinTypeI2C
  12.         xSPinTypeSPI
  13.         xSPinTypeTimer
  14.         xSPinTypeUART
  15.         xSPinTypeACMP
  16.         处理GPIO中断的APIs
  17.         xGPIOPinIntCallbackInit
  18.         xGPIOPinIntEnable
  19.         xGPIOSPinIntEnable
  20.         xGPIOPinIntDisable
  21.         xGPIOSPinIntDisable
  22.         xGPIOPinIntStatus
  23.         xGPIOPinIntClear
  24.         xGPIOSPinIntClear
  25.         处理GPIO Pin状态的APIs
  26.         xGPIOPinRead
  27.         xGPIOSPinRead
  28.         xGPIOPinWrite
  29.         xGPIOSPinWrite
复制代码
1.3通用非强制接口
通用非强制接口是一部MCU通有的功能,而不是所有MCU都具有的功能接口:
  1.         xGPIOSPinTypeGPIOOutputOD
  2.         xGPIOSPinTypeGPIOOutputQB
  3.         xSPinTypePWM
  4.         xSPinTypeEXTINT
  5.         xSPinTypeEBI
复制代码
CoX的宏定义的参数和APIs都是以' x '开头的, 体现出CoX接口的特征。比如将 GPIOA Pin0配置成输出模式, 代码如下:
  1. xGPIODirModeSet(xGPIO_PORTA_BASE, xGPIO_PIN_0, xGPIO_DIR_MODE_OUT);
复制代码
函数和形式参数都是x开头。
1.4厂商库特色接口
特色接口是包括了通用性接口,和MCU特有功能的接口。比如:
  1. void GPIOPinDebounceEnable(unsigned long ulPort, unsigned long ulPins);
复制代码
并不是通用强制型或者通用非强制型,而是MCU特有的功能,就是在厂商库特色接口这一组。

另外厂商库接口也实现了MCU其他所有的功能,比如:
  1. void GPIOPinWrite(unsigned long ulPort, unsigned long ulPins, unsigned char ucVal);
复制代码
也实现了GPIO管脚线模式的配置,这个在CoX接口的xGPIOPinWrite也是这个功能。其实这个时候xGPIOPinWrite的实现方式如下:
  1. #definex GPIOPinWrite(ulPort,ulPins,ucVal)                              \
  2.         GPIOPinWrite(ulPort, ulPins, ucVal)
复制代码
进行了一次宏定义包装罢了,对应的参数也是进行的一次宏定义比如:
  1. #define xGPIO_PIN_0             GPIO_PIN_0
复制代码
2.设计技巧简介
GPIO的CoX接口创新性的提出了Short Pin,比如PA0 是GPIOA的Pin0脚,它的定义如下:
  1. #define PA0                     PA0
复制代码
自从有了Short Pin之后,对GPIO的操作简单多了,例如比如将 GPIOA Pin0配置成输出模式,并输出高电平, 代码如下:
  1. xGPIODirModeSet(xGPIO_PORTA_BASE, xGPIO_PIN_0, xGPIO_DIR_MODE_OUT);
  2. xGPIOPinWrite(xGPIO_PORTA_BASE, xGPIO_PIN_0, 1);
复制代码
现在用Short Pin作为参数,上面的功能可以这样实现:
  1. xGPIOSPinTypeGPIOOutput(PA0);
  2. xGPIOSPinWrite(PA0, 1);
复制代码
上面的Short Pin到底是如何实现的呢?看起来很神奇,以xGPIOSPinWrite为例说明它的实现过程:
  1. #define xGPIOSPinWrite(eShortPin, ucVal)                                 \
  2.         GPIOSPinWrite(eShortPin, ucVal)
  3. #define GPIOSPinWrite(eShortPin, ucVal)                                  \
  4.         GPIOPinWrite(G##eShortPin, ucVal)
复制代码
关于##, 其实是宏定义里面的高级用法,它是一个连接符,遇到此连接符,宏会一直展开下去,直到不能展开为止。G##eShortPin其实会连接为GPA0,而GPA0同样是个宏定义,如下:
  1. #define GPA0                    GPIO_PORTA_BASE, GPIO_PIN_0
复制代码
  1. GPIOPinWrite(GPA0, ucVal)
复制代码
会进一步展开为
  1. GPIOPinWrite(GPIO_PORTA_BASE, GPIO_PIN_0, ucVal),
复制代码
这个函数在厂商库里面定义了的,所以实现了Pin写的功能。
另外Short Pin对GPIO管脚的外设多功能复用操作也带来了极大的方便,比如配置PD5为I2C的clock脚功能,如下:
  1. xSPinTypeI2C(I2C0SCK, PD5);
复制代码
是不是很简单!!!上面的实现如下:
  1. #define xSPinTypeI2C(ePeripheralPin, eShortPin)                             \
  2. do                                                                                                   \
  3. {                                                                                                     \
  4.          GPIOSPinConfigure(ePeripheralPin, eShortPin);                        \
  5.          GPIOSPinFunctionSet(GPIO_FUNCTION_I2C,eShortPin);         \
  6. }                                                                                                      \
  7. while(0)
  8.     #define GPIOSPinConfigure(ePeripheralPin, eShortPin)                  \
  9.        GPIOPinConfigure(GPIO_##eShortPin##_##ePeripheralPin)
复制代码
上面的会连接成这样GPIOPinConfigure(GPIO_PD5_I2C0SCK), GPIO_PD5_I2C0SCK宏定义如下:
#define GPIO_PD5_I2C0SCK        0x00003510
这个是根据多功能复用进行的编码,视不同的芯片,这个编码方式灵活多变。

还有一些接口完全是为了移植方便性而产生的,比如xGPIOSPinToPort, 这个接口是由Short Pin就可以得到这个Pin所对应的PORT Base,而在CoX.SYSCTL中有一个接口xSysCtlPeripheralEnable2是使用外设地址Base为参数使能这个外设 (在SYSCTL中维护了一个外设BASE-ID-INT的表),它实现的时候,是进行了一个Base到外设ID的一个转换,最终还是调用xSysCtlPeripheralEnable使能外设的。但是有了这个功能,也很利于基于CoX驱动组件的移植性,例如在AD7415温度传感器是通过I2C接口进行数据通信的,在这个驱动组件头文件中, 只需要考虑一下四个元素就可以平滑的使得这个驱动组件移植到其他的MCU上(比如NUC1xx,或者STM32F1xx):
  1. //
  2. //! Config the device i2c Address
  3. //
  4. #define AD7415_I2C_ADDRESS      0x48

  5. //
  6. //! Config the devide i2c bus master
  7. //
  8. #define AD7415_MASTER_BASE     xI2C0_BASE

  9. //
  10. //! Config the i2c SDA pin
  11. //
  12. #define AD7415_PIN_I2CSDA        PA8

  13. //
  14. //! Config the i2c SCL pin[b][size=3][/size][/b]
  15. //
  16. #define AD7415_PIN_I2CSCK        PA9
复制代码
因为有了xI2C0_BASE在驱动中就可以使能这个I2C外设,有了连接的管脚也就可以使能对应的GPIO PORT, 如xSysCtlPeripheralEnable2(AD7415_MASTER_BASE); 这里不在需要给出I2C0的外设使能ID,或者GPIOA的外设使能ID, 用户移植的时候只需要从硬件连接角度出发,用了那个I2C, 管脚是怎么连接的,而不需要考虑其他的元素。
3. GPIO接口使用示例与移植
下面给出一个CoX.GPIO的示例,都是使用的通用强制型的接口,因此下面的例子在所有Cortex M0/M3上都是平滑移植的, 类似一个简单的电灯程序。
  1. void Blinky(void)
  2. {
  3.     unsigned long i;
  4.        
  5.     //
  6.     // Initionalize system clock.
  7.     //
  8.     xSysCtlPeripheralClockSourceSet( 12000000,  xSYSCTL_XTAL_12MHZ );
  9.        
  10.     //
  11.     // Set GPIO port c pin 0 , 1 output mode.
  12.     //
  13.     xGPIODirModeSet( xGPIO_PORTC_BASE, xGPIO_PIN_0, xGPIO_DIR_MODE_OUT );
  14.     xGPIODirModeSet( xGPIO_PORTC_BASE, xGPIO_PIN_1, xGPIO_DIR_MODE_OUT );
  15.        
  16.     while (1)
  17.     {
  18.        //
  19.         // Delay some time.
  20.         //  
  21.         for( i = 0; i < 0x1FFFF; i++ )
  22.                
  23.        //
  24.         // Output high level.
  25.         //  
  26.         xGPIOPinWrite( xGPIO_PORTC_BASE, xGPIO_PIN_0 | xGPIO_PIN_1, 1 );
  27.                
  28.         for( i = 0; i < 0x1FFFF; i++ )
  29.                
  30.          //
  31.         // Output low level.
  32.         //  
  33.         xGPIOPinWrite( xGPIO_PORTC_BASE, xGPIO_PIN_0 | xGPIO_PIN_1, 0 );
  34.         }
  35.        
  36. }
复制代码

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?注册

x
回复

使用道具 举报

发表于 2012-9-5 15:55:32 | 显示全部楼层
先顶一个
回复 支持 反对

使用道具 举报

发表于 2012-9-5 15:58:07 | 显示全部楼层
cox 和  stellaris的厂商库的语法是比较类似的  是吧?
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-5 16:23:50 | 显示全部楼层
┏ωǒ┛菰独 发表于 2012-9-5 15:58
cox 和  stellaris的厂商库的语法是比较类似的  是吧?

恩是的,当时看到TI厂商库语法比较好,借鉴了不少
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-6 11:49:24 | 显示全部楼层
CoX是统一ARM Cortex MCU软件接口标准,这一文章可以让你知道CoX是怎么来的,对编程思想也有帮助。
回复 支持 反对

使用道具 举报

发表于 2012-9-13 14:36:03 | 显示全部楼层
直观感觉着个编程语言有点复杂
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-13 15:24:21 | 显示全部楼层
chenzhm 发表于 2012-9-13 14:36
直观感觉着个编程语言有点复杂

哈哈,这可使得arm mcu简单化了额
回复 支持 反对

使用道具 举报

发表于 2012-9-17 19:50:19 | 显示全部楼层
写的很详细,顶一个,如果有快试用版玩就爽了!!!
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-17 19:54:23 | 显示全部楼层
Randy 发表于 2012-9-17 19:50
写的很详细,顶一个,如果有快试用版玩就爽了!!!

cox有了。CoIDE直接勾选可以用了
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-17 19:55:07 | 显示全部楼层
Randy 发表于 2012-9-17 19:50
写的很详细,顶一个,如果有快试用版玩就爽了!!!

试用版,只需要有块M0 或者M3的就可以了
回复 支持 反对

使用道具 举报

 楼主| 发表于 2012-9-17 19:55:33 | 显示全部楼层
Randy 发表于 2012-9-17 19:50
写的很详细,顶一个,如果有快试用版玩就爽了!!!

到时候去抢楼
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则 需要先绑定手机号

Archiver|联系我们|极客工坊

GMT+8, 2024-3-29 23:00 , Processed in 0.042473 second(s), 20 queries .

Powered by Discuz! X3.4 Licensed

Copyright © 2001-2021, Tencent Cloud.

快速回复 返回顶部 返回列表