編寫需求文檔，在嵌入式開發領域是非常普遍的。需求文檔被用來定義開發任務，協調大規模的研發計劃。對於最終的產品，需求文檔扮演著開發者行為和消費者行為之間溝通紐帶的角色。當需求文檔書寫正確的時候，便可以發揮巨大的作用。然而，如果你在嵌入式開發領域工作的時間足夠長，你就會很快發現，這個領域裡不合格的需求文檔實在是太多瞭。當你嘗試對這些不合格的文檔進行修復時，你又會很快發現，書寫正確的需求文檔絕非易事。在這裡，我們提出一些建議，希望能將書寫正確需求文檔這件事情變得清晰一些。

　　從較高的層次來看，書寫需求文檔的目的就是要提供對所需行為的有效描述。該所需行為可用一個黑盒系統描述，並需要註意以下細節：

　　• 工程師可以根據系統所說進行實現。

　　• 測試人員，在不與開發人員溝通的前提下，可以利用滿足硬件要求的設備驗證需求。

　　• 最終產生的成果滿足終端用戶的要求。

　　黑盒測試書寫優質的需求文檔：

　　最基本的原則是：需求文檔應當盡量簡潔，用最易懂的描述來約束系統的預期行為。如果你遵循這個原則，剩下的那些重要因素(可測試性、避免過度設計等等)都將變得順理成章。

　　列舉一下更詳細的規則，通常會更有幫助。下面是書寫優質需求文檔需要遵循的步驟：

　　1. 定義系統的邊界。這也是黑盒系統所必要的。

　　2. 定義輸入和輸出。這也應當是你看待內部系統的唯一方式。

　　3. 用最易懂的方式描述系統的預期行為。

　　4. 除瞭輸入和輸出之外，你的需求是不是還涉及瞭系統的其他部分?如果是，那麼你的需求就設計過度瞭。重構需求，讓它變得精簡。

　　5. 你的需求是不是過於模棱兩可?加入更多的限定規范。註意：有些模棱兩可的描述並不是壞事，假設描述所包含的所有情況均可被接受，且測試的時候不需要附加的信息加以說明，那麼就沒關系。你不需要(也不應該)把系統的行為限制得過頭。

　　6. 你的需求是否可測試?(這裡指的是黑盒測試)如果不是，你最好返回到第4步。如果這種返工發生很多次，那就說明你的黑盒無法正確描述系統，或者你的測試工具不夠優秀。無論是哪種情況，不可測試的需求文檔幾乎就是一文不值的。

　　7. 你的需求文檔通俗易懂麼?如果你的需求文檔非常難以讀懂，那就說明你寫得不好，隻能給那些照著你的需求負責實施的人帶來無盡的痛苦。如果是這樣，回到第3步。

　　8. 你是不是真的做到瞭第4步?你確認麼?再檢查一下。

　　例子：下面的例子，讓我們描述一個自制的嵌入式設備的需求，這個設備能從彎曲傳感器上讀取彎曲的頻率，並根據不同的頻率值讓一個LED閃爍。

　　顯然，我們已經完成瞭步驟2和步驟3瞭!

　　• 輸入：從彎曲傳感器讀取數據。

　　• 輸出：LED。

　　但是我們跳過瞭步驟1：

　　• 在這個例子裡，我們將把黑盒畫到設備的微處理器上。

　　讓我們繼續往下進行，

　　第四步：除瞭輸入和輸出以外，我們是否還涉及瞭其他的系統邊界?

　　• 微處理器並不關心從彎曲傳感器讀取什麼樣的數據，從處理器的角度來看，僅需要做的是測量ADC腳的電壓而已。

　　• LED僅由數字輸出腳控制。

　　下面，讓我們來修正這個問題：

　　第0版本的需求：

　　1. 該設備應當根據ADC腳的不同頻率的電壓，來切換數字輸出端的狀態。

　　第五步：需求寫模棱兩可麼?

