Document License

This work is licensed under the Creative Commons Attribution-Share Alike 3.0 United States License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/us/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

PSP Overview

Linux Platform Support Package (PSP) provides support for Linux kernel, U-Boot, UBL and utilities to flash boot software on the EVM. The latest PSP package can be obtained from TI's Technology and Software Publicly Available (TSPA) download site here. This package includes the following components:

Note: Specific version information of each component is included in the PSP Release Notes for the release. PSP drivers features and performance guide provides an overview, features, constraints and performance for each of the drivers included in the PSP release.

DaVinci Linux kernel. This Linux kernel is based on a kernel version available from the DaVinci GIT tree. The pre-built kernel binary included with the PSP package is built with Sourcery G++ Lite 2009q1-203 for ARM GNU/Linux from CodeSourcery.
U-Boot. This U-Boot is based on an U-Boot version available from the U-Boot GIT tree. The pre-built U-Boot binary included with this release is built with Sourcery G++ Lite 2009q1-203 for ARM GNU/Linux from CodeSourcery
User Boot Loader (UBL). This is the primary boot software which copies U-Boot to external RAM and starts it. This software requires Code Composer Studio (CCStudio) version 3.3 or 4.1 (CCStudiov4) for building it.
Flash writers. This software requires Code Composer Studio (CCStudio) version 3.3 or 4.1 (CCStudiov4) for building.

You can copy any portions of the PSP that need to be run on a Microsoft Windows host (such as CCStudio projects for building the UBL and flash writers) to a Microsoft Windows host. Alternately, you can install the PSP package in a disk partition that can be accessed both from a Microsoft Windows and Linux host.

Most of the components of the PSP need to be untar-ed or extracted in order to be used. The following files and directories are provided in the PSP:

----DaVinci-PSP-SDK-#.#.#.#
|-- Software-manifest.html
|-- docs
|   |-- FeaturesPerformanceGuide-#.#.#.#.pdf
|   |-- GPLv2.pdf
|   |-- ReleaseNotes-#.#.#.#.pdf
|   `-- UserGuide-#.#.#.#.pdf
|-- host-tools
|   |-- linux
|   |-- src
|   `-- windows
|-- images
|   |-- boot-strap
|   |   |-- am17xx
|   |   |   |-- arm-nand-ais.bin
|   |   |   |-- arm-spi-ais.bin
|   |   |-- omapl1x7
|   |   |   |-- ubl-nand.bin
|   |   |   |-- ubl-spi.bin
|   |   |   |-- dsp-nand-ais.bin
|   |   |   `-- dsp-spi-ais.bin
|   |   |-- omapl1x8
|   |   |   |-- arm-mmcsd-ais.bin
|   |   |   |-- arm-nand-ais.bin
|   |   |   |-- arm-nor-ais.bin
|   |   |   `-- arm-spi-ais.bin
|   |-- examples
|   |   |-- edma_test.ko
|   |   |-- gpio_test.ko
|   |   |-- vpif_test_display
|   |   |-- vpif_test_mmap_loopback
|   |   `-- vpif_test_userptr_loopback
|   |-- kernel
|   |   |-- omapl1x7
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |   |-- omapl1x8
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |-- u-boot
|   |   |-- omapl1x7
|   |   |   `-- u-boot.bin
|   |   |-- omapl1x8
|   |   |   `-- u-boot.bin
|   `-- utils
|   |   |-- omapl1x7
|   |   |   |-- nand_writer.out
|   |   |   `-- spiflash_writer.out
|   |   |-- omapl1x8
|   |   |   |-- nand-writer.out
|   |   |   |-- norflash-writer.out
|   |   |   |-- spiflash-writer.out
|   |   |   `-- uflash
|-- scripts
|-- src
|   |-- boot-strap
|   |   |-- armubl-#.#.#.#.tar.gz
|   |   `-- dspubl-#.#.#.#.tar.gz
|   |-- examples
|   |   `-- examples.tar.gz
|   |-- kernel
|   |   |-- ChangeLog-#.#.#.#
|   |   |-- ShortLog
|   |   |-- Unified-patch-#.#.#.#.gz
|   |   |-- diffstat-#.#.#.#
|   |   |-- kernel-patches-#.#.#.#.tar.gz
|   |   `-- linux-#.#.#.#.tar.gz
|   |-- u-boot
|   |   |-- ChangeLog-#.#.#.#
|   |   |-- ShortLog
|   |   |-- Unified-patch-#.#.#.#.gz
|   |   |-- diffstat-#.#.#.#
|   |   |-- u-boot-#.#.#.#.tar.gz
|   |   `-- u-boot-patches-#.#.#.#.tar.gz
|   `-- utils
|       |-- mmcsd-writer-#.#.#.#.tar.gz
|       |-- nand-writer-#.#.#.#.tar.gz
|       |-- norflash-writer-#.#.#.#.tar.gz
|       `-- spiflash-writer-#.#.#.#.tar.gz
`-- test-suite
    `-- REL_LFTB_#.#.#.#.tar.gz

Host platform Requirements

Building and running all of the PSP components requires both a Windows and a Linux machine.

The Windows machine is required for running CCStudio 3.3 or 4.1. CCStudio is required for building the User Boot Loader (UBL) and Flash writers. CCStudio is also used to burn the boot images (UBL, U-Boot) into the flash using the flash writers provided in the PSP package.

Linux host is required:

for compiling U-Boot and Linux kernel.
to host the TFTP server required for downloading kernel and file system images from U-Boot using Ethernet.
to host the NFS server to boot the EVM with NFS as root filesystem

Host Software Requirements

CCstudio 3.3.38 or 4.1.0.02003 (needed only to rebuild UBL/flash writers or to re-flash UBL/U-Boot image on the EVM)
TI Code Generation Tools 4.5.1 and above for TMS470Rx (needed only to rebuild UBL/flash writers)
CodeSourcery tool chain for ARM
Serial console terminal application
TFTP and NFS servers.

Getting Started Quickly

Get started with setting up the EVMs for OMAP-L138, DA850 or AM18x or OMAP-L137, DA830 or AM17x.

To help you get started quickly, pre-built binaries for the UBL, U-Boot, Linux kernel, and flash writers are provided in the images directory under PSP installation.

In order to create your own applications running on Linux or to rebuild U-Boot or the Linux kernel provided with the PSP package, you will need to install the CodeSourcery tools for cross compilation.

Running PSP Components

Booting U-Boot provides information on setting up the EVM to boot U-Boot from various boot media.
Booting the Linux kernel provides information on booting Linux on the EVM.
Re-flashing boot images provides information on re-flashing the boot software (UBL, U-Boot) on the EVM.

Using Linux Kernel Drivers

Linux drivers usage has specific usage information on various Linux drivers and features.

Loading Linux kernel modules provides information on how to use various kernel features and drivers as loadable kernel modules.

Building PSP Components

Building Software Components for OMAP-L1 provides procedures for rebuilding the following software components used on the OMAP-L1 processors or to flash software to the board.

Linux kernel
U-Boot
DSP User Boot Loader (For OMAP-L137 (or DA830) only)
ARM User Boot Loader
SPI Flash writer
NAND Flash writer
NOR Flash writer (For OMAP-L138 (or DA850, AM18xx) only)

Configuring Linux Kernel provides information on how to reconfigure the Linux kernel to include and exclude various drivers and kernel features.

Additional topics

The additional procedures topic documents some additional useful procedures aside from the usual usage procedures.

For technical support on OMAP please post your questions on The OMAP Forum. Please post only comments about the article Community Linux PSP for DA8x/OMAP-L1/AM1x here.