咨詢電(diàn)話(huà):023-88959644    24小(xiǎo)時(shí)服務熱線:400-023-8809
NEWS CENTER ·
新聞動态
關注中技(jì)互聯 關注前沿

優質的需求文檔的“七步走”?

發表日期:2012-03-29    文章編輯:山(shān)城阿修    浏覽次數(shù):11    标簽:

  要求準備文件,在嵌入式開(kāi)發領域是很(hěn)常見的。需求文檔是用來(lái)确定發展任務,并協調大(dà)型研發計(jì)劃。最終産品需求文檔開(kāi)發的做(zuò)法和(hé)消費者行(xíng)為(wèi)之間(jiān)的通(tōng)信鏈路中起着作(zuò)用。當需求文檔寫在右,他們可(kě)以發揮重要作(zuò)用。然而,如果您在工作(zuò)領域的嵌入式開(kāi)發時(shí)間(jiān)夠長,你(nǐ)會(huì)很(hěn)快發現,這方面沒有(yǒu)要求的文件實在是太多(duō)了。當您嘗試修複失敗的文件,你(nǐ)很(hěn)快就會(huì)發現,寫文件的正确要求也不是那(nà)麽容易。在這裏,我們提出一些(xiē)建議和(hé)希望,書(shū)面文件正确的要求,事情變得(de)更加清晰。

從高(gāo)層次的需求文檔編寫目的是提供所需的行(xíng)為(wèi)的描述。所需的行(xíng)為(wèi),可(kě)以是一個(gè)黑(hēi)盒子系統的描述,并注意以下細節:
•根據系統的工程師(shī)說。
測試的前提下不與開(kāi)發商溝通(tōng),你(nǐ)可(kě)以使用,以滿足設備認證要求的硬件要求。
•最終的結果産生(shēng)滿足最終用戶的要求。
在黑(hēi)盒測試寫作(zuò)質量要求的文件:
其基本原理(lǐ)是:需求文檔應該是簡潔,最理(lǐ)解預期的行(xíng)為(wèi)約束系統的描述。如果你(nǐ)遵循這個(gè)原則,其他的重要因素(可(kě)測性,避免過度設計(jì)等),将成為(wèi)理(lǐ)所當然的事。

列舉更詳細的規則,通(tōng)常會(huì)更有(yǒu)幫助。這裏是寫作(zuò)質量要求的文件,需要遵循的步驟:

(1)定義系統的邊界。這也是一個(gè)黑(hēi)盒子系統是必要的。

(2)定義的輸入和(hé)輸出。這應該是你(nǐ)看看內(nèi)部系統的唯一途徑。

最容易理(lǐ)解的方式來(lái)描述系統預期的行(xíng)為(wèi)。

除了輸入和(hé)輸出您的需求是不是也涉及該系統的其餘部分?如果是的話(huà),那(nà)麽你(nǐ)需要超過設計(jì)。重建的需要,使其精簡。

您的需求,是不是太暧昧?新增規範較為(wèi)有(yǒu)限。注:一些(xiē)模棱兩可(kě)的描述是不是一件壞事,假設所有(yǒu)的情況下是可(kě)以接受的,測試的描述中沒有(yǒu)說明(míng)的其他信息,那(nà)麽也沒關系。你(nǐ)不需要(也不應該)系統限制(zhì)的行(xíng)為(wèi)有(yǒu)些(xiē)過頭。

6。可(kě)以測試您的需求? (在這種情況下是一個(gè)黑(hēi)盒測試),如果沒有(yǒu),你(nǐ)最好返回到步驟4。如果這種返工多(duō)次,它表明(míng)你(nǐ)不能正确地描述系統的黑(hēi)匣子,或您的測試工具是不夠的。在這兩種情況下,非測試需求文檔是幾乎一文不值。

很(hěn)容易理(lǐ)解您的需求文檔嗎?如果您的需求文檔是很(hěn)困難的閱讀,它表明(míng)你(nǐ)寫得(de)不好,隻能帶來(lái)深重的苦難負責實施的人(rén)根據自己的需要。如果是這樣,返回到步驟3。

你(nǐ)真的做(zuò)第4步?你(nǐ)确定嗎?再次檢查。

