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