变量窗口和数据类型

变量窗口

ecu.test 提供了多种数据类型,以便高效工作。这里的数据类型仅与变量当前保存的值相关,并且可以在运行时通过给变量赋值来更改。ecu.test 在这方面不施加限制,也就是说,数据类型会直接被改变。

可以在变量窗口中手动创建变量,或更改其初始值和数据类型。此外,还有由 ecu.test 自动生成的变量。例如,在某个对话框中执行 save as 时,如果输入了一个尚未知晓的变量,就会创建这类变量。这些自动生成的变量大多属于 “undefined” 类型。

../../../_images/Variablen.png

勾选 parameter/return value 后,该变量会被定义为 parameter/return,因此可在其他 Package 之间交换值(作为引用插入时)。如果在 “Recording” 列中勾选,则变量值的任何变化以及当前仿真时间都会写入测试报告目录中的 CSV 文件。

右键单击会打开变量上下文菜单:

../../../_images/Variablen_Kontextmenue.png
  • New variable

    选择variable type(变量类型)后,会打开用于创建新变量的对话框。

  • Edit

    此选项会打开同一个对话框,并填入当前选中变量的数据。也可以通过双击相应变量来打开该对话框进行编辑。

以下选项用于对变量执行 Copy、Cut、Paste 和 Delete。因此,变量也可以在不同 Package 之间交换。

  • Remove unused variables

    此选项会删除当前未被任何 test step 使用的所有变量。

  • Refresh

    此选项会刷新窗口视图。

单击变量编号(第一列)并向上或向下拖动,可以更改变量顺序。这会很有用,因为在 Package 参数化对话框中(将其作为引用输入时),变量会按照该参数化对话框中设定的顺序显示。

变量类型

Numeric(数值)

提供数值;有效输入例如 12、0xc 或 -12.234。

信息

小数位使用 “.” 书写。

String(字符串)

提供用于文本输入的变量。可以使用任意字符。