　　恩，我們的描述太模棱兩可瞭。輸出端切換的速度要多快? 跟電壓的關系如何? 輸入電壓的范圍是多少? 讓我們加一些更細節的描述吧：

　　版本0.1

　　1. 輸出端應當由一個自由活動的定時器進行控制

　　2. 自由運行定時器的頻率最高不得高於每秒10次，不得低於每秒1次。

　　3. 自由運行定時器的觸發頻率應當在最高和最低值之間呈線性變化，並與ADC端的輸入電壓成正比。

　　4. ADC端的輸入電壓應當每100毫秒讀取一次

　　5. 當ADC端的輸入電壓端被讀入時，控制自由運行定時器周期時間的註冊值也應當被更新。

　　6. ADC輸入端的電壓有效范圍應當被控制在0到1伏之間。

　　第六步：你的需求是可測試的麼?

　　• 首先，自由運行的定時器在這裡不需要提及。 因為對它基本上無法進行黑盒測試，它既不是輸入也不是輸出，而且跟這兩者也沒有什麼聯系。

　　讓我們用數字輸出端變化的頻率應控制在每秒10次和每秒1次之間來代替自由運 行定時器的測試標準。

　　• 對於上述的第四條需求，可能需要一些小修改才能作為測試標準。讓我們用ADC端的輸入電壓應當保證在每100毫秒內至少被讀取一次來加以描述，這樣的描述能讓我們預期的測試行為顯得更加通俗易懂。

　　• 需求的第五條也需要一些小修改。我們如何才能檢測電壓的輸出范圍是在0到1伏之間呢? 總不能給個2伏的電壓，然後看看元器件有沒有被燒毀吧?

　　那麼，說檢驗系統在ADC端輸入電壓為1到2伏之間的時候，工作是否正常，這樣就檢驗就容易多瞭。需求描述應當是正面的，應當描述設備應該的行為，而不是設備不應該的行為。否則的話，測試將會無法進行。

　　版本0.2

　　1. 數字輸出端的切換頻率應當控制在每秒10次到每秒1次之間

　　2. 數字輸出端的切換頻率應當在最大值和最小值之間呈線性變化，並與ADC端的輸入電壓成正比

　　3. ADC端的輸入電壓應當保證在每100毫秒內至少被讀取一次

　　4. 檢驗當ADC端的輸入電壓范圍在0到1伏之間的時候，系統工作是否正常

　　第七步：你的需求是否通俗易懂?

　　相比於我們原來的描述：根據彎曲傳感器的輸出不同頻率來控制LED閃爍，我們上面的那些需求描述顯得難以閱讀和理解。

　　我發現，讓需求文檔變得通俗易懂，最簡單辦法莫過於，把過於細節的東西抽取出來，然後以條目的形式單獨定義。

　　版本1

　　1. 彎曲傳感器應當保證至少在100毫秒內讀取一次數據(放到註釋單獨列出)

　　2. 切換LED的狀態，使其與彎曲傳感器的讀數保持一致

　　3. 當彎曲傳感器的讀數為1伏特時，LED狀態切換的次數應當保持在平均一秒十次;當傳感器的讀數為0伏特時，LED的切換次數應保持在一秒1次。

　　定義：

　　• 彎曲傳感器：輸入電壓位於ADC的X端。安全電壓范圍為0到1伏特(放到註釋單獨列出)

　　• LED狀態：數字狀態由Y端輸出

　　這樣就好多瞭(盡管還不完美)。這些需求通俗易懂，不涉及到系統內部實現，且易於測試。對於系統行為的限定也僅僅限於需要做什麼，點到為止。(例如，對彎曲傳感器的采樣頻率，在實現上也可以更高，隻要不產生非預期行為，一切都可以)。

　　編寫需求就仿佛是在大腦中構建軟件的過程。因此要重於執行操作。

　　英文原文：Job Vranish 編譯：伯樂在線 – 黃小非