Vision Apps User Guide
Build Environment Setup

Table of Contents

IMPORTANT NOTES

  • Make sure you don't skip any of the non-optional steps mentioned below
  • ${PSDKR_PATH} refers to the path where Processor SDK RTOS (PSDK RTOS) is installed
  • ${PSDKL_PATH} refers to the path where Processor SDK Linux (PSDK Linux) is installed
  • All folders like, pdk, tiovx, vision_apps mentioned in the user guide are relative to ${PSDKR_PATH} unless explicitly stated otherwise.
  • The build is tested on Ubuntu (x86_64) 22.04 system and may not work on earlier or later Ubuntu systems.
  • 20GB of free space is required to install and build PSDK RTOS
  • Make sure you have sudo access

Step 1a: Download and Install PSDK RTOS

  • Download and untar PSDK RTOS Tarball ti-processor-sdk-rtos-${SOC}-evm-xx_xx_xx_xx.tar.gz on a Ubuntu 22.04 (x86_64) machine.
    cd {path/to/file}
    tar xf ti-processor-sdk-rtos-${SOC}-evm-xx_xx_xx_xx.tar.gz

Step 1b: Download and Install PSDK RTOS Add-on to run in PC Emulation Mode (Optional, only needed for PC emulation mode)

  • Download and Run PSDK RTOS Add-on package installer file ti-processor-sdk-rtos-${SOC}-evm-xx_xx_xx_xx-addon-linux-x64-installer.run on a Ubuntu 22.04 (x86_64). This package contains performance datasheet documentation as well as PC compiled cmodel libraries for VPAC and DMPAC OpenVX nodes.
    Attention
    The installer is available only through TI mySecure login.
    To Request access for PSDK RTOS Add-on Packages the first time: [LINK]
    mySecure SW Access Link (after access has been granted) : [LINK]
    Note
    This mySecureSW site also contains MCUSW AUTOSAR Configurator package installer
  • Follow instructions on screen to complete the installation.
    Note
    The Installation Directory should be given as the parent directory of ${PSDKR_PATH} (If you choose the Browse option, Make sure you are NOT creating a new folder in the parent directory)

Step 2a: Download and install PSDK Linux (Needed for Linux+RTOS mode or for QNX SPL mode)

  • Note that for Linux+RTOS, PSDK Linux is required only if you are customizing linux. If you want to use TI linux as is, you can skip this step.
  • Run the installer file ti-processor-sdk-linux-adas-${SOC}-evm-xx_xx_xx_xx-Linux-x86-Install.bin on the same Ubuntu 22.04 (x86_64) machine.
  • Follow instructions on screen to complete the installation

Step 2b: Download and Install PSDK QNX addon to run in QNX+RTOS mode (Optional, only needed for QNX+RTOS mode)

The PSDK QNX addon package is dependent on installation of packages from both QNX and Texas Instruments. Reference PSDK QNX Documentation on Getting Started, for details on download and installation.

Once PSDK QNX download and installation is complete, proceed with below steps.

Step 3: Proxy Setup

Skip this step if you are not using a proxy server

In order to download and compile some components from next step, it is required that your PC network proxy is setup properly. Below instructions show how the network proxy is setup assuming a proxy server named "http://proxy.company.com:80" for the domain "company.com". Modify these appropriately for your network.

Proxy for wget

  • To set the "wget" proxy add below lines in ~/.wgetrc
    http_proxy=http://proxy.company.com:80
    https_proxy=http://proxy.company.com:80
    ftp_proxy=http://proxy.company.com:80
    noproxy=ti.com

Proxy for http access

  • Setup HTTP proxy by adding below lines in your ~/.bashrc
    export HTTPS_PROXY=http://proxy.company.com:80
    export https_proxy=http://proxy.company.com:80
    export HTTP_PROXY=http://proxy.company.com:80
    export http_proxy=http://proxy.company.com:80
    export ftp_proxy=http://proxy.company.com:80
    export FTP_PROXY=http://proxy.company.com:80
    export no_proxy=ti.com

Proxy for "apt-get"

  • Add below line in the file /etc/apt/apt.conf
    Acquire::http::proxy "http://proxy.company.com:80";

