3 This section describes the workflow for developing the LibreSoC.
7 RAM is the biggest requirement. Minimum 16GB, the more the better. Disk space is not hugely critical: 256GB SSD should be more than adequate. Simulations however are where raw processing power is a must. High end Graphics Cards are nonessential.
11 First install Debian (ubuntu if you absolutely must) for standardisation cross-team and so that toochain installation is greatly simplified.
13 A basic GUI desktop is necessary: fvwm2, xfce, lxde are perfectly sufficient (alongside wicd-gtk for network management). Other more complex desktops can be used however may consume greater resources.
15 # Software prerequisites
17 Whilst many resources advocate sudo in front of all of the root-level command below, this is extremely irritating. run "sudo bash", get a root prompt, and save some typing.
19 * apt-get install build-essential
20 * apt-get install git python3.7 python3.7-dev python-nosetest3
21 * apt-get install graphviz xdot
22 * return to user prompt (ctrl-d)
26 Follow the source code (git clone) instructions here: <http://www.clifford.at/yosys/download.html>
28 Do not try to use a fixed revision, nmigen is evolving and frequently interacts with yosys
32 Follow the instructions here: <https://symbiyosys.readthedocs.io/en/latest/quickstart.html#installing>
34 You do not have to install all of those (avy, boolector can be left out if desired).
38 nmigen may be installed as follows:
42 * git clone https://github.com/m-labs/nmigen.git
45 * python3 setup.py develop
48 testing can then be carried out with "python3 setp.py test"
50 # Registering for git repository access
52 After going through the onboarding process and having agreed to take responsibility for certain tasks, ask on the mailing list for git repository access, sending in a public key (id_rsa.pub). If you do not have one generate it with ssh-keygen -t rsa.
54 NEVER SEND ANYONE THE PRIVATE KEY.
56 Create a file ~/.ssh/config with the following lines:
57 Host git.libre-riscv.org
60 Wait for the Project Admin to confirm that the ssh key has been added to the required repositories. Once confirmed,
61 you can clone any of the repos at http://git.libre-riscv.org:
62 git clone gitolite3@git.libre-riscv.org:REPONAME.git