Port SERVICEACCESS - UDP-RAW¶
UDP low level communication
Stimulation¶
This port has no stimulus capabilities.
Properties 🛈¶
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
Port |
string |
Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated. |
|||
Filter in BPF format |
‘(ip dst host [IP] or ip[16] >= 224) and ip proto \udp and src port [DEST-PORT] and dst port [SRC-PORT]’ |
string |
The identifiers [IP], [DEST-PORT], [SRC-PORT] in square brackets describe variables that are replaced with the corresponding value when the configuration is loaded. By default, filtering is based on the default source port as destination and the default receive port as source. [IP] corresponds to the port IP address. Caution: The filter may only filter UDP packets, since other transport protocols cannot be interpreted. VLAN filtering happens automatically when enabled. If UDP packets are transmitted in fragmented IP packets, there must be no filtering on ports. |
||
VLAN settings |
‘no tagging’ |
[‘no tagging’, ‘single tagging’] |
string |
Used VLAN setting |
|
VLAN-VID |
1 |
int |
Integer, only used if VLAN tagging is enabled |
||
Receive buffer size |
1000 |
int |
Number of messages which can be recorded in the receive buffer (ring buffer) |
||
Automatic data reception on test run |
☑ |
bool |
Only operative if on the left for ‘Start’ either ‘Always’ is chosen, or ‘If necessary’ and the port is in use in the test configuration. |
||
Path / file name for the PCAP/PCAPNG output file |
Automatic data reception on test run |
string |
PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired. |
||
Default source MAC address |
‘02:00:4C:4F:4F:50’ |
string |
Default MAC address to be used for Ethernet frames |
||
Default source IP address |
string |
Default IP address to be used for IP packets |
|||
Subnet mask for IP network |
string |
Subnet mask for the IP Network (necessary in order to recognize broadcast addresses, e.g. for ARP) |
|||
Default source port |
30490 |
int |
Default port to be used as source in the UDP header |
||
Default destination port |
30491 |
int |
Default port to be used as destination in the UDP header |
Jobs 🛈¶
ClearReceiveBuffer¶
Clears the ecu.test high-level receive buffer. Low-level buffers in the driver are not cleared.
ReceivePacket¶
Returns a packet from the receive buffer and removes it from there
Parameterization
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
Return value of type PacketUdp or NotPresent |
ReceiveSomeIpMessage¶
Returns a packet from the receive buffer, interprets it and filters the MessageId if necessary. If MultipleResults are enabled, a list with more than one object might be returned. The packet will be removed from the receive buffer.
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
InterpretAs |
‘PacketSomeIp’ |
[‘PacketSomeIp’, ‘PacketSomeIpSd’] |
string |
Specifies which class a package is to be interpreted by. A packet is only returned if it could be successfully interpreted. |
|
MessageId |
object |
MessageIds which have to match for passing (empty / int / list with ints) |
|||
MultipleResults |
False |
[False, True] |
bool |
Boolean, if enabled a list with result objects will be returned |
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
Return value of specified type, list of it or NotPresent |
SendPacket¶
Send data
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
EthDestMac |
‘Default’ |
string |
String (format: 00:11:FF:1E:32:FF), Default if MAC address is resolved over ARP or multicast calculation |
||
EthSrcMac |
‘Default’ |
string |
String (format: 00:11:FF:1E:32:FF), leave ‘Default’ if the MAC from the port settings should be used |
||
EthSrcType |
‘ETH_TYPE_IP’ |
[‘ETH_TYPE_8021AD’, ‘ETH_TYPE_8021Q’, ‘ETH_TYPE_AOE’, ‘ETH_TYPE_ARP’, ‘ETH_TYPE_CDP’, ‘ETH_TYPE_DTP’, ‘ETH_TYPE_EDP’, ‘ETH_TYPE_IP’, ‘ETH_TYPE_IP6’, ‘ETH_TYPE_IPX’, ‘ETH_TYPE_LLDP’, ‘ETH_TYPE_MPLS’, ‘ETH_TYPE_MPLS_MCAST’, ‘ETH_TYPE_PPP’, ‘ETH_TYPE_PPPoE’, ‘ETH_TYPE_PPPoE_DISC’, ‘ETH_TYPE_PROFINET’, ‘ETH_TYPE_PUP’, ‘ETH_TYPE_QINQ1’, ‘ETH_TYPE_QINQ2’, ‘ETH_TYPE_REVARP’, ‘ETH_TYPE_TEB’, ‘ETH_TYPE_UNKNOWN’] |
string |
String from selection or integer |
|
IpChecksum |
‘Auto’ |
string |
‘Integer’, ‘Auto’ if should be calculated automatically |
||
IpDst |
‘192.168.0.1’ |
string |
String (format: 192.168.0.1) |
||
IpIdent |
0 |
int |
Integer |
||
IpLen |
‘Auto’ |
string |
‘Integer’, ‘Auto’ if should be calculated automatically |
||
IpOffset |
0 |
int |
Integer |
||
IpProt |
‘IP_PROTO_UDP’ |
[‘IP_PROTO_3PC’, ‘IP_PROTO_AH’, ‘IP_PROTO_AN’, ‘IP_PROTO_ANY0HOP’, ‘IP_PROTO_ANYENC’, ‘IP_PROTO_ANYHOST’, ‘IP_PROTO_ANYNET’, ‘IP_PROTO_ARGUS’, ‘IP_PROTO_ARIS’, ‘IP_PROTO_AX25’, ‘IP_PROTO_BBNRCC’, ‘IP_PROTO_BRSATMON’, ‘IP_PROTO_CBT’, ‘IP_PROTO_CFTP’, ‘IP_PROTO_CHAOS’, ‘IP_PROTO_CMTP’, ‘IP_PROTO_COMPAQPEER’, ‘IP_PROTO_CPHB’, ‘IP_PROTO_CPNX’, ‘IP_PROTO_CRTP’, ‘IP_PROTO_CRUDP’, ‘IP_PROTO_DCNMEAS’, ‘IP_PROTO_DDP’, ‘IP_PROTO_DDX’, ‘IP_PROTO_DGP’, ‘IP_PROTO_DISTFS’, ‘IP_PROTO_DSTOPTS’, ‘IP_PROTO_EGP’, ‘IP_PROTO_EIGRP’, ‘IP_PROTO_EMCON’, ‘IP_PROTO_ENA’, ‘IP_PROTO_ENCAP’, ‘IP_PROTO_EON’, ‘IP_PROTO_ESP’, ‘IP_PROTO_ETHERIP’, ‘IP_PROTO_EXPAK’, ‘IP_PROTO_FC’, ‘IP_PROTO_FIRE’, ‘IP_PROTO_FRAGMENT’, ‘IP_PROTO_GGP’, ‘IP_PROTO_GMTP’, ‘IP_PROTO_GRE’, ‘IP_PROTO_HMP’, ‘IP_PROTO_HOPOPTS’, ‘IP_PROTO_IATP’, ‘IP_PROTO_ICMP’, ‘IP_PROTO_ICMP6’, ‘IP_PROTO_IDP’, ‘IP_PROTO_IDPR’, ‘IP_PROTO_IFMP’, ‘IP_PROTO_IGMP’, ‘IP_PROTO_IGP’, ‘IP_PROTO_IL’, ‘IP_PROTO_INLSP’, ‘IP_PROTO_IP’, ‘IP_PROTO_IP6’, ‘IP_PROTO_IPCOMP’, ‘IP_PROTO_IPCV’, ‘IP_PROTO_IPIP’, ‘IP_PROTO_IPIPENCAP’, ‘IP_PROTO_IPLT’, ‘IP_PROTO_IPPC’, ‘IP_PROTO_IPXIP’, ‘IP_PROTO_IRTP’, ‘IP_PROTO_ISIS’, ‘IP_PROTO_KRYPTOLAN’, ‘IP_PROTO_L2TP’, ‘IP_PROTO_LARP’, ‘IP_PROTO_LEAF1’, ‘IP_PROTO_LEAF2’, ‘IP_PROTO_MAX’, ‘IP_PROTO_MERITINP’, ‘IP_PROTO_MFPNSP’, ‘IP_PROTO_MHRP’, ‘IP_PROTO_MICP’, ‘IP_PROTO_MOBILE’, ‘IP_PROTO_MTP’, ‘IP_PROTO_MUX’, ‘IP_PROTO_NARP’, ‘IP_PROTO_NETBLT’, ‘IP_PROTO_NONE’, ‘IP_PROTO_NSFIGP’, ‘IP_PROTO_NVP’, ‘IP_PROTO_OSPF’, ‘IP_PROTO_PGM’, ‘IP_PROTO_PIM’, ‘IP_PROTO_PIPE’, ‘IP_PROTO_PNNI’, ‘IP_PROTO_PRM’, ‘IP_PROTO_PTP’, ‘IP_PROTO_PUP’, ‘IP_PROTO_PVP’, ‘IP_PROTO_QNX’, ‘IP_PROTO_RAW’, ‘IP_PROTO_RDP’, ‘IP_PROTO_RESERVED’, ‘IP_PROTO_ROUTING’, ‘IP_PROTO_RSVP’, ‘IP_PROTO_RSVPIGN’, ‘IP_PROTO_RVD’, ‘IP_PROTO_SATMON’, ‘IP_PROTO_SCCSP’, ‘IP_PROTO_SCPS’, ‘IP_PROTO_SCTP’, ‘IP_PROTO_SDRP’, ‘IP_PROTO_SEP’, ‘IP_PROTO_SKIP’, ‘IP_PROTO_SM’, ‘IP_PROTO_SMP’, ‘IP_PROTO_SNP’, ‘IP_PROTO_SPRITERPC’, ‘IP_PROTO_SPS’, ‘IP_PROTO_SRP’, ‘IP_PROTO_SSCOPMCE’, ‘IP_PROTO_ST’, ‘IP_PROTO_STP’, ‘IP_PROTO_SUNND’, ‘IP_PROTO_SVMTP’, ‘IP_PROTO_SWIPE’, ‘IP_PROTO_TCF’, ‘IP_PROTO_TCP’, ‘IP_PROTO_TLSP’, ‘IP_PROTO_TP’, ‘IP_PROTO_TPPP’, ‘IP_PROTO_TRUNK1’, ‘IP_PROTO_TRUNK2’, ‘IP_PROTO_TTP’, ‘IP_PROTO_UDP’, ‘IP_PROTO_UTI’, ‘IP_PROTO_VINES’, ‘IP_PROTO_VISA’, ‘IP_PROTO_VMTP’, ‘IP_PROTO_VRRP’, ‘IP_PROTO_WBEXPAK’, ‘IP_PROTO_WBMON’, ‘IP_PROTO_WSN’, ‘IP_PROTO_XNET’, ‘IP_PROTO_XTP’] |
string |
String from selection or integer |
|
IpSrc |
‘Default’ |
string |
String (format: 192.168.0.1), leave ‘Default’ if the IP from the port settings should be used |
||
IpTos |
‘IP_TOS_PREC_ROUTINE’ |
[‘IP_TOS_PREC_CRITIC_ECP’, ‘IP_TOS_PREC_FLASH’, ‘IP_TOS_PREC_FLASHOVERRIDE’, ‘IP_TOS_PREC_IMMEDIATE’, ‘IP_TOS_PREC_INTERNETCONTROL’, ‘IP_TOS_PREC_NETCONTROL’, ‘IP_TOS_PREC_PRIORITY’, ‘IP_TOS_PREC_ROUTINE’] |
string |
String from selection or integer |
|
IpTtl |
64 |
int |
Integer |
||
IpVersionHeader |
0x45 |
int |
Integer, default is version 4 an header length 20 |
||
UdpChecksum |
‘Auto’ |
string |
‘Integer’, ‘Auto’ if should be calculated automatically |
||
UdpData |
string |
String, payload as a ByteStream (e.g. ByteStream(“00:00”)) |
|||
UdpDst |
‘Default’ |
string |
Integer, Default if port settings should be used |
||
UdpLen |
‘Auto’ |
string |
‘Integer’, ‘Auto’ if should be calculated automatically |
||
UdpSrc |
‘Default’ |
string |
Integer, Default if port settings should be used |
||
VlanCfi |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanPcp |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanVid |
‘Default’ |
string |
Integer, Default if port setting should be used, only evaluated if VLAN is configured |
StartReceiving¶
Starts manual data receiving
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
FilterString |
‘(ip dst host [IP] or ip[16] >= 224) and ip proto \\udp and src port [DEST-PORT] and dst port [SRC-PORT]’ |
string |
The identifiers [IP], [DEST-PORT], [SRC-PORT] in square brackets describe variables that are replaced with the corresponding value when the configuration is loaded. By default, filtering is based on the default source port as destination and the default receive port as source. [IP] corresponds to the port IP address. Caution: The filter may only filter UDP packets, since other transport protocols cannot be interpreted. VLAN filtering happens automatically when enabled. If UDP packets are transmitted in fragmented IP packets, there must be no filtering on ports. |
||
PcapFileName |
string |
PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired. |
|||
VlanVid |
‘Default’ |
string |
Integer, Default if port setting should be used, only evaluated if VLAN is configured |
StopReceiving¶
Stops data receiving manual