141 lines
5.5 KiB
Verilog
141 lines
5.5 KiB
Verilog
// -----------------------------------------------------------------------------
|
|
// z2_demo_top.v -- Palladium Z2 emulation demo DUT
|
|
//
|
|
// A small, fully synthesizable, register-mapped timer peripheral used to
|
|
// demonstrate the Palladium Z2 flow end to end:
|
|
// IXCOM compile (SA mode) -> download with xeDebug -> run -> check results
|
|
// The same RTL also runs in a plain event simulator (xrun / iverilog) with
|
|
// the testbench in ../tb, so the logic can be verified before using hardware.
|
|
//
|
|
// Bus: APB-like (single-cycle ready). Only the low 8 address bits are decoded.
|
|
//
|
|
// Register map (byte addresses):
|
|
// 0x00 CTRL [0]=enable [1]=irq_en [2]=pattern_en (RW)
|
|
// 0x04 LOAD reload value of the down counter (RW)
|
|
// 0x08 COUNT current counter value (RO)
|
|
// 0x0C CMP compare value: pulse cmp_hit when COUNT==CMP (RW)
|
|
// 0x10 STATUS [0]=timeout flag (W1C) [1]=cmp flag (W1C) (RW/RO)
|
|
// 0x14 GPIO 8-bit rotating pattern output register (RW)
|
|
// 0x18 ID constant 0x5A32_0001 (RO)
|
|
//
|
|
// Behaviour:
|
|
// * When CTRL.enable=1, COUNT decrements every clock. When it reaches 0 it
|
|
// sets STATUS.timeout, raises irq (if irq_en), and reloads from LOAD.
|
|
// * When COUNT==CMP, STATUS.cmp is set and cmp_hit pulses for one cycle.
|
|
// * When CTRL.pattern_en=1, GPIO rotates left by one bit on every timeout,
|
|
// giving a visible "running light" to observe in xeDebug / waveforms.
|
|
// -----------------------------------------------------------------------------
|
|
`timescale 1ns/1ps
|
|
|
|
module z2_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
|
|
);
|
|
|
|
// ------------------------------------------------------------------ regs
|
|
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);
|
|
|
|
// ------------------------------------------------------------- write path
|
|
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; // default period: 10 cycles
|
|
reg_cmp <= 32'd3;
|
|
reg_gpio <= 8'h01;
|
|
status_timeout <= 1'b0;
|
|
status_cmp <= 1'b0;
|
|
end else begin
|
|
// sticky flags: set by hardware events, cleared by W1C writes
|
|
if (timeout_now) status_timeout <= 1'b1;
|
|
if (cmp_hit) status_cmp <= 1'b1;
|
|
|
|
if (bus_write) begin
|
|
case (paddr)
|
|
8'h00: begin
|
|
ctrl_enable <= pwdata[0];
|
|
ctrl_irq_en <= pwdata[1];
|
|
ctrl_pattern_en <= pwdata[2];
|
|
end
|
|
8'h04: reg_load <= pwdata;
|
|
8'h0C: reg_cmp <= pwdata;
|
|
8'h10: begin // STATUS: write-1-to-clear
|
|
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
|
|
|
|
// pattern rotation on timeout (software write same cycle wins
|
|
// for reg_gpio because this block is separate; see count block)
|
|
if (timeout_now & ctrl_pattern_en & ~(bus_write & (paddr == 8'h14)))
|
|
reg_gpio <= {reg_gpio[6:0], reg_gpio[7]};
|
|
end
|
|
end
|
|
|
|
// ------------------------------------------------------------- count path
|
|
always @(posedge clk or negedge rst_n) begin
|
|
if (!rst_n) begin
|
|
reg_count <= 32'd9;
|
|
end else if (bus_write & (paddr == 8'h04)) begin
|
|
reg_count <= pwdata; // writing LOAD also presets COUNT
|
|
end else if (ctrl_enable) begin
|
|
if (reg_count == 32'd0)
|
|
reg_count <= reg_load; // reload
|
|
else
|
|
reg_count <= reg_count - 32'd1;
|
|
end
|
|
end
|
|
|
|
// -------------------------------------------------------------- read path
|
|
always @(*) begin
|
|
case (paddr)
|
|
8'h00: prdata = {29'd0, 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'd0, status_cmp, status_timeout};
|
|
8'h14: prdata = {24'd0, reg_gpio};
|
|
8'h18: prdata = 32'h5A32_0001; // ID
|
|
default: prdata = 32'd0;
|
|
endcase
|
|
end
|
|
|
|
// keep bus_read referenced (used by assertions in TB via hierarchy)
|
|
wire _unused = &{1'b0, bus_read};
|
|
|
|
endmodule
|