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, Linux Kernel & Filesystem
- SDK installer
- Setup scripts
- Demo applications
- Documentation
Note
For building some of the RTOS-based demonstrations, you should also download Processor SDK RTOS installer. For more information, refer to <PSDKRA install path>/index.html.
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 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. Supported Platforms¶
See here for a list of supported platforms and links to more information.
2.1.5. 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
- J721E: Video encoder/decoder support
- J721e: CAN driver
2.1.6. Build Information¶
2.1.6.1. U-Boot¶
2.1.6.2. Kernel¶
Linux Kernel
Real Time (RT) Linux Kernel
2.1.6.3. Yocto¶
meta-ti
meta-arago
2.1.7. Issues Tracker¶
2.1.7.1. Issues opened in previous releases that were closed on this release¶
Record ID | Summary |
---|---|
LCPD-23003 | IPC: when pdk-ipc fw loaded from u-boot it breaks j721e boot and ethfw |
LCPD-22979 | firmware links are missing in /lib/firmware directory for K3 |
LCPD-19636 | J7: HS: OSPI Boot broken |
LCPD-22966 | Upstream: U-Boot: PLL PostDiv1 and PostDiv2 divider clock rates are computed incorrectly |
LCPD-22967 | U-Boot: PLL PostDiv1 and PostDiv2 divider clock rates are computed incorrectly |
LCPD-22913 | USBDEV ACM NCM enumeration fails on the device side (Impact 9.3) |
LCPD-22300 | /dev/hwrng missing on K3 platforms |
LCPD-22278 | PCI-E USB devices fail to enumerate after power cycling |
LCPD-22549 | v4l2h264dec : application hangs when setting the pipeline to null |
LCPD-19819 | KMS ALPHABLEND tests fail due to no attribute ‘get_default_mode’ |
LCPD-20131 | Uboot fails to enumerate devices attached to a usb hub on the first ‘usb reset’ call |
LCPD-22965 | Upstream: U-Boot: PLL POSTDIV1 and POSTDIV2 clock parenting is reversed |
LCPD-22941 | ptp clock register breaks 5.14-rc1 kernel bootup |
LCPD-22349 | Displayport playback test fails: cannot find tidss device |
LCPD-22344 | crypto: sa2ul: crypto self-tests fail to allocate des3 algos |
LCPD-22345 | U-Boot: Main R5F clusters are incorrectly in LockStep mode |
LCPD-22318 | CRYPTO_S_PERF testcases are missing CONFIG_CRYPTO_DEV_SA2UL arg in 2021.00 |
LCPD-22285 | HS200 MMC speeds aren’t being achieved in kernel |
LCPD-22188 | j721e and am65 hs fails to build on 2021.01 uboot |
LCPD-22095 | omap-spi.txt convert to yaml |
LCPD-22091 | ti,phy-am654-serdes.txt convert to yaml |
LCPD-20737 | Documentation: u-boot documentation issues |
LCPD-22246 | j721e Uboot DFU tests are failing |
LCPD-22362 | ALSA sampling format capture/loopback test - arecord failure |
LCPD-18673 | IPSEC fails to establish connection when using HW crypto |
LCPD-22973 | GFX_XS_FUNC_GPU_MEM2MEM test fails due to a change in the expected output |
LCPD-22932 | j721e_pcie_probe() warn: missing error code ‘ret’ |
2.1.7.2. Issues found and closed on this release that may be applicable to prior releases¶
Record ID | Summary |
---|---|
LCPD-24468 | j721e and j7200 hang when booting fw image j7-main-r5f0_1-fw |
LCPD-24501 | Flashing Linux wic image to SD card does not boots Linux |
LCPD-24522 | j721e-idk-gw TIENC TIDEC tests fail with modprobe |
LCPD-24527 | j721e-idk-gw: Failed to get DMA channel with PCIe EP |
LCPD-24098 | v4l2h264enc : application hangs when setting the pipeline to null |
LCPD-24483 | j721e-idk-gw boot stess test TIMOUT at rproc (Impact 3) |
LCPD-24424 | j721e-idk-gw PCIE-EP Segmentation Fault (Impact 15) |
LCPD-24591 | j721e-idk-gw PCIE EP 4BAR, 16 MSI_INT, 4 PF, 4 VF each Fails boot with exception |
LCPD-24536 | video codec: sdk: standalone tests missing |
LCPD-24430 | j721e-idk-gw j7200-evm Dhrystone performance outside range (Impact 4) |
LCPD-24428 | j721e-idk-gw USB ping, iperf, zlp tests time out on USB link ready (Impact 5) |
LCPD-24449 | j721e-idk-gw Verify IPC spl broken (Impact 14) |
LCPD-23057 | J721e: DFU boot test fails |
LCPD-24140 | J721e-idk-gw UFS FUNC RW tests fail (Impact 1) |
LCPD-24454 | j721e-idk-gw ALSA capture performance outside expected range (Impact 1) |
LCPD-24594 | j721e-idk-gw USBHOST_S_FUNC_ETH_PING Fails (Impact 1) |
2.1.7.3. Errata workarounds¶
Record ID | Summary | Workaround | ErrataID |
---|---|---|---|
LCPD-19068 | DSS: Disabling a layer connected to Overlay may result in synclost during the next frame | i2097 | |
LCPD-19047 | USB: Race condition while reading TRB from system memory in device mode | i2067 | |
LCPD-18980 | PCIe: Gen2 capable endpoint devices always enumerate as Gen1 | i2085 | |
LCPD-16605 | MMC: MMC1/2 Speed Issue | i2090 | |
LCPD-17220 | U-Boot Hyperbus: Hyperflash reads limited to 125MHz max. frequency | i2088 | |
LCPD-19965 | OSPI PHY Controller Bug Affecting Read Transactions | i2189 |
2.1.7.4. SDK Known Issues¶
Record ID | Summary | Workaround |
---|---|---|
LCPD-24619 | Bitbake fails in different timezone | |
LCPD-24484 | j721e-idk-gw GFXBench tests fail, DRM authenticate failed (Impact 3) | |
LCPD-24482 | j721e-idk-gw RGX_S_FUNC_GLES tests fail (Impact 2) | |
LCPD-24475 | Performance of H.265 decoder is poor | |
LCPD-24290 | Decoder + kmssink elements generates pink and green frames blinking | |
LCPD-24099 | v4l2h264dec, v4l2h264enc, v4l2h265dec: Codec Allocates much more space than required in Linux | |
LCPD-22972 | j721e-idk-gw GLBenchmark GLB25_EgyptTestStandardOffscreen_inherited test | |
LCPD-22921 | j721e PVR profiling with PVRPerfServer test is failing | |
LCPD-22542 | v4l2h264dec is giving high latency compared to SW decoder | |
LCPD-21298 | Frame Buffer Decompression does not show expected improvement | |
LCPD-20620 | J721e: Gstreamer warning seen with video decoder mjpeg test | |
LCPD-19948 | Yocto: stream recipe is incorrect | |
LCPD-19894 | UYVY texture test fails due to internal data stream error | |
LCPD-19858 | OE: OPTEE label used in SDK is old and wrong | |
LCPD-19716 | GFX_XS_FUNC_UYVY_TEXTURE test fails | |
LCPD-18270 | Ivi shell test fails. Lib ivi-controller.so and other components are missing from the file system | |
LCPD-17387 | Underflow and CRTC SYNC LOST observed while running GLMark2 (1x1080p + 1x4k) | |
LCPD-16531 | video decode: vxd_dec warnings displayed at end of gstreamer hevc playback to kmssink for certain video | |
LCPD-16366 | RGX kick test fails when 32 sync dependencies are set for each command | |
LCPD-16130 | Exception triggered by drm_dev_unregister during poweroff |
2.1.7.5. U-Boot Known Issues¶
Record ID | Summary | Workaround |
---|---|---|
LCPD-24115 | j721e-idk-gw default mtdparts value in U-BOOT is wrong | |
LCPD-24633 | u-boot: j721e-sk: Update MAIN R5FSS cluster mode to Split-mode | |
LCPD-24248 | J7 Alpha board (rev E2A) no booting with PSDK8.0 | |
LCPD-22964 | U-Boot: PLL POSTDIV1 and POSTDIV2 clock parenting is reversed | |
LCPD-22904 | U-boot: Update EMIFtool for i2244:DDR: Valid stop value must be defined for write DQ VREF training | |
LCPD-22841 | Watchdog Timer test is failing (Impact 5.0) | |
LCPD-22451 | Documentation on J7ES Boot flow refers to AM65xx Boot flow in the u-boot user guide | |
LCPD-19776 | j7: uboot: some socketed evms fail to boot | |
LCPD-17770 | U-Boot: Fix order of MCU R5 shutdown depending on cluster mode | |
LCPD-17523 | A72-SPL - Support to dump EEPROM to shared memory | |
LCPD-24231 | J721e: U-boot: QSPI: Read performance very low with 7.x & 8.0 SDK | |
LCPD-22512 | Update dfu_alt_info_ospi to include flashing of PHY tuning data | |
LCPD-21986 | j721e U-Boot DDR50 mode cannot be tested using the default image | |
LCPD-17789 | UBOOT J7: Could not see UFS device by scsi scan | |
LCPD-19871 | U-boot: Documentation: Combined Boot flow and SPL Rearch | |
LCPD-22452 | u-boot README doesn’t have eMMC specific documentation for J7ES | |
LCPD-24108 | U-Boot: TISCI config ring fail traces seen in OSPI boot mode on J721E |
2.1.7.6. Linux Kernel Known Issues¶
Record ID | Summary | Workaround |
---|---|---|
LCPD-24450 | j721e-idk-gw, j7200-evm UART tests fail (Impact 3.0) | |
LCPD-24142 | J721e: Issue with OSPI probe in kernel when booting from OSPI boot mode | |
LCPD-24615 | j721e-hsevm V1.1 fails to boot | |
LCPD-20653 | ltp: kernel syscall tests fail | |
LCPD-24125 | j721e-idk-gw all LE play + record tests fail (Impact 7.0) | |
LCPD-24456 | Move IPC validation source from github to git.ti.com | |
LCPD-17284 | remoteproc/k3-r5: Cores are started out-of-order when core 0 file size >> core 1 file size | |
LCPD-16545 | remoteproc/k3-r5f: PDK IPC echo_test image fails to boot up in remoteproc mode on second run | |
LCPD-16535 | remoteproc/k3-dsp: PDK IPC echo test binaries fails to do IPC in remoteproc mode on second run | |
LCPD-24491 | Docs: MMC/SD supported modes not documented properly for J721E/J7200 | |
LCPD-24283 | CSI2 10 bit raw capture does not work | |
LCPD-24274 | PCIe: Link up failure when unused lanes are not assigned to PCIe Controller | |
LCPD-24144 | TDA4VM/J721e: An indirect write completion error occurred in the linux OSPI driver | |
LCPD-22487 | USB: usb0 doesn’t work properly in host only mode | |
LCPD-20240 | MMC Modular testcase regression | |
LCPD-19659 | Doc: PCIe: Update documentation to indicate how to move to compliance mode | |
LCPD-19084 | Few SD cards not enumerating in Kernel with Alpha EVM | |
LCPD-17814 | Kingston 16G card could not boot to uboot prompt | |
LCPD-17794 | ext4write failed to write firmware to SD card | |
LCPD-17421 | CPSW9G: Can’t bring up interface over NFS | |
LCPD-17172 | Uboot USBhost: Sandisk Extreme USB 3.0 msc stick could not be detected at second time | |
LCPD-17171 | Uboot dhcp occasionally failed | |
LCPD-16640 | PCIe RC: GIC ITS misbehaves when more than 4 devices use it simultaneously | |
LCPD-16628 | Could not enumerate PLEXTOR pcie SSD | |
LCPD-16591 | PCIe wifi ping stress test failed | |
LCPD-16396 | J721E: RC: Unsupported request in configuration completion packets results in an abort | Workaround for Multifunction: Configure all the physical functions supported by the endpoint. For configuring all the 6 functions of PCIe controller instance ‘1’ in J721E, the following can be used. mount -t configfs none /sys/kernel/config; cd /sys/kernel/config/pci_ep/; mkdir functions/pci_epf_test/func1; echo 0x104c > functions/pci_epf_test/func1/vendorid; echo 0xb00d > functions/pci_epf_test/func1/deviceid; echo 1 > functions/pci_epf_test/func1/msi_interrupts; echo 16 > functions/pci_epf_test/func1/msix_interrupts; ln -s functions/pci_epf_test/func1 controllers/d800000.pcie-ep/; mkdir functions/pci_epf_test/func2; echo 0x104c > functions/pci_epf_test/func2/vendorid; echo 0xb00d > functions/pci_epf_test/func2/deviceid; echo 1 > functions/pci_epf_test/func2/msi_interrupts; echo 16 > functions/pci_epf_test/func2/msix_interrupts; ln -s functions/pci_epf_test/func2 controllers/d800000.pcie-ep/; mkdir functions/pci_epf_test/func3; echo 0x104c > functions/pci_epf_test/func3/vendorid; echo 0xb00d > functions/pci_epf_test/func3/deviceid; echo 1 > functions/pci_epf_test/func3/msi_interrupts; echo 16 > functions/pci_epf_test/func3/msix_interrupts; ln -s functions/pci_epf_test/func3 controllers/d800000.pcie-ep/; mkdir functions/pci_epf_test/func4; echo 0x104c > functions/pci_epf_test/func4/vendorid; echo 0xb00d > functions/pci_epf_test/func4/deviceid; echo 1 > functions/pci_epf_test/func4/msi_interrupts; echo 16 > functions/pci_epf_test/func4/msix_interrupts; ln -s functions/pci_epf_test/func4 controllers/d800000.pcie-ep/; mkdir functions/pci_epf_test/func5; echo 0x104c > functions/pci_epf_test/func5/vendorid; echo 0xb00d > functions/pci_epf_test/func5/deviceid; echo 1 > functions/pci_epf_test/func5/msi_interrupts; echo 16 > functions/pci_epf_test/func5/msix_interrupts; ln -s functions/pci_epf_test/func5 controllers/d800000.pcie-ep/; mkdir functions/pci_epf_test/func6; echo 0x104c > functions/pci_epf_test/func6/vendorid; echo 0xb00d > functions/pci_epf_test/func6/deviceid; echo 1 > functions/pci_epf_test/func6/msi_interrupts; echo 16 > functions/pci_epf_test/func6/msix_interrupts; ln -s functions/pci_epf_test/func6 controllers/d800000.pcie-ep/; echo 1 > controllers/d800000.pcie-ep/start; echo 1 > /sys/bus/pci/devices/0000:00:00.0/remove; echo 1 > /sys/bus/pci/rescan; Workaround for switch card: No workarounds available. |
LCPD-24413 | J721e: ES1.1-HS: sysfw binary building steps | |
LCPD-24192 | J721E: Fix Video decoder documentation | |
LCPD-23010 | j721e-idk-gw stress boot test files | |
LCPD-22861 | Missing documentation for HS devices | |
LCPD-22760 | k3conf: Register read leads to kernel crash | |
LCPD-22715 | i2232: DDR: Controller postpones more than allowed refreshes after frequency change |
|
LCPD-19792 | j721e boot fails sometimes due to EL1 exception | |
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-17673 | No software documentation for the Timer module | |
LCPD-17543 | Some cpuhotplug tests failed | |
LCPD-16505 | Wrong clock rate is reported for 157:400, 157:401 (HSDIVIDER after PLL4 and 15) | |
LCPD-24502 | j721e-evm-ivi Universal Planes fails (Impact 1) | |
LCPD-19068 | DSS: Disabling a layer connected to Overlay may result in synclost during the next frame | |
LCPD-17387 | Underflow and CRTC SYNC LOST observed while running GLMark2 (1x1080p + 1x4k) | |
LCPD-17006 | 4k DP Display Shows Blank Screen sometimes when booting | |
LCPD-16836 | DP: GeChic display EDID read failures with custom DP cable | |
LCPD-16208 | FIFO Underflows during video playback on 4k panel | |
LCPD-22513 | Update SDK doc to include OSPI flashing instruction using dfu-util | |
LCPD-20290 | CPSW Performance regression on j721e-idk-gw | |
LCPD-18790 | eMMC tests failed on J7 rev E2 EVM | |
LCPD-22831 | Application takes 10-15 seconds to come up in some cases | |
LCPD-24677 | j721e-idk-gw PCI WIFI Tests Fail (Impact 1) | |
LCPD-24596 | j721e-idk-gw MMC MOD tests fail (Impact 1.7) | |
LCPD-24595 | j721e-idk-gw USB Suspend/Resume with RTC Wakeup fail (Impact 1) | |
LCPD-22339 | PCI-E USBCARD, ETHCARD don’t indicate 2-lane support with lspci | |
LCPD-24631 | J721e-idk-gw H264 Decoder Support Test Gap | |
LCPD-24129 | tinyFS not present in coreSDK 8.0 |
2.1.8. Change Requests¶
2.1.8.1. SDK features descoped from 8.0 release¶
ID | Head Line | Original Fix Version | New Fix Version |
---|---|---|---|
JACINTOREQ-1559 | Linux H264 decoder support | 08.00.00 | 08.01.00 |
JACINTOREQ-1485 | Linux writeback pipeline support | 08.00.00 | None |
JACINTOREQ-1444 | Vision apps inclusion in yocto build | 08.00.00 | None |
2.1.8.2. SDK features present in 7.0 that were descoped in 7.1¶
Feature | Comments |
---|---|
HS support | Restored in 7.3 |
SPL/Uboot boot modes restricted to SD card boot mode | Restored in 7.3 |
1s Linux boot | |
Descope for support of native H264 encode/decode | Use R5F based driver with OpenVX as interface. H.264 decoder support restored in 7.3 |
GPU compression | |
SA2UL driver optimization | |
Display Sharing | Display sharing demo available in SDK v6.1 |
Virtualization (Jailhouse hypervisor/IPC virtualization/CPSW9G virtualization) | Does not affect 3P virtualization solutions. Basic Jailhouse demo can be seen in SDK 7.0 |
2.1.9. Installation and Usage¶
The Software Developer’s Guide provides instructions on how to setup your Linux development environment, install the SDK and start your development. It also includes User’s Guides for various Example Applications.