Relay

在两个常量输出之间进行切换

全页展开

库:
Simulink / Discontinuities
HDL Coder / Discontinuities

描述

Relay 模块的输出在两个指定值之间切换。打开中继时，它会一直保持打开，直到输入低于关闭点参数的值为止。关闭中继时，它会一直保持关闭，直到输入高于开启点参数的值为止。此模块接受一个输入并生成一个输出。

注意

如果初始输入介于 开启点与关闭点值之间，则初始输出是中继关闭时的值。

示例

作为已有函数的 C++ 对象方法

此示例说明如何使用代码继承工具来集成已有的 C++ 对象方法。

打开模型

端口

输入

全部展开

Port_1 — 输入信号
标量

输入信号，用于打开或关闭中继。

输出

全部展开

Port_1 — 输出信号
标量

输出信号在由参数打开时的输出和关闭时的输出确定的两个值之间切换。

参数

全部展开

开启点 — 用于打开中继的输入值
`'eps'` (默认) | `scalar`

当输入超过此阈值时，中继打开。开启点值必须大于或等于关闭点。指定的开启点值大于关闭点可构建磁滞模型，指定两个值相等则可构建以该值为阈值的开关模型。

开启点参数会通过舍入到最邻近整数和饱和处理方法自动转换为输入数据类型。

编程用法

模块参数：OnSwitchValue

类型：字符向量

值：标量

默认值：'eps'

关闭点 — 用于关闭中继的输入值
`'eps'` (默认) | `scalar`

当输入超过此阈值时，中继关闭。关闭点的值必须小于或等于开启点。关闭点参数会通过舍入到最邻近整数和饱和处理自动转换为输入数据类型。

编程用法

模块参数：OffSwitchValue

类型：字符向量

值：标量

默认值：'eps'

打开时的输出 — 当中继打开时的输出值
`1` (默认) | `scalar`

当中继打开时的输出值。

编程用法

模块参数：OnOutputValue

类型：字符向量

值：标量

默认值：'1'

关闭时的输出 — 当中继关闭时的输出值
`0` (默认) | `scalar`

当中继关闭时的输出值。

编程用法

模块参数：OffOutputValue

类型：字符向量

值：标量

默认值：'0'

输入处理 — 指定基于采样或基于帧的处理
元素作为通道(基于采样) (默认) | 列作为通道(基于帧)

指定模块是执行基于采样还是基于帧的处理：

列作为通道(基于帧) - 将输入信号的每一列视为一个单独的通道（基于帧的处理）。
注意
基于帧的处理需要具有 DSP System Toolbox™ 许可证。
有关详细信息，请参阅Sample- and Frame-Based Concepts (DSP System Toolbox)。
元素作为通道(基于采样) - 将输入信号的每个元素视为一个单独的通道（基于采样的处理）。

可以使用输入处理指定模块是执行基于采样的处理还是基于帧的处理。有关这两种处理模式的详细信息，请参阅Sample- and Frame-Based Concepts (DSP System Toolbox)。

编程用法

模块参数：InputProcessing

类型：字符向量

值：'Columns as channels (frame based)' | 'Elements as channels (sample based)'

默认值：'Elements as channels (sample based)'

启用过零检测 — 启用过零检测
`on` (默认) | `off`

选择此项以启用过零检测。有关详细信息，请参阅过零检测。

编程用法

模块参数：ZeroCross

类型：字符向量 | 字符串

值：'off' | 'on'

默认值：'on'

采样时间(-1 表示继承) — 采样之间的时间间隔
`-1` (默认) | 标量 | 向量

指定采样时间间隔。要继承采样时间，请将此参数设置为 -1。有关详细信息，请参阅指定采样时间。

依存关系

仅当您将此参数设置为 -1 以外的值时才可见。要了解详细信息，请参阅不建议设置采样时间的模块。

编程用法

模块参数：SampleTime

类型：字符串标量或字符向量

默认值："-1"

输出最小值 — 范围检查的最小输出值
`[]` (默认) | 标量

Simulink^® 检查的输出范围的下限值。

Simulink 使用最小值执行下列操作：

某些模块的参数范围检查（请参阅指定模块参数的最小值和最大值）。
仿真范围检查（请参阅指定信号范围和启用仿真范围检查）。
定点数据类型的自动定标。
从模型生成的代码的优化。此优化可删除算法代码，并影响某些仿真模式（如 SIL 或外部模式）的结果。有关详细信息，请参阅Optimize using the specified minimum and maximum values (Embedded Coder)。

注意

输出最小值不会对实际输出信号进行饱和处理或截断。请改用 Saturation 模块。

编程用法

模块参数：OutMin

类型：字符向量

值：'[ ]'| 标量

默认值：'[ ]'

输出最大值 — 范围检查的最大输出值
`[]` (默认) | 标量

Simulink 检查的输出范围的上限值。

Simulink 使用最大值执行下列操作：

