DRA7xx GLSDK 6.04.00.02 Release Notes

Generic Linux Software Development Kit (GLSDK) 6.04.00.02 for DRA7xx

April 22, 2014

This is the GA 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, DMABUF)
  • VPE (V4L2 M2M, DMABUF)
  • 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 video processing acceleration (using VPE)
  • 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, multiple display support
  • X11 stack, with OpenBox window manager, multiple display support
• 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.
  • Dual-decode demo on two displays (Wayland or X11) through GStreamer.
  • Triple display application (Wayland extended display).

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.03:

• Support for J6 ES 1.1 devices.
• ABB Verification - Verification scope restricted to Software flow check
• U-boot
  • Support for early boot of IPU
  • System Boot Optimization (QSPI only)
    • Support for single stage bootloader in QSPI boot mode
  • Secure boot validated on ES1.1 HS device
• Support for LateAttach in kernel
• USB 3.0 support verified on J6 ES1.1 HS devices
• USB DRD (Dual role device) support.
• UART-DMA support. Refer to GLSDK-6.10.00.02-Post-release-page for patches.
• VIP driver
  • Support for RGB888 input color format
  • Support for multiple instances
  • Support for slice 1
  • Support for DMABUF
  • Support for Capture up to 60 fps
• VPE driver
  • Support for multiple instances and DMABUF.
  • Support for sequential Top / Bottom interlaced buffer format (decoded by IVA-HD).
• Gstreamer
  • Support for VPE Plug-in: Support limited to only the following use cases in VPE plug-in.
    • Decode->Deinterlace->Display
    • Decode->Scale->Display
• Enabled OpenBox window manager with X11 - Supports multiple displays.
• Upgraded Wayland / Weston to version 1.3 - Supports multiple displays.
• Support for Triple Display Application - Using KMSCube and Weston
• Gstreamer based dual-decode->dual-display demo with Wayland and X11 sink

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

This section contains the snapshot of Known Issues and Limitations at the time of making the release.
Information regarding any further updates - defects, enhancements and/or fixes will be made available via DRA7xx GLSDK 6.04.00.02 Post-release Updates page.

Known Issues:
Kernel and Uboot

• OMAPS00308415: Kernel: DSS errors during Gstreamer or wayland testing results in HDMI display to go blank due to PLL GO bit not set error
• OMAPS00308147: Display flicker seen on HDMI display
• OMAPS00308439: Interrupts not reliably working with GPIO on IRQF_TRIGGER_LOW
• OMAPS00308371: Missing Init sequence of PBIAS circuit for the MMC1 pins on the DRA7xx for 1.8V mode
• OMAPS00308338: Kernel: dra7xx: Kernel crash when running VIP capture test in regression
• OMAPS00308386: Kernel: VIP: Kernel crash when invoking VIP capture after STREAMON failure
• OMAPS00308245: DRA7xx: kernel: VIP: Jitter observed when capturing at less than 10 fps from OVcam/TVP camera
• OMAPS00308353: DRA7xx: KERNEL: VPE: Multi instance failed for NV12 input
• OMAPS00308311: DRA7xx: KERNEL: VPE: Artifacts occurs @ every 6th frame, while perform scaling with de-interlace on NV12 input
• OMAPS00308493: DRA7x: kernel: eth: after multiple times of interface up/down during fast ping traffic from PC, eth-interface does not work
• OMAPS00308483 : Underruns when playing back audio wav files with sampling rates 48k & 96k
• OMAPS00308435: Yocto: ltp-ddt: Update yocto recipe to include iperf and bc utilities
• OMAPS00299771: In QSPI boot mode, issuing reboot while kernel boots up results in a system hang. Cold reboot is required to get the system working again.
• OMAPS00301898: Image is cropped when framebuffer size is bigger than display mode when using omapdrm API
• OMAPS00304365: DRA7xx: Some HD monitors do not work when non-standard timing is selected.
• OMAPS00305092: DRA7XX: USB: DWC3: reset to usb3.0 flash drive occurs while running ltp-ddt usbhost performance test

