Port BUSACCESS - FLX¶
TechnicaBTS access to FlexRay
Stimulation¶
此端口支持 Stimulation control 中描述的所有功能。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Board ID ❲DIP switch❳ |
‘1’ |
string |
Board ID as configured via DIP switch (corresponds to the last octet of the IP address). |
||
Bus-DB |
string |
||||
自动 E2E 计算的占位符值 |
int |
只要为 E2E 信号(例如 CRC)指定了该值,ecu.test 在发送时就会自动将其替换为计算出的正确值。该选项的用途是允许发送任意固定值(与本处选择的值不同)。将该选项留空会完全禁用此功能。更多信息请参见文档 Tool categories - Automatic E2E calculation |
|||
Automatic start/stop |
‘Test execution’ |
[‘Test execution’, ‘Configuration start/stop’, ‘Never’] |
string |
This option affects whether the FlexRay controller will be started and stopped automatically. If ‘Never’ is chosen, the controller must be started and stopped explicitly using the port Job ‘SwitchBusState’. Caution: all timestamps (e.g. in ASC traces) are relative to the time of the controller start. |
|
Reinitialize on loss of bus synchronization |
☑ |
bool |
If this option is set, the FlexRay controller will automatically be reinitialized when it loses synchronization to the bus. Caution: if necessary, the reinitialization is performed even if the option ‘Automatic start/stop’ is set. |
||
Logging of events |
☐ |
bool |
The Events SCE, SE and EE will be written to the ASC file during recording |
||
Configuration mode |
‘Bus database’ |
[‘Bus database’] |
string |
If there are several methods to configure this port, the one to be used can be chosen here. The mode ‘configuration file’ requires a path in the corresponding setting. The mode ‘bus database’ extracts the required information from the bus database. |
|
TX ECU names ❲bus database❳ |
string |
Comma-separated list of control units, for whose messages tx buffers shall be configured. Only needed in the configuration mode ‘bus database’. |
|||
Cold-start node ❲bus database❳ |
‘<auto>’ |
[‘<auto>’, ‘no cold-start node’, ‘cold-start node’] |
string |
Decides whether the node shall participate in the cluster start. The setting <auto> takes the configuration for the first configured TX ECU from the bus database. Only needed in configuration mode ‘bus database’. |
|
Transmission confirmation |
☐ |
bool |
启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。 |
||
传输确认的超时时间 |
1000 |
int |
消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。 |
||
Null frames |
☐ |
bool |
Null frames will be logged only if ‘True’ |
||
Cold start behavior |
‘Leader’ |
[‘Leader’, ‘Follower’] |
string |
Jobs 🛈¶
ClearFrame¶
清除指定帧的接收缓冲区
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
Start cycle |
CloseFrTpSession¶
Closes the FrTP session.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
[False, True] |
bool |
会话已成功关闭 |
DeregisterFrameForInbox¶
Ungeristers a frame that is being streamed to an inbox
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
Inbox |
object |
现有收件箱 |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
StartCycle (cycle offset) |
DeregisterStreamForInbox¶
Deregisters a FrTp session.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
conId |
int |
Connection ID |
DisableSendFrameCyclic¶
停用对具有指定 ID 的报文的周期发送
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
Start cycle |
GetFirstValue¶
Reads the first received value of the given signal
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameName |
string |
Frame name |
|||
NodeName |
string |
电子控制单元的名称 |
|||
RawValue |
False |
[False, True] |
bool |
如果为 ‘True’,则返回原始值。 |
|
reset |
False |
[False, True] |
bool |
若为 ‘True’,则第一个接收到的值在被读取后将被删除 |
|
SignalName |
string |
信号名称 |
InitFrame¶
Initializes the given frame
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
DataLength |
int |
Length in words |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
StartCycle (cycle offset) |
OpenFrTpSession¶
Opens a FlexRay TP session.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
acknowledged |
False |
[False, True] |
bool |
The acknowledge bit (C_CT communication type) signals whether the sender requires a confirmation of receipt (acknowledged, STFA) or not (unacknowledged, STFU). - Integer |
|
blockSize |
0 |
int |
Block size in bytes; maximum number of bytes that may be transmitted in the following consecutive frames before the sender has to wait for another flow control frame. - Integer |
||
fillByte |
ByteStream |
用于填充报文的字节(可选) - 长度为 1 的 ByteStream |
|||
flowControlAddr |
-1 |
int |
Different address of the control unit (ECU) for FlowControl - Hex (optional Integer) |
||
maxFrameLength |
0 |
int |
一帧的最大长度(字节,适用于首帧、连续帧和末帧);如果该值设为 0,则使用 ISO 10681-2 中描述的最大值 - Integer |
||
mnpc |
0 |
int |
MNPC specifies how many consecutive frames the receiver can process within one FlexRay cycle. With MNPC set to 0 the sender can utilize the maximum possible band width. - Integer |
||
requestBaseCycle |
int |
Cycle offset in the application cycle window - Integer < RequestCycleRepetition |
|||
requestCycleRepetition |
int |
Cycle count after which the frame is sent periodically based on BaseCycle - Integer >= 1 |
|||
requestSlotId |
int |
Frame-ID for requests sent to the ECU - 1 or 2 byte Hex (integer) |
|||
responseBaseCycle |
int |
Cycle offset in the application cycle window - Integer < ResponseCycleRepetition |
|||
responseCycleRepetition |
int |
Cycle count after which the frame is received periodically based on BaseCycle - Integer >= 1 |
|||
responseSlotId |
int |
Frame-ID for ECU responses - 1 or 2 byte Hex (integer) |
|||
scExp |
0 |
int |
SC defines the minimum distance in cycles until the sender is allowed to send the next consecutive frame. SC = 2^SCexp - 1 - Integer |
||
sourceAddr |
int |
Address of the tester (ecu.test) - Hex (integer) |
|||
targetAddr |
int |
Address of the ECU - Hex (integer) |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
int |
Connection ID |
ReadFrame¶
Reads the given frame (use InitFrame before!)
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
doDelete |
False |
[False, True] |
bool |
若为 “True”,则在读取后删除该帧 |
|
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
StartCycle (cycle offset) |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
ByteStream |
ByteStream |
ReadFrameEx¶
Reads the given frame (use InitFrame before!)
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
doDelete |
False |
[False, True] |
bool |
若为 “True”,则在读取后删除该帧 |
|
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
StartCycle (cycle offset) |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
object |
FlexRayFrame |
RegisterFrameForInbox¶
注册一个帧,以便将其流式传输到 Inbox。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
Inbox |
object |
现有收件箱 |
|||
saveAsFlxFrame |
False |
[False, True] |
bool |
If True, the frame is saved as a FlexRayFrame object, else as a ByteStream |
|
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
StartCycle (cycle offset) |
RegisterStreamForInbox¶
Registers a FrTp session to be streamed to an inbox.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
conId |
int |
Connection ID |
|||
inbox |
object |
现有收件箱 |
ResetFirstValue¶
清除给定信号的第一个已接收值
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameName |
string |
Frame name |
|||
NodeName |
string |
电子控制单元的名称 |
|||
SignalName |
string |
信号名称 |
SendFrame¶
Sends the given frame ID. Frame ID must be registered in advance via the job “InitFrame”.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
CycleRepetition |
int |
Cycle repetition |
|||
Data |
ByteStream |
要发送的数据 |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
Start cycle |
SendFrameCyclic¶
以给定的 ID 和数据循环发送报文。报文 ID 必须事先通过作业 “InitFrame” 注册。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel |
‘A’ |
[‘A’, ‘B’, ‘*’] |
string |
FlexRay Channel (A, B or *) |
|
Count |
int |
发送重复次数 |
|||
CycleRepetition |
int |
Cycle repetition |
|||
DataByteStream |
ByteStream |
要发送的数据 |
|||
Interval |
int |
Cycle time in ms; 0 for every cycle |
|||
SlotId |
int |
Frame ID |
|||
StartCycle |
int |
Start cycle |
SendStream¶
Send a data stream via FrTp.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
conId |
int |
Connection ID |
|||
data |
object |
Payload to be sent via FrTp |
|||
timeout |
int |
发送消息的超时时间,单位毫秒 |
SetFlowControlCTS¶
Activates to always send a Flow Control “ContinueToSend” message in response to a segmented request. Also new values can be assigned to the internal parameters BlockSize, MNPC and SCexp.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
BlockSize |
int |
Block size in bytes; maximum number of bytes that may be transmitted in the following consecutive frames before the sender has to wait for another flow control frame. - Integer 如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。 |
|||
MNPC |
int |
MNPC specifies how many consecutive frames the receiver can process within one FlexRay cycle. With MNPC set to 0 the sender can utilize the maximum possible band width. - Integer 如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。 |
|||
SCexp |
int |
SC defines the minimum distance in cycles until the sender is allowed to send the next consecutive frame. SC = 2^SCexp - 1 - Integer 如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
SetFlowControlWait¶
激活后,对分段请求始终发送流控 “Wait” 消息。注意:激活期间无法接收任何分段消息。使用 Job SetFlowControlCTS 重置此行为。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
WaitTimeInterval |
0 |
int |
等待时间间隔,单位为 ms。如果设为 0,则只发送一次流控制“Wait”消息以响应分段请求。如果设为大于 0 的值,则按给定间隔周期性发送流控制“Wait”消息。 |
SwitchBusState¶
Switches the FlexRay controller on or off.
Caution: switching the controller on will reset the ASC timestamps. Recording during the stop and start of the controller may result in an ASC file which violates the monotony of timestamps.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
State |
‘Off’ |
[‘Off’, ‘On’] |
string |
New state of the bus |