Installation.md

Contents

• System requirements
• Install Apio
• Install FTDI-DRIVERs
• Install Serial Drivers

System requirements

Apio is written in Python and works on Linux (+ARM), Mac OS X and Windows

• Operating System: Linux (+ARM), Mac OS X or Windows
• Python Interpreter: Python 3.9 or higher

Important

Windows Users: Please Download the latest Python and install it
DON'T FORGET to select Add python.exe to Path feature on the "Customize" stage, otherwise Python Package Manager pip command will not be available.

• Terminal Application: All commands below should be executed in Command-line application (Terminal).

  • For Mac OS X and Linux OS: Terminal application,
  • For Windows OS: cmd.exe application

• Access to Serial Ports (USB/UART):

  • Windows Users: Please check that you have correctly installed USB driver from board manufacturer.
  • Linux Users: Ubuntu/Debian users may need to add own "username" to the "dialout" group if they are not "root", doing this issuing a sudo usermod -a -G dialout $USER.

Install Apio

The latest stable version of Apio may be installed or upgraded via Python Package Manager (pip as follows:

    $ pip install -U apio

Note that you may run into permissions issues running these commands. You have a few options here:

• Run with sudo to install Apio and dependencies globally
• Specify the pip install --user option to install local to your user
• Run the command in a python virtual env local to a specific project working set

Install FTDI drivers

For boards with a FTDI interface

$ apio drivers --ftdi-enable

To revert the FTDI drivers configuration.

$ apio drivers --ftdi-disable

Install Serial drivers

For boards with a Serial interface.

$ apio drivers --serial-enable

To revert the Serial drivers configuration.

  $ apio drivers --serial-disable

---