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

The SysConfig download home page is, https://www.ti.com/tool/download/SYSCONFIG/1.20.0.3426
Download SysConfig 1.20.0 from below direct links,
- Windows, WINDOWS INSTALLER
- Linux, LINUX INSTALLER
Install at below path,
- Windows, C:/ti
- Linux, ${HOME}/ti

GCC AARCH64 Compiler

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

Download GCC AARCH64 compiler 9.2-2019.12 from the below link
- Windows WINDOWS GCC AARCH64 CROSS COMPILER
- Linux LINUX GCC AARCH64 CROSS COMPILER
Extract to below path,
- Windows, C:/ti
- Linux, ${HOME}/ti

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; 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 --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 --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

Download TI CLANG compiler toolchain 3.2.2.LTS from below link
- Windows, WINDOWS INSTALLER
- Linux, LINUX INSTALLER
Install at below path,
- Windows, C:/ti
- Linux, ${HOME}/ti

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
```

Table of Contents