= gem5 =

[[TOC(Developer/Simulators/gem5, depth=2)]]

RTEMS can run in the open source cycle-accurate processor simulator  [http://gem5.org/Main_Page gem5]. The primary use of gem5 is to support architecture research. The following RTEMS BSPs work:
* SPARC - sparc64/usiii
* ARM - arm/realview_pbx_a9_qemu

= Getting Started =
You'll need to build gem5. Follow the [http://gem5.org/Documentation#Getting_Started getting started] directions 1-4.

= ARM =

Download from 5 the ARM Full-System Files and put the 'binaries' and 'disks' into /dist/m5/system (by default). Read the gem5 documentation if you need to put the files somewhere else.

If you succeeded at running `scons build/ARM/gem5.opt` (or similar), and you have configured and compiled RTEMS for the realview_pbx_a9_qemu BSP, you can run applications using a command such as:
```
build/ARM/gem5.opt configs/example/fs.py --kernel=${HOME}/work/rtems/builds/b-realview/arm-rtems5/c/realview_pbx_a9_qemu/testsuites/samples/ticker/ticker.exe --mem-size=256MB --bare-metal --machine-type=RealView_PBX --dtb-filename=None --enable-security-extensions
```

= SPARC =

Read through [http://gedare-csphd.blogspot.com/2010/05/week-in-m5.html this blog post], although a bit dated, it contains useful information for getting started with SPARC. Replace SPARC_FS with SPARC.

TBD