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
  • Prebuilt Binaries
  • SDK Installer
  • Setup Scripts
  • Makefiles
  • Matrix Application Launcher
  • Example Applications
  • 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.00.01

Released July 2020

What’s New

Processor SDK 7.0 Release has following new features:

  • AM654x GP PG2.0 Support. By default, the mksdboot script will copy the PG2.0 sysfw to the SD card. If using PG1.0, the sysfw must be copied manually

Release Features

  • AM654x GP PG1.0 and PG2.0 Support
  • R5 SPL:
    • Early booting of MCU R5F and Main R5FSS Core0
    • Bootstrapping 2nd stage boot loader (u-boot) on A53
    • UART boot, OSPI boot support.
    • eMMC HS400 mode support
    • eMMC boot support
  • A53 U-boot:
    • Early booting of remote cores (Main subsystem R5F’s) with configurable order of boot-strapping
    • Support for booting both compressed and uncompressed kernel image
    • Basic HYP mode support - boots up uboot in EL2 privileged mode
    • OSPI support, MMCSD support
    • SD card boot
    • USB Host and mass storage support
    • Support for DFU download to SD card, eMMC, OSPI
    • UFS support
    • eMMC boot support
  • Kernel: Kernel image includes support for the following drivers:
    • MMC support
    • I2C support
    • CPSW2G Ethernet driver
    • UART driver, UART console support
    • USB driver with support for device/host mode of operation
    • PCIe Root Complex and Endpoint drivers
    • CPSW9G Virtual driver
    • USB gadget driver support
      • Composite device
      • Multifunction composite device
    • USB DRD dual role support
    • Support for dual voltage SD cards (UHS mode)
    • PCIe backplane support
    • PCIe Gen3 2xlane support
    • eMMC HS400 speed mode support
    • UART DMA mode support
    • UFS support
    • ADC basic functionality
    • Crypto acceleration support for AES, 3-DES, and RNG
  • Graphics:
    • Support for OpenGL ® ES 1.x, OpenGL ® ES 2.0 and OpenGL ® ES 3.2 APIs
    • Weston window composition with GPU acceleration support
    • DRM-based display backend
    • Offscreen rendering mode support
    • DMABUF buffer import support
    • Support for YUV texture formats
    • Support for GPU profiling tools (PVRTrace and PVRTune)
  • IPC:
    • IPC support between A53 to each MainSS R5F core
    • Support for IPC in both IPC-only mode (core loaded by u-boot) and remoteproc mode (core loaded by Linux Kernel)
    • Mailbox and H/W spinlock support
  • Display:
    • DSS support for cropping, scaling, gamma correction, per-pixel blending and global alpha blending
    • DSS support for Color Space Conversion (CSC) and Color Phase Rotation (CPR)
    • DRM API support
    • Support for NV12, UYVY, and XRGB888 data
    • Static partitioning of DSS resources and using video pipelines on shared videoport
  • Audio:
    • Audio playback and Audio record support at 48 KHz, 24 bits per sample
    • Stereo and Multichannel support
    • Multi-codec support
    • McASP: Master and slave mode support
    • Multi-codec support with separate serializer per codec
  • Virtualization:
    • Jailhouse hypervisor support
    • Static system partitioning: SD/eMMC, sproxy threads, UARTs, etc.
    • IO isolation between VMs
    • Inter VM shared memory based communication
  • Profiling
    • A53 PMU support for Performance profiling

Features removed in this release compared to AM65x 6.x SDK

There are several features that had been supported in previous releases of the AM65x SDK, but that were not widely being used. Therefore, please be aware that the following features have been removed from this and future releases of AM65 SDK.

  • Create-sdcard.sh script. The mksdboot.sh script is now used instead.
  • Big Data IPC
  • IoT: Add Java Script runtime (node.js) for light-weight web solution to Processor SDK Linux Filesystem
  • Example Applications:
    • barcode-roi-01.00.00
    • evse-hmi-1.0
    • matrix-gui-2.0
    • matrix-gui-browser-2.0
    • mmwavegesture-hmi-1.0
    • mmwavegesture-hmi-1.0
    • qt-tstat-2.0
    • refresh-screen-2.0
  • R5 SPL
    • Hyperflash support
  • A53 U-boot
    • Hyperflash support
    • Hyperflash boot support
  • Multimedia
    • Decoder
      • Gstreamer-based video decode plugin for H.264 & H.265/HEVC formats
      • Support for decode resolutions up to 4K @ 60fps
      • Support for decoding NV12/NV16 pixel formats
      • Support for 8-bit and 10-bit pixel depths
      • Support for decoding streams with ‘B’ Frames
      • Support for multi channel decoding in driver and gstreamer
      • Support for MJPEG and JPEG Image decoder
      • Gstreamer plugin support for wayland sink
      • Support for video decoder error recovery
      • Support for interlaced video decode
    • Encoder
  • Virtualization
    • Display pipes
    • SMMU emulation in Jailhouse hypervisor

