Main Content

Data Type Conversion

将输入信号转换为指定的数据类型

  • Data Type Conversion block

库:
Simulink / Commonly Used Blocks
Simulink / Signal Attributes
HDL Coder / Commonly Used Blocks
HDL Coder / HDL Floating Point Operations
HDL Coder / Signal Attributes

描述

Data Type Conversion 模块可将任何 Simulink® 数据类型的输入信号转换为您指定的数据类型。

注意

要通过指定模块参数来控制输出数据类型,或者要从下游模块继承数据类型,请使用 Data Type Conversion 模块。要从模型中的不同信号继承数据类型,请使用 Data Type Conversion Inherited 模块。

转换定点信号

在定点数据类型之间转换时,可以通过输入和输出具有相等的参数来控制模块的行为。在以下情况下,此参数不会更改模块的行为:

  • 输入和输出没有定点数据类型。

  • 输入或输出使用具有平凡定标的定点数据类型。

有关定点数的详细信息,请参阅 Simulink 中的定点数 (Fixed-Point Designer)

要通过保留输入信号的真实值,将信号从一种数据类型转换为另一种数据类型,请选择默认值真实值(RWV)。模块会解释由输入和输出的定标施加的限制,并尝试生成具有相等真实值的输出。

要通过对存储的整数值执行定标重新解释来更改输入信号的真实值,请选择存储的整数(SI)。在转换过程中,模块将尝试在指定的数据类型范围内保留为信号存储的整数值。最佳做法是使用相同的字长和符号指定输入和输出数据类型。这样做可确保模块仅更改信号的定标。为输入和输出指定不同的符号或字长可能会产生意外的结果,例如范围丢失或意外的符号扩展。有关示例,请参阅转换 Simulink 模型中的数据类型

如果选择存储的整数(SI),则模块不会对浮点输入信号执行较低级别的位重新解释。例如,如果输入为 single 且值为 5,则内存中存储该输入的位将通过下列命令以十六进制方式给出。

num2hex(single(5))
40a00000

但是,Data Type Conversion 模块不会将存储的整数值视为 40a00000,而是视为真实值 5。转换后,输出的存储的整数值为 5

转换枚举信号

使用 Data Type Conversion 模块按如下所示转换枚举信号:

  1. 将枚举类型的信号转换为任意数值类型的信号。

    Data Type Conversion 模块的所有枚举值输入的基础整数都必须在该数值类型的范围内。否则,仿真过程中将发生错误。

  2. 将任意整数类型的信号转换为枚举类型的信号。

    Data Type Conversion 模块的值输入必须与枚举值的基础值匹配。否则,仿真过程中将发生错误。

    您可以启用对整数溢出进行饱和处理参数,这样当模块的值输入与枚举值的基础值不匹配时,Simulink 将使用枚举类型的默认值。请参阅枚举的类型转换 (Simulink Coder)

在下列情况下,您不能使用 Data Type Conversion 模块:

  • 将非整数数值信号转换为枚举信号。

  • 将复信号转换为枚举信号,而不管复信号的实部和虚部的数据类型如何。

有关使用枚举类型的信息,请参阅Simulink 枚举

示例

全部展开

此示例说明使用 Data Type Conversion 和 Data Type Conversion Inherited 模块转换模型中数据类型的三种不同方法。在此模型中,Sine Wave 模块生成输入信号。Sine Wave 模块只输出双精度数据类型,因此要生成单精度数据类型的正弦波,必须执行数据类型转换。

在第一行中,Data Type Conversion Inherited 模块使用来自 Constant 模块的数据类型(单精度)作为参考数据类型,并将正弦波转换为单精度数据类型。

在第二行中,Data Type Conversion 模块将输出数据类型设置为 single,并相应地转换正弦波。

在第三行中,Data Type Conversion1 模块的输出数据类型设置为 Inherit: Inherit via back propagation。由于下游 Gain2 模块的数据类型为单精度,因此 Data Type Conversion1 模块将正弦波转换为单精度数据类型。

端口

输入

全部展开

输入信号,指定为标量、向量、矩阵或 N 维数组。输入可以是任何实数或复数值信号。如果输入为实数,则输出也是实数。如果输入为复数,则输出也是复数。该模块将输入信号转换为您指定的输出数据类型

在转换定点数据类型时,使用输入和输出具有相等的参数确定是基于信号的真实值(RWV) 还是存储的整数(SI) 值进行转换。有关详细信息,请参阅 转换定点信号

数据类型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated

输出

全部展开

输出信号,转换为您指定的数据类型,具有与输入信号相同的维度。

数据类型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated

参数

全部展开

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

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

注意

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

编程用法

模块参数OutMin
类型:字符向量
'[ ]'| 标量
默认值'[ ]'

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

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

注意

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

编程用法

模块参数OutMax
类型:字符向量
'[ ]'| 标量
默认值'[ ]'

为输出选择数据类型。该类型可以继承、直接指定或表示为数据类型对象,如 Simulink.NumericType

编程用法

模块参数OutDataTypeStr
类型:字符向量
值:'Inherit: Inherit via back propagation' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'fixdt(1,16)' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'Enum: <class name>''<data type expression>'
默认值:'Inherit: Inherit via back propagation'

选择此参数可防止定点工具覆盖您在模块上指定的输出数据类型。有关详细信息,请参阅Use Lock Output Data Type Setting (Fixed-Point Designer)

编程用法

模块参数LockScale
类型:字符向量
值:'off' | 'on'
默认值:'off'

在定点数据表示的上下文中,指定哪种类型的输入和输出必须相等。

  • 真实值(RWV) - 指定希望输入的真实值(RWV) 等于输出的真实值(RWV)

  • 存储的整数(SI) - 指定希望输入的存储的整数(SI) 值等于输出的存储的整数(SI) 值。

