Signal Specification

信号の必要な次元、サンプル時間、データ型、数値タイプ、および属性を指定

ライブラリ:
Simulink / Signal Attributes
HDL Coder / Signal Attributes

説明

Signal Specification ブロックを使用すると、ブロックの入出力端子に接続された信号の属性を指定できます。指定した属性が、端子に接続されたブロックにより指定された属性と一致しない場合、モデルをコンパイルするときに Simulink^® によってエラーが表示されます。たとえば、シミュレーションの開始時に不一致が存在しない場合、Simulink はコンパイルされたモデルから Signal Specification ブロックを除外します。言い換えれば、Signal Specification ブロックはバーチャルブロックです。このブロックは、信号の属性を指定するためだけに存在し、モデルのシミュレーションで何も役割を果たしません。

Signal Specification ブロックを使って、信号の実際の属性が必要な属性に一致するようにすることができます。たとえば、ユーザーと同僚が同じモデルの異なる部分で作業をしていると仮定します。この場合、ユーザーは Signal Specification ブロックを使って同僚の部分にユーザーのモデルの部分を接続することができます。次に同僚がユーザーに通知しないで信号の属性を変更した場合、対応する Signal Specification ブロックに入力される属性が一致しなくなり、モデルをシミュレーションしようとするとエラーが発生します。

Signal Specification ブロックは、モデル全体にわたって信号属性の正しい伝播を確実にするためにも使用できます。ただし、受け入れるまたは出力する信号の属性をブロックが指定できない可能性があるので、属性を正しく伝達するための十分な情報がモデルにない場合があります。その場合、Signal Specification ブロックが Simulink が必要とする情報を提供できます。Signal Specification ブロックを使用すると、ブロックが信号属性を失っているときにモデルのコンパイルを能率よく行うこともできます。

Signal Specification ブロックは信号ラベルの伝播をサポートします。詳細については、信号ラベル伝播を参照してください。

端子

入力

すべて展開する

`Port_1` — 入力信号
スカラー | ベクトル | 行列 | N 次元配列

属性をチェックする入力信号。スカラー、ベクトル、行列または N 次元配列として指定します。ブロックは、入力信号の属性をブロックのダイアログボックスで指定した必要な属性に対してチェックします。属性が一致しない場合、ブロックはエラーを生成します。

出力

すべて展開する

`Port_1` — 出力信号
スカラー | ベクトル | 行列 | N 次元配列

信号のすべての属性がダイアログボックスで指定された属性に一致する場合、出力信号は入力信号です。属性が一致しない場合、ブロックはエラーを生成します。

パラメーター

すべて展開する

`最小値` — 範囲チェックの最小値
`[]` (既定値) | スカラー

ブロック出力の最小値を有限で実数の double のスカラー値として指定します。

メモ

このブロックのデータ型としてバスオブジェクトを指定した場合、ブロックのバスデータの最小値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバスオブジェクトのバス要素の最小値を設定してください。バス要素の [最小値] プロパティの詳細については、Simulink.BusElement を参照してください。

Simulink は、以下を行う際にこの値を使用します。

シミュレーション範囲のチェック (信号範囲の指定を参照)
固定小数点データ型の自動スケーリング

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: '[ ]'

`最大値` — 範囲チェックの最大値
`[]` (既定値) | スカラー

ブロック出力の最大値を有限で実数の double のスカラー値として指定します。

メモ

このブロックのデータ型としてバスオブジェクトを指定した場合、ブロックのバスデータの最大値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバスオブジェクトのバス要素の最大値を設定します。バス要素の [最大値] プロパティの詳細については、Simulink.BusElement を参照してください。

Simulink は、以下を行う際にこの値を使用します。

シミュレーション範囲のチェック (信号範囲の指定を参照)
固定小数点データ型の自動スケーリング

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: '[ ]'

`データ型` — 出力データ型
`Inherit: auto` (既定値) | `double` | `single` | `half` | `int8` | `uint8` | `int16` | `uint16` | ...

必要な出力データ型を指定します。入力信号のデータ型が指定した値と一致しない場合、ブロックはエラーまたは警告を生成します。

[データ型アシスタントを表示] ボタンをクリックして、データ型の属性の設定に役立つ [データ型アシスタント] を表示します。詳細については、データ型アシスタントを利用したデータ型の指定を参照してください。

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

継承したデータ型
組み込みの Simulink データ型 — たとえば、[single] や [uint8] を指定します。Simulink でサポートされているデータ型を参照してください。
固定小数点データ型 — 関数 fixdt を使用します。たとえば、[fixdt(1,16,0)] を指定します。
列挙データ型 — Enum: が前に付いた型名を使用します。たとえば、[Enum: myEnumType] を指定します。
バスデータ型 — Bus: が前に付いた Simulink.Bus オブジェクトの名前を使用します。たとえば、[Bus: myBusObject] を指定します。
Simulink イメージデータ型 — Computer Vision Toolbox™ がある場合は、Simulink.ImageType (Computer Vision Toolbox) オブジェクトのコンストラクターを使用して、イメージを記述するプロパティを指定します。既定の設定では、データ型は、イメージの行、列、チャネルをそれぞれ表す Simulink.ImageType(480,640,3) 式を使用します。
値の型 — 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,0)' | 'fixdt(1,16,2^0,0)' | 'string' | 'Enum: <class name>' | 'Bus: <object name>' | 'ValueType: <object name>' | <data type expression> | Simulink.ImageType(480,640,3)

既定の設定: 'Inherit: auto'

`固定小数点ツールによる変更に対して出力データ型の設定をロックする` — 固定小数点ツールが出力データ型をオーバーライドするのを防止
`off` (既定値) | `on`

固定小数点ツールが、ブロックに指定した [出力] データ型をオーバーライドしないようにするには、このパラメーターを選択します。詳細については、[出力データ型の設定をロックする] の使用 (Fixed-Point Designer)を参照してください。

プログラムでの使用

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

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

`非バーチャルバスが必要` — 非バーチャルバス信号のみを受け入れ
`off` (既定値) | `on`

バスオブジェクトをデータ型として指定する場合、このパラメーターを使用して非バーチャルバス信号のみを受け入れるかどうかを指定します。

off — 信号を "バーチャル" バスから受け入れなければならないことを指定します。
on — 信号を "非バーチャル" バスから受け入れなければならないことを指定します。

依存関係

このパラメーターを有効にするには、[データ型] を次のいずれかの値に設定します。

Bus:<object name>
<data type expression>。バスオブジェクトを指定します。

プログラムでの使用

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

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

`単位 (m、m/s^2、N*m など)` — ブロックに対する入力信号の物理単位
`inherit` (既定値) | `<Enter unit>`

ブロックに対する入力信号の物理単位を指定します。単位を指定するには、テキストボックスに入力します。入力中、パラメーターには一致する可能性のある単位が表示されます。サポートされる単位のリストについては、「Allowed Units」を参照してください。

単位系を制約するには、パラメーターの右側にあるリンクをクリックします。

Unit System Configuration ブロックがコンポーネントに存在する場合は、そのダイアログボックスが表示されます。そのダイアログボックスを使用して、コンポーネントに対して許可される単位系と許可されない単位系を指定します。
Unit System Configuration ブロックがコンポーネントに存在しない場合は、モデルの [コンフィギュレーションパラメーター] ダイアログボックスが表示されます。そのダイアログボックスを使用して、モデルに対して許可される単位系と許可されない単位系を指定します。

プログラムでの使用

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

型: 文字ベクトル

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

既定の設定: 'inherit'

`次元 (継承は -1)` — 入力信号と出力信号の次元
`-1` (既定値) | `n` | `[m n]`

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

-1 — 信号が次元を継承するように指定します。
n — 幅 n のベクトルを指定します。
[m n] — m 個の行と n 個の列をもつ行列を指定します。

プログラムでの使用

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

型: 文字ベクトル

値: '-1' | n | [m n]

既定の設定: '-1'

`可変サイズの信号` — 可変サイズ、固定サイズ、またはその両方の信号を許可
`継承` (既定値) | `いいえ` | `はい`

信号を可変サイズ、固定サイズ、またはその両方にすることを指定します。

継承 — 可変サイズの信号と固定サイズの信号が許可されます。
いいえ — 可変サイズの信号は許可されません。
はい — 可変サイズの信号のみが許可されます。

依存関係

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

バスオブジェクトを指定すると、バスオブジェクトが無効な可変サイズ信号のみが許可されます。

プログラムでの使用

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

型: 文字ベクトル

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

既定の設定: 'Inherit'

`サンプル時間 (継承は -1)` — サンプルの時間間隔。
`-1` (既定値) | スカラー | ベクトル

サンプルの時間間隔を指定します。サンプル時間を継承するには、このパラメーターを -1 に設定します。詳細については、サンプル時間の指定を参照してください。

プログラムでの使用

パラメーター: SampleTime

型: 文字ベクトル

値: 任意の有効なサンプル時間

既定の設定: '-1'

`信号タイプ` — 信号の複雑度
`自動` (既定値) | `実数` | `複素数`

入出力信号の複雑度を指定します。

自動 — 数値タイプとして [実数] または [複素数] を受け取ります。
実数 — 数値タイプを実数値として指定します。
複素数 — 数値タイプを複素数値として指定します。

