Port APPLICATION - XCP-CAN ✦

TOSUN-HW Calibration and Measurement

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel number

‘1’

string

当存在多个同类型控制器时,用于选择通道号。

Bit rate

‘500KB’

[‘10KB’, ‘20KB’, ‘50KB’, ‘83.333KB’, ‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’]

string

Bit rate

Activate terminating resistor

☐

bool

激活内部 120 Ω 终端电阻

Mode

Standard

[Standard, Extended]

string

寻址模式(Standard = 11bit,Extended = 29bit)

接收错误帧

☐

bool

接收错误帧

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 变量会被卸载。

默认采集速率

‘Tool-Default’

string

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

跳过值有效性检查

☐

bool

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

使用 seed 和 key

☐

bool

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

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 中)。

XAM file

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

string

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

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

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

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

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

Transmission confirmation

☐

bool

启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。

传输确认的超时时间

1000

int

消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。

CAN-ID Settings

auto

[auto, manual]


显示值:

  • auto: auto

  • manual: manual

string

在 ‘auto’ 模式下,XCP 命令、响应和 DAQ 的 CAN ID 必须在 TCF 中选择的 A2L 文件里指定。随后将自动使用这些值。如果希望自行指定命令和响应 ID,或 A2L 文件中未提供其中任何一个,请选择 ‘manual’ 模式。但目前在 ‘manual’ 模式下不支持使用与命令和响应 ID 不同的 CAN ID 进行 DAQ。

将请求填充到最大 DLC

☐

bool

如果选中该选项,则消息的数据字段将填充至最大长度。

FillByte

将请求填充到最大 DLC:‘True’

string

用于将数据字段填充到最大长度的字节。以 0x00 到 0xFF 的整数形式输入一个字节。

CAN-ID ❲Master->Slave❳

CAN-ID 设置:‘manual’

string

从 ecu.test 到 ECU 方向的 CAN-ID

CAN-ID ❲Slave->Master❳

CAN-ID 设置:‘manual’

string

ECU 到 ecu.test 方向的 CAN-ID

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

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