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.

DM816x C6A816x AM389x PSP Release Notes

From Texas Instruments Wiki
Jump to: navigation, search
DM816x C6A816x AM389x PSP Release Notes
Linux PSP

DM816x refers to DM816x/C6A816x/AM389x devices unless specified.

This document covers details for TI816x release. This release is tested on DM8168/C6A8168/AM389x EVM (Base board + Daughter Card required for second Ethernet port and NOR). Refer Validation Information section for validation details.

TI816x PSP

Release Notes Release: 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

  • Pre-built U-Boot binaries in the release package are for DDR3 @800MHz clock
  • 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.
  • 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.

In addition, note following changes applicable for release onwards:

  • The kernel NAND driver uses 1-bit h/w ECC and U-Boot is also updated accordingly. So it is mandatory to re-flash the latest U-Boot along with kernel and filesystem (if using NAND based kernel and/or filesystem) before proceeding to boot the kernel.
  • The serial console device names to be used are changed from 'ttySx' to 'ttyOx'. This means you will need to change the boot arguments passed to kernel and the /etc/inittab file in the filesystem accordingly. Please refer "Using The Correct Console Device" section in User Guide.
  • The kernel in release will not boot with U-Boot from release(s) earlier to, unless 'machid' environment variable is set correctly. Please refer "Setting up Machine ID" section form User Guide for more details.
  • 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.
  • 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 TI816x Linux PSP tested on DM8168/C6A8168/AM389x EVM. The EVM consists of base board (Rev B/C/D DDR2/DDR3) with daughter card having second Ethernet port and NOR. In the rest of the document, we will refer this setup as DM8168 EVM.

The Linux PSP serves to provide a fundamental software platform for development, deployment and execution of Linux based applications on Texas Instruments DM8168 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)
TI816x 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
TI816x Linux Kernel;a=shortlog;h=refs/heads/ti81xx-master (ti81xx-master) 2b3ea6aa16956e15f1ba8e7b70898aaacbec2237 v2.6.37_TI816XPSP_04.00.00.12
TI816x U-Boot;a=summary (ti81xx-master) v2010.06 v2010.06_TI816XPSP_04.00.00.12

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


Please refer the User Guide included in the docs folder of the package for how to use the PSP Release Package.


This release requires following tools/packages to be installed for fbdev/v4l2 drivers:

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

What's Supported

PSP package includes support for DM8168 EVM platform.

The Linux PSP package supports the following components:

  • U-Boot supporting NAND, NOR, SPI, SD and Ethernet boot mode
  • Linux Kernel and device drivers.
    • Ethernet - EMAC0 and EMAC1
    • MUSB
      • Host mode supporting Mass Storage, HID and ISO Audio/Video Class (USB0 and USB1).
      • Gadget mode supporting Mass Storage and RNDIS (USB0)
    • NAND
    • UART
    • I2C
    • SATA (2 ports)
    • NOR (Requires DC)
    • EDMA
    • Audio
    • SPI (PIO mode)
    • HDMI Driver
    • Video Graphics driver
    • Video Display driver
    • SII9022a external HDMI transmitter driver
    • PCIe RC
    • PCIe EP Boot Driver (Booting DM816x or DM814x EP from DM8168 RC)
    • MMC/SD
    • Watchdog Timer (Requires h/w modifications on EVM)
    • GPIO
    • TILER
    • IOMMU
    • AVS (Board version Rev.D onwards)
  • Pre-built binaries for U-Boot (for SD and NAND boot mode only, with DDR3 @800MHz clock), Linux kernel.
  • Pre-Built binaries for NOR, NAND and SPI flash writers.

What's Not Supported

  • Following are not supported:
    • HDMI Audio
    • ADC3101 Audio
    • RTC
    • CIR
    • The release package doesn't include filesystem image
    • Currently U-Boot doesn't handle PCIe Boot procedure. Refer PCI Express Boot Driver User Guide for details about booting DM8168 in PCIe Boot mode.

Fixed in this Release

