Processor SDK Linux Release Notes

From Texas Instruments Wiki
Jump to: navigation, search

Ti stk 1c rev rgb png.png

Last updated: 10/09/2017


The Processor Software Development Kit (Processor-SDK) for Linux provides a fundamental software platform for development, deployment and execution of Linux based applications and includes the following:

  • Bootloaders & Filesystems
  • SDK Installer
  • Setup Scripts
  • Makefiles
  • Matrix Application Launcher
  • Example Applications
  • WLAN support (Wilink 8)
  • Code Composer Studio v7


Please refer to the software manifest, which outlines the licensing status for all packages included in this release. The manifest can be found on the SDK download page. The manifest can be found on the SDK download page or in the installed directory as indicated below. In addition, see Processor_SDK_Linux_GPLv3_Disclaimer


  • Software Developer Guide: Provides information on features, functions, delivery package and, compile tools for the Processor SDK Linux release. This also provides detailed information regarding software elements and software infrastructure to allow developers to start creating applications.
  • Getting Started Guide: provides information on getting the software and running examples/demonstrations bundled in the SDK.
  • Software Manifest: Provides license information on software included in the SDK release. This document is in the release at [INSTALL-DIR]/docs.
  • EVM Quick Start Guide: Provides information on hardware setup and running the demonstration application that is loaded on flash. This document is provided as part of the EVM kit.

Release 04.01.00

Released Sep 2017

What's New

  • Enable RSTP (Rapid Spanning Tree Protocol)
  • Enable CC-Link Industrial Ethernet Field Basic Master and Slave
  • Promiscuous mode support on PRU Ethernet interface
  • Access PRU-ICSS from Linux user-space via ICSS EMAC LLD. See here
  • HSR/PRP (on AM57x)
    • Runtime configurability of HSR/PRP/SAN modes
    • GMAC can function as a PTP OC, either Master or Slave
    • Linux HSR/PRP node interop with TI-RTOS OS based nodes
    • PTP using CPTS for 1588 Time-stamping in Linux
  • New Demo Applications
    • EVSE demo to showcase HMI for EVSE charging stations
    • Protection Relay demo to showcase HMI for Protection Relays on AM335x
  • OpenVX: Introduce OpenVX support in Processor SDK Linux, with Vision processing kernels, and C66x offload. More details can be found here
  • OpenCL: Added support for profiling OpenCL kernels using hardware events and the AET Library

SDK Components & Versions

Component Version
Linux Kernel 4.9.41+
U-Boot 2017.01
Yocto Project 2.2 (morty)
Linaro Toolchain (gcc) 6.2.1 2016.11 hard-float
Qt 5.7.1
OpenCL 1.1.14
OpenCV 3.1
Wayland 1.11
GStreamer 1.8.3
Chromium v53

Kernel and U-boot Details

Kernel Details:

U-boot Details:

Supported Platforms

See Processor_SDK_Supported_Platforms_and_Versions for a list of supported platforms and links to more information.

Issues Tracker

Issues opened in previous releases that were closed on this release

