setInterface

R2026b

ポートのインターフェイスを設定する

構文

setInterface(port,interface)

説明

setInterface(port,interface) は、ポートのインターフェイスを設定します。

例

ポートのインターフェイスの設定およびポートのインターフェイスの削除

モデルを作成し、ルート アーキテクチャを取得します。

model = systemcomposer.createModel("archModel");
systemcomposer.openModel("archModel");
rootArch = get(model,"Architecture");

コンポーネントを追加し、そのコンポーネントにポートを追加します。

newComponent = addComponent(rootArch,"newComponent");
newPort = addPort(newComponent.Architecture,"newPort","in");

データ インターフェイスを追加し、ポートのインターフェイスを設定します。

newInterface = addInterface(model.InterfaceDictionary,"newInterface");
setInterface(newPort,newInterface)

ポートのデータ インターフェイスを削除します。

newPort.setInterface("")

入力引数

port — ポート

ポート オブジェクト

ポート。systemcomposer.arch.ArchitecturePort オブジェクトまたは systemcomposer.arch.ComponentPort オブジェクトとして指定します。

interface — インターフェイス

データ インターフェイス オブジェクト | 値タイプ オブジェクト | 物理インターフェイス オブジェクト | サービス インターフェイス オブジェクト | 空の string | 空の文字ベクトル

設定するインターフェイス。systemcomposer.interface.DataInterface オブジェクト、systemcomposer.ValueType オブジェクト、systemcomposer.interface.PhysicalInterface オブジェクト、または systemcomposer.interface.ServiceInterface オブジェクトとして指定します。空の string または文字ベクトルを渡すと、ポートのインターフェイスが削除されます。

詳細

定義

用語	定義	アプリケーション	詳細
アーキテクチャ	System Composer™ の "アーキテクチャ" は、コンポーネントのシステムとそれらの構造および動作の相互インターフェイスを表します。	アーキテクチャのタイプごとに、記述されるシステムの側面がそれぞれ異なります。ビューを使用してアーキテクチャ内のコンポーネントのサブセットを可視化できます。アーキテクチャ レベルのパラメーターはパラメーター エディターを使用して定義できます。	Compose Architectures Visually Author Parameters in System Composer Using Parameter Editor
ルート	"ルート" は、アーキテクチャ階層の最上位にあたります。ルート アーキテクチャの境界は、対象のシステムを囲むアーキテクチャ ポートで定義されます。	ルート アーキテクチャは、アーキテクチャ モデルの周囲をシステムの境界とします。境界をまたぐインターフェイスを定義するアーキテクチャ ポートを追加できます。	Compose Architectures Visually
モデル	System Composer の "モデル" は、コンポーネント、ポート、コネクタ、インターフェイス、動作などのアーキテクチャ情報を含むファイルです。	モデルでは、ルートレベルのアーキテクチャの抽出、プロファイルの適用、インターフェイス データ ディクショナリのリンク、モデル アーキテクチャからのインスタンスの生成などの操作を実行します。System Composer のモデルは SLX ファイルとして保存されます。	インターフェイスと要件リンクを使用したアーキテクチャ モデルの作成
コンポーネント	"コンポーネント" は、アーキテクチャのコンテキストにおいて明確な機能を果たす、システムの交換可能部分です。コンポーネントは、機能、別のシステム、ハードウェア、ソフトウェア、その他の概念項目などのアーキテクチャ要素を定義します。コンポーネントは、サブシステムまたはサブ機能になる場合もあります。	ブロックとして表されるコンポーネントは、再利用可能なアーティファクトに分割可能なアーキテクチャ モデルの一部です。コンポーネント間で情報を転送するには、ポート インターフェイスとパラメーターを使用します。ポート インターフェイスとパラメーターは、インターフェイス エディターおよびパラメーター エディターを使用して構成できます。	Compose Architectures Visually Component
ポート	"ポート" は、その環境との相互作用点を表すコンポーネントまたはアーキテクチャ上のノードです。ポートにより、他のコンポーネントまたはシステムと情報をやりとりできるようになります。	"コンポーネント ポート" は、他のコンポーネントに対するコンポーネント上の相互作用点です。"アーキテクチャ ポート" はシステムの境界上のポートで、境界はコンポーネント内にある場合と、アーキテクチャ モデル全体の場合があります。ルート アーキテクチャの境界は、そのポートで定義されます。	Compose Architectures Visually Port
コネクタ	"コネクタ" はポート間の接続を提供するラインです。コネクタは、コンポーネントまたはアーキテクチャ間の情報の流れを表します。	コネクタにより、2 つのコンポーネントは相互作用の性質を定義することなく相互作用できます。ポートにインターフェイスを設定してコンポーネントの相互作用を定義します。	Compose Architectures Visually

