Holarch

培訓 · 第 9 單元:SysML v2 基礎

第 9 單元:SysML v2 基礎:練習單

供初次接觸 SysML v2 的學生與工程師使用。每章一項練習任務與幾個問題,在看完每支影片後練習。可從瀏覽器列印本頁,或在螢幕上作答。解答從最後新的一頁開始。

開始之前

先修
應用程式內的教學課程 SysML v2: Getting Started(說明 → 教學課程)。
方案
Free
專案
應用程式內 SysML v2 教學課程的起始專案;在 Hybrid Car 示範專案上練習。

9.1 定義與屬性

觀看第 9.1 章(4:33)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 建立 Hybrid Car 示範專案:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。開啟模型 → 編輯器以及套件 Vehicles。
  2. 在 enum def FuelKind 下方新增 enum def CoolingMode { enum passive; enum active; }。
  3. 在 part def Body 下方選擇插入 ▾ → 零件定義,並以 attribute redefines mass = 8 [kg];、attribute coolantVolume : VolumeValue;(輸入 Volu,然後按 Enter 從自動完成清單中接受 VolumeValue)與 attribute mode : CoolingMode; 完成 part def Radiator :> Component。
  4. 將質量改為 8 [W],將指標移到底線上閱讀訊息,然後改回 8 [kg]。
  5. 在 part def Powertrain 中新增 part radiator : Radiator;。然後將游標放在 coolantVolume 上,按 F2,將它重新命名為 coolantCapacity。
  6. 若要進行有檢查的逐步練習,請執行 SysML v2 教學課程 Definitions and Attributes(說明 → 教學課程)。

當編輯器下方的狀態回報沒有問題,且「瀏覽器」在 Vehicles 下顯示 Radiator 及其 coolantCapacity 與 mode 時,即完成。

常見問題

  1. 在 part def Battery :> Component { attribute redefines mass = 45 [kg]; } 中,:> 與 redefines 各自做什麼?
  2. 為什麼 Component 宣告為 abstract part def?
  3. 為什麼 attribute redefines power = 60 [kg]; 會產生錯誤?
  4. doc /* … */ 與 // 行有什麼不同?

9.2 埠與介面

觀看第 9.2 章(3:44)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 Vehicles。
  2. 在 interface def HighVoltageBus 下方新增 interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }。
  3. 在 part def Powertrain 中,將 connect controller.engineCtl to engine.ecu; 取代為 interface engineControl : ControlLink connect controller.engineCtl to engine.ecu;,並在 part battery : Battery; 之後新增 part auxBattery : Battery;。
  4. 開啟架構 → Interconnection View以及檢視 powertrainConnections。從 auxBattery 的埠 powerOut 的控點拖曳到馬達的埠 powerIn,然後選擇 Interface : HighVoltageBus。
  5. 選取新的線條,並在屬性面板中將其名稱輸入為 auxBus。然後開啟模型 → 編輯器,找到 Holarch 在 Powertrain 中寫入的那一行。

當 Powertrain 包含 interface engineControl : ControlLink … 以及來自檢視的 auxBus 介面,且編輯器下方的狀態回報沒有問題時,即完成。

常見問題

  1. 引擎有 port fuelIn : ~FuelPort;。波浪號改變了什麼?
  2. bind output = transmission.output; 與 interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn; 有什麼不同?
  3. 當您從電池的 powerOut 拖曳到馬達的 powerIn 時,為什麼檢視會提供 Interface : HighVoltageBus?

9.3 動作與流

觀看第 9.3 章(4:31)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 VehicleBehavior。
  2. 在 action def <'F.3'> DriveWheels 下方新增 action def <'F.4'> Refuel { in attribute fuelDemand : Real; out item fuel : Fuel; }。
  3. 開啟行為 → FFBD,按一下 + 新增圖,選擇 Refuel,然後按一下建立。在新增面板中輸入 Open Filler Door 並按 Enter,接著輸入 Pump Fuel 與 Close Filler Door。
  4. 開啟模型 → 編輯器並找到 Refuel:FFBD 已寫入它的三個步驟以及步驟之間的 succession。
  5. 開啟行為 → Action Flow以及檢視 driveCycleFlow。找到包含 brake 的泳道,然後在 DrivenCar 中找到將它放在那裡的 perform 行。
  6. 開啟行為 → 功能分析,按一下選擇…並挑選 DriveCycle。確認其功能是依短名稱編號的。

當 Refuel 在編輯器中顯示其參數、三個步驟及其 succession,且您能說出哪個零件的泳道包含 brake 時,即完成。

