NOTICE: The Processors Wiki will End-of-Life in December of 2020. It is recommended to download any files or other content you may need that are hosted on The site is now set to read only.

DM814x C6A814x AM387x PSP Release Notes

From Texas Instruments Wiki
Jump to: navigation, search
DM814x C6A814x AM387x PSP Release Notes
Linux PSP

DM816x refers to DM816x/AM389x devices unless specified.
DM814x refers to DM814x/AM387x devices unless specified.
DM81xx refers to both DM816x, DM814x and DM813x.

This document covers details for TI814x release. This release is tested on DM8148EVM (refer Validation Information section for validation details)

TI814x PSP

Release Notes

Release Date:  July 15, 2011

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 or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

Read This First

1) The kernel NAND driver now uses 1-bit h/w ECC and U-Boot is also updated accordingly (release onwards). So it is mandatory to re-flash the latest U-Boot along with kernel and filesystem (if using NAND based kernel and/or filesystem) as provided in this release before proceeding to boot the kernel.

2) The serial console device names in this kernel are changed from ttySx to ttyOx (release onwards). This means you will need to change the boot arguments passed to kernel and the /etc/inittab file in the filesystem accordingly when booting the kernel. Please refer Using The Correct Console Device section in User Guide.

3) You might need to update the DHCP script in your filesystem when using network mounted root filesystem with the kernel from this release. Please refer Updating the DHCP Script section in User Guide.

4) The parameter passed to mkfs.jffs2 while creating JFFS2 image has changed, please refer "Creating JFFS2 File-system" section under "U-Boot NAND Support" in U-Boot User Guide.

5) The steps for flashing jffs2 image to NAND from U-Boot has changed, please refer "Flashing File-system from U-Boot" section under "U-Boot NAND Support" in U-Boot User Guide.

6) HDVPSS binaries are no longer packaged with release tar ball, instead they can be downloaded from the PSP Software Download page


This is Release of TI814x Linux PSP tested on DM8148 EVM. The EVM(Rev B DDR3) consists of base board. In the rest of the document, we will refer this setup as DM8148 EVM.

The Linux PSP serves to provide a fundamental software platform for development, deployment and execution of Linux based applications on Texas Instruments DM8148 EVM. The Linux kernel and U-Boot software in this release are based on the following open source repositories:

Component Version Base Repository Base Tag (or commit id)
TI814x Linux Kernel 2.6.37(Linux kernel version);a=commit;h=2b3ea6aa16956e15f1ba8e7b70898aaacbec2237 2b3ea6aa16956e15f1ba8e7b70898aaacbec2237
U-Boot 2010.06;a=summary v2010.06

The code base for Linux kernel and U-Boot included in this release is hosted at the following repositories:

Component Repository (Branch) Baseline Tag/Commit Release Tag
TI814x Linux Kernel;a=shortlog;h=refs/heads/ti81xx-master (ti81xx-master)
2b3ea6aa16956e15f1ba8e7b70898aaacbec2237 v2.6.37_TI814XPSP_04.01.00.05
TI814x U-Boot;a=summary (ti81xx-master) v2010.06 v2010.06_TI814XPSP_04.01.00.05

For detailed information on the various software components included in the release and how to use them, please refer to the User Guide.

The kernel and U-Boot have been compiled with CodeSourcery GNU Toolchain for ARM Processors 2009-q1-203 based on GCC 4.3.3


Tool/Component Release Version
CGTools 4.9.0
XDC 3_22_01_21
BIOS 6_32_01_38
IPC 1_23_01_26
Syslink 2_00_00_78


The User Guide provides instructions on how to use the PSP Release package. A copy of the User Guide is included in the docs folder of the package.

What's Supported

SDK package includes support for DM8148 EVM platform.

The Linux PSP package supports the following components:

  • U-Boot supporting NAND, SD and SPI, boot modes
  • Linux Kernel and device drivers.
    • Ethernet
    • MUSB host driver supporting Mass Storage Class and HID class on USB0 and USB1.
    • NAND
    • UART
    • I2C
    • SATA
    • EDMA
    • Audio
    • SPI (PIO mode)
    • SD
    • Video Display Driver(FBDev)
    • LCD Support
    • TILER
    • IOMMU
    • Watchdog Timer
    • GPIO
  • Booting DM814x EP set in PCIe boot mode from DM816x Root Complex
  • Pre-built binaries for U-Boot (for SD and NAND boot mode only), Linux kernel.
  • Pre-Built binaries for NAND and SPI flash writers.

What's Not Supported

  • Following are not supported:
    • PCIe Boot from a non-DM816x RC
    • PCIe RC driver
    • NOR Boot
    • Ethernet Boot
    • HDMI Audio
    • TVP5158 Audio
    • ADC3101 Audio
    • RTC
    • The release package does not include a filesystem image
    • Currently U-Boot doesn't handle PCIe Boot procedure. Refer PCI Express Boot Driver User Guide for details about booting DM814x EP from DM816x RC.

Fixed in this Release

This section lists issues fixed in this release:

Issue Identifier
Issue Headline
SDOCM00081445 FBDev: reshuffle any fb nodes to SDVENC failed
SDOCM00078931 VPSS UserGuide: Bootargs metioned in vpss user guide are wrong
SDOCM00080165 VPSS: CURRENT_VPS_FIRMWARE_VERSION is not updated correctly
SDOCM00081718 FBDev: blending, color key does not work without calling FBIOPUT_VSCREENINFO
SDOCM00082301 FBDev: stenciling feature not working - mmap stenciling buffer return MMAP_FAILED
SDOCM00082268 FBDev: FBDev module failed to support 1366x768@60 resolution
SDOCM00082170 VPSS: Missing sysfs entry to configure the polarity of DE(ACT VID), HS, VS and FID
Linux SD driver cannot detect SD card hot insertion
Low performace for MMC/SD reads and writes

