DRA7xx GLSDK 7.03.00.03 Release Notes

Generic Linux Software Development Kit (GLSDK) 7.03.00.03 for DRA7xx

December 18, 2015

This is the GA-Refresh 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 Software Developer's Guide contains information on how to start developing software on the DRA7xx and is located in the docs/ folder in the GLSDK along with other documentation.

Components

The Linux GLSDK 7.03.00.03 release package for DRA75x/DRA72x includes the following components:

• U-boot support (2014.07)
  • Boot from: SD card, eMMC (FAT load), QSPI.
  • tftp, dhcp
• Linux kernel 3.14
  • FS Media: SD card, eMMC, NFS
  • USB Host: Isochronous A/V, HID, MSC
  • USB 3.0 Host: MSC
  • USB Peripheral: NCM Gadget
  • UART, I2C, QSPI, Ethernet
  • VIP (V4L2, DMABUF)
  • OV1063x, TVP5158 and FPD3 serdes drivers (i2c client, v4l2 subdev)
  • VPE (V4L2 M2M, DMABUF)
  • DSS (LCD, HDMI)
  • Audio playback and capture
  • WiLink 8 (WLAN/BT)
  • MPU DVFS, AVS Class 0, ABB
  • RTC
• Multimedia
  • H.264, MPEG2, MPEG4 & VC1 decoders @ 1080p60
  • MJPEG decoder
  • H.264, MPEG4 encoders
  • Gstreamer plugin for video decode acceleration
  • Gstreamer plugin for video encode acceleration
  • Gstreamer plugin for video processing acceleration (using VPE)
  • Gstreamer plugin for KMS display sink
  • Gstreamer plugin for Wayland sink
  • Gstreamer plugin for video capture (using VIP)
  • AAC audio codec (ARM based, open-source)
• Graphics
  • 3D graphics acceleration (OpenGL ES 2.0)
  • 2D graphics acceleration (G2D)
  • Wayland, with Weston compositor, 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) through Gstreamer
  • Dual-decode demo on two displays (Wayland) through Gstreamer
  • Video capture and encode demo through Gstreamer
  • Video capture and display pass through demo 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 v7.02.00.02:

• DRA72x productization
• DRA75x PG 2.0 support
• Support for FPDLink display
• GC320 2D Accelerator support - please contact your TI FAE for getting access to GC320 SW package

Installation and Usage

The Software Developer's Guide contains information on how to start developing software on the DRA7xx 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.

Upgrade and Compatibility Information

This is the refresh release of GLSDK on 3.14 kernel and 2014.07 u-boot

Known Issues and Limitations

This section contains the snapshot of Known Issues and Limitations at the time of making the release.

Known Issues

