# CANUnpack

从 CAN 报文中解包单个信号

库： Sysblock / Utilities

# 描述

CAN Unpack 模块在每个时间步使用指定的输出参数将 CAN 报文解包为信号数据。数据作为单个信号输出。

# 示例

参考模型示例

CANUnpack.mo

。

# 端口

# 输入

u — CAN 报文输入

标量

此模块有一个输入端口，即 CAN Msg。该模块接收指定的输入 CAN 报文，并将其信号数据解包到单独的输出。

数据类型： CAN_MESSAGE | CAN_MESSAGE_BUS

# 输出

y — CAN 报文输出

标量

该模块默认有一个输出端口。输出端口的数量是动态的，取决于您为模块指定的要输出的信号数。例如，如果您的报文有四个信号，则该模块可以有四个输出端口。可以通过选择参数输出端口窗格中的选项添加其他输出端口。

# 参数

数据库文件 — CAN 数据库文件

单击浏览以在您的系统上找到数据库文件。数据库文件中指定的报文列表将填充对话框的报文部分。数据库文件还会填充所选报文的信号表。

包含非字母数字字符（如等号、& 符号等）的文件名不是有效的数据库文件名。在使用数据库文件之前，请重命名那些带有非字母数字字符的名称。

报文列表 — CAN 报文列表

在数据库文件字段中指定数据库文件后此选项可用。选择要在信号表中显示信号详细信息的报文。

名称 — CAN 报文名称

指定 CAN 报文的名称。默认值为 CAN Msg。当前直接从数据库文件中获取，不可编辑。

标识符类型 — CAN 标识符类型

指定 CAN 报文标识符是 Standard 还是 Extended 类型。默认值为 Standard 。标准标识符是 11 位标识符，扩展标识符是 29 位标识符。当前直接从数据库文件中继承类型，不可编辑。

CAN标识符 — CAN 报文 ID

指定 CAN 报文 ID。对于标准标识符，此数字必须是 [0, 2047] 之间的正整数。对于扩展标识符，此数字必须是 [0, 536870911] 之间的正整数。当前直接从数据库文件中获取，不可编辑。

长度 — CAN 报文长度

指定 CAN 报文的长度，范围为 0~8 个字节，默认为 8。当前直接从数据库文件中获取，不可编辑。

名称 — CAN 报文名称

指定 CAN 报文的名称。默认值为 CAN Msg。当前直接从数据库文件中获取，不可编辑。

信号— 报文参数列表

名称

为信号指定说明性名称。模块的输入端口标签会显示此名称。

开始位

指定数据的开始位。开始位是从报文数据的开头计数的最低有效位。开始位必须是 0~63 之间的整数。

长度（位）

指定信号在报文中占用的位数。长度必须是 1~64 之间的整数。

字节顺序

选择以下任一选项：

LE：字节顺序为小端 little-endian 格式。在这种格式中，从最低有效位先存储。
BE：字节顺序为大端 big-endian 格式。在这种格式中，从最高有效位先存储。

数据类型

指定信号如何解释分配的位中的数据。从下列各项中选择：

signed（默认值）
unsigned
float
double

多路复用类型

指定模块在每个时间步将信号打包到 CAN 报文中的方式：

Standard：在每个时间步都打包信号；
多路复用器：打包多路复用器信号，即模式信号。对每条报文，只能指定一个多路复用器信号。
多路复用：如果在运行时多路复用器信号（模式信号）的值与为此信号配置的多路复用值匹配，则打包信号。

例如，一条报文包含下列具有以下类型和值的信号：

信号名称	多路复用类型	多路复用值
Signal-A	标准	不适用
Signal-B	多路复用	1
Signal-C	多路复用	0
Signal-D	多路复用器	不适用

在此示例中：

模块在每个时间步中打包 Signal-A（标准信号）和 Signal-D（多路复用器信号）。
如果 Signal-D 的值在特定时间步为 1，则模块在该时间步中将 Signal-B 与 Signal-A 和 Signal-D 一起打包。
如果 Signal-D 的值在特定时间步为 0，则模块在该时间步中将 Signal-C 与 Signal-A 和 Signal-D 一起打包。
如果 Signal-D 的值不是 1 或 0，则模块不会在该时间步中打包任一复用信号。

多路复用值

仅当您选择的多路复用类型为 Multiplexed 时，此选项才可用。您提供的值必须与运行时的多路复用器信号值匹配，模块才会打包多路复用信号。多路复用值必须是正整数或零。

因子

指定将物理值（信号值）转换为报文中打包的原始值时要应用的因子值。

偏移量

指定将物理值（信号值）转换为报文中打包的原始值时要应用的偏移量值。

最小值、最大值

定义一个信号值范围。默认设置分别为 -Inf（负无穷）和 Inf。默认情况下，这些设置不会对超过设置的信号值进行裁剪。

输出标识符 — 添加 CAN ID 输出端口

选择此选项可输出 CAN 报文标识符。此端口的数据类型为 uint32。

输出时间戳 — 添加时间戳输出端口

选择此选项可输出报文时间戳。此值指示收到报文的时间。测量值为模型仿真开始以来经过的秒数。此选项会向模块添加一个新的输出端口。此端口的数据类型为 double。

输出错误 — 添加错误输出端口

选择此选项可输出报文错误状态。此选项会向模块添加一个新的输出端口。该端口上的输出值1表明传入报文是错误帧。如果输出值为 0，则没有错误。此端口的数据类型为 uint8。

输出远程 — 添加远程输出端口

选择此选项可输出报文远程帧状态。此选项会向模块添加一个新的输出端口。此端口的数据类型为 uint8。

输出长度 — 添加长度输出端口

选择此选项可输出报文的长度（以字节为单位）。此选项会向模块添加一个新的输出端口。此端口的数据类型为 uint8。

输出状态 — 添加状态输出端口

选择此选项可输出报文接收状态。如果模块接收到新报文，则状态为 1。如果没有收到，则状态为 0。此选项会向模块添加一个新的输出端口。此端口的数据类型为 uint8。

# 版本历史记录

在 2025b 之前推出

# 限制信息

CAN Unpack 模块最高支持 64 条信号数据输入。