Installation¶

Get AsteRISC¶

Step 1: Clone the repository¶

sudo apt update
sudo apt install -y git
git clone https://github.com/jsaussereau/AsteRISC.git
cd AsteRISC/
git submodule update --init --recursive

sudo dnf update
sudo dnf install -y git
git clone https://github.com/jsaussereau/AsteRISC.git
cd AsteRISC/
git submodule update --init --recursive

sudo pacman -Syu
sudo pacman -S git --noconfirm
git clone https://github.com/jsaussereau/AsteRISC.git
cd AsteRISC/
git submodule update --init --recursive

Install EDA tools¶

To run command from the Quick start section to work, you need the following tools:

Verilator 5+

Warning

Depending on your system, to have Verilator 5+, you may have to build it from source. Concerned distributions include: Ubuntu 22.04 and older, Debian 11 and older, Fedora 38 and older.

Vivado

Note

Vivado ML standard edition is a free Vivado version with no license requirements.

Install Asterism¶

Step 1: Install Python 3.6+ and make¶

sudo apt install -y python3 make

sudo dnf install -y python3 make

sudo pacman -S python3 make --noconfirm

Step 2: Install Python requirements¶

Option #1: Using pipx (recommended)¶

cd Asterism
sudo apt install -y pipx
make pipx_install
pipx ensurepath

cd Asterism
sudo dnf install -y pipx
make pipx_install
pipx ensurepath

cd Asterism
sudo pacman -S python-pipx --noconfirm
make pipx_install
pipx ensurepath

Warning

If the directory where pipx stores apps was not already in your PATH environment variable, you have to start a new shell session before running Asterism

Option #2: Using pip¶

cd Asterism
sudo apt install python3-pip
pip3 install -r requirements.txt

cd Asterism
sudo dnf install python3-pip
pip3 install -r requirements.txt

cd Asterism
sudo pacman -Sy python-pip
pip3 install -r requirements.txt