Key	Module	Summary	Work Around	Impact
GLSDK-1379	DRM / DSS	K3.14: libdrm errors (warning) seen during viddec3test single decode dual display	None	No known impact. Warnings can be ignored.
GLSDK-1493	DRM / DSS	DRA7xx: At times the hdmi driver in omapdss, results I2C master Error	Switch to another display	Observed with only specific HDMI monitors. Some HDMI monitors will not enumerate all modes.
GLSDK-1296	DRM / DSS	J6/J6Eco: K3.x: HDMI/OMAPDSS: Some HDMI monitors are not detected by DRA7xx EVM h/w	Switch to another display	Observed with only specific HDMI monitors
GLSDK-1369	DRM / DSS	J6/J6Eco: K3.x: HDMI/OMAPDSS: modetest not listing all the modes for some hdmi monitors.	Switch to another display	Observed with only specific HDMI monitors
GLSDK-1364	Ethernet	DRA7xx(J6/J6Eco) : ethernet : reliability issues/link failure with gigabit mode of operation(on some boards)	Connect to 100 Mbps port	"Observed only on specific boards
GLSDK-1387	Ethernet	DRA7xx : ethernet : 10Mbps mode does not work	None	HW limitation on EVM
GLSDK-1325	Graphics	SGX: SGX Kernel module crash when Weston is killed while client applications are running	Close all Weston clients before closing Weston	This is not the typical scenario.
GLSDK-1307	I2C	J6/J6Eco: I2C: EEPROM read/write test failed during intergration check.	None
GLSDK-1771	Kernel / Uboot	DRA7X: Kernel: Kernel Soft reboot fails few times when tested for 100 times.	None	None - on the EVM SW reset is converted to PoRz , issue not reproducible with standalone script testing
GLSDK-1383	Kernel / Uboot	DRA7X: Kernel: stress: boot failure seen 5 out of 1000 times, while performing kernel boot stress testing(external power on reset).	None	Not reproducible anymore on TI EVM. Multiple runs with standalone reboot test scripts, issue cannot be reproduced
GLSDK-2394	Multimedia	ducatijpegdec crashes or ouputs green screen for some yuv444 streams	Pick streams with formats and resolutions that are supported by codec.	All jpegs cannot be played. Only codec compliant ones can be played
GLSDK-2506	Multimedia	IPU2 will close automatically when player paused beyond 15 seconds on GA version	echo on > /sys/bus/platform/devices/55020000.ipu/power/control	The test player will have to be terminated and restarted.
GLSDK-2627	Multimedia	j6-eco: ipumm-fw does not recover after crash.	None	Board will have to be restarted
GLSDK-2626	Multimedia	j6-eco: ipumm-fw crashes during multimedia tests	None	If there is successful recovery, there is no impact. If recovery is unsuccessful, the board will have to be restarted
GLSDK-1727	SATA	DRA7X: SATA: 3.0 Gbps SATA devices get enumerates in 1.5Gbps when connected through Port multiplier	None	SATA Gen2 devices will operate at lower Gen1 speeds, issue not seend when the SATA device is directly connected to the SATA port(instead of port multiplier)
GLSDK-1725	Thermal	Thermal: MPU: Thermal_zone_0 (MPU) is disabled by default in kernel	Use the FS script /etc/rc5.d/S98-thermal-zone-init, already fixed in upstream.	mode for Thermal_zone_0 , which is thermal zone for MPU, is by default disabled by the driver in of_thermal_build_zone() of of-thermal.c. This affects only MPU because only MPU thermal detaisl are passed via DT file. MPU thermal status will not be monitored unless the mode is changed.
GLSDK-2628	Toolchain	malloc freeze issue with eglibc 2.15	Toolchain needs to be upgraded	System crash
GLSDK-2478	UART	UART: DMA: data inconsistency observed with serial check utility on uart3 and glitches observed in BT playback	None	One may hear glitches in Audio playback over Bluetooth.
GLSDK-1389	USB	USB: DWC3: warning occurs when the usb camera is removed while capturing the usb video	None	None - warning can be ignored
GLSDK-2594	USB	dra7x: USB: DWC3: Zero Length Packet is not handled in dwc3 device controller driver	None	Applications that use zero length packet for termination are impacted. For instance, Zero length packet is required for CDC/ACM gadget(when the packet length is exactly multiple of maximum endpoint packet size, then the zero length packet need to be transmitted to mark the end of packet) Without ZLP fix the CDC/ETHER gadget transfers of packet length multiple of maxpacket size may fail.
GLSDK-2607	VIP / VPE	DRA7xx: building Ov1603x as a module causes a green tint in captured image	Use the camera driver as builtin. Also, a delay of 1s can stop this issue from occuring	As this is only related to starting the capture within one second of insertine module. The impact is on the early video use cases.
GLSDK-1769	VIP / VPE	DRA7xx: VPE: File2File checksum changes across multiple runs	There is no workaround for this issue yet	No visual artifacts, but checksum on initial frame differs as couple of bytes are incorrect
GLSDK-2385	WiLink	K3.14: Wilink: Performance degradation observed with wl18xx when running udp iperf tests	None	Lower performance observed

