Community Linux PSP for DaVinci devices

Content is no longer maintained and is being kept for reference only!

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. 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 5.0 for building it.
• Flash writers. This software requires Code Composer Studio (CCStudio) version 5.0 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
|   |   |-- ccs
|   |   |   |-- dm36x
|   |   |   |   |-- NANDWriter_DM36x.out
|   |   |   |   `-- NANDEraser_DM36x.out
|   |   |   `-- omapl1x8
|   |   |   |   |-- NANDWriter_ARM.out
|   |   |   |   |-- NORWriter_ARM.out
|   |   |   |   `-- SPIWriter_OMAP-L138.out
|   |   `-- serial_flash
|   |   |   |-- dm36x
|   |   |   |   |-- sfh_DM36x.exe
|   |   |   |   |-- ubl_DM36x_NAND.bin
|   |   |   |   `-- ubl_DM36x_SDMMC.bin
|   |   |   `-- omapl1x8
|   |   |   |   |-- sfh_OMAP-L138.exe
|   |   |   |   |-- ubl_OMAPL138_NAND.bin
|   |   |   |   |-- ubl_OMAPL138_NOR.bin
|   |   |   |   |-- ubl_OMAPL138_SDMMC.bin
|   |   |   |   `-- ubl_OMAPL138_SPI_MEM.bin
|   |-- examples
|   |   |-- dm36x
|   |   |   |-- edma
|   |   |   |   `-- edma_test.ko
|   |   |   |-- fbdev
|   |   |   |   |-- blend
|   |   |   |   |-- fbdev_display_bands
|   |   |   |   `-- fbdev_display_rgb
|   |   |   `-- mc
|   |   |   |   |-- display_lcd
|   |   |   |   |-- mc_enumerate
|   |   |   |   |-- mt9p031_ccdc_aew
|   |   |   |   |-- mt9p031_ccdc_af
|   |   |   |   |-- mt9p031_ccdc_file
|   |   |   |   |-- mt9p031_ccdc_prv_file
|   |   |   |   |-- mt9p031_ccdc_prv_rsz_file
|   |   |   |   |-- mt9p031_ccdc_prv_rsz_loopback
|   |   |   |   |-- mt9p031_ccdc_prv_rsz_loopback_mmap
|   |   |   |   |-- previewer_resizer_ss
|   |   |   |   |-- previewer_ss
|   |   |   |   |-- resizer_ss
|   |   |   |   |-- tvp514x_ccdc_crop_loopback
|   |   |   |   |-- tvp514x_ccdc_file
|   |   |   |   |-- tvp514x_ccdc_loopback
|   |   |   |   |-- tvp514x_ccdc_loopback_mmap
|   |   |   |   |-- tvp514x_ccdc_prv_file
|   |   |   |   |-- tvp514x_ccdc_prv_rsz_file
|   |   |   |   |-- tvp7002_ccdc_file
|   |   |   |   |-- tvp7002_ccdc_loopback
|   |   |   |   |-- tvp7002_ccdc_loopback_mmap
|   |   |   |   |-- tvp7002_ccdc_prv_file
|   |   |   |   |-- tvp7002_ccdc_prv_rsz_file
|   |   |   |   |-- v4l2_colors
|   |   |   |   |-- v4l2_colors_hd
|   |   |   |   `-- v4l2_display
|   |   `-- omapl1x8
|   |   |   |-- edma
|   |   |   |   `-- edma_test.ko
|   |   |   |-- vpif
|   |   |   |   |-- vpif_mmap_loopback
|   |   |   |   |-- vpif_userptr_loopback_cmem
|   |   |   |   |-- vpif_display
|   |   |   |   |-- vpif_userptr_loopback_sd
|   |   |   |   `-- vpif_mmap_loopback_sd
|   |   |   |-- gpio
|   |   |   |   `-- gpio_test.ko
|   |   |   `-- mcbsp
|   |   |   |   `-- mcbsp_test.ko
|   |-- kernel
|   |   |-- dm36x
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |   |-- omapl1x8
|   |   |   |-- modules\
|   |   |   `-- uImage
|   |-- u-boot
|   |   |-- dm36x
|   |   |   `-- u-boot.bin
|   |   |-- omapl1x8
|   |   |   `-- u-boot.bin
|   `-- utils
|   |   |-- dm36x
|   |   `-- omapl1x8
|-- scripts
`-- src
    |-- boot-strap
    |   `-- flash-utils-#.#.#.#.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

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 5.0. 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 UBL, Serial flash writers, 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 5.0 (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
• MONO Framework
• 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 DM36x.

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 on OMAP-L138

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.

Running PSP Components on DM36x

Booting DM36x Out of the Box provides information on setting up the EVM to boot U-Boot and Linux from various boot media.
Re-flashing boot images provides information on re-flashing the boot software (UBL, U-Boot) on the EVM.

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
• ARM User Boot Loader
• SPI Flash writer
• NAND Flash writer
• NOR Flash writer for OMAP-L138

Building Software Components for DaVinci devices provides procedures for rebuilding the following software components used on the DaVinci processors or to flash software to the board.

• Linux kernel
• U-Boot
• User Boot Loader for DM36x
• NAND Flash writer for DM36x

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.