这节课是介绍如何基于COX编写移植性好驱动， 开源易用 ... - COOCOX.docVIP

这节课是介绍如何基于cox编写移植性好的驱动， 开源易用的组件。 Cox库包含通用功能接口，mcu特有功能接口，以及寄存器接口。 很明显，如果想编写好移植的驱动组件，保证写一次驱动组件，以后随意移植到其他厂商系列的mcu上，必然使用通用功能接口（强用强直型接口）。 本节课介绍基于cox库编写的AD7415温度传感器驱动组件。项目开发中使用cox库的好处前面介绍过，这节主要引导大家如何使用cox库编写好移植的驱动组件。 一个完整的组件，尤其是开源的，一般编写有比较严格的要求，包括代码编写规范，命名规范，文档等都有标准。有要求有标准才会出好的产品，CooCox写的组件都有严格的规范。 在coocox/cox的github仓库上可以看到coocox提供的所有组件，以及这些组件编写的代码规范，简单的说一下。 打开github上的仓库/coocox/cox （或者使用git版本管理软件将这个仓库clone到本地），在根目录的document下有代码规范，注视规范的文档。 在doxygen-document-howto.txt文档里面有doxygen的介绍。 CoX代码规范： 代码规范是为了代码更容易看懂和维护。并且在源文件中使用了doxygen语法便于生产文档。 排版 4字节缩进，对其只用空格不用TAB, 独立代码块之间需要空行，长语句不超过80列否则另取一行，编码语句独立一行（if，else，{，}…）等等 注释 一个源文件包括文件头，函数头，函数里面的注释，宏的注释， Doxygen分组(为什么自动生成的文档清晰有条，分组很重要)， 命名规范 变量命名都需要加类型前缀prefix + Noun with the first letter capitalized， 比如ulRegisterValue +----------------------+-------+------------------+ |Type |prefix |example | |----------------------|-------|------------------| |unsigned long |ul |ulRegisterValue | |unsigned long pointer |pul |pulBuffer | |long |l |lValue | |long pointer |pl |plValue | |unsigned short |us |usValue | |unsigned short pointer|pus |pusValue | |short |s |sValue | |short pointer |ps |psValue | |unsigned char |uc |ucValue | |unsigned char pointer |puc |pucValue | |char |c |cChar | |char pointer |pc |pcString | |struct |s |sValue | |struct pointer |ps |psValue | |xBoolean |b |bResult | +----------------------+-------+------------------+ typedef的类型需要加t前缀，比如tBoolean， 函数命名是组件名+名词+动词，比如SysCtlClockSet 宏定义命名是组件名+名词，中间用_连接，比如：xADC_EVENT_END_CONVERSION 关于doxygen使用，请看： /coocox/cox/blob/master/Document/doxygen-document-howto.txt 对于这种驱动编写，对大家来说都是小菜一碟的事情，上面说了一堆话，下面先结合源代码先看看注释： //****************