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 AM389x PSP Release Notes

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

DM816x refers to DM816x/AM389x devices unless specified.

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

TI816x PSP[edit]

Release Notes Release: November 30, 2011

Document License[edit]

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[edit]

  • 'Pre-built U-Boot binaries in the release package are for DDR3 @800MHz clock'

USBx_ID configuration

  • The USB0_ID/USB1_ID pin is always configured through software in DM816X silicon revisions. This configuration is done by chosing appropriate configuration through USBx_ID menuconfig selection. more information refers to USB Configuration Page.

Following changes are applicable for release onwards:

  • We are migrating from "legacy" mmc driver to a "generic" mmc driver in the latest u-boot .This will break the existing boot script used. Please refer the U-boot user guide and update you scripts according to that.
  • When using PCIe boot mode, NAND and/or NOR may not be accessible from U-Boot and kernel. Please refer "Conflict with NAND/NOR and DM814x/DM816x PCIe Boot Mode setting" section in PCI Express Endpoint Boot Driver User Guide

  • There is a change in the ECC layout in the kernel for 1-bit HW ECC scheme. This change is made to synchronise the ECC layout with Uboot (and make it in accordance with the community). It is advised that the customer must re-flash any data to NAND that was flashed earlier using the previous release kernel.
    -Previous release ECC byte positions: UBoot: [40-51], Kernel: [52-63]
    -Current release ECC byte positions: UBoot: [40-51], Kernel: [40-51]
  • This release supports both 8 and 16 bit NAND flash. To use 8-bit NAND, set the CS0BW (buswidth) switch on the EVM to ON state. To use 16-bit NAND, set the CS0BW (buswidth) switch on the EVM to OFF state. The switch states for 8 and 16 bit (ON and OFF respectively) are decided so as to maintain backward compatibility with our previous releases which supported 16-bit NAND flash by default (i.e. CS0BW pin in OFF state).

Following are applicable for PSP release.

  • This release adds support for V4L2 capture driver on top of release. There is no major change in this release apart from addition of V4L2 capture. Please refer to release notes for more details about change between release and release.
  • Please note that V4L2 capture driver requires I2C1 instance to be controlled from Linux side. So any of the application/driver trying to access I2C1 from any other processor wont work.
  • Only one instance of V4L2 capture driver is supported with TVP7002 decoder

In addition, note following changes applicable for release onwards:

  • 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. .


This is Release of TI816x Linux PSP tested on DM8168/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.01.13
TI816x U-Boot;a=summary (ti81xx-master) v2010.06 v2010.06_TI816XPSP_04.00.01.13

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.


For complete list of components versions that will work with this release, please refer to the Software BOM page at

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

Tool/Component Release Version
CGTools 4.9.0
XDC 3_22_04_46
BIOS 6_32_05_54
IPC 1_23_05_40
Syslink 2_00_03_82

What's Supported[edit]

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 Application board)
    • 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)
    • PCIe EP Driver for DM816x device in EP mode
    • Booting DM814x EP set in PCIe boot mode when connected to DM816x, x86 PC or DM814x Root Complex. Refer this application note for considerations when using a non DM816x/DM814x 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.
  • Video Capture driver (Applicable to PSP04.00.01.13_patch2 release)

What's Not Supported[edit]

  • Following are not supported:
    • 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.

New in this Release[edit]

Following features have been added since version

  • HDMI Audio Auto Mode Support for DM816X PG2.0
  • U-boot Environment variable support on MMC/SD
  • Video Capture driver
  • PCIe EP Driver for DM816x device in EP mode
  • Auto Detection of Kernel Load Address and Run Time RAM Base feature enabling flexible load address of kernel
  • Concurrent usage of one port as USB host and other port as USB device (refer USB Userguide for details)
  • USB CDC Host support
  • UBIFS File System support

Fixed in this Release[edit]

This section lists issues fixed in this release:

