最簡(jiǎn)單IO驅(qū)動(dòng)的智慧
從單片機(jī)到ARM7、ARM9、Cortex-A8,從uC/OS到WinCE、Linux,GPIO驅(qū)動(dòng)都是最簡(jiǎn)單、最易編寫(xiě)的驅(qū)動(dòng)。但看似簡(jiǎn)單、毫無(wú)技術(shù)含量的驅(qū)動(dòng),其是否完整?是否規(guī)范?是否安全?
典型案例
本節(jié)將選取兩例典型案例,從反、正兩個(gè)角度進(jìn)行對(duì)比。
反方案例
以某一源碼中XXX驅(qū)動(dòng)為例,截取XXX_IOControl部分的代碼,如程序清單1所示;請(qǐng)留意代碼突出顯示部分。
程序清單1
從反方案例,實(shí)現(xiàn)GPIO電平狀態(tài)的讀或?qū)懙墓δ軆H需要幾行代碼,非常簡(jiǎn)單。
正方案例
如程序清單2所示,代碼截取自ZLG某核心板GPIO驅(qū)動(dòng),請(qǐng)留意代碼中突出顯示部分。
程序清單2
從正方案例,實(shí)現(xiàn)GPIO電平狀態(tài)的讀或?qū)懙墓δ軈s花費(fèi)了2倍的代碼工作量,差異為何如此大?
案例點(diǎn)評(píng)
一、指針使用
在反方案例中,函數(shù)傳遞進(jìn)來(lái)的指針參數(shù)未經(jīng)判斷而直接使用,這種情況下若為空指針或野指針,則程序極可能出現(xiàn)異常甚至崩潰!
反方案例在讀取操作后,使用“*pBytesReturned = 2;”返回實(shí)際讀取的字節(jié)數(shù),但是,該指針依然未經(jīng)判斷而直接使用!
而正反案例則在每一項(xiàng)參數(shù)使用前均對(duì)參數(shù)范圍、有效性進(jìn)行判斷,從根本上避免了參數(shù)異常情況的發(fā)生!
二、錯(cuò)誤提示
在反方案例中,XXX_IOControl只是返回TRUE或FALSE,返回FALSE時(shí)應(yīng)用層無(wú)從獲取或獲知是什么原因造成了“FALSE”!
對(duì)比正方案例,在參數(shù)判斷時(shí)即開(kāi)始添加錯(cuò)誤提示,在return之前,調(diào)用SetLastError函數(shù),應(yīng)用層則可以通過(guò)GetLastError獲取錯(cuò)誤原因,允許用戶更快速、準(zhǔn)確的定位錯(cuò)誤點(diǎn)。
三、注釋
反方案例函數(shù)體內(nèi)外幾乎無(wú)注釋;
而正方案例,無(wú)論函數(shù)體內(nèi)的關(guān)鍵位置還是函數(shù)體外,均做必要、詳細(xì)的注釋說(shuō)明,為程序的后期維護(hù)帶來(lái)極大的便利!
包括最簡(jiǎn)單的GPIO在內(nèi),驅(qū)動(dòng)實(shí)現(xiàn)功能非常容易,但驅(qū)動(dòng)的完整性與可靠性卻蘊(yùn)藏著軟件工程的大智慧。
相關(guān)閱讀:
解析DC-DC變換器參與電動(dòng)汽車能量驅(qū)動(dòng)的過(guò)程
具備超寬輸出電壓和高功率因數(shù)的LED驅(qū)動(dòng)器設(shè)計(jì)
設(shè)計(jì)方案解讀:解析工業(yè)伺服驅(qū)動(dòng)器的保護(hù)設(shè)計(jì)