Apio Developement Builds

• Installing Apio
  • All supported platforms
    • Using a Python pip package
  • Mac OSX (Apple Silicon)
    • Using an installer
    • Using a file bundle
  • Linux (X86 64 bit)
    • Using a Debian package
    • Using a file bundle
  • Windows (X86 64 bit)
    • Using an installer
    • Using a file bundle

This repository contains the build workflows and the daily releases of the Apio, an easy to use FPGA design framework. For installation, see the instructions below.

Apio is currently supported on the following platforms:

Code	Description
darwin_arm64	Mac OSX, ARM 64 bit (Apple Silicon)
darwin_x86_64	Mac OSX, x86 64 bit (Intel)
linux_x86_64	Linux X86 64 bit
linux_aarch64	Linux ARM 64 bit
windows_amd64	Windows x86 64 bit

[NOTES]

• To upgrade an already installed Apio, first uninstall it and then install the new version.
• If you encounter any problem, please create an issue in the Apio's main repository.

TODO: Add installation instructions darwin_x86_64

TODO: Add installation instructions linux_aarch64

---

Installing Apio

---

All supported platforms

Using a Python pip package

If you have Python installed on your system, you can use this method to install Apio as a Pip package.

Install

1. Run python --version and verify that you have a 'reasonably recent' python version. (Apio's minimum Python requirement is specified in its project file).

2. Install the latest Apio code by running the following command.

pip install --force-reinstall -U git+https://github.com/FPGAwars/apio.git@develop#egg=apio

3. Run apio in a new shell to test the installation.

Uninstall

1. Delete the apio pip package by running pip uninstall apio.

2. Delete the Apio settings directory .apio under your home directory.

---

Mac OSX (Apple Silicon)

Using an installer

Install

1. Download the installer file apio-darwin-arm64-[version]-[date]-installer.pkg from the latest release.

2. Run the following command in the directory where you downloaded the installer file (replace [version] and [date] with the actual values) this will allow the unsigned installer to run.

xattr -d com.apple.quarantine apio-darwin-arm64-[version]-[date]-installer.pkg

1. Double click on the installer file and follow the instructions.

2. Run apio in a new shell to test the installation.

Unnstall

1. Delete the apio application from Applications.

2. Delete the Apio settings directory .apio under your home directory.

Using a file bundle

Install

1. Download the bundle file apio-darwin-arm64-[version]-[date]-bundle.zip from the latest release.

2. Unzip the bundle file. This will create an apio directory with the application files.

3. Run the following shell command in the apio directory to allow the unsigned files of the Apio app to run.

source ./activate

4. [Optional] Move the apio dir to a place of your choosing.

5. Add the apio dir to your $PATH.

6. Open a new shell and run apio to test the installation.

Unnstall

1. Remove the apio directory from your $PATH

2. Delete the apio directory

3. Delete the Apio settings directory .apio under your home directory.

---

Linux (X86 64 bit)

Using a Debian package

Install

1. Download the debian package file apio-linux-x86-64-[version]-[date]-debian.deb from the latest release.

2. Run the following shell command in the the directory where you downloaded the Debian package (replace [version] and [date] with the actual values) .

sudo apt install ./apio-linux-x86-64-[version]-[date]-debian.deb

2. Open a new shell and run apio to test the installation.

Unnstall

1. Run the following command to uninstall the Debian package:

sudo apt remove apio

2. Delete the Apio settings directory .apio under your home directory.

Using a file bundle

Install

1. Download the bundle file apio-linux-x86-64-[version]-[date]-bundle.zip from the latest release.

2. Unzip the bundle file. This will create an apio directory with the application files.

3. [Optional] Move the apio dir to a place of your choosing.

4. Add the apio dir to your $PATH.

5. Open a new shell and run apio to test the installation.

Unnstall

1. Remove the apio directory from your $PATH

2. Delete the apio directory

3. Delete the Apio settings directory .apio under your home directory.

---

Windows (X86 64 bit)

Using an installer

Install

1. Download the installer file apio-windows-amd64-[version]-[date]-installer.exe from the latest release.

2. Double click on the installer and follow the instructions. If your system complains that the installer is not signed, click Mofe Info and the Run Anyway.

3. Run apio in a new shell to test the installation.

Unnstall

1. Remove the apio application in windows's Add or remove programs settings.

2. Delete the Apio settings directory .apio under your home directory.

Using a file bundle

Install

1. Download the bundle file apio-windows-amd64-[version]-[date]-bundle.zip from the latest release.

2. Unzip the bundle file. This will create an apio directory with the application files.

3. [Optional] Move the apio dir to a place of your choosing.

4. Add the apio dir to your %PATH%.

5. Open a new command window and run apio to test the installation.

Unnstall

1. Remove the apio directory from your %PATH%

2. Delete the apio directory

3. Delete the Apio settings directory .apio under your home directory.