在控件字段中输入的字符串必须用 ` 或 “ 包围。

标准值也可以为多种语言分别定义(参见 Tutorial for multilingual texts(多语言文本教程))。当前使用的语言可在 Workspace 设置中选择(参见 Test editor(测试编辑器)),并会在 Variable properties 对话框中通过旗帜图标显示。

信息

字符串本身不包含 ‘ 或 “。可以直接输入。

警告

如果直接在控件字段中输入,所有类似 “\*” 的控制序列都会被替换。若要输出 “\”,则必须输入 “\\”。

Function(函数)

提供一个可输入任意 Python 代码的窗口。函数名固定为 “func”。参数和返回值可按 Python 的常规方式定义。

../../../_images/pyFunktion.png

该 Function 类型变量(在此示例中为 “Calculate_Sum”)例如可在 calculation step(计算步骤) 中调用:

../../../_images/Utility_Berechnung.png

PyObject(Python对象)

提供原生 Python 变量。它可以像在 Python 中一样用作初始值。

Map(映射表)

提供一个 “n x m” 矩阵,并可对 x 轴和 y 轴进行标注(“sampling points”)。大小可直接在左侧定义。可通过双击相应支撑点输入数值。

Matrix(矩阵)

提供一个矩阵。大小可直接在左侧定义。矩阵按列布局存储。因此,对矩阵变量进行索引时,先指定列,再指定行。

Vector(向量)

提供一维矩阵。大小可直接在左侧定义。

Curve(曲线)

提供一个可对 x 轴进行标注(“sampling points”)的一维矩阵。大小可直接在左侧定义。可通过双击相应支撑点输入数值。

FileList(文件列表)

打开一个用于选择文件的资源管理器视图。随后,这些文件会以列表形式保存在变量中。因此,可以方便地将多个文件保存到一个变量中。如果用户插入的 Package 包含该类型的参数,也会显示此对话框,以防止其他用户错误输入。

Folder(文件夹)

打开一个用于选择文件夹的资源管理器视图,随后所选文件夹会保存在变量中。因此,可以方便地将文件夹保存到变量中。如果用户插入的 Package 包含该类型的参数,也会显示此对话框,以防止其他用户错误输入。

Boolean(布尔值)

提供一个可包含逻辑值的变量。如果该变量是参数,则值字段中会提供逻辑值建议。

Enum(枚举)

Enum 类型变量表示一个与文本分配相关联的数值(value)。创建时,需要录入属于各数值的文本。第一列中必须定义一个初始值(“IV”)。虽然用户在参数化窗口中只看到文本,但 ecu.test 在测试执行期间会使用一个代表性的 enum value object。因此,无需特殊的“转换步骤”,即可更方便地编辑 Package。

也可以通过全局常量(api.globalConstants)、UserPyModules(user)或格式为 dict[int, str] 的 Python 表达式动态创建 enum 变量。生成的 enum 初始值始终是第一个元素。

在表达式中,Enum 类型变量可以直接与其数值或文本进行比较或修改。此外,还可以使用 .int 和 .str 来显式请求相应的数值或文本。还可以通过调用 .enum 显示完整的 Enum 定义。输入支持自动补全。

信息

Enum 的文本不应包含空格或特殊字符,这样才能通过点表示法进行简单的属性访问(例如 MyEnum.enum.xyz)。某些使用场景下,例如总线信号的文本表示,可能无法满足这一要求。在这种情况下,仍可通过方括号表示法访问 enum 值(例如 MyEnum.enum[‘X Y’])。

../../../_images/Enum.png

Text table(文本表)

“text table” 类型变量表示一个值选择集。创建该变量时输入可选值。随后,用户可在参数化窗口中从这些可选值中选择。第一列中必须定义一个初始值(“IV”)。

除了固定列表外,也可以使用动态列表。只需在提供的文本字段中写入一个表达式。该表达式会在使用时求值。生成列表的初始值始终是第一个元素。

信息

这些值始终会被 ecu.test 当作 Unicode 字符串处理,并且始终被视为 “in”。因此,输入文本时无需使用引号。数字在文本执行期间也会以字符串形式“传递”。

BitStream(位流)

提供一种便捷的方式来输入二进制数或十六进制数。未输入的一种表示会自动生成。十六进制数输入时不带前导 “0x”。

另请参见 API documentation for BitStream(BitStream 的 API 文档)

ByteStream(字节流)

用于输入字节序列。每个字节均以十六进制形式指定,且不带前导 0x。各个字节之间用 : 分隔。

另请参见 API documentation for ByteStream(ByteStream 的 API 文档)

Inbox(收件箱)

参见 Inbox and “Read from inbox”(Inbox 与“Read from inbox”)。

Outbox(发件箱)

参见 Outbox and test step “Write to outbox”(Outbox 与 test step“Write to outbox”)。

Relay(中继)

参见 Relays - Exchange of messages between parallel subpackages(Relays - 并行子 Package 之间的消息交换)。

Structure(结构体)

Structure 由各个组成部分构成。组成部分可以是标量元素、数组或结构节点。结构节点本身也可以由前述各类组成部分构成。

这种 Structure 变量与 NumPy-Arrays(NumPy 数组) 兼容,因此可以按相同方式使用。

这种变量类型尤其与 Service test steps(Service 测试步骤) 结合使用。在那里,它可以作为参数使用,或用于保存返回值。

每个变量都严格绑定到一个 Service Mapping,并表示其参数或返回值中的某个子结构。创建相应变量前,该 Mapping 必须已经存在。建议通过拖放 method 和 service 元素或其子结构,从 Service tab(Service 标签页) 到变量面板来创建变量。这样会自动创建匹配的 Mapping,或自动使用现有 Mapping。变量所使用的子结构由 structure path 定义。

信息

当结构元素名称与 NumPy 内置标识符冲突时(例如 count、item、sum),这些元素必须使用例如 item['count'] 的方式访问,而不是 item.count。如有必要,系统会给出提示。

信息

在 Fibex 或 ARXML 文件中描述为可变大小的数组,在 ecu.test 中会表示为具有指定最小尺寸的 numpy 数组。数组会按需自动调整大小。

../../../_images/Variable_Structure.png

该 Structure 变量通过 Mapping 绑定到 echoSTRUCT service method:

../../../_images/Variable_Structure_Service.png

Undefined(未定义)

提供没有初始值的变量。如果变量由 ecu.test 自动生成,则会得到这种类型。

信息

有关 ecu.test 变量类型高级操作的概览,请参见 API references(API 参考)。