DRA7xx GLSDK 6.03.00.01 Release Notes

Generic Linux Software Development Kit (GLSDK) 6.03.00.01 for DRA7xx

December 23, 2013

This is the Alpha release of the Generic Linux Software Development Kit (GLSDK) for the DRA7xx platform. This GLSDK Software release gives developers the ability to evaluate the hardware and software capabilities of the DRA7xx platform.

This document is divided into the following sections:

Documentation

• Latest up to the minute information and updates may be found on the Texas Instruments Processors Wiki.

• The Quick Start Guide contains information on how to set up your EVM for an out of box demo showcase as well as for software development. It is located in the docs/ folder in the GLSDK along with other documentation.

• The EVM_GLSDK_Software_Developers_Guide Software Developer's Guide contains information on how to start developing software on the DRA7xx EVM and is located in the docs/ folder in the GLSDK along with other documentation.

Components

The Linux GLSDK is a single package that includes the following components:

• U-boot support (2013.04)
  • Boot from: SD card, eMMC (FAT load), QSPI, UART
  • tftp, dhcp
  • Secure Boot (from SD Card & eMMC)
• Linux kernel 3.8.13
  • FS Media: SD card, eMMC, NFS
  • USB Host: Isochronous A/V, HID, MSC
  • USB 3.0 Host: MSC
  • UART, I2C, QSPI, Ethernet, SATA
  • VIP (V4L2, mmaped buffer, single-instance, one slice, one port, YUYV format capture)
  • VPE (V4L2 M2M – DEI, Scalar, CSC - mmaped buffer)
  • DSS (LCD, HDMI, FPDLink)
  • McASP
  • WiLink 8 (WLAN)
  • MPU DVFS, AVS Class 0
  • MPU Thermal Mgmt (via CPU freq)
• Multimedia
  • H.264, MPEG2, MPEG4 & VC1 decoders @ 1080p60
  • MJPEG decoder
  • Gstreamer plugin for video decode acceleration
  • Gstreamer plugin for KMS display sink
  • Gstreamer plugin for Wayland sink
  • Gstreamer plugin for X11 sink (DRI2video)
  • AAC audio codec (ARM based, open-source)
  • Software Defined Radio (with demo demodulator)
  • DSP-side DCE interface for custom codec integration
• Graphics
  • 2D graphics acceleration (BLTsville)
  • 3D graphics acceleration (OpenGL ES 2.0)
  • Wayland, with Weston compositor
  • X11 stack (without Window Manager)
• Frameworks
  • BIOS (IPU2, SMP-only)
  • DCE (IPU2)
  • IPC 3.x
  • OMAPDRM
• Demo applications
  • Single camera capture -> display demo using native VIP & DSS drivers
  • Dual-decode demo with one display on HDMI and other on LCD (VIDDEC3 interface)
  • Dual-decode demo on single display (Wayland or X11) through GStreamer.

The Software Build of Materials is deprecated, please look at the repo manifest file and yocto layers for details.

What's New

Changes from GLSDK v6.02:

• Secure boot now supports authentication of u-boot and kernel as well.
• Tested USB 3.0 host functionality (MSC) on GP device.
• Added support for scaling and color space conversion in VPE driver.
• Added FPDLink display support.
• Added GStreamer plugins for Wayland and X11 (DRI2video) sink.
• Added X11 stack - without any window manager.
• Software Defined Radio is integrated but only demo demodulator is included in the package due to license restrictions.
• Added DSP-side DCE interface for custom codec integration.
• GStreamer based dual-decode demo application.
• Migrated to Yocto version 1.4 (Dylan).

Installation and Usage

The EVM_GLSDK_Software_Developers_Guide Software Developer's Guide contains information on how to start developing software on the DRA7xx EVM and is located in the docs/ folder in the GLSDK along with other documentation.

Host Support

This release supports Ubuntu 12.04 LTS as your development host.

Dependencies

The GLSDK requires the Linaro toolchain, more information is there in the Software Developer's Guide

Device Support

This GLSDK release supports the DRA7xx EVM and has been validated on the following boards:

• DRA75x Rev-H EVM
  • JAMR3 Apps board
  • 10" OSD LCD display
  • PG 2.0 Silicon
• DRA75x Rev-G EVM
  • JAMR3 Apps board
  • 10" LG LCD display
• DRA72x Rev-B EVM

The DRA72x Rev-B EVM is not compatible with Vision application card. Therefore, the vision OVcamera and LVDS cameras cannot be used as is. The baseboard needs modification to support these use cases.

Validation Information

Please get in touch with your TI contact for validation information / test report.

Known Issues and Limitations

Known Issues:

