agc_complex.hdl HDL Worker

Detail

The response time and output level of the circuit are programmable, as is the ability to update/hold the gain differential used in the feedback loop. The size of the averaging window used for peak detection is build-time programmable using the avg_window parameter, which is recommended to be a power-of-two to enable hardware division implementation with shift registers. The ref property controls the desired output amplitude, while the mu property controls the AGC time constant, thus determining the response time of the circuit.

This implementation uses three multipliers per I/Q rail to process input data at the clock rate - i.e. this worker can handle a new input value every clock cycle. This circuit will produce output one clock cycle after each valid input, but the input-to-output latency is actually three valid clock cycles. The AGC Complex worker utilizes the OCPI iqstream protocol for both input and output ports. The iqstream protocol defines an interface of 16-bit complex signed samples. The data_width parameter may be used to reduce the worker’s internal data width to less than 16-bits.

Worker Properties

• data_width

  • Type: ushort

  • Access:

    • Parameter: True

    • Writable: False

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: None

• avg_window

  • Type: ushort

  • Access:

    • Parameter: True

    • Writable: False

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: None

• hold

  • Type: bool

  • Access:

    • Parameter: False

    • Writable: True

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: false

• ref

  • Type: ushort

  • Access:

    • Parameter: False

    • Writable: True

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: 16383

• mu

  • Type: ushort

  • Access:

    • Parameter: False

    • Writable: True

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: None

• ocpi_buffer_size_out

  • Type: ushort

  • Access:

    • Parameter: False

    • Writable: False

    • Initial: True

    • Volatile: False

    • Read back: False

  • Default value: 0

• ocpi_blocked_out

  • Type: ulong

  • Access:

    • Parameter: False

    • Writable: False

    • Initial: False

    • Volatile: True

    • Read back: False

  • Default value: None

• ocpi_max_latency_out

  • Type: ushort

  • Access:

    • Parameter: True

    • Writable: False

    • Initial: False

    • Volatile: False

    • Read back: False

  • Default value: None

• ocpi_latency_out

  • Type: ushort

  • Access:

    • Parameter: False

    • Writable: False

    • Initial: False

    • Volatile: True

    • Read back: False

  • Default value: None

• ocpi_messages_out

  • Type: ulong

  • Access:

    • Parameter: False

    • Writable: False

    • Initial: False

    • Volatile: True

    • Read back: False

  • Default value: None

• ocpi_bytes_out

  • Type: ulong

  • Access:

    • Parameter: False

    • Writable: False

    • Initial: False

    • Volatile: True

    • Read back: False

  • Default value: None

Worker Ports

Inputs:

• in

  • Protocol: iqstream

  • Optional: False

Outputs:

• out

  • Protocol: iqstream

  • Optional: False

Utilization

Utilization reporting is not currently implemented.