This section lists issues fixed in this release:

Issue Identifier
Issue Headline
USB:DMI81XX: The Video capture and playback from creative camera does not work
USB: TI81XX: rmmod followed by insomd of ti81xx.ko failed
USB: While USB Audio record and playback there is underrun error displayed on the console
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
Wrong resource management table listed in TI81xx-PSP-EDMA-Driver-User-Guide
Incorrect command for extracting tar ball
Kernel build fails when audio is removed from config
DDR2 EVMs don't boot on
Linux kernel build fails when TILER driver is built as module

New in this Release

Following features have been added since version

  • AVS driver support
  • SD card hot insertion
  • PCIe EP Boot Driver now supports booting DM814x EP from DM816x RC

Known Issues

This section lists known issues observed in this release:

Issue Identifier
Issue Headline
Known Workaround(s)
Memory corruption with interleaving config for DDR2


This is a known issue and observed only on very few alpha EVMs. Try using different H/W setup as the interleaved configuration is necessary to achieve performance requirements.

Audio: Overrun, underrun errors observed for less period sizes less than 64 frames
 Using period-sizes more than 64 frames is recommended.
Linux crashes if built with NOR support (physmap CFI query) and NOR is disabled in EVM


There is no way to detect form Linux if NOR is enabled in EVM. Make sure to enable NOR in the board if using kernel with NOR support.

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.

NAND 4 bit ECC not supported in TI816x


This is a hardware issue and will not be supported.

u-boot does not boot if both NAND and NOR are enabled in EVM

This is a known issue. Both NAND and NOR uses GPMC_CS0 hence both cannot be enabled simulataneously.

If u-boot is built for NAND boot then enable only NAND in EVM

If u-boot is built for NOR boot then enable only NOR in EVM

EMAC Boot:EMAC boot does not work if the link is auto-negotiated to Gigabit speed

Known issue.

Need to carry out boot operation in 10/100 Mbps mode

PCIe Boot: Kernel gets stuck randomly during boot when boot driver is built into kernel and DM8168 PCIe EP device is not connected or is switched off
This is a known issue cause due to udev device cache in filesystem. Please refer PCI Express Boot Driver User Guide for details about fixing the filesystem.
PCIe RC driver fails to reliably enumerate the downstream device(s) when PRSTn is set as OUTPUT on the EVM
This is a known issue and requires board modification to fix PWRGD line control in output mode. Please refer PCI Express Root Complex Driver User Guide for details.
NAND boot on some EVMs needs reset switch to be pressed
Press reset button SW9 on the EVM after power on.
Audio capture failure in mmap mode
This issue occurs when the verbose flag is passed and is not seen older versions of alsa-utils. When using alsa-utils 1.0.23 not passing the verbose flag is recommended.
Kernel build fails if IOMMU Debug-FS is enabled in kernel configuration
IOMMU debug-fs should always be built as module
USB: TI816X: On some of PG1.1 DDR3 EVMs, the Babble condition occurs on USB0 or USB1 port. The USB does not work when this babble issue occurs.
Known Issue, Workaround: Press the EVM reset button for long time(3 to 5sec) before releasing it.
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.
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.
Dual musb controller wtih 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.
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).
SDOCM00082447 DM81XX: Pop noise when starting audio playback
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.
SATA loadble module support: System hang observed when ahci_platform.ko module was unloaded.
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)
GPIO driver: GPIO set data is cleared after SmartReflex enable/disable
This is a known issue. The bug has been fixed and the patch fixing the bug will be pushed to arago.

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 DM8168/C6A8168/AM389x (on DM8168 EVM)

Validation Information

This release is tested on DM8168 EVM (Rev-B DDR2/ Rev C/D DDR3) with C6A816x/AM389x filesystem built from arago.

ARM is running at 1 GHz and DDR2 at 400 MHz (effective 800MHz data rate) or DDR3 running at 800MHz clock.

Note that the DDR2 based setup has undergone sanity test only.


This is release of TI816X 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: