Holarch

Formazione · Percorso 9. Fondamenti di SysML v2

Percorso 9. Fondamenti di SysML v2: scheda di esercizi

Per studenti e ingegneri che si avvicinano a SysML v2. Un’esercitazione e alcune domande per ogni capitolo, da svolgere dopo ogni video. Stampare questa pagina dal browser, oppure lavorare a schermo. Le soluzioni iniziano su una nuova pagina alla fine.

Prima di iniziare

Da seguire prima
Il tutorial integrato nell’app SysML v2: Getting Started (Guida → Tutorial).
Piano
Free
Progetto
I progetti iniziali dei tutorial SysML v2 integrati nell’app; esercitarsi sulla demo Hybrid Car.

9.1 Definitions and Attributes

Guarda il capitolo 9.1 (4:33)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Creare la demo Hybrid Car: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2). Aprire Modello → Editor e il package Vehicles.
  2. Sotto enum def FuelKind, aggiungere enum def CoolingMode { enum passive; enum active; }.
  3. Sotto part def Body, scegliere Inserisci ▾ → Definizione di part e completare part def Radiator :> Component con attribute redefines mass = 8 [kg];, attribute coolantVolume : VolumeValue; (digitare Volu e accettare VolumeValue dall’elenco di completamento con Invio) e attribute mode : CoolingMode;.
  4. Cambiare la massa in 8 [W], puntare sulla sottolineatura per leggere il messaggio, poi riportarla a 8 [kg].
  5. In part def Powertrain, aggiungere part radiator : Radiator;. Poi posizionare il cursore su coolantVolume, premere F2 e rinominarlo in coolantCapacity.
  6. Per un percorso guidato con verifica, eseguire il tutorial SysML v2 Definitions and Attributes (Guida → Tutorial).

L’esercizio è completato quando lo stato sotto l’editor non segnala problemi e il Browser mostra Radiator sotto Vehicles con coolantCapacity e mode.

Domande

  1. In part def Battery :> Component { attribute redefines mass = 45 [kg]; }, che cosa fanno rispettivamente :> e redefines?
  2. Perché Component è dichiarato abstract part def?
  3. Perché attribute redefines power = 60 [kg]; dà un errore?
  4. Qual è la differenza tra doc /* … */ e una riga //?

9.2 Ports and Interfaces

Guarda il capitolo 9.2 (3:44)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package Vehicles.
  2. Sotto interface def HighVoltageBus, aggiungere interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }.
  3. In part def Powertrain, sostituire connect controller.engineCtl to engine.ecu; con interface engineControl : ControlLink connect controller.engineCtl to engine.ecu; e aggiungere part auxBattery : Battery; dopo part battery : Battery;.
  4. Aprire Architettura → Viste di interconnessione e la vista powertrainConnections. Trascinare dalla maniglia della porta powerOut di auxBattery alla porta powerIn del motore e scegliere Interface : HighVoltageBus.
  5. Selezionare la nuova linea e inserire auxBus come Nome nell’ispettore. Poi aprire Modello → Editor e trovare la riga che Holarch ha scritto in Powertrain.

L’esercizio è completato quando Powertrain contiene interface engineControl : ControlLink … e l’interfaccia auxBus creata dalla vista, e lo stato sotto l’editor non segnala problemi.

Domande

  1. Il motore ha port fuelIn : ~FuelPort;. Che cosa cambia la tilde?
  2. Qual è la differenza tra bind output = transmission.output; e interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;?
  3. Perché la vista propone Interface : HighVoltageBus quando si trascina dalla powerOut di una batteria alla powerIn del motore?

9.3 Actions and Flows

