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

MATLAB System

System object をモデルに含める

ライブラリ:
Simulink / User-Defined Functions
HDL Coder / User-Defined Functions

説明

MATLAB System ブロックでは、(matlab.System に基づく) 既存の System object が Simulink^® に導入されます。また、Simulink の新しいブロックを開発するための System object API を使用できます。このブロックの詳細については、MATLAB System ブロックを参照してください。

インタープリター型実行では、ブロックは MATLAB^® 実行エンジンを使用してシミュレートされます。

コード生成では、モデルによりブロックはコード生成を使用してシミュレートされます (コード生成をサポートする MATLAB コードのサブセットを使用)。MATLAB System ブロックは MATLAB で使用できる関数のサブセットだけをサポートします。すべての関数の一覧は、Functions and Objects Supported for C/C++ Code Generationを参照してください。これらの関数には、次のような一般的カテゴリの関数が含まれます。

plus、minus、power などの配列と行列の演算 (MATLAB)。
size、length などの行列操作
lu、inv、svd、chol などの高度な行列操作
sin、cos、sinh、cosh などの三角関数

System object

MATLAB System ブロックを使用するには、新しい System object™ を事前に用意するか既存のものを使用しなければなりません。詳細については、MATLAB System ブロックを使用した System object の統合を参照してください。

端子

入力

すべて展開する

`In` — MATLAB サブシステムブロックへの信号入力
スカラー | ベクトル | 行列

MATLAB System ブロックは、Simulink がサポートするほとんどの型の入力を受け入れます。このブロックはバーチャルバスの入出力をサポートしません。このブロックは可変サイズの信号を含んでいる非バーチャルバスをサポートしません。詳細については、Simulink でサポートされているデータ型を参照してください。

このブロックの固定小数点サポートの詳細は、コードの高速化と MATLAB からのコード生成 (Fixed-Point Designer)を参照してください。

MATLAB System ブロックは、Simulink フレームをサポートします。詳細については、サンプルベースおよびフレームベースの概念 (DSP System Toolbox)を参照してください。

出力

すべて展開する

`Out` — MATLAB System ブロックの信号出力
スカラー | ベクトル | 行列

System object が返す MATLAB System ブロックの信号出力。

パラメーター

すべて展開する

`System object 名` — System object の名前
cell 配列 (既定値)

ユーザー定義の System object クラスの完全な名前をファイル拡張子なしで指定します。このエントリでは大文字と小文字が区別されます。クラス名は MATLAB パス上に存在しなければなりません。

System object 名は次のいずれかの方法で指定できます。

テキストボックスに名前を入力します。
テキストボックスに付いているリスト矢印をクリックします。現在のフォルダーに有効な System object があれば、それらの名前がリストに表示されます。このリストから System object を選択します。
有効な System object があるフォルダーを参照します。フォルダーが MATLAB パスにない場合は、追加するように求められます。

System object を作成する必要がある場合は、[新規] をクリックしてテンプレートから作成できます。

System object を保存した後、[System object 名] テキストボックスに名前が表示されます。

ユーザー定義の System object クラス名の完全な名前を使用します。System object クラス名に割り当てた MATLAB 変数はこのブロックでは受け入れられません。

プログラムでの使用

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

型: 文字ベクトル

値: System object の名前

既定の設定: ' '

`新規` — テンプレートから System object を作成
`標準` (既定値) | `詳細設定` | `Simulink 拡張`

System object テンプレートのいずれかのオプションを選択します。

標準: MATLAB エディターを起動し、System object メソッドが少ないシンプルな System object のテンプレートを表示します。
詳細設定: MATLAB エディターを起動し、System object メソッドが多い高度な System object のテンプレートを表示します。
Simulink 拡張: MATLAB エディターを起動し、Simulink のブロックをカスタマイズするためのユーティリティを含むファイルを表示します。これは、MATLAB で [新規] 、 [System object] 、 [Simulink 拡張] を選択したときに使用できるファイルと同じものです。

System object を保存した後、[System object 名] テキストボックスに名前を入力できます。

`シミュレーション実行方法` — シミュレーションモードの選択
`コード生成` (既定値) | `インタープリター型実行`

