Loading files
This file is pinned to the selected release. Download the original to open it in your design tool.
// Copyright 2024 ETH Zurich and University of Bologna.
// Solderpad Hardware License, Version 0.51, see LICENSE for details.
// SPDX-License-Identifier: SHL-0.51
// Authors:
// - Thomas Benz <tbenz@iis.ee.ethz.ch>
// - Tobias Senti <tsenti@ethz.ch>
`include "common_cells/assertions.svh"
`include "common_cells/registers.svh"
/// Stream FIFO that does not cut the timing path. When full; pushing data is allowed if in
/// the same cycle data is popped. Creates longer timing paths but can use buffer space more
/// efficiently.
module cc_passthrough_stream_fifo #(
/// Depth can be arbitrary from 2 to 2**32
parameter int unsigned Depth = 32'd8,
/// Print information when the simulation launches
parameter bit PrintInfo = 1'b0,
/// If the FIFO is full, allow reading and writing in the same cycle
parameter bit SameCycleRW = 1'b1,
/// Type of the FIFO
parameter type data_t = logic
) (
/// Clock
input logic clk_i,
/// Asynchronous reset active low
input logic rst_ni,
/// Synchronous clear active high; clears all sequential logic
input logic clr_i,
/// Fifo flush. Compared to clr_i, this only clears internal pointers.
/// Sufficient for most functional purposes.
input logic flush_i,
/// data to push into the FIFO
input data_t data_i,
/// input data valid
input logic valid_i,
/// FIFO is not full
output logic ready_o,
/// output data
output data_t data_o,
/// FIFO is not empty
output logic valid_o,
/// pop head from FIFO
input logic ready_i
);
/// Bit Width of the read and write pointers
/// One additional bit to detect overflows
localparam int unsigned PointerWidth = $clog2(Depth) + 1;
// Read and write pointers
logic [PointerWidth-1:0] read_ptr_d, read_ptr_q;
logic [PointerWidth-1:0] write_ptr_d, write_ptr_q;
// Data
data_t [Depth-1:0] data_d, data_q;
// Enable storage
logic load_data;
assign data_o = data_q[read_ptr_q[PointerWidth-2:0]];
// Logic
always_comb begin
// Default
load_data = 1'b0;
read_ptr_d = read_ptr_q;
write_ptr_d = write_ptr_q;
data_d = data_q;
if (flush_i) begin // Flush
read_ptr_d = '0;
write_ptr_d = '0;
valid_o = 1'b0;
ready_o = 1'b0;
end else begin
// Read
valid_o = read_ptr_q[PointerWidth-1] == write_ptr_q[PointerWidth-1]
? read_ptr_q[PointerWidth-2:0] != write_ptr_q[PointerWidth-2:0] : 1'b1;
if (ready_i && valid_o) begin
if (read_ptr_q[PointerWidth-2:0] == (Depth-1)) begin
// On overflow reset pointer to zero and flip imaginary bit
read_ptr_d[PointerWidth-2:0] = '0;
read_ptr_d[PointerWidth-1] = !read_ptr_q[PointerWidth-1];
end else begin
// Increment counter
read_ptr_d = read_ptr_q + 'd1;
end
end
// Write -> Also able to write if we read in the same cycle
ready_o = (read_ptr_q[PointerWidth-1] == write_ptr_q[PointerWidth-1]
? 1'b1 : write_ptr_q[PointerWidth-2:0] != read_ptr_q[PointerWidth-2:0])
|| (SameCycleRW && ready_i && valid_o);
if (valid_i && ready_o) begin
load_data = 1'b1;
data_d[write_ptr_q[PointerWidth-2:0]] = data_i;
if (write_ptr_q[PointerWidth-2:0] == (Depth-1)) begin
// On overflow reset pointer to zero and flip imaginary bit
write_ptr_d[PointerWidth-2:0] = '0;
write_ptr_d[PointerWidth-1] = !write_ptr_q[PointerWidth-1];
end else begin
// Increment pointer
write_ptr_d = write_ptr_q + 'd1;
end
end
end
end
// Flip Flops
`FFARNC( read_ptr_q, read_ptr_d, clr_i, '0, clk_i, rst_ni)
`FFARNC(write_ptr_q, write_ptr_d, clr_i, '0, clk_i, rst_ni)
`FFLARNC(data_q, data_d, load_data, clr_i, '0, clk_i, rst_ni)
endmodule
4f62c83c0This file is pinned to the selected release. Download the original to open it in your design tool.