Главы курса
Обучение · Курс 9. Основы SysML v2 · Глава 9.2 из 8
9.2 Порты и интерфейсы 3:44
Определите порты и интерфейсы, соедините части в тексте и нарисуйте интерфейс в представлении.
Показан Holarch 2.22.
Чему вы научитесь
- Определять порт с направленными атрибутами и сопрягать его с помощью `~`
- Определять интерфейс, концы которого типизированы портами
- Соединять части использованием интерфейса и связывать граничный порт с портом внутренней части
- Создавать представление Interconnection и рисовать интерфейс между двумя портами
Определите порты и интерфейсы SysML v2 в Holarch по учебному материалу SysML v2 «Ports and Interfaces» на небольшом проекте Hybrid Car: определение порта с направлениями, сопряжённый порт, определение интерфейса с двумя концами, силовая установка, части которой соединены интерфейсами и связыванием, её представление Interconnection и интерфейс, нарисованный в представлении, который Holarch записывает в текст. SysML является зарегистрированным товарным знаком Object Management Group, Inc.
Файлы проектов
- Готовый проект (.holarch.json; Управление проектами → Файлы проекта ▾ → Импортировать проект (.json)…)
Видео воспроизводится с holarch.app; см. Политику конфиденциальности.
Практика
Выполните это сами в Holarch на демо-проекте 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 auxBattery : Battery;послеpart battery : Battery;. - Откройте Архитектура → Представления Interconnection и представление
powertrainConnections. Перетащите от маркера портаpowerOutчастиauxBatteryк порту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;? - Почему представление предлагает Interface : HighVoltageBus, когда вы перетаскиваете от
powerOutбатареи кpowerInдвигателя?
Показать ответы
У двигателя есть
port fuelIn : ~FuelPort;. Что меняет тильда?Она сопрягает порт: у порта двигателя те же свойства, что у FuelPort, но с обратными направлениями, поэтому
out attribute flowRateиз FuelPort приходит в двигатель как вход.Чем отличаются
bind output = transmission.output;иinterface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;?Связывание (binding) говорит, что два свойства — одно и то же: граничный порт силовой установки — это выход трансмиссии. Использование интерфейса соединяет два разных порта, а его определение интерфейса говорит, какие порты принимают его концы.
Почему представление предлагает Interface : HighVoltageBus, когда вы перетаскиваете от
powerOutбатареи кpowerInдвигателя?Holarch предлагает определения интерфейсов, концы которых подходят к обоим портам. У HighVoltageBus концы
source : PowerPortиload : ~PowerPort, которые соответствуют двум портам.
Подробнее
- Учебный материал: Ports and Interfaces (учебные материалы SysML v2)
- Docs: Текстовая нотация SysML v2, порты, соединения, интерфейсы, связывания и потоки
- Docs: Представления SysML v2, представление Interconnection
- Справка: Текст и представления остаются согласованными
- Справка: Интерфейсы, ICD и диаграммы N²
Расшифровка
Показать расшифровку (дикторский текст и то, что на экране)
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.