Port APPLICATION - XCP-CAN ✦¶
HIRAIN-HW Calibration and Measurement
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel number |
‘1’ |
string |
当存在多个同类型控制器时,用于选择通道号。 |
||
Bit rate |
‘500KB’ |
[‘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 |
控制器运行在被动模式。自动 ACK 已禁用,无法发送 CAN 帧。 |
||
接收错误帧 |
☐ |
bool |
接收错误帧 |
||
Connection setup |
‘OnPortStart’ |
[‘OnPortStart’, ‘OnPortConfigure’, ‘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’] 显示值:
|
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] 显示值:
|
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 |
Jobs 🛈¶
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)。
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 |
测量或标定变量的逻辑值。 |