嵌入式C语言工程简明规范V1.0.pdfVIP

苏州大学飞思卡尔嵌入式系统研发中心 嵌入式C 语言工程简明规范V1.0(2010)(1020) 嵌入式C 语言工程简明规范 1. 使用编程规范的目的 编程规范约定应建立于一项工程之初，且该约定应贯穿整个工程之始终。采用一些规 约有助于提高劳动生产率，并使工程软件便于维护。 用C 语言或其他语言编写程序的方式有很多种，惯用的，好的书写风格以及他人用的一 些好的方法，无非是想力图达到以下的目的：  可移植性好；  兼容性好；  干净整齐；  易维护性好；  易看懂；  简明扼要； 无论采用哪种编程风格，必须在整个工程中采用始终如一的格式。 2. 工程组织说明 范例工程结构如下图： 苏州大学飞思卡尔嵌入式系统研发中心 嵌入式C 语言工程简明规范V1.0(2010)(1020) 上图结构详细说明：  Component_C, Component_H 两个文件夹用于放置MCU 各模块代码和头文 件。  Project Settings 为工程文件夹，其下的文件都由CodeWarrior 自动生 成，不建议修改，除非特别需要。  Libs 文件夹，主要用于引入库文件。  Frame_C, Frame_H 两个文件夹用于放置通用代码文件。比如 type.h 用 于类型定义。GeneralFun.c 用于放置一些常用函数等。  Isr.h ,isr.c 文件用于处理中断程序。而main.c 为主函数。Include.h 为总的头文件。  最后一个为工程说明文件。建议在做工程的时候充分利用好这样的一个 文件，进行工程开发过程的记录以及版本升级的记录。 3. 关于构件模块代码的详细说明 在范例代码中，每个构件都由一个.c 程序和.h 的头文件。 头文件包含所有的该构件对外开放的函数接口的声明及其调用说明。用户只 需要查看该头文件就能知道如何调用该模块，那么这个构件就是成功的，用 户不需要看具体的函数实现过程。 同时，头文件中还可以放置一些与寄存器有关的一些宏定义，这样在主程序 中就可以通过宏进行对构件的访问或者操作，而不需要用户记忆一些繁琐的 地址。 .c 文件主要是完成对头文件中声明的函数的实现。以及一些内部调用函数的 声明和实现。 下面给出部分范例代码，加深用户理解: .h 头文件结构如下 /* 头部说明，实现功能，构件的一些情况说明 */ //* // 文件名: GPIO.h * // 说 明: GPIO构件头文件,包含了GeneralFun.h 文件 * //* #ifndef GPIO_H //防止重复定义 #define GPIO_H //1 头文件 #include MC9S08AW60.h //MC9S08AW60 MCU 映像寄存器名定义 #include Type.h //类型别名定义 /* 与寄存器有关的部分宏定义 */ 苏州大学飞思卡尔嵌入式系统研发中心 嵌入式C 语言工程简明规范V1.0(2010)(1020) //2.1 AW60 端口 名与偏移地址的对应关系 #define PORT_A 0 #define PORT_B 2 #define PORT_C 4 #define PORT_D 6 #define PORT_E 8 #define PORT_F 10 #define PORT_G 12 … … //部分代码已经省略 /* 函数接口声明及其调用说明 */