例如:下面的例子中,我們描述了一個(gè)自制(zhì)的嵌入式設備的需求,根據不同的頻率值,彎曲傳感​​器(qì),LED閃爍讀取裝置的彎曲頻率。
顯然,我們已經完成步驟2和(hé)3!
•輸入:彎曲傳感器(qì)讀取數(shù)據。
•輸出的LED。
但(dàn)是我們跳(tiào)過第1步:
在這個(gè)例子中,我們将借鑒黑(hēi)匣子設備的微處理(lǐ)器(qì)。
我們将繼續開(kāi)展
步驟4:除了輸入和(hé)輸出,我們是否還(hái)涉及其他系統的邊界?
•微處理(lǐ)器(qì)不關心隻是一種從處理(lǐ)器(qì)的角度彎曲傳感器(qì)讀取數(shù)據,需要做(zuò)的是測量ADC的腳的電(diàn)壓。
•LED控制(zhì),隻能由數(shù)字輸出引腳。
現在,讓我們解決這個(gè)問題:
0版本的要求:
(1)該設備應根據不同頻率的電(diàn)壓ADC的數(shù)字輸出的狀态切換的腳。
12下一頁
第五步:需要寫暧昧?
好了,我們的描述是過于暧昧。輸出開(kāi)關速度快嗎?如何與電(diàn)壓的關系?輸入電(diàn)壓範圍是什麽?讓我們添加一些(xiē)更詳細的說明(míng):
版本0.1
應控制(zhì)輸出的第一個(gè)自由定時(shí)器(qì)
最高(gāo)的兩個(gè)自由運行(xíng)的定時(shí)器(qì)的頻率不得(de)超過每秒(miǎo)10次,不得(de)小(xiǎo)于每秒(miǎo)1。
自由運行(xíng)定時(shí)器(qì)觸發頻率之間(jiān)應該是最高(gāo)的和(hé)最低(dī)值的線性擴展和(hé)輸入電(diàn)壓的ADC方成正比。
讀取ADC的輸入電(diàn)壓端應每隔100毫秒(miǎo)
5 ADC的輸入電(diàn)壓端讀取,控制(zhì)自由運行(xíng)定時(shí)器(qì)周期值應更新。
6。 ADC輸入電(diàn)壓範圍應控制(zhì)在0-1伏之間(jiān)。
步驟6:你(nǐ)的要求是可(kě)測試的嗎?
首先,自由運行(xíng)的定時(shí)器(qì)不需要在這裏提及。因為(wèi)它基本上(shàng)不能黑(hēi)盒測試,它既不是輸入也不輸出,并沒有(yǒu)與這兩個(gè)連接。
讓我們用數(shù)字輸出的頻率應控制(zhì)在每秒(miǎo)10次每秒(miǎo),而不是自由運行(xíng)定時(shí)器(qì)的測試标準範圍內(nèi)。
•第四的需求,可(kě)能需要作(zuò)為(wèi)測試标準,一些(xiē)小(xiǎo)的變化。讓我們使用的ADC輸入電(diàn)壓方應保證至少(shǎo)可(kě)謂“,這說明(míng)讓我們來(lái)測試預期更容易理(lǐ)解的行(xíng)為(wèi),必須在每100毫秒(miǎo)讀取。
•需求也需要一些(xiē)小(xiǎo)的變化。我們怎樣才能檢測輸出電(diàn)壓範圍是0-1伏之間(jiān)?不能給2伏特的電(diàn)壓,然後在看起來(lái)已經被燒毀的元件?
檢測系統在ADC輸入電(diàn)壓1-2伏之間(jiān),工作(zuò)是正常的,這樣測試就好辦多(duō)了。要求的描述應該是“積極的”,應說明(míng)設備的行(xíng)為(wèi),“應該”,而不是設備的“不應該”的行(xíng)為(wèi)。否則,測試将失敗。
版本0.2
數(shù)字輸出的開(kāi)關頻率應控制(zhì)在1每秒(miǎo),每秒(miǎo)10次
開(kāi)關頻率的數(shù)字輸出應該是最高(gāo)和(hé)最低(dī)之間(jiān)的線性變化和(hé)輸入電(diàn)壓的ADC方成正比
ADC輸入電(diàn)壓方應确保,在每100毫秒(miǎo)要讀至少(shǎo)一次
(4)當測試端時(shí),ADC的輸入0-1伏的電(diàn)壓範圍,系統工作(zuò)正常
第七步:您的需求是很(hěn)容易理(lǐ)解?
相比,我們的原始描述:“根據不同頻率的彎曲傳感器(qì)輸出控制(zhì)LED閃爍,我們上(shàng)面介紹的這些(xiē)需求似乎難以閱讀和(hé)理(lǐ)解。
我發現,文件的要求變得(de)很(hěn)容易理(lǐ)解,最簡單的方法之一提取,然後太細節的條目中單獨定義的形式。
第1版
一個(gè)彎傳感器(qì)應确保至少(shǎo)100毫秒(miǎo)讀取數(shù)據(将單獨列出的評論)
切換LED狀态,彎曲傳感​​器(qì)的讀數(shù)一緻
彎曲傳感器(qì)讀數(shù)的1伏特時(shí),LED狀态切換的數(shù)量應保持在平均的二十倍;傳感器(qì)的讀數(shù)為(wèi)0伏時(shí),LED的開(kāi)關時(shí)間(jiān)應保持在第二個(gè)1。

定義:
•彎曲傳感器(qì):在ADC x側面的輸入電(diàn)壓。 0-1伏安全電(diàn)壓範圍(将單獨列出的注釋)
•LED狀态:Y端數(shù)字狀态輸出
好多(duō)了(雖然不完美)。很(hěn)容易理(lǐ)解這些(xiē)要求,不涉及系統內(nèi)實現,易于測試。密閉系統的行(xíng)為(wèi)的限制(zhì),需要做(zuò)的,點到為(wèi)止。 (例如,在實施的彎曲傳感器(qì)的采樣頻率也比較高(gāo),隻要它不會(huì)産生(shēng)意外的行(xíng)為(wèi),一切都可(kě)以)。
如果在大(dà)腦(nǎo)中的軟件建設的過程中,編寫需求。因此,必須執行(xíng)該操作(zuò)。

如沒特殊注明(míng),文章均為(wèi)中技(jì)互聯原創,轉載請(qǐng)注明(míng)來(lái)自www.zjcoo.com
相關新聞

CopyrightZJCOO technology Co., LTD. All Rights Reserved.    

渝ICP 備11003429号

  • qq客服
  • 公衆号
  • 手機版
  • 新浪微博