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.01.00¶
Released December 2021
What’s New
Processor SDK 8.1 Release has following new features:
- Second release on 2021 LTS 5.10 kernel, 2021.01 U-Boot
- Support PRU IPC with Linux
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: 15769936a559b1840f50b83f94ee0c636b245001 configs: am64x: Add FIT ARGS for HS images
Date: Tue Dec 14 08:15:08 CST 2021
uBoot Version: 2021.01
uBoot Description: 08.01.00.006
Clone: git://git.ti.com/ti-u-boot/ti-u-boot.git
Branch: 08.01.00.006
uBoot Tag: 08.01.00.006
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: dcc6bedb2c2bdb509709e4ae08303206e95ce6c2 Merged TI feature connectivity into ti-linux-5.10.y
Date: Wed Dec 15 08:06:10 CST 2021
Kernel Version: 5.10.65
Kernel Description: 08.01.00.006
Clone: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-5.10.y
Tag: 08.01.00.006
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: 541ec9a6995c3dd881d6f0b63cc714a08ded457d Merged TI feature ti_linux_base_rt into ti-rt-linux-5.10.y
Date: Tue Dec 14 09:43:46 CST 2021
Kernel Version: 5.10.65
RT Kernel Version: 5.10.65-rt53
Kernel Description: 08.01.00.006-rt
Clone: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-5.10.y
Tag: 08.01.00.006-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))
2.1.6.3. Yocto¶
meta-ti
Head Commit: 15613c951051c450fc8726b2576c23c105b79d53 linux-ti-staging: block sa2ul for am64x hs and j7200 hs device
Date: 2021-12-10
Version: dunfell-3.1
Clone: git://git.yoctoproject.org/meta-ti
Branch: dunfell
Release Tag: 08.01.00.006
meta-arago
Head Commit: e13e698213f5c4e2617ace97dca2d0ccf84ab0af Update the ltp-ddt to latest
Date: 2021-12-03
Version: 2021.09
Clone: git://git.yoctoproject.org/git/meta-arago.git
Branch: dunfell
Release Tag: 08.01.00.006
2.1.7. Issues Tracker¶
2.1.7.1. Issues opened in previous releases that were closed on this release¶
| Record ID | Summary |
|---|---|
| LCPD-22979 | firmware links are missing in /lib/firmware directory for K3 |
| LCPD-23009 | CAL capture test- No capture device of type cal found |
| LCPD-22300 | /dev/hwrng missing on K3 platforms |
| LCPD-21525 | k3-am654-base-board-sr1.dtb is missing for upstream |
| LCPD-22941 | ptp clock register breaks 5.14-rc1 kernel bootup |
| LCPD-22950 | AM654x ALSA tests fail due to soundcard issues (Impact 6.6) |
| LCPD-22951 | Alsa test fails - no soundcards found |
| LCPD-22949 | Audio interactive test fails |
| LCPD-22344 | crypto: sa2ul: crypto self-tests fail to allocate des3 algos |
| LCPD-22318 | CRYPTO_S_PERF testcases are missing CONFIG_CRYPTO_DEV_SA2UL arg in 2021.00 |
| LCPD-22188 | j721e and am65 hs fails to build on 2021.01 uboot |
2.1.7.2. Issues found and closed on this release that may be applicable to prior releases¶
| Record ID | Summary |
|---|---|
| LCPD-24480 | am654x-hsevm fails to boot ti linux |
| LCPD-23055 | AM654x: DFU Boot fails |
| LCPD-24501 | Flashing Linux wic image to SD card does not boots Linux |
| LCPD-24469 | AM65_SR10: ICSSG is broken |
| LCPD-24126 | AM654x KMS_XS_FUNC tests fail (Impact 5) |
| LCPD-24122 | AM654x DRM Tests all fail (Impact 14) |
| LCPD-24514 | AM65: PCIE-EP: swiotlb buffer is full |
| LCPD-24523 | am654x alsa tests failing 75% of the time |
| LCPD-24326 | am654x-evm: CAL capture test fails |
| LCPD-24229 | AM654x PCIE EP Tests Cannot Find Images |
| LCPD-23012 | DRM universal planes - Could not get DRM master permission |
| LCPD-24124 | AM654x Audio play + record test fails unexpectedly (impact: 7.3) |
| LCPD-24540 | am654x-evm PCIE-EP tests must be updated to expect GEN2 |
2.1.7.3. Errata workarounds¶
| Record ID | Summary | Workaround | ErrataID |
|---|---|---|---|
| LCPD-19447 | DSS: Disabling a layer connected to Overlay may result in synclost during the next frame | i2097 | |
| LCPD-17783 | USB: USB2PHY Charger Detect is enabled by default without VBUS presence | i2075 | |
| LCPD-17788 | PCI-Express: GEN3 (8GT/s) Operation Not Supported. | i2104 | |
| LCPD-14579 | DSS : DSS Does Not Support YUV Pixel Data Formats | i2000 |
2.1.7.4. SDK Known Issues¶
| Record ID | Summary | Workaround |
|---|---|---|
| LCPD-24586 | am65 uboot usbhost custom builds are missing in 8.1 | |
| LCPD-23006 | PVR driver fails to detect SGX core on AM65x SR1.0 | |
| 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-24628 | am654x-idk DFU boot is failing | |
| 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-17471 | device hang when restarting crashed R5F | |
| LCPD-24450 | j721e-idk-gw, j7200-evm UART tests fail (Impact 3.0) | |
| LCPD-13653 | am65x-evm could not boot from MMC/SD when MMC/SD is backup boot mode | No workaround |
| LCPD-24456 | Move IPC validation source from github to git.ti.com | |
| LCPD-22931 | RemoteProc documentation missing | |
| LCPD-16534 | remoteproc/k3-r5f: PDK IPC echo_test image fails to do IPC in remoteproc mode on second run | None |
| LCPD-24541 | am65xx OSPI boot does not work | |
| LCPD-24289 | ICSSG Ethernet Docs Broken link to ICSS Eth docs | |
| LCPD-24199 | AM654x UART HWFLOW FUNC, PERF, STRESS tests fail (Impact 2) | |
| LCPD-22916 | CSI: Interface Setup/Hold Timing Does Not Meet MIPI DPHY Spec above 600MHz | |
| LCPD-22892 | icssg: due to FW bug both interfaces has to be loaded always | |
| LCPD-20691 | AM65xx - lcd backlight scenario not enabled (Impact 1) | |
| LCPD-20683 | am65xx fails emmc boot | |
| 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-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-24539 | am654x-evm CAL test fails on PG2.0 boards | |
| LCPD-24284 | DRM tests fail due to crash in panel_simple_probe | |
| LCPD-24171 | Display driver for parallel port: CTRLMMR_DSS_CLKSEL register write enablement | |
| LCPD-24134 | AM654x CAL DMABUF tests fail (Impact 4.0) | |
| LCPD-22953 | v4l2 cal compliance 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-24605 | ICSSG: Not all TX timestamps are received | |
| LCPD-22959 | UART Read/Write tests at baud rate 115200 fails | |
| LCPD-24644 | weston service takes a long time to terminate | |
| LCPD-24319 | am654x-evm DRM tests fail due to frequency mismatch (Impact 7) | |
| LCPD-23008 | AM65xx - display port scenario not enabled | |
| LCPD-23007 | k3-am654-evm-hdmi.dtbo file is missing in CoreSDK for am654x | |
| LCPD-22954 | DRM Stress Test fails |
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