=======================================
Install Genio Hardware Support Packages
=======================================

Several MediaTek proprietary components for hardware acceleration are not pre-installed in the Ubuntu OS image, including:

* Video hardware packages: User space daemons and firmware for Genio SoC hardware video codec and video format conversion hardware. 

* NeuroPilot packages: Firmware, tools and libraries for machine learning hardware on Genio 510, Genio 700, and Genio 1200.

These Genio hardware support packages are publicly available in a 
personal package archive(`PPA <https://help.ubuntu.com/community/PPA>`__):
`ppa:mediatek-genio/genio-public <https://launchpad.net/~mediatek-genio/+archive/ubuntu/genio-public>`__.

These packages are maintained by MediaTek and are distributed under proprietary licenses.
Please follow the steps below to install these packages to enable hardware acceleration features for Ubuntu on Genio.

.. _add-genio-ppa:

Add Genio Package Archive
=========================

Before installing these proprietary packages, you need to add the `archives <https://help.ubuntu.com/community/PPA>`__ 
to the list of trusted repositories on your board first.
To do so, follow these steps:

1. Make sure the Genio EVK is connected to the internet
2. Login to the Ubuntu console.
3. Use the following commands to register `ppa:mediatek-genio/genio-public <https://launchpad.net/~mediatek-genio/+archive/ubuntu/genio-public>`__:

    .. prompt:: bash $ auto
        
        $ sudo apt-add-repository ppa:mediatek-genio/genio-public

4. Press **ENTER** key when prompted. The ``apt-add-repository`` tool automatically
   fetches package lists from all registered archives.

At this point, these packages should be available to your Genio EVK:

.. toctree::
    :caption: Genio Packages
    :titlesonly:

    Video Drivers <bsp-installation/video>
    AI Processor Drivers <bsp-installation/neuropilot>

Add Pre-Release Genio Package Archive
=====================================

If you'd like to test pre-release packages for early bug fixes, or help testing
new versions of Genio packages, instead of adding ``ppa:mediatek-genio/genio-public``,
you could add ``ppa:mediatek-genio/genio-proposed`` instead.

The ``genio-proposed`` PPA stores newer versions of Genio packages that are still under development
and testing. So it can be unstable and you should only use the ``genio-proposed`` PPA for development
or testing purposes.

Use the following commands to register `ppa:mediatek-genio/genio-proposed <https://launchpad.net/~mediatek-genio/+archive/ubuntu/genio-proposed>`__:

    .. prompt:: bash $ auto
        
        $ sudo apt-add-repository ppa:mediatek-genio/genio-proposed