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
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.
- 1 TI816x PSP 04.00.00.12
- 1.1 Document License
- 1.2 Read This First
- 1.3 Introduction
- 1.4 Documentation
- 1.5 Dependencies
- 1.6 What's Supported
- 1.7 What's Not Supported
- 1.8 Fixed in this Release
- 1.9 New in this Release
- 1.10 Known Issues
- 1.11 Installation and Usage
- 1.12 Upgrade and Compatibility Information
- 1.13 Device Support
- 1.14 Validation Information
- 1.15 Versioning
- 1.16 Useful Links
- 1.17 Technical Support and Product Updates
TI816x PSP 04.00.00.12
04.00.00.12 Release: July 15, 2011
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
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|
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
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:
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
- Host mode supporting Mass Storage, HID and ISO Audio/Video Class (USB0 and USB1).
- Gadget mode supporting Mass Storage and RNDIS (USB0)
- SATA (2 ports)
- NOR (Requires DC)
- 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)
- Watchdog Timer (Requires h/w modifications on EVM)
- 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
- 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 04.00.00.11|
|| 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
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||
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.
This release supports the Texas Instruments DM8168/C6A8168/AM389x (on DM8168 EVM)
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 04.00.00.12 release of TI816X Linux PSP product.