admin/retroSoC
1
0 Fork 0
mirror of https://github.com/retroSoC/retroSoC.git synced 2026-11-06 14:55:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat: refactor XPI integration and add programming tool

Browse Source 
- Updated filelist to include new XPI source files.
- Modified IRQ compatibility mapping for XPI in the SOC topology generator.
- Adjusted JSON topology configuration to reflect new IRQ signal naming.
- Changed software.mk to reference the new XPI HAL source file.
- Enhanced APB4 peripheral module to include XPI IRQ signal.
- Updated RTL style audit to include new XPI files.
- Documented new XPI programming script in README.
- Added a new script for programming XPI flash through OpenOCD.
- Enhanced XPI IO testbench to validate new LUT engine and isolation behavior.
- Created unit tests for the new XPI programming tool and its functionalities.
This commit is contained in:
maksyuki committed 2026-08-20 20:48:36 +08:00
1 parent 075344df58
commit ef84c818b0
47 files changed
+5166 -2736
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

tests/rtl/xpi_io_tb.sv
+131 -88
View File
@@ -1,111 +1,154 @@
`timescale 1ns / 1ps
`include "xpi_define.svh"
module xpi_io_tb;
logic clk_i = 1'b0;
logic rst_n_i = 1'b0;
logic mode_i = 1'b0;
logic [`XPI_LNS_NUM-1:0] nss_i = '0;
logic [ 7:0] clkdiv_i = '0;
logic rdwr_i = 1'b0;
logic revdat_i = 1'b0;
logic [ 1:0] cmdtyp_i = `XPI_TYPE_NONE;
logic [ 2:0] cmdlen_i = '0;
logic [ 31:0] cmddat_i = '0;
logic [ 1:0] adrtyp_i = `XPI_TYPE_NONE;
logic [ 2:0] adrlen_i = '0;
logic [ 31:0] adrdat_i = '0;
logic [ 7:0] tdulen_i = '0;
logic [ 7:0] rdulen_i = '0;
logic [ 1:0] dattyp_i = `XPI_TYPE_NONE;
logic [ 7:0] datlen_i = '0;
logic [ 2:0] datbit_i = '0;
logic [ 7:0] hlvlen_i = '0;
logic tx_data_rdy_i = 1'b0;
logic [ 31:0] tx_data_i = '0;
logic rx_data_rdy_i = 1'b0;
logic start_i = 1'b0;
logic [ 7:0] tx_elem_num_i = '0;
logic dma_xfer_done_i = 1'b0;
logic tx_data_req_o;
logic rx_data_req_o;
logic [ 31:0] rx_data_o;
logic done_o;
import xpi_pkg::*;
logic clk_i = 1'b0;
logic rst_n_i = 1'b0;
logic start_i = 1'b0;
logic abort_i = 1'b0;
logic [ 1:0] slot_i = 2'd2;
logic mode3_i = 1'b0;
logic [ 7:0] clkdiv_i = 8'd0;
logic [ 7:0] cs_setup_i = 8'd0;
logic [ 7:0] cs_hold_i = 8'd0;
logic [ 7:0] cs_high_i = 8'd0;
logic [31:0] timeout_i = 32'd1000;
logic [31:0] address_i = 32'h0012_3456;
logic [15:0] data_len_i = 16'd1;
logic [15:0] lut_i [0:7];
logic tx_valid_i = 1'b0;
logic tx_ready_o;
logic [ 7:0] tx_data_i = 8'hA5;
logic rx_valid_o;
logic rx_ready_i = 1'b1;
logic [ 7:0] rx_data_o;
logic busy_o;
logic done_o;
logic error_o;
xpi_error_e error_code_o;
logic [ 2:0] error_pc_o;
logic phy_byte_event_o;
xpi_if xpi ();
logic s_saw_drive;
logic s_saw_receive_release;
logic s_saw_selected_slot;
always #5 clk_i = ~clk_i;
xpi_core dut (
.clk_i (clk_i),
.rst_n_i (rst_n_i),
.mode_i (mode_i),
.nss_i (nss_i),
.clkdiv_i (clkdiv_i),
.rdwr_i (rdwr_i),
.revdat_i (revdat_i),
.cmdtyp_i (cmdtyp_i),
.cmdlen_i (cmdlen_i),
.cmddat_i (cmddat_i),
.adrtyp_i (adrtyp_i),
.adrlen_i (adrlen_i),
.adrdat_i (adrdat_i),
.tdulen_i (tdulen_i),
.rdulen_i (rdulen_i),
.dattyp_i (dattyp_i),
.datlen_i (datlen_i),
.datbit_i (datbit_i),
.hlvlen_i (hlvlen_i),
.tx_data_req_o (tx_data_req_o),
.tx_data_rdy_i (tx_data_rdy_i),
.tx_data_i (tx_data_i),
.rx_data_req_o (rx_data_req_o),
.rx_data_rdy_i (rx_data_rdy_i),
.rx_data_o (rx_data_o),
.start_i (start_i),
.done_o (done_o),
.tx_elem_num_i (tx_elem_num_i),
.dma_xfer_done_i(dma_xfer_done_i),
.xpi (xpi)
xpi_core u_dut (
.clk_i (clk_i),
.rst_n_i (rst_n_i),
.start_i (start_i),
.abort_i (abort_i),
.slot_i (slot_i),
.mode3_i (mode3_i),
.clkdiv_i (clkdiv_i),
.cs_setup_i (cs_setup_i),
.cs_hold_i (cs_hold_i),
.cs_high_i (cs_high_i),
.timeout_i (timeout_i),
.address_i (address_i),
.data_len_i (data_len_i),
.lut_i (lut_i),
.tx_valid_i (tx_valid_i),
.tx_ready_o (tx_ready_o),
.tx_data_i (tx_data_i),
.rx_valid_o (rx_valid_o),
.rx_ready_i (rx_ready_i),
.rx_data_o (rx_data_o),
.busy_o (busy_o),
.done_o (done_o),
.error_o (error_o),
.error_code_o (error_code_o),
.error_pc_o (error_pc_o),
.phy_byte_event_o(phy_byte_event_o),
.xpi (xpi)
);
task automatic expect_pad(input logic [3:0] oe, input logic [3:0] data, input string state);
task automatic clear_lut;
begin
#1;
if (xpi.io_oe_o !== oe || xpi.io_do_o !== data) begin
$fatal(1, "%s pad drive was oe=%b data=%b", state, xpi.io_oe_o, xpi.io_do_o);
for (int index = 0; index < 8; index++) begin
lut_i[index] = xpi_instr(XpiInstrStop, 2'd0, 8'd0);
end
end
endtask
task automatic start_and_wait;
int timeout;
begin
@(negedge clk_i);
start_i = 1'b1;
@(negedge clk_i);
start_i = 1'b0;
timeout = 0;
while (!done_o && (timeout < 1200)) begin
@(posedge clk_i);
timeout++;
end
if (!done_o) $fatal(1, "XPI transaction timed out in testbench");
end
endtask
always @(posedge clk_i) begin
if (rst_n_i && busy_o) begin
if (xpi.io_oe_o != 4'b0000) s_saw_drive <= 1'b1;
if (rx_valid_o && (xpi.nss_o == 4'b1011) && (xpi.io_oe_o == 4'b0000)) begin
s_saw_receive_release <= 1'b1;
end
if (xpi.nss_o == 4'b1011) s_saw_selected_slot <= 1'b1;
if ((xpi.nss_o != 4'b1111) && (xpi.nss_o != 4'b1110) &&
(xpi.nss_o != 4'b1101) && (xpi.nss_o != 4'b1011) &&
(xpi.nss_o != 4'b0111)) begin
$fatal(1, "invalid NSS value %b", xpi.nss_o);
end
end
end
initial begin
repeat (2) @(posedge clk_i);
clear_lut();
xpi.io_di_i = 4'hF;
s_saw_drive = 1'b0;
s_saw_receive_release = 1'b0;
s_saw_selected_slot = 1'b0;
repeat (3) @(posedge clk_i);
rst_n_i = 1'b1;
force dut.s_xfer_data_q = 32'hABCD_1234;
repeat (2) @(posedge clk_i);
force dut.s_fsm_q = 3'd0;
expect_pad(4'b0001, 4'b0000, "idle");
if (xpi.sck_o !== 1'b0 || xpi.nss_o !== 4'b1111 || xpi.io_oe_o !== 4'b0000) begin
$fatal(1, "mode-0 reset pins were not idle");
end
lut_i[0] = xpi_instr(XpiInstrCommand, 2'd2, 8'hA5);
lut_i[1] = xpi_instr(XpiInstrDummy, 2'd0, 8'd2);
lut_i[2] = xpi_instr(XpiInstrReceive, 2'd2, 8'd1);
lut_i[3] = xpi_instr(XpiInstrStop, 2'd0, 8'd0);
start_and_wait();
if (error_o || !s_saw_drive || !s_saw_receive_release || !s_saw_selected_slot ||
(rx_data_o !== 8'hFF)) begin
$fatal(1, "mode-0 failed err=%b drive=%b release=%b slot=%b rx=%02x", error_o, s_saw_drive,
s_saw_receive_release, s_saw_selected_slot, rx_data_o);
end
cmdtyp_i = `XPI_TYPE_QUAD;
force dut.s_fsm_q = 3'd1;
expect_pad(4'b1111, 4'b1010, "command");
mode3_i = 1'b1;
clear_lut();
lut_i[0] = xpi_instr(XpiInstrCommand, 2'd0, 8'h9F);
lut_i[1] = xpi_instr(XpiInstrStop, 2'd0, 8'd0);
repeat (2) @(posedge clk_i);
if (xpi.sck_o !== 1'b1) $fatal(1, "mode-3 idle clock was not high");
start_and_wait();
if (error_o || xpi.sck_o !== 1'b1) $fatal(1, "mode-3 command failed");
dattyp_i = `XPI_TYPE_DUAL;
force dut.s_fsm_q = 3'd4;
expect_pad(4'b0011, 4'b0010, "transmit");
mode3_i = 1'b0;
for (int index = 0; index < 8; index++) begin
lut_i[index] = xpi_instr(XpiInstrCommand, 2'd0, 8'h06);
end
start_and_wait();
if (!error_o || (error_code_o != XpiErrorSequence) || (error_pc_o != 3'd7)) begin
$fatal(1, "unterminated LUT did not report instruction 7");
end
force dut.s_fsm_q = 3'd3;
expect_pad(4'b0000, 4'b0000, "dummy");
force dut.s_fsm_q = 3'd5;
xpi.io_di_i = 4'b0000;
expect_pad(4'b0000, 4'b0000, "receive low");
xpi.io_di_i = 4'b1111;
expect_pad(4'b0000, 4'b0000, "receive high");
release dut.s_fsm_q;
release dut.s_xfer_data_q;
$display("XPI pad drive isolation test passed");
$display("XPI v2 LUT and pad isolation test passed");
$finish;
end
endmodule