changeset 9b6ff962d62f in /z/repo/gem5
details: http://repo.gem5.org/gem5?cmd=changeset;node=9b6ff962d62f
description:
        DRAM: Introduce SimpleDRAM to capture a high-level controller

        This patch introduces a high-level model of a DRAM controller, with a
        basic read/write buffer structure, a selectable and customisable
        arbiter, a few address mapping options, and the basic DRAM timing
        constraints. The parameters make it possible to turn this model into
        any desired DDRx/LPDDRx/WideIOx memory controller.

        The intention is not to be cycle accurate or capture every aspect of a
        DDR DRAM interface, but rather to enable exploring of the high-level
        knobs with a good simulation speed. Thus, contrary to e.g. DRAMSim
        this module emphasizes simulation speed with a good-enough accuracy.

        This module is merely a starting point, and there are plenty additions
        and improvements to come. A notable addition is the support for
        address-striping in the bus to enable a multi-channel DRAM
        controller. Also note that there are still a few "todo's" in the code
        base that will be addressed as we go along.

        A follow-up patch will add basic performance regressions that use the
        traffic generator to exercise a few well-defined corner cases.

diffstat:

 src/mem/SConscript     |     4 +
 src/mem/SimpleDRAM.py  |   130 ++++
 src/mem/simple_dram.cc |  1264 ++++++++++++++++++++++++++++++++++++++++++++++++
 src/mem/simple_dram.hh |   478 ++++++++++++++++++
 4 files changed, 1876 insertions(+), 0 deletions(-)

diffs (truncated from 1909 to 300 lines):

diff -r 256143419b40 -r 9b6ff962d62f src/mem/SConscript
--- a/src/mem/SConscript        Fri Sep 21 11:48:11 2012 -0400
+++ b/src/mem/SConscript        Fri Sep 21 11:48:13 2012 -0400
@@ -53,10 +53,12 @@
 if env['TARGET_ISA'] != 'no':
     SimObject('AbstractMemory.py')
     SimObject('SimpleMemory.py')
+    SimObject('SimpleDRAM.py')
     Source('abstract_mem.cc')
     Source('simple_mem.cc')
     Source('page_table.cc')
     Source('physical.cc')
+    Source('simple_dram.cc')
 
 DebugFlag('BaseBus')
 DebugFlag('BusAddrRanges')
@@ -67,6 +69,8 @@
 
 DebugFlag('Bridge')
 DebugFlag('CommMonitor')
+DebugFlag('DRAM')
+DebugFlag('DRAMWR')
 DebugFlag('LLSC')
 DebugFlag('MMU')
 DebugFlag('MemoryAccess')
