Community Linux PSP for DA8x/OMAP-L1/AM1x
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.
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
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
- 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.
The additional procedures topic documents some additional useful procedures aside from the usual usage procedures.