支持的文件格式¶
目前,ecu.test 在 Trace Analysis(测量轨迹分析 / 后处理)中支持以下文件格式:
格式 |
文件扩展名 |
版本 |
制造商 |
软件产品(节选) |
|---|---|---|---|---|
.astrace |
||||
.as3trace |
||||
.asc |
||||
.wav, .flac, .mp3, .ogg |
||||
.blf |
||||
.erg, .erg.info |
||||
.csv |
||||
.dlt |
||||
.hdf5 |
5.0, 5.1 |
|||
none |
3, 4 |
GL 系列数据记录仪 |
||
.mat |
Level 5 MAT-File Format |
|||
.mat |
||||
.mat |
||||
.dat |
2.0, 3.0, 3.1, 3.2, 3.3 |
|||
.dat |
||||
.dat |
||||
.mdf |
||||
.mdf |
||||
.mdf |
||||
.mf4 |
4.0, 4.1, 4.2, 4.3* |
|||
.mf4 |
||||
.osi, .osi.info .txt, .txt.info |
||||
.parquet, .pqt |
||||
.pcap, .pcapng |
||||
.zip |
4, 5, 6, 7, 8, 9 |
|||
.rdb |
||||
.sti, .stz |
2.0.1 |
|||
.tdms |
||||
.ttl |
||||
.avi, .mp4, .mkv, .mts, .wmv |
Generic support via OpenCV |
以下章节详细介绍受支持的格式。对于每种格式,Parser parameterization 小节会说明设备名称的含义以及格式细节。如果 Recording 是在 test case 执行期间完成的,ecu.test 会自动设置这些信息。因此,只有在将 Recording 手动添加到 trace analysis 时(例如通过 test step Add trace),才需要考虑它们。
ASC, BLF¶
- 支持的总线系统
ecu.test 支持 CAN、FlexRay、CAN FD、LIN 和 Ethernet(仅 BLF)总线系统。
此外,还支持通过 DIAG-SERVICE 量提取并解释诊断报文(当前仅支持 CAN (FD))。 值结构请参见 Diagnostics related objects of trace analysis(Trace Analysis 诊断相关对象)。
- 选定的帧
对于 CAN,会读取格式规范中定义的 CAN (Extended) Message Event 和 CAN Error Frame 结果,其他帧均不处理。
对于带 FlexRay 的 ASC 和 BLF,支持所谓的 FlexRay Message Event,包括“旧”格式和“新”格式(CANoe/CANalyzer 自 5.2.26 版起)。 空帧始终会计入 MessageEvent 信号以及已弃用的 Frame 信号。
与 CAN 完全类似,也可以分析 CAN FD 报文。会读取格式规范中定义的 CAN FD (Extended) Message Event、用于 ASC 的 CAN FD Error Frame 以及 CAN FD Message 64, 其他帧均不予考虑。
可以分析 LIN 报文。会读取格式规范中定义的 LIN Message Event、LIN Sleep Mode Event、 LIN Wakeup Frame 和 LIN Unexpected Wakeup 事件, 其他帧均不予考虑。对于 BLF,请注意,不支持来自 CANoe/CANalyzer 6.0 及更早版本的过时 LIN 记录。
- 仅 BLF
可从 BLF Trace 中读取 Ethernet 报文。支持格式规范中定义的 Ethernet Packet。 基于服务的通信数值也可以通过与 PCAP format(PCAP 格式) 类似的方式访问。
- 多路复用
支持 CAN 和 FlexRay 的帧多路复用。这意味着根据 Multiplex ID(位于 FramePayloads 的固定位置,且不会作为伪信号提供),同一 FrameID 的不同帧中可能包含不同信号。ecu.test 可借助指定的 Signal database(信号数据库) 自动识别哪些信号采用了这种多路复用方式。
- 伪信号
对于 ASC 和 BLF 文件格式,ecu.test 除实际总线信号外,还提供用于分析的伪信号(位于相应文件的 Trace files 选项卡下的 Signals 中)。伪信号可在无需加载 Signal database(信号数据库) 的情况下访问文件原始数据。如果已加载信号数据库,ecu.test 还可以利用 BUS 选项卡中列出的元素,从原始数据中提取具体信号并在 Trace Analysis 中提供。
说明
这些伪信号基于 ASC 和 BLF 的格式规范,提供直接来自原始数据的内容。数据不会被进一步解释处理(即 ecu.test 不会计算总线统计信息)。
说明
BLF 中的 Ethernet 伪信号也像 PCAP 一样支持访问更高层协议。详见 PCAP Pseudo signals(PCAP 伪信号)。
根据读取的介质不同,可用的伪信号也不同:
信号
说明
CAN
CANFD
FlexRay
LIN
Ethernet
数据类型
MessageEvent
所有类型的帧(例如 Error Frame 和 CAN Remote Frame)。
+
+
+
+
-
ErrorEvent
仅 ASC。由总线硬件记录的错误条目。
+
+
+
-
-
BusStatisticsEvent
仅 ASC。帧统计和总线负载统计。
+
+
-
-
-
OverloadFrameEvent
仅 ASC。总线节点过载。
+
+
-
-
-
StartCycleEvent
仅 ASC。FlexRay 周期开始。
-
-
+
-
-
StatusEvent
仅 ASC。FlexRay 状态条目。
-
-
+
-
-
SleepModeEvent
初始状态或休眠模式变化。
-
-
-
+
-
WakeupFrame
唤醒请求。
-
-
-
+
-
UnexpectedWakeup
CANoe/CANanlyzer 在唤醒模式的总线空闲阶段检测到意外字节,该字节可能是唤醒帧。
-
-
-
+
-
J1939Message
需要 ecu.test diagnostics。J1939 报文。
+
-
-
-
-
J1939DTCList
需要 ecu.test diagnostics。J1939 诊断故障码列表。
+
-
-
-
-
UdsMessage
需要 ecu.test diagnostics。Unified Diagnostics Services (UDS) 报文。
+
+
-
-
-
FrameID
已弃用。如果出现 FlexRay Error Frame,也会输出该信号。
+
+
+
+
-
Integer
FramePayload
已弃用。如果出现 FlexRay Error Frame,也会输出该信号。
+
+
+
+
-
String
FrameLength
已弃用。如果出现 FlexRay Error Frame,也会输出该信号。
+
+
+
+
-
Integer
FrameCycle
已弃用。如果出现 FlexRay Error Frame,也会输出该信号。
-
-
+
-
-
Integer
ErrorFrame
已弃用。如果发生 Error Frame,则会生成一个值为 1 的样本。
+
+
+
-
-
Integer
ErrorFrameECC
已弃用。类似于 “ErrorFrame”。如果可用,则包含 ECC 寄存器的值,否则为 0。
+
+
+
-
-
Integer
PacketEthernet
仅 BLF。Recording 中任意一个 Ethernet 帧。
-
-
-
-
+
PacketIp
仅 BLF。协议类型为 IP 的 Ethernet 帧,不自动检测 IP 分片。
-
-
-
-
+
PacketIcmp
仅 BLF。协议类型为 ICMP 的 IP 数据包。
-
-
-
-
+
PacketTcp
仅 BLF。协议类型为 TCP 的 IP 数据包,不支持 TCP 重组。
-
-
-
-
+
PacketUdp
仅 BLF。协议类型为 UDP 的 IP 数据包。
-
-
-
-
+
PacketSomeIp
仅 BLF。源端口或目标端口为 30490 的 TCP 或 UDP 数据包会被解释为 SOME/IP 数据包。
-
-
-
-
+
PacketSomeIpSd
仅 BLF。消息 ID 为 0xFFFF8100 的 SOME/IP 数据包。
-
-
-
-
+
PTP/PacketPtpSync
仅 BLF。协议类型为 PTP 且 PTP 消息类型为 Sync 的 Ethernet 帧。
-
-
-
-
+
PTP/PacketPtpFollowUp
仅 BLF。协议类型为 PTP 且 PTP 消息类型为 Follow_Up 的 Ethernet 帧。
-
-
-
-
+
PTP/PacketPdelayReq
仅 BLF。协议类型为 PTP 且 PTP 消息类型为 Pdelay_Req 的 Ethernet 帧。
-
-
-
-
+
PTP/PacketPdelayResp
仅 BLF。协议类型为 PTP 且 PTP 消息类型为 Pdelay_Resp 的 Ethernet 帧。
-
-
-
-
+
PTP/PacketPdelayRespFollowUp
仅 BLF。协议类型为 PTP 且 PTP 消息类型为 Pdelay_Resp_Follow_UP 的 Ethernet 帧。
-
-
-
-
+
说明
使用 ErrorFrame 时请注意:默认情况下,FrameID、FramePayload、FrameLength 和 FrameCycle 只考虑有效报文。 但如果同时读取 ErrorFrame,被标记为错误帧的报文也会被纳入,并为 FrameID、FramePayload、FrameLength 和 FrameCycle 增加样本。 因此在 Trace Analysis 中,可能需要确保只分析有效报文的样本(增加对 ErrorFrame 的检查)。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情可作为过滤条件,仅读取 Trace 中特定的帧。
- 结构:
%Medium%_%Channel%_%Direction%[_%OptionalParameters%](ASC) resp.%Medium%_%Channel%_%Direction%_%Port%[_%OptionalParameters%](BLF)- Medium
要过滤的总线。
可选值:
AUTO .. 在 ASC 中评估第一帧,并将对应的 BUS 设置为介质。(如果第一帧的类型是 “CANFD”,则将 “CAN” 设置为 介质,以支持混合 Recording。)
CAN ..
BLF 格式:同时读取 CAN 和 CAN FD 的帧。
ASC 格式:如果为 Channel 指定值 ALL, 则同时读取 CAN 和 CAN FD 的报文。否则会自动确定在指定通道上记录的是 CAN 还是 CAN FD。 只读取匹配的条目。
CANFD .. 仅读取 CAN FD 的帧(仅 ASC 格式)。
FlexRay .. 仅读取 FlexRay 的帧。
LIN .. 仅读取 LIN 的帧。
Ethernet .. 仅读取 Ethernet 的帧(仅 BLF 格式)。
- Channel
仅读取此通道中的帧。
可选值:
%Number% .. 通道编号。CAN 的有效值为 1-99;LIN 的有效值为 1-64。
ALL .. 读取所有通道的帧,并将其视为一条单独的 Trace。 仅应在 ASC 中确实只存在一个通道时使用。
- Direction
仅读取朝特定方向发送的帧。
可选值:
Rx .. 仅读取接收帧。
Tx .. 仅读取发送帧。
RxTx .. 同时读取接收帧和发送帧。
- Port
指定传输 SOME/IP 服务发现控制数据流的 UDP 端口。 一方面,事件发送方可通过服务数据库(Fibex)中配置的 IP 地址、传输协议和端口来识别。在这种情况下,不会考虑此处指定的端口。 另一方面,也可以通过动态分析控制数据流 (SOME/IP 服务发现)来确定事件发送方。在这种情况下, 会考虑此处指定的端口。
- Optional parameters
可选参数列表(方括号表示“可选”,无需输入)。 参数之间必须使用
_分隔。可选参数:
idMask=%HexadezimaleZahl% .. 用于 CAN-ID 的掩码, 可忽略 CAN-ID 的某些位。
j1939mode .. 如果设置了此标志,且未显式设置
idMask,则应用idMask=0x3ffffff。
- 默认值:
AUTO_ALL_RxTx(ASC) resp.AUTO_ALL_RxTx_30490(BLF)
ASTRACE¶
- 文件类型:
该解析器支持所有类型的 ASTRACE 文件,即:
由 Trace Analysis(测量轨迹分析 / 后处理)生成、用于集成 trace.xplorer 的文件
使用 auto.spy analyzer 记录的文件
- 信号类型:
该解析器支持所有可存储在 ASTRACE 文件中的信号类型,包括视频信号。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
AS3TRACE¶
- 文件类型:
该解析器支持所有类型的 AS3TRACE 文件,即:
由 Trace Analysis(测量轨迹分析 / 后处理)生成、用于集成 trace.xplorer 的文件
使用 ecu.test 通过工具 FEP 记录的文件
使用 auto.spy analyzer 记录的文件
- 信号类型:
该解析器支持所有可存储在 AS3TRACE 文件中的信号类型,包括视频信号。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
CSV¶
- 信号类型
支持以下信号类型:
Interpreted (Number)
信号值会转换为浮点数
转换失败会导致错误
Raw value
信号值会转换为 Unicode
Interpreted (String)
信号值会转换为 Unicode
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情包含 CSV 结构信息。解析器需要这些信息才能正确读取文件。
- 结构:
该字符串由一个或多个关键字-值对组成,顺序无关。 关键字-值对的格式如下:
%Keyword%: '%Value%'注意:无论值是字符、字符串还是数字,都必须始终用单引号括起来。 可指定以下关键字:
- columnSeparator
用于分隔各列的字符。若要使用制表符作为分隔符,请将
-->作为值。默认配置:
;- decimalSeparator
用于分隔浮点数整数位和小数位的字符。
默认配置:
.- thousandSeparator
数字分组符号。
默认配置:
,- headLineNumber
包含列标题的行号(从 0 开始计数)。
如果将值指定为 -1,则表示不存在标题行。因此文件的第一行已经是数据行。
如果指定的值大于 0,则会忽略第 0 行到 headLineNumber -1 行。
默认配置:
0- timeColumn
包含 Recording 时间戳的列。
如果该值是数字,则表示列号(从 0 开始计数)。
如果该值是字符串,则表示列标题。
默认配置:
0
- 默认值:
columnSeparator: ';', decimalSeparator: '.', thousandSeparator: ',', headLineNumber: '0', timeColumn: '0'`
DLT¶
- 概述
DLT(AUTOSAR 标准 “Diagnostic Log and Trace”)文件(.dlt)包含记录下来的 DLT 消息。 DLT 区分 verbose 和 non-verbose 消息。 Verbose 消息包含解释其内容所需的全部信息。它们包含所谓的参数,这些参数可通过名称或索引访问。 要解释 non-verbose 消息的内容,则需要一个外部数据库,这一点与总线通信类似。
要读取 DLT,必须在测试配置中创建一个控制单元。 尤其需要填写 “Logging” 区域。 各字段的更详细说明可在其工具提示中查看。
- Non-verbose DLT
读取 non-verbose DLT 需要 DLT-FIBEX 数据库。但其结构与常规 FIBEX 不同。 另请参见 AUTOSAR Log and Trace Protocol Specification,Release 1.5.1,第 27 页。 数据库的文件路径必须保存在测试配置中。
启动配置后,可用信号会列在 Logging 选项卡中, 并可通过拖放到 Signal recordings 选项卡的方式提供给测量轨迹分析使用。
- Verbose DLT
读取 verbose DLT 需要 DLT 过滤文件(.dlf)。过滤文件路径 必须保存在测试配置中。目前需要通过 DLT Viewer (GitHub) 创建该文件。
启动配置后,会基于过滤文件中的过滤条件提供所谓的“过滤后的 logging 消息”, 这些消息可以像信号一样读取。 读取到的值类型为 DltMessage。
目前,ecu.test 支持 DLT 标准版本 1。为了确保与 DLT Viewer 及其过滤机制的最佳兼容性,同时也支持 DLT 标准版本 2 中的 Type Format (TYFM) 字段。
- 伪信号
为了通用访问 DLT 消息,提供了一个名为 DltMessage 的信号。 与 verbose DLT 类似,该信号的值类型同样为 DltMessage。 但需要注意,这些消息是未经过滤直接读取的。 因此,verbose 和 non-verbose 消息会同时被读取。 在测量轨迹分析中,必须手动区分这两类消息。 例如,可通过检查属性 .verbose 来区分 verbose/non-verbose。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
- 时间戳排序
对于时间轴不严格单调递增的 Recording,可使用以下 Workspace 设置: ETHERNET, DLT: Sort timestamps via moving window(ETHERNET、DLT:通过移动窗口排序时间戳)
ECAL¶
- 概述
eCal Recording 以 HDF5 格式存储,并包含使用 Protobuf 序列化的任意数据结构。 ecu.test 会将这些部分嵌套的数据结构分解为其基本组成部分,并提供给分析使用。 要进行解析,至少需要安装 5.0 版本的 eCAL framework。 由于可用信号可能随时间变化,首次使用时会解析整个 Recording,以提取其中存在的全部信号。 根据 Recording 大小,此过程可能需要一些时间。随后获取到的元数据会写入同目录下的 .info 文件中, 供后续分析使用。
- 信号类型
支持以下信号类型:
Interpreted (Number)
支持 Protobuf 的所有常见基础数据类型,包括整数、浮点数和 long。
此外还可原生使用布尔值。
Interpreted (String)
根据信号的 Protobuf 定义,可将其作为 Unicode 字符串或字节串使用。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
ERG¶
进行测量轨迹分析需要两个不同的文件。*.erg 文件包含 Recording 数据,*.erg.info 文件
包含信号描述。两个文件必须具有相同的基本文件名。Recording 必须包含信号(Quantity)“Time”。
- 信号类型
支持以下信号类型:
Raw value
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
GIN¶
- 概述
ecu.test 支持 G.i.N. 数据记录仪直接生成的原始数据格式。 包含各个环形缓冲区数据目录(例如 !D1FX)以及附加 Ethernet logger(参数化为 ‘logger’)的根目录, 会作为一个单独的 GIN Recording 提供。 为了被识别为单个 GIN Recording,根目录中必须包含 GiN 配置文件 ‘ml_rt.ini’ 和 ‘ml_rt2.ini’。
支持经典总线的原始数据,以及包含 Ethernet 流量数据的 .gfj 文件。
警告
.clf 文件由 Logger RAW File Decoder 从原始文件生成,但不受支持!
- 支持的现场总线系统
ecu.test 支持 CAN (FD)、LIN、FlexRay 和 Ethernet 总线系统。与 PCAP 等其他 格式类似,也支持提取多种协议。
此外,还支持通过 DIAG-SERVICE 量提取并解释诊断消息(当前仅支持 CAN (FD))。 值结构请参见 Diagnostics related objects of trace analysis(Trace Analysis 诊断相关对象)。
警告
根据诊断数据库的结构方式不同,该信号可能包含额外样本,这些消息实际上并不属于所选服务。 在这种情况下,建议在测量轨迹分析中基于原始数据再增加额外过滤。
- 伪信号
通过所谓的伪信号,可以直接在协议层访问原始数据。 这使得无需总线数据库也能访问总线消息。
信号
说明
CAN (FD)
FlexRay
LIN
数据类型
MessageEvent
所有类型的帧(例如 Error Frame 和 CAN Remote Frame)。
+
+
+
UdsMessage
需要 ecu.test diagnostics。Unified Diagnostics Services (UDS) 消息。
+
-
-
FrameID
已弃用。对于错误帧也会输出该信号。
+
+
+
Integer
FramePayload
已弃用。对于错误帧也会输出该信号。
+
+
+
String
FrameLength
已弃用。对于错误帧也会输出该信号。
+
+
+
Integer
FrameCycle
已弃用。对于错误帧也会输出该信号。
-
+
-
Integer
ErrorFrame
已弃用。如果发生错误帧,则会生成一个值为 1 的样本。
+
+
-
Integer
PacketEthernet
更多 Ethernet 伪信号请参见 PCAP Pseudosignals(PCAP 伪信号)
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情作为过滤条件,用于仅读取 Trace 中特定的帧。
- 结构:
%Medium%_%Logger%:%Channel%_%Direction%- Medium
要过滤的总线。
可选值:
CAN .. 同时读取 CAN 和 CAN FD 的帧。
LIN .. 仅读取 LIN 的帧。
FlexRay .. 仅读取 FlexRay 的帧。
Ethernet .. 仅读取 Ethernet 的帧。
- Logger
要解析其数据的 logger,在文件和目录名称中以索引 m 表示, 例如 ‘!D*m*FX’。
- 可选值:
%String% .. logger 0(trip odometer)、1、2、3、E1、E2 或 E3
- Channel
仅读取该 logical 通道中的帧。该 logical 通道会根据 ‘ml_rt2.ini’ 中定义的配置(例如 CAN Mapping)转换为内部通道。
可选值:
%String% .. 通道编号。对于 FlexRay,可为 1A、1B、2A 或 2B。
- Direction
仅读取发送方向符合要求的帧。
可选值:
Rx .. 仅读取接收帧。
Tx .. 仅读取发送帧。
RxTx .. 同时读取接收帧和发送帧。
- 默认值:
CAN_1:1_RxTx
MDF (version 2.x, 3.x)¶
Note
目前仅最低限度地支持 MDF 4.3。 当前仅涵盖读取包含 ZSTD 压缩 DZ 块的 MDF4 文件。 目前不保证对更多 MDF 4.3 特定扩展的全面支持。
- 已读取的块
对于 MDF 格式,ecu.test 会读取格式规范中定义的 IDBLOCK、 HDBLOCK、TXBLOCK、DGBLOCK、CGBLOCK、CNBLOCK、CCBLOCK、CDBLOCK 和 CEBLOCK。
- 解释值
CCBLOCK(Channel Conversion Block)定义了多种转换公式,用于将读取到的原始值转换为物理值。目前支持以下转换公式:
参数型、线性
带插值的表格型
表格型
带 6 个参数的多项式函数
指数函数
对数函数
有理转换公式
文本转换公式(例如 ASAM MCD-2 MC V1.6.0 文本公式)
表格型(文本)
表格型(区间)
1:1 转换
- 不支持的信号类型
对于 INCA 创建的 MDF 文件(文件扩展名 .dat),不支持 curve 和 map 类型的信号。
- INCA Recording 中特征量的特殊情况
使用 INCA 记录 MDF3 文件时,测量变量和标定变量默认存储在同一个 device 下。 测量变量按一定采样率采样,而标定变量按事件记录: 只有当标定变量的值发生变化时,才会向 Recording 文件写入一个采样点 (另外在 Recording 开始和结束时也会额外写入)。
但如果启用了 “Capture calibration variables as measurements” 选项, 标定变量会像测量变量一样按一定采样率采样。 不过,作为测量量记录的标定变量在 Recording 中将不再位于与测量变量相同的 device 下: 例如,如果测量变量存储在 device “CCP:1” 下,则作为测量量记录的标定变量会存储在 device “CCP:1#MeasureCal” 下。 同一个 Recording 甚至可能在这两个 device 下同时包含同一个标定变量 (一次按事件记录,一次按固定采样率记录)。
尽管 device 不同,将 INCA MDF3 Recording 添加到 Package 时, 通常只需要一个信号组或 Recording 组。 绝不应使用 MeasureCal device,因为无论指定哪个 device, ecu.test 都会始终通过 MeasureCal device 访问标定变量; 但如果显式指定该 device,则无法解析测量变量。
- 解析器参数化
- 设备名称
- 用途:
必填。用于从文件中选择特定 device,并据此过滤信号。 如果还要读取其他 device 的信号,则必须以相同方式将该 Recording 分配到另一个 Recording 组。
- 格式详情(参见 Management of signals(信号管理))
- 用途:
仅适用于 ControlDesk 的多处理器 Recording,且 device name 传入 “multiprocessor” 时: 用于将文件中的 device name 映射到测试配置中的 device name。
- 结构:
平台-设备对,格式为
%Platform1%=%Device1%##%Platform2%=%Device2%...- 示例:
Platform=Master##Platform_2=Slave
MDF4¶
- 基础特性
MDF 规范:4.2.0
可通用读取 “Trace files”“Bus access”“Measurement”“Calibration”“Model” 和 “Service” 选项卡中的信号
可从文件中读取信号名称和信号源名称(不支持的信号,见下文,不会由 ecu.test 显示)
可提取信号数据的 raw value 和 interpreted value(见下文)
支持读取压缩的信号数据
支持读取有序和无序的 MDF4 文件
支持读取 bus logging Trace 中的数据,并借助总线数据库提取信号
失效位:如果该位被置位,则忽略该信号值
通过 “Event” 块提供伪信号(见下文)
- 部分支持
MDF 4.2.0 的新特性尚未完全支持。当前仍待补充的重要特性包括:
数据类型 “complex number”
带 “event signals” 的 event 块扩展
转换规则 “bitfield text table”
数组(依据 MDF4 规范 “CN template”):
不带轴的简单数组:
对于通过 Generic XIL-API 接口的 Model 或 Application 端口生成的 Recording,会考虑测试台架配置中的 “Adapt matrix layout” 选项。这样可以确保即使记录工具内部使用 [Row][Column],ecu.test 在 test case 和测量轨迹分析中仍一致使用 [Column][Row] 的矩阵寻址方式。
带轴的数组:
不支持:
超过二维的数组
带 “complex axes” 的数组(轴上还有轴) -> 会导致运行时错误
轴会变化且缺少时间戳的 Map/Curve -> 会导致运行时错误
带有/位于 “Nested Compositions”(结构体/数组嵌套组合)中的信号
叶子元素可以按常规方式读取。
也可以读取顶层结构节点。此时会创建结构化信号。 在测量轨迹分析中,可借助属性访问其子元素。 例如在计算步骤中:MyStructuredSignal.subSignal > 5。
- 不支持
没有时间轴的信号
符合 MDF4 规范 “CG-Template” 和 “DG-Template” 的数组
来自附件的信号(MDF4 规范:“synchronization channel”)
数据类型为 “MIME sample/stream” 的信号
- 未使用的文件内容
ecu.test 会忽略以下 MDF 文件内容:
头块的元数据
“Channel Hierarchy” 块
“Attachment” 块
“Sample Reduction” 块和 “Reduction Data” 块
CA 块中的 “Input/output/comparison channels”
- 伪信号
目前 MDF4 文件支持两种不同类型的伪信号。
第一类伪信号直接位于文件级别,其值来自 MDF4 文件中的所谓 event 块:
伪信号 Events.isRecording
会基于用于记录控制(开始/停止记录)的 “event” 块构建伪信号 “isRecording”: 当 Recording 处于活动状态时其值为 1,处于暂停状态时其值为 0。 因此,在测量轨迹分析中可借助触发块将检查限制在 Recording 处于活动状态的时间区间内。
即使不存在用于记录控制的 “event” 块,也会利用元数据在第一个时间戳处创建值为 1 的 “isRecording” 信号。
大多数工具在使用 start/stop trace test step 时会生成多个 Recording 文件。 每个 Recording 文件都会单独执行一次测量轨迹分析。使用 INCA 进行 Trace 记录时属于特殊情况。 如果记录为 MDF3 格式,则会在一个文件中创建多个 Recording,因此会执行多次测量轨迹分析。 而在 MDF4 中,这一行为会发生变化。 在 MDF4 中,只有一个带暂停区间的 Recording。
说明
对于 INCA Recording,建议使用 “isRecording” 信号过滤记录暂停区间。
伪信号 Events.Marker
每个时间戳对应一个对象,该对象要么是一个点,要么定义一个区间的起点或终点。 可通过属性 isPoint, isRangeStart, isRangeStop 进行区分。
还可以通过属性 name 和 comment 访问更多信息。 如果某个 marker 是通过 XIL-API 设置的,则可使用属性 xilId。
也可以将单个属性直接作为信号访问,例如 “Marker.name”。
第二类是用于 bus logging 的伪信号,可用于访问特定协议层的报文。 为 Ethernet 提供的伪信号支持访问 Ethernet 协议栈上层信息,例如 PacketSomeIp.udp.srcPort。 关于各个信号和协议层的更多细节,请参见 PCAP format(PCAP 格式) 章节。 针对 CAN 提供的伪信号有 J1939Message 和 J1939DTCList,用于支持 J1939 诊断协议。
说明
J1939 需要许可证选项 ecu.test diagnostics!
- Bus logging
MDF4 标准允许存储未解释的总线通信报文。 ecu.test 不仅能够读取这些报文,还能基于总线数据库提取信号值。
支持:CAN(-FD)、FlexRay、LIN、Ethernet
MDF 标准为 bus logging 数据提供了三种存储方式:未过滤的 <NONE>、按总线通道组织的 <BUS>,以及基于 ID(按报文)的 <ID>。 目前支持 <BUS> 和 <NONE> 模式;在 <NONE> 模式下,device 分配必须扩展为带通道号的具体总线,例如 “CAN2”(而不是 “CAN”)。
对于不符合标准、时间轴并非严格单调递增的 Ethernet bus logging,可使用以下 Workspace 设置: ETHERNET: Sort timestamps via moving window
Ethernet bus logging 支持以下协议:
SOME/IP
DLT Verbose 和 Non-Verbose(必须在格式详情中设置 device name)
带 MACsec 的 SocketAdaptor 帧
- INCA Recording 中特征量的特殊情况
使用 INCA 记录 MDF4 文件时,标定变量默认存储在 device “EtasCalibrationRecordingDevice” 下(而测量变量存储在用户所选的 device 下)。 测量变量按一定采样率记录,而标定变量按事件记录: 只有当标定变量的值发生变化时,才会向 Recording 文件写入一个采样点 (另外在记录开始和结束时也会写入)。
但如果启用了 “Capture calibration variables as measurements” 选项, 标定变量会像测量变量一样按一定采样率采样。 不过,作为测量量记录的标定变量将不再存储在 Recording 中的 “EtasCalibrationRecordingDevice” 下: 例如,如果测量变量存储在 device “CCP:1” 下,则作为测量量记录的 标定变量将存储在 device “CCP:1#MeasureCal” 下。 一个 Recording 甚至可能在这两个 device 下同时包含同一个标定变量 (一次按事件记录,一次按固定采样率记录)。
尽管 device 不同,将 INCA MDF4 Recording 添加到 Package 时通常只需要 一个信号组或 Recording 组。 对于该组,格式详情应指向测量变量所在的 device, 因为 ecu.test 会优先在 MeasureCal device 中查找标定变量, 并以 “EtasCalibrationRecordingDevice” 作为回退选项。
不过,如果在 FormatDetails 中使用 “EtasCalibrationRecordingDevice”, 则即使文件中也存在该标定变量的固定采样率记录, 仍可以显式访问该标定变量的按事件记录版本。 但在这种情况下必须注意,测量变量和标定变量必须放在不同的信号组或 Recording 组中。
- ControlDesk Recording 中总线信号的特殊点
通过总线端口,ecu.test 也可以记录来源于模型的总线信号。为了正确解析模型路径,需要使用总线端口的一些参数。
为了从生成的 Recording 中读取此类总线信号,ecu.test 会创建一个所谓的 sidecar 文件 (.recsf)。该文件包含从总线路径到信号模型路径的映射。如果此文件不存在,则无法从 Recording 中读取总线信号。
- 通过 AUTOSAR Socket Adaptor 进行总线测量
-
说明
如果存在多个系统标识符,则必须为每个系统标识符分别创建一个 Recording 组。
说明
当前存在以下限制:
仅支持通过 UDP 在 IPv6 上传输的报文。
不支持 IP 分片。
- 解析器参数化
- 设备名称
- 用途:
可选。用于从文件中选择特定 device,并据此过滤信号。 通常传入 格式详情 就足以完成文件中 device name 与测试配置中 device name 之间的映射。
- 格式详情(参见 Management of signals(信号管理))
- 用途:
用于将文件中的 device name(工具中的命名)映射到测试配置中的 device name(ecu.test 中的命名)。
- 结构:
设备-设备对,格式为
%Device in file 1%=%Device1%##%Device in file 2%=%Device2%...- 示例:
CAN-Monitoring:1=A-CAN##XCP:1=DME1_DDE1- 示例:
Platform=Master##Platform_2=Slave
MAT¶
- 结构
由 MATLAB/Simulink、ecu.test 和 trace.check 写入的文件具有以下内部结构:
MAT 文件格式 5
Struct.Header.time = [0]
Struct.Header.signal = [1]
Struct.Data = [timeDataVector; signalDataVector]
由 ControlDesk 创建的文件内部结构说明请参见相应的用户手册。
- 解析器参数化
- 设备名称
- 用途:
可选。仅用于 ControlDesk 的 MAT 文件,用于从文件中选择特定设备。 信号会据此进行过滤。如果还要读取其他设备的信号,则必须将 Recording 以同样方式分配到另一个 recording group。
- 格式详情(参见 Management of signals(信号管理))
- 用途:
仅用于 ControlDesk 的多处理器 Recording,且设备名称传入 “multiprocessor” 时: 将文件中的设备名称映射到测试配置中的设备名称。
- 结构:
平台-设备对,格式为
%Platform1%=%Device1%##%Platform2%=%Device2%...- 示例:
Platform=Master##Platform_2=Slave
OSI¶
进行测量轨迹分析需要两个文件。*.osi 或 *.txt 文件包含 Recording 数据,
*.osi.info 或 *.txt.info 文件包含用于确定 OSI Recording 类型的关联元数据。
两个文件的文件名前缀必须相同。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
PARQUET¶
- 概述
Apache Parquet 是一种开源、面向列的数据文件格式,主要用于 Big Data 领域。 默认情况下,其中包含的列会作为信号提供。
ecu.test 提供了多个选项,可用于基于 parquet 格式实现更复杂的使用场景。
不支持分区 parquet 文件,即通过文件夹结构对恒定列值进行建模的 parquet 文件。
- 时间轴
可配置用作时间轴的列。 此外,还可以指定时间戳的存储单位。读取时间戳时,会自动将其转换为秒, 以确保时间轴与其他文件格式中的信号兼容。 另外,也可以选择对时间戳进行归一化,使相对时间戳从 0.0 开始。
- 拆分 parquet 文件
支持按时间轴拆分为多个分片的 parquet 文件。只需将其中一个分片添加到信号记录中即可。同一目录下符合以下命名方案的所有其余 parquet 文件会合并为一个数据集:
part-<number>-<basename>.<file extension>number 字段应从零开始,并且所有文件名的位数必须相同。示例: - part-000-myfile.parquet - part-001-myfile.parquet
- Eventlog 模式
通常,parquet 文件按表格形式组织。每一列代表一个信号,每一行代表一个时间点。 而在 eventlog 模式下,假定所有信号交错存储在单个值列中。 使用一个或多个键列来确定当前值列中的值所属的信号标识符。 在 ecu.test 中提供的信号通过将键列值使用
/拼接而成。对于拆分 parquet 文件,只会使用作为代理的那个文件来确定可用信号。
以下示例使用
"keyColumns":["ecu", "name"]和"valueColumn": "value", 生成信号ECU1/Sig1(值 42、45)和ECU2/Sig1(值 -13):parquet 文件中的原始数据¶ time
ecu
name
value
0.0
ECU1
Sig1
42
1.0
ECU2
Sig1
-13
2.0
ECU1
Sig1
45
通过 Eventlog 模式解释后的数据¶ time
ECU1/Sig1
ECU2/Sig1
0.0
42
1.0
-13
2.0
45
- JSON 结构
Parquet 本身通常不支持复杂数据类型。 不过,可以将结构化信号值存储为 JSON。 如果将某个信号选择为按结构读取,则会读取 structured signal(结构化信号), 而不是简单信号。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情会影响文件内容的处理方式。
- 结构:
采用以下结构的字典形式 JSON 字符串:
- timeColumn:
[str] 时间列名称。若未设置,则自动确定。
- timeUnit:
[str] 时间戳单位:
ns、µs、ms、s。默认值:s。- normalizeTime:
[bool] 是否归一化时间戳:
true|false。默认值:false。- mode:
[str]
simple|eventlog。默认值:simple。- keyColumns:
[list[str],仅当
"mode":"eventlog"时] 键列列表- valueColumn:
[str,仅当
"mode":"eventlog"时] 值列
- 示例:
{"timeColumn":"time", "timeUnit":"ns", "mode":"eventlog", "keyColumns":["ecu", "name"], "valueColumn":"value"}
PCAP/PCAPNG¶
- 概述
PCAP 和 PCAPNG 是用于网络数据 Recording 的格式。
- 伪信号
为分析该文件格式,提供了所谓的伪信号。借助这些伪信号, 可以定义分层网络协议栈中的对应入口点。 这些伪信号一旦出现,就会以 Python 数据结构的形式返回 (参见 Ethernet API 文档)。 请注意,signal type 必须始终设置为 raw value, 因为无法对该信号进行进一步解释。
上述 Python 数据结构还支持通过 .parent 属性直接访问上层协议信息, 或通过 .FindParent(protocolName) 获取特定协议。 此外,也可以直接通过属性访问协议,例如 PacketSomeIp.ip4.src。 与“原生”数据类型不同,出于性能考虑,Protocol 类型只包含头字段,不包含任何负载数据。 完整 API 文档请参见: Ethernet。
以下列出了所有伪信号及其说明:
信号
说明
数据类型
对应协议类型
PacketEthernet
Recording 中任意一个 Ethernet 帧
PacketMka
协议类型为 MKA 的 Ethernet 帧
不支持
PacketIp
协议类型为 IP 的 Ethernet 帧
PacketIcmp
协议类型为 ICMP 的 IP 数据包
不支持
PacketTcp
协议类型为 TCP 的 IP 数据包, 不支持 TCP 重组
PacketUdp
协议类型为 UDP 的 IP 数据包
PacketIke
协议类型为 IKEv2 的 UDP 数据包。 默认情况下,源端口和目标端口均为 500 的 UDP 数据包会被解释为 IKEv2 数据包。
不支持
PacketSomeIp
协议类型为 SOME/IP 的 TCP 或 UDP 数据包。 默认情况下,源端口或目标端口为 30490 的 TCP 或 UDP 数据包会被解释为 SOME/IP 数据包。
PacketSomeIpSd
消息 ID 为 0xFFFF8100 的 SOME/IP 数据包
不支持
PTP
协议类型为 PTP 的 Ethernet 帧
不支持
PTP/PacketPtpSync
协议类型为 PTP 且 PTP 消息类型为 Sync 的 Ethernet 帧
不支持
PTP/PacketPtpFollowUp
协议类型为 PTP 且 PTP 消息类型为 Follow_Up 的 Ethernet 帧
不支持
PTP/PacketPdelayReq
协议类型为 PTP 且 PTP 消息类型为 Pdelay_Req 的 Ethernet 帧
不支持
PTP/PacketPdelayResp
协议类型为 PTP 且 PTP 消息类型为 Pdelay_Resp 的 Ethernet 帧
不支持
PTP/PacketPdelayRespFollowUp
协议类型为 PTP 且 PTP 消息类型为 Pdelay_Resp_Follow_UP 的 Ethernet 帧
不支持
说明
在发生 IP 分片时,会在最后一个分片的时间点生成 PacketTcp 或 PacketUdp。 各个分片仍可通过 PacketEthernet 和 PacketIp 访问。
- 基于服务的通信
除协议分析外,还可以对 PCAP 和 PCAPNG Recording 中的方法和事件进行分析。 可用于分析的是 Service 选项卡中的值。 事件信号、方法信号及其叶子节点都可以使用。
- Logging 信号
此外,还可以读取符合 “Diagnostic Log and Trace”(DLT)协议的 logging 消息。 其工作原理与 DLT format(DLT 格式) 类似。 为了正确识别 ECU,必须在测试配置中指定 IP 和 Port。
目前仅支持 UDP 数据包中的 logging 消息。
- PLP (Probe Logger Protocol) / TECMP
也支持 PLP/TECMP 格式的 Recording,其中包含类型为 “Ethernet” 的消息。 PLP/TECMP 中包含的 Ethernet 帧会被透明解包并继续处理。 不支持基于 ProbeID/DeviceId 和 BusSpecID/InterfaceID 进行过滤。 除 “Ethernet” 之外的消息类型不受支持。对于通用信号的时间轴, 将使用 PLP/TECMP Data Frames 更精确的内部时间戳,而不是外层 PCAP 时间戳。
- DTLS (Datagram Transport Layer Security)
可以通过 PacketSomeIp 读取 DTLS 1.2 加密的 SOME-IP 消息。这需要一个特殊的 key log file ,其文件扩展名为 “.keys”,并且与同一文件夹中的 Trace 文件同名。 要解密每个会话,key log file 中必须包含对应的 CLIENT_RANDOM 条目。 Key log file 可以通过 Wireshark 创建。
说明
当实现了 NULL cipher 时,是否使用 key log file 是可选的。 在这种情况下,SOME-IP 消息也可以被解析,但无法校验其真实性。
- 通过 AUTOSAR Socket Adaptor 的总线测量
可以解析通过 Socket Adaptor 模块发送的 CAN 消息。 为此,需要在测试配置的 Bus access 选项卡中设置带有 SOCKET-ADAPTOR 通道的数据库。 之后,就可以在动作窗口的 Bus access 选项卡中使用所需的总线信号。
支持解析来自 UDP 和 TCP 的 CAN 消息。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
这些详情可用作事件信号和 SOME/IP 伪信号的过滤条件。 对其他伪信号没有意义。
- 结构:
%Port%- Port
指定承载 SOME/IP 服务发现控制数据流的 UDP 端口。 一方面,事件发送方可通过服务数据库(Fibex)中配置的 IP 地址、传输协议和端口来识别。 在这种情况下,不会考虑这里指定的端口。 另一方面,也可以通过动态分析控制数据流(SOME/IP 服务发现)来确定事件发送方。 在这种情况下,会考虑这里指定的端口。
- 默认值:
30490
- Filter
- 用途:
基于过滤条件,不满足条件的文件条目会被丢弃。
过滤器由多个比较条件通过与(and)连接而成,这些条件可以引用 Ethernet 协议栈中不同总线消息或数据包的属性。 因此,该过滤器的工作方式类似 Wireshark 的过滤,但使用的是 ecu.test 的命名空间。
示例:PacketTcp.tcpSrc == 1234
假设只允许包含端口 1234 的 PacketTcp 条目。 由于过滤应用于 Recording 的完整消息,因此协议栈更深层的 PacketEthernet 也会被一并过滤掉。
- 时间戳排序
对于时间轴不严格单调递增的 Recording,可使用以下 Workspace 设置: ETHERNET: Sort timestamps via moving window(ETHERNET:通过移动窗口排序时间戳)
ROS2¶
- 概述
说明
支持版本 4 至 9(含)的 rosbag2 Recording。 Rosbag2 Recording 支持不同的序列化方式。该工具连接 当前仅支持小端、无压缩的 CDR version 1(Common Data Representation)格式 Recording。 仅支持 sqlite3 和 mcap 存储插件。
- sqlite3
“sqlite3” 格式的 rosbag2 Recording 是一个文件夹,其中包含一个或多个扩展名为 .db3 的 SQLite 文件, 以及对应的 metadata.yaml。为了使 ecu.test 正确识别 rosbag2 Recording, 需要提供 zip 文件。要从 Recording 中提取实际数据,还需要元信息,而这些元信息也必须包含在 zip 文件中。
若要使用不是由 ecu.test 创建的 rosbag2 Recording,需要执行一些手动步骤:
新建一个空文件夹
将所有 rosbag2 Recording 文件复制到该文件夹中(即属于该 Recording 的所有 .db3 文件)
将 metadata.yaml 添加到该文件夹中
在 Humble Hawksbill 及之前版本中,收集并加入从数据中提取信号所需的全部结构信息(所有 .msg 文件)。从 Iron Irwini 开始可省略此步骤。
将整个文件夹内容打包为 zip 文件。
示例 zip 文件内容:
- mcap
“mcap” 格式的 rosbag2 Recording 是一个文件夹,其中包含一个或多个扩展名为 .mcap 的 MCAP 文件, 以及对应的 metadata.yaml。为了使 ecu.test 正确识别 rosbag2 Recording, 需要提供 zip 文件。
若要使用不是由 ecu.test 创建的 rosbag2 Recording,需要执行一些手动步骤:
新建一个空文件夹
将所有 rosbag2 Recording 文件复制到该文件夹中(即属于该 Recording 的所有 .mcap 文件)
将 metadata.yaml 添加到该文件夹中
将整个文件夹内容打包为 zip 文件。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
RDB¶
- 概述
RDB 是一种二进制格式,包含由 VTD 生成的 RDB 数据流。 VTD 本身将这些文件保存为 .dat 扩展名,但 ecu.test 会将其重命名为 .rdb,以避免与其他格式混淆。
- 信号类型
支持以下信号类型:
Integer
Floating point
Unicode strings
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
STI¶
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情用于指定采样率。
- 结构:
%Samplerate%- 采样率
每秒采样数。
可选值:
%Number% .. 以浮点数表示的采样率。
- 默认值:
50.0
TDMS¶
- 概述
TDMS Recording 的每个组都可以定义自己的时间通道。 如果所有时间戳都是绝对时间戳,则最早的时间戳会被归一化为零,并作为其他所有时间戳的参考。 如果 Recording 只包含相对时间戳,则最小时间戳会被归一化为零并作为参考。 对于混合时间戳类型,则以最早的绝对时间戳作为参考,所有相对时间戳都相对于该绝对参考值。
- 解析器参数化
- 设备名称
- 用途:
必填。用于从文件中选择特定 device,并据此过滤信号。 如果还要读取其他 device 的信号,则必须以相同方式将该 Recording 分配到另一个 Recording 组。
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
TTL¶
- 支持的现场总线系统
ecu.test 支持 CAN、CAN-FD、FlexRay、LIN 以及 Ethernet 总线系统。 Clamp 15 和 Clamp 30 作为模拟信号提供。
此外,还支持通过 DIAG-SERVICE 量提取并解释诊断报文(当前仅支持 CAN (FD))。 值结构请参见 Diagnostics related objects of trace analysis(Trace Analysis 诊断相关对象)。
- TAP
支持通过 Ethernet 连接到主记录仪的 TAP(扩展板)。 其 TAP 编号(也包括级联)必须在格式详情中显式设置(见下文)。
- 伪信号
对于 TTL 文件格式,ecu.test 除实际总线信号外,还提供所谓的伪信号用于分析 (位于相应文件的 Trace files 选项卡下的 Signals 中)。 伪信号可在无需加载 Signal database(信号数据库) 的情况下访问文件原始数据。 如果已加载信号数据库,ecu.test 还可以利用 BUS 选项卡中列出的元素,从原始数据中提取具体信号并在 Trace Analysis 中提供。
根据读取的介质不同,可用的伪信号也不同:
信号
说明
CAN/CAN-FD
FlexRay
LIN
数据类型
FrameID
+
+
+
Integer
FramePayload
+
+
+
String
FrameLength
+
+
+
Integer
FrameCycle
-
+
-
Integer
UdsMessage
需要 ecu.test diagnostics。
+
-
-
适用于 Ethernet 的可用伪信号见以下章节: PCAP pseudo signals(PCAP 伪信号)。
- 基于服务的通信
- Logging 信号
- PLP (Probe Logger Protocol) / TECMP
- 通过 AUTOSAR Socket Adaptor 进行总线测量
- 解析器参数化
- 设备名称
- 用途:
必填。用于从文件中选择特定 device,并据此过滤信号。 如果还要读取其他 device 的信号,则必须以相同方式将该 Recording 分配到另一个 Recording 组。
- 可选值:
Analoge Signale、CAN、Flexray、 LIN, Ethernet
- 格式详情(参见 Management of signals(信号管理))
- 用途:
格式详情用作过滤条件,以便只读取 Trace 中特定的帧。 模拟信号不需要格式详情。旧版本中还会额外定义一个 device (‘ANY’、‘Tricore’、‘FPGA’)。现在已不再需要。
- 结构:
%Medium%_%TAP Number%:%Channel%_%Direction%_%Port%- Medium
要过滤的总线。
可选值:
CAN .. 仅读取 CAN 或 CAN-FD 的帧。
Flexray .. 仅读取 FlexRay 的帧。
LIN .. 仅读取 LIN 的帧。
Ethernet .. 仅读取 Ethernet 的帧。
- TAP Number:
仅读取来自该记录仪的帧。
可选值:
%Number% .. TAP 编号。有效值为 0 到 7,其中 0 表示主记录仪。
- Channel
仅读取来自该通道的帧。
可选值:
%Number% .. 通道编号。
主记录仪的有效值如下:
CAN .. 1-24
LIN .. 1-12
FlexRay .. 由 FlexRay 编号 1-3 与 FlexRay 通道 A、B 或 AB 组成
Ethernet .. A 或 B
CAN-FD .. 不支持
TAP 的有效值如下:
CAN .. 1-5
LIN .. 1-15
FlexRay .. 由 FlexRay 编号 1-2 与 FlexRay 通道 A 或 B 组成
Ethernet .. 由 1-6 的编号与 A 或 B 组合而成
CAN-FD .. 1-15(即,由于 CAN-FD 包含在介质 CAN 中,因此通道 1-5 的格式详情对两者相同。)
- Direction
仅读取朝特定方向发送的帧。
可选值:
Rx .. 仅读取接收帧。
Tx .. 仅读取发送帧。
RxTx .. 同时读取接收帧和发送帧。
- Port
指定传输 SOME/IP 服务发现控制数据流的 UDP 端口。 一方面,事件发送方可通过服务数据库(Fibex)中配置的 IP 地址、传输协议和端口来识别。在这种情况下,不会考虑此处指定的端口。 另一方面,也可以通过动态分析控制数据流 (SOME/IP 服务发现)来确定事件发送方。在这种情况下, 会考虑此处指定的端口。
- 默认值:
Flexray_1A_RxTx_30490
AUDIO¶
- 概述
ecu.test 支持
.wav、.flac、.mp3和.ogg文件。 其中每个音频通道都可以单独读取。读取值为 64 位浮点数,典型范围是 -1.0 到 1.0。- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用
VIDEO¶
- 支持的视频格式
ecu.test 使用 OpenCV 2.x 读取视频文件。因此,它支持 OpenCV 支持的所有视频格式,具体取决于所使用的视频编解码器。目前支持以下 容器格式:.avi、.mp4、.mkv、.mts。
警告
OpenCV 需要某些 DLL 库,而部分 Windows 版本默认并不附带这些库。这尤其影响 Windows 10 N 和 Windows Server 2012 R2。若要在这些机器上使用该功能,需要安装相应的功能包,例如 Windows 10 的 Media Feature Pack 或 Windows Server Essentials Media Pack。
说明
OpenCV 提供的图像采用 BGR 颜色顺序! 在将图像添加到报告之前,必须先进行颜色转换,例如使用以下调用:
rgbArray = cv2.cvtColor(bgrArray, cv2.COLOR_BGR2RGB)- 伪信号
为了分析帧,提供了名为 Frame 的信号。使用该信号可为每个时间戳获得一个 Frame 对象。如果已配置媒体访问,也可以改为访问顶层视频信号。
Frame 对象的接口可参见 API documentation(API 文档)。
说明
可以直接读取属性 number、data 和 time。为此需要访问伪信号 Frame.number、Frame.data 和 Frame.time。
如果设置了分析执行中的时间戳舍入选项,则帧时间也会相应进行舍入。
- 解析器参数化
- 设备名称
- 用途:
不需要
- 格式详情(参见 Management of signals(信号管理))
- 用途:
未使用