diff -r 256143419b40 -r 9b6ff962d62f src/mem/SimpleDRAM.py
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/src/mem/SimpleDRAM.py     Fri Sep 21 11:48:13 2012 -0400
@@ -0,0 +1,130 @@
+# Copyright (c) 2012 ARM Limited
+# All rights reserved.
+#
+# The license below extends only to copyright in the software and shall
+# not be construed as granting a license to any other intellectual
+# property including but not limited to intellectual property relating
+# to a hardware implementation of the functionality of the software
+# licensed hereunder.  You may use the software subject to the license
+# terms below provided that you ensure that this notice is replicated
+# unmodified and in its entirety in all distributions of the software,
+# modified or unmodified, in source code or in binary form.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met: redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer;
+# redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution;
+# neither the name of the copyright holders nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# Authors: Andreas Hansson
+#          Ani Udipi
+
+from m5.params import *
+from AbstractMemory import *
+
+# Enum for memory scheduling algorithms, currently First-Come
+# First-Served and a First-Row Hit then First-Come First-Served
+class MemSched(Enum): vals = ['fcfs', 'frfcfs']
+
+# Enum for the address mapping, currently corresponding to either
+# optimising for sequential accesses hitting in the open row, or
+# striping across banks.
+class AddrMap(Enum): vals = ['openmap', 'closemap']
+
+# Enum for the page policy, either open or close.
+class PageManage(Enum): vals = ['open', 'close']
+
+# SimpleDRAM is a single-channel single-ported DRAM controller model
+# that aims to model the most important system-level performance
+# effects of a DRAM without getting into too much detail of the DRAM
+# itself.
+class SimpleDRAM(AbstractMemory):
+    type = 'SimpleDRAM'
+
+    # single-ported on the system interface side, instantiate with a
+    # bus in front of the controller for multiple ports
+    port = SlavePort("Slave port")
+
+    # the physical organisation of the DRAM
+    lines_per_rowbuffer = Param.Unsigned(64, "Row buffer size in cache lines")
+    ranks_per_channel = Param.Unsigned(2, "Number of ranks per channel")
+    banks_per_rank = Param.Unsigned(8, "Number of banks per rank")
+
+    # the basic configuration of the controller architecture
+    write_buffer_size = Param.Unsigned(32, "Number of read queue entries")
+    read_buffer_size = Param.Unsigned(32, "Number of write queue entries")
+
+    # threshold in percent for when to trigger writes and start
+    # emptying the write buffer as it starts to get full
+    write_thresh_perc = Param.Percent(70, "Threshold to trigger writes")
+
+    # scheduler, address map and page policy
+    mem_sched_policy = Param.MemSched('fcfs', "Memory scheduling policy")
+    addr_mapping = Param.AddrMap('openmap', "Address mapping policy")
+    page_policy = Param.PageManage('open', "Page closure management policy")
+
+    # timing behaviour and constraints - all in nanoseconds
+
+    # the amount of time in nanoseconds from issuing an activate command
+    # to the data being available in the row buffer for a read/write
+    tRCD = Param.Latency("14ns", "RAS to CAS delay")
+
+    # the time from issuing a read/write command to seeing the actual data
+    tCL = Param.Latency("14ns", "CAS latency")
+
+    # minimum time between a precharge and subsequent activate
+    tRP = Param.Latency("14ns", "Row precharge time")
+
+    # time to complete a burst transfer, typically the burst length
+    # divided by two due to the DDR bus, but by making it a parameter
+    # it is easier to also evaluate SDR memories like WideIO.
+    # This parameter has to account for bus width and burst length.
+    # Adjustment also necessary if cache line size is greater than
+    # data size read/written by one full burst.
+    tBURST = Param.Latency("4ns",
+                           "Burst duration (for DDR burst length / 2 cycles)")
+
+    # time taken to complete one refresh cycle (N rows in all banks)
+    tRFC = Param.Latency("300ns", "Refresh cycle time")
+
+    # refresh command interval, how often a "ref" command needs
+    # to be sent. It is 7.8 us for a 64ms refresh requirement
+    tREFI = Param.Latency("7.8us", "Refresh command interval")
+
+    # write-to-read turn around penalty, assumed same as read-to-write
+    tWTR = Param.Latency("1ns", "Write to read switching time")
+
+    # Currently unimplemented, unused, deduced or rolled into other params
+    ######################################################################
+
+    # the minimum amount of time between a row being activated, and
+    # precharged (de-activated)
+    # tRAS - assumed to be 3 * tRP
+
+    # tRC  - assumed to be 4 * tRP
+
+    # burst length for an access derived from peerBlockSize
+
+    # @todo: Implement tFAW in the model
+    # minimum time window in which a maximum of four activates are
+    # allowed to take place
+    # tFAW = Param.Latency("30ns", "Four activation window")
+
+
diff -r 256143419b40 -r 9b6ff962d62f src/mem/simple_dram.cc
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/src/mem/simple_dram.cc    Fri Sep 21 11:48:13 2012 -0400
@@ -0,0 +1,1264 @@
+/*
+ * Copyright (c) 2010-2012 ARM Limited
+ * All rights reserved
+ *
+ * The license below extends only to copyright in the software and shall
+ * not be construed as granting a license to any other intellectual
+ * property including but not limited to intellectual property relating
+ * to a hardware implementation of the functionality of the software
+ * licensed hereunder.  You may use the software subject to the license
+ * terms below provided that you ensure that this notice is replicated
+ * unmodified and in its entirety in all distributions of the software,
+ * modified or unmodified, in source code or in binary form.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met: redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer;
+ * redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution;
+ * neither the name of the copyright holders nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Authors: Andreas Hansson
+ *          Ani Udipi
+ */
+
+#include "debug/DRAM.hh"
+#include "debug/DRAMWR.hh"
+#include "mem/simple_dram.hh"
+#include "sim/stat_control.hh"
+
+using namespace std;
+
+SimpleDRAM::SimpleDRAM(const SimpleDRAMParams* p) :
+    AbstractMemory(p),
+    port(name() + ".port", *this),
+    retryRdReq(false), retryWrReq(false),
+    rowHitFlag(false), stopReads(false),
+    writeEvent(this), respondEvent(this),
+    refreshEvent(this), nextReqEvent(this), drainEvent(NULL),
+    bytesPerCacheLine(0),
+    linesPerRowBuffer(p->lines_per_rowbuffer),
+    ranksPerChannel(p->ranks_per_channel),
+    banksPerRank(p->banks_per_rank), rowsPerBank(0),
+    readBufferSize(p->read_buffer_size),
+    writeBufferSize(p->write_buffer_size),
+    writeThresholdPerc(p->write_thresh_perc),
+    tWTR(p->tWTR), tBURST(p->tBURST),
+    tRCD(p->tRCD), tCL(p->tCL), tRP(p->tRP),
+    tRFC(p->tRFC), tREFI(p->tREFI),
+    memSchedPolicy(p->mem_sched_policy), addrMapping(p->addr_mapping),
+    pageMgmt(p->page_policy),
+    busBusyUntil(0), prevdramaccess(0), writeStartTime(0),
+    prevArrival(0), numReqs(0)
+{
+    // create the bank states based on the dimensions of the ranks and
+    // banks
+    banks.resize(ranksPerChannel);
+    for (size_t c = 0; c < ranksPerChannel; ++c) {
+        banks[c].resize(banksPerRank);
+    }
+
+    // round the write threshold percent to a whole number of entries
+    // in the buffer
+    writeThreshold = writeBufferSize * writeThresholdPerc / 100.0;
+}
+
+void
+SimpleDRAM::init()
+{
+    if (!port.isConnected()) {
+        fatal("SimpleDRAM %s is unconnected!\n", name());
+    } else {
+        port.sendRangeChange();
+    }
+
+    // get the cache line size from the connected port
+    bytesPerCacheLine = port.peerBlockSize();
+
+    // we could deal with plenty options here, but for now do a quick
+    // sanity check
+    if (bytesPerCacheLine != 64 && bytesPerCacheLine != 32)
+        panic("Unexpected cache line size %d", bytesPerCacheLine);
+
+    // determine the rows per bank by looking at the total capacity
+    uint64_t capacity = AbstractMemory::size();
+    uint64_t i = 1;
+    while (i < 64 && capacity > ((1 << i))) {
+        ++i;
+    }
+
+    // rounded up to nearest power of two
+    DPRINTF(DRAM, "i is %lld\n", i);
+    capacity = 1 << i;
+
+    DPRINTF(DRAM, "Memory capacity %lld (%lld) bytes\n", capacity,
+            AbstractMemory::size());
+    rowsPerBank = capacity / (bytesPerCacheLine * linesPerRowBuffer *
+                              banksPerRank * ranksPerChannel);
+
+}
+
+void
+SimpleDRAM::startup()
+{
+    // print the configuration of the controller
+    printParams();
+
+    // kick off the refresh
+    schedule(&refreshEvent, curTick() + tREFI);
+}
+
+
+Tick
+SimpleDRAM::recvAtomic(PacketPtr pkt)
+{
+    DPRINTF(DRAM, "recvAtomic: %s 0x%x\n", pkt->cmdString(), pkt->getAddr());
+
+    // do the actual memory access and turn the packet into a response
+    access(pkt);
+
+    Tick latency = 0;
+    if (!pkt->memInhibitAsserted() && pkt->hasData()) {
_______________________________________________
gem5-dev mailing list
[email protected]
http://m5sim.org/mailman/listinfo/gem5-dev

Reply via email to