NOTE: The Multifacet Group uses GEMS internally with Simics 2.2.X and Simics 2.0.X. GEMS has not been exhaustively tested when running with Simics 3.0.X.
NOTE: The following steps are applicable to GEMS v2.1.1 and higher. For older versions, please see Setup_for_Simics_3.0.X(pre GEMS-2.1.1)
NOTE: For older versions of Simics, please see Setup_for_Simics_2.2.X
Setting up your GEMS environment
1. Unpack gems-release2.1.1.tar.gz into a chosen directory. For the following instructions, it will be assumed that the $GEMS environment variable is set to this root directory.
-
cd $GEMS tar xvzf gems-release2.1.1.tar.gz
2. Install Simics 3.0.X. You should not install to $GEMS/simics. These instructions assume the environment variable $SIMICS_INSTALL points to the Simics 3.0.X installation directory.
-
tar xvf simics-pal-3.0.11-linux.tar cd simics-3.0-install/ ./install-simics.sh
Follow the installation instructions provided by Virtutech.
3. Instantiate a Simics workspace.
-
cd $GEMS/ mkdir simics_3_workspace cd $SIMICS_INSTALL/bin ./workspace-setup $GEMS/simics_3_workspace
4. Edit $GEMS/scripts/makesymlinks.sh to include the correct path to $SIMICS_INSTALL
-
cd $GEMS/scripts/ vi makesymlinks.sh
echo "Making symlink for import directory..." ln -s $SIMICS_INSTALL/import import
5. Run makesymlinks.sh from your Simics workspace. This will make the Simics workspace directory structure look very much like that of a Simics 2.2.X installation.
-
cd $GEMS/simics_3_workspace ../scripts/makesymlinks.sh
6. Link your Simics workspace to $GEMS/simics.
-
cd $GEMS/ ln -s simics_3_workspace simics
7. Edit GEMS Makefiles:
-
$GEMS/common/Makefile.common -- set the CC for your chosen compiler, update the path for SIMICS_INCLUDE_ROOT to point to your Simics 3.0 installation's include/directory.
-
$GEMS/ruby/module/Makefile -- set the runtime library path (not necessary if using native compiler).
8. Please direct any Simics related questions to [https://www.simics.net/]
9. Please direct any GEMS related questions to the GEMS users mailing list. You can sign up for the mailing list here: [https://lists.cs.wisc.edu/mailman/listinfo/gems-users].
-
We also ask that you first search the mailing list to see if your question has already been answered. To search the mailing list please google the following:
your-search-string site:https://lists.cs.wisc.edu/archive/gems-users/
Now you are ready to compile Ruby and Opal. Proceed to the ["QuickStart"] page