gem5-dev@gem5.org

The gem5 Developer List

View all threads

[M] Change in gem5/gem5[develop]: configs: Adds an example script for MIPS Hello

KP
Kunal Pai (Gerrit)
Wed, Mar 8, 2023 6:16 PM

Kunal Pai has uploaded this change for review. (
https://gem5-review.googlesource.com/c/public/gem5/+/68777?usp=email )

Change subject: configs: Adds an example script for MIPS Hello
......................................................................

configs: Adds an example script for MIPS Hello

Used the "mips-hello" resource to make an
stdlib example script for that resource.

Change-Id: I14f1bac69aebde4d8fe96eb844f41d5d97d606ae

A configs/example/gem5_library/mips-hello.py
1 file changed, 89 insertions(+), 0 deletions(-)

diff --git a/configs/example/gem5_library/mips-hello.py
b/configs/example/gem5_library/mips-hello.py
new file mode 100644
index 0000000..4a0e904
--- /dev/null
+++ b/configs/example/gem5_library/mips-hello.py
@@ -0,0 +1,89 @@
+# 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 MIPS
+"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/MIPS/gem5.opt +./build/MIPS/gem5.opt configs/example/gem5_library/mips-hello.py +
+"""
+
+from gem5.isas import ISA
+from gem5.utils.requires import requires
+from gem5.resources.resource import Resource
+from gem5.components.memory import SingleChannelDDR3_2133
+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 MIPS ISA target.
+# If not, an exception will be thrown.
+requires(isa_required=ISA.MIPS)
+
+# In this setup we don't have a cache. NoCache can be used for such
setups.
+cache_hierarchy = NoCache()
+
+# We use a single channel DDR3_2133 memory system
+memory = SingleChannelDDR3_2133(size="16MB")
+
+# We use a simple TIMING processor with one core.
+processor = SimpleProcessor(

  • cpu_type=CPUTypes.TIMING, isa=ISA.MIPS, num_cores=1
    +)

+# The gem5 library simple board which can be used to run simple SE-mode
+# simulations.
+board = SimpleBoard(

  • clk_freq="5GHz",
  • processor=processor,
  • memory=memory,
  • cache_hierarchy=cache_hierarchy,
    +)

+board.set_se_binary_workload(Resource("mips-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(),
    
  • )
    +)

--
To view, visit
https://gem5-review.googlesource.com/c/public/gem5/+/68777?usp=email
To unsubscribe, or for help writing mail filters, visit
https://gem5-review.googlesource.com/settings

Gerrit-Project: public/gem5
Gerrit-Branch: develop
Gerrit-Change-Id: I14f1bac69aebde4d8fe96eb844f41d5d97d606ae
Gerrit-Change-Number: 68777
Gerrit-PatchSet: 1
Gerrit-Owner: Kunal Pai kunpai@ucdavis.edu
Gerrit-MessageType: newchange

Kunal Pai has uploaded this change for review. ( https://gem5-review.googlesource.com/c/public/gem5/+/68777?usp=email ) Change subject: configs: Adds an example script for MIPS Hello ...................................................................... configs: Adds an example script for MIPS Hello Used the "mips-hello" resource to make an stdlib example script for that resource. Change-Id: I14f1bac69aebde4d8fe96eb844f41d5d97d606ae --- A configs/example/gem5_library/mips-hello.py 1 file changed, 89 insertions(+), 0 deletions(-) diff --git a/configs/example/gem5_library/mips-hello.py b/configs/example/gem5_library/mips-hello.py new file mode 100644 index 0000000..4a0e904 --- /dev/null +++ b/configs/example/gem5_library/mips-hello.py @@ -0,0 +1,89 @@ +# 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 MIPS +"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/MIPS/gem5.opt +./build/MIPS/gem5.opt configs/example/gem5_library/mips-hello.py +``` +""" + +from gem5.isas import ISA +from gem5.utils.requires import requires +from gem5.resources.resource import Resource +from gem5.components.memory import SingleChannelDDR3_2133 +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 MIPS ISA target. +# If not, an exception will be thrown. +requires(isa_required=ISA.MIPS) + +# In this setup we don't have a cache. `NoCache` can be used for such setups. +cache_hierarchy = NoCache() + +# We use a single channel DDR3_2133 memory system +memory = SingleChannelDDR3_2133(size="16MB") + +# We use a simple TIMING processor with one core. +processor = SimpleProcessor( + cpu_type=CPUTypes.TIMING, isa=ISA.MIPS, num_cores=1 +) + +# The gem5 library simple board which can be used to run simple SE-mode +# simulations. +board = SimpleBoard( + clk_freq="5GHz", + processor=processor, + memory=memory, + cache_hierarchy=cache_hierarchy, +) + +board.set_se_binary_workload(Resource("mips-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(), + ) +) -- To view, visit https://gem5-review.googlesource.com/c/public/gem5/+/68777?usp=email To unsubscribe, or for help writing mail filters, visit https://gem5-review.googlesource.com/settings Gerrit-Project: public/gem5 Gerrit-Branch: develop Gerrit-Change-Id: I14f1bac69aebde4d8fe96eb844f41d5d97d606ae Gerrit-Change-Number: 68777 Gerrit-PatchSet: 1 Gerrit-Owner: Kunal Pai <kunpai@ucdavis.edu> Gerrit-MessageType: newchange