2.1. Release Notes

2.1.1. Overview

The Processor Software Development Kit (Processor SDK) is a unified software platform for TI embedded processors providing easy setup and fast out-of-the-box access to benchmarks and demos. All releases of Processor SDK are consistent across TI’s broad portfolio, allowing developers to seamlessly reuse and develop software across devices. Developing a scalable platform solutions has never been easier than with the Processor SDK and TI’s embedded processor solutions.

To simplify the end user experience, Processor SDK Linux AM62x installer provides everything needed as discussed below to create the embedded system from “scratch” :

  • Platform/board-support software and configuration files for Linux
  • U-Boot and Kernel sources and configuration files
  • An ARM cross-compiling toolchain as well as other host binaries and components
  • A Yocto/OE compliant filesystem and sources for example applications
  • A variety of scripts and Makefiles to automate certain tasks
  • Other components needed to build an embedded system that don’t fit neatly into one of the above buckets
  • Reference Examples, benchmarks

This release supports High Security - Field Securable (HS-FS) devices. For migration guide and other info, refer GP to HS-FS Migration Guide

2.1.2. Licensing

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

  • Linux Manifest: “/docs/software_manifest.html”

2.1.3. Release 09.00.00

Released on July 2023

2.1.3.1. What’s new

Processor SDK Linux AM62x Release has following new features:

  • New improved OOB experience
  • Jailhouse Hypervisor with various use-cases
  • SEVA store (Demo store/Apps Gallery)
  • Debian distribution
  • Kirkstone filesystem on Yocto based distribution
  • Binman Migration across all K3 platforms for Uboot builds
  • HS-FS Default Boot Experience for AM62x
  • A53 Early Splash-Screen
  • Low Power: Deep Sleep on HS-FS, MCU Only mode and more wakeup sources

Major Refresh of component version:

  • Kernel 6.1
  • U-Boot 2023.04
  • Toolchain GCC 11.2
  • ATF 2.8+
  • OPTEE 3.20
  • Graphics DDK 23.1

2.1.4. Build Information

2.1.4.1. U-Boot

u-boot

Head Commit: 24098ea90dbaac7b16958e2f7d9f7a412ef1522a configs: am64: Fix booting of fitImage on AM64x”
Date: 2023-07-07 08:52:25 -0500
uBoot Version: 2023.04
uBoot Description: 09.00.00.006
Clone: git://git.ti.com/ti-u-boot/ti-u-boot.git
Branch: ti-u-boot-2023.04
uBoot Tag: 09.00.00.006
Compiler Information:
- arm-gnu-toolchain-11.3.rel1-x86_64-aarch64-none-linux-gnu
- arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-linux-gnueabihf

2.1.4.2. Kernel

Linux Kernel

Head Commit: 40c32565ca0e213fb653570cc618408ee8e9c6cf arm64: dts: ti: k3-am64-main: Add ITAP delay values in Device Tree
Date: 2023-07-07 08:51:44 -0500
Kernel Version: 6.1.33
Kernel Description: 09.00.00.006
Repo: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-6.1.y
Tag: 09.00.00.006
use-kernel-config=defconfig
config-fragment=kernel/configs/ti_arm64_prune.config
Compiler Information:
- arm-gnu-toolchain-11.3.rel1-x86_64-aarch64-none-linux-gnu
- arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-linux-gnueabihf

Real Time (RT) Linux Kernel

Head Commit: 685e77152461bd6b791500f717bec62d17c1b36d Merge branch ‘ti-linux-6.1.y-cicd’ of git://git.ti.com/ti-linux-kernel/ti-linux-kernel into ti-rt-linux-6.1.y-cicd
Date: 2023-07-07 08:51:50 -0500
Kernel Version: 6.1.33-rt11
Kernel Description: 09.00.00.006-rt
Repo: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-6.1.y
Tag: 09.00.00.006-rt
use-kernel-config=defconfig
config-fragment=kernel/configs/ti_arm64_prune.config kernel/configs/ti_rt.config
Compiler Information:
- arm-gnu-toolchain-11.3.rel1-x86_64-aarch64-none-linux-gnu
- arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-linux-gnueabihf

2.1.4.3. Yocto

meta-ti

