2.1. Release Notes for AM335X

2.1.1. Overview

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

2.1.2. Licensing

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 PLSDK GPLv3 Disclaimer.

2.1.3. Documentation

  • Processor SDK Linux Software Developer’s 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.
  • Processor SDK Linux 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.

2.1.4. Release 07.03.00

Released June 2021

What’s New

Processor SDK 7.3 Release has following new features:

  • 2020 LTS Update (Kernel 5.4, U-boot: 2020.01, gcc: 9.2 2019.12 hf, Yocto 3.1 (dunfell))

  • PRUSS HW UART Support
    • Up to 12M baud rate
    • Hardware flow control support
  • HSR/PRP with PRU-ICSS firmware offload support has been descoped

  • ICSS-EMAC support has been descoped

  • SORTE support has been descoped

SDK Components & Versions

Component Version
Linux Kernel 5.4.106 (2020 LTS)
U-Boot 2020.01
Yocto Project 3.1 (dunfell)
ARM Toolchain (gcc) 9.2 2019.12 hard-float
Qt 5.14.2
OpenCL 1.2.00.02
OpenCV 4.1.0
Wayland 1.18
GStreamer 1.16.3
TI PRU Compiler 2.3.2
TI C66x CGT Compiler 8.3.2

2.1.5. Supported Platforms

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


2.1.6. Build Information

2.1.6.1. U-Boot

The U-Boot git repository, branch and commit id can be found below:
Based on verson: 2020.01
URL: git.ti.com/ti-u-boot/ti-u-boot.git
Branch: ti-u-boot-2020.01
Commit ID: 2781231a33c3d779e32445f4fe55164c45d6d7c1

2.1.6.2. Kernel

Linux Kernel

The kernel git repository, branch and commit id can be found below:
Based on Version: 5.4.106
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-5.4.y
Commit ID: 023faefa70274929bff92dc41167b007f7523792

Real Time (RT) Linux Kernel

The RT kernel git repository, branch and commit id can be found below:
Based on:
Kernel Version: 5.4.106
RT Kernel Version: 5.4.106-rt54
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-5.4.y
Commit ID: 519667b0d81d74a6e55105dcd6072ae550352599

Generic Kernel Release Notes

Generic kernel release notes from kernelnewbies.org can be found at: http://kernelnewbies.org/Linux_5.4
Archived versions can be found at: http://kernelnewbies.org/LinuxVersions

2.1.7. Issues Tracker

2.1.7.1. Issues opened in previous releases that were closed on this release

  • None

2.1.7.2. Issues found and closed on this release that may be applicable to prior releases

Record ID Platform Title
LCPD-20209 am335x-evm cpsw: dual_mac: kernel crash when DT “”slaves=<1>”“

2.1.7.3. SDK Known Issues

Record ID Platform Title Workaround
SITSW-428 am335x-evm,am335x-sk Matrix demo is not running by default Restart the Matrix demo manually after boot
SITSW-429 am335x-ice Kernel crash while running docker hello-world example  
LCPD-20148 am335x-evm am335x-evm: Yocto recipe in meta-processor-sdk needs to be fixed for origin reference  
LCPD-19858 am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk,am571x-idk,am572x-idk,am574x-idk,am574x-hsidk,am57xx-evm,am57xx-beagle-x15,am57xx-hsevm,am64xx-evm,am64xx-vlab,am64xx-zebu,am654x-evm,am654x-idk,am654x-hsevm,beaglebone,bbai,beaglebone-black,dra71x-evm,dra71x-hsevm,dra72x-evm,dra72x-hsevm,dra76x-evm,dra76x-hsevm,dra7xx-evm,dra7xx-hsevm,j721e-evm,j721e-hsevm,j721e-evm-ivi,j721e-idk-gw,j7200-evm,j7200-hsevm,k2e-evm,k2e-hsevm,k2g-evm,k2g-hsevm,k2g-ice,k2hk-evm,k2hk-hsevm,k2l-evm,k2l-hsevm OE: OPTEE label used in SDK is old and wrong  
LCPD-19279 am335x-evm,am43xx-gpevm openssl_perf.sh functionality to be included in rootfs (decouple from matrixgui)  
LCPD-18270 am335x-evm,am43xx-gpevm,am571x-idk,am572x-idk,am574x-idk,am57xx-evm,am57xx-beagle-x15,am654x-evm,am654x-idk,dra71x-evm,dra72x-evm,dra76x-evm,dra7xx-evm,j721e-evm,j721e-evm-ivi,j721e-idk-gw Ivi shell test fails. Lib ivi-controller.so and other components are missing from the file system  
LCPD-17817 am335x-hsevm,am43xx-epos,am43xx-hsevm,k2e-hsevm,k2g-hsevm,k2hk-hsevm,k2l-hsevm Images created with Proc-SECDEV grow with number of times SECDEV has been used  
LCPD-17449 am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk,am571x-idk,am572x-idk,am574x-idk,am574x-hsidk,am57xx-evm,am57xx-beagle-x15,am57xx-hsevm,am654x-evm,am654x-idk,am654x-hsevm,beaglebone,beaglebone-black,dra71x-evm,dra71x-hsevm,dra72x-evm,dra72x-hsevm,dra76x-evm,dra76x-hsevm,dra7xx-evm,dra7xx-hsevm libasan_preinit.o is missing in devkit  
LCPD-17413 am335x-evm,am43xx-gpevm,am57xx-evm,am654x-evm QT Webengine-based browser: the mouse does not work within the web page with QPA EGLFS  
LCPD-17164 am335x-evm,am571x-idk,am574x-idk,am57xx-evm,dra71x-evm,dra7xx-evm GLBenchmark is not able to run missing libgbm.so.2 error reported create a symlink for linker file
LCPD-16114 am335x-evm,am335x-ice,am335x-sk RTC Init Script Needs to Wait for Module Load  
LCPD-15810 am335x-evm,am43xx-gpevm,k2g-evm Illegal instruction reported when trying to decode h264 stream with gstreamer None
LCPD-15367 am335x-evm,am574x-idk Boot time increased about 15s  
LCPD-13947 am335x-evm nativesdk-opkg is broken in the devkit  
LCPD-12405 am335x-evm,am335x-ice,am43xx-epos,am43xx-gpevm,am57xx-evm,dra71x-evm,k2e-evm,k2e-hsevm,k2g-evm,k2g-hsevm,k2l-evm Openssl certgen fails due to coredump in openssl_gen_cert.sh  