SDK Components & Versions

Component Version
Linux Kernel 5.4.40
U-Boot 2020.01
Yocto Project 3.1 (dunfell)
ARM Toolchain (gcc) 9.2-2019.12 hard-float
TI PRU Compiler 2.2.1

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: f9b0d030d31ab79577f1dd1e48814a8f3119c481
uBoot Version: 2020.01
uBoot Description: 07.00.00.005
Clone: ssh://git@bitbucket.itg.ti.com/lcpdpub/ti-u-boot.git
Branch: 07.00.00.005
uBoot Tag: 07.00.00.005

2.1.6.2. Kernel

Linux Kernel

Head Commit: 66cf445b7697a4963cfc796e06918fe5b147fe7d
URL: http://git.ti.com/gitweb/?p=ti-linux-kernel/ti-linux-kernel.git;a=commit;h=66cf445b7697a4963cfc796e06918fe5b147fe7d
Kernel Version: 5.4.40
Kernel Description: 07.00.00.005
Repo: ssh://git@bitbucket.itg.ti.com/lcpdpub/ti-linux-kernel.git
Branch: ti-linux-5.4.y
Kernel Tag: 07.00.00.005
Kernel defconfig: multi_v7_defconfig
Compiler Information: arm-none-linux-gnueabihf-gcc (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10)) 9.2.1 20191025
Compiler Download Location: https://developer.arm.com/open-source/gnu-toolchain/gnu-a/downloads
Information on how to download and build the kernel can be found here: https://processors.wiki.ti.com/index.php/Linux_Kernel_Users_Guide

Real Time (RT) Linux Kernel

Head Commit: 17e2c5c658e9bcdf7566c9e7f70b1f0a8c9f7036
URL: http://git.ti.com/gitweb/?p=ti-linux-kernel/ti-linux-kernel.git;a=commit;h=17e2c5c658e9bcdf7566c9e7f70b1f0a8c9f7036
RT Kernel Version: 5.4.43-rt25
Kernel Description: 07.00.00.005-rt
Repo: ssh://git@bitbucket.itg.ti.com/lcpdpub/ti-linux-kernel.git
Tag: 07.00.00.005-rt
Kernel defconfig: multi_v7_defconfig
Compiler Information: arm-none-linux-gnueabihf-gcc (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10)) 9.2.1 20191025
Compiler Download Location: https://developer.arm.com/open-source/gnu-toolchain/gnu-a/downloads
Information on how to download and build the kernel can be found here: https://processors.wiki.ti.com/index.php/Linux_Kernel_Users_Guide

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

Record ID Platform Title
LCPD-17236 am654x-evm PDK-IPC build from sources is not creating stripped images and links
LCPD-16029 am654x-evm AM65: icssg: PRU ethernet links might be unstable with new PHY package
LCPD-17783 am654x-evm USB: USB2PHY Charger Detect is enabled by default without VBUS presence

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

Record ID Title Platform
LCPD-18690 AM65x SR1.0: MMC UHS mode enabled but not functional am654x-evm
LCPD-18694 AM65x: cpsw2g: ale parameters init issue am654x-evm,am654x-hsevm
LCPD-18848 Fit Image is missing default config (k3-am654-base-board-sr1.dtb) am654x-hsevm
LCPD-18887 am654x-hsevm fails to boot am654x-hsevm
LCPD-18641 u-boot: says “cannot find image node ‘k3-am654-idk-sr1.dtbo’” on AM65 SR1.0 am654x-evm,am654x-hsevm
LCPD-18674 sysint: k3-am654-idk-sr1.dtbo missing from rootfs am654x-idk
LCPD-18593 CPSW2G: restore vlan cfg after ifconfig up/down am654x-evm,am654x-hsevm
LCPD-18594 CPSW2G: CPTS: sync PPS to adjusted PTP clock am654x-evm,am654x-hsevm
LCPD-18695 AM65x: cpsw2g: allmulti mode is broken am654x-evm,am654x-hsevm
LCPD-18669 SA2UL causes boot failure if built-in to kernel am654x-evm
LCPD-18753 AM65x: cpsw2g: iet changes bloks rrobin cfg is <2 TX queues am654x-evm,am654x-hsevm
LCPD-18847 UDMA: atype is ignored even if it is correctly specified for non slave channels am654x-evm,am654x-hsevm

