STAR ELECTRONICS: FL3X¶
供应商信息
Vendor |
Web page |
产品名称 |
Version |
|---|---|---|---|
STAR ELECTRONICS |
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)。
Properties 🛈¶
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 |
工具调用被中止前的超时时间。 |
Jobs 🛈¶
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 |