このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Out Bus Element, Bus Element Out

外部端子に接続される出力を指定

• 

×

ライブラリ:
Simulink / Ports & Subsystems
Simulink / Sinks
HDL Coder / Ports & Subsystems
HDL Coder / Sinks

説明

Bus Element Out ブロックとしても知られる Out Bus Element ブロックは、Outport ブロックと Bus Creator ブロックの機能を組み合わせたものです。このブロックのブロック タイプは Outport であり、同じ端子を使用するすべての Out Bus Element ブロックは、ダイアログ ボックスを共有します。

多くのバス要素で構成されるバスを含むインターフェイスに対し、Out Bus Element ブロックは次を行います。

• ブロック線図における信号線の複雑さと煩雑さを低減する。

• インターフェイスに対する段階的な変更を容易にする。

• 使用ポイントに近いバス要素へのアクセスを許可して、Bus Creator および From ブロック構成の使用を回避する。

Out Bus Element ブロックではメッセージと信号の要素を入力として混在させることはサポートされません。

出力バス要素端子の作成

モデル コンポーネントの出力バス要素端子を作成するには、モデル コンポーネントのブロック線図で Out Bus Element ブロックを追加します。あるいは、サブシステムの場合は、Subsystem ブロックの端をクリックして [出力バス端子の作成] を選択します。

モデル コンポーネントのブロック ラベルでは、端子名とバス要素の 2 つの対話型のテキスト フィールドに既定値が使用されます。ブロックに関連付けられた端子の名前を変更するには、ラベルの最初のテキスト フィールドをクリックして編集します。

複数のブロックが同じ端子に関連付けられている場合、その端子の名前を変更すると、その端子を共有するすべてのブロックが新しい端子の名前を反映するように更新されます。

別の出力バス要素端子を作成するには、Ctrl キーを押したまま既存の Out Bus Element ブロックを新しい場所にドラッグします。ポインターを放したら [新規端子の作成] をクリックします。

出力バスへの要素の追加

複数の要素を出力するには、バスに含める要素ごとに Out Bus Element ブロックを作成します。次の表に、既存の端子の Out Bus Element ブロックを追加する方法を示します。

目的	操作
新しい要素の Out Bus Element ブロックを追加する。	Out Bus Element ブロックをダブルクリックします。開いたダイアログ ボックスで、[新規信号を追加します] を選択します。必要に応じて、新しい要素を入れ子になったバスにドラッグします。
入れ子になった新しいバスの Out Bus Element ブロックを追加する。	Out Bus Element ブロックをダブルクリックします。開いたダイアログ ボックスで、[新規サブバスを追加します] を選択します。必要に応じて、バスを別のバスにドラッグします。
新しい要素の Out Bus Element ブロックを既存の要素と同じレベルに追加する。	Ctrl キーを押したまま端子の既存の Out Bus Element ブロックを新しい場所にドラッグします。ポインターを放したら [既存端子の使用] をクリックします。

端子に関連付けられたすべての要素名は一意でなければなりません。出力バス要素端子に対して同じ要素名を複数回指定することはできません。Simulink^® は同じ端子へのオーバーラップする書き込みをサポートしません。

Out Bus Element ブロックの要素の名前または階層を変更するには、ラベルの 2 番目のテキスト フィールドをクリックして編集します。

出力バスで階層を作成するには、バス要素を説明するラベルの部分でドットを使用します。それぞれのドットはバス階層の新しいレベルを示します。

ラベルのサイズを小さくするには、要素名のみを表示できます。ブロックを選択し、省略記号をポイントして、操作バーから [コンパクトな表記法] を選択します。バス階層を再度表示するには、操作バーから [展開された表記法] を選択します。

ブロック入力を出力端子にバスなしで渡す

バス内で入れ子にすることなくブロック入力を外部出力端子に渡すには、2 番目のテキスト フィールドからテキストを削除します。

Out Bus Element ブロックで端子全体を定義する場合、Out Bus Element ブロックの入力はバス要素端子の出力であり、非バス信号の場合があります。

端子の出力の変更

ダイアログ ボックスで次のことが可能です。

• 端子名と要素名を変更する。

• 要素のリストで要素を新しい場所にドラッグしてバス要素を並べ替える。

• [選択した信号のブロックを削除します] ボタン をクリックして、選択した要素に関連付けられたブロックを削除する。

