Port SERVICEACCESS - UDP-RAW

UDP Lowlevel-Kommunikation

Dieser Port erfordert, dass ein PCAP-Treiber installiert ist.

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Netzwerkadapter

[ONLINE]

string

Verwendeter Netzwerkadapter

Filter im 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

Die in eckigen Klammern eingefassten Bezeichner [IP], [DEST-PORT], [SRC-PORT] beschreiben Variablen, die beim Laden der Konfiguration mit dem entsprechenden Wert ersetzt werden. Voreingestellt ist, dass nach dem Standard-Quellport als Ziel und dem Standard-Empfangsport als Quelle gefiltert wird. [IP] entspricht der Port-IP-Adresse. Achtung: Der Filter darf nur UDP-Pakete filtern, da andere Transportprotokolle nicht interpretiert werden können. VLAN-Filterung geschieht bei Aktivierung automatisch. Werden UDP-Pakete in fragmentierten IP-Paketen übertragen, darf keine Filterung auf Ports erfolgen.

VLAN-Einstellung

‚no tagging‘

[‚no tagging‘, ‚single tagging‘]

string

Verwendete VLAN-Einstellung

VLAN-VID

1

int

Integer, wird nur bei aktiviertem VLAN-Tagging verwendet

Empfangspuffergröße

1000

int

Anzahl der Botschaften die der Empfangspuffers (Ringbuffer) aufnehmen kann

Autom. Datenempfang bei Testausführung

☑

bool

Nur wirksam wenn links bei ‚Start‘ entweder ‚Immer‘ gewählt ist, oder ‚Wenn benötigt‘ und der Port in der Testkonfiguration verwendet wird.

Pfad/Dateiname der PCAP/PCAPNG-Ausgabedatei

Autom. Datenempfang bei Testausführung

string

PCAP- oder PCAPNG-Datei (mit absolutem Pfad). In diese Datei wird aufgezeichnet. Leer lassen wenn keine Aufzeichnung gewünscht ist.

Loggerprotokoll

[, PLP/TECMP, ASAM CMP]

string

Ein Loggerprotokoll wie z.B. ASAM CMP verwenden. Der Port kann dann nur noch lesend verwendet werden. In den Loggernachrichten enthaltene Ethernet-Frames werden extrahiert und der Filter im BPF-Format (falls angegeben) wird auf diese Frames angewendet.

Device-IDs / Probe-IDs

Loggerprotokoll: ‚PLP/TECMP‘

string

Identifier der Devices / Probes: leer, wenn keine Filterung anhand der Probe-ID benötigt wird; mehrere können durch Komma getrennt werden.

Device- und Stream-IDs

Loggerprotokoll: ‚ASAM CMP‘

string

Identifier der Devices und Streams als Liste von Tupeln, jeweils bestehend aus Device-ID und Stream-ID, z.B.: (1,2),(3,4). Leer lassen, wenn keine Filterung anhand von Device- und Stream-ID benötigt wird.

Interface-IDs / Bus-Spec-IDs

Loggerprotokoll: ‚PLP/TECMP‘

string

Identifier der Interfaces / Busspezifikationen: leer, wenn keine Filterung anhand der Busspezifikation benötigt wird; mehrere können durch Komma getrennt werden.

Interface-IDs

Loggerprotokoll: ‚ASAM CMP‘

string

Identifier der Interfaces: leer, wenn keine Filterung anhand der Interface-ID benötigt wird; mehrere können durch Komma getrennt werden.

Standard-Quell-MAC-Adresse

‚Default‘

string

Standard-MAC die als Quelle für Ethernet-Frames verwendet wird, Default wenn die primäre Adapter-MAC-Adresse verwendet werden soll

Standard-Quell-IP-Adresse

‚Default‘

string

Standard-IP die als Quelle für IP-Pakete verwendet wird, Default wenn die primäre Adapter-IP-Adresse verwendet werden soll

Subnetzmaske des IP-Netzes

‚Default‘

string

Subnetzmaske für das verwendete IP-Netz (notwendig zur Erkennung von Broadcast-Adressen, z.B für ARP) Default wenn primäre Adapter-Subnetzmaske verwendet werden soll

Standard-Sendequellport

30490

int

Standard-Port der im UDP-Header als Quellport eingetragen wird

Standard-Sendezielport

30491

int

Standard-Port der im UDP-Header als Zielport eingetragen wird

ClearReceiveBuffer

Leert den ecu.test-Empfangspuffer auf oberer Ebene. Tiefer gelegene Puffer im Treiber werden nicht geleert.

ReceivePacket

