Relay

2 つの定数間で出力を切り替え

ライブラリ:
Simulink / Discontinuities
HDL Coder / Discontinuities

説明

Relay ブロックの出力は、指定した 2 つの値の間で切り替わります。Relay がオンの場合、入力が [スイッチオフポイント] パラメーターの値以下になるまでオンの状態です。Relay がオフの場合、入力が [スイッチオンポイント] パラメーターの値を超えるまでオフの状態です。ブロックは 1 つの入力を受け入れ、1 つの出力を生成します。

メモ

初期入力が [スイッチオフポイント] 値と [スイッチオンポイント] 値の "間" に来たときの初期出力は、リレーがオフになったときの値です。

例

Use Fixed-Step Zero-Crossing Detection for Faster Simulations

Use fixed-step zero-crossing detection to improve simulation performance.

スクリプトを開く

端子

入力

すべて展開する

Port_1 — 入力信号
スカラー

リレーをオンまたはオフに切り替える入力信号。

出力

すべて展開する

Port_1 — 出力信号
スカラー

出力信号は、パラメーター [オンの時の出力] と [オフの時の出力] で決定される 2 つの値の間で切り替わります。

パラメーター

すべて展開する

スイッチオンポイント — リレーをオンに切り替える入力値
`'eps'` (既定値) | スカラー

入力がこのしきい値を超えると、リレーはオンに切り替わります。[スイッチオンポイント] 値は、[スイッチオフポイント] 値以上であることが求められます。[スイッチオンポイント] 値を [スイッチオフポイント] 値より大きく指定するとヒステリシスのモデルが作成され、等しい値を指定するとその値をしきい値とするスイッチのモデルが作成されます。

[スイッチオンポイント] パラメーターは、最近傍の丸めと飽和方法を使用してオフラインで入力データ型に変換されます。

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: 'eps'

スイッチオフポイント — リレーをオフに切り替える入力値
`'eps'` (既定値) | スカラー

入力がこのしきい値を超えると、リレーはオフに切り替わります。[スイッチオフポイント] の値は [スイッチオンポイント] 以下でなければなりません。[スイッチオフポイント] パラメーターは、最近傍の丸めと飽和を使用してオフラインで入力データ型に変換されます。

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: 'eps'

オンの時の出力 — リレーがオンの場合の出力値
`1` (既定値) | スカラー

リレーがオンの場合の出力値。

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: '1'

オフの時の出力 — リレーがオフの場合の出力値
`0` (既定値) | スカラー

リレーがオフの場合の出力値。

プログラムでの使用

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

型: 文字ベクトル

値: スカラー

既定の設定: '0'

入力処理 — サンプルベースまたはフレームベースの処理を指定
`チャネルとしての要素 (サンプルベース)` (既定値) | `チャネルとしての列 (フレームベース)`

ブロックでサンプルベースかフレームベースのどちらの処理を実行するかを指定します。

チャネルとしての列 (フレームベース) — 入力の各列を独立したチャネルとして扱います (フレームベースの処理)。
メモ
フレームベースの処理には、DSP System Toolbox™ のライセンスが必要になります。
詳細については、サンプルベースおよびフレームベースの概念 (DSP System Toolbox)を参照してください。
チャネルとしての要素 (サンプルベース) — 入力の各要素を独立したチャネルとして扱います (サンプルベースの処理)。

[入力処理] を使って、ブロックでサンプルベースかフレームベースのどちらの処理を実行するかを指定します。これらの 2 つの処理モードの詳細については、サンプルベースおよびフレームベースの概念 (DSP System Toolbox)を参照してください。

プログラムでの使用

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

型: 文字ベクトル

値: 'Columns as channels (frame based)' | 'Elements as channels (sample based)'

既定の設定: 'Elements as channels (sample based)'

ゼロクロッシング検出を有効にする — ゼロクロッシング検出を有効にする
`on` (既定値) | `off`

ゼロクロッシング検出を有効にする場合は選択します。詳細については、ゼロクロッシング検出を参照してください。

プログラムでの使用

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

型: 文字ベクトル | string

値: 'off' | 'on'

既定の設定: 'on'

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

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

依存関係

このパラメーターは、-1 以外の値に設定した場合にのみ表示されます。詳細は、サンプル時間が推奨されないブロックを参照してください。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、関数 set_param を使用します。

パラメーター:	`SampleTime`
値:	`"-1"` (既定値) \| scalar or vector in quotes

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

ソフトウェアでチェックする出力範囲の下限値。

最小値を使用して以下が行われます。

一部のブロックに対するパラメーター範囲のチェック (ブロックパラメーターの最小値と最大値の指定を参照)
シミュレーション範囲のチェック (信号範囲の指定およびシミュレーション範囲のチェックの有効化を参照)
固定小数点データ型の自動スケーリング
モデルから生成するコードの最適化。この最適化により、アルゴリズムコードが削除され、SIL やエクスターナルモードなどの一部のシミュレーションモードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

ヒント

[出力の最小値] により、実際の出力信号が飽和する (またはクリップされる) ことはありません。代わりに、Saturation ブロックを使用してください。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、関数 set_param を使用します。