Nand partition with bad block could not be mounted. Flash_eraseall return errors.

File system was reported to not mount on a Nand partition having bad blocks.

Kernel crashes if the client driver tries to allocate a channel for the cross bar event.

MMC/SD card's write protect status is not acknowledged if a daughter card is attached to the base board.

The MMC/SD card always mounted in read-only mode if a daughter card was connected to the base-board. So, no write operations could be performed on the card.

U-Boot DMM LISA settings do not match the ones in GEL file
SATA warning/error messages observed when kernel boots even when SATA device is not connected

New in this Release

  • NAND 1-bit h/w ECC support in U-Boot and Kernel (Enabled by default)
  • SD card hot insertion
  • Watchdog Timer
  • GPIO
  • PCIe Booting with 32-bit mode (from DM816x RC only)
  • Clock framework
  • Mux framework
  • Support for LCD on Catalog Daughter Card

Known Issues

This section lists known issues observed in this release:

Issue Identifier
Issue Headline
Known Workaround(s)
Audio: Overrun, underrun errors observed for less period sizes less than 64 frames
 Use period size >64.
Fourth test(try to write off end of device) in mtd_oobtest is failing for read on third mtd partition

This is a limitation in Linux NAND stack. Fourth mtd_oobtest will fail if used in intermediate partitions in a flash device. Hence if mtd4 is used for mtd_oobtest it would succeed.


MMC/SD card's write protect status is not detected.

Write can happen on the SD/MMC card irrespective of whether the write protect switch on the card is on or off.

Known Issue.

The signal MMC1_SD_WP is by default not connected to pin AG4. Instead signal UART0_DSRn is connected.
So I2C2 on the daughter cards will be lost on using Write Protect functionality.

Host does not enumerate devices connected to all the ports of a port multiplier.
Do not use 0th Port of the port multiplier and connect the required devices to the remaining ports of the port multiplier
Kernel build fails if IOMMU Debug-FS is enabled in kernel configuration
Disable iommu debug-fs support during kernel configuration (menuconfig)
CCS based JTAG flashing tool can be used only to flash bootloader
For other images use u-boot or uart boot mode.
HDMI PLL doesn't get locked on some of Centaurus boards. Will be fixed in PG2.0 version of Silicon
Try on a PG2.x EVM.
DM81XX:USB: After four times insmod and rmmod of ti81xx.ko in loop causes crash in dma_alloc_free in cppi41dma driver
Remove all the modules in reverse order and insert all modules in right order again.
DebugFS entries for pinmux show incorrect status for pins
DebugFS is currently not supported for DM81xx pinmux. Please refer user guide for details about changing pinmux settings. While the associated register value read from debugfs should still show correct value (only pullup/pulldown decoding is incorrect).
USB:TI8XX: Removal of flash drive during file i/o will lead to crash observed from filesystem module
unmount (umount) the flash drive before removing the flash drive from usb port. Again when the flash drive is inserted umount default mount path (/media/sda1) and mount again.
DM81XX: Dual musb controller with one controller(usb0) as host and other controller(usb1) as device feature is not supported
This feature currently not supported.
USB:TI8XX: The file i/o to flash drive fails when connected through Full Speed HUB Use high speed hub.
SDOCM00078500 Audio playback cannot start till record is started This issue is seen when running capture and playback simultaneously after boot-up. If either a capture or a playback operation precedes the simultaneous operation then things work fine. This problem is due to the recent changes in the ASoC framework
SDOCM00082699 VPSS: System crashes when re-enabling the display after removing external video encoder After external video encoder is removed, do not disable and re-enable the display via /sys/devices/platform/vpss/display#/enaabled, this leads to system crash, patch is available to fix this.
NAND module support: Second insmod of nand driver (omap2.ko) fails due to improper cleanup during rmmod

The requested memory region was not released in driver cleanup function.

The bug has been fixed. The patch fixing the bug will be pushed to arago.

SD removal while IO is in progress causes system hang
The bug has been fixed. The patch fixing the bug will be pushed to arago.
McSPI loadable module support broken, second time insmod of McSPI driver fails.
None. Requires a system reboot.
Hyperlinks in the PDF documents in the release package are missing
This is a known issue. The PDF rendering tool in processor wiki removes the hyperlinks while generating PDF documents. Please use the online wiki documents mentioned in Useful Links section (at the end of this release notes)

Installation and Usage

Please look for detailed installation and usage instructions in the User Guide

Upgrade and Compatibility Information

To upgrade to new PSP release, simply delete the old release and extract the new release in its place.

Device Support

This release supports the Texas Instruments DM8148 EVM

Validation Information

This release is tested on DM8148 EVM with SDK filesystem (link to be updated).

The setup details are as follows:

  • PG2.x DM8148 based EVM with with ARM running at 600 MHz and DDR3 at 400MHz clock, having RGMII for Ethernet ports. This setup has undergone full test coverage.
  • PG1.0 DM8148 based EVM with with ARM running at 600 MHz and DDR2 at 333MHz clock, having GMII for Ethernet port. This setup is sanity tested only.


This is release of TI814X Linux PSP product.

Useful Links

PSP User Guide

PSP Feature and Performance Guide

PSP Release Download Page

Technical Support and Product Updates

For further information or to report any problems, contact or

OMAP Linux Mailing List: </div>