出力データのログ記録

出力データをワークスペースまたはファイルに保存すると、ルートレベルの Out Bus Element ブロックのグループによって定義されるバス データはルートレベルの Outport ブロック データと共にログに記録されます。

例

Simulink バス機能の確認

コンポーネントでのバスの使用、コンポーネント インターフェイスのバス端子の使用、一般的なバス ワークフローの迅速な実行。

モデルを開く

複数の出力信号を 1 つの端子に接続

モデルを開く

サブシステムおよびモデルのバス インターフェイスの簡略化

モデルを開く

複数のサブシステム端子を 1 つの端子に結合

モデルを開く

Programmatically Create Bus Element Ports

Add blocks for bus element ports and specify element attributes using MATLAB^® functions.

ライブ スクリプトを開く

端子

入力

Port_1 — 外部端子用の全出力または部分出力

スカラー | ベクトル | 行列 | 配列 | バス

親サブシステムまたはモデルの対応する外部入力端子に渡すバス、信号またはメッセージを接続します。

複数の Out Bus Element ブロックが同一の外部端子に関連付けられている場合、このブロックへの入力は出力端子のバスの 1 要素になります。要素名はラベルの 2 番目のテキスト フィールドで指定されます。

1 つの Out Bus Element ブロックが外部端子に関連付けられている場合、このブロックへの入力は出力端子に直接受け渡されるか、出力端子においてバス内で入れ子にされます。バス内で入れ子にすることなく、ブロックの入力を出力端子に受け渡すには、ラベルの 2 番目のテキスト フィールドからテキストを削除します。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | string | Boolean | fixed point | enumerated | bus
複素数のサポート: あり

パラメーター

ブロックのパラメーターと対応する端子を対話的に編集するには、ブロックをダブルクリックします。

端子の名前 — 出力端子の名前

OutBus (既定値) | 端子の名前

他のブロックまたは端子でまだ使用されていない端子名を指定します。名前は親 Subsystem ブロックまたは Model ブロックに表示されます。名前は、ブロックの横にも表示されます。複数のブロックが同じ端子にアクセスできます。

プログラムでの使用

ブロック パラメーター: PortName

型: 文字ベクトル

値: 'OutBus' | '<port name>'

既定の設定: 'OutBus'

端子番号 — 親ブロックの端子の位置

1 (既定値) | 実数の整数

ブロックに対応する端子が親 Subsystem または Model ブロックに現れる順序を指定します。

• 別の端子を作成するブロックを追加する場合、端子番号は次に利用可能な番号になります。

• ある端子に関連付けられているすべてのブロックを削除すると、その端子が削除されます。どの番号も省略されることなく連番になるように、その他の端子の番号を付け直します。

• 端子の数を超える端子番号を指定すると、その番号の端子と、その番号まで連番になる他の端子が作成されます。

プログラムでの使用

ブロック パラメーター: Port

型: 文字ベクトル

値: 実数の整数

既定の設定: '1'

色の設定 — ブロックの背景色の指定

黒 (既定値) | 白 | 赤 | 緑 | 青 | シアン | マゼンタ | 黄 | グレー | 薄い青 | オレンジ | 濃い緑 | その他の色

ブロックの背景色を指定します。これを指定すると、選択したバス要素に関連付けられているブロック、またはバス要素を選択していない場合は、端子に関連付けられているすべてのブロックの色が設定されます。

プログラムでの使用

ブロック パラメーター: BackgroundColor

型: 文字ベクトル

値: 'black' | 'white | 'red' | 'green' | 'blue' | 'cyan' | 'magenta' | 'yellow' | 'gray' | 'lightBlue' | 'orange' | 'darkGreen' | '[r,g,b]'。ここで、r、g および b は、0.0 ～ 1.0 の範囲の赤、緑、青のカラー値です。

既定の設定: 'black'

フィルター — 表示される一連の信号をフィルター

テキスト

バス要素の長いリストをフィルター処理するために使用する検索用語を指定します。検索用語は引用符で囲まないでください。フィルターは部分的な文字列検索を行い、正規表現をサポートします。正規表現文字をリテラルとして使用するには、エスケープ文字 (\) を含めます。たとえば、疑問符を使用するには、sig\?1 と入力します。

属性

データ型などの属性を指定するには、バス、信号またはメッセージの名前で一時停止します。次に、表示される鉛筆ボタンをクリックします。