Graphics

• OMAPS00308301: Wayland: Stress Test - Kernel crash during Wayland stress test after ~40 hours of continuous testing due to dispc_mgr_go
• OMAPS00308513: Graphics/DRM: Usability - kmscube application on HDMI shows tearing artifacts in specific screen area
• OMAPS00308070: SGX: Functionality: Killing Weston simple-egl and subsurface applications leads to SGX HW recovery
  • This does not result in a system hang or a system reboot.
  • Weston continues to run without crashing. Other weston clients can be launched
• OMAPS00302074: Wayland: Stress - Termination of Weston and running clients causes kernel crash due to page faults
• OMAPS00308455: X11: Functionality - Simultaneous execution of gstreamer and OPENGLES application causes PVR crash
• OMAPS00308451: X11: Functionality - Reflection/rotation operation with xrandr result in kernel hang and reboot is needed
• OMAPS00307925: X11: Functionality - Consecutive rotation of LCD display using xrandr results in kernel warning
• OMAPS00307993: X11: Functionality - Dual 1080p video playback causes EQ overflow in XServer resulting in a hang
• OMAPS00308054: X11: Functionality - Mode set with xrandr doesn't change the video playback resolution
• OMAPS00308141: X11: Functionality - gst-dri2videosink testcases fail after x11 goes into screensaver

Multimedia

• OMAPS00308271: DRA7xx: Stress Test - Kernel crash seen when running Gstreamer pipelines with decoder->vpe (deinterlace)->display in a loop

Issues closed since GLSDK v6.03:
Kernel and Uboot

• OMAPS00307900: modetest with option -v and for non-standard timings is causing kernel crash
• OMAPS00308174: The first few lines of the default framebuffer gets corrupted after running VIP capture test application. This happens randomly and is not seen every time.
• OMAPS00301948: Double free or corruption error while playing dual decode using viddec3test
• OMAPS00301699: VIP cannot be used unless HDMI is disabled
  • This defect is rejected as it is an EVM limitation. Please refer to the limitations section in this release notes for further details
• OMAPS00302834: DRA7xx: Kernel: HDMI: Display is smudged typically after running long duration tests.
• OMAPS00304690: Low frame rate in VIP capture 15fps
• OMAPS00305090: Higher resolution LCD flickers in the multiple display setup using the FPDLink
• OMAPS00305100: USB3.0: DRA7XX: Secure(HS): USB3.0 superspeed flashdrive is detected as highspeed device
• OMAPS00303496: J6: HW_AUTO mode setting from Kernel does not work correctly for certain peripherals
• OMAPS00303465: VPE deinterlace test fails for 176x144-nv12 input
• OMAPS00301807: Boot takes a long time (in the order of few minutes) if ip=dhcp is set in bootargs and Ethernet cable is not connected to the target.
  • Resolved by ensuring that "ip=off" is set by default in bootargs, when file system is mounted from SD/MMC and not using NFS Mount. "ip=dhcp" option is used if the Ethernet usage is mandatory during kernel boot time, particularly where NFS file system is used. In this scenario, without “ip-<address>”, the kernel cannot mount NFS file system and hence wait till the configuration is successful using various autoconf options (dhcp, bootp, rarp etc). For more details on the usage of ip=<address>, refer to the kernel documentation in Documentation/filesystems/nfs/nfsroot.txt. For use cases where NFS mount is not required, "ip=off" is set and the kernel boots normally. Once the file system is mounted, file systems script will bring the interface up either through DHCP or static based on configuration. Refer /etc/network/interfaces.

Graphics

