Community Linux PSP for DA8x/OMAP-L1/AM1x

From Texas Instruments Wiki
Jump to: navigation, search

TIBanner.png

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.

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.

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.