これらは、属性を指定するとバス、信号またはメッセージの名前の横に表示されます。属性の概要をクリックして、バス、信号またはメッセージの属性を編集します。

データ型 — データ型

Inherit: auto (既定値) | double | single | half | int8 | uint8 | int16 | uint16 | ...

データ型は継承されるか、直接指定されるか、Simulink.NumericType オブジェクトなどのデータ型オブジェクトとして表現されます。

次のいずれかのオプションを指定できます。

• 継承したデータ型

• 組み込みの Simulink データ型 — たとえば、[single] や [uint8] を指定します。Simulink でサポートされているデータ型を参照してください。

• 固定小数点データ型 — 関数 fixdt を使用します。たとえば、[fixdt(1,16,0)] を指定します。

• 列挙データ型 — Enum: が前に付いた型名を使用します。たとえば、[Enum: myEnumType] を指定します。

• バス データ型 — Bus: が前に付いた Simulink.Bus オブジェクトの名前を使用します。たとえば、[Bus: myBusObject] を指定します。

• 値の型 — ValueType: が前に付いた Simulink.ValueType オブジェクトの名前を使用します。たとえば、[ValueType: windVelocity] を指定します。

• カスタムのデータ型 — 型を指定する MATLAB 式を使用します。たとえば、DataTypeMode プロパティが 'Fixed-point: unspecified scaling' 以外の値に設定されている Simulink.NumericType オブジェクトを指定できます。

Simulink.ValueType オブジェクトまたは Simulink.Bus オブジェクトを指定する場合は、データ型以外のものも定義します。そのオブジェクトでは [最小値]、[最大値]、[単位] などのプロパティも定義します。ValueType オブジェクトで指定されたプロパティ値は、ブロックで指定された対応するプロパティ値をオーバーライドします。たとえば、ブロックで [単位] が ft/s に設定されているとします。ブロックの [データ型] で ValueType オブジェクトが指定されており、そのオブジェクトの単位として m/s が使用されている場合、ブロックは ft/s ではなく m/s を使用します。

プログラムでの使用

ブロック パラメーター: OutDataTypeStr

型: 文字ベクトル

値: 'Inherit: auto' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16)' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'string' | 'Enum: <class name>' | 'Bus: <object name>' | 'ValueType: <object name>' | '<data type expression>'

既定の設定: 'Inherit: auto'

データ モード — バス要素のデータ モード

継承 (既定値) | 信号 | メッセージ

バス要素のデータ モードを指定します。

• [継承] — バス要素はデータ モードを継承する。

• [信号] — バス要素は信号でなければならない。

• [メッセージ] — バス要素はメッセージでなければならない。

  In Bus Element ブロックでは、データ モードとして [メッセージ] を選択すると、バスまたはバス要素の横にエンベロープ ボタンが表示されます。エンベロープ ボタンを使用して、メッセージ要素ごとにカスタムのキュー プロパティを指定します。Out Bus Element ブロックではキューの指定はサポートされません。

依存関係

このパラメーターを有効にするには、ブロックがモデルの最上位レベルでなければなりません。

プログラムでの使用

ブロック パラメーター: DataMode

型: 文字ベクトル

値: 'inherit' | 'signal' | 'message'

既定の設定: 'inherit'

バスの仮想性 — バーチャルまたは非バーチャル バス

継承 (既定値) | バーチャル | 非バーチャル

バスの仮想性を継承するか、バスをバーチャルまたは非バーチャルとして定義するかを指定します。詳細については、合成インターフェイスのガイドラインを参照してください。

このパラメーターは、ブロックがバスの仮想性を継承または定義するかを決定します。ブロックがバスの仮想性を定義し、入力バスの仮想性が一致しない場合、モデルをコンパイルするとエラーが発生します。

依存関係

このパラメーターを有効にするには、[データ型] を Bus オブジェクトに設定します。

プログラムでの使用

ブロック パラメーター: BusVirtuality

型: 文字ベクトル

値: 'inherit' | 'virtual' | 'nonvirtual'

既定の設定: 'inherit'

次元 — 信号の次元

-1 (既定値) | 整数 | [整数, 整数]

信号の次元を指定します。

• -1 — 信号はどのような次元ももつことができます。

• N — 信号はサイズ N のベクトルでなければなりません。

• [R C] — この信号は、R 行 C 列の行列でなければなりません。

