STAR ELECTRONICS: FL3X

供应商信息

Vendor

Web page

产品名称

Version

STAR ELECTRONICS

https://flex-product.com/

FL3X Device, FL3X System; FL3X Config

PC-HW Interface D3V8c-F

Categories

MDL 🛈

APL 🛈

BAN 🛈

BMA 🛈

SVC 🛈

DGN 🛈

FIU 🛈

EES 🛈

FCT 🛈

DBG 🛈

IMG 🛈

AUDIO 🛈

ENVSIM 🛈

ENVCOM 🛈

Platform

操作系统

Support

Windows

✓

Linux

✓

Ports

Specifics

通过此接口可以在配置为 RBS 和/或网关的 FL3X 设备 或 FL3X 系统上操控总线信号并抑制报文。

要将信号强制为特定值,只需将该值写入信号。其他操纵类型通过将具有以下语法的表达式作为原始值写入来触发。方括号标记可选参数。完整表达式必须作为字符串写入,即用引号括起来。

offset(value: int[, min: int, max: int])

value 会加到原始信号值上。如果提供了 min 和 max,则新的原始值会被限制在该范围内。

偏移量也可以为负值。

Example: "offset(-7)"

factor(value: int[, min: int, max: int])

原始信号值乘以 value。如果提供了 min 和 max,则新的原始值会被限制在该范围内。

不支持负的因子。

Example: "factor(3)"

ramp(start: int, end: int, steps: int[, hold: bool[, min: int, max: int]])

不再发送原始值,而是以 steps 为步长,从 start 到 end 发送斜坡。若提供 hold 并将其设为 True,则保持最后一个值,否则斜坡会持续重复。若提供了 min 和 max,则新的原始值会被限制在该范围内。

不支持负值,并且 steps 不得为 0。

示例:"ramp(0, 14, 7)" – 依次输出 0、2、4、…、14,然后重新开始。

drift(start: int, end: int, steps: int[, hold: bool[, min: int, max: int]])

在原始信号值上叠加一个斜坡(如同 ramp 中那样)。

示例:"drift(0, 6, 3, True, 3, 9)" – 先给信号值加 0,再加 3,再加 6,然后保持 +6 的偏移。如果结果值小于 3,则发送 3;如果大于 9,则发送 9。

freeze()

当前信号值被冻结。

blackout()

所有信号位均以 0 发送。

factor_phys(factor: float, signal_factor: float, signal_offset: float[, min: int, max: int])

使用 signal_factor 和 signal_offset 可由原始值计算物理值。该物理值乘以 factor,然后转换回新的原始值。若提供了 min 和 max,则新的原始值会被限制在该范围内。

示例:"factor_phys(1.2, 0.1, -6.0, 0, 254)" – 待发送的原始值按如下方式计算:

PHYS_orig := 0.1 * RAW_orig - 6.0
PHYS_new := PHYS_orig * 1.2
RAW_new := (PHYS_new + 6.0) / 0.1, as an integer
RAW_send := min(max(0, RAW_new), 254)

要在这种表达式中使用 test case 变量值,例如可以使用 Python 类 str 的 format 方法:"offset({0}, {1}, {2})".format(variable1, variable2, variable3)。

如有需要,可通过 BusBrowser API 查询 min、max、signal_factor 和 signal_offset 的值 (GetMinRawValue、GetMaxRawValue、GetLinearCoeffs)。

每次篡改都会立即生效,替换同一信号之前的任何篡改(前提是该篡改由 ecu.test 创建,且此后工具适配器未重启),并且与对其他信号的篡改无关地生效。

要撤销单个信号操纵,请使用 Reset test step。通过工具作业 StopAllManipulations 可停止所有操纵和报文抑制(包括在当前 test case 之外,甚至 ecu.test 之外创建的操纵)。

此外,可以单独抑制消息(使用测试步骤 Change PDU timing;仅激活状态,不含周期时间或 计算类别),也可以抑制某个 ECU 的所有消息(通过向该 ECU 本身“写入” 0 或 1)。

Name

在以下情况下可用

默认值

有效值

Type

Description

IP address

string

FL3X 设备的 IP 地址

端口号

1500

int

FL3X 设备的端口号

Mappings 文件

string

ID_Defines.xml 映射文件的完整路径和文件名。该路径在 ecu.test PC 上解析,可以相对于 Workspace。

Path to HwCom library

string

HWCom.dll(Windows)或 libHwCom.so(Linux)所在的文件夹。通过 Tool Server 远程使用时,为远程 PC 上的位置

Timeout for tool call ❲in sec.❳

‘600’

string

工具调用被中止前的超时时间。

CheckConnection

检查设备是否在线并响应

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

[False, True]

bool

DownloadApp

将应用程序(*.s19 文件)下载到设备的指定槽位

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

s19File

string

包含应用程序的 *.s19 文件的完整路径和文件名。该路径在 ecu.test PC 上解析。

slot

0

int

用于下载应用程序的槽位号

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

[False, True]

bool

如果设备在一分钟内重新上线则为 True,否则为 False

DownloadFPGA

将 FPGA 镜像(*.fpga 文件)下载到设备的指定槽位中

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

fpgaFile

string

包含 FPGA 映像的 *.fpga 文件的完整路径和文件名。该路径在 ecu.test PC 上解析。

slot

0

int

下载 FPGA 映像的目标槽位号

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

[False, True]

bool

如果设备在一分钟内重新上线则为 True,否则为 False

ReadGlobalVariable

读取全局变量的值。非数组变量返回整数,数组变量返回整数列表。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

variable

[ONLINE]

string

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

object

StartApp

启动设备上当前安装的应用

StopAllManipulations

停止所有当前活动的操纵和报文抑制

StopApp

停止设备上运行的应用

WriteGlobalVariable

写入全局变量的值。对于非数组变量,参数 ‘value’ 必须为整数;对于数组变量,必须为整数列表。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

value

object

variable

[ONLINE]

string