arch-power: Refactor process initialization
[gem5.git] / src / mem / HMCController.py
1 # Copyright (c) 2012-2013 ARM Limited
2 # All rights reserved.
3 #
4 # The license below extends only to copyright in the software and shall
5 # not be construed as granting a license to any other intellectual
6 # property including but not limited to intellectual property relating
7 # to a hardware implementation of the functionality of the software
8 # licensed hereunder. You may use the software subject to the license
9 # terms below provided that you ensure that this notice is replicated
10 # unmodified and in its entirety in all distributions of the software,
11 # modified or unmodified, in source code or in binary form.
12 #
13 # Copyright (c) 2015 The University of Bologna
14 # All rights reserved.
15 #
16 # Redistribution and use in source and binary forms, with or without
17 # modification, are permitted provided that the following conditions are
18 # met: redistributions of source code must retain the above copyright
19 # notice, this list of conditions and the following disclaimer;
20 # redistributions in binary form must reproduce the above copyright
21 # notice, this list of conditions and the following disclaimer in the
22 # documentation and/or other materials provided with the distribution;
23 # neither the name of the copyright holders nor the names of its
24 # contributors may be used to endorse or promote products derived from
25 # this software without specific prior written permission.
26 #
27 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
28 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
29 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
30 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
31 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
32 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
34 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
35 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
36 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38
39 from m5.params import *
40 from m5.objects.XBar import *
41
42 # References:
43 # [1] http://www.open-silicon.com/open-silicon-ips/hmc/
44 # [2] Ahn, J.; Yoo, S.; Choi, K., "Low-Power Hybrid Memory Cubes With Link
45 # Power Management and Two-Level Prefetching," TVLSI 2015
46
47 # The HMCController class highlights the fact that a component is required
48 # between host and HMC to convert the host protocol (AXI for example) to the
49 # serial links protocol. Moreover, this component should have large internal
50 # queueing to hide the access latency of the HMC.
51 # Plus, this controller can implement more advanced global scheduling policies
52 # and can reorder and steer transactions if required. A good example of such
53 # component is available in [1].
54 # Also in [2] there is a similar component which is connected to all serial
55 # links, and it schedules the requests to the ones which are not busy.
56 # These two references clarify two things:
57 # 1. The serial links support the same address range and packets can travel
58 # over any of them.
59 # 2. One host can be connected to more than 1 serial link simply to achieve
60 # higher bandwidth, and not for any other reason.
61
62 # In this model, we have used a round-robin counter, because it is the
63 # simplest way to schedule packets over the non-busy serial links. However,
64 # more advanced scheduling algorithms are possible and even host can dedicate
65 # each serial link to a portion of the address space and interleave packets
66 # over them. Yet in this model, we have not made any such assumptions on the
67 # address space.
68
69 class HMCController(NoncoherentXBar):
70 type = 'HMCController'
71 cxx_header = "mem/hmc_controller.hh"