Guarda il capitolo 9.3 (4:31)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package VehicleBehavior.
  2. Sotto action def <'F.3'> DriveWheels, aggiungere action def <'F.4'> Refuel { in attribute fuelDemand : Real; out item fuel : Fuel; }.
  3. Aprire Comportamento → FFBD, fare clic su + Nuovo diagramma, scegliere Refuel e fare clic su Crea. Nel pannello Aggiungi, digitare Open Filler Door e premere Invio, poi Pump Fuel e Close Filler Door.
  4. Aprire Modello → Editor e trovare Refuel: il FFBD ha scritto i suoi tre passi e le successioni tra di essi.
  5. Aprire Comportamento → Flussi di action e la vista driveCycleFlow. Trovare la corsia che contiene brake, poi trovare la riga perform in DrivenCar che lo colloca lì.
  6. Aprire Comportamento → Analisi funzionale, fare clic su Scegli… e selezionare DriveCycle. Verificare che le sue funzioni siano numerate in base ai loro nomi brevi.

L’esercizio è completato quando Refuel mostra nell’Editor i suoi parametri, tre passi e le relative successioni, e si sa indicare la part la cui corsia contiene brake.

Domande

  1. In first start then split; fork split; then supply; then produce;, quali passi vengono eseguiti in parallelo e che cosa li riunisce?
  2. Qual è la differenza tra first supply then ready; e flow of Fuel from supply.fuel to produce.fuel;?
  3. Da dove provengono le corsie di una Action Flow View?

9.4 States and Transitions

Guarda il capitolo 9.4 (3:51)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package VehicleBehavior.
  2. Dopo attribute def Unplug;, aggiungere attribute def FaultDetected;.
  3. Prima della parentesi graffa di chiusura di state def PowertrainStates, aggiungere state limpHome { entry action warnDriver; do action driveLimited; } e transition limpStop first limpHome accept StopRequest then off;.
  4. Aprire Comportamento → Macchine a stati, fare clic su + Nuovo diagramma, scegliere PowertrainStates in Mostra e fare clic su Crea.
  5. Selezionare electric e trascinare dalla sua maniglia a limpHome; rilasciare su Transizione. Nel pannello della transizione, inserire il Nome electricFault e il Trigger FaultDetected, poi fare clic su Mostra nel testo.

L’esercizio è completato quando PowertrainStates contiene limpHome, limpStop e la transizione electricFault che accetta FaultDetected, e lo stato sotto l’editor non segnala problemi.

Domande

  1. Che cosa rende off lo stato iniziale di PowertrainStates?
  2. Dopo state off; viene accept StartRequest if charge > 20 then electric;. Indicarne trigger, guardia, sorgente e destinazione.
  3. Quando vengono eseguite le azioni entry, do ed exit di uno stato?
  4. Che cosa dice exhibit state powertrainStates : PowertrainStates; in DrivenCar?

9.5 Requirements

Guarda il capitolo 9.5 (4:15)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package VehicleRequirements.
  2. Dopo attribute minElectricRange, aggiungere attribute minTopSpeed : SpeedValue = 180 [km/h];.
  3. Sotto requirement def <'VR-5'> ChargeTime, scegliere Inserisci ▾ → Definizione di requisito e scrivere <'VR-8'> TopSpeed con l’enunciato The sports car shall reach at least the minimum top speed., il soggetto car : SportCar e require constraint { car.topSpeed >= minTopSpeed }.
  4. Dopo le altre righe satisfy, aggiungere satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;.
  5. Cambiare minTopSpeed in 220 [km/h]. Puntare sul segno che l’Editor mette sul satisfy per leggere i valori confrontati, poi premere ⌘Z / Ctrl+Z.
  6. Aprire Esigenze e requisiti → Requisiti e trovare VR-8, poi aprire Esigenze e requisiti → Qualità e fare clic su Controlla la qualità.

L’esercizio è completato quando VR-8 compare nella tabella Requisiti, il satisfy non ha alcun segno a 180 km/h e Controlla la qualità ha assegnato un punteggio al suo enunciato.