• OMAPS00293304: Got warning when running gst-launch first time
• OMAPS00293402: Frame drop with kms sink.
• OMAPS00299337: Memory Leak in GFX driver
• OMAPS00299771: QSPI boot can't be done once kernel is loaded
• OMAPS00300317: Viddec3test: Mpeg4 decoding takes more time to display the first frame
• OMAPS00300658: Viddec3test: H264 QCIF resolution is failing on Omap5
• OMAPS00300660: Viddec3test: MPEG4 QCIF resolution playack failed
• OMAPS00300662: Viddec3test: MPEG4 CIF resolution playack failed
• OMAPS00300857: Kernel crash and board reset during stress testing fot gstreamer playback for Audio Video files
• OMAPS00301285: H264 and MPEG4 1080p60 files does not play smoothly with gstreamer kmssink
• OMAPS00301594: Viddec3test fails after long duration playback
• OMAPS00301595: Gstreamer crashes when Playing AV files in a loop by assigning audio=fakesink
• OMAPS00301600: Always getting mmrpc error when playing a particular stream using gstreamer
• OMAPS00301692: Memory leak in graphics driver
• OMAPS00301699: VIP cannot be used unless HDMI is disabled
• OMAPS00301723: Caught SIGSEGV error with gstreamer playbin2 for interlace streams
• OMAPS00301807: Long boot up time if ethernet is not connected
• OMAPS00301898: Image is cropped when framebuffer size is bigger than display mode when using omapdrm API
• OMAPS00301948: Double free or corruption error while playing dual decode using viddec3test
• OMAPS00301952: viddec3test runs out of memory during overnight regression
• OMAPS00301953: getting the error: unable to declare buffer use with mpeg4 specific stream
• OMAPS00302008: VPE failed to deinterlace UYVY
• OMAPS00302071: Kernel crash when stress testing Wayland
• OMAPS00302074: PVR Kernel module failure while running Weston clients and closing abruptly
• OMAPS00302079: Failure seen during very long duration Weston tests
• OMAPS00302094: Mmap error observed with Weston
• OMAPS00302334: Graphics jittering artifacts on Jacinto6/OMAP5
• OMAPS00302834: Display is not working properly, typically after running long duration tests involving graphics and video
• OMAPS00303465: VPE deinterlace test fails for 176x144-nv12 (refer attachments in CQ)
• OMAPS00303496: J6: HW_AUTO mode setting from Kernel does not work correctly for certain peripherals
• OMAPS00304365: Some HD monitors do not work
• OMAPS00304483: Waylandsink: UV offset issue- Color information is getting corrupted
• OMAPS00304690: Low frame rate in VIP capture 15fps
• OMAPS00305090: Higher resolution LCD flickers in the multiple display setup using the FPDLink
• OMAPS00305092: DRA7XX: USB: DWC3: reset to usb3.0 flash drive occurs while running ltp-ddt usbhost performance test
• OMAPS00305094: xrandr does not detect the LCD display on DRA7xx correctly
• OMAPS00305100: USB3.0: DRA7XX: Secure(HS): USB3.0 superspeed flashdrive is detected as highspeed device
• OMAPS00305104: Dual instance IVA-HD decoder support in mult-threaded environment for GLSDK 6.02.01.02
• OMAPS00305111: PVR crash with dual display on DRAxx using X11
• OMAPS00305120: xclock application causes a PVR crash

Issues closed since GLSDK v6.02:

• OMAPS00297282: Running kmscube for long duration crash the system
• OMAPS00299773: VPE firmware can't be loaded through userspace
• OMAPS00301597: Frame drop observed in Gstreamer when playing 60fps AV streams
• OMAPS00301764: EDID read misses all supported modes of HDMI
• OMAPS00301768: KMSCube shows aliasing artifacts on HDMI
• OMAPS00302007: VPE test app processes exactly 20 frames
• OMAPS00302057: symbolic link to bltsville libraries not found in file system
• OMAPS00302060: ipumm binary does not show the right tag information
• OMAPS00302070: Screen saver settings specified in the weston.ini are not taking effect
• OMAPS00302076: Cannot unlock screen saver when the weston goes into screensaver mode the second time

Limitations:

• USB 3.0 support is not tested on HS devices.
• u-boot QSPI can't read / erase more than 0x10000.
• VIP support is limited to mmaped buffer, single-instance, one slice, one port, YUYV format capture.
• VPE support is limited to mmaped buffer, single-instance.
• Audio playback is limited to 44.1 kHz.
• NAND/NOR FS support is not available.
• HDMI audio is not supported.
• PVR EXA driver is included in this release to enable DRI2video sink. However, the window management feature of PVR EXA driver leads to SGX hardware recovery. Workaround is to remove PVR EXA driver from file system and use software EXA. DRI2video sink will not be available with software EXA.
• Conflict between HDMI and I2C2 requires that HDMI be disabled when VIP or FPDLink display are used.
• On DRA7xx EVMs of Rev D or earlier, HDMI error logs appear continuously on the console when HDMI is not connected. It is recommend to use Rev E board or later, or keep the HDMI connected.
• Wayland and X11 support only single display. KMS can be used with multiple displays.
• Support for JAMR3 board is limited to Software Defined Radio.

Versioning

This is Alpha release (GLSDK 6.03.00.01) for DRA7xx ES 1.0.

Technical Support and Product Updates

Latest up to the minute information and updates may be found on the http://processors.wiki.ti.com/index.php/Category:GLSDK.
E2E Linux Forum - http://e2e.ti.com/support/embedded/f/354.aspx] can be used for discussing the Linux GLSDK development.

Download the Latest GLSDK

The latest GLSDK is available for download from http://downloads.ti.com/infotainment/esd/jacinto6/glsdk/latest/index_FDS.html

GLSDK releases can be downloaded from http://downloads.ti.com/infotainment/esd/jacinto6/glsdk/

The current version is 6.03.00.01.