Merge pull request #112 from firesim/new-agfi

new pre-built agfis for 1.3.2 release. shared publicly

.ctags

@@ -0,0 +1,13 @@
+--langdef=scala
+--langmap=scala:.scala
+
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy)[ \t]*)*(private[^ ]*|protected)?[ \t]*class[ \t]+([a-zA-Z0-9_]+)/\4/c,classes/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy)[ \t]*)*(private[^ ]*|protected)?[ \t]*object[ \t]+([a-zA-Z0-9_]+)/\4/o,objects/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy)[ \t]*)*(private[^ ]*|protected)?[ \t]*((abstract|final|sealed|implicit|lazy)[ \t ]*)*case class[ \t ]+([a-zA-Z0-9_]+)/\6/C,case classes/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy)[ \t]*)*(private[^ ]*|protected)?[ \t]*case object[ \t]+([a-zA-Z0-9_]+)/\4/O,case objects/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy)[ \t]*)*(private[^ ]*|protected)?[ \t]*trait[ \t]+([a-zA-Z0-9_]+)/\4/t,traits/
+--regex-scala=/^[ \t]*type[ \t]+([a-zA-Z0-9_]+)/\1/T,types/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy|override|private[^ ]*(\[[a-z]*\])*|protected)[ \t]*)*def[ \t]+([a-zA-Z0-9_]+)/\4/m,methods/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy|override|private[^ ]*|protected)[ \t]*)*val[ \t]+([a-zA-Z0-9_]+)/\3/V,values/
+--regex-scala=/^[ \t]*((abstract|final|sealed|implicit|lazy|override|private[^ ]*|protected)[ \t]*)*var[ \t]+([a-zA-Z0-9_]+)/\3/v,variables/
+--regex-scala=/^[ \t]*package[ \t]+([a-zA-Z0-9_.]+)/\1/p,packages/

.ctagsignore

@@ -0,0 +1,6 @@
+*/riscv-tools
+*/target
+*/firesim-software
+deploy/results-build
+platforms/f1/aws-fpga/hdk/cl/developer_designs/cl_F*
+sw/qemu

.gitignore

@@ -5,3 +5,4 @@ sim/ucli.key
 target-design/switch/switchconfig.h
 sim[0-9]
 build-setup-log
+tags

CHANGELOG.md

@@ -2,6 +2,40 @@
 
 This changelog follows the format defined here: https://keepachangelog.com/en/1.0.0/
 