シミュレーションモードを選択します。

コード生成

モデルの最初の実行時にコード生成をサポートする MATLAB 関数のみを使用して MATLAB System ブロックのシミュレーションとコード生成が行われます。ブロックの構造が変更されていない場合は、以降のモデルの実行でコードは再生成されません。

シミュレーションモードが [コード生成] の場合、System object では最大 32 個の入力を受け入れます。

インタープリター型実行

サポートされるすべての MATLAB 関数を使用してモデルをシミュレートします。このオプションを使用するとシミュレーションのパフォーマンスが遅くなる場合があります。

`依存関係` — MATLAB System ブロックの依存関係パラメーター
自動 (既定値)

有効な System object クラス名をブロックに割り当てた後、次にこのブロックのダイアログボックスを開くと、パラメーターが表示されます。このパラメーターはすべての MATLAB System ブロックに表示されます。削除することはできません。

ブロックにタブがない場合、このパラメーターはダイアログボックスの一番下に表示されます。
ブロックに複数のタブがある場合、このパラメーターはダイアログボックスの最初のタブの一番下に表示されます。

`整数オーバーフローで飽和` — オーバーフローで飽和するかどうかを指定
オフ (既定値) | オン

オン: オーバーフローは、データ型が表現できる最小値または最大値のいずれかに飽和します。たとえば、符号付き 8 ビット整数に関連付けられたオーバーフローは、-128 または 127 に飽和することができます。
オフ: オーバーフローは、データ型によって表現される適切な値にラップされます。たとえば、数 130 は符号付き 8 ビット整数 1 つに収まりきらないので、-126 にラップされます。

ヒント

モデルでオーバーフローが発生する可能性があり、生成コードに飽和保護を明示的に組み込む必要があるときには、このチェックボックスをオンにすることを検討してください。
生成コードの効率を最適化する場合には、このチェックボックスをオフにすることを検討してください。このチェックボックスをオフにすると、ブロックが範囲外の信号を処理する方法を指定しすぎないようにする点でも役立ちます。詳細については、信号範囲のエラーのチェックを参照してください。
このチェックボックスをオンにすると、飽和は出力や結果だけでなく、このブロックの内部演算すべてに適用されます。
通常、オーバーフローが可能ではない場合は、コード生成プロセスで検出されます。この場合、コードジェネレーターでは飽和コードは生成されません。

依存関係

このチェックボックスは、System object で showFiSettingsImpl メソッドを使用すると表示されます。

プログラムでの使用

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

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

`これらの継承される Simulink 信号タイプを fi オブジェクトとして扱う` — fi データ型を指定
`固定小数点` (既定値) | `固定小数点および整数`

fi データ型を扱う継承されるデータ型を選択します。

固定小数点: 固定小数点データ型を fi データ型として扱います。
固定小数点および整数: 固定小数点データ型および整数データ型を fi データ型として扱います。

依存関係

このチェックボックスは、System object で showFiSettingsImpl メソッドを使用すると表示されます。

`MATLAB System fimath` — 使用する固定小数点設定を指定
MATLAB と同じ (既定値) | それ以外を指定

使用する固定小数点の算術設定を選択します。

MATLAB と同じ: 現在の MATLAB 固定小数点の算術設定を使用します。
それ以外を指定: 目的の固定小数点の算術設定を指定するためのエディットボックスを有効にします。固定小数点の算術の設定については、fimath を参照してください。

依存関係

このチェックボックスは、System object で showFiSettingsImpl メソッドを使用すると表示されます。

モデルの例

MATLAB System ブロックの System object のサンプル時間の指定

この例では、System object™ メソッドを使用して MATLAB System ブロックのサンプル時間を制御する方法を示します。

スクリプトを開く

ブロックの特性

データ型	`Boolean^[a]` \| `bus^[b]^[a]` \| `double^[a]` \| `enumerated^[a]` \| `fixed point^[a]` \| `integer^[a]` \| `single^[a]`
直接フィードスルー	`いいえ`
多次元信号	`限定的^[a]`
可変サイズの信号	`限定的^[c]^[a]`
ゼロクロッシング検出	`いいえ`
^[a] 実際のデータ型または機能のサポートは、ブロックの実装に依存します。 ^[b] 詳細は、「非バーチャルバスと MATLAB System ブロック」を参照してください。 ^[c] 詳細は、「可変サイズの信号」を参照してください。

