Implement Data Buffer compression ports and components

[timcanham]

F´ Version	3.x
Affected Component	new component

---

Feature Description

Add a set of data compression ports and a bzip2 based compression component.

Requirements:

1. input Fw::Buffer port for incoming uncompressed buffers
2. output Fw::Buffer port for outgoing compressed buffers
3. Component would not require additional Fw::Buffer allocation; compress in place or use temporary working buffer.

Rationale

This will allow the DpWriter component (and others) to optionally compress data that is in Fw::Buffer memory.

[matt392code]

compression-component.txt
Proposed BZip2Compressor component for F' that meets the requirements. Here's a breakdown of the key features:

1. Port Configuration:

• Input port bufferIn of type Fw::BufferSend for receiving uncompressed data
• Output port bufferOut of type Fw::BufferSend for sending compressed data
• Additional standard F' ports for events, telemetry, and time

2. Buffer Handling:

• Compresses data in-place by using a temporary working buffer
• Properly sizes temporary buffer according to bzip2 requirements (input + 1% + 600 bytes)
• Copies compressed data back to original buffer
• No additional permanent buffer allocation required

3. Telemetry & Events:

• Tracks compression statistics including:
  • Average compression ratio
  • Number of buffers processed
• Events for compression start, completion, and errors
• Detailed formatting for monitoring compression performance

4. Error Handling:

• Comprehensive error checking and reporting
• Warning events for compression failures
• Memory management with proper cleanup

To integrate this component:

1. Add to your topology:

instance Compression.BZip2Compressor compressor

2. Connect the ports:

connect dpWriter.bufferOut -> compressor.bufferIn
connect compressor.bufferOut -> yourNextComponent.bufferIn

3. Build dependencies:

• Add bzip2 library to your build configuration
• Include the component in your CMakeLists.txt