パラメーター:	`OutMin`
値:	`'[]'` (既定値) \| scalar in quotes

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

ソフトウェアでチェックする出力範囲の上限値。

最大値を使用して以下が行われます。

一部のブロックに対するパラメーター範囲のチェック (ブロックパラメーターの最小値と最大値の指定を参照)
シミュレーション範囲のチェック (信号範囲の指定およびシミュレーション範囲のチェックの有効化を参照)
固定小数点データ型の自動スケーリング
モデルから生成するコードの最適化。この最適化により、アルゴリズムコードが削除され、SIL やエクスターナルモードなどの一部のシミュレーションモードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

ヒント

[出力の最大値] により、実際の出力信号が飽和する (またはクリップされる) ことはありません。代わりに、Saturation ブロックを使用してください。

プログラムでの使用

ブロックパラメーターの値をプログラムで設定するには、関数 set_param を使用します。

パラメーター:	`OutMax`
値:	`'[]'` (既定値) \| scalar in quotes

出力データ型 — 出力信号のデータ型
`継承: データ型と同じすべての点` (既定値) | `継承: 逆伝播による継承` | `double` | `single` | `int8` | `int32` | `uint32` | `int64` | `uint64` | `fixdt(1,16,2^0,0)` | `<data type expression>` | ...

出力データ型を指定します。以下を指定可能です。

データ型継承ルール (例: [継承: 逆伝播による継承])
組み込みデータ型名 (例: single)
データ型オブジェクト名 (例: Simulink.NumericType オブジェクト)
データ型を評価する式 (例: fixdt(1,16,0))

[データ型アシスタントを表示] ボタンをクリックして、[出力データ型] パラメーターの設定に役立つ [データ型アシスタント] を表示します。

詳細については、信号のデータ型の制御を参照してください。

プログラムでの使用

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

型: 文字ベクトル

既定の設定: 'Inherit: All ports same datatype'

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

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

プログラムでの使用

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

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

ブロックの特性

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

拡張機能

すべて展開する

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

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

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

HDL アーキテクチャ

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

HDL ブロックプロパティ

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

制限

ブロックは、HDL コード生成では浮動小数点データ型をサポートしていません。

PLC コード生成
Simulink® PLC Coder™ を使用して構造化テキストコードを生成します。

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

バージョン履歴

R2006a より前に導入

参考

Saturation | Backlash

Relay

説明

例

Use Fixed-Step Zero-Crossing Detection for Faster Simulations

端子

入力

Port_1 — 入力信号 スカラー

出力

Port_1 — 出力信号 スカラー

パラメーター

スイッチオン ポイント — リレーをオンに切り替える入力値 'eps' (既定値) | スカラー

プログラムでの使用

スイッチオフ ポイント — リレーをオフに切り替える入力値 'eps' (既定値) | スカラー

プログラムでの使用

オンの時の出力 — リレーがオンの場合の出力値 1 (既定値) | スカラー

プログラムでの使用

オフの時の出力 — リレーがオフの場合の出力値 0 (既定値) | スカラー

プログラムでの使用

入力処理 — サンプルベースまたはフレームベースの処理を指定 チャネルとしての要素 (サンプル ベース) (既定値) | チャネルとしての列 (フレーム ベース)

プログラムでの使用

ゼロクロッシング検出を有効にする — ゼロクロッシング検出を有効にする on (既定値) | off

プログラムでの使用

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

依存関係

プログラムでの使用

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

ヒント

プログラムでの使用

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

ヒント

プログラムでの使用

出力データ型 — 出力信号のデータ型 継承: データ型と同じすべての点 (既定値) | 継承: 逆伝播による継承 | double | single | int8 | int32 | uint32 | int64 | uint64 | fixdt(1,16,2^0,0) | <data type expression> | ...

プログラムでの使用

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

プログラムでの使用

ブロックの特性

拡張機能

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

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

PLC コード生成 Simulink® PLC Coder™ を使用して構造化テキスト コードを生成します。

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

バージョン履歴

参考

Port_1 — 入力信号
スカラー

Port_1 — 出力信号
スカラー

スイッチオンポイント — リレーをオンに切り替える入力値
`'eps'` (既定値) | スカラー

スイッチオフポイント — リレーをオフに切り替える入力値
`'eps'` (既定値) | スカラー

オンの時の出力 — リレーがオンの場合の出力値
`1` (既定値) | スカラー

オフの時の出力 — リレーがオフの場合の出力値
`0` (既定値) | スカラー

入力処理 — サンプルベースまたはフレームベースの処理を指定
`チャネルとしての要素 (サンプルベース)` (既定値) | `チャネルとしての列 (フレームベース)`

ゼロクロッシング検出を有効にする — ゼロクロッシング検出を有効にする
`on` (既定値) | `off`

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

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

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

出力データ型 — 出力信号のデータ型
`継承: データ型と同じすべての点` (既定値) | `継承: 逆伝播による継承` | `double` | `single` | `int8` | `int32` | `uint32` | `int64` | `uint64` | `fixdt(1,16,2^0,0)` | `<data type expression>` | ...

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

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

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

PLC コード生成
Simulink® PLC Coder™ を使用して構造化テキストコードを生成します。

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