2.1. Release Notes for AM437X

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 09.01.00

Released Oct 2023

What’s New

Note

Generic PRU-ICSS Ethernet is descoped in 09.01.00 release.

Processor SDK 9.1 Release has following new features:

  • 2023 LTS Refresh with Stable Kernel 6.1, U-boot 2023.04, Yocto Kirkstone 4.0

SDK Components & Versions

Component

Version

Linux Kernel

6.1 (2023 LTS)

U-Boot

2023.04

Yocto Project

4.0 (kirkstone)

ARM Toolchain (gcc)

11.4


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 version: 2023.04
URL: git.ti.com/ti-u-boot/ti-u-boot.git
Branch: ti-u-boot-2023.04
uBoot Tag: 09.01.00.001

2.1.6.2. Kernel

Linux Kernel

The kernel git repository, branch and commit id can be found below:
Based on Version: 6.1
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-6.1.y
Tag: 09.01.00.001

Real Time (RT) Linux Kernel

The RT kernel git repository, branch and commit id can be found below:
Based on Kernel Version: 6.1
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-6.1.y
Tag: 09.01.00.001-rt

Generic Kernel Release Notes

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

2.1.6.3. Yocto

meta-ti

Head Commit: 59edb4e886df468edeb683355c36f06004b29925 linux-ti-staging_6.1: CI/CD Auto-Merger: cicd.kirkstone.202310191725
Date: 2023-10-20 08:11:47 -0500
Clone: git://git.yoctoproject.org/meta-ti
Branch: kirkstone
Release Tag: 09.01.00.001

meta-arago

Head Commit: a9dcc0583f44bd7a7d8780759c2091b85d280ec2 ltp-ddt: CI/CD Auto-Merger: cicd.kirkstone.202310191725
Date: 2023-10-20 08:11:26 -0500
Clone: git://git.yoctoproject.org/meta-arago
Branch: kirkstone
Release Tag: 09.01.00.001

meta-processor-sdk

Head Commit: 3cbe955ce03d9c25e59e3a401f378132163a3569 recipes-core: matrix: Handle systemd and sysvinit scripts separately
Date: 2023-10-31 03:48:05 -0500
Branch: kirkstone
Release Tag: 09.01.00.001

2.1.7. Issues Tracker

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

Record ID

Title

Platform

SITSW-706

Top level makefile broken in AM335x & AM437x

am437x-idk,am437x-sk

LCPD-25313

HDMI Audio playback tests are failing for all the frequencies

am43xx-gpevm

LCPD-25277

NAND rootfs as ubifs mount, read, write and delete test Fails

am43xx-gpevm

LCPD-24853

USBDEV msc_mmc g_mass_storage.ko module not available

am43xx-gpevm

LCPD-24826

Power Manager Runtime is not suspending SERIAL

am43xx-gpevm

LCPD-24820

HW SHA crypto acceleration error getting irq for crypto

am43xx-gpevm

LCPD-24811

LTP test fail- No Timers

am43xx-gpevm

LCPD-24239

IPC performance test

am43xx-gpevm

LCPD-23019

OPTEE tests are failing (Impact 5)

am43xx-hsevm

LCPD-22828

Convert tps62360-regulator.txt: “ti,tps62363” to yaml

am437x-idk

LCPD-21523

alpha blending test failure

am43xx-gpevm

LCPD-20673

packaging: ipsec: command not found

am43xx-gpevm

LCPD-19858

OE: OPTEE label used in SDK is old and wrong

am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk

LCPD-19838

Cryptodev not building against 5.10 kernel

am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk

LCPD-19279

openssl_perf.sh functionality to be included in rootfs (decouple from matrixgui)

am43xx-gpevm

LCPD-18643

U-Boot: AM335x/AM473x: Both SPI CS signals get asserted

am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk

LCPD-17817

Images created with Proc-SECDEV grow with number of times SECDEV has been used

am43xx-hsevm

LCPD-7025

System takes more than 10 seconds to go from login prompt to system prompt

am43xx-gpevm


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

Record ID

Title

Platform

SITSW-3404

installer-scripts: Version not auto updated for installer

am437x-idk,am437x-sk,am43xx-gpevm,am43xx-hsevm

SITSW-3378

systemd-networkd-wait-online service timeouts

am437x-idk,am437x-sk,am43xx-gpevm,am43xx-hsevm

SITSW-1649

Create-sdcard.sh: Displays command not found error

am437x-sk,am43xx-gpevm,am43xx-hsevm

LCPD-36626

am335x: am43xx: Display and Touchscreen is not functional

am43xx-gpevm,am43xx-hsevm

LCPD-34652

AM437x: Failing POWERMGR_S_FUNC_CPUFREQ_BASIC test

am43xx-gpevm,am43xx-hsevm,am437x-sk

LCPD-29650

AM437x: kernel init routine execution time regression

am43xx-gpevm

LCPD-26692

Hardware + Software IPSec Performance Test Failures

am43xx-gpevm


2.1.7.3. U-Boot Known Issues


2.1.7.4. Linux Kernel Known Issues

Record ID

Platform

Title

Workaround

LCPD-26730

am43xx-gpevm

Stack Exception observed while modetest command in HDMI tests

LCPD-25498

am43xx-gpevm

Test to validate poweroff voltage on all voltage domains fails

LCPD-25272

am43xx-gpevm

Crypto_M_PERF_openssl_perf_software test Fails

LCPD-24728

am43xx-gpevm

Power measurement with Standby/Suspend/Resume failure

LCPD-24650

am43xx-gpevm

VPFE sensor capture fails

LCPD-24505

am43xx-gpevm

KMS properties test failed

LCPD-24456

am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk

Move IPC validation source from github to git.ti.com

LCPD-24302

am43xx-gpevm

The speed test built in to OpenSSL - cryptographic

LCPD-24182

am43xx-gpevm

Powermgr_xs_func_simple_suspend/standby resume tests

LCPD-17673

am43xx-gpevm

No software documentation for the Timer module

LCPD-17449

am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk

libasan_preinit.o is missing in devkit

LCPD-10974

am43xx-gpevm

am43xx-gpevm - usb camera gadget shows halting frames

None

LCPD-9254

am43xx-hsevm

Kernel warnings in boot for am437x-hsevm

LCPD-7955

am43xx-gpevm

Uncorrectable Bitflip errors seen after switch to SystemD

Workaround to erase the NAND flash completely if flashed with an incompatible flash writer. SystemD tries to mount all partitions and that is the reason this is being seen now.

LCPD-1207

am43xx-gpevm

AM43XX/AM57XX/DRA7: CONNECTIVITY: dwc3_omap on am43xx and xhci_plat_hcd on dra7 - removal results in segmentation fault


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