DM816x C6A816x AM389x PSP 04.00.00.12 Release Notes

DM816x C6A816x AM389x PSP 04.00.00.12 Release Notes

Linux PSP

IMPORTANT

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

Important
This document covers details for TI816x 04.00.00.12 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 04.00.00.12

Release Notes

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

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 04.00.00.09 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 04.00.00.06, 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
  
  

Introduction

This is Release 04.00.00.12 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)	http://git.kernel.org/?p=linux/kernel/git/tmlind/linux-omap-2.6.git;a=commit;h=2b3ea6aa16956e15f1ba8e7b70898aaacbec2237	2b3ea6aa16956e15f1ba8e7b70898aaacbec2237
U-Boot	2010.06	http://git.denx.de/?p=u-boot.git;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	http://arago-project.org/git/projects/?p=linux-omap3.git;a=shortlog;h=refs/heads/ti81xx-master (ti81xx-master)	2b3ea6aa16956e15f1ba8e7b70898aaacbec2237	v2.6.37_TI816XPSP_04.00.00.12
TI816x U-Boot	http://arago-project.org/git/projects/?p=u-boot-omap3.git;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

Documentation

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

Dependencies

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

Tool/Component	Release Version
CCS	5.0.3.00013
CGTools	4.9.0
XDC	3_22_01_21
BIOS	6_32_01_38
IPC	1_23_01_26
Syslink	2_00_00_78
HDVPSS Binary	01.00.01.28

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
SDOCM00078904	USB:DMI81XX: The Video capture and playback from creative camera does not work
SDOCM00078869	USB: TI81XX: rmmod followed by insomd of ti81xx.ko failed
SDOCM00078467	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
SDOCM00074366	Linux SD driver cannot detect SD card hot insertion
SDOCM00075294	Low performace for MMC/SD reads and writes
SDOCM00081779	Wrong resource management table listed in TI81xx-PSP-EDMA-Driver-User-Guide
SDOCM00079049	Incorrect command for extracting tar ball
SDOCM00078907	Kernel build fails when audio is removed from config
SDOCM00081529	DDR2 EVMs don't boot on 04.00.00.11
SDOCM00079987	Linux kernel build fails when TILER driver is built as module

New in this Release

Following features have been added since version 04.00.00.10:

• 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)
SDOCM00072633	Memory corruption with interleaving config for DDR2	None. 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.
SDOCM00072638	Audio: Overrun, underrun errors observed for less period sizes less than 64 frames	Using period-sizes more than 64 frames is recommended.
SDOCM00072523	Linux crashes if built with NOR support (physmap CFI query) and NOR is disabled in EVM	None. 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.
SDOCM00072456	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.
SDOCM00072442	NAND 4 bit ECC not supported in TI816x	None. This is a hardware issue and will not be supported.
SDOCM00072694	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
SDOCM00077540	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
SDOCM00077551	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.
SDOCM00077550	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.
SDOCM00077223	NAND boot on some EVMs needs reset switch to be pressed	Press reset button SW9 on the EVM after power on.
SDOCM00072636	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.
SDOCM00078292	Kernel build fails if IOMMU Debug-FS is enabled in kernel configuration	IOMMU debug-fs should always be built as module
SDOCM00078870	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.
SDOCM00081588	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.
SDOCM00082475	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.
SDOCM00081534	Dual musb controller wtih one controller(usb0) as host and other controller(usb1) as device feature is not supported	This feature currently not supported.
SDOCM00082541	USB:TI8XX: The file i/o to flash drive fails when connected through Full Speed HUB	Use high speed hub.
SDOCM00082356	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	None
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.
SDOCM00082505	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.
SDOCM00082602	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.
SDOCM00082504	McSPI loadable module support broken, second time insmod of McSPI driver fails.	None. Requires a system reboot.
SDOCM00082503	SATA loadble module support: System hang observed when ahci_platform.ko module was unloaded.	None. Requires a system reboot.
SDOCM00082597	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)
SDOCM00083248	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.

Versioning

This is 04.00.00.12 release of TI816X Linux PSP product.

Useful Links

PSP 04.00.00.12 User Guide

PSP 04.00.00.12 Feature and Performance Guide

PSP 04.00.00.12 Release Download Page

Technical Support and Product Updates

For further information or to report any problems, contact http://community.ti.com or http://support.ti.com.

OMAP Linux Mailing List: http://vger.kernel.org/vger-lists.html#linux-omap