用語	定義	アプリケーション	詳細
データ ディクショナリ	"データ ディクショナリ" は、モデルに関連するデータのリポジトリです。データ ディクショナリの [Architectural Data] セクションに、ポート インターフェイス、データ型、システム全体の定数など、Simulink® とアーキテクチャ モデルのインターフェイスで使用される共有定義が保存されます。詳細については、データ ディクショナリとはを参照してください。	System Composer モデルのローカル インターフェイスは、インターフェイス エディターを使用して Simulink データ ディクショナリの [Architectural Data] セクションに保存できます。インターフェイスおよび値のタイプの管理と変更は、インターフェイス エディターに加え、アーキテクチャ データ エディターを使用して行うこともできます。	データ ディクショナリによるインターフェイスの管理 Reference Data Dictionaries Store Shared Data in Architectural Data Section
データ インターフェイス	"データ インターフェイス" は、ポートを流れる情報の種類を定義します。同じインターフェイスを複数のポートに割り当てることができます。データ インターフェイスは複合にできます。つまり、インターフェイス信号のプロパティを表すデータ要素を含めることができます。	データ インターフェイスはコネクタを通じて共有される情報を表し、ポートを通じてコンポーネントに出入りします。データ インターフェイスとデータ要素を作成および管理し、それらをデータ ディクショナリに保存してモデル間で再利用するには、インターフェイス エディターを使用します。	インターフェイスと要件リンクを使用したアーキテクチャ モデルの作成 コンポーネント間のポート インターフェイスの定義
データ要素	"データ要素" は、インターフェイスの各部分を記述したものです。通信メッセージ、計算または測定されるパラメーター、そのインターフェイスの他の分解要素などがあります。	データ インターフェイスは、コネクタまたはハーネスのピンやワイヤー、バスで送信されるメッセージ、コンポーネント間で共有されるデータ構造を表すことができるデータ要素に分解されます。	Create Interfaces Assign Interfaces to Ports
ポート要素	"ポート要素" は、複合インターフェイスまたは所有インターフェイスで型指定されたポートで使用できるインターフェイス要素を表します。	ポート要素を使用すると、ルートレベルのポートに接続されたシェブロンでポート名を選択することでポートの要素にアクセスできます。インターフェイス要素が複合インターフェイスで型指定されている場合、入れ子のポート要素は 2 レベルの階層をもちます。	Transmit Signal Data Between Components Linked to Behavior Models Assign Interfaces to Ports
値のタイプ	"値のタイプ" は、ポートのインターフェイスとして、そのポートを流れるデータのアトミックな部分を定義するために使用できます。最上位の型、次元、単位、実数/複素数、最小値、最大値、および説明があります。	値のタイプにデータ インターフェイスのデータ要素のタイプを割り当てることもできます。インターフェイス エディターを使用して値のタイプをデータ ディクショナリに追加し、値のタイプをインターフェイスまたはデータ要素として再利用できるようにします。	Create Value Types as Interfaces
所有インターフェイス	"所有インターフェイス" は、特定のポートに対してローカルであり、データ ディクショナリやモデル ディクショナリで共有されないインターフェイスです。	所有インターフェイスは、ポートに対してローカルな値のタイプやデータ インターフェイスを表すために作成します。	Define Owned Interfaces Local to Ports
アダプター	"アダプター" は、ポートのインターフェイスに互換性がない 2 つのコンポーネントを 2 つのインターフェイス間のマッピングを行うことで接続します。アダプターは単位遅延、レート変換、またはマージとして機能します。バスの作成にもアダプターを使用できます。アダプターは Adapter ブロックを使用して実装します。	アダプターを使用して、Interface Adapterダイアログ ボックスで入力インターフェイスと出力インターフェイスの間のマッピングの作成と編集が可能です。インターフェイス変換 UnitDelay を適用して代数ループを回避したり、インターフェイス変換 RateTransition を適用して参照モデルの異なるサンプル時間レートを調整したり、インターフェイス変換 Merge を適用して 2 つ以上のメッセージまたは信号の線をマージしたりできます。出力インターフェイスが未定義の場合は、バス作成モードで入力インターフェイスを使用して所有出力インターフェイスを作成できます。	Interface Adapter Adapter

バージョン履歴

R2019a で導入

参考

関数

• addInterface | moveInterface | addPhysicalInterface | removeInterface | createInterface | setName | getInterface | getInterfaceNames | addElement | removeElement | getElement | getSubElement | getPortElement | getConnectorTo | setName | setType | createOwnedType | getSourceElement | getDestinationElement | systemcomposer.createDictionary | systemcomposer.openDictionary | saveToDictionary | isOpen | getFileName | linkDictionary | unlinkDictionary | addReference | removeReference | getReferencedDictionaries | makeOwnedInterfaceShared | addValueType | createInterface | setName | setDataType | setDimensions | setUnits | setComplexity | setMinimum | setMaximum | setDescription | addServiceInterface | setFunctionPrototype | getFunctionArgument | setAsynchronous | setServerResponseNotRequired | systemcomposer.getSelectedInterfaces | IsAdapterComponent

オブジェクト

• systemcomposer.arch.PortElement | systemcomposer.ValueType | systemcomposer.interface.DataInterface | systemcomposer.interface.DataElement | systemcomposer.interface.PhysicalDomain | systemcomposer.interface.PhysicalInterface | systemcomposer.interface.PhysicalElement | systemcomposer.interface.Dictionary | systemcomposer.interface.ServiceInterface | systemcomposer.interface.FunctionArgument | systemcomposer.interface.FunctionElement | addServiceInterface | setFunctionPrototype | getFunctionArgument | setAsynchronous | setServerResponseNotRequired

ブロック

• Adapter | Component | Reference Component | Variant Component

ツール

• 型エディター | インターフェイス エディター

トピック

• System Composer API の概要
• コンポーネント間のポート インターフェイスの定義
• Service Interfaces Overview
• Client-Server Interfaces in Class Diagram View
• Specify Physical Interfaces on Ports