.. _cross_compilation_setup:

Cross Compilation Environment
#############################

The SiMa DevKit comes pre-flashed with SiMa's Yocto Linux, a build system designed for creating custom Linux distributions tailored to embedded systems. 
Unlike Ubuntu, Yocto Linux does not include a package manager like ``apt``.

Developers can create `custom Yocto builds <https://github.com/SiMa-ai/meta-simaai/blob/master/documentation/build-manual.rst>`_ by introducing their 
own recipes or use the SiMa-provided Yocto SDK to cross-compile applications and third-party components from source code.

For developers new to setting up a Yocto Linux build, it is still possible to build applications that run on the SiMa-provided Linux distribution.

To setup the cross compilation environment, follow the steps below:

.. code:: bash

    user@palette-container-id:/home/docker/{project}$ source /opt/poky/davinci/4.0.24/environment-setup-cortexa65-poky-linux 

.. note:: 

    The Yocto version may change from the above example when you update Palette. 

This setup configures the build environment to use the right toolchain and libraries for cross-compilation. The following commands shows various tools such as ``CXX`` and how they are configured:

.. code:: bash

    user@palette-container-id:/home/docker/{project}$ env | grep -E 'CC|CXX|LD|SYSROOT|CROSS|TARGET'