2.1. Release Notes

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

  • 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 Processor SDK Linux 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.00.00

Released August 2021

What’s New

Processor SDK 8.0 Release has following new features:

  • First release on 2021 LTS 5.10 kernel, 2021.01 U-Boot

  • PRU IPC with Linux is not supported

  • AM65: ICSS-G PRUETH

  • ATF 2.5, OPTEE 3.12


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

Head Commit: 53e79d0e89f975eeb874366dd9a92f68b3a599d1 defconfigs: am65x_hs_evm: Sync HS and non-HS defconfigs
Date: Sat Jul 31 10:26:46 CDT 2021
uBoot Version: 2021.01
uBoot Description: 08.00.00.004
Clone: git://git.ti.com/ti-u-boot/ti-u-boot.git
Branch: 08.00.00.004
uBoot Tag: 08.00.00.004
Compiler Information: aarch64-none-linux-gnu-gcc (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10))

2.1.6.2. Kernel

Linux Kernel

Head Commit: 4c2eade9f722838b0e457650368cba1c6c7483c2 Merged TI feature rpmsg into ti-linux-5.10.y
Date: Fri Jul 30 11:37:10 CDT 2021
Kernel Version: 5.10.41
Kernel Description: 08.00.00.004
Clone: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-5.10.y
Tag: 08.00.00.004
Kernel defconfig: ti_sdk_arm64_release_defconfig
Compiler Information: aarch64-none-linux-gnu-gcc (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10))

Real Time (RT) Linux Kernel

Head Commit: 0701a5b58c943909a38be9df38a3b4bdd8234340 Merged TI feature ti_linux_base_rt into ti-rt-linux-5.10.y
Date: Fri Jul 30 16:42:25 CDT 2021
Kernel Version: 5.10.41
RT Kernel Version: 5.10.41-rt39<br>
Kernel Description: 08.00.00.004-rt
Clone: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-5.10.y
Tag: 08.00.00.004-rt
Kernel defconfig: ti_sdk_arm64_rt_release_defconfig
Compiler Information: aarch64-none-linux-gnu-gcc (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10))

Generic Kernel Release Notes

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

2.1.6.3. Yocto

meta-ti

Head Commit: 15f3d4a3c3773294f1cdb66a88744930941a892e ti-rtos-firmware: Add soft link to the rtos firmware binaries
Date: 2021-07-23
Version: dunfell-3.1
Clone: git://git.yoctoproject.org/meta-ti
Branch: dunfell
Release Tag: 08.00.00.004

meta-arago

Head Commit: ae47bd7fbea2776a4f8792f20c493d7959ee2f54 iproute2: upgrade to 5.10
Date: 2021-07-21
Version: 2020.05
Clone: git://git.yoctoproject.org/git/meta-arago.git
Branch: dunfell
Release Tag: 08.00.00.004

2.1.7. Issues Tracker

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

Record ID

Summary

LCPD-21334

Convert ti,j721e-gpio to yaml

LCPD-20623

AM654x UART boot failing to boot

LCPD-21536

AM654x - Display port tests fail due to tidss not found

LCPD-21297

Upstream: remoteproc/pru: Fix multiple issues in firmware event mapping

LCPD-19873

Pings not received by DUT over Ethernet VLAN

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

Record ID

Summary

LCPD-22979

firmware links are missing in /lib/firmware directory for K3

LCPD-22784

am654x-evm fails to load boot images over UART

LCPD-22914

HS EVMs fail to boot

LCPD-22304

am654x boot fails with latest baseboard dtb’s

LCPD-22300

/dev/hwrng missing on K3 platforms

LCPD-22188

j721e and am65 hs fails to build on 2021.01 uboot

LCPD-22792

EFI is disabled

LCPD-22358

U-Boot: am642/am654/j72xx: ethernet address fixup is broken

LCPD-22344

crypto: sa2ul: crypto self-tests fail to allocate des3 algos

LCPD-22342

crypto: sa2ul: Fix a number of leaks in failure paths in probe

LCPD-22318

CRYPTO_S_PERF testcases are missing CONFIG_CRYPTO_DEV_SA2UL arg in 2021.00

LCPD-22306

GFX: Fix RT kernel build failure for SGX

LCPD-22282

U-Boot: reset to default env fails in 2021 LTS

LCPD-22239

2021.00 idk and pcie dtbs are missing for am654

2.1.7.3. Errata workarounds

Record ID

Summary

Workaround

ErrataID

LCPD-17788

PCI-Express: GEN3 (8GT/s) Operation Not Supported.

i2104

LCPD-17783

USB: USB2PHY Charger Detect is enabled by default without VBUS presence

i2075

LCPD-19447

DSS: Disabling a layer connected to Overlay may result in synclost during the next frame

i2097

LCPD-14579

DSS : DSS Does Not Support YUV Pixel Data Formats

i2000

2.1.7.4. SDK Known Issues

Record ID

Summary

Workaround

LCPD-23006

PVR driver fails to detect SGX core on AM65x SR1.0

Remove graphics driver from filesystem (/lib/modules/5.10.41-g4c2eade9f7/extra/pvrsrvkm.ko)

LCPD-19948

Yocto: stream recipe is incorrect

LCPD-19858

OE: OPTEE label used in SDK is old and wrong

LCPD-18908

GLMark2 fails for am65x

LCPD-18270

Ivi shell test fails. Lib ivi-controller.so and other components are missing from the file system

LCPD-17449

libasan_preinit.o is missing in devkit

LCPD-17413

QT Webengine-based browser: the mouse does not work within the web page with QPA EGLFS

LCPD-17412

QT5 Webengine-based browser crashing with any resize operation

LCPD-13817

Qt5 Webengine-based broswer does not work on AM654x with pagesize = 64k

LCPD-13816

Chromium-wayland broswer does not work on AM654x with page size = 64k

2.1.7.5. U-Boot Known Issues

Record ID

Summary

Workaround

LCPD-22975

AM654x: 1Ghz & beyond caused boot hang on SR2.0

LCPD-17770

U-Boot: Fix order of MCU R5 shutdown depending on cluster mode

LCPD-16524

Need to adjust RMW bit when using enabling ECC

None

LCPD-14843

U-boot should support default settings for netboot

None

LCPD-16696

U-Boot does not recognize SD-Card after re-insert/change

LCPD-15873

There is no dtbo in u-boot for PCIe x1 + usb3 daughter card

None

2.1.7.6. Linux Kernel Known Issues

Record ID

Summary

Workaround

LCPD-23055

AM654x: DFU Boot fails

LCPD-17471

device hang when restarting crashed R5F

LCPD-13653

am65x-evm could not boot from MMC/SD when MMC/SD is backup boot mode

No workaround

LCPD-22962

IPC performance- IPC_S_FUNC_PRU_ECHO test failing

LCPD-16534

remoteproc/k3-r5f: PDK IPC echo_test image fails to do IPC in remoteproc mode on second run

None

LCPD-22892

icssg: due to FW bug both interfaces has to be loaded always

LCPD-19924

[AM65xx] ICSS-G TCP receive throughput degraded

LCPD-19923

[AM65x] Linux reboot command fails

https://e2e.ti.com/support/processors-group/processors/f/processors-forum/1011070/am6548-linux-reboot-command-fails

LCPD-19861

ICSSG: Unregistered multicast MAC packets are still visible in non-promiscuous mode

LCPD-19859

ETH ICSSG netperf benchmark returns lower performance than expected

LCPD-19580

am654- unable to select a mode (sdhci?)

LCPD-18665

Am65x Pg2: Board cannot do soft reboot when booting from SD card

LCPD-18289

pcie-usb tests sometimes fail

LCPD-18228

PCI PM runtime suspend is not increasing

LCPD-17908

ICSSG: dual-emac: udp packets ocassionally sent out of order on egress

LCPD-17800

CPSW: Master/Slave resolution failed message seen at console

LCPD-15540

uvc-gadget results in segmentation fault

LCPD-13938

PCIe EP read/write/copy test failed with larger sizes

LCPD-13936

Uboot dhcp timeout 1 of 100 times

LCPD-13603

One board could not boot rootfs from more than one SDHC card

LCPD-13445

Seldom kernel oops triggered by prueth_netdev_init

LCPD-22534

Ipsec aes128 TCP test failure

LCPD-19929

Industrial protocols documentation

LCPD-18860

isolcpus in the command line is not honored

LCPD-18684

syscalls sync failures: fdatasync03, fsync04, sync03, syncfs01, sync_file_range02

LCPD-18258

IPSEC perfomance failures

LCPD-17798

2020 LTS: INTA/INTR smp_affinity failure and IRQ allocation issues.

LCPD-17777

AES HW is not exercised

LCPD-17673

No software documentation for the Timer module

LCPD-16845

OPP freq update in DT impacts only cluster0

LCPD-13410

Reboot command is not operational

LCPD-22953

v4l2 cal compliance test fails

LCPD-22952

alsa_amixer_volumesetting fails

LCPD-22951

Alsa test fails - no soundcards found

LCPD-22950

Alsa speaker test fails

LCPD-22949

Audio interactive test fails

LCPD-22947

Alsa performance test fails

LCPD-18297

AM6: OV5640: 176x144 does not work

LCPD-15819

tidss: the driver should reject dual-display setup, as it is not supported

LCPD-20014

remoteproc: TX_PRU: IRQ vring, IRQ kick not found error message on console

LCPD-22931

RemoteProc documentation missing

LCPD-22959

UART Read/Write tests at baud rate 115200 fails

LCPD-23012

DRM universal planes - Could not get DRM master permission

LCPD-23009

CAL capture test- No capture device of type cal found

LCPD-23008

AM65xx - display port scenario not enabled

LCPD-23007

k3-am654-evm-hdmi.dtbo file is missing in CoreSDK for am654x

LCPD-22955

DSS scaling and cropping tests fails- kms_props not supported

LCPD-22954

DRM Stress Test fails

2.1.7.7. RT Linux Kernel Known Issues

Record ID

Summary

Workaround

LCPD-6663

[RT] Kmemleak is buggy and boot is crashed randomly

LCPD-22238

RT linux build sometimes fails to boot - might be related to remoteproc2


2.1.8. Change Requests

ID

Head Line

Original Fix Version

New Fix Version

JACINTOREQ-1431

Descope all non ETHERNET functionality inside PRU-ICSS subsystem

08.00.00

None

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


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