EDA365电子论坛网

标题: 学习一下嵌入式C51相关规范 [打印本页]

---

作者: mytomorrow    时间: 2019-9-17 17:16
标题: 学习一下嵌入式C51相关规范

  M( \( T9 t7 w$ w

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

一、注释

（1）文件注释

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

/***********************************************************
6 u2 l; W7 Z8 M  {- A2 h3 {文件名称： hal.h
作 者：
日 期：　
2 ~' D! A1 \' z1 |% F* S版 本： 1.1
功能说明： 硬件抽象层
; q5 Y, l& G# {" s- t! ~函数列表： （略）
: a: i$ _& R- V修改记录：
***********************************************************/

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

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

（2）函数注释

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

6 W' p8 Y6 Z" }, M8 Z
* x! U- I9 C: q" n
6 Y% S, y; z. k5 @

- V& S' O$ {& _8 H" U  g1 n

---

作者: artic    时间: 2019-9-17 20:54
看看嵌入式C51相关规范。

---

欢迎光临 EDA365电子论坛网 (https://bbs.eda365.com/)

Powered by Discuz! X3.2