变量窗口和数据类型¶
变量窗口¶
ecu.test 提供了多种数据类型,以便高效工作。这里的数据类型仅与变量当前保存的值相关,并且可以在运行时通过给变量赋值来更改。ecu.test 在这方面不施加限制,也就是说,数据类型会直接被改变。
可以在变量窗口中手动创建变量,或更改其初始值和数据类型。此外,还有由 ecu.test 自动生成的变量。例如,在某个对话框中执行 save as 时,如果输入了一个尚未知晓的变量,就会创建这类变量。这些自动生成的变量大多属于 “undefined” 类型。
勾选 parameter/return value 后,该变量会被定义为 parameter/return,因此可在其他 Package 之间交换值(作为引用插入时)。如果在 “Recording” 列中勾选,则变量值的任何变化以及当前仿真时间都会写入测试报告目录中的 CSV 文件。
右键单击会打开变量上下文菜单:
New variable
选择variable type(变量类型)后,会打开用于创建新变量的对话框。
Edit
此选项会打开同一个对话框,并填入当前选中变量的数据。也可以通过双击相应变量来打开该对话框进行编辑。
以下选项用于对变量执行 、、 和 。因此,变量也可以在不同 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 的常规方式定义。
该 Function 类型变量(在此示例中为 “Calculate_Sum”)例如可在 calculation step(计算步骤) 中调用:
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’])。
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 数组。数组会按需自动调整大小。
该 Structure 变量通过 Mapping 绑定到 echoSTRUCT service method:
Undefined(未定义)¶
提供没有初始值的变量。如果变量由 ecu.test 自动生成,则会得到这种类型。
信息
有关 ecu.test 变量类型高级操作的概览,请参见 API references(API 参考)。