Port APPLICATION - XCP-ETH ✦

用于通过 XCP over Ethernet 进行应用访问的端口。

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

TCP/IP stack

LwIP + Vector XL API

[LwIP + Vector XL API]

string

此选项仅供参考,无法更改。

物理层 ❲网络访问❳

Port

string

Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated.

MAC 地址 ❲客户端❳

‘02:00:4C:4F:4F:50’

string

字符串(格式:02:00:4C:4F:4F:50),如果要使用默认 MAC 地址,则为 ‘default’

VLAN Settings ❲IEEE 802.1Q❳

TCP/IP stack is LwIP

VLAN mode

TCP/IP stack is LwIP

auto

[auto, disable, single tagging]

string

如果应使用数据库中的 VLAN ID,则设为 ‘auto’;如果不应使用 VLAN,则设为 ‘disable’;如果应指定固定的 VLAN ID,则设为 ‘single tagging’

VLAN id

TCP/IP 协议栈为 LwIP » VLAN 模式:‘single tagging’

0

int

如果传入的数据包带有 VLAN 标签,则会对其进行过滤,只有带有该 VLAN ID 的数据包才能通过。不带任何 VLAN 标签的传入数据包也会通过过滤器。

IP Settings

IP version

IPv4

[IPv4, IPv6]

string

所用 IP 版本的选择

IP 地址 ❲客户端❳

TCP/IP stack is LwIP

string

用作客户端的 IP 地址。它必须与被测设备的 IP 地址位于同一子网,且不得等于其他参与者的 IP 地址,也不得等于操作系统分配给所选网络接口的 IP 地址。

Subnet mask / prefix length

TCP/IP stack is LwIP

‘default’

string

对于 IPv4 地址,可以给出子网掩码或前缀长度(格式:‘255.255.255.0’ 或 ‘24’)。‘default’ 使用该 IP 地址(客户端)所属网络类的默认子网掩码。

对于 IPv6,只接受前缀长度,且不支持值 ‘default’。

网关地址

TCP/IP stack is LwIP

string

网关的 IP 地址,通过该网关可以访问本地子网之外的主机。如果不需要网关,请留空

TCP/UDP Settings

Source port range

‘default’

string

用于建立连接的本地端口范围。

值 ‘default’ 将选择随机端口。

Example: 123,456-567,789

XCP Settings

Transport Layer Settings

auto

[auto, manual]


显示值:

  • auto: auto

  • manual: manual

string

In ‘auto’ mode, the transport-layer settings (protocol, server address and port) must be specified by the A2L file and transport layer selected in the test configuration. These values will then be used automatically. Choose ‘manual’ mode if you want to specify the values yourself or if any of them cannot be determined vie the test configuration.

IP address ❲server❳

Transport Layer Settings: ‘manual’

string

Address of the XCP server

Port ❲server❳

Transport Layer Settings: ‘manual’

5555

int

Port of the XCP server

Protocol

Transport Layer Settings: ‘manual’

‘TCP’

[‘UDP’, ‘TCP’]

string

Transport protocol for data transmission

Connection setup

‘OnPortStart’

[‘OnPortStart’, ‘OnPortConfigure’, ‘Job’]


显示值:

  • ‘OnPortStart’: ‘At start of test execution’

  • ‘OnPortConfigure’: ‘At start of configuration’

  • ‘Job’:‘manually via job’

string

应建立与 XCP 从站连接的时间

OnPortConfigure:

配置启动后即可获得在线信息。

OnPortStart and Job:

只有来自 A2L 文件的信息可用。

Auto-reconnect

☐

bool

如果启用此选项,则在每次读/写操作之前都会检查一次与 XCP 从站的连接。如果发现连接已不再存活,则尝试重新建立连接。如果重连成功,将清空所有缓冲区、恢复上次的标定页、继续测量和 Recording,然后执行测试步骤。如果重连失败,读测试步骤返回 NotPresent,而写测试步骤则报告为错误。启用此功能可能会减慢受影响测试步骤的执行速度。

仅在断开连接时注销 DAQ 变量

☐

bool

在建立端口连接时注册 DAQ 变量。

DAQ 变量一旦注册,就会在整个测试执行期间可用。

断开连接后,DAQ 变量会被卸载。

XAM file

注销 DAQ 变量 仅在断开连接时:‘True’

string

.xam 文件中包含的所有测量与标定变量都

在建立端口连接时注册用于 Recording 并作为 DAQ 变量

已建立。具有相同标识符的变量不会重复注册。

默认采集速率

‘Tool-Default’

string

测量采集率的声明,用于在 test step 中未设置采集率时作为替代使用(”*” 和 “?” 可用作通配符)。“Tool-Default” 会启用工具的默认采集率

