Start

Setting up the Virtual Machine

Installation

1. Download and install VirtualBox
Version 4.3.20 used in this example.

2. Create Virtual Machine
Select "New"

3. Create a Name
Select OS Type and Version you will be installing:
Linux
Ubuntu (32 bit)

4. Memory Size
1024MB (recommended)

5. Create Virtual Hard Drive

6. VDI (VirtualBox Disk Image)

7. Dynamically Allocated

8. File Location and Size
19.67GB
NOTE: In addition to the OS, the EZSDK plus add-ons take up a fair amount of space.

9. Settings
Storage

  Controller: IDE
    Add CD/DVD Device
      Choose disk
        ubuntu-10.04.4-desktop-1386.iso
          Ok

NOTE: This sets the ISO as the boot image.

10. Start

Install Ubuntu.04.4 LTS.
Follow steps to install (just like any other Linux installation).
Restart VirtualBox Guest instance.
Shutdown.

Guest Additions (Optimize Performance and Usability)

1. Download VirtualBox Guest Additions ISO
Location:

http://download.virtualbox.org/virtualbox/4.3.20/
VirtualBox-4.3.20-96996-Linux_x86.run

NOTE: Make sure you select the version that matches the version of Virtual Box and the OS matches the guest OS.

2. Settings
Storage

        Controller: IDE
          Add CD/DVD Device
            Choose disk
              VBoxGuestAdditions_4.3.20.iso
                Ok

NOTE: This mounts the ISO as a CD

3. Start
Open a terminal

  cd /media/VBoxGuestAdditions_4.3.20
  sudo ./VirtualBox-4.3.20-96996-Linux_x86.run 
  Shutdown

4. Creating a Share Folder
Create folder on host to be used as your share folder between host and guest (ie VirtualShare)

  Settings
    Shared Folders
      Folder Path
        Browse to share folder location on Host machine
          Select Auto-Mount

5. Set of Copy and Paste Between Host and Guest
General

    Advanced
      Shared Clipboard: Bidirectional
      Drag'nDrop: Bidirectional

NOTE: Share folder is located at /media/sf_VirtualShare (depends on folder name).

6. Network Setup
Network

  Attached to: Bridge Adapter
    Start

Cross Compiler

1. Download
Location:

2. Install
NOTE: System uses dash shell as /bin/sh despite echo $0 telling me bash.
sudo dpkg-reconfigure -plow dash Install as /bin/sh? ---No

sudo chmod 777 arm-2009q1-203-arm-none-linux-gnueabi.bin ./arm-2009q1-203-arm-none-linux-gnueabi.bin

NOTE: Anything may be chosen, but installed @ '/home/tim/CodeSourcery/Sourcery_G++_Lite/'

EZSDK

1. Download
Location:

http://software-dl.ti.com/dsps/dsps_public_sw/ezsdk/latest/index_FDS.html

2. Install
sudo chmod 777 ezsdk_dm816x-evm_5_05_02_00_setuplinux

 ./ezsdk_dm816x-evm_5_05_02_00_setuplinux

NOTE: Should find your cross compiler automatically but if not, proceed to guide it to the '/<home/tim>/CodeSourcery/Sourcery_G++_Lite/bin' folder

3. Setup Build Path
cd /home/tim/ti-ezsdk_dm816x-evm_5_05_02_00

  sudo ./setup.sh

NOTE: If Ubuntu is used you may need to first run "sudo apt-get update" to update the package lists.

4. Update files
upzip SI-EZSDK zip file.

  cp the content of SI-EZSDK to ti-ezsdk dir.

Please notice that SI-EZSDK will overwrite some files of ti-ezsdk to support the customization of SI-DM816x.
The default targetfs dir generated by ti-ezsdk installation contains too many unnecessary files. Inside SI-EZSDK/filesystem, SI provides a slim version of targetfs (SI-initrd.tar.gz).

5. Build
cd /home/tim/ti-ezsdk_dm816x-evm_5_05_02_00/

  Change EXEC_DIR inside Rules.make to targetfs path (the dir that will be used as rootfs on target board)
  make u-boot-min: will build u-boot image to be used as first stage
  make u-boot: will build u-boot image to be used as second stage
  make test: will build Linux kernel, Linux Modules, Video in&out Demo & Rootfs

Serial Port Communications

The RS-232 serial port is used to communicate with the SI-DM816x module via a host using a serial terminal program.

RS-232 Header Pinout

Pin connections on the IDC2x5 header on the SI-DM816x module are arranged to form a null modem cable, such that a simple ribbon cable may be used to connect to a standard RS-232 9 pin DSub connector. However, many motherboards no longer offer an externally accessible 9 pin DSub connector, but instead may have an IDC2x5 header on the motherboard which should allow for a direct null modem connection to the SI-DM816x using a straight ribbon cable with an IDC2x5 pin socket on each side. Please be aware to properly align polarity with pin 1 as the reference.

Host DSub9 Connection
DSub9 at PC		Signal Name	IDC2x5 at DM816x
	1	DCD <-> GND	1
6		DSR <-> GND		2
	2	RxD <-> TxD	3
7		RTS <-> CTS		4
	3	TxD <-> RxD	5
8		CTS <-> RTS		6
	4	DTR <-> n/c	7
9		RI <-> n/c		8
	5	GND <-> GND	9
n/a		n/c		10

IDC2x5 at PC		Signal Name	IDC2x5 at DM816x
Host IDC2x5 Connection
1		DCD <-> GND	1
	2	DSR <-> GND		2
3		RxD <-> TxD	3
	4	RTS <-> CTS		4
5		TxD <-> RxD	5
	6	CTS <-> RTS		6
7		DTR <-> n/c	7
	8	RI <-> n/c		8
9		GND <-> GND	9
	10	n/c		10

RS-232 Configuration

The RS-232 port is configured as follows:

Baud Rate: 115200 kbits/sec
Parity: none
Data bits: 8
Stop bits: 1

Serial Port Terminal Programs Run From Host

Hyperterminal is available for hosts running Win XP and earlier. However, Hyperterminal has been removed from Win 7 and later and therefore other serial port terminal programs may be used; SI recommends Tera Term. Meanwhile, hosts running Linux can use Minicom.

User Guide

TI DM816x User Guide: http://processors.wiki.ti.com/index.php/DM816x_AM389x_PSP_User_Guide
TI DM816x U-Boot: http://processors.wiki.ti.com/index.php/DM816x_AM389x_PSP_U-Boot

Video In & Out Demos

The program saLoopBackFbdev is used to test video IO. The source code is in $TI-EZSDK/example-applications/linux-driver-examples-psp04.04.00.01/video/. The executable is in /bin on target filesystem. When Linux is booted on DM board, type ./bin/saLoopBackFbdev on console to run the test.

NOTE: the Video I/O demos only apply to cards populated with composite video circuitry.