# Installing Coriolis2
-TODO: include tasyagle <https://www-soc.lip6.fr/en/team-cian/softwares/tasyagle/>
-
-## Automated Installation
-The new automated method of installing/setting coriolis2 is as follows:
-
-1. Clone the repo "dev-env-setup". Tutorial assumes the directory is located under your user's home.
-1. Run the script "mk-deb-chroot" to create a chroot environment. Tutorial assumes the name is "libresoc"
-1. Run the script "cp-scripts-to-chroot" to copy the dev-env-setup directory over to your new chroot environment.
-1. Login into the new scroot environment as a normal user (should be the same as your current user).
-1. Run the script "coriolis-install"
-1. Once cgt window appears, go to File, Open Cell, and type chip_r.
-1. You should now have a working Coriolis environment!
-
-In a terminal:
-
+Videos and links:
+
+* <https://www.youtube.com/watch?v=TN9AQgoVwDw&list=PLj2N46Uqs4huGN-redGHVEILPz17OBu37&index=11>
+* <http://coriolis.lip6.fr/>
+* <https://gitlab.lip6.fr/vlsi-eda>
+* <https://www.youtube.com/watch?v=C0diiTc7_VI&list=PLBtNqZjUZB80uByfZVm0gGYEtmTG0mZzm&index=5>
+* <https://www.youtube.com/watch?v=e0ATrAlNzWk>
+* <https://fosdem.org/2022/schedule/event/coriolis2/>
+* <https://archive.fosdem.org/2021/schedule/event/alliance/>
+* <https://www.youtube.com/watch?v=TN9AQgoVwDw>
+* HiTas (tasyagle) page: [[tasyagle]]
+
+## Automated Installation - One-liner
+
+The new automated method of installing/setting up Coriolis2 is as follows:
+
+1. Clone the repo "dev-env-setup".
+ <https://git.libre-soc.org/?p=dev-env-setup.git;a=summary>
+ Tutorial assumes the directory is located under user's home.
+2. Run the script "coriolis2-chroot" to create a new chroot environment,
+ and setup Coriolis2.
+3. Once cgt window appears, go to File, Open Cell, and type chip_r.
+4. You should now have a working Coriolis chroot!
+
+In a terminal (of course you checked what this does before running
+it because it is "commands downloaded off the internet", and you
+of course take absolute and complete and full responsibility):
+
+ $ git clone https://git.libre-soc.org/git/dev-env-setup.git
$ cd ~/dev-env-setup
$ sudo bash
- # ./mk-deb-chroot libresoc
- # ./cp-scripts-to-chroot libresoc
-
-In a separate terminal as normal user:
+ # ./coriolis2-chroot
- $ scroot -c libresoc
- (libresoc)$ cd ~/dev-env-setup
- (libresoc)$ ./coriolis-install
-
-And now you wait...I suggest occasionally checking the status messages, especially after apt finished updating the packages and the script moves on to compiling yosys, coriolis2, alliance, as well as when alliance-check-toolkit generates the floorplan for you.
+And now you wait... (about 30-45min, depends on your CPU).
+I suggest occasionallly checking the status messages,
+especially after apt finished updating the packages and the script moves on
+to compiling yosys, coriolis2, alliance, as well as when
+alliance-check-toolkit generates the floorplan for you.
This is what the chip floorplan should look like:
-[[!img chip_r_flooplan.png ]]
-
-# More Details
-
-
-## debootstrap
-
-Perhaps this should be moved to [[devscripts]] as part of "mk-deb-chroot" script explanation?
-
-First set up an schroot debootstrap jail with debian 10.
-These instructions are based on information taken from here:
-<https://www.debian.org/releases/stretch/amd64/apds03.html.en>
-
-In advance, on the host system, edit /etc/fstab and add mount points:
-
-(edit: personally I prefer using mount --bind points. however if doing
-that then after a reboot the chroot will lose the bind mountpoints
-and the commands need to be re-run, without which the chroot is
-unusable)
+[[!img chip_r_floorplan.png ]]
- /dev /home/chroot/coriolis/dev none bind 0 0
- /dev/pts /home/chroot/coriolis/dev/pts none bind 0 0
- /proc /home/chroot/coriolis/proc none bind 0 0
- /sys /home/chroot/coriolis/sys none bind 0 0
- /tmp /home/chroot/coriolis/tmp none bind 0 0
+## Automated Installation - Separated Steps
+The steps performed by "coriolis2-chroot" can be done manually and are:
-Then run these commands:
-
- sudo bash
- apt-get install debootstrap schroot
- mkdir /opt/chroot/coriolis
- /usr/sbin/debootstrap buster !$ http://ftp.us.debian.org/debian
- mount /home/chroot/coriolis/dev
- mount /home/chroot/coriolis/dev/pts
- mount /home/chroot/coriolis/proc
- mount /home/chroot/coriolis/sys
- mount /home/chroot/coriolis/tmp
- echo "coriolis2" > /home/chroot/coriolis/etc/debian_chroot
-
-To do some preparation (users):
-
- chroot /home/chroot/coriolis2 /bin/bash
- adduser {yourpreferredusername}
-
-It is best to make the username the same as the first user that
-was added during the *main* (non-chroot) debian install, so that
-uid 1000 matches between both main and chroot. You can check
-this by looking at /etc/passwd as root, or by typing "id".
-
- lkcl@fizzy:~$ id
- uid=1000(lkcl) gid=1000(lkcl) groups=1000(lkcl),5(tty),....
-
-Alternatively, /etc/passwd and /etc/group may
-be mount-bound as well as /home however if you later forget you did
-this and decide to delete the chroot, you will delete the entire /home
-of your main system, as well as /etc/passwd.
-
-You may wish to follow some of the other things such as configuring apt,
-locales and keyboard, from the above-linked debian-admin HOWTO.
-
-bootloader, kernel, ssh access, are unnecessary. Do run "apt clean" to clear out /var/cache/apt/archives in the chroot.
-
-## schroot
-
-Perhaps this should be moved to [[devscripts]] as part of "mk-deb-chroot" script explanation?
-
-Create an schroot file section for the coriolis chroot by
-editing /etc/schroot/schroot.conf:
+1. Run the script "mk-deb-chroot" to create a chroot environment.
+Tutorial assumes the name is "coriolis"
+1. Run the script "cp-scripts-to-chroot" to copy the dev-env-setup directory
+over to your new chroot environment.
+1. Login into the new scroot environment as a normal user
+(should be the same as your current user).
+1. Run the script "coriolis-install"
- [coriolis]
- description=Debian Buster for Coriolis
- directory=/home/chroot/coriolis
- groups=sbuild-security,lkcl,users
+In a terminal:
-Now as an *ordinary* user - not as root - you may type:
+ $ cd ~/dev-env-setup
+ $ sudo bash
+ # ./mk-deb-chroot coriolis
+ # ./cp-scripts-to-chroot coriolis
- lkcl@fizzy:~$ schroot -c coriolis
+In a separate terminal as normal user:
-and, due to the contents of /etc/debian\_chroot, and that you were in
-fact logged in as uid 1000 and did in fact add a user to the chroot
-as uid 1000, the prompt should become:
+ $ scroot -c coriolis
+ (coriolis)$ cd ~/dev-env-setup
+ (coriolis)$ ./coriolis-install
- (coriolis2)lkcl@fizzy:~$
+# Further Details
-If however you need to run as root, then from outside the chroot,
-as *root*, you run this:
+## Python3 Coriolis Support
- lkcl@fizzy:~# schroot -c coriolis
+A separate script will be written to use the latest development version of Coriolis2.
+For now however, a stable version is pulled in, which still uses Python2.
-and you will see this as a result:
+## Chroot/Jail Environment
- (coriolis2)lkcl@fizzy:~#
+See [[devscripts]] for explanation of the "mk-deb-chroot" script.
-## coriolis2
+## Coriolis2 Setup
These are nominally taken from
<https://www-soc.lip6.fr/equipe-cian/logiciels/coriolis/>
This will remove debian/buster yosys however getting the build dependencies is quick and easy enough.
As the ordinary user, the following instructions can be followed
-(<http://www.clifford.at/yosys/download.html>)
+(<https://github.com/YosysHQ/yosys>)
cd ~
- git clone https://github.com/cliffordwolf/yosys.git
+ git clone https://github.com/YosysHQ/yosys
cd yosys
git checkout 049e3abf9baf795e69b9ecb9c4f19de6131f8418
make config-clang
make install
-## Check out alliance
+## Alliance
Adapted from <https://www-soc.lip6.fr/en/team-cian/softwares/alliance/>
alliace installed above by doing the following
(using experiment9 as an example):
+ $ source ~/coriolisenv # if not done already
$ cd ~/src
$ git clone https://git.libre-soc.org/git/soclayout.git
$ cd soclayout/
* run the coriolis2-chroot script as root
* drop into the schroot
* navigate to the soclayout/experiments9 directory
-* run the ./build_full_4k_sram.sh script
+* check out the final tag
+ <https://git.libre-soc.org/?p=soclayout.git;a=tag;h=refs/tags/LS180_RC8_FINAL>
+* run the ./build_full_4k_sram_recon.sh script
* run "make view" to see the results.
The FreePDK45 Chips4Makers FlexLib variant is slightly
$ sudo bash
# ./coriolis2-chroot
# exit
-$ schroot -c cotiolis
+$ schroot -c coriolis
+$ source ~/coriolisenv
$ cd soclayout/experiments9
-$ ./build_full_4k_sram.sh
+$ git checkout LS180_RC8_FINAL
+$ ./build_full_4k_sram_recon.sh
```
(now do something else for the next 90 minutes)
projects / libreriscv.git / blobdiff