Getting Started Guide for OMAP-L1

From Texas Instruments Wiki
Jump to: navigation, search

This Getting Started Guide (GSG) walks you through setting up the OMAP-L137 and OMAP-L138 EVM and installing the software. You should proceed through this guide in the order given for best results. By the end of this Getting Started Guide you will have the EVM booting to Linux and the Linux host development environment configured. You should also bookmark the OMAPL1 category since new articles will continue to appear on this wiki.

ATTENTION OMAP-L138 DEVELOPERS: The Generally Available (GA) Linux DVSDK 4.x for the OMAP-L138 device is now available here. There are various capabilities and improvements that have been added to this version. This is the recommended release kit for development which supersedes the SDK 1.00.xx Beta. The majority of the information below is only applicable to the SDK 1.00.xx Beta.

EVM overview

EVM Overview - OMAP-L138 provides an overview of the OMAP-L138 EVM kits and boards.

EVM Overview - OMAP-L137 provides an overview of the OMAP-L137 EVM kits and boards.

Hardware setup

For information on setting up the OMAP-L138 EVM hardware, please follow the steps in the ZOOM OMAP-L138 eXperimenter Kit QuickStart Guide, which is available for downloading at http://support.logicpd.com/downloads/1213/.

Spectrum Digital, Inc has a Technical Reference Guide for OMAP-L137 EVM.

Booting the EVM out of the box

This section describes how to boot the EVM board when you first set it up.

  • For OMAP-L138 (or DA850) details are provided here
  • For OMAP-L137 (or DA830) details are provided here

Installing the SDK software

OMAP-L138 DEVELOPERS - See attention note at the top of the page.

Installing the Software for OMAP-L1 covers how to install the SDK software and CodeSourcery Sourcery G++ tools for the OMAP-L1 processors.

As host platforms for the development software, you need both a Windows PC and a Linux machine to build and run all of the components.

  • The Windows machine is used to run CCStudio 3.3/CCStudio 4, which you will use if you want to build 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.
  • The Linux host is used for the following:
    • Recompiling U-Boot and the Linux kernel.
    • Hosting the TFTP server required for downloading kernel and file system images from U-Boot using Ethernet.
    • Hosting the NFS server to boot the EVM with NFS as root filesystem
    • Running a serial console terminal application


The Installing the Software for OMAP-L137 page covers how to install the MontaVista tools, SDK software, and Linux Support Pack for the OMAP-L137 processor.

Note: If you are migrating from the early adopter version of the SDK software you can check the differences in this document.

Setting up target file system

OMAP-L138 DEVELOPERS - See attention note at the top of the page.

Setting up OMAP-L1 Target File System explains how to set up an NFS target file system for use on the OMAP-L1 EVMs.

For information on setting up an NFS target file system for use on the OMAP-L137 EVM please see the Setting up OMAP-L137 Target File System page.

For information on creating other types of target file systems such as SD/MMC and USB please see the Creating file systems on removable media page.

Building software components

Building PSP components provides procedures for rebuilding the platform software components used on the processors or to flash software on to the EVM.

Building the SDK

OMAP-L138 DEVELOPERS - See attention note at the top of the page.

Building the OMAP-L1 SDK provides information on building the SDK software for both OMAP-L137 and OMAP-L138.

Note: In general, the instructions for building the SDK for OMAP-L138 are the same as for OMAP-L137. Follow the steps on this page that are specific to your device.

The SDK software provided with this EVM contains examples for communicating between the ARM and DSP processors as well as driver modules used in that communication. It also contains development packages, such as Codec Engine, which allow for easy communication between the ARM and DSP.

Running PSP Components

Running PSP Components describes the steps to boot Linux and to how to re-flash UBL and U-boot images if needed.

Additional procedures

OMAP-L138 DEVELOPERS - See attention note at the top of the page.

Linux Functional Test Bench introduces a set of tools used to verify the various driver features.
Loading Linux kernel modules describes the procedure to load kernel modules into a running kernel.
Message logging on UART in UBL describes the procedure to enable message logging in ARM UBL.
Modifying SPI Frequency in U-Boot describes how to modify the SPI frequency in U-Boot.
Restoring factory default U-Boot environment variables describes how to revert to factory default U-Boot environment variables.
Using extended memory available on DA850/OMAP-L138/AM18x EVM describes how Linux can be configured to utilize the additional RAM available on the EVM board when compared to the eXperimenter board.
Creating bootable SD card for DA850/OMAP-L138/AM18x EVM describes the steps to write U-Boot to SD card using uflash utility.
Creating custom boot images for OMAP-L138 describes how to create your own bootable images from scratch and flash them to run on the ARM or DSP.

For OMAP-L138 and DA850 SoCs, DSP wakeup in U-Boot explains how to prevent the DSP from being woken up by U-Boot.

For DA850/OMAP-L138/AM18x EVMs, Restoring MAC address on SPI Flash explains the steps to Restore MAC address on SPI flash.

For OMAP-L137 and DA830 SoCs, enabling Write-Back cache explains how to enable write-back cache support in Linux kernel when using silicon revision 2.0 and higher.

The following pages provide additional procedures that apply to a variety of platforms, including the OMAP-L1:

Enabling UART1 on AM18X/DA850/OMAP-L138 running Linux describes steps to enable and verify the UART1/ttyS1 on AM18x/DA850/OAMP-L138 EVMs running linux.
LCD brightness control on da850/omap-l138 describes steps to enable and modify LCD backlight brightness.

Additional information