From 80f518882c572ba9b6834b9cb0fa04e1a3945e65 Mon Sep 17 00:00:00 2001 From: Daniel Lublin Date: Thu, 1 Dec 2022 19:10:13 +0100 Subject: [PATCH] Clarify commonly needed pkgs Signed-off-by: Daniel Lublin --- doc/toolchain_setup.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/doc/toolchain_setup.md b/doc/toolchain_setup.md index 333907b..96ab05f 100644 --- a/doc/toolchain_setup.md +++ b/doc/toolchain_setup.md @@ -1,13 +1,13 @@ # Toolchain setup -Here are instructions for setting up the tools required to build the project. -Tested on Ubuntu 22.10. +Here are instructions for setting up the tools required to build the +project. Tested on Ubuntu 22.10. -## Gateware: icestorm toolchain +## General development environment -These steps are used to build and install the -[icestorm](http://bygone.clairexen.net/icestorm/) toolchain (in -`/usr/local`). Note that nextpnr replaces Arachne-PNR. +The following is intended to be a complete list of the packages that +are *required* to build the gateware icestorm toolchain, the firmware, +and the apps. sudo apt install build-essential clang lld llvm bison flex libreadline-dev \ gawk tcl-dev libffi-dev git mercurial graphviz \ @@ -19,6 +19,12 @@ These steps are used to build and install the ninja-build libglib2.0-dev libpixman-1-dev \ golang +## Gateware: icestorm toolchain + +These steps are used to build and install the +[icestorm](http://bygone.clairexen.net/icestorm/) toolchain (in +`/usr/local`). Note that nextpnr is replacing Arachne-PNR. + git clone https://github.com/YosysHQ/icestorm cd icestorm make -j$(nproc) @@ -54,7 +60,7 @@ References: ## Firmware: riscv toolchain -The Tillitis Key 1 implements a +The Tillitis TKey implements a [picorv32](https://github.com/YosysHQ/picorv32) soft core CPU, which is a RISC-V microcontroller with the M and C instructions (RV32IMC). You can read