プログラムでの使用

ブロック パラメーター: PortDimensions

型: 文字ベクトル

値: '-1' | 整数 | [整数, 整数]

既定の設定: '-1'

次元モード — 可変サイズの信号のみまたは固定サイズの信号のみを許可するオプション

継承 (既定値) | 固定 | 可変

許可される信号の型を指定します。

• 継承 — 可変サイズの信号と固定サイズの信号が許可されます。

• 可変 — 可変サイズの信号のみが許可されます。

• 固定 — 固定サイズの信号のみが許可されます。可変サイズの信号は許可されません。

この信号が可変サイズの場合、[次元] パラメーターは信号の最大次元を指定します。

プログラムでの使用

パラメーター: VarSizeSig

型: 文字ベクトル

値: 'Inherit' | 'No' | 'Yes'

既定の設定: 'Inherit'

単位 — 物理単位

inherit (既定値) | <Enter unit>

信号の物理単位を指定します。サポートされる単位のリストについては、「Allowed Units」を参照してください。

プログラムでの使用

ブロック パラメーター: Unit

型: 文字ベクトル

値: 'inherit' | '<Enter unit>'

既定の設定: 'inherit'

サンプル時間 — サンプル時間

-1 (既定値) | スカラー

サンプル時間のヒット間の離散間隔を指定するか、連続 (0) や継承 (-1) など、別のタイプのサンプル時間を指定します。その他のオプションについては、サンプル時間のタイプを参照してください。

既定では、信号はサンプル時間を継承します。

プログラムでの使用

ブロック パラメーター: SampleTime

型: 文字ベクトル

値: スカラー

既定の設定: '-1'

実数/複素数 — 数値型

自動 (既定値) | 実数 | 複素数

信号の数値型を指定します。信号の数値型を選択するには [自動] を選択します。それ以外の場合は、実数または複素信号型を選択します。

プログラムでの使用

ブロック パラメーター: SignalType

型: 文字ベクトル

値: 'auto' | 'real' | 'complex'

既定の設定: 'auto'

最小値 — 最小値

[] (既定値) | スカラー

Simulink がチェックする範囲の下限値。

この数値は有限の実数で double のスカラー値でなければなりません。

Simulink ソフトウェアは、以下を行う際にこの値を使用します。

• シミュレーション範囲のチェック (信号範囲の指定を参照)

• 固定小数点データ型の自動スケーリング

• モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

プログラムでの使用

ブロック パラメーター: OutMin

型: 文字ベクトル

値: '[]' | スカラー

既定の設定: '[]'

最大値 — 最大値

[] (既定値) | スカラー

Simulink がチェックする範囲の上限値。

この数値は有限の実数で double のスカラー値でなければなりません。

Simulink ソフトウェアは、以下を行う際にこの値を使用します。

• シミュレーション範囲のチェック (信号範囲の指定を参照)

• 固定小数点データ型の自動スケーリング

• モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

プログラムでの使用

ブロック パラメーター: OutMax

型: 文字ベクトル

値: '[]' | スカラー

既定の設定: '[]'

説明 — バスまたはバス要素の説明

既定値なし

この説明を使用して、バスまたはバス要素に関する情報 (使用場所など) を記述します。この情報は、Simulink 処理に影響を与えません。

プログラムでの使用

ブロック パラメーター: Description

型: 文字ベクトル

値: '' | '<Enter text>'

既定の設定: ''

ブロックの特性

データ型	Boolean | bus | double | enumerated | fixed point | half | integer | single | string
直達	いいえ
多次元信号	はい
可変サイズの信号	はい
ゼロクロッシング検出	いいえ

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための Verilog および VHDL のコードを生成します。

このブロックは、HDL コードを生成するサブシステムでブロックを使用する際のサブシステム バス インターフェイスを簡略化するために使用できますが、ハードウェア実装には含まれません。

HDL コード生成でのバスの使用の詳細についてはバス (HDL Coder)およびバス信号を使用したモデルの可読性の向上および HDL コードの生成 (HDL Coder)を参照してください。

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

バージョン履歴

R2017a で導入

参考

In Bus Element | Bus Creator | Outport

トピック

• バス要素端子を使用したサブシステム インターフェイスとモデル インターフェイスの簡略化
• 合成インターフェイスのガイドライン
• バーチャル バスへの信号またはメッセージのグループ化