Limitations

• Audio - Primary sound card only supports 44.1kHz. Other sample rates require SRC before passing to ALSA pcm device
• VIP - Driver does not support in-line CSC and scaling
• Display - HDMI is not supported with Rev-D and earlier versions of DRA75x EVM
• DRA7x: Power/Thermal - DVFS supports only MPU frequency and voltage changes
• J6Eco: Power/Thermal - On a few samples dynamic detection MPU OPPs doesnt work due to wrong efuse values. Only OPP_NOM is enabled in such cases
• WiLink - Wilink and bluetooth are not functional on J6Eco
• Early Boot and Late Attach has only been verified with IPU2 and in two stage SD boot mode
• System - NAND/NOR FS support is not available
• EVM - JAMR3 sound card cannot be used simultaneously with Software Defined Radio
• J6Eco: Boot - ROM - If an empty SD card is inserted in SD boot mode system hangs with some cards
• J6: MMC/SD: UHS mode is not enabled on DRA75x PG 1.1 (enabled run time on PG 2.0)

Issues closed since GLSDK v7.02.00.02

Key	Module	Summary
GLSDK-1766	DRM / DSS	K3.14: omap_crtc_flush() timeout seen while playing videos on kmscube
GLSDK-2564	DRM / DSS	Kernel: DRM - Crash observed in PVRMISR / omap_gem_op_update
GLSDK-2273	DRM / DSS	K3.14: omapdrm: could not allocate mmap offset during long run test.
GLSDK-2509	Graphics	glReadPixels fails for KMS EGL
GLSDK-1342	Graphics	SGX/DRM: GLBenchmark test for offscreen test leads to kernel crash
GLSDK-2278	Graphics	SGX HWrecovery issue observed with glmark2
GLSDK-2505	Graphics	Application is stuck in eglSwapBuffers()
GLSDK-2566	Graphics	SGX H/W Recovery seen leading to weston hang
GLSDK-2324	Graphics	DRA7xx: Graphics/Display - Two GEM objects, 8KB memory leak observed when an EGL application is closed
GLSDK-2423	Graphics	eglInitialize causes segfault when same native display is passed to eglGetDisplay twice
GLSDK-2383	Kernel / Uboot	u-boot: secure: dra7x: device tree (DTB) authentication fails if dtb file size is not 4 byte aligned
GLSDK-1332	Kernel / Uboot	Init sequence for various modules has to be same between uboot and GEL sequence
GLSDK-2387	Kernel / Uboot	DRA7x: UBOOT: QSPI :cannot access more than 16MB of address space
GLSDK-1363	Kernel / Uboot	DRA7X: U-BOOT: UART-boot mode is not working on DRA7X platform in 2014.07 u-boot, unable to load u-boot image with YMODEM
GLSDK-2341	Kernel / Uboot	DRA7xx: Kernel build fails with CONFIG_THERMAL=m
GLSDK-1728	Multimedia	J6:multimedia: DSP based application like copycodec fails
GLSDK-2190	Multimedia	IPC/BIOS: Suspend to Ram: Suspend/resume support for DSP is missing which prevents system from entering suspend state
GLSDK-1293	UART	DRA7x: UART: UART3/4 ports do not support early debugging
GLSDK-1305	UART	DRA7x: UART : DMA mode is not supported
GLSDK-2480	VIP / VPE	VPE: Memory corruption when used for deinterlacing
GLSDK-2358	VIP / VPE	Failure to allocate a memory in vpe driver causes ioctl to hang
GLSDK-2386	VIP / VPE	VIP: Failed to capture from analog camera
GLSDK-2555	VIP / VPE	VPE: Failure when the ARCH_DMA_ADDR_T_64BIT is enabled

Versioning

This is maintenance release based on kernel version 3.14 (GLSDK 7.03.00.03) for DRA75x PG 1.0/2.0 and DRA72x PG 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.
Please contact your FAE or CPM for any support requests on GLSDK

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