プログラムでの使用

パラメーター: SignalType

型: 文字ベクトル

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

既定の設定: 'auto'

モデルの例

For Each Subsystem を使用した同等のダイナミクスをもつオブジェクトのモデル化

この例では、同等のダイナミクスをもつ複数のオブジェクトを For Each Subsystem を使用してモデル化する方法を示します。オブジェクトの数は、入力信号の長さでパラメーター化されます。

モデルを開く

ブロックの特性

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

拡張機能

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

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

HDL Coder™ には、HDL の実装および合成されたロジックに影響する追加のコンフィギュレーションオプションがあります。

HDL アーキテクチャ

このブロックにはパススルー実装があります。

HDL ブロックプロパティ

ConstrainedOutputPipeline	既存の遅延を設計内で移動することによって出力に配置するレジスタの数。分散型パイプラインではこれらのレジスタは再分散されません。既定の設定は `0` です。詳細については、ConstrainedOutputPipeline (HDL Coder)を参照してください。
InputPipeline	生成されたコードに挿入する入力パイプラインステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は `0` です。詳細については、InputPipeline (HDL Coder)を参照してください。
OutputPipeline	生成されたコードに挿入する出力パイプラインステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は `0` です。詳細については、OutputPipeline (HDL Coder)を参照してください。

複素数データのサポート

このブロックは、複素信号のコード生成をサポートしています。

Signal Specification

説明

端子

入力

Port_1 — 入力信号 スカラー | ベクトル | 行列 | N 次元配列

出力

Port_1 — 出力信号 スカラー | ベクトル | 行列 | N 次元配列

パラメーター

最小値 — 範囲チェックの最小値 [] (既定値) | スカラー

プログラムでの使用

最大値 — 範囲チェックの最大値 [] (既定値) | スカラー

プログラムでの使用

データ型 — 出力データ型 Inherit: auto (既定値) | double | single | half | int8 | uint8 | int16 | uint16 | ...

プログラムでの使用

固定小数点ツールによる変更に対して出力データ型の設定をロックする — 固定小数点ツールが出力データ型をオーバーライドするのを防止 off (既定値) | on

プログラムでの使用

非バーチャル バスが必要 — 非バーチャル バス信号のみを受け入れ off (既定値) | on

依存関係

プログラムでの使用

単位 (m、m/s^2、N*m など) — ブロックに対する入力信号の物理単位 inherit (既定値) | <Enter unit>

プログラムでの使用

次元 (継承は -1) — 入力信号と出力信号の次元 -1 (既定値) | n | [m n]

プログラムでの使用

可変サイズの信号 — 可変サイズ、固定サイズ、またはその両方の信号を許可 継承 (既定値) | いいえ | はい

依存関係

プログラムでの使用

サンプル時間 (継承は -1) — サンプルの時間間隔。 -1 (既定値) | スカラー | ベクトル

プログラムでの使用

信号タイプ — 信号の複雑度 自動 (既定値) | 実数 | 複素数

プログラムでの使用

モデルの例

For Each Subsystem を使用した同等のダイナミクスをもつオブジェクトのモデル化

ブロックの特性

拡張機能

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

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

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

バージョン履歴

参考

ブロック

オブジェクト

トピック

`Port_1` — 入力信号
スカラー | ベクトル | 行列 | N 次元配列

`Port_1` — 出力信号
スカラー | ベクトル | 行列 | N 次元配列

`最小値` — 範囲チェックの最小値
`[]` (既定値) | スカラー

`最大値` — 範囲チェックの最大値
`[]` (既定値) | スカラー

`データ型` — 出力データ型
`Inherit: auto` (既定値) | `double` | `single` | `half` | `int8` | `uint8` | `int16` | `uint16` | ...

`固定小数点ツールによる変更に対して出力データ型の設定をロックする` — 固定小数点ツールが出力データ型をオーバーライドするのを防止
`off` (既定値) | `on`

`非バーチャルバスが必要` — 非バーチャルバス信号のみを受け入れ
`off` (既定値) | `on`

`単位 (m、m/s^2、N*m など)` — ブロックに対する入力信号の物理単位
`inherit` (既定値) | `<Enter unit>`

`次元 (継承は -1)` — 入力信号と出力信号の次元
`-1` (既定値) | `n` | `[m n]`

`可変サイズの信号` — 可変サイズ、固定サイズ、またはその両方の信号を許可
`継承` (既定値) | `いいえ` | `はい`

`サンプル時間 (継承は -1)` — サンプルの時間間隔。
`-1` (既定値) | スカラー | ベクトル

`信号タイプ` — 信号の複雑度
`自動` (既定値) | `実数` | `複素数`

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

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

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