Skip to content

Commit

Permalink
Change tests submodule branch
Browse files Browse the repository at this point in the history
Change-Id: I2d6eb67b0f431b41e25c8f37dc087c7fbd54c47e
  • Loading branch information
hakase56557 committed Dec 26, 2023
1 parent f6e1fba commit 544db5c
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 28 deletions.
43 changes: 16 additions & 27 deletions README
Original file line number Diff line number Diff line change
@@ -1,24 +1,23 @@
This is the gem5 simulator.
## CAPStone gem5 simulator

The main website can be found at http://www.gem5.org
This repo contains an out of order CPU model for CAPStone, built on top
of gem5's O3 CPU model. This design is intended to be used for performance evaluations.

A good starting point is http://www.gem5.org/about, and for
more information about building the simulator and getting started
please see http://www.gem5.org/documentation and
http://www.gem5.org/documentation/learning_gem5/introduction.
This version of the CAPStone implementation is based on the CAPStone Academic Spec (vxx.xx, link)

To build gem5, you will need the following software: g++ or clang,
Python (gem5 links in the Python interpreter), SCons, zlib, m4, and lastly
protobuf if you want trace capture and playback support. Please see
http://www.gem5.org/documentation/general_docs/building for more details
concerning the minimum versions of these tools.
## Dependencies

Once you have all dependencies resolved, type 'scons
build/<CONFIG>/gem5.opt' where CONFIG is one of the options in build_opts like
ARM, NULL, MIPS, POWER, SPARC, X86, Garnet_standalone, etc. This will build an
optimized version of the gem5 binary (gem5.opt) with the the specified
configuration. See http://www.gem5.org/documentation/general_docs/building for
more details and options.
To build, make sure you have apptainer installed.
Then simply run the following from the project root directory:

```
chmod +x run.sh
./run.sh <NUM_THREADS>
```

This will automatically build an apptainer image with all dependencies
required to build gem5, and use that image to build gem5 and run Capstone
functional tests.

The main source tree includes these subdirectories:
- build_opts: pre-made default configurations for gem5
Expand All @@ -31,13 +30,3 @@ The main source tree includes these subdirectories:
- system: source for some optional system software for simulated systems
- tests: regression tests
- util: useful utility programs and files

To run full-system simulations, you may need compiled system firmware, kernel
binaries and one or more disk images, depending on gem5's configuration and
what type of workload you're trying to run. Many of those resources can be
downloaded from http://resources.gem5.org, and/or from the git repository here:
https://gem5.googlesource.com/public/gem5-resources/

If you have questions, please send mail to [email protected]

Enjoy using gem5 and please share your modifications and extensions.
2 changes: 1 addition & 1 deletion tests/capstone/o3/src
Submodule src updated from e15b7d to e3a6b5

0 comments on commit 544db5c

Please sign in to comment.