Record ID Platform Title
LCPD-10175 am571x-idk Matrix demos doesn't display on LCD for AM571 IDK
LCPD-9967 am437x-sk No calibration screen and touchscreen un-responsive on AM4 SK
LCPD-10024 am57xx-evm devkit is not able to cross-compile binaries
LCPD-10230 all remoteproc: Fix kconfig dependency warnings on linux-next 20170627
LCPD-10228 am57xx-evm, am57xx-hsevm, am571x-idk, am572x-idk Artifacts observed while deinterlacing video
LCPD-10213 k2g-ice k2g ice: missing LCD DT nodes
LCPD-9848 am572x-idk RT: scheduling while atomic bug detected while running some real time use cases
LCPD-9854 am572x-idk RT: cpu affinity seems to eventually lead to system hang
LCPD-9984 am57xx-evm CONFIG_KEXEC is not enabled
LCPD-9353 am335x-evm BT not functional
LCPD-10227 am57xx-evm, am572x-idk, k2g-evm DSP communication errors observed while running OpenCL examples
LCPD-9295 am571x-idk DDR Speed not set 667 MHz for AM571x/AM570x
LCPD-10058 am572x-idk Board instability seen after some time, Aligment trap error reported
LCPD-9887 am43xx-gpevm, am437x-sk USB: Software role switch can lock up system
LCPD-9873 am43xx-gpevm, am43xx-hsevm, am437x-idk, am437x-sk u-boot: tps65218: Fix tps65218_voltage_update function
LCPD-9073 am57xx-evm, am57xx-hsevm, am571x-idk, am572x-idk Uboot: DFU: eMMC: u-boot.img.raw and spl-os-image.raw overlap
LCPD-9910 am43xx-epos, am43xx-gpevm, am43xx-hsevm, am437x-idk, am437x-sk [U-boot] AM43x: MMC: Implement WA for "CMD12 Command is Not Issued on Write Transfer Completion"
LCPD-10194 am57xx-evm, am57xx-hsevm, am571x-idk, am572x-idk VIDIOC_Q_BUF failure
LCPD-9840 am43xx-gpevm, am437x-idk, am437x-sk am43xx: Not all DMA events can be mapped via eDMA crossbar
LCPD-9836 am43xx-gpevm am437x: BT hcitool scan does not work when UART DMA is enabled
LCPD-9845 am572x-idk ov2659 color degradation observed sometimes after performing multiple scaled captures
LCPD-9964 k2hk-evm Uboot: Missing DT entries to work with I2C device model
LCPD-9938 omapl138-lcdk Multi Gadget cannot be supported on omapl138 due to endpoint limitation
LCPD-9747 am57xx-evm systemd sync-clocks.service starts before RTC module loads
LCPD-9820 am57xx-evm, am57xx-hsevm TX PTP does not work reliably at 100M link or when auto negotiation is turned off
LCPD-9951 am335x-evm, am335x-hsevm, am335x-ice, am335x-sk, am43xx-epos, am43xx-gpevm, am43xx-hsevm, am437x-idk, am437x-sk, am57xx-evm, am57xx-hsevm, am571x-idk, am572x-idk, beaglebone, beaglebone-black, k2g-evm, k2g-ice remoteproc: fix unbalanced ref-count with sysfs start and rmmod with no auto-boot
LCPD-10244 am57xx-evm Some OpenCL examples can not be compiled due to missing ti/sysbios/BIOS.h file
PLSDK-888 K2H, K2L, K2E MPM-TRANSPORT: mpm_mailbox test failed on K2 Platforms
PLSDK-1263 am572x-idk Offloaded HSR/PRP: Packet loss seen at firmware when running iperf
PLSDK-1390 AM3 Beagle Bone Black kmscube does not work on AM3 Beagle Bone Black
PLSDK-1406 am571x-idk Matrix demos doesn't display on LCD for AM571 IDK
PLSDK-1417 HSR: PRU Ethernet driver reports Link Up/Down frequently
PLSDK-1426 am571x-idk, am572x-idk, am572x-evm Dual Camera test fails on AM571/2 IDK and AM572x GP EVM
PLSDK-1467 omapl138-lcdk Matrix Shutdown test fails on OMAPL-138
PLSDK-1468 am572x-idk net-snmp: basic network and iec62439-3 mibs agent modules doesn't work
PLSDK-1480 am572x-idk HSR/PRP doesn work when rootfs is on SD card
PLSDK-1483 am572x-evm OpenCV initializes OpenCL context even if not required
PLSDK-1493 am335x-ice AM335x ICEv2: PRU-ETH is not up after the booting
PLSDK-1517 omapl138-lcdk Missing IPC top level build targets in OMAP-L SDK
PLSDK-1522 am570x-evm, am571x-idk, am572x-idk, am572x-evm, am572x-hsevm gstreamer file read based encoder pipeline fails
PLSDK-1569 am572x-evm PLSDK OpenVX memory allocation relies on separate DTB
PLSDK-1264 am572x-idk Offloaded HSR: firmware node_table shows incorrect values

Issued found and closed on this release that may be applicable to prior releases

Record ID Platform Title
LCPD-10375 k2g-evm, k2g-ice, k2g-hsevm sci-clk driver appears to be broken upstream
LCPD-10280 am43xx-gpevm Potential resume hang on AM437x
LCPD-10416 am335x-hsevm kernel authentication fails and board does not boot
LCPD-10418 am335x-hsevm UART boot failed on am335x-hsevm
LCPD-10314 am43xx-gpevm, am43xx-hsevm Touchwake does not work after RTC+DDR Mode.
LCPD-10250 am43xx-gpevm, am43xx-hsevm GPIO0 wake does not work after RTC+DDR Mode.
LCPD-10414 k2g-evm, k2g-ice Enable PCIe endpoint for Keystone
LCPD-10313 am335x-hsevm, am43xx-epos, am43xx-hsevm, am57xx-hsevm Cache misaligned messages seen during HS boot
LCPD-10262 k2g-evm, k2g-ice, k2g-hsevm Upstream: Fix ti-sci-clk binding
LCPD-10260 am335x-evm Pulse audio Bluez packages
LCPD-10277 am335x-hsevm AM335x HS signing scripts only encrypts SPL by default
LCPD-10276 am335x-hsevm AM335x HS EVM does not boot when JTAG is enabled in PPA
LCPD-10371 am57xx-evm, am571x-idk, am572x-idk, k2e-evm, k2g-evm, k2g-ice, k2hk-evm, k2l-evm rpmsg_proto: kernel crash when a message is received on rpmsg_proto's endpoint
PLSDK-1568 am572x-idk, am571x-idk Non-PRU Offload HSR Fails with 2 Hops