Domande

  1. Perché tenere limiti come maxCurbMass come attributi con nome invece di scrivere il numero in ogni constraint?
  2. In requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }, che cosa fa :>>?
  3. Che cosa permette di verificare a Holarch satisfy carSpec by fleet.sedan;?
  4. Lo Stato e la Priorità di un requisito si impostano nella pagina Requisiti. Il testo SysML cambia?

9.6 Verification and Traceability

Guarda il capitolo 9.6 (3:32)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package VehicleRequirements.
  2. Dopo verification <'VC-1.1'> sedanWeighing, aggiungere verification def <'VC-2'> BatteryWeighing { subject battery : Battery; objective { verify batteryMassLimit; } return verdict : Boolean = battery.mass <= 50 [kg]; } e verification <'VC-2.1'> sedanBatteryWeighing : BatteryWeighing { subject battery = fleet.sedan.powertrain.battery; }.
  3. Aprire Verifica → Casi di verifica. Nella riga del nuovo caso, fare clic su + Passi, poi su + Aggiungi passo, digitare Weigh the battery on a bench scale in Azione, fare clic su Applica e fare clic su Superati tra i pulsanti di stato.
  4. Aprire Verifica → RVTM e trovare VR-6 batteryMassLimit con il nuovo caso e il suo stato.
  5. Aprire Verifica → Matrice di tracciabilità, mostrare i requisiti come righe e la classe Azione come colonne, fare clic sulla cella in cui sedanAcceleration incontra accelerate e scegliere satisfied by.
  6. Alla fine del package, aggiungere requirement <'VR-9'> tankVolume { doc /* The fuel tank shall hold at least 40 L. */ subject tank : FuelTank; } e connection tankDerivation : Derivation connect carSpec.sedanRange to tankVolume;. Poi aprire Verifica → Controlli del modello.

L’esercizio è completato quando la RVTM elenca il nuovo caso rispetto a VR-6 come superato, l’Editor contiene il nuovo satisfy e tankDerivation, e lo stato non segnala problemi.

Domande

  1. In objective massObjective { verify carSpec.sedanMass; }, che cosa dice verify e dove lo si vede?
  2. Qual è la differenza tra il verdetto di un caso di verifica e lo stato nella pagina Casi di verifica?
  3. Quando si usa satisfy e quando una Derivation?
  4. Che cosa succede quando si sceglie satisfied by in una cella della Matrice di tracciabilità?

9.7 Constraints and Calculations

Guarda il capitolo 9.7 (4:26)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package VehicleRequirements.
  2. Dopo constraint def SpeedLimit, aggiungere constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }.
  3. Nella pagina Diagrammi, fare clic su + Nuovo diagramma, scegliere Vista parametrica e VehicleRequirements in Mostra, e fare clic su Crea. La nuova verifica è superata: 48 kg rientrano nei 50 kg.
  4. Nel package Vehicles, cambiare la massa della batteria della berlina in 52 [kg]; la vista mostra la verifica fallita. Premere ⌘Z / Ctrl+Z, poi fare clic su Risolvi tutto per verificare di nuovo tutti i constraint.
  5. In requirement def <'VR-2'> Acceleration, sostituire attribute zeroToHundred : TimeValue; con attribute zeroToHundred : TimeValue { @TBD { owner = "Test lead"; rationale = "The test track is not booked yet."; } }. Aprire Esigenze e requisiti → TBD/TBR e trovare il requisito con il suo responsabile.
  6. Aprire Architettura → Budget e TPM, fare clic su Seleziona parte radice… e scegliere sedan. In Grandezza, scegliere Massa e trovare i 48 kg della batteria.

L’esercizio è completato quando sedanBatteryCheck mostra Superato nella Vista parametrica e il registro TBD/TBR elenca il requisito Acceleration con il responsabile Test lead.

Domande

  1. Qual è la differenza tra un constraint def e un calc def?
  2. Un constraint nella Vista parametrica mostra Richiede input. Che cosa manca?
  3. Perché contrassegnare un valore aperto con #TBD o @TBD { … } invece di scrivere TBD come valore?
  4. Che cosa aggiunge un analysis case a un calcolo?