某些模块的参数范围检查（请参阅指定模块参数的最小值和最大值）。
仿真范围检查（请参阅指定信号范围和启用仿真范围检查）。
定点数据类型的自动定标。
从模型生成的代码的优化。此优化可删除算法代码，并影响某些仿真模式（如 SIL 或外部模式）的结果。有关详细信息，请参阅Optimize using the specified minimum and maximum values (Embedded Coder)。

注意

输出最大值不会对实际输出信号进行饱和处理或截断。请改用 Saturation 模块。

编程用法

模块参数：OutMax

类型：字符向量

值：'[ ]'| 标量

默认值：'[ ]'

输出数据类型 — 输出信号的数据类型
继承: 所有端口都具有相同数据类型 (默认) | 继承: 通过反向传播继承 | double | single | int8 | int32 | uint32 | int64 | uint64 | fixdt(1,16,2^0,0) | <数据类型表达式> | ...

指定输出数据类型。可以将其设置为：

继承数据类型的规则，例如继承: 通过反向传播继承
内置数据类型的名称，例如 single
数据类型对象的名称，例如 Simulink.NumericType 对象
计算结果为数据类型的表达式，例如 fixdt(1,16,0)

点击显示数据类型助手按钮可以显示数据类型助手，这有助于您设置输出数据类型参数。

有关详细信息，请参阅。

编程用法

模块参数：OutDataTypeStr

类型：字符向量

值：'Inherit: Same as input'、'Inherit: Inherit via back propagation'、'single'、'int8'、'uint8'、int16、'uint16'、'int32'、'uint32'、'int64'、'uint64'、fixdt(1,16,0)、fixdt(1,16,2^0,0)、fixdt(1,16,2^0,0)。'<data type expression>'

默认值：'Inherit: Same as input'

锁定数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
`off` (默认) | `on`

选择此参数可防止定点工具覆盖您对此模块指定的数据类型。有关详细信息，请参阅Lock the Output Data Type Setting (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 架构

此模块具有一个默认 HDL 架构。

HDL 模块属性

ConstrainedOutputPipeline	通过移动设计中现有延迟的方式来放置在输出端的寄存器的数量。分布式流水线不会重新分发这些寄存器。默认值为 `0`。有关详细信息，请参阅ConstrainedOutputPipeline (HDL Coder)。
InputPipeline	要在生成的代码中插入的输入流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅InputPipeline (HDL Coder)。
OutputPipeline	要在生成的代码中插入的输出流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅OutputPipeline (HDL Coder)。

Relay

描述

示例

作为已有函数的 C++ 对象方法

端口

输入

Port_1 — 输入信号 标量

输出

Port_1 — 输出信号 标量

参数

开启点 — 用于打开中继的输入值 'eps' (默认) | scalar

编程用法

关闭点 — 用于关闭中继的输入值 'eps' (默认) | scalar

编程用法

打开时的输出 — 当中继打开时的输出值 1 (默认) | scalar

编程用法

关闭时的输出 — 当中继关闭时的输出值 0 (默认) | scalar

编程用法

输入处理 — 指定基于采样或基于帧的处理 元素作为通道(基于采样) (默认) | 列作为通道(基于帧)

编程用法

启用过零检测 — 启用过零检测 on (默认) | off

编程用法

采样时间(-1 表示继承) — 采样之间的时间间隔 -1 (默认) | 标量 | 向量

依存关系

编程用法

输出最小值 — 范围检查的最小输出值 [] (默认) | 标量

编程用法

输出最大值 — 范围检查的最大输出值 [] (默认) | 标量

编程用法

输出数据类型 — 输出信号的数据类型 继承: 所有端口都具有相同数据类型 (默认) | 继承: 通过反向传播继承 | double | single | int8 | int32 | uint32 | int64 | uint64 | fixdt(1,16,2^0,0) | <数据类型表达式> | ...

编程用法

锁定数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型 off (默认) | on

编程用法

模块特性

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成 使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换 使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

WeChat

Port_1 — 输入信号
标量

Port_1 — 输出信号
标量

开启点 — 用于打开中继的输入值
`'eps'` (默认) | `scalar`

关闭点 — 用于关闭中继的输入值
`'eps'` (默认) | `scalar`

打开时的输出 — 当中继打开时的输出值
`1` (默认) | `scalar`

关闭时的输出 — 当中继关闭时的输出值
`0` (默认) | `scalar`

输入处理 — 指定基于采样或基于帧的处理
元素作为通道(基于采样) (默认) | 列作为通道(基于帧)

启用过零检测 — 启用过零检测
`on` (默认) | `off`

采样时间(-1 表示继承) — 采样之间的时间间隔
`-1` (默认) | 标量 | 向量

输出最小值 — 范围检查的最小输出值
`[]` (默认) | 标量

输出最大值 — 范围检查的最大输出值
`[]` (默认) | 标量

输出数据类型 — 输出信号的数据类型
继承: 所有端口都具有相同数据类型 (默认) | 继承: 通过反向传播继承 | double | single | int8 | int32 | uint32 | int64 | uint64 | fixdt(1,16,2^0,0) | <数据类型表达式> | ...

锁定数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
`off` (默认) | `on`

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。