Community Linux PSP (Linux 3.3) for DA8x/OMAP-L1/AM1x

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 serial-flasher utility 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. 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 toolchain.
• U-Boot. This U-Boot is based on the version available from the U-Boot GIT tree. The pre-built U-Boot binary included with this release is built with toolchain. U-Boot included in this release will replace the UBL which was being used to copy U-Boot to external RAM in case of da850-sdi board.
• User Boot Loader (UBL). In case of da830 boards, this is the primary boot software which copies U-Boot to external RAM and starts it. This software requires Code Composer Studio (CCStudio) version 5.3.0 for building it.
• Serial Flash writers. This software is used to flash the boot images to SPI/NAND/NOR flash. Latest version of this package can be downloaded from here under host-tools for OMAP-L137 and OMAP-L138. Version 2.40 and Version 2.43 has been used to test OMAP-L138 and OMAP-L137 devices respectively.

You can copy any portions of the PSP that need to be run on a Microsoft Windows host (such as Serial 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
|   |-- ReleaseNotes-#.#.#.#.pdf
|   `-- UserGuide-#.#.#.#.pdf
|-- host-tools
|   |-- OMAP-L138_FlashAndBootUtils_2_40.tar.gz
|   |-- OMAP-L137_FlashAndBootUtils_2_43.tar.gz
|   `-- uflash
|-- images
|   |-- boot-strap
|   |   |-- da830-evm
|   |   |   `--pa_ubl-spi.bin
|   |   |-- da830-wifi
|   |   |   `--pa_ubl-spi.bin
|   |-- kernel
|   |   |-- da830-evm
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |   |-- da830-wifi
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |   `-- da850-sdi
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |   `-- omapl138-lcdk
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |-- u-boot
|   |   |-- da830-evm
|   |   |   `-- u-boot-spi.ais
|   |   |-- da830-wifi
|   |   |   `-- u-boot-spi.ais
|   |   `-- da850-sdi
|   |   |   |-- u-boot-spi.ais
|   |   |   |-- u-boot-nand.ais
|   |   |   |-- u-boot-nor.bin
|   |   |   |-- u-boot-mmcsd.ais
|   |   |   `-- u-boot-mmcsd.bin
|   |   `-- omapl138-lcdk
|   |   |   |-- u-boot-lcdk_ais.bin
|   |-- utils
|   |   |-- da830-evm
|   |   |   `-- DA830_spiWriter.out
|   |   |-- da830-wifi
|   |   |   `-- DA830_spiWriter.out
`-- src
|   |-- boot-strap
|   |   |-- armubl-#.#.#.#.tar.gz
|   |   `-- dspubl-#.#.#.#.tar.gz
|   |-- kernel
|   |   `-- linux-#.#.#.#.tar.gz
|   `-- u-boot
|   |   `-- u-boot-#.#.#.#.tar.gz
|   `-- utils
|   |   `-- spi-flash-writer-#.#.#.#.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 flashing the binaries to SPI/NAND/NOR flash using serial flash writers.

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

• Arago tool chain for ARM
• MONO Framework (Required to use serial flash writers from Linux)
• 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 U-Boot and Linux kernel 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 arago based armv5te toolchain for cross compilation.

Running PSP Components on da850 Spectrum Digital EVM

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 (U-Boot) on the EVM.

Running PSP Components on da830 and da830-WiFi Spectrum Digital EVMs

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 (U-Boot) on the EVM.

Running PSP Components on OMAPL138 LCDK EVM

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 (U-Boot) on the EVM.

Using Linux Kernel Drivers

Linux v3.3 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 PSP Components for OMAP-L1x on v3.x Kernel 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

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.