Please note as of Wednesday, August 15th, 2018 this wiki has been set to read only. If you are a TI Employee and require Edit ability please contact x0211426 from the company directory.

DM816x C6A816x AM389x PSP 04.00.00.12 Release Notes

From Texas Instruments Wiki
Jump to: navigation, search
TIBanner.png
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