f34f582dcf
This documentation string provided in the "config/example/gem5_library/riscvmatched-fs.py" was minimal. This patch adds more detail. Change-Id: I0f203ea6952fc72a078594d7c30853bd426017ff Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/65851 Tested-by: kokoro <noreply+kokoro@google.com> Reviewed-by: Bobby Bruce <bbruce@ucdavis.edu> Maintainer: Bobby Bruce <bbruce@ucdavis.edu> Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/65972
66 lines
2.6 KiB
Python
66 lines
2.6 KiB
Python
# Copyright (c) 2022 The Regents of the University of California
|
|
# All rights reserved.
|
|
#
|
|
# 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 gem5 configuration script runs the RISCVMatchedBoard in FS mode with a
|
|
an Ubuntu 20.04 image and calls m5 exit after the simulation has booted the OS.
|
|
|
|
Usage
|
|
---
|
|
|
|
```
|
|
scons build/RISCV/gem5.opt
|
|
|
|
./build/RISCV/gem5.opt configs/example/gem5_library/riscvmatched-fs.py
|
|
```
|
|
"""
|
|
|
|
from python.gem5.prebuilt.riscvmatched.riscvmatched_board import (
|
|
RISCVMatchedBoard,
|
|
)
|
|
from gem5.utils.requires import requires
|
|
from gem5.isas import ISA
|
|
from gem5.simulate.simulator import Simulator
|
|
from gem5.resources.workload import Workload
|
|
|
|
requires(isa_required=ISA.RISCV)
|
|
|
|
# instantiate the riscv matched board with default parameters
|
|
board = RISCVMatchedBoard(
|
|
clk_freq="1.2GHz",
|
|
l2_size="2MB",
|
|
is_fs=True,
|
|
)
|
|
|
|
# Here we a full system workload: "riscv-ubuntu-20.04-boot" which boots
|
|
# Ubuntu 20.04. Once the system successfully boots it encounters an `m5_exit`
|
|
# instruction which stops the simulation. When the simulation has ended you may
|
|
# inspect `m5out/system.pc.com_1.device` to see the stdout.
|
|
board.set_workload(Workload("riscv-ubuntu-20.04-boot"))
|
|
|
|
simulator = Simulator(board=board)
|
|
simulator.run()
|