Errata Workarounds Available in this Release

Record ID Platform Title
LCPD-9084 am57xx-evm i887: Software workaround to limit mmc3 speed to 64MHz
LCPD-7642 MMC/SD: i832: return DLL to default reset state with CLK gated if not in SDR104/HS200 mode.
LCPD-5310 i900: CTRL_CORE_MMR_LOCK_5 region after locking results in ctrl module inaccessible, recoverable only post a reset
LCPD-5311 AM571x, AM572x i893: DCAN ram init issues in HW AUTO and when traffic hitting CAN bus (open investigation)
LCPD-5309 AM437x, AM571x, AM572x LCPD: i896: USB Port disable doesnt work
LCPD-976 AM571x, AM572x 32clk is psuedo (erratum i856) - clock source
LCPD-975 AM571x, AM572x 32clk is psuedo (erratum i856) - realtime counter
LCPD-1022 AM335x, AM437x, AM571x, AM572x Errata: i694: System I2C hang due to miss of Bus Clear support @ OMAP level
LCPD-9173 AM437x, AM571x, AM572x, K2E, K2G, K2HK, K2L i897: USB Stop Endpoint doesnt work in certain circumstances
LCPD-5052 Upstream: Post the dmtimer errata fix for i874
LCPD-8294 am57xx-evm 37 pins + VOUT pins need slow slew enabled for timing and reliability respectively
LCPD-8277 am57xx-evm, am57xx-hsevm, u-boot: SATA is not shutdown correctly as per errata i818
LCPD-5460 am57xx-evm, am571x-idk, am572x-idk Implement WA for Vayu errata i829 (Reusing Pipe Connected To Writeback Pipeline On The Fly To An Active Panel)
LCPD-6907 am57xx-evm Workaround errata i880 for RGMII2 is missing
LCPD-5924 AM571x, AM572x ALL: CONNECTIVITY: CPSW: errata i877 workarround for cpsw
LCPD-5836 AM571x CAL: Errata: i913: CSI2 LDO needs to be disabled when module is powered on
LCPD-4975 DSS AM5: implement WA for errata i886
LCPD-4910 AM572x errata i810 implementation
LCPD-4218 Implement Workaround for Errata i813 - Spurious Thermal Alert Generation When Temperature Remains in Expected Range
LCPD-4217 Implement Workaround for Errata i814 - Bandgap Temperature read Dtemp can be corrupted
LCPD-1146 am57xx-evm, am571x-idk, am572x-idk DMM hang: Errata VAYU-BUG02976 (i878) (register part)
LCPD-1087 AM571x, AM572x MMC: Errata: i802: OMAP5430 MMCHS: DCRC errors during tuning procedure
LCPD-4184 Implement workaround for errata i814 - Bandgap Temperature read Dtemp can be corrupted
LCPD-1108 am57xx-evm, am571x-idk, am572x-idk Wrong Access In 1D Burst For YUV4:2:0-NV12 Format (Errata i631)
LCPD-876 AM571x, AM572x Errata i810: DPLL Controller Sticks when left clock requests are removed
LCPD-4647 AM57 [rpmsg 2015 LTS] Implement errata i879 - DSP MStandby requires CD_EMU in SW_WKUP
LCPD-4648 AM57 [rpmsg 2014 LTS] Implement errata i879 - DSP MStandby requires CD_EMU in SW_WKUP
LCPD-1776 AM571x, AM572x Errata i783, SATA Lockup After SATA DPLL Unlock/Relock

Known Issues