Head Commit: 2e3ffb73630f4ff78227822bdb4c23e75a720223 linux-ti-staging_6.1: CI/CD Auto-Merger: cicd.kirkstone.202307061739
Date: 2023-07-07 08:52:30 -0500
Clone: git://git.yoctoproject.org/meta-ti
Branch: kirkstone
Release Tag: 09.00.00.006

meta-arago

Head Commit: e1d3561ec681fd05509affa063e0d6212f1571d1 ltp-ddt: CI/CD Auto-Merger: cicd.kirkstone.202307061739
Date: 2023-07-07 08:51:10 -0500
Clone: git://git.yoctoproject.org/meta-arago
Branch: kirkstone
Release Tag: 09.00.00.006

2.1.5. Issues Tracker

2.1.5.1. Issues opened in previous releases that were closed in this release

Record ID Platform Title Workaround
LCPD-32790 am62axx_sk-fs AM62A: VPU: Module load/unload in loop fails after bootup  
LCPD-30075 am62axx_sk-fs,am62axx_sk-se AM62ax: Enable distro bootcommand  
LCPD-29949 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,j721e-idk-gw [PROD STOP]I2c operations at 100KHz is broken  
LCPD-29792 am62xx-sk,am62xx_sk-fs,am62xx_sk-se am62x: mcspi not functional  
LCPD-29589 am62axx_sk-fs,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x CPSW: PPS example not enabled by default  
LCPD-29441 am62xx-sk,am62xx_sk-fs,am62xx_sk-se am62x: kingston emmc fails on AM62x  
LCPD-29339 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Processor SDK 8.3 AM62x lacks RT Linux performance numbers  
LCPD-29300 am62xx-sk,am62xx_sk-fs,am62xx_sk-se U-Boot: OSPI-NOR: sf probe shows 0 randomly  
LCPD-28950 am62axx_sk-fs CSI2 Multi-capture channel 0 not working  
LCPD-28764 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x: Cannot resume from low power mode  
LCPD-28688 am62axx_sk-fs,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx-sk,am62xx_sk-fs,am62xx_sk-se,am64xx-evm,am64xx-sk AM62x Kernel User Guide: Document AM62x default kernel config  
LCPD-28614 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x: RPMsg client driver sample does not work  
LCPD-28415 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62: emmc: Had to disable higherspeeds  
LCPD-28414 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x EVM Devicetree should disable unused MCU peripherals  
LCPD-25662 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,j721e-evm,j7200-evm Remove SGX PVR tools from KS3 devices  
LCPD-24691 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,am64xx-evm,j721s2-evm,j721s2_evm-fs,j7200-evm Kernel: Upstream: Set HIGH_SPEED_EN for MMC1 instance  
LCPD-24690 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,am64xx-evm,am64xx-sk,j721s2-evm,j721s2_evm-fs,j7200-evm Kernel: SDK: Set HIGH_SPEED_EN for MMC1 instance  

2.1.5.2. Issues found and closed in this release that may also be applicable to prior releases

Record ID Platform Title Workaround
LCPD-34980 am62axx_sk-fs Serial Nand flash is not discovered from uboot and kernel  
LCPD-34976 am62axx_sk-se AM62a: HS-SE : Fails to boot : Firewall Exception  
LCPD-34967 am62axx_sk-fs AM62a: SD Boot fails with warning “alloc space exhausted”  
LCPD-34966 am62axx_sk-fs,am62xx-lp-sk,am62xx-sk,am62xx_sk-fs,am64xx-evm,am64xx-sk,j721e-evm-ivi,j721e-idk-gw,j721e-sk,j721s2-evm,j784s4-evm rpmsg_ctrl device mapping errors see with 6.1 kernel  
LCPD-34896 am62xx_lp_sk-fs AM62x-LP: RT Kernel fails to boot due to PRU  
LCPD-34852 am62xx_sk-se,am64xx-evm,am654x-evm,j721e-idk-gw,j721s2-evm,j7200-evm Few times payload is packed at size boundary by binman  
LCPD-34836 am62xx_lp_sk-fs AM62-lp-sk: USB Audio device missing in test farm  
LCPD-34686 am62axx_sk-fs,am64xx-evm MMC itapdly sel values are not specified in uboot DTS  
LCPD-34593 am62axx_sk-fs,am62xx-sk,am62xx_sk-fs,am64xx-evm,am64xx-hsevm,am654x-evm,am654x-idk,am654x-hsevm,beagleplay-gp DISTRO BOOT: Not enabled on all Sitara Platforms  
LCPD-34519 am62axx_sk-fs,am62xx-sk,am68_sk-fs,j721e-idk-gw,j721s2-evm,j7200-evm,j784s4-evm IPC: IPC_S_FUNC_RPMSG_SAMPLE_CLIENT test failures  
LCPD-34378 am62xx_lp_sk-fs U-Boot: AM62x document SRAM layout  
LCPD-34354 am62xx-sk,am62xx_sk-fs Doc: Power Management Arch: Board name misspelled  
LCPD-34301 am62axx_sk-fs,am62xx-lp-sk,am62xx-sk Enabling clock output on AUDIO_EXT_REFCLK1 pin  
LCPD-34131 am62xx_sk-fs AM62: Boot inconsistencies on HS FS  
LCPD-32945 am62xx-lp-sk,am62xx_lp_sk-fs,am62xx-sk,am62xx_sk-fs AM62x USB-DFU Boot is broken in R5 SPL  