9.8 Variants and Configurations

Guarda il capitolo 9.8 (3:42)

Esercitazione

Sul progetto demo Hybrid Car (SysML v2):

  1. Aprire il progetto demo Hybrid Car (crearlo se necessario: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2)), aprire Modello → Editor e il package Vehicles. Importa già HolarchVariability.
  2. In part def CarLine, dopo la variation charger, aggiungere variation part rims : Wheel { variant part steelRims : Wheel; variant part alloyRims : Wheel { attribute :>> mass = 18 [kg]; } }. L’Editor segnala che le tre configurazioni non hanno ancora scelto rims.
  3. Dopo wallboxNeedsLargePack, aggiungere la regola assert constraint alloyNeedsLargePack { rims == rims::alloyRims implies pack == BatteryPack::largePack }.
  4. Aprire Modello → Browser e selezionare selfChargingHybrid. Nella sezione Configurazione dell’ispettore, scegliere steelRims per rims; scegliere alloyRims per plugInHybrid e longRangeHybrid. Poi provare alloyRims su selfChargingHybrid, leggere il verdetto e premere ⌘Z / Ctrl+Z.
  5. Aprire il menu della riga (⋯) di CarLine e scegliere Nuova configurazione…. Chiamarla cityHybrid, scegliere standardPack, noCharger e steelRims, verificare che il verdetto sia Valida e fare clic su Crea.
  6. Fare clic su Visualizza come ▾ nella barra superiore e scegliere cityHybrid, poi aprire la vista carLineVariants dall’elenco Diagrammi: le varianti che non sceglie sono nascoste.

L’esercizio è completato quando la sezione Linea di prodotti dell’ispettore per CarLine elenca quattro configurazioni, tutte Valide, e la regola alloyNeedsLargePack.

Domande

  1. Qual è la differenza tra variation part def BatteryPack { … } e variation part charger : Component { … }?
  2. plugInHybrid sceglie BatteryPack::standardPack e charger::wallbox. Che cosa succede e perché?
  3. Una configurazione non ha ancora scelto una variante per ogni punto. Qual è il suo verdetto?
  4. Che cosa permette di scrivere metadata def <safetyCritical> SafetyCritical, e come lo vedono gli altri strumenti SysML v2?

Soluzioni

9.1 Definitions and Attributes

  1. :> rende Battery una specializzazione di Component, quindi eredita mass, partNumber e power. redefines sostituisce in Battery la mass ereditata con una feature propria, qui legata a 45 kg.
  2. Nulla è un componente in quanto tale, esistono solo tipi di componenti. Una definizione astratta raccoglie ciò che tutti i componenti hanno in comune, e solo le sue specializzazioni, come Battery o Engine, descrivono parti reali.
  3. power è di tipo PowerValue, e i chilogrammi sono un’unità di massa. Il controllo valuta le unità, quindi sottolinea il valore finché l’unità non è un’unità di potenza come [W].
  4. Un commento doc è documentazione che appartiene all’elemento e fa parte del modello. Una nota // resta solo nel testo e non fa parte del modello.

9.2 Ports and Interfaces

  1. Coniuga la porta: la porta del motore ha le stesse feature di FuelPort con le direzioni invertite, quindi l’out attribute flowRate di FuelPort arriva al motore come input.
  2. Un binding dice che le due feature sono la stessa: la porta di confine del gruppo motopropulsore è l’uscita della trasmissione. Un uso di interfaccia collega due porte diverse, e la sua definizione di interfaccia dice quali porte accettano le sue estremità.
  3. Holarch propone le definizioni di interfaccia le cui estremità si adattano a entrambe le porte. HighVoltageBus ha le estremità source : PowerPort e load : ~PowerPort, che corrispondono alle due porte.

