PCap BPF Ethernet Reducer

Note: The PCap BPF Ethernet Reducer uses libpcap to filter raw ethernet frames. Due to licensing issues the pcap library is not part of the the Device Toolbox - to be able to use the PCap BPF Ethernet Reducer make sure that libpcap is installed on your system. On Linux this is usually a matter of installing the libpcap package provided by your distribution.

Windows users can choose from a number of PCap implementations such as npcap, winpcap or win10pcap. With Wireshark installed and working on your Windows system there is a good chance that the PCap BPF Ethernet Reducer will work, too.

Plugin Information

Plugin Filename	pcap_bpf_ethernet_reducer.adtfplugin
Plugin Description	pcap_bpf_ethernet_reducer.plugindescription
Plugin Name	PCap BPF Ethernet Reducer Plugin
License	ADTF
Support Mail	support@digitalwerk.net
Homepage URL	www.digitalwerk.net

Plugin Versions

Component Information

Name	PCap BPF Ethernet Reducer
CID	pcap_bpf_ethernet_reducer.filter.devicetb.cid
Description	Use this filter to output only a subset of the incoming raw ethernet stream by using a Berkeley Packet Filter.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
berkeley_packet_filter		cString	Definition of the subset to filter.

Input Pins

Name	Stream Type	Description
ethernet_in	adtf/devicetb/ethernet	Sample stream containing raw ethernet samples to create a subset of.

Output Pins

Name	Stream Type	Description
ethernet_out	adtf/devicetb/ethernet	Provides the filtered subset of raw ethernet samples.

Runner

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

Dynamic Pins

Required Interfaces

IID
reference_clock.flash.streaming.adtf.iid

Input Pin Stream Types

Pin Name

ethernet_in

Meta Type Name

adtf/devicetb/ethernet

Stream Type Properties

Name	Value	Type
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="tEthernetSampleHeader" version="1" ddlversion="4.0"> <element name="tmTimestampBeginNs" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="tmTimestampEndNs" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="8" byteorder="LE"/> </element> <element name="nErrorCode" type="tInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="16" byteorder="LE"/> </element> <element name="nFrameCheckSequence" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="20" byteorder="LE"/> </element> <element name="nFrameSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="24" byteorder="LE"/> </element> <element name="aFrameData" type="tUInt8" arraysize="nFrameSize"> <deserialized alignment="1"/> <serialized bytepos="28" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl>	cString
md_struct	tEthernetSampleHeader	cString

Output Pin Stream Types

Pin Name

ethernet_out

Meta Type Name

adtf/devicetb/ethernet

Stream Type Properties

Name	Value	Type
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="tEthernetSampleHeader" version="1" ddlversion="4.0"> <element name="tmTimestampBeginNs" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="0" byteorder="LE"/> </element> <element name="tmTimestampEndNs" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="8" byteorder="LE"/> </element> <element name="nErrorCode" type="tInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="16" byteorder="LE"/> </element> <element name="nFrameCheckSequence" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="20" byteorder="LE"/> </element> <element name="nFrameSize" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized bytepos="24" byteorder="LE"/> </element> <element name="aFrameData" type="tUInt8" arraysize="nFrameSize"> <deserialized alignment="1"/> <serialized bytepos="28" byteorder="LE"/> </element> </struct> </structs> </adtf:ddl>	cString
md_struct	tEthernetSampleHeader	cString

Reference setup

Tested with win10pcap Version 10.2.5002, npcap Version 0.9995, Wireshark Version 3.2.5