+## [1.3.2] - 2018-09-22
+
+### Changed
+
+* Serial IO model made deterministic (resolves https://github.com/ucb-bar/midas/issues/78 )
+* `firesim managerinit` generates an initial bucket name that won't collide with an existing one
+* verilator is now installed by the machine launch script 
+* Rebuild EDMA driver on Run Farm nodes. This fixes a potential kernel version mismatch issue due to AWS GUI scripts
+
+### Added
+
+* Auto-ILA added: Annotate Chisel code to automatically wire-up an ILA
+  * Enables ILA-based debugging of the FPGA simulation
+  * Automatic generation and wiring of FPGA ILA, based on chisel annotations in relevant source code (target source code or simulation source code). This is done using the ILATopWiring transformation. Generates several partial Verilog files which are included in the top-level cl_firesim.sv file.
+  * Includes refactoring of midas to allow post-midas host-transformations (in addition to the already existing target transformations)
+  * Documentation and integration into manager for ease of use
+* sim/Make system fractured into:
+  * `sim/Makefile` -- the top-level Makefile
+  * `sim/Makefrag` -- target-agnostic recipes for build simulators and simulation drivers and 
+  * `sim/src/main/makefrag/<project>/Makefrag` -- target specific recipes for generating RTL
+  * this makes it easier to submodule firesim from a larger project, and allows for multiple target projects to coexist within FireSim
+  * see `Targets/Generating Different Target-RTL` in Advanced Docs. 
+* MIDAS-examples added (Resolves https://github.com/firesim/firesim/issues/81 )
+  * live in `sim/src/main/{cc, scala, makefrag}/midas-examples`
+  * a suite of simple circuits like GCD to demonstrate MIDAS/FireSim
+  * these serve as good smoke tests for bringing up features in MIDAS
+  * see `Targets/Midas Examples` in Advanced Docs. 
+* Scalatests updated
+  * generates all of the MIDAS-examples, a Rocket- and Boom-based target and runs them through midas-level simulation.
+    * good regression test for bumping/changing chisel/firrtl/rocket chip/midas
+* Better ctags support. Script to generate ctags efficiently in `gen-tags.sh`. Also called by build-setup process. On a fresh clone, gen-tags.sh only takes ~10s. Resolves #79 
+  * Generated across: target-design code, all shim code, driver code, workloads, etc.
+
+
 ## [1.3.1] - 2018-08-18
 
 ### Changed

build-setup-nolog.sh

@@ -104,6 +104,9 @@ if wget -T 1 -t 3 -O /dev/null http://169.254.169.254/; then
     bash sourceme-f1-full.sh
 fi
 
+cd $RDIR
+./gen-tags.sh
+
 echo "Setup complete!"
 echo "To use the manager to deploy builds/simulations, source sourceme-f1-manager.sh to setup your environment."
 echo "To run builds/simulations manually on this machine, source sourceme-f1-full.sh to setup your environment."

deploy/sample-backup-configs/sample_config_hwdb.ini

@@ -9,52 +9,52 @@
 # If you are using an older version of FireSim, you will need to generate your
 # own images.
 
-[firesim-singlecore-no-nic-lbp]
-agfi=agfi-083ef86e56214c8ec
-deploytripletoverride=None
-customruntimeconfig=None
-
-[firesim-singlecore-nic-lbp]
-agfi=agfi-0d197dd524465d139
-deploytripletoverride=None
-customruntimeconfig=None
-
-[firesim-quadcore-no-nic-lbp]
-agfi=agfi-0a01489a4aef54387
-deploytripletoverride=None
-customruntimeconfig=None
-
-[firesim-quadcore-nic-lbp]
-agfi=agfi-0cc0da6e6eacd155c
-deploytripletoverride=None
-customruntimeconfig=None
-
-[firesim-quadcore-no-nic-ddr3-llc4mb]
-agfi=agfi-0323912be5f6d9c91
-deploytripletoverride=None
-customruntimeconfig=None
-
-[firesim-quadcore-nic-ddr3-llc4mb]
-agfi=agfi-0ecd398c27432a31d
+[fireboom-singlecore-nic-ddr3-llc4mb]
+agfi=agfi-06a2d40b49e1a1034
 deploytripletoverride=None
 customruntimeconfig=None
 
 [fireboom-singlecore-nic-lbp]
-agfi=agfi-07ff0b0d6c32d3c54
+agfi=agfi-06f0280bc843bc13e
 deploytripletoverride=None
 customruntimeconfig=None
 
 [fireboom-singlecore-no-nic-ddr3-llc4mb]
-agfi=agfi-0cfc78f07c15d3c7c
+agfi=agfi-06af32e23be49f5d0
 deploytripletoverride=None
 customruntimeconfig=None
 
 [fireboom-singlecore-no-nic-lbp]
-agfi=agfi-077d1f12a88d6b29a
+agfi=agfi-0673639cb9ae9d4d0
 deploytripletoverride=None
 customruntimeconfig=None
 
-[fireboom-singlecore-nic-ddr3-llc4mb]
-agfi=agfi-0c6ce0050de7813fe
+[firesim-quadcore-nic-ddr3-llc4mb]
+agfi=agfi-01fcd09aa9a22a81e
+deploytripletoverride=None
+customruntimeconfig=None
+
+[firesim-quadcore-nic-lbp]
+agfi=agfi-034d73970b3ff9b33
+deploytripletoverride=None
+customruntimeconfig=None
+
+[firesim-quadcore-no-nic-ddr3-llc4mb]
+agfi=agfi-07a1d8925c3b9213f
+deploytripletoverride=None
+customruntimeconfig=None
+
+[firesim-quadcore-no-nic-lbp]
+agfi=agfi-03ba523656104145a
+deploytripletoverride=None
+customruntimeconfig=None
+
+[firesim-singlecore-nic-lbp]
+agfi=agfi-00df7bcf8f8374b5b
+deploytripletoverride=None
+customruntimeconfig=None
+
+[firesim-singlecore-no-nic-lbp]
+agfi=agfi-061edbd6ddf2b1dee
 deploytripletoverride=None
 customruntimeconfig=None

docs/Advanced-Usage/Miscellaneous-Tips.rst

@@ -108,3 +108,27 @@ on the RUN FARM INSTANCE:
 
 
 At this point, you will be able to access the outside internet, e.g. ``ping google.com`` or ``wget google.com``.
+
+
+Navigating the FireSim Codebase
+---------------------------------
+
+This is a large codebase with tons of dependencies, so navigating it can be
+difficult. By default, a ``tags`` file is generated when you run
+``./build-setup.sh`` which aids in jumping around the codebase. This file is
+generated by Exuberant Ctags and many editors support using this file to jump
+around the codebase. You can also regenerate the ``tags`` file if you make code changes
+by running ``./gen-tags.sh`` in your FireSim repo.
+
+For example, to use these tags to jump around the codebase in ``vim``, add the following to
+your ``.vimrc``:
+
+::
+
+    set tags=../tags,../../tags,../../../tags,../../../../tags,../../../../../tags,../../../../../../tags,../../../../../../../tags,../../../../../../../../tags,tags
+
+
+Then, you can move the cursor over something you want to jump to and hit
+``ctrl-]`` to jump to the definition and ``ctrl-t`` to jump back out. E.g. in
+top-level configurations in FireSim, you can jump all the way down through the
+Rocket Chip codebase and even down to Chisel.

gen-tags.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+# ctags wrapper
+ctags -R --exclude=@.ctagsignore --links=no

platforms/f1/aws-fpga

@@ -1 +1 @@
-Subproject commit ebf5db945a1298461853e0eb99e6a9982d1a01cc
+Subproject commit bca30e63c91b30e6db9b253077da805ca69513e7

sim/.ctagsignore

@@ -1,2 +0,0 @@
-target
-target-rtl/firechip/riscv-tools

sim/midas

@@ -1 +1 @@
-Subproject commit b947a569b439a57d42005827abf6290f1eae3a60
+Subproject commit c0af260b6d3a540a47f6d46e9c1cc7cc55e61153

target-design/firechip

@@ -1 +1 @@
-Subproject commit 22f09f02cd95c59e97e02935adf3fd9eaa2acfc3
+Subproject commit 97153b5abe15ba1ad51ec8bda44b7f5ac6a876ad