Main Content

Simulink.Bus

バスのプロパティを指定

このページをすべて展開する

説明

Simulink.Bus オブジェクトは、Simulink.BusElement オブジェクトと共に使用するときに、バスのプロパティを特定および検証するデータ型です。モデルをシミュレーションまたは更新するときに、Simulink® は、ブロックに接続されたバスがブロックで指定された Simulink.Bus オブジェクトのデータ型に一致するかどうかをチェックします。

Bus オブジェクトは、バスのアーキテクチャのプロパティのみ指定します。たとえば、バス オブジェクトで要素名、階層、順序、データ型を指定できます。Bus オブジェクトはバス内の信号の値を指定できません。

Bus オブジェクトは、C における構造体の定義に似ています。つまり、バス オブジェクトは、バスのメンバーを定義しますが、バスは作成しません。Bus オブジェクトはケーブル コネクタにも似ています。コネクタはすべてのピンとそれらの構成を定義し、接続可能なワイヤのタイプを制御します。同様に、Bus オブジェクトは関連付けられたバスに必要な信号の構成とプロパティを定義します。

Bus オブジェクトには Simulink.BusElement オブジェクトが含まれています。各 BusElement オブジェクトは、名前、データ型、次元など、バス内の 1 つの信号のプロパティを指定します。Bus オブジェクト内の BusElement オブジェクトの順序により、バス内の信号の順序が決まります。

Bus オブジェクトは、構成要素の信号によって定義されずに、継承に依存するプロパティを指定できます。

Bus オブジェクトをベース ワークスペースまたはデータ ディクショナリに作成し変更するには、バス エディター、モデル エクスプローラー、または MATLAB® コマンドを使用します。Bus オブジェクトをモデル ワークスペースに保存することはできません。

モデル内で Bus オブジェクトを使用する場合は、Simulink.Bus オブジェクト データ型でのバス プロパティの指定を参照してください。

作成

Bus オブジェクトは複数の方法で作成できます。

構文

name = Simulink.Bus

説明

例

name = Simulink.Bus は、既定のプロパティ値をもつ Bus オブジェクトを返します。Bus オブジェクトの名前は、Bus オブジェクトを割り当てる MATLAB 変数の名前です。

プロパティ

すべて展開する

バスの description。文字ベクトルとして指定します。description を使用して、バス オブジェクトが適用される信号の種類や Bus オブジェクトの使用場所など Bus オブジェクトに関する情報を記述します。この情報は、Simulink 処理に影響を与えません。

データ型: char | string

バスの要素。Simulink.BusElement オブジェクトの配列として指定します。各 BusElement オブジェクトはバス内の信号の名前、データ型、次元、その他のプロパティを定義します。詳細については、Simulink.BusElement を参照してください。

生成コード内のデータ型の定義モード。'Auto'、'Exported' または 'Imported' として指定します。このプロパティは、コードの生成中に、データ型定義を HeaderFile プロパティで指定されたヘッダー ファイルからインポートするか、このファイルにエクスポートするかを指定します。

値アクション
'Auto' (既定の設定)

指定されたヘッダー ファイルからデータ型定義をインポートします。ヘッダー ファイルを指定しない場合、データ型定義を既定のヘッダー ファイルにエクスポートします。

'Exported'データ型定義を指定されたヘッダー ファイルまたは既定のヘッダー ファイルにエクスポートします。
'Imported'指定されたヘッダー ファイルまたは既定のヘッダー ファイルからデータ型定義をインポートします。

データ型: char | string

データ型定義で使用される C ヘッダー ファイル。文字ベクトルとして指定します。DataScope プロパティの値に基づいて、ヘッダー ファイルからデータ型定義をインポート、またはヘッダー ファイルにデータ型定義をエクスポートします。Simulink Coder™ ソフトウェアではコード生成にこのプロパティが使用されます。Simulink ソフトウェアではこのプロパティは無視されます。

既定では、生成された #include 命令は、< および > の代わりに、プリプロセッサの区切り記号である " を使用します。命令 #include <myTypes.h> を生成するには、HeaderFile を <myTypes.h> として指定します。

データ型: char | string

データ整列境界。整数 (バイト数) として指定します。Simulink Coder ソフトウェアではコード生成にこのプロパティが使用されます。Simulink ソフトウェアではこのプロパティは無視されます。

このバスに割り当てられるデータの開始メモリ アドレスは Alignment 設定の倍数です。配置を必要とする状況でオブジェクトが発生した場合は、128 を超えない 2 のべき乗である正の整数もつ Alignment 値を指定しなければなりません。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

多次元バス要素の次元を生成コード内で保持するためのコード ジェネレーターの指定。詳細については、Preserve Dimensions of Bus Elements in Generated Code (Embedded Coder)を参照してください。

データ型: logical

例

すべて折りたたむ

ライブ スクリプトを開く

Simulink.BusElement オブジェクトの配列を使用して Simulink.Bus オブジェクトの階層を作成します。

Chirp および Sine という名前の 2 つの BusElement オブジェクトを含む配列をベース ワークスペースに作成します。

elems(1) = Simulink.BusElement;
elems(1).Name = 'Chirp';

elems(2) = Simulink.BusElement;
elems(2).Name = 'Sine';

配列のインデックス付けにより、配列の要素を作成したり要素にアクセスしたりできます。ドット表記によって要素のプロパティ値にアクセスできます。

elems 配列で定義される要素を含む、Sinusoidal という名前の Bus オブジェクトを作成します。

Sinusoidal = Simulink.Bus;
Sinusoidal.Elements = elems;

Bus オブジェクトの階層を作成するため、Sinusoidal という名前の Bus を参照する別の Bus オブジェクトを作成します。

NestedBus および Step という名前の 2 つの BusElement オブジェクトを含む配列を作成します。NestedBus 要素のデータ型として、Sinusoidal という名前の Bus オブジェクトを指定します。

clear elems

elems(1) = Simulink.BusElement;
elems(1).Name = 'NestedBus';
elems(1).DataType = 'Bus: Sinusoidal';

elems(2) = Simulink.BusElement;
elems(2).Name = 'Step';

elems 配列で定義される要素を含む、TopBus という名前の Bus オブジェクトを作成します。

TopBus = Simulink.Bus;
TopBus.Elements = elems;

作成されたオブジェクトの階層を [バス エディター] で表示できます。

buseditor

バージョン履歴

R2006a より前に導入

参考

関数

ツール

オブジェクト

トピック