SOME/IP ARXML Substream Decoder Plugin

Table of Contents

• SOME/IP ARXML Substream Decoder

SOME/IP ARXML Substream Decoder

Plugin Information

Plugin Filename	someip_substream_decoder.adtfplugin
Plugin Description	someip_substream_decoder.plugindescription
Plugin Name	SOME IP ARXML Substream Decoder Plugin
License	ADTF
Support Mail	support@digitalwerk.net
Homepage URL	www.digitalwerk.net

Plugin Versions

Plugin Version	3.12.1
Plugin File Version	1.0
adtf::devicetb	3.12.1
adtf	3.18.3
adtf::ucom	3.1.0

Component Information

Name	SOME IP ARXML Substream Decoder
CID	someip_substream_decoder.filter.devicetb.cid
Description	Use this filter to decode an SOME/IP or Autosar Pdu stream as Substream.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
enable_logging	true	tBool	Enable verbose logging for all TP failures and bitstream corruptions. Regardless of whether logging is enabled or not, faulty samples will be forwarded to the corresponding output pins.
substream_names	0	tUInt32	Switch between different sources of substream names. Pick a fully qualified source if short names are not unique within the cluster.	Value List: PDU shortname = 0 PDU fully qualified path = 1
tp_garbage_collection_timeout	100000000	tNanoSeconds	Time in nanoseconds after which a SOME/IP TP fragment is considered stale. Garbage collection happens periodically and discards all fragments older than the threshold.

Input Pins

Name	Stream Type	Description
input_some_ip	adtf/devicetb/someip	The SOME/IP sample stream to decode.

Output Pins

Name	Stream Type	Description
output_messages	adtf/substreams	The decoded SOME/IP sample stream as requestable substreams.
output_some_ip_unknown	adtf/devicetb/someip	Forwarded raw SOME/IP samples which were not matched by the backing SOME/IP database. If the input sample contains a mix of known and unknown message IDs, the entire input sample is forwarded.
output_some_ip_tp_failure	adtf/devicetb/someip	Raw SOME / IP samples which were impossibble to decode due to TP sequence errors or timeouts. If the input sample contains a mix of well-formed and failed messages, the entire input sample is forwarded. In case of reassembly faults, sample timestamps may have been increased up to the timestamp of the last received fragment. Only guaranteed to contain samples for messages which are being decoded, e.g. the corresponding substream has been requested.
output_some_ip_corrupt	adtf/devicetb/someip	Raw SOME / IP samples which were impossibble to decode due to protocol violations. If the input sample contains a mix of well-formed and corrupted messages, the entire input sample is forwarded. In case of reassembly faults, sample timestamps may have been increased up to the timestamp of the last received fragment. Only guaranteed to contain samples for messages which are being decoded, e.g. the corresponding substream has been requested.

Runner

Name	Activation Type	Data Triggered	Data Input	Thread Triggered	Thread Cyclic	Timer Triggered	Timer Interval	Description
process_input_some_ip	9	1	input_some_ip	0	0	0	0	Default runner port for the input pin 'input_some_ip'

Dynamic Pins

Dynamic Input Pins	false
Dynamic Output Pins	false
Dynamic Input Binding Pins	false
Dynamic Output Binding Pins	false

Required Interfaces

IID
someip_service.hood.someip.sdk.devicetb.adtf.iid
reference_clock.riddler.streaming.adtf.iid

Input Pin Stream Types

Pin Name	input_some_ip
Meta Type Name	adtf/devicetb/someip
Stream Type Properties	Name Value Type Description Subproperties database cString md_data_serialized true tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> <adtf:ddl xmlns:adtf="adtf"> <structs> <struct name="tSomeIpSampleHeader" version="1" ddlversion="4.0"> <element name="nVLANId" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="bIsTCP" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="2" byteorder="LE"/> </element> <element name="bIsIPv6" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="3" byteorder="LE"/> </element> <element name="nMessageCount" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="4" byteorder="LE"/> </element> <element name="aSrcIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="6" byteorder="LE"/> </element> <element name="aDstIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="22" byteorder="LE"/> </element> <element name="nSrcPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="38" byteorder="LE"/> </element> <element name="nDstPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="40" byteorder="LE"/> </element> <element name="nMessageDataSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="42" byteorder="LE"/> </element> <element name="aMessageData" type="tUInt8" arraysize="nMessageDataSize"> <deserialized alignment="1"/> <serialized bytepos="46" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl> cString md_struct tSomeIpSampleHeader cString

