rtl/verilog/or1200_spram_2048x8.v

   1 //////////////////////////////////////////////////////////////////////
   2 ////                                                              ////
   3 ////  Generic Single-Port Synchronous RAM                         ////
   4 ////                                                              ////
   5 ////  This file is part of memory library available from          ////
   6 ////  http://www.opencores.org/cvsweb.shtml/generic_memories/     ////
   7 ////                                                              ////
   8 ////  Description                                                 ////
   9 ////  This block is a wrapper with common single-port             ////
  10 ////  synchronous memory interface for different                  ////
  11 ////  types of ASIC and FPGA RAMs. Beside universal memory        ////
  12 ////  interface it also provides behavioral model of generic      ////
  13 ////  single-port synchronous RAM.                                ////
  14 ////  It should be used in all OPENCORES designs that want to be  ////
  15 ////  portable accross different target technologies and          ////
  16 ////  independent of target memory.                               ////
  17 ////                                                              ////
  18 ////  Supported ASIC RAMs are:                                    ////
  19 ////  - Artisan Single-Port Sync RAM                              ////
  20 ////  - Avant! Two-Port Sync RAM (*)                              ////
  21 ////  - Virage Single-Port Sync RAM                               ////
  22 ////  - Virtual Silicon Single-Port Sync RAM                      ////
  23 ////                                                              ////
  24 ////  Supported FPGA RAMs are:                                    ////
  25 ////  - Xilinx Virtex RAMB4_S16                                   ////
  26 ////  - Altera LPM                                                ////
  27 ////                                                              ////
  28 ////  To Do:                                                      ////
  29 ////   - xilinx rams need external tri-state logic                ////
  30 ////   - fix avant! two-port ram                                  ////
  31 ////   - add additional RAMs                                      ////
  32 ////                                                              ////
  33 ////  Author(s):                                                  ////
  34 ////      - Damjan Lampret, lampret@opencores.org                 ////
  35 ////                                                              ////
  36 //////////////////////////////////////////////////////////////////////
  37 ////                                                              ////
  38 //// Copyright (C) 2000 Authors and OPENCORES.ORG                 ////
  39 ////                                                              ////
  40 //// This source file may be used and distributed without         ////
  41 //// restriction provided that this copyright statement is not    ////
  42 //// removed from the file and that any derivative work contains  ////
  43 //// the original copyright notice and the associated disclaimer. ////
  44 ////                                                              ////
  45 //// This source file is free software; you can redistribute it   ////
  46 //// and/or modify it under the terms of the GNU Lesser General   ////
  47 //// Public License as published by the Free Software Foundation; ////
  48 //// either version 2.1 of the License, or (at your option) any   ////
  49 //// later version.                                               ////
  50 ////                                                              ////
  51 //// This source is distributed in the hope that it will be       ////
  52 //// useful, but WITHOUT ANY WARRANTY; without even the implied   ////
  53 //// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR      ////
  54 //// PURPOSE.  See the GNU Lesser General Public License for more ////
  55 //// details.                                                     ////
  56 ////                                                              ////
  57 //// You should have received a copy of the GNU Lesser General    ////
  58 //// Public License along with this source; if not, download it   ////
  59 //// from http://www.opencores.org/lgpl.shtml                     ////
  60 ////                                                              ////
  61 //////////////////////////////////////////////////////////////////////
  62 //
  63 // CVS Revision History
  64 //
  65 // $Log$
  66 // Revision 1.8  2004/06/08 18:15:32  lampret
  67 // Changed behavior of the simulation generic models
  68 //
  69 // Revision 1.7  2004/04/05 08:29:57  lampret
  70 // Merged branch_qmem into main tree.
  71 //
  72 // Revision 1.3.4.1  2003/12/09 11:46:48  simons
  73 // Mbist nameing changed, Artisan ram instance signal names fixed, some synthesis waning fixed.
  74 //
  75 // Revision 1.3  2003/04/07 01:19:07  lampret
  76 // Added Altera LPM RAMs. Changed generic RAM output when OE inactive.
  77 //
  78 // Revision 1.2  2002/10/17 20:04:40  lampret
  79 // Added BIST scan. Special VS RAMs need to be used to implement BIST.
  80 //
  81 // Revision 1.1  2002/01/03 08:16:15  lampret
  82 // New prefixes for RTL files, prefixed module names. Updated cache controllers and MMUs.
  83 //
  84 // Revision 1.8  2001/11/02 18:57:14  lampret
  85 // Modified virtual silicon instantiations.
  86 //
  87 // Revision 1.7  2001/10/21 17:57:16  lampret
  88 // Removed params from generic_XX.v. Added translate_off/on in sprs.v and id.v. Removed spr_addr from dc.v and ic.v. Fixed CR+LF.
  89 //
  90 // Revision 1.6  2001/10/14 13:12:09  lampret
  91 // MP3 version.
  92 //
  93 // Revision 1.1.1.1  2001/10/06 10:18:36  igorm
  94 // no message
  95 //
  96 // Revision 1.1  2001/08/09 13:39:33  lampret
  97 // Major clean-up.
  98 //
  99 // Revision 1.2  2001/07/30 05:38:02  lampret
 100 // Adding empty directories required by HDL coding guidelines
 101 //
 102 //
 103
 104 // synopsys translate_off
 105 `include "timescale.v"
 106 // synopsys translate_on
 107 `include "or1200_defines.v"
 108
 109 module or1200_spram_2048x8(
 110 `ifdef OR1200_BIST
 111         // RAM BIST
 112         mbist_si_i, mbist_so_o, mbist_ctrl_i,
 113 `endif
 114         // Generic synchronous single-port RAM interface
 115         clk, rst, ce, we, oe, addr, di, doq
 116 );
 117
 118 //
 119 // Default address and data buses width
 120 //
 121 parameter aw = 11;
 122 parameter dw = 8;
 123
 124 `ifdef OR1200_BIST
 125 //
 126 // RAM BIST
 127 //
 128 input mbist_si_i;
 129 input [`OR1200_MBIST_CTRL_WIDTH - 1:0] mbist_ctrl_i;
 130 output mbist_so_o;
 131 `endif
 132
 133 //
 134 // Generic synchronous single-port RAM interface
 135 //
 136 input                   clk;    // Clock
 137 input                   rst;    // Reset
 138 input                   ce;     // Chip enable input
 139 input                   we;     // Write enable input
 140 input                   oe;     // Output enable input
 141 input   [aw-1:0]        addr;   // address bus inputs
 142 input   [dw-1:0]        di;     // input data bus
 143 output  [dw-1:0]        doq;    // output data bus
 144
 145 //
 146 // Internal wires and registers
 147 //
 148
 149 `ifdef OR1200_ARTISAN_SSP
 150 `else
 151 `ifdef OR1200_VIRTUALSILICON_SSP
 152 `else
 153 `ifdef OR1200_BIST
 154 assign mbist_so_o = mbist_si_i;
 155 `endif
 156 `endif
 157 `endif
 158
 159 `ifdef OR1200_ARTISAN_SSP
 160
 161 //
 162 // Instantiation of ASIC memory:
 163 //
 164 // Artisan Synchronous Single-Port RAM (ra1sh)
 165 //
 166 `ifdef UNUSED
 167 art_hssp_2048x8 #(dw, 1<<aw, aw) artisan_ssp(
 168 `else
 169 `ifdef OR1200_BIST
 170 art_hssp_2048x8_bist artisan_ssp(
 171 `else
 172 art_hssp_2048x8 artisan_ssp(
 173 `endif
 174 `endif
 175 `ifdef OR1200_BIST
 176         // RAM BIST
 177         .mbist_si_i(mbist_si_i),
 178         .mbist_so_o(mbist_so_o),
 179         .mbist_ctrl_i(mbist_ctrl_i),
 180 `endif
 181         .CLK(clk),
 182         .CEN(~ce),
 183         .WEN(~we),
 184         .A(addr),
 185         .D(di),
 186         .OEN(~oe),
 187         .Q(doq)
 188 );
 189
 190 `else
 191
 192 `ifdef OR1200_AVANT_ATP
 193
 194 //
 195 // Instantiation of ASIC memory:
 196 //
 197 // Avant! Asynchronous Two-Port RAM
 198 //
 199 avant_atp avant_atp(
 200         .web(~we),
 201         .reb(),
 202         .oeb(~oe),
 203         .rcsb(),
 204         .wcsb(),
 205         .ra(addr),
 206         .wa(addr),
 207         .di(di),
 208         .doq(doq)
 209 );
 210
 211 `else
 212
 213 `ifdef OR1200_VIRAGE_SSP
 214
 215 //
 216 // Instantiation of ASIC memory:
 217 //
 218 // Virage Synchronous 1-port R/W RAM
 219 //
 220 virage_ssp virage_ssp(
 221         .clk(clk),
 222         .adr(addr),
 223         .d(di),
 224         .we(we),
 225         .oe(oe),
 226         .me(ce),
 227         .q(doq)
 228 );
 229
 230 `else
 231
 232 `ifdef OR1200_VIRTUALSILICON_SSP
 233
 234 //
 235 // Instantiation of ASIC memory:
 236 //
 237 // Virtual Silicon Single-Port Synchronous SRAM
 238 //
 239 `ifdef UNUSED
 240 vs_hdsp_2048x8 #(1<<aw, aw-1, dw-1) vs_ssp(
 241 `else
 242 `ifdef OR1200_BIST
 243 vs_hdsp_2048x8_bist vs_ssp(
 244 `else
 245 vs_hdsp_2048x8 vs_ssp(
 246 `endif
 247 `endif
 248 `ifdef OR1200_BIST
 249         // RAM BIST
 250         .mbist_si_i(mbist_si_i),
 251         .mbist_so_o(mbist_so_o),
 252         .mbist_ctrl_i(mbist_ctrl_i),
 253 `endif
 254         .CK(clk),
 255         .ADR(addr),
 256         .DI(di),
 257         .WEN(~we),
 258         .CEN(~ce),
 259         .OEN(~oe),
 260         .DOUT(doq)
 261 );
 262
 263 `else
 264
 265 `ifdef OR1200_XILINX_RAMB4
 266
 267 //
 268 // Instantiation of FPGA memory:
 269 //
 270 // Virtex/Spartan2
 271 //
 272
 273 //
 274 // Block 0
 275 //
 276 RAMB4_S2 ramb4_s2_0(
 277         .CLK(clk),
 278         .RST(rst),
 279         .ADDR(addr),
 280         .DI(di[1:0]),
 281         .EN(ce),
 282         .WE(we),
 283         .DO(doq[1:0])
 284 );
 285
 286 //
 287 // Block 1
 288 //
 289 RAMB4_S2 ramb4_s2_1(
 290         .CLK(clk),
 291         .RST(rst),
 292         .ADDR(addr),
 293         .DI(di[3:2]),
 294         .EN(ce),
 295         .WE(we),
 296         .DO(doq[3:2])
 297 );
 298
 299 //
 300 // Block 2
 301 //
 302 RAMB4_S2 ramb4_s2_2(
 303         .CLK(clk),
 304         .RST(rst),
 305         .ADDR(addr),
 306         .DI(di[5:4]),
 307         .EN(ce),
 308         .WE(we),
 309         .DO(doq[5:4])
 310 );
 311
 312 //
 313 // Block 3
 314 //
 315 RAMB4_S2 ramb4_s2_3(
 316         .CLK(clk),
 317         .RST(rst),
 318         .ADDR(addr),
 319         .DI(di[7:6]),
 320         .EN(ce),
 321         .WE(we),
 322         .DO(doq[7:6])
 323 );
 324
 325 `else
 326
 327 `ifdef OR1200_ALTERA_LPM
 328
 329 //
 330 // Instantiation of FPGA memory:
 331 //
 332 // Altera LPM
 333 //
 334 // Added By Jamil Khatib
 335 //
 336
 337 wire    wr;
 338
 339 assign  wr = ce & we;
 340
 341 initial $display("Using Altera LPM.");
 342
 343 lpm_ram_dq lpm_ram_dq_component (
 344         .address(addr),
 345         .inclock(clk),
 346         .outclock(clk),
 347         .data(di),
 348         .we(wr),
 349         .q(doq)
 350 );
 351
 352 defparam lpm_ram_dq_component.lpm_width = dw,
 353         lpm_ram_dq_component.lpm_widthad = aw,
 354         lpm_ram_dq_component.lpm_indata = "REGISTERED",
 355         lpm_ram_dq_component.lpm_address_control = "REGISTERED",
 356         lpm_ram_dq_component.lpm_outdata = "UNREGISTERED",
 357         lpm_ram_dq_component.lpm_hint = "USE_EAB=ON";
 358         // examplar attribute lpm_ram_dq_component NOOPT TRUE
 359
 360 `else
 361
 362 //
 363 // Generic single-port synchronous RAM model
 364 //
 365
 366 //
 367 // Generic RAM's registers and wires
 368 //
 369 reg     [dw-1:0]        mem [(1<<aw)-1:0];      // RAM content
 370 reg     [aw-1:0]        addr_reg;               // RAM address register
 371
 372 //
 373 // Data output drivers
 374 //
 375 assign doq = (oe) ? mem[addr_reg] : {dw{1'b0}};
 376
 377 //
 378 // RAM address register
 379 //
 380 always @(posedge clk or posedge rst)
 381         if (rst)
 382                 addr_reg <= #1 {aw{1'b0}};
 383         else if (ce)
 384                 addr_reg <= #1 addr;
 385
 386 //
 387 // RAM write
 388 //
 389 always @(posedge clk)
 390         if (ce && we)
 391                 mem[addr] <= #1 di;
 392
 393 `endif  // !OR1200_ALTERA_LPM
 394 `endif  // !OR1200_XILINX_RAMB4_S16
 395 `endif  // !OR1200_VIRTUALSILICON_SSP
 396 `endif  // !OR1200_VIRAGE_SSP
 397 `endif  // !OR1200_AVANT_ATP
 398 `endif  // !OR1200_ARTISAN_SSP
 399
 400 endmodule