常見問題

  1. 在 first start then split; fork split; then supply; then produce; 中,哪些步驟平行執行?又是什麼讓它們重新匯合?
  2. first supply then ready; 與 flow of Fuel from supply.fuel to produce.fuel; 有什麼不同?
  3. Action Flow 檢視的泳道從哪裡來?

9.4 狀態與轉換

觀看第 9.4 章(3:51)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 VehicleBehavior。
  2. 在 attribute def Unplug; 之後新增 attribute def FaultDetected;。
  3. 在 state def PowertrainStates 的右大括號之前,新增 state limpHome { entry action warnDriver; do action driveLimited; } 與 transition limpStop first limpHome accept StopRequest then off;。
  4. 開啟行為 → 狀態機,按一下 + 新增圖,在顯示下選擇 PowertrainStates,然後按一下建立。
  5. 選取 electric,從其控點拖曳到 limpHome;放在轉換上。在轉換面板中輸入名稱 electricFault 與觸發條件 FaultDetected,然後按一下在文字中顯示。

當 PowertrainStates 包含 limpHome、limpStop 以及接受 FaultDetected 的轉換 electricFault,且編輯器下方的狀態回報沒有問題時,即完成。

常見問題

  1. 是什麼讓 off 成為 PowertrainStates 的初始狀態?
  2. state off; 之後是 accept StartRequest if charge > 20 then electric;。請說出它的觸發條件、防護條件、來源與目標。
  3. 狀態的 entry、do 與 exit 動作分別在什麼時候執行?
  4. DrivenCar 中的 exhibit state powertrainStates : PowertrainStates; 表達了什麼?

9.5 需求

觀看第 9.5 章(4:15)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 VehicleRequirements。
  2. 在 attribute minElectricRange 之後新增 attribute minTopSpeed : SpeedValue = 180 [km/h];。
  3. 在 requirement def <'VR-5'> ChargeTime 下方,選擇插入 ▾ → 需求定義,並撰寫 <'VR-8'> TopSpeed,其陳述為 The sports car shall reach at least the minimum top speed.、主體為 car : SportCar,以及 require constraint { car.topSpeed >= minTopSpeed }。
  4. 在其他 satisfy 行之後新增 satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;。
  5. 將 minTopSpeed 改為 220 [km/h]。將指標移到編輯器標在 satisfy 上的標記,閱讀它比較的數值,然後按 ⌘Z / Ctrl+Z。
  6. 開啟需要與需求 → 需求並找到 VR-8,然後開啟需要與需求 → 品質並按一下檢查品質。

當 VR-8 出現在需求表格中、satisfy 在 180 km/h 時沒有標記,且「檢查品質」已為其陳述評分時,即完成。

常見問題

  1. 為什麼要將 maxCurbMass 之類的限制值保存為具名屬性,而不是在每個約束中寫入數字?
  2. 在 requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; } 中,:>> 做什麼?
  3. satisfy carSpec by fleet.sedan; 讓 Holarch 能檢查什麼?
  4. 您在需求頁面上設定需求的狀態與優先順序。SysML 文字會改變嗎?

9.6 驗證與可追溯性

觀看第 9.6 章(3:32)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 VehicleRequirements。
  2. 在 verification <'VC-1.1'> sedanWeighing 之後新增 verification def <'VC-2'> BatteryWeighing { subject battery : Battery; objective { verify batteryMassLimit; } return verdict : Boolean = battery.mass <= 50 [kg]; } 與 verification <'VC-2.1'> sedanBatteryWeighing : BatteryWeighing { subject battery = fleet.sedan.powertrain.battery; }。
  3. 開啟驗證 → 驗證案例。在新案例的列中按一下 + 步驟,接著按 + 新增步驟,在動作下輸入 Weigh the battery on a bench scale,按一下套用,然後在其狀態按鈕中按一下通過。
  4. 開啟驗證 → RVTM,找到 VR-6 batteryMassLimit 以及新案例與其狀態。
  5. 開啟驗證 → 可追溯性矩陣,以需求作為列、類別 動作 作為欄,按一下 sedanAcceleration 與 accelerate 交會的儲存格,然後選擇 satisfied by。
  6. 在套件末尾新增 requirement <'VR-9'> tankVolume { doc /* The fuel tank shall hold at least 40 L. */ subject tank : FuelTank; } 與 connection tankDerivation : Derivation connect carSpec.sedanRange to tankVolume;。然後開啟驗證 → 模型檢查。

當 RVTM 將新案例列在 VR-6 下且為通過、編輯器包含新的 satisfy 與 tankDerivation,且狀態回報沒有問題時,即完成。