编程用法

模块参数ConvertRealWorld
类型:字符向量
值:'Real World Value (RWV)' | 'Stored Integer (SI)'
默认值'Real World Value (RWV)'

选择下列舍入模式之一。

向上

将正值和负值朝正无穷方向舍入。等同于 MATLAB® ceil 函数。

收敛

将数值舍入到最邻近的可表示值。如果出现结值,则舍入到最邻近的偶数整数。等同于 Fixed-Point Designer™ convergent 函数。

向下

将正值和负值朝负无穷方向舍入。等同于 MATLAB floor 函数。

最邻近值

将数值舍入到最邻近的可表示值。如果出现结值,则朝正无穷方向舍入。等同于 Fixed-Point Designer nearest 函数。

舍入

将数值舍入到最邻近的可表示值。如果出现结值,则将正数朝正无穷方向舍入,将负数朝负无穷方向舍入。等同于 Fixed-Point Designer round 函数。

最简

自动选择是向负无穷大方向舍入还是向零舍入,以生成尽可能有效的舍入代码。

将数值向零舍入。等同于 MATLAB fix 函数。

编程用法

模块参数RndMeth
类型:字符向量
'Ceiling' | 'Convergent' | 'Floor' | 'Nearest' | 'Round' | 'Simplest' | 'Zero'
默认值'Floor'

另请参阅

有关详细信息,请参阅舍入 (Fixed-Point Designer)

指定对溢出是进行饱和处理还是绕回处理。

  • off - 溢出将绕回到数据类型可以表示的合适值。

    例如,数字 130 不适合一个有符号的 8 位整数,因此绕回 -126。

  • on - 将溢出饱和处理为数据类型能够表示的最小值或最大值。

    例如,一个有符号的 8 位整数的溢出可以饱和处理为 -128 或 127。

提示

  • 如果您的模型存在可能的溢出,而您希望在生成的代码中进行显式饱和保护,请考虑选中此复选框。

  • 如果您希望优化生成的代码的效率,请考虑清除此复选框。

    清除此复选框还可以帮助您避免过度地指定信号超出范围时的处理方式。有关详细信息,请参阅信号范围错误故障排除

  • 如果选中此复选框,饱和将应用于模块中的每个内部操作,而不仅仅应用于输出或结果。

  • 一般情况下,代码生成进程可以检测到何时不可能发生溢出。在这种情况下,代码生成器不会生成饱和代码。

编程用法

模块参数SaturateOnIntegerOverflow
类型:字符向量
值:'off' | 'on'
默认值:'off'

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

依存关系

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

编程用法

模块参数:SampleTime
类型:字符串标量或字符向量
默认值:"-1"

选择要指定的数据类别。

  • 继承 - 数据类型的继承规则。选择 Inherit 将在右侧启用另一个菜单/文本框,您可以在其中选择继承模式。

  • 内置 - 内置数据类型。选择 Built in 将在右侧启用另一个菜单/文本框,您可以在其中选择内置数据类型。

  • 定点 - 定点数据类型。选择定点将启用可用于指定定点数据类型的其他参数。

  • 表达式 - 计算结果为数据类型的表达式。选择 Expression 将在右侧启用另一个菜单/文本框,您可以在其中输入表达式。

有关详细信息,请参阅使用数据类型助手指定数据类型

依存关系

要启用此参数,请点击显示数据类型助手按钮。

为此信号选择数据类型覆盖模式。

  • 当您选择 inherit 时,Simulink 从信号的上下文(即:从 Simulink 中使用该信号的模块、Simulink.Signal 对象或 Stateflow® 图)中继承数据类型覆盖设置。

  • 当您选择 off 时,Simulink 忽略信号上下文的数据类型覆盖设置,并使用为信号指定的定点数据类型。

有关详细信息,请参阅 Simulink 文档中的使用数据类型助手指定数据类型

依存关系

要启用此参数,请将模式设置为内置定点

提示

由于能够关闭单个数据类型的数据类型覆盖,您可以在应用数据类型覆盖时更好地控制模型中的数据类型。例如,您可以使用此选项确保数据类型满足下游模块的要求,而忽略数据类型覆盖设置。

指定定点数据是有符号还是无符号。有符号数据可以表示正值和负值,无符号数据只表示正值。

  • 有符号,将定点数据指定为有符号数据。

  • 无符号,将定点数据指定为无符号数据。

有关详细信息,请参阅使用数据类型助手指定数据类型

依存关系

要启用此参数,请将模式设置为 Fixed point

指定定点数据的定标方法,以避免发生溢出情况并最大限度地减少量化错误。有关详细信息,请参阅指定定点数据类型

依存关系

要启用此参数,请将模式设置为定点

指定存储量化整数的字的位大小。有关详细信息,请参阅指定定点数据类型

依存关系

要启用此参数,请将模式设置为定点

将定点数据类型的小数长度指定为正整数或负整数。有关详细信息,请参阅指定定点数据类型

依存关系

要启用此参数,请将定标设置为二进制小数点

指定定点数据类型的斜率。有关详细信息,请参阅指定定点数据类型

依存关系

要启用此参数,请将定标设置为斜率和偏置

将定点数据类型的偏置指定为任意实数。有关详细信息,请参阅指定定点数据类型

依存关系

要启用此参数,请将定标设置为斜率和偏置

模块特性

数据类型

Boolean | double | enumerated | fixed point | half | integer | single

直接馈通

多维信号

可变大小信号

过零检测

扩展功能

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

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

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

版本历史记录

在 R2006a 之前推出