指南 · 介面
介面控制文件(ICD):內容與如何保持最新
收聽本指南 20 分鐘
介面控制文件記錄系統兩個部分之間跨越邊界的內容,並讓雙方團隊受同一份定義約束。本指南說明 ICD 包含什麼、由誰擁有、如何在一開始找出介面,以及如何在設計變更時讓文件與設計保持一致,並以一顆小型地球觀測衛星的兩個子系統作為實作範例。
本頁內容
什麼是介面控制文件
多數整合問題不在子系統內部,而是位於兩個子系統之間的接縫。一個團隊假設連接器朝某一方向防呆,另一個團隊則假設相反。一方每 100 ms 傳送一次狀態訊息,另一方的逾時卻是 80 ms。介面控制文件的存在,就是要讓這條接縫明確化:它在雙方都同意的單一位置,說明它們之間傳遞什麼,以及在什麼條件下傳遞。
ICD 從外部描述介面。它不說明任何一方如何建造,只說明每一方在邊界上必須呈現什麼:連接器及其接腳、電壓與電流、訊息格式與時序、安裝點、介面必須承受的環境。接著每個團隊各自設計自己這一側以相符。
有三種相關的文件名稱常被混淆:
| 文件 | 回答 | 典型內容 |
|---|---|---|
| 介面需求規格(IRS) | 介面必須做什麼? | 針對一個或多個介面的需求,在設計確定前以可驗證的「shall」陳述撰寫。 |
| 介面設計說明(IDD) | 一方如何實作它? | 由一方實際建造的介面設計,通常是一個軟體或硬體項目,詳細程度足以據以建造與測試。 |
| 介面控制文件(ICD) | 雙方同意了什麼? | 兩個特定方之間介面的受管制、共同核准的定義,並納入變更管制。 |
各計畫組合這些文件的方式不同。有些將需求併入 ICD;有些先撰寫 IRS,設計成熟後再撰寫 ICD。重要的是需求與已同意的定義都有記錄,並且清楚表明其中哪一份具有管制效力。
ICD 由誰擁有
ICD 有兩方,有時更多,但只有一個擁有者。各方是負責每一側的組織或團隊:兩個子系統團隊、主承包商與供應商、載具團隊與酬載團隊。擁有者是維護文件、追蹤未結事項並主持核准的個人或團體。在較大的計畫中,這是介面控制工作小組(ICWG):由各方代表加上負責整合的系統工程師組成,定期開會。
幾條擁有權規則可以避免大多數爭議:
- 每個介面一個擁有者,並在文件中指名。「系統團隊」不是擁有者;指名的負責人才是。
- 雙方都要核准。只有一方簽署的 ICD 是願望清單,不是管制文件。
- 由整合層級擁有其子項之間的介面。兩個子系統之間的介面屬於系統層級,因為任何一個子系統都無法單獨決定它。
- 外部介面,即與計畫外部設備或系統之間的介面,由計畫方擁有並與外部方議定,外部方可能有自己優先適用的文件。
ICD 包含什麼
確切的大綱取決於領域與計畫的標準,但完整的 ICD 涵蓋的範圍相同。保留章節並註明「不適用」,而不是刪除它,讓審查者能看出它曾被考量。
| 章節 | 記錄內容 |
|---|---|
| 識別與各方 | 介面編號與名稱、雙方、擁有者、文件狀態與核准。 |
| 介面概觀 | 雙方以及兩者之間每條連結的圖,以及介面用途的簡短陳述。 |
| 介面清單 | 每條個別連結(線束、匯流排、線路、管路、安裝),各有自己的編號、端點與狀態。 |
| 機械與實體 | 安裝點與螺栓孔位、外形包絡與禁入區、介面處的質量特性、對準、連接器類型與位置。 |
| 電氣 | 接腳配置、電壓與電流範圍、電源品質、接地與搭接、屏蔽、隔離、訊號位準。 |
| 資料與通訊協定 | 通訊協定與實體層、含欄位名稱、類型、範圍、單位與比例的訊息定義、識別碼、錯誤處理。 |
| 時序 | 訊息速率與週期、延遲預算、啟動與喚醒順序、逾時,以及逾時發生時各方的處理方式。 |
| 流體、熱與光學 | 邊界處的流量、壓力與溫度、跨越邊界傳遞的熱量、光學路徑與視野(如適用)。 |
| 環境 | 介面必須承受的振動、衝擊、溫度、濕度、防塵防水與電磁相容條件。 |
| 介面需求 | 介面必須滿足的需求,每項都追溯到其父需求。 |
| 驗證 | 每項需求如何在介面處驗證(測試、分析、檢查、展示)、在什麼層級,以及使用哪些設備。 |
| 未結事項 | 每個 TBD(數值尚未決定)與 TBR(數值已提出但尚未確認),每項都附有負責人與結案日期。 |
| 變更歷程 | 每個修訂版及其變更請求、變更內容與核准者。 |
資料與時序最需要詳細說明
機械與電氣介面通常在早期的配合檢查與首次通電時就經過實體檢查。資料與時序的不一致則會存在更久,往往直到系統整合,因為各方都是對照依自己對文件的解讀所建的模擬器進行測試。針對每則訊息,寫下識別碼、週期及其容許誤差、每個欄位的類型、範圍、單位與比例、位元組順序,以及訊息延遲、遺失或超出範圍時接收方的處理方式。只寫「battery current」而沒有單位、正負號慣例(充電或放電為正)與解析度的訊息定義,還不算受管制。
驗證介面本身
介面需求與其他需求一樣要經過驗證(需求驗證矩陣指南 說明方法、層級與證據),但其證據有一種特殊形式:需要雙方。實際單元之間的相容性測試,或一個實際單元與另一方經過確認的模擬器之間的測試,比對照兩份各自解讀的 ICD 所做的兩項獨立測試更有力。請在 ICD 中規劃這些測試,讓設備與時程在需要時已經就緒。
在架構中找出介面
ICD 只能管制已被找出的介面。找出介面的可靠方式是從架構著手,而不是靠記憶。
- 從功能開始。將任務分解為功能及其輸入與輸出(功能分析指南 說明做法)。N² 圖將功能(或子系統)放在對角線上;A 列 B 欄的儲存格記錄 A 傳送給 B 的內容。每個已填寫的非對角線儲存格都是一項需要路徑的交換。已填寫儲存格的群集顯示哪些功能屬於一起;繁忙的列或欄則標示出許多其他功能所依賴的功能。
- 將功能分配給元件。一旦每個功能都由一個實體零件執行,不同零件中功能之間的每項交換,就成為跨越零件邊界的交換。系統架構指南 說明如何進行並檢查這項分配。
- 為每項跨越邊界的交換提供實體路徑。線束、匯流排、無線電鏈路、管路或機械接頭。沒有路徑的交換是設計中的缺口;不承載任何東西的路徑,要嘛是不必要的,要嘛是尚未被理解。
- 繪製介面圖。針對每一對參與方,顯示雙方、它們在邊界處的內部零件,以及每條連結及其承載的內容。這會成為 ICD 的概觀圖。
在找到介面時就為它們編號。下方的實作範例將其連結編為 IF-01 到 IF-25,並以小數為較大介面內的連結編號(IF-14 內的 IF-14.1)。編號讓介面能在需求、測試程序與變更請求中被引用,並在名稱變更時讓介面清單保持穩定。
讓 ICD 與模型保持連結
以獨立文書處理檔案撰寫的 ICD,從核准當天就開始與設計脫節。線束圖中的某支接腳被重新配置、軟體中的訊息週期變更、為了一項較晚的需求加入新訊號,而 ICD 幾週後才更新,或根本沒有更新。審查者於是比較文件與文件,而不是比較文件與設計。
以模型為基礎的系統工程扭轉了這一點。每個介面都是系統模型中的一個元素,連接到其兩個端點、它承載的項目以及管轄它的需求。ICD 是從這些元素產生的報告。於是:
- 同一條連結在 ICD、介面圖、需求追溯與驗證矩陣中以相同的數值出現,因為它們都讀取同一份定義。
- 訊息速率或連接器的變更會出現在下一份產生的 ICD 中,而變更歷程來自模型本身的記錄。
- 檢查在模型上執行:兩個零件之間沒有連結承載的交換、只有一個端點的連結、負載超過容量的連結、沒有擁有者或狀態的連結。
- 介面上的需求會追溯到該介面,因此 ICD 的需求與驗證章節能保持完整(關聯類型與缺口檢查請參閱 需求可追溯性指南)。
並非所有內容都適合放在模型屬性中。詳細的連接器圖面、時序圖與冗長的訊息目錄可以保留在附加或引用的文件中。模型仍保存介面、其狀態、擁有者與引用,因此產生的 ICD 會指向正確的修訂版。
介面變更管制
介面定義會分階段成熟,而階段決定了變更的處理方式。簡單的四階段方案適用於大多數計畫:
| 狀態 | 意義 | 變更方式 |
|---|---|---|
| Draft(草稿) | 一方的初步定義。 | 擁有者可自由編輯。 |
| Proposed(已提議) | 提供給另一方審查。 | 變更在工作小組中討論並記錄。 |
| Agreed(已同意) | 雙方都接受;設計可依此進行。 | 變更需要雙方同意,並為每一方提出影響說明。 |
| Baselined(已納入基準線) | 屬於已核准的組態基準線。 | 正式的變更請求,由變更委員會評估與核准,並重新發行 ICD。 |
常見的節奏是在系統需求審查前草擬介面、在初步設計審查前達成同意,並在關鍵設計審查前納入基準線。無論節奏為何,針對已納入基準線之介面的變更請求都應說明原因、受影響的連結與項目、對各方設計、成本與時程的影響、受影響的需求與驗證,以及適用性:變更從哪個建置版本或序號開始適用。如何找出並評估這些影響,變更影響分析指南 有逐步說明。
將 TBD 與 TBR 作為一份必須縮短的清單來追蹤。在關鍵設計審查時仍充滿未結事項的介面,無論其狀態寫什麼,都是時程風險。
常見的失誤
- 沒有人找到的介面。功能之間的某項交換從未被賦予實體路徑,或某個外部介面(地面設備、測試設備、操作者)被遺漏。請從架構建立介面清單,而不是從線束清單。
- 單方面的文件。一個團隊撰寫 ICD,另一個團隊從未正式同意,而分歧在整合時才浮現。在狀態成為 Agreed 之前,要求雙方都核准。
- 缺少單位與慣例。沒有單位、正負號慣例、位元組順序或比例的數值,會招致兩種不同的解讀。在審查中將每一項都視為缺陷。
- 未將負載與容量比較。每則訊息都放得下,但合起來超過匯流排;每項負載都符合線束,但合起來超過其額定值。加總每條連結上的負載並與其容量比較,並保留裕度。在下方的範例模型中,IF-05 Payload Interface 在一條 400 Mbps 的連結上承載 480 Mbps 的影像條帶加上 0.02 Mbps 的指令排程:400 Mbps 中的 480.02,即 120 %,在整合前就由模型標示出來,而不是在測試台上才發現。
- 時序未明確說明。給了速率,卻沒有給容許誤差與逾時行為。兩者都要記錄,以及當另一方延遲時各方的處理方式。
- 過時的副本。ICD、線束圖與軟體的訊息表各自保有自己的版本。請從單一來源產生,或至少指明哪一份具有管制效力。
- 沒有負責人的未結事項。沒有指定人員與日期的 TBR 會一直保持未結。兩者都要為每一項指定。
- 太晚規劃驗證。介面測試需要雙方的硬體或經過確認的模擬器。在 ICD 達成同意時就規劃這些測試,而不是等到單元送達時。
實作範例:CubeSat 上 C&DH 到 Communications 的介面
範例為 EO-1,一顆從 500 km 太陽同步軌道拍攝農地影像的 6U 地球觀測 CubeSat;MBSE 範例專案指南 會走過整個模型。這裡我們取太空載具內的一條接縫:介於 1.4 C&DH(指令與資料處理,一台具有 64 GB 酬載儲存空間的飛行電腦)與 1.5 Communications(用於指令的 1.5.1 UHF Transceiver 與用於酬載資料的 1.5.2 S-band Transmitter)之間。兩側由不同團隊建造,而衛星執行的每道指令與傳送到地面的每張影像都會跨越這條邊界。
找出交換內容
模型的標準成像過境 OPS Run Nominal Imaging Pass 被分解為十二個功能 OPS.1 到 OPS.12,其中十一個分配給執行它們的資產。其 N² 圖將它們放在對角線上,並將它們交換的項目放在儲存格中:
有兩個儲存格跨越 C&DH 與 Communications 之間的邊界:
- OPS.2 Receive Imaging Plan 列(由 UHF Transceiver 執行)、OPS.3 Load Command Schedule 欄(由 C&DH 執行):Command Packets,來自無線電的已解碼指令封包。
- OPS.7 Encode and Store Image 列(C&DH)、OPS.8 Transmit Image Data 欄(S-band Transmitter):Downlink Frames,經壓縮與封包化的影像資料。
第三項交換沒有出現在這次過境中,因為它來自太空載具的模式邏輯:C&DH 的進入動作 Enable S-band Transmitter 會傳送 Transmitter Enable Command 給由 S-band Transmitter 執行的 F9 Transmit Payload Data。只從單一情境建立的介面清單會遺漏它,這就是為什麼要在列出介面之前,先在整個模型中將功能分配給資產。
連結及其承載的內容
示範專案已為每項交換提供實體路徑。為了將它們組成一個受管制的介面,我們在示範專案中加入了一個元素:父管道 IF-26 C&DH to Communications Interface,連接兩個子系統,狀態為 Agreed,擁有者為 Comms Lead,並以兩條現有連結作為其子項。以下其餘內容都是示範專案的原始內容。
| 連結 | 端點 | 媒介與連接器 | 承載內容 | 容量 | 狀態 |
|---|---|---|---|---|---|
| IF-07 Radio Command Interface | UHF Transceiver → C&DH | UART,115.2 kbaud;J3(Micro-D 9) | Command Packets,0.0096 Mbps(9.6 kbps) | 0.1 Mbps | Baselined(已納入基準線) |
| IF-08 Payload Data Interface | C&DH → S-band Transmitter | SpaceWire;J4(Micro-D 9) | Downlink Frames,10 Mbps;Transmitter Enable Command,未設定速率 | 100 Mbps | Agreed(已同意) |
每條連結都追溯到驅動它的需求:IF-07 satisfies 5.2 UHF Command Uplink(「The UHF transceiver shall receive ground commands at 9.6 kbps」),IF-08 satisfies 5.1 S-band Downlink Rate(「The S-band transmitter shall downlink payload data at 10 Mbps」)。
介面圖
介面控制圖將雙方顯示為帶狀區域,中間是父介面,每條連結顯示為一條附有狀態、容量與項目的長條,並從每條連結畫一條線到它所連接的零件:
C&DH 帶狀區域中沒有零件,因為模型將飛行電腦視為一個單元:兩條連結都終止於 C&DH 本身。在 Communications 這一側,每條連結終止於不同的無線電,這正是線束團隊需要知道的。
產生的 ICD
ICD 從相同的元素匯出為 Word 文件。第一頁包含介面登錄表與狀態摘要;接著每個管道都有自己的章節,列出端點、連接器與接腳、媒介、傳遞的項目及其方向與速率、關聯的需求以及容量檢查。
下載 ICD:C&DH 到 Communications 介面的 EO-1 ICD(.docx),即 Holarch 匯出的完整三頁文件,已移除匯出日期。其中只包含虛構的 EO-1 示範資料。
範例說明了什麼
- 登錄表就是工作小組的議程。IF-07 已納入基準線,因此對它的變更須經過變更請求。IF-08 已達成同意:變更仍需要 C&DH 與 Communications 兩個團隊。兩者都沒有未結的 TBD 或 TBR,因此這個介面已可整體納入基準線。
- 將容量與媒介實際能提供的量比較。IF-07 在記錄容量 0.1 Mbps 上承載 9.6 kbps,文件將其報告為 10 %。以 115.2 kbaud 運作、每位元組一個起始位元與一個停止位元的 UART,每秒傳送 115,200 × 8 / 10 = 92,160 bit 的資料,因此實際容量約為 92 kbps,負載約為其 10.4 %。無論哪種算法裕度都很大,但記錄的數字是向上取整的;在較繁忙的連結上,這種取整會掩蓋問題。
- 連結可以通過,而其系統卻失敗。IF-08 在 100 Mbps 的 SpaceWire 連結上傳送 10 Mbps 的訊框,為容量的 10 %。約束位於下游的一個介面:IF-12 S-band Downlink 在 10 Mbps 的無線電鏈路上承載 9.6 Mbps,達 96 %。更快的訊框流可以輕鬆通過 IF-08,卻會在天線處失敗,因此 ICD 審查要看整條鏈,而不是單一連結。
- 沒有速率的項目不會被檢查。Transmitter Enable Command 沒有資料速率,因此容量檢查會略過它。它很小,但空白的數值就是未結事項:為它設定速率,或設定附負責人的 TBD。
- 父介面本身不承載容量。它將其連結的項目(此處為三個)打包在一起,並為這對參與方提供一份文件、一位擁有者與一個狀態;負載檢查則在每條連結上執行。
- 變更可以追溯。如果任務改用更快的下傳,Downlink Frames 的速率只需在一處變更,IF-08 與 IF-12 的檢查會重新執行,而追溯到 IF-08 的需求 5.1 會指出需要重新驗證的內容。
在 Holarch 中試試看
- 以 管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程) 建立示範專案。
- 開啟 介面 → N² 圖,並開啟動作 OPS Run Nominal Imaging Pass 的 N² 圖,查看其功能之間的交換。
- 開啟 介面 → ICD,按一下 + 新增圖,並選擇 C&DH 作為左側、Communications 作為右側的父資產。
- 從面板將現有的管道 IF-07 Radio Command Interface 與 IF-08 Payload Data Interface 拖曳到中央方框。它們的項目與連接會一併帶入。
- 選取一條連結,檢視其 介面狀態、擁有者、TBD/TBR、容量 與 單位,以及其關聯的需求。
- 按一下 匯出 ICD 文件 取得 Word 文件,或按 匯出 ICD (CSV) 取得表格。
介面 → 介面登錄表 列出專案中的每個介面及其狀態與容量檢查;在示範專案中,它顯示 IF-05 超過容量。逐步說明請見 產生介面控制文件;已納入基準線的介面透過 變更請求 變更。
下一步
- Holarch 中的介面:介面登錄表、容量檢查,以及從模型產生的 ICD。
- 介面文件:管道、項目、介面控制圖、N² 圖與 Physical I/O 圖。
- 變更請求文件:已納入基準線項目的組態管制。
- 什麼是 MBSE?:工程師為何將系統保存在模型中。