raddsp_axis_matrix_elementwise Datasheet

Use Cases

AXI-Stream datapath integration where module boundaries need explicit ready/valid behavior.
Reusable FPGA DSP pipelines that need fixed-point, timing-aware implementation.
Memory-mapped control/status integration with software-visible register maps.

Block Diagram

VHDL Include And Instantiation Template

File Header

library ieee;
use ieee.std_logic_1164.all;
use ieee.numeric_std.all;

library radhdl;
-- Direct entity instantiation below does not require importing the entity name.
use radhdl.dsp.all;
-- Narrower alternative: use radhdl.dsp_matrix.all;

Component Declaration

component raddsp_axis_matrix_elementwise is
  generic (
    VENDOR : string := "xilinx";
    DEVICE_FAMILY : string := "generic";
    DATA_WIDTH : positive := 16;
    COEFF_FRAC_BITS : natural := 15
  );
  port (
    s0_axis_tvalid : in std_logic;
    s0_axis_tready : out std_logic;
    s0_axis_tdata : in std_logic_vector(DATA_WIDTH - 1 downto 0);
    s0_axis_tlast : in std_logic;
    s1_axis_tvalid : in std_logic;
    s1_axis_tready : out std_logic;
    s1_axis_tdata : in std_logic_vector(DATA_WIDTH - 1 downto 0);
    s1_axis_tlast : in std_logic;
    m_axis_tvalid : out std_logic;
    m_axis_tready : in std_logic;
    m_axis_tdata : out std_logic_vector(DATA_WIDTH - 1 downto 0);
    m_axis_tlast : out std_logic;
    clk : in std_logic;
    rst : in std_logic;
    op_i : in std_logic_vector(1 downto 0)
  );
end component;

Direct Entity Instantiation

u_raddsp_axis_matrix_elementwise : entity radhdl.raddsp_axis_matrix_elementwise
  generic map (
    VENDOR          => "xilinx",
    DEVICE_FAMILY   => "generic",
    DATA_WIDTH      => 16,
    COEFF_FRAC_BITS => 15
  )
  port map (
    s0_axis_tvalid => <s0_axis_tvalid_signal>,
    s0_axis_tready => <s0_axis_tready_signal>,
    s0_axis_tdata  => <s0_axis_tdata_signal>,
    s0_axis_tlast  => <s0_axis_tlast_signal>,
    s1_axis_tvalid => <s1_axis_tvalid_signal>,
    s1_axis_tready => <s1_axis_tready_signal>,
    s1_axis_tdata  => <s1_axis_tdata_signal>,
    s1_axis_tlast  => <s1_axis_tlast_signal>,
    m_axis_tvalid  => <m_axis_tvalid_signal>,
    m_axis_tready  => <m_axis_tready_signal>,
    m_axis_tdata   => <m_axis_tdata_signal>,
    m_axis_tlast   => <m_axis_tlast_signal>,
    clk            => <clk_signal>,
    rst            => <rst_signal>,
    op_i           => <op_i_signal>
  );

Generics

Name	Type	Default	Description
VENDOR	string	"xilinx"	Selects the vendor-specific implementation path, usually XILINX for DSP48/XPM-backed builds or generic for portable RTL.
DEVICE_FAMILY	string	"generic"	Identifies the target FPGA family so wrappers can choose the correct primitive or conservative portable behavior.
DATA_WIDTH	positive	16	Sets the bit width for DATA WIDTH values carried by this module.
COEFF_FRAC_BITS	natural	15	Sets coefficient precision or coefficient count for the fixed-point DSP operation.

Ports

Name	Direction	Type	Description
s0_axis_tvalid	in	std_logic	S0 axis tvalid interface signal.
s0_axis_tready	out	std_logic	S0 axis tready interface signal.
s0_axis_tdata	in	std_logic_vector(DATA_WIDTH - 1 downto 0)	S0 axis tdata interface signal.
s0_axis_tlast	in	std_logic	S0 axis tlast interface signal.
s1_axis_tvalid	in	std_logic	S1 axis tvalid interface signal.
s1_axis_tready	out	std_logic	S1 axis tready interface signal.
s1_axis_tdata	in	std_logic_vector(DATA_WIDTH - 1 downto 0)	S1 axis tdata interface signal.
s1_axis_tlast	in	std_logic	S1 axis tlast interface signal.
m_axis_tvalid	out	std_logic	Output AXI-stream valid qualifier for the current result beat.
m_axis_tready	in	std_logic	Output AXI-stream ready input from the downstream block.
m_axis_tdata	out	std_logic_vector(DATA_WIDTH - 1 downto 0)	Output AXI-stream payload containing packed processed result lanes.
m_axis_tlast	out	std_logic	Output AXI-stream frame marker aligned with the processed result beat.
clk	in	std_logic	Clock for the associated synchronous logic and handshake domain.
rst	in	std_logic	Active-high synchronous reset for this clock domain.
op_i	in	std_logic_vector(1 downto 0)	Input op i signal for this module.