Proxy for "git"

  • Install corkscrew
    sudo apt-get install corkscrew
  • Create a file ~/.gitconfig and add below content to it
    [user]
    email = <myemail>@company.com
    name = <myname>
    [core]
    gitproxy = none for company.com
    gitproxy = /home/<username>/git-proxy.sh
    [http]
    proxy = http://proxy.company.com:80
    [https]
    proxy = http://proxy.company.com:80
  • Create a file ~/git-proxy.sh and add below lines in it
    #!/bin/sh
    exec /usr/bin/corkscrew proxy.company.com 80 $*
  • Make ~/git-proxy.sh as executable
    chmod +x ~/git-proxy.sh

Proxy for "curl"

  • Add below line in ~/.curlrc file
    proxy=http://proxy.company.com:80

Step 4: Download and install additional dependencies

  • Do below to download and install additional dependencies needed to build PSDK RTOS
    cd ${PSDKR_PATH}
    ./sdk_builder/scripts/setup_psdk_rtos.sh
    Note
    Make sure to call the script from ${PSDKR_PATH} as shown above. DO NOT "cd" into sdk_builder/scripts and call the script

setup_psdk_rtos.sh Script Options

The setup_psdk_rtos.sh script supports various command-line flags to customize the installation based on your specific development needs. Use these flags to skip unnecessary components and reduce setup time.

Usage

./sdk_builder/scripts/setup_psdk_rtos.sh [options]

To view all available options, use:

./sdk_builder/scripts/setup_psdk_rtos.sh --help

Available Flags

Flag Description Use Case
--skip_sudo Skip steps that require sudo command When you don't have sudo access or want to install packages manually. Open the setup_psdk_rtos.sh file and install packages marked with sudo apt install separately.
--qnx_sbl Setup SDK for QNX SBL only, skip SPL u-boot setup steps When developing exclusively with QNX SBL bootloader and don't need SPL-related installations.
--firmware_only Setup SDK for firmware build only, skip Linux build dependencies When building only RTOS firmware (e.g., for Yocto integration) and don't need Linux MPU components.
--skip_linux Skip downloading and installing Linux build components When not building for Linux+RTOS mode or using pre-installed Linux components.
--skip_pc_emulation Skip installing packages needed for PC emulation When you don't plan to run PC emulation mode and want to save installation time.
--skip_tools Skip downloading and installing GCC and TI code generation tools When the required toolchains are already installed or will be installed separately.
--skip_atf_optee Skip downloading and installing ATF and OPTEE When ATF and OPTEE are already installed or not needed for your development.
--skip_qnx_build Skip QNX build setup steps When not building for QNX+RTOS mode.
--install_tidl_deps Install TIDL dependencies (protobuf, OpenCV, flatbuffers, TVM, etc.) When developing with TIDL (Deep Learning) features in PC emulation mode. This builds additional libraries needed for TIDL PC emulation.
--install_toolchain Install only toolchains, skip Linux, QNX, ATF/OPTEE setups When you only need to install/update the cross-compilation toolchains without other dependencies.

Common Usage Examples

Standard Installation (recommended for first-time setup):

./sdk_builder/scripts/setup_psdk_rtos.sh

Installation without sudo access:

./sdk_builder/scripts/setup_psdk_rtos.sh --skip_sudo

Then manually install the required packages listed in the script with sudo apt install.

QNX SBL development only:

./sdk_builder/scripts/setup_psdk_rtos.sh --qnx_sbl

Firmware-only build (for Yocto or custom Linux):

./sdk_builder/scripts/setup_psdk_rtos.sh --firmware_only

Skip PC emulation to save space:

./sdk_builder/scripts/setup_psdk_rtos.sh --skip_pc_emulation

Install TIDL dependencies for deep learning development:

./sdk_builder/scripts/setup_psdk_rtos.sh --install_tidl_deps

Install only toolchains:

./sdk_builder/scripts/setup_psdk_rtos.sh --install_toolchain

Combine multiple flags:

./sdk_builder/scripts/setup_psdk_rtos.sh --skip_pc_emulation --skip_qnx_build
Note
Multiple flags can be combined in a single command to customize the installation precisely for your development environment.