第 9 單元:SysML v2 基礎:練習單
供初次接觸 SysML v2 的學生與工程師使用。每章一項練習任務與幾個問題,在看完每支影片後練習。可從瀏覽器列印本頁,或在螢幕上作答。解答從最後新的一頁開始。
開始之前
- 先修
- 應用程式內的教學課程 SysML v2: Getting Started(說明 → 教學課程)。
- 方案
- Free
- 專案
- 應用程式內 SysML v2 教學課程的起始專案;在 Hybrid Car 示範專案上練習。
9.1 定義與屬性
觀看第 9.1 章(4:33)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 建立 Hybrid Car 示範專案:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。開啟模型 → 編輯器以及套件
Vehicles。 - 在
enum def FuelKind下方新增enum def CoolingMode { enum passive; enum active; }。 - 在
part def Body下方選擇插入 ▾ → 零件定義,並以attribute redefines mass = 8 [kg];、attribute coolantVolume : VolumeValue;(輸入Volu,然後按 Enter 從自動完成清單中接受VolumeValue)與attribute mode : CoolingMode;完成part def Radiator :> Component。 - 將質量改為
8 [W],將指標移到底線上閱讀訊息,然後改回8 [kg]。 - 在
part def Powertrain中新增part radiator : Radiator;。然後將游標放在coolantVolume上,按 F2,將它重新命名為coolantCapacity。 - 若要進行有檢查的逐步練習,請執行 SysML v2 教學課程 Definitions and Attributes(說明 → 教學課程)。
當編輯器下方的狀態回報沒有問題,且「瀏覽器」在 Vehicles 下顯示 Radiator 及其 coolantCapacity 與 mode 時,即完成。
常見問題
- 在
part def Battery :> Component { attribute redefines mass = 45 [kg]; }中,:>與redefines各自做什麼? - 為什麼 Component 宣告為
abstract part def? - 為什麼
attribute redefines power = 60 [kg];會產生錯誤? doc /* … */與//行有什麼不同?
9.2 埠與介面
觀看第 9.2 章(3:44)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
Vehicles。 - 在
interface def HighVoltageBus下方新增interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }。 - 在
part def Powertrain中,將connect controller.engineCtl to engine.ecu;取代為interface engineControl : ControlLink connect controller.engineCtl to engine.ecu;,並在part battery : Battery;之後新增part auxBattery : Battery;。 - 開啟架構 → Interconnection View以及檢視
powertrainConnections。從auxBattery的埠powerOut的控點拖曳到馬達的埠powerIn,然後選擇 Interface : HighVoltageBus。 - 選取新的線條,並在屬性面板中將其名稱輸入為
auxBus。然後開啟模型 → 編輯器,找到 Holarch 在Powertrain中寫入的那一行。
當 Powertrain 包含 interface engineControl : ControlLink … 以及來自檢視的 auxBus 介面,且編輯器下方的狀態回報沒有問題時,即完成。
常見問題
- 引擎有
port fuelIn : ~FuelPort;。波浪號改變了什麼? bind output = transmission.output;與interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;有什麼不同?- 當您從電池的
powerOut拖曳到馬達的powerIn時,為什麼檢視會提供 Interface : HighVoltageBus?
9.3 動作與流
觀看第 9.3 章(4:31)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
VehicleBehavior。 - 在
action def <'F.3'> DriveWheels下方新增action def <'F.4'> Refuel { in attribute fuelDemand : Real; out item fuel : Fuel; }。 - 開啟行為 → FFBD,按一下 + 新增圖,選擇
Refuel,然後按一下建立。在新增面板中輸入Open Filler Door並按 Enter,接著輸入Pump Fuel與Close Filler Door。 - 開啟模型 → 編輯器並找到
Refuel:FFBD 已寫入它的三個步驟以及步驟之間的 succession。 - 開啟行為 → Action Flow以及檢視
driveCycleFlow。找到包含brake的泳道,然後在DrivenCar中找到將它放在那裡的perform行。 - 開啟行為 → 功能分析,按一下選擇…並挑選
DriveCycle。確認其功能是依短名稱編號的。
當 Refuel 在編輯器中顯示其參數、三個步驟及其 succession,且您能說出哪個零件的泳道包含 brake 時,即完成。
常見問題
- 在
first start then split; fork split; then supply; then produce;中,哪些步驟平行執行?又是什麼讓它們重新匯合? first supply then ready;與flow of Fuel from supply.fuel to produce.fuel;有什麼不同?- Action Flow 檢視的泳道從哪裡來?
9.4 狀態與轉換
觀看第 9.4 章(3:51)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
VehicleBehavior。 - 在
attribute def Unplug;之後新增attribute def FaultDetected;。 - 在
state def PowertrainStates的右大括號之前,新增state limpHome { entry action warnDriver; do action driveLimited; }與transition limpStop first limpHome accept StopRequest then off;。 - 開啟行為 → 狀態機,按一下 + 新增圖,在顯示下選擇
PowertrainStates,然後按一下建立。 - 選取
electric,從其控點拖曳到limpHome;放在轉換上。在轉換面板中輸入名稱electricFault與觸發條件FaultDetected,然後按一下在文字中顯示。
當 PowertrainStates 包含 limpHome、limpStop 以及接受 FaultDetected 的轉換 electricFault,且編輯器下方的狀態回報沒有問題時,即完成。
常見問題
- 是什麼讓
off成為PowertrainStates的初始狀態? state off;之後是accept StartRequest if charge > 20 then electric;。請說出它的觸發條件、防護條件、來源與目標。- 狀態的 entry、do 與 exit 動作分別在什麼時候執行?
DrivenCar中的exhibit state powertrainStates : PowertrainStates;表達了什麼?
9.5 需求
觀看第 9.5 章(4:15)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
VehicleRequirements。 - 在
attribute minElectricRange之後新增attribute minTopSpeed : SpeedValue = 180 [km/h];。 - 在
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 }。 - 在其他
satisfy行之後新增satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;。 - 將
minTopSpeed改為220 [km/h]。將指標移到編輯器標在 satisfy 上的標記,閱讀它比較的數值,然後按 ⌘Z / Ctrl+Z。 - 開啟需要與需求 → 需求並找到 VR-8,然後開啟需要與需求 → 品質並按一下檢查品質。
當 VR-8 出現在需求表格中、satisfy 在 180 km/h 時沒有標記,且「檢查品質」已為其陳述評分時,即完成。
常見問題
- 為什麼要將
maxCurbMass之類的限制值保存為具名屬性,而不是在每個約束中寫入數字? - 在
requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }中,:>>做什麼? satisfy carSpec by fleet.sedan;讓 Holarch 能檢查什麼?- 您在需求頁面上設定需求的狀態與優先順序。SysML 文字會改變嗎?
9.6 驗證與可追溯性
觀看第 9.6 章(3:32)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
VehicleRequirements。 - 在
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; }。 - 開啟驗證 → 驗證案例。在新案例的列中按一下 + 步驟,接著按 + 新增步驟,在動作下輸入
Weigh the battery on a bench scale,按一下套用,然後在其狀態按鈕中按一下通過。 - 開啟驗證 → RVTM,找到 VR-6
batteryMassLimit以及新案例與其狀態。 - 開啟驗證 → 可追溯性矩陣,以需求作為列、類別 動作 作為欄,按一下
sedanAcceleration與accelerate交會的儲存格,然後選擇 satisfied by。 - 在套件末尾新增
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,且狀態回報沒有問題時,即完成。
常見問題
- 在
objective massObjective { verify carSpec.sedanMass; }中,verify表達了什麼?您在哪裡看到它? - 驗證案例的 verdict 與驗證案例頁面上的狀態有什麼不同?
- 什麼時候使用
satisfy,什麼時候使用Derivation? - 在可追溯性矩陣的儲存格中選擇 satisfied by 時,會發生什麼事?
9.7 約束與計算
觀看第 9.7 章(4:26)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
VehicleRequirements。 - 在
constraint def SpeedLimit之後新增constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }。 - 在圖頁面上按一下 + 新增圖,選擇參數檢視,並在顯示下選擇
VehicleRequirements,然後按一下建立。新的檢查會通過:48 kg 在 50 kg 以內。 - 在套件
Vehicles中,將轎車電池的質量改為52 [kg];檢視會顯示檢查失敗。按 ⌘Z / Ctrl+Z,然後按一下全部求解再次檢查每個約束。 - 在
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,找到該需求及其負責人。 - 開啟架構 → 預算和 TPM,按一下選擇根零件…並選擇
sedan。在數量下選擇質量,找到電池的 48 kg。
當 sedanBatteryCheck 在參數檢視中顯示 Pass,且 TBD/TBR 登錄表列出負責人為 Test lead 的 Acceleration 需求時,即完成。
常見問題
constraint def與calc def有什麼不同?- 參數檢視中的某個約束顯示「需要輸入」。缺少了什麼?
- 為什麼要以
#TBD或@TBD { … }標記待定數值,而不是把 TBD 寫成數值? - 分析案例為計算增加了什麼?
9.8 變體與組態
觀看第 9.8 章(3:42)
練習
在 Hybrid Car 示範專案(SysML v2)上:
- 開啟您的 Hybrid Car 示範專案(如有需要請建立:管理專案 → 專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)),開啟模型 → 編輯器以及套件
Vehicles。它已經匯入HolarchVariability。 - 在
part def CarLine中,於chargervariation 之後新增variation part rims : Wheel { variant part steelRims : Wheel; variant part alloyRims : Wheel { attribute :>> mass = 18 [kg]; } }。編輯器會註明三個組態尚未選擇rims。 - 在
wallboxNeedsLargePack之後新增規則assert constraint alloyNeedsLargePack { rims == rims::alloyRims implies pack == BatteryPack::largePack }。 - 開啟模型 → 瀏覽器並選取
selfChargingHybrid。在屬性面板的組態區段中,為 rims 選擇 steelRims;為plugInHybrid與longRangeHybrid選擇 alloyRims。然後在selfChargingHybrid上試試 alloyRims,閱讀判定結果,再按 ⌘Z / Ctrl+Z。 - 開啟
CarLine的列選單(⋯),選擇新增組態…。將它命名為cityHybrid,選擇 standardPack、noCharger 與 steelRims,確認判定結果為「有效」,然後按一下建立。 - 按一下頂端列中的檢視方式 ▾並選擇
cityHybrid,然後從圖清單中開啟檢視carLineVariants:它未選擇的變體會被隱藏。
當屬性面板中 CarLine 的「產品線」區段列出四個組態(全部為「有效」)以及規則 alloyNeedsLargePack 時,即完成。
常見問題
variation part def BatteryPack { … }與variation part charger : Component { … }有什麼不同?plugInHybrid選擇了BatteryPack::standardPack與charger::wallbox。會發生什麼事?為什麼?- 某個組態尚未為每個變化點選擇變體。它的判定結果是什麼?
metadata def <safetyCritical> SafetyCritical讓您能寫出什麼?其他 SysML v2 工具如何看待它?
解答
9.1 定義與屬性
:>使 Battery 成為 Component 的特化,因此它繼承 mass、partNumber 與 power。redefines以 Battery 自己的特徵取代繼承的mass,此處繫結為 45 kg。- 沒有任何東西單純是「元件」,只有各種元件。抽象定義收集每個元件共有的內容,只有其特化(例如 Battery 或 Engine)才描述實際的零件。
power的類型是PowerValue,而公斤是質量單位。檢查器會評估單位,因此會在數值下標上底線,直到單位改為功率單位,例如[W]。doc註解是屬於該元素的文件,是模型的一部分。//註記只留在文字中,不屬於模型。
9.2 埠與介面
- 它使埠共軛:引擎的埠具有與 FuelPort 相同的特徵,但方向相反,因此 FuelPort 的
out attribute flowRate會以輸入的形式抵達引擎。 - 繫結表示兩個特徵是同一個:動力系統的邊界埠就是變速箱的輸出。介面用法則連接兩個不同的埠,而其介面定義說明它的兩端接受哪些埠。
- Holarch 會提供兩端都符合這兩個埠的介面定義。HighVoltageBus 的兩端為
source : PowerPort與load : ~PowerPort,正好符合這兩個埠。
9.3 動作與流
- 在 fork
split之後,supply與produce以平行分支開始;fork 之後的每個then都會開始一個分支。joinready會等待兩者完成後才進入下一步。 - 前者是 succession:它依時間排定步驟的順序。後者是 flow:它將一個 Fuel 項從某個步驟的輸出參數傳到另一個步驟的輸入,本身並不排定步驟的順序。
- 來自
perform:每個執行某步驟的零件,例如part redefines tank { perform trip.supply; },都會得到一條包含其執行步驟的泳道。
9.4 狀態與轉換
entry; then off;:entry 之後接著一個到off的 succession,因此狀態機從那裡開始。檢視會將它畫成圓點。- 觸發條件:訊號 StartRequest。防護條件:
charge > 20。目標:electric。簡短形式從它所接續的狀態off開始。 - entry 動作在進入狀態時執行,do 動作在狀態作用期間執行,exit 動作則在離開狀態時執行。
- 表示汽車展現這個狀態機:汽車擁有一個 PowertrainStates 的用法,因此其狀態就是汽車的狀態。
9.5 需求
- 每個使用該名稱的需求都只需一次編輯就會跟著更新,而且限制值帶有單位,因此檢查器會以單位比較數值。
- 它重新定義 sedanMass 從 CurbMass 繼承的
limit屬性,為這個用法提供自己的數值。 - 轎車的數值是否符合 carSpec 的約束。如果轎車的整備質量超過限制,編輯器會標記 satisfy 並顯示比較的數值。
- 不會。狀態、優先順序與驗證方法是保存在模型旁的 Holarch 資料;它們永遠不會變更文字。
9.6 驗證與可追溯性
- 表示這個驗證案例驗證需求 sedanMass。RVTM 會將該案例列在該需求下。
- verdict 是模型的一部分:一個運算式,此處為整備質量是否在限制內。步驟、結果以及測試執行的狀態則是保存在模型旁的 Holarch 資料。
satisfy表示某個設計元素(例如零件或動作)滿足一個需求。Derivation 將原始需求連接到由它衍生的需求;它需要private import RequirementDerivation::*;。- Holarch 會將
satisfy寫入 SysML 文字,因此追溯成為模型的一部分,並顯示在編輯器中。
9.7 約束與計算
- 約束定義陳述一個針對其參數、成立與否的條件,例如
mass <= limit。計算定義則計算並回傳一個數值,例如return ratio = power / mass;。 - 某個參數還沒有數值。將每個參數繫結到一個數值,例如
in mass = fleet.sedan.curbMass;。 - 以
TBD取代數值並不是有效的 SysML。來自 HolarchHolarchMetadata套件的中繼資料能讓文字保持有效;TBD 與 TBR 特化了標準的StatusInfo中繼資料,因此其他 SysML v2 工具會將它們讀作狀態註記。 - 它將計算套用到一個主體(例如轎車)、回傳結果,並具有一個目標,其 require 約束由 Holarch 像其他約束一樣進行評估。
9.8 變體與組態
- 前者是 variation 定義,一組可重複使用的選擇:以它為類型的用法(例如
part pack : BatteryPack;)就是變化點。後者是 variation 用法,是在單一設計內宣告的變化點。 - 規則
wallboxNeedsLargePack被違反:它規定 wallbox 意味著大型電池組。判定結果會指出該規則,編輯器也會回報失敗的斷言。 - 不完整,並指出未決的變化點。在某個變化點尚未選擇時,針對它的規則既不算滿足,也不算違反。
- 短名稱會成為關鍵字,例如
#safetyCritical part controller : Controller;。它是一般的 metadata 用法,因此其他 SysML v2 工具會將它視為該零件上的中繼資料。
由 Holarch發布