Download, Install and Setup SDK and Tools

Note

The steps on this page need to be done once on a given host machine

Host PC Requirements

To build applications using this SDK, one needs below host PC machine

  • Windows PC

    • Windows 10 64bit

    • Minimum 4GB, >8GB RAM recommended

    • At least 10GB of hard disk space

  • Linux PC

    • Ubuntu 22.04 64bit or higher

    • Minimum 4GB, >8GB RAM recommended

    • At least 10GB of hard disk space

Download and Install the SDK

  • Download the SDK installer and install at below path on your PC

    • Windows, C:/ti

    • Linux, ${HOME}/ti

  • ${SDK_INSTALL_PATH} in this user guide refers to the path, including the SDK folder name, where the SDK is installed. Example, in Windows, ${SDK_INSTALL_PATH} will refer to the path C:/ti/mcu_plus_sdk_{soc}_{version}

  • You can also browse, download and install the SDK using TIREX as shown here, Using SDK with TI Resource Explorer.

Download and Install Additional SDK Tools

SysConfig

GCC AARCH64 Compiler

Attention

GCC AARCH64 compiler installation is required for HSM appimage generation and Linux appimage generation in am62px

C7000-CGT Compiler Toolchain

Python3

Attention

It is important to install Python 3.x. If you have Python 2.x installed, then additionally install Python 3.x and make sure the command python or python3 indeed points to Python 3.x

Attention

All commands mentioned below should be typed in cmd.exe command console in Windows and bash terminal in Linux.

  • Python scripts are used for below functionality in the SDK,

    • Flashing files to the flash on the EVM via UART.

    • Booting application on the EVM via UART

  • Flashing files is the most popular reason why you would need python, so its strongly recommended to install it.

  • In Windows,

    • Install python from, https://www.python.org/downloads/windows/

    • Confirm python is installed by typing below in a command prompt, make sure you see 3.x as the version

      C:\> python --version
Python 3.9.1

    • If above command fails, then add path to Python to your environment “Path” variable, by default python is installed at below path

      C:\Users\{your username}\AppData\Local\Programs\Python\Python39

    • To add a new path to your environment variables, goto “Windows Task Bar Search” and search for “environment variables for your account”

      Environment Variables For Your Account

    • Click on “Path” variables, click on “Edit”, click on “New”

    • Add the path to the folder where python in installed.

    • It is strongly recommended to move the path “up” in your path list by clicking the “Move Up” button until the path is at the top of the list.

    • Click “OK” to save the settings

    • Close your Windows command prompt and reopen it and then check if python is visible by doing below

      C:\> python --version
Python 3.9.1

    • Check if the python package manager “pip” is installed, by default pip should be installed along with python.

      C:\> python -m pip --version
pip 21.0.1 from C:\Users\{your username}\AppData\Local\Programs\Python\Python39\lib\site-packages\pip (python 3.9)

    • Install below additional packages via “pip” that are needed for the flashing tools. If you are behind a corporate firewall make sure to pass the server name and port for the proxy as shown below. If proxy is not needed keep --proxy= as blank.

      C:\> python -m pip install pyserial xmodem tqdm pyelftools construct --proxy={your proxy server web-link and port}

  • In Linux,

    • Do below in Linux bash shell to install python3

      $ sudo apt install python3 python3-pip

    • Check the python version by doing below

      $ python3 --version

    • Check if the python package manager “pip” is installed, by default pip should be installed along with python.

      $ pip3 --version

    • Install below additional packages via “pip” that are needed for the flashing tools. If you are behind a corporate firewall make sure to pass the server name and port for the proxy as shown below. If proxy is not needed keep --proxy= as blank.

      $ pip3 install pyserial xmodem tqdm pyelftools construct --proxy={your proxy server web-link and port}

OpenSSL

  • OpenSSL is needed for signing the bootloader images when booting using a bootloader.

  • Download and install OpenSSL as below,

    • In windows,

      • Download v1.1.1 and higher from https://slproweb.com/products/Win32OpenSSL.html

      • You can install the “light” version which is smaller download size

      • Install to default path, which is C:/Program Files/OpenSSL-Win64/

      • When prompted select option to install binaries to /bin folder of installed path instead of Windows system path.

      • Add path to OpenSSL, to your environment “Path” variable in windows

          C:/Program Files/OpenSSL-Win64/bin

      • In windows, there are multiple other options to install openssl as well, refer to this page if you want to install other versions of openssl, https://wiki.openssl.org/index.php/Binaries

    • In Linux,

      • Do below in Linux Ubuntu shell to install openssl

          $ sudo apt install openssl

  • Test “openssl” by doing below on a command prompt and make sure there is no error. Example output on Windows is shown below,

      C:\> openssl version
  OpenSSL 1.1.1k  25 Mar 2021

Mono Runtime

Attention

You MUST install mono runtime only if you’re on Linux

  • Mono runtime is required in Linux for creating bootloader images for application binaries.

  • If you haven’t installed mono, you are likely to run into this error while building:

      /bin/sh: 1: mono: not found

  • Do below in Linux Ubuntu shell to install mono

      $ sudo apt install mono-runtime

Code Composer Studio (CCS)

To download, install and setup CCS, follow instructions on this page, Download, Install and Setup CCS .

TI CLANG Compiler Toolchain

Device Tree Compiler

Attention

You MUST install device tree compiler only if you’re on Linux.

  • Device Tree Compiler is required for ATF (Arm Trusted Firmware) to build.

  • If you haven’t installed device tree compiler, you are likely to run into this error while building ATF:

      ../../make helpers/toolchain.sk: 344: The configured host device tree compiler could not be identified and may not be supported:

  • Do below in Linux Ubuntu shell to install device tree compiler (DTC).

      $ sudo apt install device-tree-compiler