2.1.5.3. Errata Workarounds Available in this Release

Record ID Platform Title Workaround
LCPD-27887 am62xx-sk,am62xx_sk-fs i2327: RTC: Hardware wakeup event limitation None
LCPD-27886 am62axx_sk-fs,am62xx-sk,am64xx-evm,j721e-idk-gw,j7200-evm,j784s4-evm,j784s4-hsevm USART: Erroneous clear/trigger of timeout interrupt  

2.1.5.4. U-Boot Known Issues

Record ID Platform Title Workaround
LCPD-34929 am62axx_sk-fs Remoteproc load of C7x from U-boot fails on 9.0 RC3  
LCPD-34398 am62axx_sk-fs Uboot: AM62a boot reporting wrong SOC name  
LCPD-28503 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,am64xx-evm,am64xx-sk Need to sync up DTS files between u-boot and kernel for at least AM62x, possibly other boards too  

2.1.5.5. Linux Kernel Known Issues

Record ID Platform Title Workaround
LCPD-35056 am62xx-sk,am62xx_sk-fs,am62xx_sk-se ‘Error: “main_cpsw0_qsgmii_phyinit” not defined’ on AM62x  
LCPD-35055 am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-se ERROR: reserving fdt memory region failed on AM62x  
LCPD-35054 am62xx_lp_sk-fs,am62xx_lp_sk-se AM62x LP fitImage boot issue with Yocto images
On fs : boot non fit image and this is set as default in u-boot
LCPD-35043 am62axx_sk-fs Doc: VPU performance and capabilities shown incorrectly for AM62Ax  
LCPD-35042 am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se Linux: AM62x: OSPI NOR Flash read speed is low (~2.5MBPS)  
LCPD-35025 am62xx_sk-fs Test gap: Implement automated test for Driver suspend resume  
LCPD-35007 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x: ip adress not assigned by default on AM62x  
LCPD-34991 am62axx_sk-fs systemd failure with vmalloc overflow error when using fitimage  
LCPD-34978 am62xx-sk,am62xx_sk-fs AM62x: High tiny-image cpio file size  
LCPD-34916 am62xx-sk,am62xx_sk-fs AM62x: op-tee with LOG_LEVEL=2 crashes after Deep Sleep  
LCPD-34915 am62xx-sk,am62xx_sk-fs AM62x: op-tee with HW TRNG crashes after Deep Sleep  
LCPD-34912 am62axx_sk-fs,am62axx_sk-hs4,am62axx_sk-hs5,am62axx_sk-se,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se AM62/AM62Ax: DM does not set correct pixel clock  
LCPD-34901 am62xx-sk,am62xx_sk-fs AM62: Reset button fails to reset AM625-SK-EVM after wakeup from deep sleep  
LCPD-34898 am62xx-sk,am62xx_sk-fs AM62x: MCU Only mode: Linux console lockup after ~100 suspend resume cycles  
LCPD-34835 am62axx_sk-fs,am62xx-lp-sk,am62xx-sk,beagleplay-gp am62/am62a: Add CTRL MMR support for DPI signals on negative edge  
LCPD-34833 am62xx-sk,am62xx_sk-fs AM62: Wi-Fi not functional after 6.1/kirkstone migration  
LCPD-34816 am62xx-sk,am62xx_sk-fs rtcwake fails after resuming from Deep Sleep  
LCPD-34813 am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se SK-AM62B: Flood of tps6598x_interrupt failed to read events  
LCPD-34755 am62axx_sk-fs am62a: HDMI related crashes  
LCPD-34693 am62axx_sk-fs,am62xx-sk,am62xx_sk-fs am62: CPSW TCP bidir tests fail  
LCPD-34531 am62axx_sk-fs,am654x-evm AM62a: eMMC LTP tests failure  
LCPD-34397 am62xx-sk usb xhci locks up after multiple Linux reboot  
LCPD-34360 am62axx_sk-fs Display distorted above certain resolution  
LCPD-34242 am62xx-sk,am62xx_sk-fs,am68_sk-fs,j721s2-evm,j7200-evm,j784s4-evm GPIO_S_FUNC_DIR_IN_ALL_BANK unit test fails  
LCPD-34105 am62axx_sk-fs,am62axx_sk-hs4,am62axx_sk-hs5,am62axx_sk-se,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se convert uboot’s MDIO driver over to use the driver model  
LCPD-32706 am62xx-sk,am62xx_sk-fs Display: DRM tests fail inconsistently  
LCPD-32351 am62xx-sk,am62xx_sk-fs,am62xx_sk-se MMCSD: HS200 and SDR104 Command Timeout Window Too Small If the command requires a timeout longer than 700ms, then the MMC host controller command timeout can be disabled (MMCSD_CON[6] MIT=0x1) and a software implementation may be used in its place.
LCPD-28742 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x: Make “Debugging SPL” doc specific to AM62x  
LCPD-28491 am62xx-sk,am62xx_sk-fs,am62xx_sk-se WiLink not functional with fw_devlink option set to on  
LCPD-28448 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Wall time does not account for sleep time  
LCPD-28105 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Automated test failure - CPSW failure doing runtime pm  
LCPD-28104 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Automated test failure - CPSW test is passing invalid parameters to switch-config  
LCPD-25563 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Test: AM62: Linux: Add support for MCAN  
LCPD-22715 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,j721e-idk-gw,j721s2-evm,j721s2_evm-fs,j7200-evm i2232: DDR: Controller postpones more than allowed refreshes after frequency change Workaround 1: Disable dynamic frequency change by programing DFS_ENABLE
LCPD-22319 am62axx_sk-fs,am62xx-sk,am64xx-evm,j721e-idk-gw,j721s2-evm,j7200-evm,j784s4-evm OpenSSL performance test data out of bounds  