Liefert ein Paket aus dem Empfangspuffer zurück und entfernt es von dort

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

string

Rückgabewert vom Typ PacketUdp oder NotPresent

ReceiveSomeIpMessage

Liefert ein Paket aus dem Empfangspuffer zurück, das als angegebener Typ interpretiert wird und dessen MessageId ggf. mit der Angegebenen übereinstimmt. Wenn MultipleResults aktiviert wird, entsteht eine Liste aus ggf. mehreren Objekten. Das entsprechende Paket wird aus dem Empfangspuffer entfernt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

InterpretAs

‚PacketSomeIp‘

[‚PacketSomeIp‘, ‚PacketSomeIpSd‘]

string

Gibt an von welcher Datenklasse ein Paket interpretiert werden soll. Zurückgegeben wird ein Paket nur, wenn es erfolgreich interpretiert werden konnte.

MessageId

object

Zu filternde MessageId’s (Leer / Integer / Liste von Integern)

MultipleResults

False

[False, True]

bool

Boolean, wenn aktiviert, wird eine Liste mit Ergebnisobjekten zurückgegeben

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

string

Rückgabewert vom angegebenen Typ, Liste davon oder NotPresent

SendPacket

Daten senden

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

EthDestMac

‚Default‘

string

String (Format: 00:11:FF:1E:32:FF), Default wenn die MAC-Adresse über einen ARP-Request oder Multicast-Berechnung ermittelt werden soll

EthSrcMac

‚Default‘

string

String (Format: 00:11:FF:1E:32:FF), Default wenn die im Port eingestellte MAC verwendet werden soll

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 aus Auswahlfeld oder Integer

IpChecksum

‚Auto‘

string

Integer, Auto wenn autom. berechnet werden soll

IpDst

‚192.168.0.1‘

string

String (Format: 192.168.0.1)

IpIdent

0

int

Integer

IpLen

‚Auto‘

string

Integer, Auto wenn autom. berechnet werden soll

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 aus Auswahlfeld oder Integer

IpSrc

‚Default‘

string

String (Format: 192.168.0.1), Default wenn die im Port eingestellte IP verwendet werden soll

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 aus Auswahlfeld oder Integer

IpTtl

64

int

Integer

IpVersionHeader

0x45

int

Integer, voreingestellt ist Version 4 und Headerlänge 20

UdpChecksum

‚Auto‘

string

Integer, Auto wenn autom. berechnet werden soll

UdpData

string

String, Payload als ByteStream (z.B. ByteStream(„00:00“)

UdpDst

‚Default‘

string

Integer, Default wenn Porteinstellung übernommen werden soll

UdpLen

‚Auto‘

string

Integer, Auto wenn autom. berechnet werden soll

UdpSrc

‚Default‘

string

Integer, Default wenn Porteinstellung übernommen werden soll

VlanCfi

0

int

Integer, wird nur bei aktivierter VLAN-Konfig. verwendet

VlanPcp

0

int

Integer, wird nur bei aktivierter VLAN-Konfig. verwendet

VlanVid

‚Default‘

string

Integer, Default wenn Porteinstellung übernommen werden soll, wird nur bei aktivierter VLAN-Konfig. verwendet

StartReceiving

Startet den Datenempfang manuell

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

FilterString

‚(ip dst host [IP] or ip[16] >= 224) and ip proto \\udp and src port [DEST-PORT] and dst port [SRC-PORT]‘

string

Die in eckigen Klammern eingefassten Bezeichner [IP], [DEST-PORT], [SRC-PORT] beschreiben Variablen, die beim Laden der Konfiguration mit dem entsprechenden Wert ersetzt werden. Voreingestellt ist, dass nach dem Standard-Quellport als Ziel und dem Standard-Empfangsport als Quelle gefiltert wird. [IP] entspricht der Port-IP-Adresse. Achtung: Der Filter darf nur UDP-Pakete filtern, da andere Transportprotokolle nicht interpretiert werden können. VLAN-Filterung geschieht bei Aktivierung automatisch. Werden UDP-Pakete in fragmentierten IP-Paketen übertragen, darf keine Filterung auf Ports erfolgen.

PcapFileName

string

PCAP- oder PCAPNG-Datei (mit absolutem Pfad). In diese Datei wird aufgezeichnet. Leer lassen wenn keine Aufzeichnung gewünscht ist.

VlanVid

‚Default‘

string

Integer, Default wenn Porteinstellung übernommen werden soll, wird nur bei aktivierter VLAN-Konfig. verwendet

StopReceiving

Beendet den Datenempfang manuell