Docker-Image.md

@@ -79,7 +79,7 @@ docker run \
     socks.lbl.gov:4567/cag/bxe
 ```
 
-Any changes made in `/app` in the Docker container are reflected in `/tmp/mpoint` on the host. You can mount multiple directories with multiple `-v [HOSTDIR]:[CONTAINERDIR]` flags with the different mounts.
+Any changes made in `/app` in the Docker container are reflected in `/tmp/mpoint` on the host. You can mount multiple directories with multiple `-v [HOSTDIR]:[CONTAINERDIR]` flags with the different mounts.``
 
 # Initializing the Chipyard and FireMarshal Environment
 
@@ -107,6 +107,45 @@ Sourcing Chipyard Environment...
 ```
 
 You are now ready to build RTL with Chipyard and build software with FireMarshal.
+# File and Directory Structure
+
+## FireSim
+
+Environment Variable: `$FIRESIM_ROOT`
+
+Directory Path: `~/firesim`
+
+Files/Directories of Note:
+
+- `deploy`: This is where the FireSim configuration YAML is located, specifically `config_build_recipes.yaml`, `config_build.yaml`, `config_hwdb.yaml`, and `config_runtime.yaml`.
+
+
+## Chipyard
+
+Environment Variable: `$CHIPYARD_ROOT`
+
+Directory Path: `~/firesim/target-design/chipyard`
+
+Files/Directories of Note:
+
+- `generators`: This is a collection of all of the source code required hardware generators contained within Chipyard. This includes Rocket Chip (SoC generator), Rocket/BOOM/CVA6 (Processors), Constellation (NoC Generator), among many more. This is the place to put any custom hardware for your design.
+
+- `build.sbt`: This file manages the relative locations of all of the Scala packages needed to run the Chipyard generator. If you add any custom hardware as it's own Scala package, make sure to add its path to this file, as well as making it a dependency for the `chipyard` package.
+
+- `generators/chipyard/src/main/scala/DigitalTop.scala`: This file controls the top level dependencies for the RocketChip SoC generators. If you add any custom hardware, make sure to add your hardware Scala Trait to the `DigitalTop` module in `DigitalTop.scala`.
+
+- `sims/verilator`: This is where you run `make` with the config flag of your custom hardware. All Verilog is generated here as well.
+
+## FireMarshal
+
+Environment Variable: N/A
+
+Directory Path: `$CHIPYARD_ROOT/software/firemarshal`
+
+Files/Directories of Note:
+
+- `example-workloads`: This directory contains examples of using FireMarshal for different OS or bare-metal based systems.
+
 
 ---