51单片机学习

1 模块化编程

1.1 什么是模块化编程

随着我们的代码越来越复杂，我们的main.c越来越长，阅读性也越来越差。如果将来开始做项目，我们可能要同时操作好几个模块，这种情况下我们无法再把代码写到同一个文件，而是要分模块管理代码。

具体实现方法，就是将源码按照不同功能和模块，拆成若干部分源码，再用头文件相互引用。

2命名规范

2.1 变量命名

使用有意义的名字，该名字应反映变量的用途或其代表的值

避免使用单个字符名字，除非是常见的循环变量如i, j。

使用小写字母，并在多个单词间使用下划线连接。例如：sensor_value，update_interval。

使用g_前缀来标识全局变量。例如：g_system_state。

使用s_前缀来标识静态变量。例如：s_internal_counter。

使用st_前缀来标识结构体变量。例如：st_date。

使用p_前缀来标识指针。例如：p_num。

使用p_st_前缀来标识结构体指针。例如p_st_date。

常量和宏定义使用全大写字母，并用下划线分隔单词。例如：MAX_VALUE, TIMER_INTERVAL。

结构体类型声明需要使用“_Struct”后缀，例如Da****te*****_Struct*

枚举类型名称使用大写字母开始，例如：ColorType。

枚举值使用全大写字母，并用下划线分隔单词，例如：COLOR_RED, COLOR_BLUE。

内部变量都要加static关键字。

2.2 函数命名

函数名称应描述其功能或执行的操作。

使用{分层}{模块}{功能}作为函数名称，分层详见分层定义，模块首字母大写，功能使用首字母大写的驼峰命名。特殊名词全部大写。

返回布尔值的函数，其名称应该是一个问题或断言。例如：IsButtonPressed(), HasDataArrived()。

为属性/变量获取值的函数使用Get前缀。例如：GetSpeed()。

为属性/变量设置值的函数使用Set前缀。例如：SetSpeed(int speed)。

函数应尽量短小，并执行单一功能。这样可以提高代码的可读性和可维护性。

内部函数都要加static关键字。

2.3 文件命名

使用{分层}_{模块}作为文件名称，分层详见分层定义，模块首字母大写，特殊名词全部大写。

如果项目规模较大，头文件和源文件建议分开存放。

3 代码分层规范

3.1 工具函数和常规宏定义

所有特定算法、工具函数和常规宏定义。

目录：Com/

前缀：Com_

3.2 驱动层

所有与芯片直接交互的自身硬件代码，例如GPIO开关、硬件UART或ADC的驱动、计时器等。

目录：Dri/

前缀：Dri_

3.3 接口层

位于驱动层之上，通过标准接口（GPIO、UART、IIC、SPI等）驱动的外部硬件代码。如果没有外部硬件设备，可以不用这一层。

目录：Int/

前缀：Int_

3.4 中间层

提供更高级的服务，如操作系统、文件系统、通信协议栈等。这层通常用于复杂的单片机项目，例如使用RTOS的项目。简单的项目可以不用这一层。

目录：Mid/

前缀：Mid_

3.5 应用层

包含应用程序的主要逻辑。该层应只与上面的中间件层或接口层交互，尽量不直接访问驱动层。

目录：App/

前缀：App_

4 常规定义和通用方法

4.1 延时函数

1）Util.h

（1）点击EIDE图标，在项目的Com目录下新建文件Util.h

#ifndef _UTIL_H_
#define _UTIL_H_
#include <INTRINS.H>// 8bit无符号数
typedef unsigned char u8;
// 16bit无符号数
typedef unsigned int u16;/*** @brief 延时一定时长** @param count 延时时长，单位1ms*/
void Delay1ms(u16 count);#endif

2）Util.c

在项目的Com目录下新建文件Util.c，写入以下内容。

#include "Util.h"void Delay1ms(u16 count) //@11.0592MHz
{u8 i, j;while (count > 0){count--;_nop_();i = 2;j = 199;do{while (--j);} while (--i);}
}

4.2 数码管驱动

1）Int_DigitalTube.h

在项目的Int目录下创建Int_DigitalTube.h，写入以下内容。

#ifndef __INT_DIGITALTUBE_H__
#define __INT_DIGITALTUBE_H__
#include <STC89C5xRC.H>
#include "Util.h"/*** @brief 设置数码管要显示的数字** @param num 要显示的数字*/
void Int_DigitalTube_DisplayNum