9.3 Actions and Flows

  1. Dopo il fork split, supply e produce partono come rami paralleli; ogni then dopo un fork avvia un ramo. Il join ready attende entrambi prima del passo successivo.
  2. Il primo è una successione: ordina i passi nel tempo. Il secondo è un flusso: porta un item Fuel dal parametro di output di un passo all’input di un altro passo e da solo non ordina i passi.
  3. Da perform: ogni part che esegue un passo, come part redefines tank { perform trip.supply; }, riceve una corsia con i passi che esegue.

9.4 States and Transitions

  1. entry; then off;: l’entry è seguita da una successione verso off, quindi la macchina a stati parte da lì. La vista lo disegna come il punto.
  2. Trigger: il segnale StartRequest. Guardia: charge > 20. Destinazione: electric. La forma breve parte dallo stato che segue, off.
  3. L’azione entry viene eseguita quando si entra nello stato, l’azione do mentre lo stato è attivo e l’azione exit quando si esce dallo stato.
  4. Che l’auto presenta questa macchina a stati: l’auto possiede un uso di PowertrainStates, quindi i suoi stati sono gli stati dell’auto.

9.5 Requirements

  1. Ogni requisito che usa il nome segue un’unica modifica, e il limite porta con sé la sua unità, quindi il controllo confronta valori con unità.
  2. Ridefinisce l’attributo limit che sedanMass eredita da CurbMass, dando a questo uso un valore proprio.
  3. Se i valori della berlina rispettano i constraint di carSpec. Se la massa a vuoto della berlina supera il limite, l’Editor contrassegna il satisfy e mostra i valori confrontati.
  4. No. Stato, priorità e metodo di verifica sono dati di Holarch tenuti accanto al modello; non modificano mai il testo.

9.6 Verification and Traceability

  1. Che questo caso di verifica verifica il requisito sedanMass. La RVTM elenca il caso rispetto a quel requisito.
  2. Il verdetto fa parte del modello: un’espressione, qui se la massa a vuoto rientra nel limite. Passi, risultati e lo stato di un’esecuzione di test sono dati di Holarch tenuti accanto al modello.
  3. satisfy dice che un elemento di progetto, come una part o una action, soddisfa un requisito. Una Derivation collega un requisito originale a un requisito derivato da esso; richiede private import RequirementDerivation::*;.
  4. Holarch scrive un satisfy nel testo SysML, quindi la traccia fa parte del modello e compare nell’Editor.

9.7 Constraints and Calculations

  1. Una definizione di constraint esprime sui suoi parametri una condizione che è vera o falsa, come mass <= limit. Una definizione di calcolo calcola e restituisce un valore, come return ratio = power / mass;.
  2. Un parametro non ha ancora un valore. Legare ogni parametro a un valore, ad esempio in mass = fleet.sedan.curbMass;.
  3. TBD al posto di un valore non è SysML valido. I metadati del package HolarchMetadata di Holarch mantengono il testo valido; TBD e TBR specializzano i metadati standard StatusInfo, quindi gli altri strumenti SysML v2 li leggono come annotazioni di stato.
  4. Applica il calcolo a un soggetto, come la berlina, restituisce il risultato e ha un obiettivo il cui require constraint Holarch valuta come qualsiasi altro constraint.

9.8 Variants and Configurations

  1. La prima è una definizione di variation, un insieme riutilizzabile di scelte: un uso tipizzato da essa, come part pack : BatteryPack;, è un punto di variazione. La seconda è un uso di variation, un punto dichiarato all’interno di un unico progetto.
  2. La regola wallboxNeedsLargePack è violata: dice che il wallbox implica il pacco grande. Il verdetto nomina la regola e l’Editor segnala l’asserzione non riuscita.
  3. Incompleta, con l’indicazione del punto aperto. Finché un punto non ha una scelta, una regola su di esso non è né soddisfatta né violata.
  4. Il nome breve diventa una parola chiave, come in #safetyCritical part controller : Controller;. È un normale uso di metadati, quindi gli altri strumenti SysML v2 lo vedono come metadati sulla part.

Pubblicato da Holarch