Issue Identifier
Issue Headline
USB_Audio:seeing many warnings while unpluging USB audiodevice and DUT hangs for sometime
Warnings observed while building kernel
DM81XX: USB: video capture and play from usb camera (creative) is inconsistent for 640X480 resolution
DM81XX: USB: when overcurrent device connected to DM81XX host,VBUS_ERROR occurs further connecting good device does not work
TI816X: u-boot: Second Stage u-boot does not load automatically from SD-Card
TI81XX: ASoC: Audio Capture Noise: The captured file has a lot of noise
TI816X: Sil9022a -Missing TI81xx_un_register_display_panel ()
TI816X: Sil9022a - Turn off display at exit()
TI816X: Sil9022a- gsii9022a_obj.vencinfo.enabled removal
TI81XX: Setting mode via sysfs fails once in a while
TI81XX: Capture driver continously reports "Unable to allocatebuffers"
ti816x: davinci emac: not able to connect second ethernet on VS daughter card to Gigabit switch

Known Issues[edit]

This section lists known issues observed in this release:

Issue Identifier
Issue Headline
Known Workaround(s)
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.
SATA driver does not support suspend/resume
This support is not available in the current release. Hence when the system switches to low power state and if SATA support is enabled in the kernel then the suspend/resume process will not disable SATA module and PHY. But this will not affect the suspend / resume process.
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)
Kernel build fails if IOMMU Debug-FS is enabled in kernel configuration
Disable iommu debug-fs support during kernel configuration (menuconfig)
CCS based NAND flashing tool can be used only to flash bootloader
This is a limitation mainly due to the different ECC scheme and ECC layouts used for different images. Hence for flashing other images (like linux kernel and filesystem) use u-boot or uart boot mode.
No SPI software support (including SPI boot) for DM8168 Rev H EVM. There is no workaround as of now. The SPI part used in this revision of EVM is different from the ones used in the earlier EVMs.
SATA loadble module support: System hang observed when ahci_platform.ko module was unloaded.
None. Requires a system reboot.
DM81xx:V4L2 Capture: FPS is low with capture +fbdev loop back (PSP04.00.01.13_patch2)
DM81xx:V4L2 Capture: Kernel dump is seen on starting capture (PSP04.00.01.13_patch2)
DM81xx:V4L2 Capture: Filter is always selected for 1080P60 mode (PSP04.00.01.13_patch2)
SDOCM00082602 SD removal while I/O is in progress causes system hang None. It is recommended not to remove the card while I/O is in progress.
SDOCM00087448 USB_Audio : DUT hangs for 8 to 10 sec while unpluging the USB audiodevice during playback Recommeded to stop the audio playback before unplugging of audio device.

Installation and Usage[edit]

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

Upgrade and Compatibility Information[edit]

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

Device Support[edit]

This release supports the Texas Instruments DM8168/C6A8168/AM389x (on DM8168 EVM)

Validation Information[edit]

This release is tested on DM8168 EVM (Rev-B DDR2/ Rev C/D DDR3) with 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[edit]

PSP User Guide

PSP Feature and Performance Guide

PSP Release Download Page

Technical Support and Product Updates[edit]

For further information or to report any problems, contact or

OMAP Linux Mailing List:

E2e.jpg {{
  1. switchcategory:MultiCore=
  • For technical support on MultiCore devices, please post your questions in the C6000 MultiCore Forum
  • For questions related to the BIOS MultiCore SDK (MCSDK), please use the BIOS Forum

Please post only comments related to the article DM816x AM389x PSP Release Notes here.

  • For technical support on MultiCore devices, please post your questions in the C6000 MultiCore Forum
  • For questions related to the BIOS MultiCore SDK (MCSDK), please use the BIOS Forum

Please post only comments related to the article DM816x AM389x PSP Release Notes here.

C2000=For technical support on the C2000 please post your questions on The C2000 Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. DaVinci=For technical support on DaVincoplease post your questions on The DaVinci Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. MSP430=For technical support on MSP430 please post your questions on The MSP430 Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. OMAP35x=For technical support on OMAP please post your questions on The OMAP Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. OMAPL1=For technical support on OMAP please post your questions on The OMAP Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. MAVRK=For technical support on MAVRK please post your questions on The MAVRK Toolbox Forum. Please post only comments about the article DM816x AM389x PSP Release Notes here. For technical support please post your questions at Please post only comments about the article DM816x AM389x PSP Release Notes here.


Hyperlink blue.png Links

Amplifiers & Linear
Broadband RF/IF & Digital Radio
Clocks & Timers
Data Converters

Power Management


Switches & Multiplexers
Temperature Sensors & Control ICs
Wireless Connectivity