4.1 硬件文檔撰寫(xiě)思路

　　1）首先是需求定義或產(chǎn)品規(guī)格：

　　如果這些是產(chǎn)品最終目標(biāo)的話(huà)，那么產(chǎn)品對(duì)硬件和軟件的要求就是技術(shù)方案的最終目標(biāo)；對(duì)硬件和軟件的要求是從定義用戶(hù)界面和系統(tǒng)功能開(kāi)始的。

　　2）其次，根據(jù)需求，系統(tǒng)整體定義文檔中給出硬件接口的具體定義：

　　定義硬件最有效的方法是從需求開(kāi)始描述，由于硬件必須支持系統(tǒng)定義的所有功能，因此硬件定義是與系統(tǒng)說(shuō)明不可分割的；

　　例如，我們?cè)O(shè)計(jì)一個(gè)定時(shí)器（事先需求說(shuō)明定時(shí)器不能與個(gè)人電腦連接，故無(wú)法使用CRT顯示時(shí)間），我們只有兩種選擇：一種是使用發(fā)光二極管（LED），另一種是使用液晶顯示器件（LCD）；盡管LCD的顯示效果比較好，但考慮到定時(shí)器要常年位于戶(hù)外，并且早期LCD顯示器不能在低溫下工作，最終還是選擇 LED設(shè)備（這整個(gè)過(guò)程描述了我們硬件選型時(shí)的一個(gè)思路，這個(gè)是密切跟需求掛鉤的）

　　3）一旦完成了系統(tǒng)整體說(shuō)明文檔，就開(kāi)始進(jìn)行系統(tǒng)設(shè)計(jì)：

　　首先要對(duì)硬件說(shuō)明的內(nèi)容進(jìn)行細(xì)化，包括添加能讓工程師理解的設(shè)計(jì)意圖，以及軟件工程師圍繞硬件進(jìn)行程序設(shè)計(jì)時(shí)需要使用的硬件信息等。

　　完成硬件電路板說(shuō)明文檔后，我們還要在該文檔中增加一個(gè)用來(lái)描述系統(tǒng)的原始要求的前言部分，包括說(shuō)明方案的設(shè)計(jì)思路和方法，除此之外，還要附上軟件工程師用來(lái)對(duì)硬件進(jìn)行控制所需的各類(lèi)信息，這類(lèi)信息主要包括如下內(nèi)容（軟件工程所需信息）：

　　-----內(nèi)存和I/O端口地址（如果需要，還可以提供內(nèi)存映射圖）

　　-----可用內(nèi)存容量

　　-----狀態(tài)寄存器每一位的定義

　　-----每個(gè)端口管腳的用途

　　-----外部設(shè)備的驅(qū)動(dòng)方法（例如，說(shuō)明輸入定時(shí)器電路的時(shí)鐘頻率等）

　　-----其他有管軟件人員設(shè)計(jì)程序需要了解的信息

　　對(duì)于比較復(fù)雜的系統(tǒng)來(lái)說(shuō)，硬件文檔中經(jīng)常使用兩個(gè)獨(dú)立的部分來(lái)進(jìn)行說(shuō)明；其第一部分用來(lái)描述硬件指標(biāo)和工作原理，第二部分則主要為軟件人員提供程序設(shè)計(jì)需要的信息。

　　4.2 軟件文檔撰寫(xiě)思路

　　1） 軟件文檔與硬件文檔的組織方法類(lèi)似，軟件要求文檔的主要內(nèi)容則是定義軟件要實(shí)現(xiàn)的功能；一種是在簡(jiǎn)單項(xiàng)目設(shè)計(jì)過(guò)程中，軟件定義也可以只對(duì)一種電路板使用的軟件給予描述；對(duì)較復(fù)雜的項(xiàng)目來(lái)說(shuō)，由于參與這種項(xiàng)目的軟件人員分別負(fù)責(zé)設(shè)計(jì)驅(qū)動(dòng)不同硬件部分的代碼（同一電路板），因此每個(gè)軟件人員可能會(huì)為自己的設(shè)計(jì)代碼指定不同的定義，這類(lèi)軟件說(shuō)明需要提供下列的內(nèi)容：