2.1.7.4. U-Boot Known Issues

Record ID Platform Title Workaround
LCPD-19133 am335x-evm,am335x-hsevm,am335x-ice,am335x-sk Netconsole output corrupted when CONFIG_NETCONSOLE_BUFFER_SIZE >= 281  
LCPD-18643 am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk U-Boot: AM335x/AM473x: Both SPI CS signals get asserted  
LCPD-7366 am335x-evm uboot McSPI driver drives multiple chip selects simultaneously None

2.1.7.5. Linux Kernel Known Issues

Record ID Priority Title Component Subcomponent Platform Workaround
LCPD-22355 P5-Not Prioritized Update PHY latency values in SDK documentation Connectivity   am335x-ice,am437x-idk,am571x-idk,am572x-idk,am574x-idk  
LCPD-19757 P3-Medium OpenSSL DES performance numbers are lower in 07.01 Baseport,System Test   am335x-evm  
LCPD-19703 P3-Medium suspicious RCU usage wkup_m3_prepare_low_power on am335x-evm: 20201002 Baseport   am335x-evm  
LCPD-19702 P3-Medium crypto algapi failure on am335x-evm: 20201002 Baseport   am335x-evm,am437x-sk  
LCPD-19660 P4-Low Remove unused definitions and related code for SV frame MAC address Connectivity   am335x-ice,am437x-idk,am571x-idk,am572x-idk,am574x-idk  
LCPD-19262 P3-Medium Uboot: usb ethernet boot does not work on am335x-evm Connectivity   am335x-evm  
LCPD-17673 P3-Medium No software documentation for the Timer module Baseport Timers am335x-evm,am43xx-gpevm,am571x-idk,am572x-idk,am574x-idk,am57xx-evm,am654x-evm,beaglebone-black,dra71x-evm,dra72x-evm,dra7xx-evm,j721e-evm  
LCPD-16437 P4-Low Nand with prefetch dma: read perf drop ~20% comparing to 2018 Connectivity   am335x-evm  
LCPD-15787 P3-Medium Power suspend fails due to USB (scsi_bus_suspend) failure when HDD is in use Connectivity   am335x-evm  
LCPD-15648 P4-Low Uboot mmc write performance decreased Connectivity   am335x-evm  
LCPD-14855 P3-Medium omap_i2c_prepare_recovery() function can Lock System Connectivity I2C am335x-evm,am335x-ice,am335x-sk  
LCPD-14191 P3-Medium IPSec hardware-based throughput is 30% lower than 2018.03 Baseport   am335x-evm,am57xx-evm  
LCPD-13720 P3-Medium SPI DMA TX Mode Halts During Continuous 16/32/64 bit Transfers Connectivity   beaglebone-black  
LCPD-12392 P4-Low USBhost video: higher resolution tests fail with some cameras Connectivity   am335x-evm  
LCPD-10221 P3-Medium Longer resume times observed on setup with usb device cable Connectivity USB am335x-evm  
LCPD-1245 P3-Medium AM335x: Power: Reverse current leakage on poweroff Power & Thermal   am335x-evm  
LCPD-1191 P4-Low AM335x: Power: System resumes due to wakeup source USB1_PHY without any external trigger Power & Thermal   am335x-evm Use GPIO interrupt instead of USB PHY for wakeup source.
LCPD-998 P4-Low MUSB does not free urbs causing usb audio playback to fail Connectivity   AM335x  

2.1.7.6. RT Linux Kernel Known Issues

  • None

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 16.04 and 18.04. Details on how to create a virtual machine to load Ubuntu are described in this page.

Note

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