DM814x AM387x PSP 04.01.00.07 Release Notes

DM814x AM387x PSP 04.01.00.07 Release Notes

Linux PSP

Important
This document covers details for TI814x 04.01.00.07 release. This release is tested on DM8148EVM (refer Validation Information section for validation details)

TI814x PSP 04.01.00.07

Release Notes

Release Date:  November 30, 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

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

1) 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]

2) 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 (CS0BW is connected to BTMODE12 switch on DM814X board). 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).

3) HDVPSS binaries are no longer packaged with release tar ball, instead they can be downloaded from the PSP Software Download page

4) Suspend to memory/resume is supported, if UART wake-up/resume is desired then "no_console_suspend" needs to be passed as part of bootargs.For more details refer to Suspend to Memory

5) Clocks: All clocks required by a driver/module must be enabled explicitly in the driver code (interface,functional).Drivers/modules should not rely on u-boot/kernel to enable required clocks as with updated pm framework unused(usecount zero) clocks/clock domains are disabled during kernel initialization.

6) McASP clock is changed from PLL_AUDIO_OUT to sys_clk_22 (OSC0) as the PLL_AUDIO_OUT is used to feed clock to CPTS module (IEEE 1588 clock) and RGMII ref clock in Ethernet switch.
7) 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

7)V4L2 capture support is available from PSP04.01.00.06_patch2 release only

• Please note that V4L2 capture driver requires I2C2 instance to be controlled from Linux side. So any of the application/driver trying to access I2C2 from any other processor wont work.
• Only one instance of V4L2 capture driver is supported with TVP7002 decoder

8) The USB0-ID/USB1_ID input to DM814X decides the role of usb mode to be either host or device for USB0/USB1 mentor usb controllers. USBx_ID should be floating (open) for device mode and grounded for host mode operations The configuration of USBx_ID pin can be done by

• software control (only supported on DM814X PG1.x revision)

• usb plug type inserted to usb connector (micro/mini-A plug for host mode, micro/mini-B plug for device mode).

• by on board USBx_ID jumper setting to either short/open the ID pin for force host/device mode respectively.

The USBx_ID is always software controlled for DM814X PG1.x silicon. In PG2.0 onwards USBx_ID is configured through either external usb plug type or onboard jumper setting. This configuration is done by chosing appropriate configuration through USBx_ID menuconfig selection. more information refers to USB Configuration page

Introduction

This is Release 04.01.00.07 of TI814x Linux PSP tested on DM8148 EVM. The EVM(Rev B DDR3) consists of base board, catalog application card and LCD adapter board In the rest of the document, we will refer this setup as DM8148 EVM.

The Linux PSP serves to provide a fundamental software platform for development, deployment and execution of Linux based applications on Texas Instruments DM8148 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)
TI814x 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
TI814x 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_TI814XPSP_04.01.00.06
TI814x U-Boot	http://arago-project.org/git/projects/?p=u-boot-omap3.git;a=summary (ti81xx-master)	v2010.06	v2010.06_TI814XPSP_04.01.00.06

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

Dependencies

For complete list of components versions that will work with this release, please refer to the Software BOM page at http://processors.wiki.ti.com/index.php/Category:EZSDK_Software_BOM

Tool/Component	Release Version
CCS	5.0.3.00013
CGTools	4.9.0
XDC	3_22_04_46
BIOS	6_32_05_54
IPC	1_23_05_40
Syslink	2_00_03_82
HDVPSS Binary	01.00.01.33

Documentation

The User Guide provides instructions on how to use the PSP Release package.

What's Supported

The Linux PSP package supports the following components:

• U-Boot supporting NAND, NOR, SD and SPI boot modes
• Linux Kernel and device drivers.
  • Ethernet Switch
  • MUSB host driver supporting Mass Storage Class and HID class on USB0 and USB1.
  • NAND
  • NOR
  • TouchScreen
  • UART
  • I2C
  • SATA
  • EDMA
  • Audio driver for HDMI port and AIC3106
  • SPI (PIO mode)
  • SD
  • Video Display Driver(FBDev)
  • LCD Support
  • TILER
  • IOMMU
  • Watchdog Timer
  • GPIO
  • Pinmux support
  • PCIe RC driver
  • PCIe Boot driver supporting booting DM816x or DM814x device connected as PCIe EP to DM814x RC
  • PCIe EP Driver for DM814x device in EP mode
  • Booting DM814x EP set in PCIe boot mode when connected to DM816x or DM814x Root Complex
• Pre-built binaries for U-Boot (for SD and NAND boot mode only), Linux kernel.
• Pre-Built binaries for NAND , NOR and SPI flash writers.
• V4L2 Capture driver (Applicable to PSP04.01.00.06_patch2 release)

What's Not Supported

• Following are not supported:
  • PCIe Boot from a RC other than DM816x or DM814x
  • Ethernet Boot
  • TVP5158 Audio
  • ADC3101 Audio
  • RTC
  • USB OTG-SRP
  • The release package does not include a filesystem image
  • Currently U-Boot doesn't handle PCIe Boot procedure. Refer PCI Express Boot Driver User Guide for details about booting DM814x EP from DM816x RC.

New in this Release

• U-boot Environment variable support on MMC/SD
• PCIe EP Driver for DM814x device in EP mode
• Auto Detection of Kernel Load Address and Run Time RAM Base feature enabling flexible load address of kernel
• Support for LCD on Catalog Application board
• Concurrent usage of one port as USB host and other port as USB device (refer USB Userguide for details)
• USB CDC Host support
• Suspend to memory / Resume - Refer to User Guide for more on this.
• Quick boot configuration for MMC/SD in u-boot
• UBIFS File System support

