feat: complete Palladium Z3 demo (SA & ICE dual-mode) and 24.05 hardware compilation fix

This commit is contained in:
xuejin.wang
2026-10-20 19:01:16 +08:00
commit 1cc994fac4
18 changed files with 1445 additions and 0 deletions
+190
View File
@@ -0,0 +1,190 @@
// -----------------------------------------------------------------------------
// z3_demo_ice_top.v -- Palladium Z3 ICE-mode demo top
//
// ICE (In-Circuit Emulation) has NO software testbench: everything that runs
// in the emulator must be synthesizable hardware.
//
// This top-level module wraps z3_demo_top with an on-chip hardware self-checking
// FSM that autonomously stimulates and verifies the DUT:
// reset -> program LOAD/CMP -> verify Z3 ID -> start timer
// -> wait for irq -> verify STATUS flags -> verify GPIO rotation
// -> disable, clear W1C flags -> assert led_pass/led_fail
// -----------------------------------------------------------------------------
`timescale 1ns/1ps
module z3_demo_ice_top (
input wire clk_in,
input wire rst_n_in,
output wire [7:0] led_gpio,
output wire led_irq,
output reg led_done,
output reg led_pass,
output reg led_fail
);
// ------------------------------------------------------------ DUT signals
reg [7:0] paddr;
reg psel;
reg penable;
reg pwrite;
reg [31:0] pwdata;
wire [31:0] prdata;
wire pready;
wire [7:0] gpio_out;
wire irq;
wire cmp_hit;
z3_demo_top dut (
.clk (clk_in),
.rst_n (rst_n_in),
.paddr (paddr),
.psel (psel),
.penable (penable),
.pwrite (pwrite),
.pwdata (pwdata),
.prdata (prdata),
.pready (pready),
.gpio_out (gpio_out),
.irq (irq),
.cmp_hit (cmp_hit)
);
assign led_gpio = gpio_out;
assign led_irq = irq;
// ------------------------------------------------------------ FSM
localparam ST_WAIT = 5'd0;
localparam ST_WR_LOAD = 5'd1;
localparam ST_WR_CMP = 5'd2;
localparam ST_RD_ID = 5'd3;
localparam ST_CHK_ID = 5'd4;
localparam ST_WR_CTRL = 5'd5;
localparam ST_WAIT_IRQ = 5'd6;
localparam ST_RD_STAT = 5'd7;
localparam ST_CHK_STAT = 5'd8;
localparam ST_RD_GPIO = 5'd9;
localparam ST_CHK_GPIO = 5'd10;
localparam ST_WR_CTRL0 = 5'd11;
localparam ST_WR_W1C = 5'd12;
localparam ST_RD_STAT2 = 5'd13;
localparam ST_CHK_STAT2 = 5'd14;
localparam ST_PASS = 5'd15;
localparam ST_FAIL = 5'd16;
reg [4:0] state;
reg [15:0] wait_cnt;
reg [31:0] rd_latched;
always @(*) begin
paddr = 8'd0;
pwdata = 32'd0;
pwrite = 1'b0;
psel = 1'b0;
penable = 1'b0;
case (state)
ST_WR_LOAD: begin psel=1; penable=1; pwrite=1; paddr=8'h04; pwdata=32'd19; end
ST_WR_CMP: begin psel=1; penable=1; pwrite=1; paddr=8'h0C; pwdata=32'd5; end
ST_RD_ID: begin psel=1; penable=1; pwrite=0; paddr=8'h18; end
ST_WR_CTRL: begin psel=1; penable=1; pwrite=1; paddr=8'h00; pwdata=32'd7; end
ST_RD_STAT: begin psel=1; penable=1; pwrite=0; paddr=8'h10; end
ST_RD_GPIO: begin psel=1; penable=1; pwrite=0; paddr=8'h14; end
ST_WR_CTRL0: begin psel=1; penable=1; pwrite=1; paddr=8'h00; pwdata=32'd0; end
ST_WR_W1C: begin psel=1; penable=1; pwrite=1; paddr=8'h10; pwdata=32'd3; end
ST_RD_STAT2: begin psel=1; penable=1; pwrite=0; paddr=8'h10; end
default: ;
endcase
end
always @(posedge clk_in or negedge rst_n_in) begin
if (!rst_n_in) begin
state <= ST_WAIT;
wait_cnt <= 16'd0;
rd_latched <= 32'd0;
led_done <= 1'b0;
led_pass <= 1'b0;
led_fail <= 1'b0;
end else begin
case (state)
ST_WAIT: begin
if (wait_cnt == 16'd10) begin
wait_cnt <= 16'd0;
state <= ST_WR_LOAD;
end else begin
wait_cnt <= wait_cnt + 16'd1;
end
end
ST_WR_LOAD: state <= ST_WR_CMP;
ST_WR_CMP: state <= ST_RD_ID;
ST_RD_ID: begin rd_latched <= prdata; state <= ST_CHK_ID; end
ST_CHK_ID: begin
// Verify Palladium Z3 signature
if (rd_latched == 32'h5A33_0001)
state <= ST_WR_CTRL;
else
state <= ST_FAIL;
end
ST_WR_CTRL: begin
wait_cnt <= 16'd0;
state <= ST_WAIT_IRQ;
end
ST_WAIT_IRQ: begin
if (irq) begin
state <= ST_RD_STAT;
end else if (wait_cnt >= 16'd1000) begin
state <= ST_FAIL; // watchdog timeout
end else begin
wait_cnt <= wait_cnt + 16'd1;
end
end
ST_RD_STAT: begin rd_latched <= prdata; state <= ST_CHK_STAT; end
ST_CHK_STAT: begin
if ((rd_latched & 32'd3) == 32'd3)
state <= ST_RD_GPIO;
else
state <= ST_FAIL;
end
ST_RD_GPIO: begin rd_latched <= prdata; state <= ST_CHK_GPIO; end
ST_CHK_GPIO: begin
if (rd_latched[7:0] == 8'h02)
state <= ST_WR_CTRL0;
else
state <= ST_FAIL;
end
ST_WR_CTRL0: state <= ST_WR_W1C;
ST_WR_W1C: state <= ST_RD_STAT2;
ST_RD_STAT2: begin rd_latched <= prdata; state <= ST_CHK_STAT2; end
ST_CHK_STAT2: begin
if ((rd_latched & 32'd3) == 32'd0)
state <= ST_PASS;
else
state <= ST_FAIL;
end
ST_PASS: begin
led_done <= 1'b1;
led_pass <= 1'b1;
led_fail <= 1'b0;
end
ST_FAIL: begin
led_done <= 1'b1;
led_pass <= 1'b0;
led_fail <= 1'b1;
end
default: state <= ST_FAIL;
endcase
end
end
endmodule
+108
View File
@@ -0,0 +1,108 @@
// -----------------------------------------------------------------------------
// z3_demo_top.v -- Palladium Z3 emulation demo DUT
// (Identical to root rtl/z3_demo_top.v)
// -----------------------------------------------------------------------------
`timescale 1ns/1ps
module z3_demo_top (
input wire clk,
input wire rst_n,
// APB-like slave bus
input wire [7:0] paddr,
input wire psel,
input wire penable,
input wire pwrite,
input wire [31:0] pwdata,
output reg [31:0] prdata,
output wire pready,
// Observable outputs
output wire [7:0] gpio_out,
output wire irq,
output wire cmp_hit
);
reg ctrl_enable;
reg ctrl_irq_en;
reg ctrl_pattern_en;
reg [31:0] reg_load;
reg [31:0] reg_count;
reg [31:0] reg_cmp;
reg status_timeout;
reg status_cmp;
reg [7:0] reg_gpio;
assign pready = 1'b1;
assign gpio_out = reg_gpio;
assign irq = status_timeout & ctrl_irq_en;
wire bus_write = psel & penable & pwrite;
wire bus_read = psel & penable & ~pwrite;
wire timeout_now = ctrl_enable & (reg_count == 32'd0);
assign cmp_hit = ctrl_enable & (reg_count == reg_cmp);
always @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
ctrl_enable <= 1'b0;
ctrl_irq_en <= 1'b0;
ctrl_pattern_en <= 1'b0;
reg_load <= 32'd9;
reg_cmp <= 32'd3;
reg_gpio <= 8'h01;
status_timeout <= 1'b0;
status_cmp <= 1'b0;
end else begin
if (timeout_now)
status_timeout <= 1'b1;
if (cmp_hit)
status_cmp <= 1'b1;
if (bus_write) begin
case (paddr[7:0])
8'h00: begin
ctrl_enable <= pwdata[0];
ctrl_irq_en <= pwdata[1];
ctrl_pattern_en <= pwdata[2];
end
8'h04: begin
reg_load <= pwdata;
reg_count <= pwdata;
end
8'h0C: reg_cmp <= pwdata;
8'h10: begin
if (pwdata[0]) status_timeout <= 1'b0;
if (pwdata[1]) status_cmp <= 1'b0;
end
8'h14: reg_gpio <= pwdata[7:0];
default: ;
endcase
end else if (ctrl_enable) begin
if (reg_count == 32'd0) begin
reg_count <= reg_load;
if (ctrl_pattern_en)
reg_gpio <= {reg_gpio[6:0], reg_gpio[7]};
end else begin
reg_count <= reg_count - 32'd1;
end
end
end
end
always @(*) begin
if (bus_read) begin
case (paddr[7:0])
8'h00: prdata = {29'b0, ctrl_pattern_en, ctrl_irq_en, ctrl_enable};
8'h04: prdata = reg_load;
8'h08: prdata = reg_count;
8'h0C: prdata = reg_cmp;
8'h10: prdata = {30'b0, status_cmp, status_timeout};
8'h14: prdata = {24'b0, reg_gpio};
8'h18: prdata = 32'h5A33_0001; // Z3 ID
default: prdata = 32'hDEAD_BEEF;
endcase
end else begin
prdata = 32'h0;
end
end
endmodule