　　-----論述包括需求定義、工程指標(biāo)、硬件參數(shù)等實(shí)施項(xiàng)目需要的內(nèi)容

　　-----說(shuō)明軟件之間、處理器之間或處理器與其內(nèi)部器件之間使用的通信協(xié)議：其內(nèi)容應(yīng)包括對(duì)緩沖區(qū)接口機(jī)制、命令/應(yīng)答協(xié)議、信號(hào)控制等協(xié)議的具體說(shuō)明。

　　-----借助流程圖、偽代碼或者其他可能的方法來(lái)描述軟件的實(shí)現(xiàn)方法和過(guò)程

　　2） 軟件與硬件所考慮的不同之處（此經(jīng)驗(yàn)方便技術(shù)總監(jiān)或其他相關(guān)管理者參考，因?yàn)闊o(wú)論是多高深的技術(shù)管理者，要么是硬件出身，要么是軟件出身，要么就是非技術(shù)出身，armjishu.com里面有少數(shù)軟硬件都精通的高手）

　　a. 軟件的靈活性遠(yuǎn)遠(yuǎn)大于硬件，要讓軟件人員搞清楚某個(gè)軟件的內(nèi)部格式是非常困難的任務(wù)，解決的辦法：詳細(xì)定義其他程序員需要了解的編程接口具體內(nèi)容，以及其他工程人員在實(shí)施開(kāi)發(fā)項(xiàng)目過(guò)程中需要使用的技術(shù)細(xì)節(jié)信息。

　　b. 軟件工程師只有在收到硬件說(shuō)明文檔后，才有可能知道如何對(duì)系統(tǒng)硬件進(jìn)行操作；而硬件人員一般不需要了解軟件程序的技術(shù)細(xì)節(jié)。

　　c. 由于軟件易于更改，因此程序內(nèi)容經(jīng)常會(huì)按銷(xiāo)售人員提供的要求發(fā)生變更，在某些情況下，軟件文檔的內(nèi)容無(wú)法及時(shí)反映程序的最新變化。

　　d. 軟件經(jīng)常是工程項(xiàng)目最后完成的部分，因此其文檔也經(jīng)常因時(shí)間不夠而欠缺完整。實(shí)際上，軟件文檔是否詳細(xì)、完整，在某種程度上是與公司或客戶(hù)的要求有關(guān)的。例如，軍事或國(guó)家工程一般要求開(kāi)發(fā)商就其所有軟件實(shí)現(xiàn)的功能提供全面詳細(xì)的文檔

　　e. 有個(gè)潛規(guī)則，對(duì)軟件的要求越復(fù)雜，則需求的正確可能性就越小，這個(gè)是經(jīng)驗(yàn)之談了，我們需要把準(zhǔn)需求這個(gè)準(zhǔn)繩來(lái)做文章，而不是陷入個(gè)人主義以及對(duì)軟件要求而憑空發(fā)揮自己不切實(shí)際的想象。

　　f. 我們可以先硬件設(shè)計(jì)，接著圍繞該硬件編制軟件。雖然實(shí)際系統(tǒng)的實(shí)現(xiàn)過(guò)程可能是軟硬件并行開(kāi)發(fā)，但軟件人員基本上也是圍繞著已經(jīng)實(shí)現(xiàn)的硬件來(lái)進(jìn)行程序設(shè)計(jì)的；對(duì)于更為復(fù)雜的系統(tǒng)來(lái)說(shuō)，開(kāi)發(fā)過(guò)程可能會(huì)出現(xiàn)重復(fù)。

　　例如，某個(gè)項(xiàng)目的硬件工程師和軟件工程師可能會(huì)坐下來(lái)開(kāi)會(huì)，共同決定使用哪種硬件來(lái)實(shí)現(xiàn)某種功能；軟件人員可能提出需要為數(shù)據(jù)緩沖區(qū)口沖內(nèi)存容量，也可能要求提供某種外部設(shè)備接口，以便充分利用現(xiàn)成接口程序提供的各種驅(qū)動(dòng)代碼。

　　總的來(lái)說(shuō)，必須在提高軟件開(kāi)發(fā)效率與硬件系統(tǒng)的復(fù)雜性與成本之間進(jìn)行權(quán)衡。