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 18.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/SYSCONFIG
Download SysConfig 1.20.0 and Install at below path,
- Windows, C:/ti
- Linux, ${HOME}/ti

GCC AARCH64 Compiler

Attention: GCC AARCH64 compiler installation is required only for A53 development in am64x

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

GCC ARM (R5) Compiler

Attention: GCC ARM compiler installation is required only for R5 GCC build

Download GCC ARM compiler 7-2017-q4-major from the below link
- Windows WINDOWS GCC ARM CROSS COMPILER
- Linux LINUX GCC ARM 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
- SYSFW boardcfg formatting and C header file generation for SYSFW
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 and application images when booting using a bootloader.
Current signing scripts of SDK support both v1.1.1 and v3 of OpenSSL.
With am263x, am263px, am273x OpenSSL v3 is recommended as v1.1.1 has reached END OF LIFE.
Download and install OpenSSL as below,
- In windows,
  - Download OpenSSL v1.1.1 or v3 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,
  - So if you have Ubuntu 22.04, do below in Linux Ubuntu shell to install openssl
```
 $ sudo apt install openssl
```
  - Make sure that you install the v1.1.1 or v3 of OpenSSL. You can get the v1.1.1 or v3 packages from http://security.ubuntu.com/ubuntu/pool/main/o/openssl/. The packages required are openssl, libssl and libssl-dev

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

OR

~/workarea/mcu_plus_sdk$ openssl version
OpenSSL 3.0.2 15 Mar 2022 (Library: OpenSSL 3.0.2 15 Mar 2022)

dfu-util

Note: USB2.0 DFU driver and application is tested with dfu-util verson dfu-util 0.11-dev and dfu-util 0.8-dev. It is recomended to use that same version as mentioned.

Windows

Download the dfu-util to your local system
Rename it to dfu-util.exe
Add the path to dfu-util.exe to the system environment variable path.
check dfu-util version
```
      $ dfu-util --version
```

dfu-util version

Steps to install windows generic USB drivers.

On windows we have to make sure that correct generic USB drivers are installed. We will use Zadig tool to install dependent USB libraries.
Click here to Install zadig.
- Connect EVM USB to PC and put the SOC in DFU boot mode. refer EVM Setup. Select WinUSB as shown in the figure below.

Step 1 select AM64x DFU from the list of devices.

Select 1.options 2. list all device. Find and select device named AM64x DFU. Click Install WCID Driver.

Step 2 Install drivers for AM64x DFU device.

Use following command to check whether ROM DFU device has been enumerated correctly or not.
```
  $ dfu-util -l
```

Step 2 Install drivers for AM64x DFU device.

Setps to Install drivers for using SBL DFU.

After following above mentioned steps user will be able to perfom ROM DFU Boot. For using SBL DFU Uniflash DFU based flash writter tool follow below mentioned steps.
- Follow the setps mentioned in the above section then use following command to boot the SBL DFU Uniflash flash writter.
```
  $ dfu-util -a 0 -i 0 -t 64 -D <path_to_sbl_dfu_uniflash.release.tiimage>
```
- Once booted successfully, 1. open zadig tool 2. select options. 3. select list all devices. Select USB device named AM64x-AM243x DFU. Now select Install WCID Driver to install.

Install drivers for AM64x-AM243x DFU device.

Once the Drivers are installed successfully, user should be able to use the USB DFU Uniflash tool to flash the application images.

Linux

Download the dfu-util or use the package manager of your distribution to get the latest version.
```
      $ sudo apt install dfu-util
```
check dfu-util version
```
      $ dfu-util --version
```

PRU-CGT

Attention: You MUST install PRU-CGT if trying to build PRU firmware.

: PRU-CGT-2-3 (ti-pru-cgt) should be installed at: C:/ti/ when working with PRU firmware development.

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 .

Download and Install Additional SDK Tools

TI CLANG Compiler Toolchain

Attention: TI CLANG Compiler Toolchain is part of CCS, however if user wants to build example using makefile and CCS is not installed then this MUST be installed separately

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

Table of Contents

Host PC Requirements

Download and Install the SDK

Download and Install Additional SDK Tools

SysConfig

GCC AARCH64 Compiler

GCC ARM (R5) Compiler

Python3

OpenSSL

dfu-util

Windows

Steps to install windows generic USB drivers.

Setps to Install drivers for using SBL DFU.

Linux

PRU-CGT

Mono Runtime

Code Composer Studio (CCS)

Download and Install Additional SDK Tools

TI CLANG Compiler Toolchain