Svc::BufferRepeater: Buffer Repeater (Passive Component)

1. Introduction

The BufferRepeater component is designed to take in an Fw::buffer port call and repeat it to multiple output ports. New memory is allocated from a Svc::BufferManager and the data is copied to ensure that each downstream component has full ownership of its data. The original buffer is deallocated. Users call configure to set the response of the component when allocation requests fail.

2. Requirements

3. Design

The buffer repeater has a single portIn port of type Fw.BufferSend and an array of portOut ports of the same type. Each port call received on portIn is repeated to each connected portOut port. These repetitions emit a copy of the Fw::Buffer data.

3.1 Ports

Svc::BufferRepeater has the following ports:

3.1.1 portIn handler

The portIn port handler receives an Fw::Buffer data type and a port number. For each connected portOut port it allocates new memory large enough to hold a copy of the Fw::Buffer data via the allocate port, copies the data to the new invocation, and sends it to the active portOut port. This continues until each portOut port has been tried and at the end it returns the original buffer via deallocate.

Should an allocation fail, portOut is not called and an event may be emitted (see below).

3.2 Events

4. Configuration

Buffer repeater maximum output ports are configured using AcConstants.fpp as shown below:

constant BufferRepeaterOutputPorts = 10

The component's response to allocation failures is configured with a call to the configure method during system initialization. Possible values include:

bufferRepeater.configure(Svc::BufferRepeater::FATAL_ON_OUT_OF_MEMORY);