Port SERVICEACCESS - UDP-RAW

UDP low level communication

This port requires a PCAP driver to be installed.

Stimulation

This port has no stimulus capabilities.

Name

Available if

Default value

Valid values

Type

Description

Network name

string

Name of the network as defined in SIL-Kit Config yaml.

Controller name

string

Name of the controller as defined in SIL-Kit Config yaml.

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

‘Default’

string

Default MAC which will be used as source address for ethernet frames, leave Default if the primary adapter MAC address should be used

Default source IP address

‘Default’

string

Default IP which will be used as source address for ethernet frames, leave Default if the primary adapter IP address should be used

Subnet mask for IP network

‘Default’

string

Subnet mask for IP network (necessary for broadcast detection, e.g. ARP), leave Default for using the primary NIC subnet mask

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

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