学习一下嵌入式C51相关规范

mytomorrow

+ H; m: G& \5 ]" @0 c+ _' V

为单片机编写C51代码，程序的可行性当然是必须保证的。但是包括笔者在内的很多新手，都忽略了程序的另一面——可读性、可维护性以及可扩展性。只要稍微有些嵌入式开发经验的读者，若看到笔者在“Zigbee之旅”系列博文中的源码，可能都会从其代码编写习惯中得出一个结论——“菜鸟”。呵呵，笔者决定抽时间学习一下C51嵌入式开发的编程规范，于是在网上收集了一些资料，结合自己的经验，一并分享如下。

一、注释

（1）文件注释

　　这里说的文件，一般是 .h 和 .c 文件。

/***********************************************************
文件名称： hal.h
作 者：
日 期：　
版 本： 1.1
功能说明： 硬件抽象层
: I! f, @- x0 P: x# G3 D函数列表： （略）
修改记录：
***********************************************************/
. I# Y) W5 R" _0 F2 s+ O
) d. y6 j2 G# t& C  X7 W
1 z, P$ V$ _" Z2 j' c& v& U

　　其实一个人学习的话，诸如“文件名称”、“作者”、“版本”、“日期”这些内容，不是特别必要。上述的规范一般在公司内要求比较严格（在多人作业的情况下，对于软件开发的流程控制非常重要）。

　　但“说明”和“函数列表”这两项，我想还是方便的话写写比较好。当你对这个项目比较淡忘的时候，你只需要扫一下文件头部注释，就能一下子知道这个文件到底是干什么的，明白都有哪些函数。

（2）函数注释

　　如果对上述的文件注释不怎么感冒的话，我想大家函数注释都应比较熟悉。博客园的园友中大多都是使用vs的，相信vs中对函数注释的支持一定不会忘记（敲三个///，啥都出来了，只需要一个个填就行）。虽然嵌入式开发IDE没有如此强大的功能，但是还是很有必要对“函数功能”、“入口参数”、“出口参数”进行说明：

0 R/ M/ m4 r+ |/ t% F% f

游客，如果您要查看本帖隐藏内容请回复

/ {. o; x8 l- G1 C% S
( T6 s8 j( f- ?& ^2 l

artic

看看嵌入式C51相关规范。