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
- Decoder
- 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¶
2.1.6.2. Kernel¶
Linux Kernel
Real Time (RT) Linux Kernel
Generic Kernel Release Notes
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 Descriptors 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 |