Skip to content

Commit

Permalink
docs: recommend Sifive August 2020 toolchain
Browse files Browse the repository at this point in the history
This gives us GCC 10.1 which produces faster code than 8.x. We can't use
the Sifive release of GCC 10.2 because it doesn't include rv32im.

Signed-off-by: Dan Callaghan <dcallagh@google.com>
  • Loading branch information
danc86 committed Nov 15, 2021
1 parent ca18eec commit 4481a18
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 6 deletions.
8 changes: 4 additions & 4 deletions docs/source/setup-guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,19 +35,19 @@ Step 2: Install Vivado and Renode
Step 3: Install RISCV toolchain
-------------------------------

1. Download the `April 2020`_ toolchain from freedom-tools and unpack the binaries to your home directory:
1. Download the `August 2020`_ toolchain from freedom-tools and unpack the binaries to your home directory:

.. _`April 2020`: https://github.com/sifive/freedom-tools/releases/tag/v2020.04.0-Toolchain.Only
.. _`August 2020`: https://github.com/sifive/freedom-tools/releases/tag/v2020.08.0

.. code-block:: bash
$ tar xvfz ~/Downloads/riscv64-unknown-elf-gcc-8.3.0-2020.04.1-x86_64-linux-ubuntu14.tar.gz
$ tar xvfz ~/Downloads/riscv64-unknown-elf-gcc-10.1.0-2020.08.2-x86_64-linux-ubuntu14.tar.gz
2. Add the toolchain to your `PATH` in your ``.bashrc`` script:

.. code-block:: bash
export PATH=$PATH:$HOME/riscv64-unknown-elf-gcc-8.3.0-2020.04.1-x86_64-linux-ubuntu14/bin
export PATH=$PATH:$HOME/riscv64-unknown-elf-gcc-10.1.0-2020.08.2-x86_64-linux-ubuntu14/bin
Step 4: Clone the CFU-Playground Repository
Expand Down
4 changes: 2 additions & 2 deletions scripts/setup
Original file line number Diff line number Diff line change
Expand Up @@ -118,8 +118,8 @@ if ! which riscv64-unknown-elf-gcc >/dev/null; then
echo "Error: RISCV GCC toolchain not found. Please install one, following the instructions at"
echo "https://cfu-playground.readthedocs.io/en/latest/setup-guide.html#step-3-install-riscv-toolchain"

elif ! riscv64-unknown-elf-gcc --version | grep 'SiFive GCC 8.3.0-2020.04.1.' >/dev/null; then
echo "Unsupported version of riscv64-unknown-elf-gcc. SiFive GCC 8.3.0-2020.04.1 is known to work." >&2
elif ! riscv64-unknown-elf-gcc --version | grep 'SiFive GCC 10.1.' >/dev/null; then
echo "Unsupported version of riscv64-unknown-elf-gcc. SiFive GCC 10.1.0 is known to work." >&2
echo "To install this version, follow the instructions at"
echo "https://cfu-playground.readthedocs.io/en/latest/setup-guide.html#step-3-install-riscv-toolchain"
fi
Expand Down

0 comments on commit 4481a18

Please sign in to comment.