ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Simulink.Bus クラス

パッケージ: Simulink
スーパークラス:

バス信号のプロパティを指定

説明

Simulink.Bus クラスのオブジェクトは Simulink.BusElement クラスのオブジェクトとともに使用して、バス信号のプロパティを指定します。バス オブジェクトは、バス信号のプロパティを検証します。モデルのシミュレーションを実行したり、ブロック線図を更新するときに、Simulink® では、ブロックに接続されているバスにバス オブジェクトで指定されたプロパティがあるどうか確認されます。指定されたプロパティをもたない場合、Simulink はエラー メッセージを表示します。データ型としてバス オブジェクトを使用できるブロックの完全なリストについては、バス オブジェクトを使用する状況を参照してください。

Simulink バス エディター、または MATLAB® コマンドを使用して、ベース MATLAB ワークスペースにバス オブジェクトを作成および変更できます。モデル ワークスペースにはバス オブジェクトを格納できません。

バス エディターを使用する場合は、ベース ワークスペースまたは関連付けられた Simulink データ ディクショナリに Simulink.Bus オブジェクトと Simulink.BusElement オブジェクトを作成します。

また、バス オブジェクトを使用して信号の属性を (モデルのルート レベルまたは Data Store Memory ブロックなどで) 指定できます。

構築

busObj = Simulink.Bus は、次のプロパティをもつバス オブジェクトを返します。

    Description: ''
      DataScope: 'Auto'
     HeaderFile: ''
      Alignment: -1
       Elements: [0×0 Simulink.BusElement]

バス オブジェクトの名前は、バス オブジェクトを割り当てる MATLAB 変数の名前です。バス オブジェクトを作成した後に、各プロパティを設定できます。

出力引数

すべて展開する

バス オブジェクト。Simulink.Bus オブジェクトとして返されます。

プロパティ

すべて展開する

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

バス要素。Simulink.BusElement オブジェクトの配列として指定します。各バス要素オブジェクトで、バス内の信号の名前、データ型、次元および他のプロパティを定義します。

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

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

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

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

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

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

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

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

メソッド

メソッド

目的

Simulink.Bus.cellToObject

バスの情報を含む cell 配列をバス オブジェクトに変換

Simulink.Bus.createMATLABStruct

バス信号と同じ階層と属性を使用して MATLAB 構造体を作成

Simulink.Bus.createObject

ブロックまたは MATLAB 構造体からバス オブジェクトを作成

Simulink.Bus.objectToCell

バス オブジェクトを使用して、バス情報を含む cell 配列を作成

Simulink.Bus.save

バス オブジェクトを MATLAB ファイルに保存

コピーのセマンティクス

値。値クラスがコピー操作に与える影響については、オブジェクトのコピー (MATLAB)を参照してください。

すべて折りたたむ

CONTROL バス オブジェクトとそのバス要素を作成します。バス オブジェクトはベース ワークスペースに格納されます。

clear elems;
elems(1) = Simulink.BusElement;
elems(1).Name = 'VALVE1';
elems(1).Dimensions = 1;
elems(1).DimensionsMode = 'Fixed';
elems(1).DataType = 'double';
elems(1).SampleTime = -1;
elems(1).Complexity = 'real';

elems(2) = Simulink.BusElement;
elems(2).Name = 'VALVE2';
elems(2).Dimensions = 1;
elems(2).DimensionsMode = 'Fixed';
elems(2).DataType = 'double';
elems(2).SampleTime = -1;
elems(2).Complexity = 'real';

CONTROL = Simulink.Bus;
CONTROL.Elements = elems;

このスクリプトは、バス オブジェクトを MATLAB ファイルに保存し、[オブジェクト] 形式を選択して取得するファイルに似ています。

代替方法

バス エディターを使用してバス オブジェクトとそのバス要素を対話的に作成できます。詳細については、バス エディターによるバス オブジェクトの作成を参照してください。

プログラムにより、次からバス オブジェクトを作成できます。

R2006a より前に導入