From 857ce9dd9b19d8b308ff30eefd2a9b2aa2656eb9 Mon Sep 17 00:00:00 2001 From: David Biancolin Date: Sun, 8 Sep 2019 15:33:27 -0700 Subject: [PATCH 1/4] [docs] Tell users to source env.sh in quick start --- docs/Quick-Start.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/Quick-Start.rst b/docs/Quick-Start.rst index 936597e6..fac3f8ab 100644 --- a/docs/Quick-Start.rst +++ b/docs/Quick-Start.rst @@ -28,6 +28,11 @@ To build the toolchains, you should run: .. Note:: If you are planning to use the Hwacha vector unit, or other RoCC-based accelerators, you should build the esp-tools toolchains by adding the ``esp-tools`` argument to the script above. If you are running on an Amazon Web Services EC2 instance, intending to use FireSim, you can also use the ``--ec2fast`` flag for an expedited installation of a pre-compiled toolchain. +Finally, set up Chipyard environment varibles and put the newly built toolchain on your path: + +.. code-block:: shell + + source ./env.sh What's Next? ------------------------------------------- From d0b00d4ddf9a883c0d159e78e8d7c397bb714a9e Mon Sep 17 00:00:00 2001 From: David Biancolin Date: Sun, 8 Sep 2019 15:33:58 -0700 Subject: [PATCH 2/4] [docs] gitignore build files --- docs/.gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/.gitignore diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 00000000..e35d8850 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1 @@ +_build From a0d009b8e4c9fbd5cca696dcfadd9c8bcf0429b5 Mon Sep 17 00:00:00 2001 From: David Biancolin Date: Sun, 8 Sep 2019 15:41:12 -0700 Subject: [PATCH 3/4] [docs] Make _What's Next_ more succinct --- docs/Quick-Start.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/Quick-Start.rst b/docs/Quick-Start.rst index fac3f8ab..fc022ca0 100644 --- a/docs/Quick-Start.rst +++ b/docs/Quick-Start.rst @@ -39,16 +39,16 @@ What's Next? This depends on what you are planning to do with Chipyard. -* If you want to learn about the structure of Chipyard, go to :ref:`chipyard-components`. +* To learn about the structure of Chipyard, see :ref:`chipyard-components`. -* If you intend to build one of the vanilla Chipyard examples, go to :ref:`build-a-chip` and follow the instructions. +* To build one of the vanilla Chipyard examples, see :ref:`build-a-chip`. -* If you intend to add a new accelerator, go to :ref:`adding-an-accelerator` and follow the instructions. +* To add a new accelerator, see :ref:`adding-an-accelerator`. -* If you intend to run a simulation of one of the vanilla Chipyard examples, go to :ref:`sw-rtl-sim-intro` and follow the instructions. +* To run a simulation of one of the Chipyard examples, see :ref:`sw-rtl-sim-intro`. -* If you intend to run a simulation of a custom Chipyard SoC Configuration, go to <> and follow the instructions. +* To run a simulation of a custom Chipyard SoC Configuration, see <>. -* If you intend to run a full-system FireSim simulation, go to :ref:`firesim-sim-intro` and follow the instructions. +* To run a FPGA-accelerated simulation using FireSim, see :ref:`firesim-sim-intro`. -* If you intend to run a VLSI flow using one of the vanilla Chipyard examples, go to <> and follow the instructions. +* To run a VLSI flow using one of the vanilla Chipyard examples, see <>. From 2cba47b6972dd9e2713744c8d469346e55f44fa1 Mon Sep 17 00:00:00 2001 From: David Biancolin Date: Sun, 8 Sep 2019 21:37:02 -0700 Subject: [PATCH 4/4] [docs] A couple spelling fixes in Quick Start [skip ci] --- docs/Quick-Start.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Quick-Start.rst b/docs/Quick-Start.rst index fc022ca0..86d62b11 100644 --- a/docs/Quick-Start.rst +++ b/docs/Quick-Start.rst @@ -28,7 +28,7 @@ To build the toolchains, you should run: .. Note:: If you are planning to use the Hwacha vector unit, or other RoCC-based accelerators, you should build the esp-tools toolchains by adding the ``esp-tools`` argument to the script above. If you are running on an Amazon Web Services EC2 instance, intending to use FireSim, you can also use the ``--ec2fast`` flag for an expedited installation of a pre-compiled toolchain. -Finally, set up Chipyard environment varibles and put the newly built toolchain on your path: +Finally, set up Chipyard's environment variables and put the newly built toolchain on your path: .. code-block:: shell