This commit contains the rest of the base 2 vs base 10 cache/memory size clarifications. It also changes the warning message to use warn(). With these changes, the warning message should now no longer show up during a fresh compilation of gem5. Change-Id: Ia63f841bdf045b76473437f41548fab27dc19631
438 lines
14 KiB
Python
438 lines
14 KiB
Python
# Copyright (c) 2016-2017,2019-2023 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.
|
|
#
|
|
|
|
"""This script is the full system example script from the ARM
|
|
Research Starter Kit on System Modeling. More information can be found
|
|
at: http://www.arm.com/ResearchEnablement/SystemModeling
|
|
"""
|
|
|
|
import argparse
|
|
import os
|
|
|
|
import m5
|
|
from m5.objects import *
|
|
from m5.options import *
|
|
from m5.util import addToPath
|
|
|
|
from gem5.simulate.exit_event import ExitEvent
|
|
|
|
m5.util.addToPath("../..")
|
|
|
|
import devices
|
|
import workloads
|
|
from common import (
|
|
MemConfig,
|
|
ObjectList,
|
|
SysPaths,
|
|
)
|
|
from common.cores.arm import (
|
|
HPI,
|
|
O3_ARM_v7a,
|
|
)
|
|
|
|
# Pre-defined CPU configurations. Each tuple must be ordered as : (cpu_class,
|
|
# l1_icache_class, l1_dcache_class, walk_cache_class, l2_Cache_class). Any of
|
|
# the cache class may be 'None' if the particular cache is not present.
|
|
cpu_types = {
|
|
"atomic": (AtomicSimpleCPU, None, None, None),
|
|
"minor": (MinorCPU, devices.L1I, devices.L1D, devices.L2),
|
|
"hpi": (HPI.HPI, HPI.HPI_ICache, HPI.HPI_DCache, HPI.HPI_L2),
|
|
"o3": (
|
|
O3_ARM_v7a.O3_ARM_v7a_3,
|
|
O3_ARM_v7a.O3_ARM_v7a_ICache,
|
|
O3_ARM_v7a.O3_ARM_v7a_DCache,
|
|
O3_ARM_v7a.O3_ARM_v7aL2,
|
|
),
|
|
}
|
|
|
|
pmu_control_events = {
|
|
"enable": ExitEvent.PERF_COUNTER_ENABLE,
|
|
"disable": ExitEvent.PERF_COUNTER_DISABLE,
|
|
"reset": ExitEvent.PERF_COUNTER_RESET,
|
|
}
|
|
|
|
pmu_interrupt_events = {
|
|
"interrupt": ExitEvent.PERF_COUNTER_INTERRUPT,
|
|
}
|
|
|
|
pmu_stats_events = dict(**pmu_control_events, **pmu_interrupt_events)
|
|
|
|
|
|
def create_cow_image(name):
|
|
"""Helper function to create a Copy-on-Write disk image"""
|
|
image = CowDiskImage()
|
|
image.child.image_file = name
|
|
return image
|
|
|
|
|
|
def create(args):
|
|
"""Create and configure the system object."""
|
|
|
|
if args.readfile and not os.path.isfile(args.readfile):
|
|
print(f"Error: Bootscript {args.readfile} does not exist")
|
|
sys.exit(1)
|
|
|
|
object_file = args.kernel if args.kernel else ""
|
|
|
|
cpu_class = cpu_types[args.cpu][0]
|
|
mem_mode = cpu_class.memory_mode()
|
|
# Only simulate caches when using a timing CPU (e.g., the HPI model)
|
|
want_caches = True if mem_mode == "timing" else False
|
|
|
|
platform = ObjectList.platform_list.get(args.machine_type)
|
|
|
|
system = devices.SimpleSystem(
|
|
want_caches,
|
|
args.mem_size,
|
|
platform=platform(),
|
|
mem_mode=mem_mode,
|
|
readfile=args.readfile,
|
|
)
|
|
|
|
MemConfig.config_mem(args, system)
|
|
|
|
if args.semi_enable:
|
|
system.semihosting = ArmSemihosting(
|
|
stdin=args.semi_stdin,
|
|
stdout=args.semi_stdout,
|
|
stderr=args.semi_stderr,
|
|
files_root_dir=args.semi_path,
|
|
cmd_line=" ".join([object_file] + args.args),
|
|
)
|
|
|
|
if args.disk_image:
|
|
# Create a VirtIO block device for the system's boot
|
|
# disk. Attach the disk image using gem5's Copy-on-Write
|
|
# functionality to avoid writing changes to the stored copy of
|
|
# the disk image.
|
|
system.realview.vio[0].vio = VirtIOBlock(
|
|
image=create_cow_image(args.disk_image)
|
|
)
|
|
|
|
# Wire up the system's memory system
|
|
system.connect()
|
|
|
|
# Add CPU clusters to the system
|
|
system.cpu_cluster = [
|
|
devices.ArmCpuCluster(
|
|
system,
|
|
args.num_cores,
|
|
args.cpu_freq,
|
|
"1.0V",
|
|
*cpu_types[args.cpu],
|
|
tarmac_gen=args.tarmac_gen,
|
|
tarmac_dest=args.tarmac_dest,
|
|
)
|
|
]
|
|
|
|
# Create a cache hierarchy for the cluster. We are assuming that
|
|
# clusters have core-private L1 caches and an L2 that's shared
|
|
# within the cluster.
|
|
system.addCaches(want_caches, last_cache_level=2)
|
|
|
|
# Setup gem5's minimal Linux boot loader.
|
|
system.auto_reset_addr = True
|
|
|
|
# Using GICv3
|
|
if hasattr(system.realview.gic, "gicv4"):
|
|
system.realview.gic.gicv4 = False
|
|
|
|
system.highest_el_is_64 = True
|
|
|
|
workload_class = workloads.workload_list.get(args.workload)
|
|
system.workload = workload_class(object_file, system)
|
|
|
|
if args.with_pmu:
|
|
enabled_pmu_events = {
|
|
*args.pmu_dump_stats_on,
|
|
*args.pmu_reset_stats_on,
|
|
}
|
|
exit_sim_on_control = bool(
|
|
enabled_pmu_events & set(pmu_control_events.keys())
|
|
)
|
|
exit_sim_on_interrupt = bool(
|
|
enabled_pmu_events & set(pmu_interrupt_events.keys())
|
|
)
|
|
for cluster in system.cpu_cluster:
|
|
interrupt_numbers = [args.pmu_ppi_number] * len(cluster)
|
|
cluster.addPMUs(
|
|
interrupt_numbers,
|
|
exit_sim_on_control=exit_sim_on_control,
|
|
exit_sim_on_interrupt=exit_sim_on_interrupt,
|
|
)
|
|
|
|
if args.exit_on_uart_eot:
|
|
for uart in system.realview.uart:
|
|
uart.end_on_eot = True
|
|
|
|
return system
|
|
|
|
|
|
def run(args):
|
|
cptdir = m5.options.outdir
|
|
if args.checkpoint:
|
|
print(f"Checkpoint directory: {cptdir}")
|
|
|
|
pmu_exit_msgs = tuple(evt.value for evt in pmu_stats_events.values())
|
|
pmu_stats_dump_msgs = tuple(
|
|
pmu_stats_events[evt].value for evt in set(args.pmu_dump_stats_on)
|
|
)
|
|
pmu_stats_reset_msgs = tuple(
|
|
pmu_stats_events[evt].value for evt in set(args.pmu_reset_stats_on)
|
|
)
|
|
|
|
while True:
|
|
event = m5.simulate()
|
|
exit_msg = event.getCause()
|
|
if exit_msg == ExitEvent.CHECKPOINT.value:
|
|
print(f"Dropping checkpoint at tick {m5.curTick():d}")
|
|
cpt_dir = os.path.join(m5.options.outdir, "cpt.%d" % m5.curTick())
|
|
m5.checkpoint(os.path.join(cpt_dir))
|
|
print("Checkpoint done.")
|
|
elif exit_msg in pmu_exit_msgs:
|
|
if exit_msg in pmu_stats_dump_msgs:
|
|
print(
|
|
f"Dumping stats at tick {m5.curTick():d}, "
|
|
f"due to {exit_msg}"
|
|
)
|
|
m5.stats.dump()
|
|
if exit_msg in pmu_stats_reset_msgs:
|
|
print(
|
|
f"Resetting stats at tick {m5.curTick():d}, "
|
|
f"due to {exit_msg}"
|
|
)
|
|
m5.stats.reset()
|
|
else:
|
|
print(f"{exit_msg} ({event.getCode()}) @ {m5.curTick()}")
|
|
break
|
|
|
|
|
|
def arm_ppi_arg(int_num: int) -> int:
|
|
"""Argparse argument parser for valid Arm PPI numbers."""
|
|
# PPIs (1056 <= int_num <= 1119) are not yet supported by gem5
|
|
int_num = int(int_num)
|
|
if 16 <= int_num <= 31:
|
|
return int_num
|
|
raise ValueError(f"{int_num} is not a valid Arm PPI number")
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(epilog=__doc__)
|
|
|
|
parser.add_argument(
|
|
"--kernel", type=str, default=None, help="Binary to run"
|
|
)
|
|
parser.add_argument(
|
|
"--workload",
|
|
type=str,
|
|
default="ArmBaremetal",
|
|
choices=workloads.workload_list.get_names(),
|
|
help="Workload type",
|
|
)
|
|
parser.add_argument(
|
|
"--disk-image", type=str, default=None, help="Disk to instantiate"
|
|
)
|
|
parser.add_argument(
|
|
"--readfile",
|
|
type=str,
|
|
default="",
|
|
help="File to return with the m5 readfile command",
|
|
)
|
|
parser.add_argument(
|
|
"--cpu",
|
|
type=str,
|
|
choices=list(cpu_types.keys()),
|
|
default="atomic",
|
|
help="CPU model to use",
|
|
)
|
|
parser.add_argument("--cpu-freq", type=str, default="4GHz")
|
|
parser.add_argument(
|
|
"--num-cores", type=int, default=1, help="Number of CPU cores"
|
|
)
|
|
parser.add_argument(
|
|
"--machine-type",
|
|
type=str,
|
|
choices=ObjectList.platform_list.get_names(),
|
|
default="VExpress_GEM5_V2",
|
|
help="Hardware platform class",
|
|
)
|
|
parser.add_argument(
|
|
"--mem-type",
|
|
default="DDR3_1600_8x8",
|
|
choices=ObjectList.mem_list.get_names(),
|
|
help="type of memory to use",
|
|
)
|
|
parser.add_argument(
|
|
"--mem-channels", type=int, default=1, help="number of memory channels"
|
|
)
|
|
parser.add_argument(
|
|
"--mem-ranks",
|
|
type=int,
|
|
default=None,
|
|
help="number of memory ranks per channel",
|
|
)
|
|
parser.add_argument(
|
|
"--mem-size",
|
|
action="store",
|
|
type=str,
|
|
default="2GiB",
|
|
help="Specify the physical memory size",
|
|
)
|
|
parser.add_argument("--checkpoint", action="store_true")
|
|
parser.add_argument("--restore", type=str, default=None)
|
|
parser.add_argument(
|
|
"--tarmac-gen",
|
|
action="store_true",
|
|
help="Write a Tarmac trace.",
|
|
)
|
|
parser.add_argument(
|
|
"--tarmac-dest",
|
|
choices=TarmacDump.vals,
|
|
default="stdoutput",
|
|
help="Destination for the Tarmac trace output. [Default: stdoutput]",
|
|
)
|
|
parser.add_argument(
|
|
"--with-pmu",
|
|
action="store_true",
|
|
help="Add a PMU to each core in the cluster.",
|
|
)
|
|
parser.add_argument(
|
|
"--pmu-ppi-number",
|
|
type=arm_ppi_arg,
|
|
default=23,
|
|
help="The number of the PPI to use to connect each PMU to its core. "
|
|
"Must be an integer and a valid PPI number (16 <= int_num <= 31).",
|
|
)
|
|
parser.add_argument(
|
|
"--pmu-dump-stats-on",
|
|
type=str,
|
|
default=[],
|
|
action="append",
|
|
choices=pmu_stats_events.keys(),
|
|
help="Specify the PMU events on which to dump the gem5 stats. "
|
|
"This option may be specified multiple times to enable multiple "
|
|
"PMU events.",
|
|
)
|
|
parser.add_argument(
|
|
"--pmu-reset-stats-on",
|
|
type=str,
|
|
default=[],
|
|
action="append",
|
|
choices=pmu_stats_events.keys(),
|
|
help="Specify the PMU events on which to reset the gem5 stats. "
|
|
"This option may be specified multiple times to enable multiple "
|
|
"PMU events.",
|
|
)
|
|
parser.add_argument(
|
|
"--exit-on-uart-eot",
|
|
action="store_true",
|
|
help="Exit simulation if any of the UARTs receive an EOT. Many "
|
|
"workloads signal termination by sending an EOT character.",
|
|
)
|
|
parser.add_argument(
|
|
"--dtb-gen",
|
|
action="store_true",
|
|
help="Doesn't run simulation, it generates a DTB only",
|
|
)
|
|
parser.add_argument(
|
|
"--semi-enable", action="store_true", help="Enable semihosting support"
|
|
)
|
|
parser.add_argument(
|
|
"--semi-stdin",
|
|
type=str,
|
|
default="stdin",
|
|
help="Standard input for semihosting (default: gem5's stdin)",
|
|
)
|
|
parser.add_argument(
|
|
"--semi-stdout",
|
|
type=str,
|
|
default="stdout",
|
|
help="Standard output for semihosting (default: gem5's stdout)",
|
|
)
|
|
parser.add_argument(
|
|
"--semi-stderr",
|
|
type=str,
|
|
default="stderr",
|
|
help="Standard error for semihosting (default: gem5's stderr)",
|
|
)
|
|
parser.add_argument(
|
|
"--semi-path",
|
|
type=str,
|
|
default="",
|
|
help=("Search path for files to be loaded through Arm Semihosting"),
|
|
)
|
|
parser.add_argument(
|
|
"args",
|
|
default=[],
|
|
nargs="*",
|
|
help="Semihosting arguments to pass to benchmark",
|
|
)
|
|
parser.add_argument(
|
|
"-P",
|
|
"--param",
|
|
action="append",
|
|
default=[],
|
|
help="Set a SimObject parameter relative to the root node. "
|
|
"An extended Python multi range slicing syntax can be used "
|
|
"for arrays. For example: "
|
|
"'system.cpu[0,1,3:8:2].max_insts_all_threads = 42' "
|
|
"sets max_insts_all_threads for cpus 0, 1, 3, 5 and 7 "
|
|
"Direct parameters of the root object are not accessible, "
|
|
"only parameters of its children.",
|
|
)
|
|
|
|
args = parser.parse_args()
|
|
|
|
root = Root(full_system=True)
|
|
root.system = create(args)
|
|
|
|
root.apply_config(args.param)
|
|
|
|
if args.restore is not None:
|
|
m5.instantiate(args.restore)
|
|
else:
|
|
m5.instantiate()
|
|
|
|
if args.dtb_gen:
|
|
# No run, autogenerate DTB and exit
|
|
root.system.generateDtb(os.path.join(m5.options.outdir, "system.dtb"))
|
|
else:
|
|
run(args)
|
|
|
|
|
|
if __name__ == "__m5_main__":
|
|
main()
|