2.1.7.3. Errata Workarounds Available in this Release

Record ID Title
LCPD-5310 i900: CTRL_CORE_MMR_LOCK_5 region after locking results in ctrl module inaccessible, recoverable only post a reset
LCPD-5311 i893: DCAN ram init issues in HW AUTO and when traffic hitting CAN bus (open investigation)
LCPD-5309 LCPD: i896: USB Port disable doesnt work
LCPD-7642 MMC/SD: i832: return DLL to default reset state with CLK gated if not in SDR104/HS200 mode.
LCPD-4195 J6: SATA: Investigate applicability of i807
LCPD-4225 J6: Errata: i834: Investigate possibility of software workaround
LCPD-976 J6/J6eco: 32clk is psuedo (erratum i856) - clock source
LCPD-975 J6/J6eco: 32clk is psuedo (erratum i856) - realtime counter
LCPD-1022 J6: Errata: i694: System I2C hang due to miss of Bus Clear support @ OMAP level
LCPD-1188 J6: Baseport: Errata i877: RGMII clocks must be enabled to avoid IO timing degradation due to Assymetric Aging
LCPD-9084 i887: Software workaround to limit mmc3 speed to 64MHz
LCPD-16904 PCIe: Unsupported request (UR) or Configuration Request Retry Status (CRS) in configuration completion response packets results in external abort
LCPD-5836 CAL: Errata: i913: CSI2 LDO needs to be disabled when module is powered on
LCPD-5460 Implement WA for Vayu errata i829 (Reusing Pipe Connected To Writeback Pipeline On The Fly To An Active Panel)
LCPD-5052 Upstream: Post the dmtimer errata fix for i874
LCPD-4910 J6/OMAP5: errata i810 implementation
LCPD-4911 DRA7: USB: Investigate applicability of Errata i897: StopEndpoint_issue
LCPD-4912 DRA7: USB: Implement ErrataID_i896_PED_issue
LCPD-16363 IO, MMCSD: Incorrect IO Power Supply Connectivity Prevent Dynamic Voltage Change on VDDSHV6 and VDDSHV7
LCPD-16364 MMCSD: Negative Current from UHS-I PHY May Create an Over-Voltage Condition on VDDS6 and VDDS7 which exposes the Device to a Significant Reliability Risk
LCPD-16538 PCI-Express (PCIe) May Corrupt Inbound Data
LCPD-14184 USB: SuperSpeed USB Non-Functional
LCPD-14187 UDMA-P Real-time Remote Peer Registers not Functional Across UDMA-P Domains
LCPD-14185 MSMC: Non-coherent memory access to coherent memory can cause invalidation of snoop filter
LCPD-14159 The assertion of warm reset coinciding with a debug configuration access targeting the STM Subsystem may result in a hang of said debug configuration access
LCPD-13884 CPTracer Bus Probes MAIN_CAL0_0 and MCU_SRAM_SLV_1 are not able to distinguish between secure and non-secure transactions
LCPD-13887 DDR Controller ECC Scrubbing feature can cause DRAM data corruption
LCPD-4647 [rpmsg 2015 LTS] Implement errata i879 - DSP MStandby requires CD_EMU in SW_WKUP
LCPD-4648 [rpmsg 2014 LTS] Implement errata i879 - DSP MStandby requires CD_EMU in SW_WKUP
LCPD-4975 DSS AM5/DRA7: implement WA for errata i886
LCPD-14941 RINGACC and UDMA ring state interoperability issue after channel teardown
LCPD-14579 DSS : DSS Does Not Support YUV Pixel Data Formats
LCPD-14580 DSS : DSS Does Not Support YUV Pixel Data Formats
LCPD-14578 DSS : DSS DPI Interface does not support BT.656 and BT.1120 output modes
LCPD-14577 CPSW does not support CPPI receive checksum (Host to Ethernet) offload feature
LCPD-8277 u-boot: j6: SATA is not shutdown correctly as per errata i818
LCPD-8294 37 pins + VOUT pins need slow slew enabled for timing and reliability respectively
LCPD-5308 i897: USB Stop Endpoint doesnt work in certain circumstances
LCPD-6907 Workaround errata i880 for RGMII2 is missing
LCPD-5931 DRA7xx: AM57xx: mmc: upstream errata workaround for i834
LCPD-5924 ALL: CONNECTIVITY: CPSW: errata i877 workarround for cpsw
LCPD-4218 Implement Workaround for Errata i813 - Spurious Thermal Alert Generation When Temperature Remains in Expected Range
LCPD-4217 Implement Workaround for Errata i814 - Bandgap Temperature read Dtemp can be corrupted
LCPD-4184 Implement workaround for errata i814 - Bandgap Temperature read Dtemp can be corrupted
LCPD-1146 DMM hang: Errata VAYU-BUG02976 (i878) (register part)
LCPD-1087 J6: MMC: Errata: i802: OMAP5430 MMCHS: DCRC errors during tuning procedure
LCPD-1108 J6: Wrong Access In 1D Burst For YUV4:2:0-NV12 Format (Errata i631)
LCPD-876 OMAP5: Errata i810: DPLL Controller Sticks when left clock requests are removed
LCPD-16605 MMC: MMC1/2 Speed Issue
LCPD-17220 U-Boot Hyperbus: Hyperflash reads limited to 125MHz max. frequency
LCPD-16643 Hyperbus: Hyperflash reads limited to 125MHz max. frequency
LCPD-16350 DSS: Frame Buffer Flip/Mirror Feature Using RGB24/BGR24 Packed Format can Result in Pixel Corruption
LCPD-9173 i897: USB Stop Endpoint doesnt work in certain circumstances
LCPD-17333 [CPTS] GENF (and ESTF) Reconfiguration Issue
LCPD-14186 UDMA-P Host Packet Descriptor’s “0x3FFFFF” Packet Length Mode not Functional
LCPD-1776 [J6 SATA Adaptation] J6 - Errata i783, SATA Lockup After SATA DPLL Unlock/Relock
LCPD-941 OMAP4,5: DSS: implement workaround for errata i740
LCPD-1171 DRA7: DMM errata i878 (framebuffer part)