常見問題

  1. 在 objective massObjective { verify carSpec.sedanMass; } 中,verify 表達了什麼?您在哪裡看到它?
  2. 驗證案例的 verdict 與驗證案例頁面上的狀態有什麼不同?
  3. 什麼時候使用 satisfy,什麼時候使用 Derivation?
  4. 在可追溯性矩陣的儲存格中選擇 satisfied by 時,會發生什麼事?

9.7 約束與計算

觀看第 9.7 章(4:26)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 VehicleRequirements。
  2. 在 constraint def SpeedLimit 之後新增 constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }。
  3. 在圖頁面上按一下 + 新增圖,選擇參數檢視,並在顯示下選擇 VehicleRequirements,然後按一下建立。新的檢查會通過:48 kg 在 50 kg 以內。
  4. 在套件 Vehicles 中,將轎車電池的質量改為 52 [kg];檢視會顯示檢查失敗。按 ⌘Z / Ctrl+Z,然後按一下全部求解再次檢查每個約束。
  5. 在 requirement def <'VR-2'> Acceleration 中,將 attribute zeroToHundred : TimeValue; 取代為 attribute zeroToHundred : TimeValue { @TBD { owner = "Test lead"; rationale = "The test track is not booked yet."; } }。開啟需要與需求 → TBD/TBR,找到該需求及其負責人。
  6. 開啟架構 → 預算和 TPM,按一下選擇根零件…並選擇 sedan。在數量下選擇質量,找到電池的 48 kg。

當 sedanBatteryCheck 在參數檢視中顯示 Pass,且 TBD/TBR 登錄表列出負責人為 Test lead 的 Acceleration 需求時,即完成。

常見問題

  1. constraint def 與 calc def 有什麼不同?
  2. 參數檢視中的某個約束顯示「需要輸入」。缺少了什麼?
  3. 為什麼要以 #TBD 或 @TBD { … } 標記待定數值,而不是把 TBD 寫成數值?
  4. 分析案例為計算增加了什麼?

9.8 變體與組態

觀看第 9.8 章(3:42)

練習

在 Hybrid Car 示範專案(SysML v2)上:

  1. 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件 Vehicles。它已經匯入 HolarchVariability。
  2. 在 part def CarLine 中,於 charger variation 之後新增 variation part rims : Wheel { variant part steelRims : Wheel; variant part alloyRims : Wheel { attribute :>> mass = 18 [kg]; } }。編輯器會註明三個組態尚未選擇 rims。
  3. 在 wallboxNeedsLargePack 之後新增規則 assert constraint alloyNeedsLargePack { rims == rims::alloyRims implies pack == BatteryPack::largePack }。
  4. 開啟模型 → 瀏覽器並選取 selfChargingHybrid。在屬性面板的組態區段中,為 rims 選擇 steelRims;為 plugInHybrid 與 longRangeHybrid 選擇 alloyRims。然後在 selfChargingHybrid 上試試 alloyRims,閱讀判定結果,再按 ⌘Z / Ctrl+Z。
  5. 開啟 CarLine 的列選單(⋯),選擇新增組態…。將它命名為 cityHybrid,選擇 standardPack、noCharger 與 steelRims,確認判定結果為「有效」,然後按一下建立。
  6. 按一下頂端列中的檢視方式 ▾並選擇 cityHybrid,然後從圖清單中開啟檢視 carLineVariants:它未選擇的變體會被隱藏。

當屬性面板中 CarLine 的「產品線」區段列出四個組態(全部為「有效」)以及規則 alloyNeedsLargePack 時,即完成。

常見問題

  1. variation part def BatteryPack { … } 與 variation part charger : Component { … } 有什麼不同?
  2. plugInHybrid 選擇了 BatteryPack::standardPack 與 charger::wallbox。會發生什麼事?為什麼?
  3. 某個組態尚未為每個變化點選擇變體。它的判定結果是什麼?
  4. metadata def <safetyCritical> SafetyCritical 讓您能寫出什麼?其他 SysML v2 工具如何看待它?

解答

9.1 定義與屬性

  1. :> 使 Battery 成為 Component 的特化,因此它繼承 mass、partNumber 與 power。redefines 以 Battery 自己的特徵取代繼承的 mass,此處繫結為 45 kg。
  2. 沒有任何東西單純是「元件」,只有各種元件。抽象定義收集每個元件共有的內容,只有其特化(例如 Battery 或 Engine)才描述實際的零件。
  3. power 的類型是 PowerValue,而公斤是質量單位。檢查器會評估單位,因此會在數值下標上底線,直到單位改為功率單位,例如 [W]。
  4. doc 註解是屬於該元素的文件,是模型的一部分。// 註記只留在文字中,不屬於模型。