跳过值有效性检查

☐

bool

启用此选项可抑制通常在物理值与原始值之间转换时执行的值范围检查。

使用 seed 和 key

☐

bool

定义要获取访问权限的资源,以及位于工具主机路径中的 32 位 dll 的文件名。

Seed and Key Library Path

使用种子与密钥:‘True’

SeedNKeyXcp.dll

uri

工具主机上包含 Seed and Key 函数的库的路径。处理 DLL 会增加配置启动时间。

请求的资源

使用种子与密钥:‘True’

5

int

要解锁的资源,以位掩码表示

CAL/PAG : 1

CAL/PAG DAQ : 5

CAL/PAG STIM : 9

CAL/PAG PGM : 17

CAL/PAG DAQ STIM : 13

CAL/PAG DAQ PGM : 21

CAL/PAG STIM PGM : 25

CAL/PAG DAQ STIM PGM: 29

DAQ : 4

DAQ STIM : 12

DAQ PGM : 20

DAQ STIM PGM : 28

STIM : 8

STIM PGM : 24

PGM : 16

解锁所需的时间取决于资源数量。

Recording 模式

‘immediate’

[‘immediate’, ‘two-stage’]


显示值:

  • ‘immediate’: ‘immediate’

  • ‘two-stage’: ‘two-stage’

string

immediate recording 会在 test execution 期间立即写入基于信号的 MDF4 文件。此模式会使用 XCP 从站时间戳(若可用)。

两阶段记录先记录原始总线/以太网通信,然后在 test execution 结束后将其后处理为基于信号的 MDF4 文件。该模式能更好地应对非常大量的信号。即使有可用的 XCP 从站时间戳,也使用帧的入站时间戳。

测试用例的开始时间将作为起始时间存储在 MDF4 文件的元数据中。

Default Polling Cycle [ms]

-1

int

默认轮询周期,单位为毫秒。所有采集率为“Polling”的 Recording 都使用该默认值。当 Mapping 的采集率中未提供轮询周期时,使用此值。值 -1 会停用受影响的轮询(不过,测试用例中显式读取的结果仍会合并到 Recording 中)。

Connect

建立与 XCP 从站的连接。

Disconnect

断开与 XCP 从站的连接。

FreezeCalibrationParameters

将从站上的所有给定段设置为 “Freeze” 模式,然后请求从站将标定数据保存到非易失性存储器。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

segments

[0]

object

整数段 ID 列表

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

[False, True]

bool

如果全部成功则为 True。如果出现任何错误则为 False(详情见日志输出)。

GetEPKFromECU

从 ECU 返回 EPROM ID(EPK)。

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

epk

ByteStream

包含 ID 的 ByteStream

GetStatus

返回 XCP 从站的资源保护状态。已锁定的资源可通过作业“UnlockResource”解锁。

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

statusDict

object

包含保护状态的字典。

ReadDataByAddress

从给定地址开始读取内存中的数据。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

address

int

读取的起始地址

addrExt

0

int

该地址所属段的地址扩展

length

int

要读取的字节数

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

data

ByteStream

以 ByteStream 形式读取数据

ReadValue

读取特定的测量或标定变量,并返回其逻辑值。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

name

string

在 A2L 文件中定义的测量量或标定变量的符号名。

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

value

float

测量变量或标定变量的逻辑值。

SwitchPage

切换活动页面。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

page

[ONLINE]

string

要切换到的页面

UnlockResource

使用 Seed and Key 机制解锁资源。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

requestedResourcesMask

5

int

要解锁的资源,以位掩码表示

CAL/PAG : 1

CAL/PAG DAQ : 5

CAL/PAG STIM : 9

CAL/PAG PGM : 17

CAL/PAG DAQ STIM : 13

CAL/PAG DAQ PGM : 21

CAL/PAG STIM PGM : 25

CAL/PAG DAQ STIM PGM: 29

DAQ : 4

DAQ STIM : 12

DAQ PGM : 20

DAQ STIM PGM : 28

STIM : 8

STIM PGM : 24

PGM : 16

seedNKeyLib

SeedNKeyXcp.dll

uri

工具主机上包含 Seed and Key 函数的库路径。

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

unlockedResourcesMask

int

已解锁资源的位掩码

WriteDataByAddress

从给定地址开始向内存写入数据。请谨慎使用,并再次核对输入。错误可能导致 XCP 从站出现严重问题。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

address

int

要写入的起始地址

addrExt

0

int

该地址所属段的地址扩展

data

ByteStream

要写入的数据,类型为 ByteStream

WriteValue

将逻辑值写入特定的测量变量或标定变量。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

name

string

在 A2L 文件中定义的测量量或标定变量的符号名。

value

float

测量或标定变量的逻辑值。