Fixed in this Release

This section lists issues fixed in this release:

Issue Identifier	Issue Headline
SDOCM00085277	USB_Audio:seeing many warnings while unpluging USB audiodevice and DUT hangs for sometime
SDOCM00085229	TI814x_Buildwarnings: warnings seen during the kernel build
SDOCM00086234	DM81XX: USB: video capture and play from usb camera (creative) is inconsistent for 640X480 resolution
SDOCM00086887	DM81XX: USB: when overcurrent device connected to DM81XX host,VBUS_ERROR occurs further connecting good device does not work
SDOCM00085300	TI816X: u-boot: Second Stage u-boot does not load automatically from SD-Card
SDOCM00084446	ti814x: pm: suspend-resume: DDR should be in self refresh mode before entering suspend
SDOCM00085331	DM81XX:USB: MUSB_DUAL_ROLE : Host mode is not working for PG1.x under MUSB Dual ROLE
SDOCM00082592	TI81XX: ASoC: Audio Capture Noise: The captured file has a lot of noise
SDOCM00082612	TI81XX: ASoC: ALSA Loopback plays back even if all captures are switched off
SDOCM00082844	TI816X: Sil9022a -Missing TI81xx_un_register_display_panel ()
SDOCM00082845	TI816X: Sil9022a - Turn off display at exit()
SDOCM00082846	TI816X: Sil9022a- gsii9022a_obj.vencinfo.enabled removal
SDOCM00083234	TI81XX: Setting mode via sysfs fails once in a while
SDOCM00085999	TI81XX: Capture driver continously reports "Unable to allocatebuffers"
SDOCM00087111	ti814x: cpsw: memory leak during network device closed and opened again and again

Known Issues

This section lists known issues observed in this release:

Issue Identifier	Issue Headline	Known Workaround(s)
SDOCM00084027	ti814x: clock: clock parent change is not reflected in debugfs	None
SDOCM00072638	Audio: Overrun, underrun errors observed for less period sizes less than 64 frames	Use period size >64.
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.
SDOCM00078276	MMC/SD card's write protect status is not detected. Writes can happen on the SD/MMC card irrespective of whether the write protect switch on the card is on or off.	Known Issue. The signal MMC1_SD_WP is by default not connected to pin AG4. Instead signal UART0_DSRn is connected. So I2C2 on the daughter cards will be lost on using Write Protect functionality.
SDOCM00078292	Kernel build fails if IOMMU Debug-FS is enabled in kernel configuration	Disable iommu debug-fs support during kernel configuration (menuconfig)
SDOCM00078359	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.
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.
SDOCM00084561	USB:DM814X: Dynamic detection of USB-ID pin not working on DM814X PG2 when device connected after linux bootup	Use onboard jumper J22/J23 (on TIEVM) to short (for host mode) and open (for device mode) to configure usb-id pin of usb0/usb1.
SDOCM00086735	DM814X: USBOTG: The SRP (Session Request Protocol) initiated from OTG-B peripheral device is not working	There is no software workaround.
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.
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).
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.
SDOCM00082504	McSPI loadable module support broken, second time insmod of McSPI driver fails.	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)
SDOCM00084751	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.
SDOCM00085007	TI816X ALSA SoC Audio Resume Fails due to I/O error	System resume from PM suspend state Causes the background audio playback to fail due to "aplay: pcm_write:1528: write error: Input/output error". This will not block any Suspend/Resume functionality and the audio play back can be restart after the failure with out any issue .
SDOCM00084809	ti814x: cpsw: PTP time syncronization not happening when connected to Port 2	None.
SDOCM00085341	SATA hotplug support does not work after a unplug during read/write access.	Do not unplug SATA cable during access
SDOCM00085342	SATA devices cannot be configured to work in PIO mode using the hdparm tool	None. Only option is to use DMA mode.
SDOCM00085425	SATA read/write issues due to internal 20MHz clock	The internal 20MHz clock source for SATA PLL has some issues. This is being used as the default clock for SATA. Hence we were seeing interface fatal errors. This is a hardware issue. The workaround is to either use the 100MHz external clock from PCIe or find a 20mhz clock source on the board and feed into XI/CLKIN. The later option is transparent and does not require code change but the former requires code change and the PCIe PLL has to be programmed for this.
SDOCM00085989	DM81xx:V4L2 Capture: FPS is low with capture +fbdev loop back (PSP04.01.00.06_patch2)	None
SDOCM00085993	DM81xx:V4L2 Capture: Kernel dump is seen on starting capture (PSP04.01.00.06_patch2)	None
SDOCM00086261	DM81xx:V4L2 Capture: Filter is always selected for 1080P60 mode (PSP04.00.01.13_patch2)	None
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.

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 DM8148 EVM

Validation Information

This release is tested on DM8148 EVM.

The setup details are as follows:

• PG2.x DM8148 based EVM with with ARM running at 600 MHz and DDR3 at 400MHz clock, having RGMII for Ethernet ports. This setup has undergone full test coverage.
• PG1.0 DM8148 based EVM with with ARM running at 600 MHz and DDR2 at 333MHz clock, having GMII for Ethernet port. This setup is sanity tested only.

Versioning

This is 04.01.00.07 release of TI814X Linux PSP product.

Useful Links

PSP 04.01.00.07 User Guide

PSP 04.01.00.07 Feature and Performance Guide

PSP 04.01.00.07 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 </div>