doom_riscv/projects/riscv_usb/rtl/mailbox_wb_rtl2sw.v

/*
 * mailbox_wb_rtl2sw.v
 *
 * vim: ts=4 sw=4
 *
 * Copyright (C) 2025 Krzysztof Skrzynecki, Jakub Duchniewicz <j.duchniewicz@gmail.com>
 * SPDX-License-Identifier: TODO:
 */

`default_nettype none

module mailbox_wb_rtl2sw #(
    parameter AW = 4,  // Address width for 16 registers (4 bits)
    parameter DW = 32,   // Data width for the Wishbone interface (32 bits)
    parameter REG_WIDTH = 8
)(
    input  wire             clk,
    input  wire             rst,
    // Wishbone Interface
    input  wire [AW-1:0]    wb_addr,
    output reg  [DW-1:0]    wb_rdata,
    input  wire             wb_cyc,
    output reg              wb_ack,

    input wire [REG_WIDTH*16-1:0] registers_flat_in
);
    localparam DW_PADDING = DW - REG_WIDTH;

    // Internal registers (16 registers, each 16 bits wide)
    reg [REG_WIDTH-1:0] registers_array[15:0];

    generate
        genvar j;
        for (j = 0; j < 16; j = j + 1) begin : unflatten_ro
            always @(posedge clk) begin
                // Continuously update read-only registers
                // from the hardware input
                registers_array[j] <= registers_flat_in[REG_WIDTH*(j+1)-1 : REG_WIDTH*j];
            end
        end
    endgenerate

    // Always reset the registers on reset signal
    integer i;
    always @(posedge clk) begin
        begin
            // Default no ack
            wb_ack <= 1'b0;

            if (wb_cyc) begin
                // Read operation (read the correct register based on address)
                case (wb_addr)
                    4'b0000: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[0]}; // Place 16-bit value in lower half of 32-bit bus
                    4'b0001: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[1]};
                    4'b0010: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[2]};
                    4'b0011: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[3]};
                    4'b0100: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[4]};
                    4'b0101: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[5]};
                    4'b0110: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[6]};
                    4'b0111: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[7]};
                    4'b1000: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[8]};
                    4'b1001: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[9]};
                    4'b1010: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[10]};
                    4'b1011: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[11]};
                    4'b1100: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[12]};
                    4'b1101: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[13]};
                    4'b1110: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[14]};
                    4'b1111: wb_rdata <= {{DW_PADDING{1'b0}}, registers_array[15]};
                    default: wb_rdata <= 32'hDEAD_BEEF; // Default error value
                endcase

                // Acknowledge for exactly 1 cycle
                wb_ack <= 1'b1;
            end
        end
    end

endmodule