从最简单的IO驱动看出工程师的水平

版权声明:开心源自分享,快乐源于生活 —— 分享技术,传递快乐。转载文章请注明出处,谢谢! https://blog.csdn.net/luckydarcy/article/details/52683867

  GPIO驱动是嵌入式系统中最简单的驱动,然而有多少电子类高材生在它身上栽了跟头?
  从单片机到ARM7、ARM9、Cortex-A8,从uC/OS到WinCE、Linux,GPIO驱动都是最简单、最易编写的驱动。但看似简单、毫无技术含量的驱动,其是否完整?是否规范?是否安全?
典型案例
  本节将选取两例典型案例,从反、正两个角度进行对比。
  
反方案例
以某一源码中XXX驱动为例,截取XXX_IOControl部分的代码,如程序清单1所示;请留意代码突出显示部分。

程序清单1

PUBLIC BOOL
XXX_IOControl()
{

}

从反方案例,实现GPIO电平状态的读或写的功能仅需要几行代码,非常简单。
正方案例
如程序清单2所示,代码截取自ZLG某核心板GPIO驱动,请留意代码中突出显示部分。
程序清单2

/* ************************************************
 * Function name: 
 * Description:
 * Input:
 * Output:
 * Note:
 * Created by:
 * Created Date:
 * -------------------------------
 * Modified by:
 * Modified Date:
 * -------------------------------
 *********************************************** */

BOOL
XXX_IOControl()
{

}

从正方案例,实现GPIO电平状态的读或写的功能却花费了2倍的代码工作量,差异为何如此大?
案例点评
一、指针使用
在反方案例中,函数传递进来的指针参数未经判断而直接使用,这种情况下若为空指针或野指针,则程序极可能出现异常甚至崩溃!反方案例在读取操作后,使用“*pBytesReturned = 2;”返回实际读取的字节数,但是,该指针依然未经判断而直接使用!而正反案例则在每一项参数使用前均对参数范围、有效性进行判断,从根本上避免了参数异常情况的发生!
二、错误提示
在反方案例中,XXX_IOControl只是返回TRUE或FALSE,返回FALSE时应用层无从获取或获知是什么原因造成了“FALSE”!对比正方案例,在参数判断时即开始添加错误提示,在return之前,调用SetLastError函数,应用层则可以通过GetLastError获取错误原因,允许用户更快速、准确的定位错误点。
三、注释
反方案例函数体内外几乎无注释;而正方案例,无论函数体内的关键位置还是函数体外,均做必要、详细的注释说明,为程序的后期维护带来极大的便利!包括最简单的GPIO在内,驱动实现功能非常容易,但驱动的完整性与可靠性却蕴藏着软件工程的大智慧。


(待续。。。)
http://www.wtoutiao.com/p/i47dMb.html

展开阅读全文

没有更多推荐了,返回首页