2.1.7.4. SDK Known Issues

Record ID Platform Title Workaround
LCPD-16664 am654x-evm MMU Alloc errors and Kernel Oops with RT build  
LCPD-17412 am654x-evm QT5 Webengine-based browser crashing with any resize operation  
LCPD-18908 am654x-evm GLMark2 fails for am65x  
LCPD-13816 am654x-evm Chromium-wayland broswer does not work on AM654x with page size = 64k  
LCPD-13817 am654x-evm Qt5 Webengine-based broswer does not work on AM654x with pagesize = 64k  
LCPD-14254 am654x-evm meta-ti: Need a recipe update to pick up the new AM65x PRU Ethernet firmwares  
LCPD-13947 am335x-evm nativesdk-opkg is broken in the devkit  
PLSDK-2642 am654x-idk PRU Ethernet links on IDK Application board are unstable IDK Limitation, requires re-work
PLSDK-3147 am654x-idk ICSSG: < 0.01 packet loss at 3/4/4.5 Mbits/sec for 10M Half Duplex link  
PLSDK-3148 am654x-idk ICSSG: 10M/100M Half duplex doesn’t work with 10/100M Hub  
PLSDK-3152 am654x-idk 10M/100M EVM <——-> PC / H3C S5120V2: setup results in kernel errors and ping failures  
PLSDK-3213 am654x-idk DP83867: auto negotiation at 10M/100M unstable  
PLSDK-3225 am654x-evm bin/create-ubifs.sh not available in SDK  
PLSDK-3232 am654x-evm UDP throughput numbers are half of what they should be  

2.1.7.5. U-Boot Known Issues

Record ID Platform Title Workaround
LCPD-18627 am654x-idk uboot does not read the reserve-memory from the fdt  
LCPD-17770 am654x-evm U-Boot: Fix order of MCU R5 shutdown depending on cluster mode  
LCPD-16524 am654x-evm Need to adjust RMW bit when using enabling ECC None
LCPD-14843 am654x-evm U-boot should support default settings for netboot None
LCPD-18620 am654x-evm AM65x PG2: U-Boot MMC/SD does not work at greater than 25MHz clock  
LCPD-16696 am654x-evm U-Boot does not recognize SD-Card after re-insert/change  
LCPD-15873 am654x-evm There is no dtbo in u-boot for PCIe x1 + usb3 daughter card None

2.1.7.6. Linux Kernel Known Issues

Record ID Priority Title Component Subcomponent Platform Workaround Impact
LCPD-17471 P2-High device hang when restarting crashed R5F IPC am654x-evm      
LCPD-18832 P2-High NVMe SSD could not be detected reliably Connectivity am654x-idk      
LCPD-18902 P2-High Unhandled Exception from EL1 observed during boot Baseport am654x-hsevm      
LCPD-18784 P2-High SD boot and eMMC alternative boot do not work if tftp images instead of fatload Baseport am654x-idk      
LCPD-13653 P2-High am65x-evm could not boot from MMC/SD when MMC/SD is backup boot mode Baseport am654x-evm   No workaround