Holarch
Capítulos del curso

Formación · Curso 9. Fundamentos de SysML v2 · Capítulo 9.2 de 8

9.2 Puertos e interfaces 3:44

Definir puertos e interfaces, conectar partes en texto y dibujar una interfaz en una vista.

Muestra Holarch 2.22.

← 9.1 Definiciones y atributos · Todos los capítulos · 9.3 Acciones y flujos →

Lo que aprenderá

  • Definir un puerto con atributos dirigidos y conjugarlo con `~`
  • Definir una interfaz cuyos extremos están tipados por puertos
  • Conectar partes con un uso de interfaz y enlazar un puerto de frontera con el puerto de una parte interna
  • Crear una Vista de interconexión y dibujar una interfaz entre dos puertos

Defina puertos e interfaces de SysML v2 en Holarch, siguiendo el tutorial de SysML v2 Ports and Interfaces en un pequeño proyecto Hybrid Car: una definición de puerto con sentidos, un puerto conjugado, una definición de interfaz con dos extremos, un tren motriz cuyas partes están conectadas por interfaces y un enlace, una Vista de interconexión del mismo y una interfaz dibujada en la vista que Holarch escribe en el texto. SysML es una marca registrada de Object Management Group, Inc.

Archivos de proyecto

  • Proyecto terminado (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)

El vídeo se reproduce desde holarch.app; consulte la Política de privacidad.

Práctica

Hágalo usted mismo en Holarch, en el proyecto de demostración Hybrid Car (SysML v2).

  1. Abra su proyecto de demostración Hybrid Car (créelo si hace falta: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2)), abra Modelo → Editor y el paquete Vehicles.
  2. Debajo de interface def HighVoltageBus, añada interface def ControlLink { end commander : ~ControlPort; end unit : ControlPort; }.
  3. En part def Powertrain, sustituya connect controller.engineCtl to engine.ecu; por interface engineControl : ControlLink connect controller.engineCtl to engine.ecu;, y añada part auxBattery : Battery; después de part battery : Battery;.
  4. Abra Arquitectura → Vistas de interconexión y la vista powertrainConnections. Arrastre desde el tirador del puerto powerOut de auxBattery hasta el puerto powerIn del motor y elija Interface : HighVoltageBus.
  5. Seleccione la nueva línea e introduzca auxBus como su Nombre en el inspector. Después abra Modelo → Editor y busque la línea que Holarch escribió en Powertrain.

Habrá terminado cuando Powertrain contenga interface engineControl : ControlLink … y la interfaz auxBus de la vista, y el estado bajo el editor no indique problemas.

Compruebe lo aprendido

  1. El motor tiene port fuelIn : ~FuelPort;. ¿Qué cambia la tilde?
  2. ¿Qué diferencia hay entre bind output = transmission.output; e interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;?
  3. ¿Por qué la vista ofrece Interface : HighVoltageBus al arrastrar desde el powerOut de una batería hasta el powerIn del motor?
Mostrar las respuestas
  1. El motor tiene port fuelIn : ~FuelPort;. ¿Qué cambia la tilde?

    Conjuga el puerto: el puerto del motor tiene las mismas características que FuelPort con los sentidos invertidos, de modo que el out attribute flowRate de FuelPort llega al motor como entrada.

  2. ¿Qué diferencia hay entre bind output = transmission.output; e interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;?

    Un enlace (binding) dice que las dos características son la misma: el puerto de frontera del tren motriz es la salida de la transmisión. Un uso de interfaz conecta dos puertos distintos, y su definición de interfaz indica qué puertos aceptan sus extremos.

  3. ¿Por qué la vista ofrece Interface : HighVoltageBus al arrastrar desde el powerOut de una batería hasta el powerIn del motor?

    Holarch ofrece las definiciones de interfaz cuyos extremos encajan con ambos puertos. HighVoltageBus tiene los extremos source : PowerPort y load : ~PowerPort, que corresponden a los dos puertos.

Más información

Transcripción

Mostrar la transcripción (narración y lo que aparece en pantalla)

Introduction

Chapter two: ports and interfaces. A port is where a part meets the world outside it. An interface says which ports may connect.

In this chapter you define a port and an interface, connect parts in a powertrain, and draw an interface in a view.

Start the tutorial

Start the tutorial Ports and Interfaces from Project Files, Start a Tutorial. Its starter project holds the car's components with their torque and power ports, two interface definitions, and nothing yet for fuel.

On screen: Project Files ▾ → Start a Tutorial… → SysML v2: Ports and Interfaces → Start.

Ports

Above the torque port, define the fuel port. A port definition lists what crosses the port. Out means the flow rate leaves the part that owns the port.

On screen: Below FuelKind; type port def FuelPort.

The tank owns a fuel port. The engine takes fuel in, so its port is conjugated with a tilde: the same features, with in and out reversed.

On screen: FuelTank: port fuelOut : FuelPort; Engine: port fuelIn : ~FuelPort;

Interfaces

An interface definition says which ports may connect. Below the high voltage bus, define the fuel line, with a supply end and a conjugated consumer end.

On screen: Below HighVoltageBus; type interface def FuelLine.

Connect the parts

Now the powertrain: a part definition made of parts. Its own output port is bound to the transmission's output, so the two are one and the same.

On screen: After Transmission; type part def Powertrain with five parts, a port and bind.

Connect the tank to the engine with a fuel line. A dotted name reaches into a part: from the tank's fuel out, to the engine's fuel in.

On screen: In Powertrain after part transmission: interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;

The engine and the motor both drive the transmission, through a shaft each.

On screen: Two shaft interfaces.

The status under the editor says the text is applied, with no problems.

On screen: Applied, No problems.

The Interconnection View

Now see the powertrain as a view. Open Architecture, then Interconnection Views, and click New Diagram. Keep Interconnection View, choose the powertrain under Shows, and click Create.

On screen: Architecture → Interconnection Views → + New Diagram; Shows: Vehicles::Powertrain; Create.

The parts sit inside the frame with their ports on their sides. Each line is an interface from the text, and the output port on the frame is bound to the transmission.

On screen: The view.

Draw an interface

The battery does not feed the motor yet. Drag from the battery's power out port to the motor's power in. Holarch offers what fits both ports: choose Interface, High Voltage Bus.

On screen: Select battery.powerOut; drag its handle to motor.powerIn → Interface : HighVoltageBus.

Select the new line, and name it H V Bus in the inspector.

On screen: Click the new line; inspector Name: hvBus.

Close the inspector and open the text again. Holarch wrote the interface into the powertrain, with its name, its type and both ends.

On screen: Inspector ×; Model → Editor: the interface hvBus line in Powertrain.

Recap

Every step is ticked off. Click Mark as Done.

On screen: Step panel → Mark as Done.

Let's recap. You defined a port with a direction, conjugated it for the engine, defined an interface with two ends, connected the powertrain's parts in text, and drew an interface that Holarch wrote back into the text.

Next, actions and flows describe what the car does.