2.1.5.6. Linux RT Kernel Known Issues

Record ID Platform Title Workaround
LCPD-35056 am62xx-sk,am62xx_sk-fs,am62xx_sk-se ‘Error: “main_cpsw0_qsgmii_phyinit” not defined’ on AM62x  
LCPD-35055 am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-se ERROR: reserving fdt memory region failed on AM62x  
LCPD-35054 am62xx_lp_sk-fs,am62xx_lp_sk-se AM62x LP fitImage boot issue with Yocto images
On fs : boot non fit image and this is set as default in u-boot
LCPD-35043 am62axx_sk-fs Doc: VPU performance and capabilities shown incorrectly for AM62Ax  
LCPD-35042 am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se Linux: AM62x: OSPI NOR Flash read speed is low (~2.5MBPS)  
LCPD-35025 am62xx_sk-fs Test gap: Implement automated test for Driver suspend resume  
LCPD-34991 am62axx_sk-fs systemd failure with vmalloc overflow error when using fitimage  
LCPD-34978 am62xx-sk,am62xx_sk-fs AM62x: High tiny-image cpio file size  
LCPD-34916 am62xx-sk,am62xx_sk-fs AM62x: op-tee with LOG_LEVEL=2 crashes after Deep Sleep  
LCPD-34915 am62xx-sk,am62xx_sk-fs AM62x: op-tee with HW TRNG crashes after Deep Sleep  
LCPD-34912 am62axx_sk-fs,am62axx_sk-hs4,am62axx_sk-hs5,am62axx_sk-se,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se AM62/AM62Ax: DM does not set correct pixel clock  
LCPD-34901 am62xx-sk,am62xx_sk-fs AM62: Reset button fails to reset AM625-SK-EVM after wakeup from deep sleep  
LCPD-34898 am62xx-sk,am62xx_sk-fs AM62x: MCU Only mode: Linux console lockup after ~100 suspend resume cycles  
LCPD-34897 am62xx_lp_sk-fs AM62x-LP: USB failures  
LCPD-34835 am62axx_sk-fs,am62xx-lp-sk,am62xx-sk,beagleplay-gp am62/am62a: Add CTRL MMR support for DPI signals on negative edge  
LCPD-34833 am62xx-sk,am62xx_sk-fs AM62: Wi-Fi not functional after 6.1/kirkstone migration  
LCPD-34816 am62xx-sk,am62xx_sk-fs rtcwake fails after resuming from Deep Sleep  
LCPD-34813 am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se SK-AM62B: Flood of tps6598x_interrupt failed to read events  
LCPD-34755 am62axx_sk-fs am62a: HDMI related crashes  
LCPD-34693 am62axx_sk-fs,am62xx-sk,am62xx_sk-fs am62: CPSW TCP bidir tests fail  
LCPD-34531 am62axx_sk-fs,am654x-evm AM62a: eMMC LTP tests failure  
LCPD-34516 am62xx-sk,am62xx_sk-fs,j721s2-evm,j7200-evm,j784s4-evm USBHOST Audio ltp unit test fails  
LCPD-34360 am62axx_sk-fs Display distorted above certain resolution  
LCPD-34242 am62xx-sk,am62xx_sk-fs,am68_sk-fs,j721s2-evm,j7200-evm,j784s4-evm GPIO_S_FUNC_DIR_IN_ALL_BANK unit test fails  
LCPD-34105 am62axx_sk-fs,am62axx_sk-hs4,am62axx_sk-hs5,am62axx_sk-se,am62xx-lp-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx-sk,am62xx_sk-fs,am62xx_sk-hs4,am62xx_sk-hs5,am62xx_sk-se convert uboot’s MDIO driver over to use the driver model  
LCPD-32706 am62xx-sk,am62xx_sk-fs Display: DRM tests fail inconsistently  
LCPD-32351 am62xx-sk,am62xx_sk-fs,am62xx_sk-se MMCSD: HS200 and SDR104 Command Timeout Window Too Small If the command requires a timeout longer than 700ms, then the MMC host controller command timeout can be disabled (MMCSD_CON[6] MIT=0x1) and a software implementation may be used in its place
LCPD-29332 am62xx-sk,am62xx_sk-fs,am62xx_sk-se LPM Demo not Working on Linux RT  
LCPD-28742 am62xx-sk,am62xx_sk-fs,am62xx_sk-se AM62x: Make “Debugging SPL” doc specific to AM62x  
LCPD-28491 am62xx-sk,am62xx_sk-fs,am62xx_sk-se WiLink not functional with fw_devlink option set to on  
LCPD-28448 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Wall time does not account for sleep time  
LCPD-28105 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Automated test failure - CPSW failure doing runtime pm  
LCPD-28104 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Automated test failure - CPSW test is passing invalid parameters to switch-config  
LCPD-25563 am62xx-sk,am62xx_sk-fs,am62xx_sk-se Test: AM62: Linux: Add support for MCAN  
LCPD-22715 am62xx-sk,am62xx_sk-fs,am62xx_sk-se,j721e-idk-gw,j721s2-evm,j721s2_evm-fs,j7200-evm i2232: DDR: Controller postpones more than allowed refreshes after frequency change Workaround 1: Disable dynamic frequency change by programing DFS_ENABLE = 0
LCPD-22319 am62axx_sk-fs,am62xx-sk,am64xx-evm,j721e-idk-gw,j721s2-evm,j7200-evm,j784s4-evm OpenSSL performance test data out of bounds  

2.1.5.7. Linux SDK Known Issues

Record ID Platform Title Workaround
LCPD-34978 am62xx-sk,am62xx_sk-fs AM62x: High tiny-image cpio file size  
LCPD-35083 am62xx_sk-fs,am62xx_sk-se,am62xx_lp_sk-fs,am62xx_lp_sk-se AM62: PRU rpmsg samples echo sample FW are not getting installed MACHINE=am62xx-evm bitbake pru-icss; install the ipk on the targetfs; opkg install pru-icss-rpmsg-echo_6.2.0-r1.0_am62xx_evm.ipk