Sitara Linux Training: Linux Host Configuration

Host OS Install

1. Download the Ubuntu 14.04 LTS ISO image from http://releases.ubuntu.com/14.04/ and burn a CD

   NOTE
   
   If you install 64-bit Ubuntu you will need to update the OS through the Update Manager. Once this is complete download ia32-libs via apt-get.

2. Using the media from above install Ubuntu 14.04 LTS to either a PC or a VMWare Virtual Machine
   • You should be able to take all of the default options
   • In the Sitara Linux training material the user is set to "sitara" with a password of "sitara". This is not required for your image but you should adjust the steps in the training labs accordingly.

   NOTE
   
   If you are using VMware, it is not necessary to burn a CD, you can install directly from the downloaded ISO image

Additional Host Packages to Install

1. Select Dash Home and type in Terminal. Select it to open, then right click the button on the Launcher and select Lock to Launcher
2. Install the following software to the Linux host to add additional functionality for development and training. You can use either the graphical software manager or sudo apt-get install <package> to install the packages listed.
   • git-core
   • gitk
   • vim
   • uboot-mkimage
   • libqt3-mt-dev (for kernel xconfig support)
     • If apt-get tells you the package cannot be located download the following packages instead: libqt4-dev pkg-config
   • libglib2.0-dev (for compiling some apps)
   • corkscrew (used for git proxy if needed)
   • ia32-libs (if using 64-bit Ubuntu)
     • If you are unable to install this package install the following packages: lib32z1 lib32ncurses5 lib32bz2-1.0

IMPORTANT

You may need to setup your network proxy and reload the package list to install the above packages

NOTE

Some packages will be installed later as part of the SDK lab configuration.

Installing Training Software

1. Download the latest SDK installer from http://www.ti.com/tool/linuxezsdk-sitara to your home directory (i.e. /home/sitara)

   

2. Download the CCS installer tarball from the SDK download page and save to the same directory as the SDK installer

   NOTE
   
   You will need to fill out an export control form to gain access to the CCS download

   

3. Extract the CCS tarball into the same directory as the SDK installer. This will allow the SDK installer to install CCS for you at the same time.
   • cd /home/sitara
   • tar xzf <CCS tarball>
4. Make the SDK installer executable
   • chmod +x <SDK installer>
5. Run the SDK installer and install to the default path
   • Take all the defaults including the default to install CCS
   • In the CCS installer take all defaults.

   IMPORTANT
   
   If you are going to be using an emulator do NOT install the JTAG support when prompted by CCS. We will re-run the installer in the next step with sudo permissions to install the drivers

6. Re-Run the CCS installer as sudo to add emulator support
   • cd /home/sitara/CCS
   • sudo ./ccs_setup_5.3.0.00090.bin
     • When prompted to select an install location point to your previous installation at /home/sitara/ti
     • You will be warned that a CCS installation exists. Click next to modify the existing installation
     • Click next until you get to the Select Emulators screen. Select the XDS100 Class Emulator Support option

       NOTE
       
       If you are using a different emulator go ahead and select that emulator here

     • Continue to click Next until the installation finishes.
7. Download Qt Creator qt-opensource-linux-x64-5.7.0.run from http://download.qt.io/official_releases/qt/5.7/5.7.0/] to your home directory
   • Make the downloaded file executable chmod + <nameOfFile>
   • Launch the installer ./<nameOfFile>
8. Run the Qt Creator installer and accept all the defaults

Optional - Clone Board Port Trees

This is listed as optional because the board port trees are included in the SDK under /home/sitara/ti-sdk-am335x-evm-06.00.00.00/board-support/board-port-labs/. The board port trees found in the gitorious project are slightly newer than the ones included in SDK 6.0 so it may be beneficial to download them.

1. A repository has been created to contain various helper files for the different labs. This repository should be cloned to the home directory.

   IMPORTANT
   
   You may need to export a GIT_PROXY_COMMAND if you are using git behind a firewall. See you network administrator if you need help setting your proxy.

   • cd /home/sitara
   • git clone git://gitorious.org/sitara-training/sitara-training-helper-files.git
2. Clone the Sitara Linux Board Port repositories into a directory called board-port
   • cd /home/sitara
   • mkdir board-port
   • cd board-port
   • git clone git://gitorious.org/sitara-board-port/sitara-board-port-linux.git
   • git clone git://gitorious.org/sitara-board-port/sitara-board-port-uboot.git

Configuring SDK for Labs

The following steps were performed when preparing the Linux host for the Sitara Linux training labs. This was done to allow slow operations to be run prior to the lab exercises.

1. Run the setup.sh script in the SDK installation and configure the system for NFS and TFTP boot.
   • This extracts and sets up the root file system as well as the TFTP and NFS servers

   NOTE
   
   When asked if you want to create a minicom script with the above parameters say No

2. Compile the sitara-board-port-linux sources to help bypass the build time
   • cd /home/sitara/board-port/sitara-board-port-linux
   • git checkout board-port-<sdk version>
   • make ARCH=arm CROSS_COMPILE=/home/sitara/<sdk install dir>/linux-devkit/sysroots/i686-arago-linux/usr/bin/arm-linux-gnueabihf- tisdk_am335x-evm_defconfig
   • make ARCH=arm CROSS_COMPILE=/home/sitara/<sdk install dir>/linux-devkit/sysroots/i686-arago-linux/usr/bin/arm-linux-gnueabihf- uImage
   • make ARCH=arm CROSS_COMPILE=/home/sitara/<sdk install dir>/linux-devkit/sysroots/i686-arago-linux/usr/bin/arm-linux-gnueabihf- modules
3. Compile the sitara-board-port-uboot sources to help bypass the build time
   • cd /home/sitara/board-port/sitara-board-port-uboot
   • git checkout board-port-<sdk version>
   • make ARCH=arm CROSS_COMPILE=/home/sitara/<sdk install dir>/linux-devkit/sysroots/i686-arago-linux/usr/bin/arm-linux-gnueabihf- am335x_evm_config
   • make ARCH=arm CROSS_COMPILE=/home/sitara/<sdk install dir>/linux-devkit/sysroots/i686-arago-linux/usr/bin/arm-linux-gnueabihf-
4. Copy the Sitara board port Linux kernel image and u-boot images to the TFTP directory to be available for the boot time optimization lab
   • cp /home/sitara/board-port/sitara-board-port-linux/arch/arm/boot/uImage /tftpboot/uImage-board-port
   • cp /home/sitara/board-port/sitara-board-port-uboot/MLO /tftpboot/MLO-board-port
   • cp /home/sitara/board-port/sitara-board-port-uboot/u-boot.img /tftpboot/u-boot-board-port

Archived versions

• [SDK 05.00.00.05]