• OMAPS00307872: Graphics: Functional: Running kmscube during init (like a splash screen) causes kernel crash in omap_plane_mode_set function
• OMAPS00302071: Wayland: Stability - Long duration wayland tests results in a kernel crash due to omap_plane_mode_set in DRM layer
• OMAPS00302079: Wayland: Stress - Relaunching weston with n instances of weston clients in a loop causes hang due to mmap failure in SGX KM
• OMAPS00302094: Wayland: Stress - Relaunching Weston in a loop causes board to hang due to PVR mmap errors
• OMAPS00307795: X11: Functionality - Video playback with dri2videosink causes kernel oops in DRM layer due to spinlock
• OMAPS00302334: Graphics jittering artifacts on Jacinto6/OMAP5
• OMAPS00301692: Memory leak in graphics driver
• OMAPS00305094: xrandr does not detect the LCD display on DRA7xx correctly
• OMAPS00305111: PVR crash with dual display on DRA7xx using X11
• OMAPS00305120: xclock application causes a PVR crash

Multimedia

• OMAPS00308144: interlaced streams gst playback: kernel backtrace if ctrl-C command issued during play.
• OMAPS00301723: Caught SIGSEGV error with gstreamer playbin2 for interlace streams
• OMAPS00293402: Frame drop with kms sink.
• OMAPS00300857: Kernel crash and board reset during stress testing for 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
• OMAPS00301952: viddec3test runs out of memory during overnight regression
• OMAPS00301953: getting the error: unable to declare buffer use with mpeg4 specific stream
• OMAPS00305104: Dual instance IVA-HD decoder support in mult-threaded environment for GLSDK 6.02.01.02

Limitations:

• VIP driver supports Slice 0 or Slice 1, but not both simultaneously for a given VIP instance.
• VIP driver supports only Port A.
• VIP driver does not support in-line CSC and scaling.
• NAND/NOR FS support is not available.
• HDMI audio is not supported.
• 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.
• Support for JAMR3 board is limited to Software Defined Radio.
• OMAPS00308094: Remote processor IPU2 application / firmware leaks memory when the MPU side application is killed abruptly.

Appendix

There are some fixes which did not make it to the 6.04.00.02 release. But there are patches available for the corresponding defects. The patches can be cherry-picked from the omapzoom repository and can be applied on top of 6.04.00.02 release (kernel). These would be reviewed and merged into p-ti-glsdk-3.8.y branch of the kernel repository. The updates will be available via DRA7xx GLSDK 6.04.00.02 Post-release Updates page.

Defect Fixes and Patch Updates

Defect/ER ID	Description	Patch Details	Comments
OMAPS00308263	DRA7xx: Kernel: VIP: Capture hangs after running for regression for around 100 iterations	http://review.omapzoom.org/35030 http://review.omapzoom.org/35031	Improving buffer dropping mechanism seem to have solved the problem
OMAPS00308434	DRA7xx: Kernel: VIP: Driver does not return field ID to the user space	http://review.omapzoom.org/35061 http://review.omapzoom.org/35062	Reading field ID through write descriptor and returning to user space
OMAPS00308544	DRA7xx: Kernel: OMAPDSS: 10" LCD must be supported as default LCD panel connected via parallel connector	http://review.omapzoom.org/#/c/35249/ http://review.omapzoom.org/#/c/35250/	Patches are not reviewed on p-ti-glsdk-3.8.y
OMAPS00309900	DRA7XX: KERNEL + U-BOOT: Workaround for non efuse burn for AVS Class 0 voltage	Kernel 3.8: http://review.omapzoom.org/#/c/35287/ http://review.omapzoom.org/#/c/35288/ http://review.omapzoom.org/#/c/35289/ u-boot: http://review.omapzoom.org/#/c/35116/	Patches are merged into the p-ti-linux-3.8.y and the p-ti-u-boot-2013.04.
OMAPS00310935	J6 DDR3 PowerUp Initialisation Sequence Issue	u-boot: http://review.omapzoom.org/#/c/35598/	Patches are merged into the p-ti-u-boot-2013.04.

Versioning

This is GA release (GLSDK 6.04.00.02) for DRA7xx ES 1.0 and ES 1.1.

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