拡張機能

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

実際のコード生成のサポートは、ブロックの実装に依存します。

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

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

System object を定義して MATLAB System ブロック内で HDL コード生成に使用できます。

調整可能なパラメーターのサポート

HDL Coder では、次のデータ型をもつ調整可能なパラメーターがサポートされます。

数値
固定小数点
文字
論理値

MATLAB System ブロックをもつ調整可能なパラメーターを使用する場合、調整可能なパラメーターは StorageClass が ExportedGlobal に設定された Simulink.Parameter オブジェクトである必要があります。

x = Simulink.Parameter 
x.Value = 1 
x.CoderInfo.StorageClass = 'ExportedGlobal'

詳細については、調整可能なパラメーターの DUT 端子を生成する (HDL Coder)を参照してください。

HDL アーキテクチャ

このブロックには単一の既定の HDL アーキテクチャがあります。

HDL ブロックプロパティ

事前定義された System object を使用する場合、使用できる HDL ブロックプロパティは、対応するブロックで使用できるプロパティと同じです。

既定では、次の HDL ブロックプロパティが使用できます。

ConstMultiplierOptimization	正準型符号付き桁数 (CSD) または因数分解された CSD による最適化。既定の設定は `[なし]` です。ConstMultiplierOptimization (HDL Coder)も参照してください。
ConstrainedOutputPipeline	既存の遅延を設計内で移動することによって出力に配置するレジスタの数。分散型パイプラインではこれらのレジスタは再分散されません。既定の設定は `0` です。詳細については、ConstrainedOutputPipeline (HDL Coder)を参照してください。
DistributedPipelining	パイプラインレジスタの分散、またはレジスタのリタイミング。既定の設定は `[オフ]` です。DistributedPipelining (HDL Coder)も参照してください。
InputPipeline	生成されたコードに挿入する入力パイプラインステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は `0` です。詳細については、InputPipeline (HDL Coder)を参照してください。
LoopOptimization	ループを展開、またはストリームするか、最適化しません。既定の設定は `[なし]` です。LoopOptimization (HDL Coder)も参照してください。
MapPersistentVarsToRAM	永続配列を RAM にマッピングします。既定の設定は `[オフ]` です。MapPersistentVarsToRAM (HDL Coder)も参照してください。
OutputPipeline	生成されたコードに挿入する出力パイプラインステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は `0` です。詳細については、OutputPipeline (HDL Coder)を参照してください。
ResetType	リセットロジックの生成を抑制。既定値は `[既定の設定]` で、リセットロジックを生成します。ResetType (HDL Coder)も参照してください。
SharingFactor	単一の共有リソースにマッピングされる、機能的に等価なリソースの数。既定の設定は 0 です。リソース共有 (HDL Coder)も参照してください。
VariablesToPipeline	警告 `VariablesToPipeline` は推奨されません。代わりに `coder.hdl.pipeline` を使用してください。指定された 1 つ以上の MATLAB 変数の出力にパイプラインレジスタを挿入します。変数のリストを、変数をスペースで区切った文字ベクトルとして指定します。

制限

DUT サブシステムはシングルレートでなければなりません。
入力は非離散 (定数または Inf) サンプル時間をもつことはできません。
次の事前定義された System objects が、MATLAB System ブロックで使用した場合のコード生成でサポートされます。
ユーザー定義の System object を使用する場合は、HDL コード生成をサポートしなければなりません。ユーザー定義の System objects および HDL コード生成の要件の詳細については、System Objects の HDL コード生成 (HDL Coder)を参照してください。

ユーザー定義 System Objects のコードの生成 (HDL Coder)およびSystem Objects の HDL コード生成 (HDL Coder)も参照してください。

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

実際のデータ型のサポートは、ブロックの実装に依存します。

参考

MATLAB Function

MATLAB System