9.2 埠與介面

  1. 它使埠共軛:引擎的埠具有與 FuelPort 相同的特徵,但方向相反,因此 FuelPort 的 out attribute flowRate 會以輸入的形式抵達引擎。
  2. 繫結表示兩個特徵是同一個:動力系統的邊界埠就是變速箱的輸出。介面用法則連接兩個不同的埠,而其介面定義說明它的兩端接受哪些埠。
  3. Holarch 會提供兩端都符合這兩個埠的介面定義。HighVoltageBus 的兩端為 source : PowerPort 與 load : ~PowerPort,正好符合這兩個埠。

9.3 動作與流

  1. 在 fork split 之後,supply 與 produce 以平行分支開始;fork 之後的每個 then 都會開始一個分支。join ready 會等待兩者完成後才進入下一步。
  2. 前者是 succession:它依時間排定步驟的順序。後者是 flow:它將一個 Fuel 項從某個步驟的輸出參數傳到另一個步驟的輸入,本身並不排定步驟的順序。
  3. 來自 perform:每個執行某步驟的零件,例如 part redefines tank { perform trip.supply; },都會得到一條包含其執行步驟的泳道。

9.4 狀態與轉換

  1. entry; then off;:entry 之後接著一個到 off 的 succession,因此狀態機從那裡開始。檢視會將它畫成圓點。
  2. 觸發條件:訊號 StartRequest。防護條件:charge > 20。目標:electric。簡短形式從它所接續的狀態 off 開始。
  3. entry 動作在進入狀態時執行,do 動作在狀態作用期間執行,exit 動作則在離開狀態時執行。
  4. 表示汽車展現這個狀態機:汽車擁有一個 PowertrainStates 的用法,因此其狀態就是汽車的狀態。

9.5 需求

  1. 每個使用該名稱的需求都只需一次編輯就會跟著更新,而且限制值帶有單位,因此檢查器會以單位比較數值。
  2. 它重新定義 sedanMass 從 CurbMass 繼承的 limit 屬性,為這個用法提供自己的數值。
  3. 轎車的數值是否符合 carSpec 的約束。如果轎車的整備質量超過限制,編輯器會標記 satisfy 並顯示比較的數值。
  4. 不會。狀態、優先順序與驗證方法是保存在模型旁的 Holarch 資料;它們永遠不會變更文字。

9.6 驗證與可追溯性

  1. 表示這個驗證案例驗證需求 sedanMass。RVTM 會將該案例列在該需求下。
  2. verdict 是模型的一部分:一個運算式,此處為整備質量是否在限制內。步驟、結果以及測試執行的狀態則是保存在模型旁的 Holarch 資料。
  3. satisfy 表示某個設計元素(例如零件或動作)滿足一個需求。Derivation 將原始需求連接到由它衍生的需求;它需要 private import RequirementDerivation::*;。
  4. Holarch 會將 satisfy 寫入 SysML 文字,因此追溯成為模型的一部分,並顯示在編輯器中。

9.7 約束與計算

  1. 約束定義陳述一個針對其參數、成立與否的條件,例如 mass <= limit。計算定義則計算並回傳一個數值,例如 return ratio = power / mass;。
  2. 某個參數還沒有數值。將每個參數繫結到一個數值,例如 in mass = fleet.sedan.curbMass;。
  3. 以 TBD 取代數值並不是有效的 SysML。來自 Holarch HolarchMetadata 套件的中繼資料能讓文字保持有效;TBD 與 TBR 特化了標準的 StatusInfo 中繼資料,因此其他 SysML v2 工具會將它們讀作狀態註記。
  4. 它將計算套用到一個主體(例如轎車)、回傳結果,並具有一個目標,其 require 約束由 Holarch 像其他約束一樣進行評估。

9.8 變體與組態

  1. 前者是 variation 定義,一組可重複使用的選擇:以它為類型的用法(例如 part pack : BatteryPack;)就是變化點。後者是 variation 用法,是在單一設計內宣告的變化點。
  2. 規則 wallboxNeedsLargePack 被違反:它規定 wallbox 意味著大型電池組。判定結果會指出該規則,編輯器也會回報失敗的斷言。
  3. 不完整,並指出未決的變化點。在某個變化點尚未選擇時,針對它的規則既不算滿足,也不算違反。
  4. 短名稱會成為關鍵字,例如 #safetyCritical part controller : Controller;。它是一般的 metadata 用法,因此其他 SysML v2 工具會將它視為該零件上的中繼資料。

由 Holarch發布