Register Interfaces

No fixed register map was found; this section documents the exposed register/control interface ports.

Interface	Directions	Signals	Representative ports
M_AXIS	in, out	4	m_axis_tvalid, m_axis_tready, m_axis_tdata, m_axis_tlast

Testbenches

tb_raddsp_axis_smoke captured waveform

Source: dsp/hdl/testbenches/tb_raddsp_axis_smoke.vhd

Self-checking or stimulus-focused testbench for axis smoke. Exercises representative handshakes, reset behavior, frame boundaries, and numeric corner cases for regression runs.

Artifacts: status, vcd

Data Plots

Gain Core Response

Input and output samples for the scalar AXI-stream gain core.

FIR Two-Tap Accumulation

Short impulse-style sequence showing the two-tap FIR summing current and prior samples.

Biquad Sequential Path

Sequential-MAC biquad smoke response with feed-forward coefficient b0 set for unity behavior.

Matrix Dot Product Output

Dot-product smoke output and accumulated element count.

Captured GHDL Waveform

Source: dsp/hdl/testbenches/tb_raddsp_axis_smoke.vhd

Horizontal Vertical

clk

rst

gain_coeff[15:0]

gain2_coeff[31:0]

gain2_s_valid

gain2_s_ready

gain2_s_data[31:0]

gain2_s_last

gain2_m_valid

gain2_m_ready

gain2_m_data[31:0]

gain2_m_last

bq_b0[15:0]

bq_z[15:0]

bq_s_valid

bq_s_ready

bq_s_data[15:0]

bq_s_last

bq_m_valid

bq_m_ready

bq_m_data[15:0]

bq_m_last

bq_seq_s_valid

bq_seq_s_ready

bq_seq_s_data[15:0]

bq_seq_s_last

bq_seq_m_valid

bq_seq_m_ready

bq_seq_m_data[15:0]

bq_seq_m_last

lp_seq_s_valid

lp_seq_s_ready

lp_seq_s_data[15:0]

lp_seq_s_last

lp_seq_m_valid

lp_seq_m_ready

lp_seq_m_data[15:0]

lp_seq_m_last

fir_taps[31:0]

fir_s_valid

fir_s_ready

fir_s_data[15:0]

fir_s_last

fir_m_valid

fir_m_ready

fir_m_data[15:0]

fir_m_last

fir_seq_s_valid

fir_seq_s_ready

fir_seq_s_data[15:0]

fir_seq_s_last

fir_seq_m_valid

fir_seq_m_ready

fir_seq_m_data[15:0]

fir_seq_m_last

mat_op[1:0]

mat_s0_valid

mat_s0_ready

mat_s0_data[15:0]

mat_s0_last

mat_s1_valid

mat_s1_ready

mat_s1_data[15:0]

mat_s1_last

mat_m_valid

mat_m_ready

mat_m_data[15:0]

mat_m_last

dot_s0_valid

dot_s0_ready

dot_s0_data[15:0]

dot_s0_last

dot_s1_valid

dot_s1_ready

dot_s1_data[15:0]

dot_s1_last

dot_m_valid

dot_m_ready

dot_m_data[31:0]

dot_m_last

dot_count[31:0]

gain_i[15:0]

out_valid_r

out_data_r[15:0]

out_last_r

busy_r

ready_i

mul_valid[0:0]

mul_last[0:0]

mul_p_valid[0:0]

mul_p_last[0:0]

unused_sub[0:0]

valid_i

subtract_i

last_i

a_i[15:0]

M_AXIS interface signals

M_AXIS Interface Waveform

Source: dsp/hdl/testbenches/tb_raddsp_axis_smoke.vhd

Horizontal Vertical

m_axis_tvalid

m_axis_tready

m_axis_tdata[15:0]

m_axis_tlast

m_axis_tdata[31:0]

S_AXIS interface signals

S_AXIS Interface Waveform

Source: dsp/hdl/testbenches/tb_raddsp_axis_smoke.vhd

Horizontal Vertical

s_axis_tvalid

s_axis_tready

s_axis_tdata[15:0]

s_axis_tlast

s_axis_tdata[31:0]

Sources

dsp/hdl/raddsp/src/raddsp_axis_matrix_elementwise.vhd