2.1. Release Notes for AM335X¶
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 07.03.00¶
Released June 2021
What’s New
Processor SDK 7.3 Release has following new features:
2020 LTS Update (Kernel 5.4, U-boot: 2020.01, gcc: 9.2 2019.12 hf, Yocto 3.1 (dunfell))
- PRUSS HW UART Support
- Up to 12M baud rate
- Hardware flow control support
HSR/PRP with PRU-ICSS firmware offload support has been descoped
ICSS-EMAC support has been descoped
SORTE support has been descoped
SDK Components & Versions
| Component | Version |
|---|---|
| Linux Kernel | 5.4.106 (2020 LTS) |
| U-Boot | 2020.01 |
| Yocto Project | 3.1 (dunfell) |
| ARM Toolchain (gcc) | 9.2 2019.12 hard-float |
| Qt | 5.14.2 |
| OpenCL | 1.2.00.02 |
| OpenCV | 4.1.0 |
| Wayland | 1.18 |
| GStreamer | 1.16.3 |
| TI PRU Compiler | 2.3.2 |
| TI C66x CGT Compiler | 8.3.2 |
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 verson: 2020.01
URL: git.ti.com/ti-u-boot/ti-u-boot.git
Branch: ti-u-boot-2020.01
Commit ID: 2781231a33c3d779e32445f4fe55164c45d6d7c1
2.1.6.2. Kernel¶
Linux Kernel
The kernel git repository, branch and commit id can be found below:
Based on Version: 5.4.106
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-linux-5.4.y
Commit ID: 023faefa70274929bff92dc41167b007f7523792
Real Time (RT) Linux Kernel
The RT kernel git repository, branch and commit id can be found below:
Based on:
Kernel Version: 5.4.106
RT Kernel Version: 5.4.106-rt54
URL: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git
Branch: ti-rt-linux-5.4.y
Commit ID: 519667b0d81d74a6e55105dcd6072ae550352599
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.2. Issues found and closed on this release that may be applicable to prior releases¶
| Record ID | Platform | Title |
|---|---|---|
| LCPD-20209 | am335x-evm | cpsw: dual_mac: kernel crash when DT “”slaves=<1>”“ |
2.1.7.3. SDK Known Issues¶
| Record ID | Platform | Title | Workaround |
|---|---|---|---|
| SITSW-428 | am335x-evm,am335x-sk | Matrix demo is not running by default | Restart the Matrix demo manually after boot |
| SITSW-429 | am335x-ice | Kernel crash while running docker hello-world example | |
| LCPD-20148 | am335x-evm | am335x-evm: Yocto recipe in meta-processor-sdk needs to be fixed for origin reference | |
| LCPD-19858 | am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk,am571x-idk,am572x-idk,am574x-idk,am574x-hsidk,am57xx-evm,am57xx-beagle-x15,am57xx-hsevm,am64xx-evm,am64xx-vlab,am64xx-zebu,am654x-evm,am654x-idk,am654x-hsevm,beaglebone,bbai,beaglebone-black,dra71x-evm,dra71x-hsevm,dra72x-evm,dra72x-hsevm,dra76x-evm,dra76x-hsevm,dra7xx-evm,dra7xx-hsevm,j721e-evm,j721e-hsevm,j721e-evm-ivi,j721e-idk-gw,j7200-evm,j7200-hsevm,k2e-evm,k2e-hsevm,k2g-evm,k2g-hsevm,k2g-ice,k2hk-evm,k2hk-hsevm,k2l-evm,k2l-hsevm | OE: OPTEE label used in SDK is old and wrong | |
| LCPD-19279 | am335x-evm,am43xx-gpevm | openssl_perf.sh functionality to be included in rootfs (decouple from matrixgui) | |
| LCPD-18270 | am335x-evm,am43xx-gpevm,am571x-idk,am572x-idk,am574x-idk,am57xx-evm,am57xx-beagle-x15,am654x-evm,am654x-idk,dra71x-evm,dra72x-evm,dra76x-evm,dra7xx-evm,j721e-evm,j721e-evm-ivi,j721e-idk-gw | Ivi shell test fails. Lib ivi-controller.so and other components are missing from the file system | |
| LCPD-17817 | am335x-hsevm,am43xx-epos,am43xx-hsevm,k2e-hsevm,k2g-hsevm,k2hk-hsevm,k2l-hsevm | Images created with Proc-SECDEV grow with number of times SECDEV has been used | |
| LCPD-17449 | am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk,am571x-idk,am572x-idk,am574x-idk,am574x-hsidk,am57xx-evm,am57xx-beagle-x15,am57xx-hsevm,am654x-evm,am654x-idk,am654x-hsevm,beaglebone,beaglebone-black,dra71x-evm,dra71x-hsevm,dra72x-evm,dra72x-hsevm,dra76x-evm,dra76x-hsevm,dra7xx-evm,dra7xx-hsevm | libasan_preinit.o is missing in devkit | |
| LCPD-17413 | am335x-evm,am43xx-gpevm,am57xx-evm,am654x-evm | QT Webengine-based browser: the mouse does not work within the web page with QPA EGLFS | |
| LCPD-17164 | am335x-evm,am571x-idk,am574x-idk,am57xx-evm,dra71x-evm,dra7xx-evm | GLBenchmark is not able to run missing libgbm.so.2 error reported | create a symlink for linker file |
| LCPD-16114 | am335x-evm,am335x-ice,am335x-sk | RTC Init Script Needs to Wait for Module Load | |
| LCPD-15810 | am335x-evm,am43xx-gpevm,k2g-evm | Illegal instruction reported when trying to decode h264 stream with gstreamer | None |
| LCPD-15367 | am335x-evm,am574x-idk | Boot time increased about 15s | |
| LCPD-13947 | am335x-evm | nativesdk-opkg is broken in the devkit | |
| LCPD-12405 | am335x-evm,am335x-ice,am43xx-epos,am43xx-gpevm,am57xx-evm,dra71x-evm,k2e-evm,k2e-hsevm,k2g-evm,k2g-hsevm,k2l-evm | Openssl certgen fails due to coredump in openssl_gen_cert.sh |
2.1.7.4. U-Boot Known Issues¶
| Record ID | Platform | Title | Workaround |
|---|---|---|---|
| LCPD-19133 | am335x-evm,am335x-hsevm,am335x-ice,am335x-sk | Netconsole output corrupted when CONFIG_NETCONSOLE_BUFFER_SIZE >= 281 | |
| LCPD-18643 | am335x-evm,am335x-hsevm,am335x-ice,am335x-sk,am43xx-epos,am43xx-gpevm,am43xx-hsevm,am437x-idk,am437x-sk | U-Boot: AM335x/AM473x: Both SPI CS signals get asserted | |
| LCPD-7366 | am335x-evm | uboot McSPI driver drives multiple chip selects simultaneously | None |
2.1.7.5. Linux Kernel Known Issues¶
| Record ID | Priority | Title | Component | Subcomponent | Platform | Workaround |
|---|---|---|---|---|---|---|
| LCPD-22355 | P5-Not Prioritized | Update PHY latency values in SDK documentation | Connectivity | am335x-ice,am437x-idk,am571x-idk,am572x-idk,am574x-idk | ||
| LCPD-19757 | P3-Medium | OpenSSL DES performance numbers are lower in 07.01 | Baseport,System Test | am335x-evm | ||
| LCPD-19703 | P3-Medium | suspicious RCU usage wkup_m3_prepare_low_power on am335x-evm: 20201002 | Baseport | am335x-evm | ||
| LCPD-19702 | P3-Medium | crypto algapi failure on am335x-evm: 20201002 | Baseport | am335x-evm,am437x-sk | ||
| LCPD-19660 | P4-Low | Remove unused definitions and related code for SV frame MAC address | Connectivity | am335x-ice,am437x-idk,am571x-idk,am572x-idk,am574x-idk | ||
| LCPD-19262 | P3-Medium | Uboot: usb ethernet boot does not work on am335x-evm | Connectivity | am335x-evm | ||
| LCPD-17673 | P3-Medium | No software documentation for the Timer module | Baseport | Timers | am335x-evm,am43xx-gpevm,am571x-idk,am572x-idk,am574x-idk,am57xx-evm,am654x-evm,beaglebone-black,dra71x-evm,dra72x-evm,dra7xx-evm,j721e-evm | |
| LCPD-16437 | P4-Low | Nand with prefetch dma: read perf drop ~20% comparing to 2018 | Connectivity | am335x-evm | ||
| LCPD-15787 | P3-Medium | Power suspend fails due to USB (scsi_bus_suspend) failure when HDD is in use | Connectivity | am335x-evm | ||
| LCPD-15648 | P4-Low | Uboot mmc write performance decreased | Connectivity | am335x-evm | ||
| LCPD-14855 | P3-Medium | omap_i2c_prepare_recovery() function can Lock System | Connectivity | I2C | am335x-evm,am335x-ice,am335x-sk | |
| LCPD-14191 | P3-Medium | IPSec hardware-based throughput is 30% lower than 2018.03 | Baseport | am335x-evm,am57xx-evm | ||
| LCPD-13720 | P3-Medium | SPI DMA TX Mode Halts During Continuous 16/32/64 bit Transfers | Connectivity | beaglebone-black | ||
| LCPD-12392 | P4-Low | USBhost video: higher resolution tests fail with some cameras | Connectivity | am335x-evm | ||
| LCPD-10221 | P3-Medium | Longer resume times observed on setup with usb device cable | Connectivity | USB | am335x-evm | |
| LCPD-1245 | P3-Medium | AM335x: Power: Reverse current leakage on poweroff | Power & Thermal | am335x-evm | ||
| LCPD-1191 | P4-Low | AM335x: Power: System resumes due to wakeup source USB1_PHY without any external trigger | Power & Thermal | am335x-evm | Use GPIO interrupt instead of USB PHY for wakeup source. | |
| LCPD-998 | P4-Low | MUSB does not free urbs causing usb audio playback to fail | Connectivity | AM335x |
2.1.7.6. RT Linux Kernel Known Issues¶
- None
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 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