Record ID Platform Title Workaround
LCPD-5578 beaglebone-black Exception triggered by graphics driver during boot if board does not have SGX (BBB A4) Build Processor SDK without SGX following instructions here
LCPD-7025 am43xx-gpevm System takes more than 10 seconds to go from login prompt to system prompt Automated tests need to account for this boot delay
LCPD-7161 AM335x, K2G Intermittent issue with systemd not able to allocate login console (ttyO/ttyS) Restart the EVM
LCPD-7255 All Telnet login takes too long (~40 seconds) Booting with rootfs mounted over NFS might cause ~40 seconds delay on Telnet login because DNS entries might not be properly populated. To work around this issue, enter appropriate DNS server IP in resolv.conf. For example: echo 'nameserver' > /etc/resolv.conf;
LCPD-8210 am57xx-evm, am571x-idk, am572x-idk QT Touchscreen interaction (Bear Whack) crash None
LCPD-8345 am335x-evm, am437x-idk, k2e-evm, k2e-hsevm, k2hk-evm, k2l-evm Board fails to start login console after waiting 3.5 minutes ( hard to reproduce, ~4/1000) Restart the EVM
LCPD-8352 am43xx-gpevm, am57xx-evm weston: stress testing with 75 concurrent instances of simple-egl leads to unresponsive HMI due to running out of memory 1. Restart Wayland application. 2. Restart board if Weston is killed by oom-killer
LCPD-9006 am57xx-evm Some GLBenchmark tests fail to run This is a limitation with Imagination DDK, and no workaround
LCPD-9616 am57xx-evm QtCreator GDB (remote) debugging stops working since QT5.7.1 use GDB from Processor SDK 3.2
LCPD-10533 am335x-evm, am335x-ice, am43xx-gpevm, am571x-idk, am572x-idk, am57xx-evm Cryptos: SHA1_Hash demo test fails on AM3/4/5 platforms
LCPD-10712 am571x-idk AM571x IDK: pruss1_eth is not initialized and the corresponding eth ports are not up Apply u-boot patch
PLSDK-780 AM5X Failing to create more then 10 gst pipeline using ductai codec plugins Upper limit on # of simultaneous video channels is 10.
PLSDK-832 AM57 OpenCL matmpy intermittent DSP1 crash due to EdmaMgr issues w/ suspend/resume Disable DSP suspend/resume
echo "on" > /sys/bus/platform/devices/40800000.dsp/power/control
echo "on" > /sys/bus/platform/devices/41000000.dsp/power/control
PLSDK-885 AM57 OpenCV Video test failure w/ GStreamer errors Use the workaround from PLSDK-832
PLSDK-1266 am572x-idk PRP: stale IGMP packets (IPv6) seems directly sent to eth2/eth3 of a HRP node
PLSDK-1277 k2g-ice IP address is not getting displayed on EVM LCD for K2G ICE Use ifconfig once Linux boots, to acquire ip address
PLSDK-1308 am572x-idk PRP: PRP node is shown as SAN at times in the node table dump when not offloaded No problem with offload, which is default
PLSDK-1312 k2h-evm, k2e-evm, k2l-evm QoS test fails due to missing qos-inputs-0 on K2 platforms None
PLSDK-1398 k2e-evm, k2e-hsevm Matrix IPC demo hangs, if run after OpenCL demos, on K2E platform Run IPC demo w/o running OpenCL first
PLSDK-1418 k2h-evm, k2e-evm, k2l-evm IPSEC Inflow mode not supported on 2017 LTS None
PLSDK-1419 k2l-evm Intermittent-IP address display issue on LCD for K2L RT Use ifconfig once Linux boots, to acquire ip address
PLSDK-1421 k2hk-evm SRIO is not functional on 2017 LTS None
PLSDK-1432 k2hk-evm, k2e-evm, k2l-evm,k2g-evm 10G UBoot support broken on K2, in 2017LTS None
PLSDK-1512 am571x-idk ICSS-EMAC_unittest test fails on AM571 IDK platform due to PRU1 ETH0/1 link down Apply u-boot patch
PLSDK-1556 k2hk-evm, k2hk-hsevm, k2e-evm, k2l-evm PDK: saBasicExample test shows warning as 'Alignment trap' on K2x platforms. Just a warning message. No impact to test output
PLSDK-1584 beagleboneblack AM3 Beagle Bone Black Board: weston is not up on HDMI Follow Processor_Linux_SDK_Graphics_and_Display wiki to set RGB565 (16bpp) mode and configure the display resolution if needed.

Installation and Usage

The Software Developer's Guide provides instructions on how to setup up your Linux development environment, install the SDK and start your development.  It also includes User's Guides for various Example Applications and Code Composer Studio.

Host Support

The Processor SDK is developed, built and verified on Ubuntu 14.04 and 16.04.   Details on how to create a virtual machine to load Ubuntu 14.04 are described in this page.


Processor SDK Installer is 64-bit, and installs only on 64-bit host machine. Support for 32-bit host is dropped as Linaro toolchain is available only for 64-bit machines

Technical Support and Product Updates

For further information or to report any problems, see Processor_SDK_Technical_Support


Processor SDK Linux 04.00.00
Processor SDK Linux 03.03.00
Processor SDK Linux 03.02.00
Processor SDK Linux 03.01.00
Processor SDK Linux 03.00.00
Processor SDK Linux 02.00.02
Processor SDK Linux 02.00.01
Processor SDK Linux 02.00.00
Processor SDK Linux
Processor SDK Linux
Sitara Linux SDK 08.00.00
Sitara Linux SDK 7.0X.00