Output Pin Stream Types

Pin Name	output_messages
Meta Type Name	adtf/substreams
Stream Type Properties	Name Value Type Description Subproperties substreams true tBool

Pin Name	output_some_ip_unknown
Meta Type Name	adtf/devicetb/someip
Stream Type Properties	Name Value Type Description Subproperties database cString md_data_serialized true tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> <adtf:ddl xmlns:adtf="adtf"> <structs> <struct name="tSomeIpSampleHeader" version="1" ddlversion="4.0"> <element name="nVLANId" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="bIsTCP" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="2" byteorder="LE"/> </element> <element name="bIsIPv6" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="3" byteorder="LE"/> </element> <element name="nMessageCount" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="4" byteorder="LE"/> </element> <element name="aSrcIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="6" byteorder="LE"/> </element> <element name="aDstIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="22" byteorder="LE"/> </element> <element name="nSrcPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="38" byteorder="LE"/> </element> <element name="nDstPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="40" byteorder="LE"/> </element> <element name="nMessageDataSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="42" byteorder="LE"/> </element> <element name="aMessageData" type="tUInt8" arraysize="nMessageDataSize"> <deserialized alignment="1"/> <serialized bytepos="46" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl> cString md_struct tSomeIpSampleHeader cString

Pin Name	output_some_ip_tp_failure
Meta Type Name	adtf/devicetb/someip
Stream Type Properties	Name Value Type Description Subproperties database cString md_data_serialized true tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> <adtf:ddl xmlns:adtf="adtf"> <structs> <struct name="tSomeIpSampleHeader" version="1" ddlversion="4.0"> <element name="nVLANId" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="bIsTCP" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="2" byteorder="LE"/> </element> <element name="bIsIPv6" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="3" byteorder="LE"/> </element> <element name="nMessageCount" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="4" byteorder="LE"/> </element> <element name="aSrcIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="6" byteorder="LE"/> </element> <element name="aDstIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="22" byteorder="LE"/> </element> <element name="nSrcPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="38" byteorder="LE"/> </element> <element name="nDstPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="40" byteorder="LE"/> </element> <element name="nMessageDataSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="42" byteorder="LE"/> </element> <element name="aMessageData" type="tUInt8" arraysize="nMessageDataSize"> <deserialized alignment="1"/> <serialized bytepos="46" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl> cString md_struct tSomeIpSampleHeader cString

Pin Name	output_some_ip_corrupt
Meta Type Name	adtf/devicetb/someip
Stream Type Properties	Name Value Type Description Subproperties database cString md_data_serialized true tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> <adtf:ddl xmlns:adtf="adtf"> <structs> <struct name="tSomeIpSampleHeader" version="1" ddlversion="4.0"> <element name="nVLANId" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="bIsTCP" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="2" byteorder="LE"/> </element> <element name="bIsIPv6" type="bool" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="3" byteorder="LE"/> </element> <element name="nMessageCount" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="4" byteorder="LE"/> </element> <element name="aSrcIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="6" byteorder="LE"/> </element> <element name="aDstIP" type="tUInt8" arraysize="16"> <deserialized alignment="1"/> <serialized bytepos="22" byteorder="LE"/> </element> <element name="nSrcPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="38" byteorder="LE"/> </element> <element name="nDstPort" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="40" byteorder="LE"/> </element> <element name="nMessageDataSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="42" byteorder="LE"/> </element> <element name="aMessageData" type="tUInt8" arraysize="nMessageDataSize"> <deserialized alignment="1"/> <serialized bytepos="46" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl> cString md_struct tSomeIpSampleHeader cString