整个slave 的框图如图所示,有三部分组成。
APB slave example包括以下功能:
- 一个简单的APB slave接口。
- 32位数据总线,与字节序无关。 请使用PSTRB信号对单个字节执行写操作。
- 数据传输需要两个时钟周期。
- 4个32bit的读写寄存器。
寄存器列表:
Abstract : APB example slave, support AMBA APB4.
slave is always ready and response is always OKAY.
module cmsdk_apb4_eg_slave #(
// parameter for address width
parameter ADDRWIDTH = 12)
(
// IO declaration
input wire PCLK, // pclk
input wire PRESETn, // reset
// apb interface inputs
input wire PSEL,
input wire [ADDRWIDTH-1:0] PADDR,
input wire PENABLE,
input wire PWRITE,
input wire [31:0] PWDATA,
input wire [3:0] PSTRB,
input wire [3:0] ECOREVNUM, // Engineering-change-order revision bits
// apb interface outputs
output wire [31:0] PRDATA,
output wire PREADY,
output wire PSLVERR);
//------------------------------------------------------------------------------
// internal wires
//------------------------------------------------------------------------------
// Register module interface signals
wire [ADDRWIDTH-1:0] reg_addr;
wire reg_read_en;
wire reg_write_en;
wire [3:0] reg_byte_strobe;
wire [31:0] reg_wdata;
wire [31:0] reg_rdata;
//------------------------------------------------------------------------------
// module logic start
//------------------------------------------------------------------------------
// Interface to convert APB signals to simple read and write controls
cmsdk_apb4_eg_slave_interface
#(.ADDRWIDTH (ADDRWIDTH))
u_apb_eg_slave_interface(
.pclk (PCLK), // pclk
.presetn (PRESETn), // reset
.psel (PSEL), // apb interface inputs
.paddr (PADDR),
.penable (PENABLE),
.pwrite (PWRITE),
.pwdata (PWDATA),
.pstrb (PSTRB),
.prdata (PRDATA), // apb interface outputs
.pready (PREADY),
.pslverr (PSLVERR),
// Register interface
.addr (reg_addr),
.read_en (reg_read_en),
.write_en (reg_write_en),
.byte_strobe (reg_byte_strobe),
.wdata (reg_wdata),
.rdata (reg_rdata)
);
// Example hardware register block
cmsdk_apb4_eg_slave_reg
#(.ADDRWIDTH (ADDRWIDTH))
u_apb_eg_slave_reg (
.pclk (PCLK),
.presetn (PRESETn),
// Register interface
.addr (reg_addr),
.read_en (reg_read_en),
.write_en (reg_write_en),
.byte_strobe (reg_byte_strobe),
.wdata (reg_wdata),
.ecorevnum (ECOREVNUM),
.rdata (reg_rdata)
);
endmodule
Abstract : AMBA APB4 example slave interface module. Transfer APB BUS protocol to
// simple register read write protocol
module cmsdk_apb4_eg_slave_interface #(
// parameter for address width
parameter ADDRWIDTH = 12)
(
// IO declaration
input wire pclk, // pclk
input wire presetn, // reset
// apb interface inputs
input wire psel,
input wire [ADDRWIDTH-1:0] paddr,
input wire penable,
input wire pwrite,
input wire [31:0] pwdata,
input wire [3:0] pstrb,
// apb interface outputs
output wire [31:0] prdata,
output wire pready,
output wire pslverr,
//Register interface
output wire [ADDRWIDTH-1:0] addr,
output wire read_en,
output wire write_en,
output wire [3:0] byte_strobe,
output wire [31:0] wdata,
input wire [31:0] rdata);
//--------------------------
// ----------------------------------------------------
// module logic start
//------------------------------------------------------------------------------
// APB interface
assign pready = 1'b1; //always ready. Can be customized to support waitstate if required.
assign pslverr = 1'b0; //always OKAY. Can be customized to support error response if required.
// register read and write signal
assign addr = paddr;
assign read_en = psel & (~pwrite); // assert for whole apb read transfer
assign write_en = psel & (~penable) & pwrite; // assert for 1st cycle of write transfer
// It is also possible to change the design to perform the write in the 2nd
// APB cycle. E.g.
// assign write_en = psel & penable & pwrite;
// However, if the design generate waitstate, this expression will result
// in write_en being asserted for multiple cycles.
assign byte_strobe = pstrb;
assign wdata = pwdata;
assign prdata = rdata;
endmodule
Abstract : APB example slave register module.
// Support AMBA APB4
// This is an example slave with four 32-bit registers, provides write
// and read operation. The Data and address valid at the same clock
// cycle. Byte strobe signal is supported.
module cmsdk_apb4_eg_slave_reg #(
// parameter for address width
parameter ADDRWIDTH = 12)
(
input wire pclk, // clock
input wire presetn, // reset
// Register interface
input wire [ADDRWIDTH-1:0] addr,
input wire read_en,
input wire write_en,
input wire [3:0] byte_strobe,
input wire [31:0] wdata,
input wire [3:0] ecorevnum,
output reg [31:0] rdata);
// Local ID parameters, APB4 example slave has part number of 819
localparam ARM_CMSDK_APB4_EG_SLAVE_PID4 = 32'h00000004; // 0xFD0 : PID 4
localparam ARM_CMSDK_APB4_EG_SLAVE_PID5 = 32'h00000000; // 0xFD4 : PID 5
localparam ARM_CMSDK_APB4_EG_SLAVE_PID6 = 32'h00000000; // 0xFD8 : PID 6
localparam ARM_CMSDK_APB4_EG_SLAVE_PID7 = 32'h00000000; // 0xFDC : PID 7
localparam ARM_CMSDK_APB4_EG_SLAVE_PID0 = 32'h00000019; // 0xFE0 : PID 0 APB4 Example slave part number[7:0]
localparam ARM_CMSDK_APB4_EG_SLAVE_PID1 = 32'h000000B8; // 0xFE4 : PID 1 [7:4] jep106_id_3_0. [3:0] part number [11:8]
localparam ARM_CMSDK_APB4_EG_SLAVE_PID2 = 32'h0000001B; // 0xFE8 : PID 2 [7:4] revision, [3] jedec_used. [2:0] jep106_id_6_4
localparam ARM_CMSDK_APB4_EG_SLAVE_PID3 = 32'h00000000; // 0xFEC : PID 3
localparam ARM_CMSDK_APB4_EG_SLAVE_CID0 = 32'h0000000D; // 0xFF0 : CID 0
localparam ARM_CMSDK_APB4_EG_SLAVE_CID1 = 32'h000000F0; // 0xFF4 : CID 1 PrimeCell class
localparam ARM_CMSDK_APB4_EG_SLAVE_CID2 = 32'h00000005; // 0xFF8 : CID 2
localparam ARM_CMSDK_APB4_EG_SLAVE_CID3 = 32'h000000B1; // 0xFFC : CID 3
// Note : Customer changing the design should modify
// - jep106 value (www.jedec.org)
// - part number (customer define)
// - Optional revision and modification number (e.g. rXpY)
//------------------------------------------------------------------------------
// internal signals
//------------------------------------------------------------------------------
reg [31:0] data0;
reg [31:0] data1;
reg [31:0] data2;
reg [31:0] data3;
wire [3:0] wr_sel;
//------------------------------------------------------------------------------
// module logic start
//------------------------------------------------------------------------------
// Address decoding for write operations
assign wr_sel[0] = ((addr[(ADDRWIDTH-1):2]==10'b0000000000)&(write_en)) ? 1'b1: 1'b0;
assign wr_sel[1] = ((addr[(ADDRWIDTH-1):2]==10'b0000000001)&(write_en)) ? 1'b1: 1'b0;
assign wr_sel[2] = ((addr[(ADDRWIDTH-1):2]==10'b0000000010)&(write_en)) ? 1'b1: 1'b0;
assign wr_sel[3] = ((addr[(ADDRWIDTH-1):2]==10'b0000000011)&(write_en)) ? 1'b1: 1'b0;
// register write, byte enable
// Data register: data0
always @(posedge pclk or negedge presetn)
begin
if (~presetn)
begin
data0 <= {32{1'b0}}; // Reset data 0 to 0x00000000
end
else if (wr_sel[0])
begin
if (byte_strobe[0])
data0[ 7: 0] <= wdata[ 7: 0];
if (byte_strobe[1])
data0[15: 8] <= wdata[15: 8];
if (byte_strobe[2])
data0[23:16] <= wdata[23:16];
if (byte_strobe[3])
data0[31:24] <= wdata[31:24];
end
end
// Data register: data1
always @(posedge pclk or negedge presetn)
begin
if (~presetn)
begin
data1 <= {32{1'b0}}; // Reset data 1 to 0x00000000
end
else if (wr_sel[1])
begin
if (byte_strobe[0])
data1[ 7: 0] <= wdata[7:0];
if (byte_strobe[1])
data1[15: 8] <= wdata[15:8];
if (byte_strobe[2])
data1[23:16] <= wdata[23:16];
if (byte_strobe[3])
data1[31:24] <= wdata[31:24];
end
end
// Data register: data2
always @(posedge pclk or negedge presetn)
begin
if (~presetn)
begin
data2 <= {32{1'b0}}; // Reset data 2 to 0x00000000
end
else if (wr_sel[2])
begin
if (byte_strobe[0])
data2[ 7: 0] <= wdata[ 7: 0];
if (byte_strobe[1])
data2[15: 8] <= wdata[15: 8];
if (byte_strobe[2])
data2[23:16] <= wdata[23:16];
if (byte_strobe[3])
data2[31:24] <= wdata[31:24];
end
end
// Data register: data3
always @(posedge pclk or negedge presetn)
begin
if (~presetn)
begin
data3 <= {32{1'b0}}; // Reset data 3 to 0x00000000
end
else if (wr_sel[3])
begin
if (byte_strobe[0])
data3[ 7: 0] <= wdata[ 7: 0];
if (byte_strobe[1])
data3[15: 8] <= wdata[15: 8];
if (byte_strobe[2])
data3[23:16] <= wdata[23:16];
if (byte_strobe[3])
data3[31:24] <= wdata[31:24];
end
end
// register read
always @ (read_en or addr or data0 or data1 or data2 or data3 or ecorevnum)
begin
case (read_en)
1'b1:
begin
if (addr[11:4] == 8'h00) begin
case(addr[3:2])
2'b00: rdata = data0;
2'b01: rdata = data1;
2'b10: rdata = data2;
2'b11: rdata = data3;
default: rdata = {32{1'bx}};
endcase
end
else if (addr[11:6] == 6'h3F) begin
case(addr[5:2])
// Peripheral IDs and Component IDs.
// AHB example slave has part number of 818
4'b0100: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID4; // 0xFD0 : PID 4
4'b0101: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID5; // 0xFD4 : PID 5
4'b0110: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID6; // 0xFD8 : PID 6
4'b0111: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID7; // 0xFDC : PID 7
4'b1000: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID0; // 0xFE0 : PID 0 APB Example slave part number[7:0]
4'b1001: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID1; // 0xFE4 : PID 1 [7:4] jep106_id_3_0. [3:0] part number [11:8]
4'b1010: rdata = ARM_CMSDK_APB4_EG_SLAVE_PID2; // 0xFE8 : PID 2 [7:4] revision, [3] jedec_used. [2:0] jep106_id_6_4
4'b1011: rdata ={ARM_CMSDK_APB4_EG_SLAVE_PID3[31:8], ecorevnum[3:0], 4'h0};
// 0xFEC : PID 3 [7:4] ECO rev number, [3:0] modification number
4'b1100: rdata = ARM_CMSDK_APB4_EG_SLAVE_CID0; // 0xFF0 : CID 0
4'b1101: rdata = ARM_CMSDK_APB4_EG_SLAVE_CID1; // 0xFF4 : CID 1 PrimeCell class
4'b1110: rdata = ARM_CMSDK_APB4_EG_SLAVE_CID2; // 0xFF8 : CID 2
4'b1111: rdata = ARM_CMSDK_APB4_EG_SLAVE_CID3; // 0xFFC : CID 3
// Note : Customer changing the design should modify
// - jep106 value (www.jedec.org)
// - part number (customer define)
// - Optional revision and modification number (e.g. rXpY)
4'b0000, 4'b0001,4'b0010,4'b0011: rdata = {32'h00000000}; // default
default: rdata = {32{1'bx}}; // x propagation
endcase
end
else begin
rdata = {32'h00000000}; // default
end
end
1'b0:
begin
rdata = {32{1'b0}};
end
default:
begin
rdata = {32{1'bx}};
end
endcase
end
//------------------------------------------------------------------------------
// module logic end
//------------------------------------------------------------------------------
endmodule