| # Copyright (c) 2023 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 configuation script creates a simple board to run a POWER |
| "hello world" binary. |
| |
| This is setup is the close to the simplest setup possible using the gem5 |
| library. It does not contain any kind of caching, IO, or any non-essential |
| components. |
| |
| Usage |
| ----- |
| |
| ``` |
| scons build/POWER/gem5.opt |
| ./build/POWER/gem5.opt configs/example/gem5_library/power-hello.py |
| ``` |
| """ |
| |
| from gem5.isas import ISA |
| from gem5.utils.requires import requires |
| from gem5.resources.resource import Resource |
| from gem5.components.memory import SingleChannelDDR4_2400 |
| from gem5.components.processors.cpu_types import CPUTypes |
| from gem5.components.boards.simple_board import SimpleBoard |
| from gem5.components.cachehierarchies.classic.no_cache import NoCache |
| from gem5.components.processors.simple_processor import SimpleProcessor |
| from gem5.simulate.simulator import Simulator |
| |
| # This check ensures the gem5 binary is compiled to the POWER ISA target. |
| # If not, an exception will be thrown. |
| requires(isa_required=ISA.POWER) |
| |
| # In this setup we don't have a cache. `NoCache` can be used for such setups. |
| cache_hierarchy = NoCache() |
| |
| # We use a single channel DDR4_2400 memory system |
| memory = SingleChannelDDR4_2400(size="32MB") |
| |
| # We use a simple ATOMIC processor with one core. |
| processor = SimpleProcessor( |
| cpu_type=CPUTypes.ATOMIC, isa=ISA.POWER, num_cores=1 |
| ) |
| |
| # The gem5 library simple board which can be used to run simple SE-mode |
| # simulations. |
| board = SimpleBoard( |
| clk_freq="3GHz", |
| processor=processor, |
| memory=memory, |
| cache_hierarchy=cache_hierarchy, |
| ) |
| |
| board.set_se_binary_workload(Resource("power-hello")) |
| |
| # Lastly we run the simulation. |
| simulator = Simulator(board=board) |
| simulator.run() |
| |
| print( |
| "Exiting @ tick {} because {}.".format( |
| simulator.get_current_tick(), |
| simulator.get_last_exit_event_cause(), |
| ) |
| ) |