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 08.02.00

Released May 2022

What’s New

Processor SDK 8.2 Release has following new features:

  • 2021 LTS Update (Kernel 5.10, U-boot: 2021.01, gcc: 9.2 2019.12 hf, Yocto 3.1 (dunfell))

SDK Components & Versions

Component Version
Linux Kernel 5.10.100 (2021 LTS)
U-Boot 2021.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: 2021.01
URL: git.ti.com/ti-u-boot/ti-u-boot.git
Branch: ti-u-boot-2021.01
uBoot Tag: 08.02.00.006
Commit ID: 44a87e3ab85c6d64044f0b5ad677008316baad70

2.1.6.2. Kernel

Linux Kernel

The kernel git repository, branch and commit id can be found below:
Based on Version: 5.10.100
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-5.10.y
Tag: 08.02.00.006
Commit ID: 7a7a3af903da2b2d551d058f8262a66e6b42b6b1

Real Time (RT) Linux Kernel

The RT kernel git repository, branch and commit id can be found below:
Based on:
Kernel Version: 5.10.100
RT Kernel Version: 5.10.100-rt62
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-5.10.y
Tag: 08.02.00.006-rt
Commit ID: 204ec708dc86f4334f585f04835527570be1c4eb

Generic Kernel Release Notes

Generic kernel release notes from kernelnewbies.org can be found at: http://kernelnewbies.org/Linux_5.10
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

Record ID Platform Title
SITSW-428 am335x-evm,am335x-sk Matrix demo is not running by default
SITSW-706 am335x-evm,am335x-ice,am335x-sk,am437x-idk,am437x-sk Top level makefile broken in AM335x & AM437x

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

  • None

2.1.7.3. SDK Known Issues

Record ID Platform Title Workaround
SITSW-1357 am335x-evm,am335x-sk,am437x-sk,am43xx-gpevm Some of the Matrix QT5 demos (Touch, Thermostat, Browser) are failing  
SITSW-1358 am335x-evm,am335x-sk,am437x-sk,am43xx-gpevm Matrix KMScube demo is failing  
SITSW-1376 am335x-evm,am335x-sk,am437x-sk,am43xx-gpevm Matrix demo does not start until XFRM netlink socket initialization is complete Reload localhost URL after XFRM netlink socket initialization is completed
LCPD-28033 am335x-evm,am335x-ice,am335x-sk,am43xx-gpevm,am437x-idk,am437x-sk,beaglebone Error while running docker hello world example  
LCPD-27524 am335x-evm,am335x-sk Yocto: SRCIPK Packaging Build Failures for Kernel/U-Boot  
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-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-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-26694 am335x-ice,am437x-idk AM335x/AM437x PRU Ethernet slowdown from kernel 4.19 -> 5.4/5.10        
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-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