2.1. Release Notes¶
2.1.1. Overview¶
The Processor Software Development Kit (Processor-SDK) provides the core foundation and building blocks that facilitate application software development on TI’s embedded processors. This Release Notes focuses on the Real-time operating system (RTOS).
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.
2.1.3. Documentation¶
- Getting Started Guide: Provides information on getting the software and running basic examples/demonstrations bundled in the SDK.
- Migration Guide Provides migration information for applications built on top of the Processor SDK for RTOS.
- Software Developer Guide Provides information on features, functions, delivery package and, compile tools for the Processor SDK RTOS release. This also provides detailed information regarding software elements and software infrastructure to allow developers to start creating applications.
- Software Manifest: Provides license information on software
included in the SDK release. This document is in the release at
/processor_sdk_rtos_<SOC>_<version>/docsand available to view from the software download page. - 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. Processor SDK v06.03.02¶
Released July 2021
Note
This release is specific to AM57x platform. No other platforms supported by RTOS processor SDK are validated in this release.
What’s New
New Features
- AM57x
- USB driver
- Added Full Speed support for USB Bulk Device
- Support for Set and Clear STALL feature functions
- Added close API
- Bug fixes
- MMCSD driver
- Added support for different timeout errors
- Bug fixes
- PRU Firmware
- Added version details
- Dual EMAC firmware memory map update
Component Version
The following software components and host tools are bundled with the SDK installer. See the Software Developer Guide for more information on each item.
Note
This release has been tested with the following component and tool versions. It is recommended to use the versions listed here to avoid compatibility issues.
| Component | Version | AM335x | AM437x | AM57x | AM65x | K2H/K2K | K2E | K2L | K2G | C665x | C667x | OMAP-L137 | OMAP-L138 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CG_XML | 2.61.0 | X | X | X | X | X | X | X | X | X | X | X | X |
| CTOOLSLIB | 2.2.0.0 | X | X | X | X | X | X | X | |||||
| DSPLIB | 3.4.0.4 | X | X | X | X | X | X | X | X | X | |||
| EDMA3 LLD | 2.12.5.30 | X | X | X | X | X | X | X | X | X | X | ||
| FC | 3.40.2.7 | X | X | X | X | X | X | X | |||||
| FFTLIB | 3.1.0.0 | X | |||||||||||
| IMGLIB | 3.1.1.0 | X | X | X | X | X | X | X | |||||
| IPC | 3.50.4 | X | X | X | X | X | X | X | X | X | |||
| LIBARCH | 1.0.0.0 | X | X | ||||||||||
| LINALG | 1.2.0.0 | X | X | ||||||||||
| MATHLIB | 3.1.2.4 | X | X | X | X | X | X | X | X | X | |||
| MPM | 3.0.4.0 | X | X | X | X | ||||||||
| NDK | 3.61.1 | X | X | X | X | X | X | X | X | X | X | X | X |
| NS | 2.60.1 | X | X | X | X | X | X | X | X | X | X | X | X |
| OPENCL | 1.2.0.2 | X | |||||||||||
| OPENMP | 2.6.3.0 | X | X | X | X | X | X | X | |||||
| PDK | 1.0.17 | 1.0.17 | 1.0.18 | 1.0.7 | 4.0.16 | 4.0.16 | 4.0.16 | 1.0.16 | 2.0.16 | 2.0.16 | 1.0.11 | 1.0.11 | |
| SYS/BIOS | 6.76.3.1 | X | X | X | X | X | X | X | X | X | X | X | X |
| UIA | 2.30.1.2 | X | X | X | X | X | X | X | X | X | X | ||
| XDAIS | 7.24.0.4 | X | X | X | X | X | X | X | X | X | |||
| XDCTOOLS | 3.55.02 | X | X | X | X | X | X | X | X | X | X | X | X |
The following compilers are bundled with the SDK installer:
| Compiler | Version | AM335x | AM437x | AM57x | AM65x | K2H/K2K | K2E | K2L | K2G | C665x | C667x | OMAP-L137 | OMAP-L138 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| GNU ARM Embedded | 7-2018-q2 | A8 | A9 | A15 | A15 | A15 | A15 | A15 | |||||
| GNU Linaro GCC | 7.2.1 | A53 | |||||||||||
| TI ARM CGT | 18.12.5 | M4 | R5 | A15(SBL) | ARM9 | ARM9 | |||||||
| TI C6000 CGT | 8.3.2 | C66x | C66x | C66x | C66x | C66x | C66x | C66x | C674x | C674x | |||
| TI PRU CGT | 2.3.2 | PRU | PRU | PRU | PRU | PRU |
The SDK uses Code Composer Studio (CCS) as the integrated development environment (IDE) for all devices and EVMs:
| Component | Version | AM335x | AM437x | AM57x | AM65x | K2H/K2K | K2E | K2L | K2G | C665x | C667x | OMAP-L137 | OMAP-L138 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CCS | 9.3.0 | X | X | X | X | X | X | X | X | X | X | X | X |
| EMU Pack | Sitara Device 1.4.5 | X | X | X | X | ||||||||
Emulators |
8.3.0.0 | X | X | X | X | X | X | X | X | X | X | X | X |
If you need to install CCS, see the CCS installation section in the Getting Started Guide for options to select for Processor-SDK.
2.1.5. Fixed Issues¶
ID Head Line Module Affected Versions Affected Platforms PRSDK-8827 USB clearFeature and close function failures when device is operated in BULK mode USB 6.03.00 am57xx-evm, am571x-idk, am572x-idk, am574x-idk PRSDK-8826 TRB Memory corruption when the next event occurred before processing TRB completion event at EP0 USB 6.03.00 am571x-idk, am57xx-evm, am572x-idk, am574x-idk PRSDK-8832 USB host driver crashes when multiple EP0 requests are initiated USB 6.03.00 am57xx-evm, am571x-idk, am572x-idk, am574x-idk PRSDK-8795 PC couldn’t connect to the USB device after connecting and disconnecting it several times. USB 6.03.00 am574x-idk PRSDK-8805 MMCSD driver is not detecting the SD cards supporting SD spec revision below 2.0 MMCSD 6.03.00 am574x-idk PRSDK-8810 Transfer failure if TCC channel was changed during enabling DMA. MMCSD 6.03.00 am574x-idk PDK-10281 NIMU ICSS CCLink test failure on M4 core NIMU ICSS 6.03.00 am571x-idk, am572x-idk, am574x-idk PDK-10277 NIMU CCLink test failure on M4 core NIMU 6.03.00 am571x-idk, am572x-idk, am574x-idk
2.1.6. Known Issues¶
This section contains the list of known issues at the time of making the release and any known workaround.
| ID | Head Line | Module | Reported in Release | Affected Platforms | Impact | Workaround in this release |
|---|---|---|---|---|---|---|
| PRSDK-8819 | UART LLD data structure UART_Params mismatching between LLD and application | UART | 6.03.02 | am571x-idk, am572x-evm, am572x-idk, am574x-idk | UART_Params_init() can overwrite application’s data memory | None |
| PDK-9869 | McSPI master slave example failures with some HW setups | McASPI | 6.03.02 | am571x-idk, am572x-idk, am574x-idk | Inconsistent results while running the test | Use shorter cables with single wire for connections |
| PDK-10276 | False test fail condition reported by diagnostic test framework | Diagnostics | 6.03.02 | am571x-idk, am572x-idk, am574x-idk | Diagnostic framework menu shows test status as fail | Use logs displayed by the test to confirm test result |
| PDK-10275 | ICSS STP switch test failure while executing the loopback test | ICSS EMAC | 6.03.02 | am574x-idk | ICSS STP switch test hang | None |
| PDK-10285 | ICSS EMAC diagnostic test hang after link detection | Diagnostics | 6.03.02 | am574x-idk | ICSS EMAC diagnostic test hang | None |
| PDK-10282 | CSL timer example hang on DSP core while configuring timer instance 32 | CSL examples | 6.03.02 | am571x-idk, am572x-evm, am572x-idk, am574x-idk | CSL timer test hang | None |
| PDK-10302 | Prebuilt SD images are not included in AM57x processor SDK demos package | Demos | 6.03.02 | am571x-idk, am572x-evm, am572x-idk, am574x-idk | No prebuilt images | Generate the diagnostic test binaries by following Diag-Build steps |
| PDK-10313 | System fails to recover using clearFeature when USB bulk application is made to sleep in different sequences | USB | 6.03.02 | am574x-idk | Aborting pending transactions with clearFeature fails | None |
| PDK-10328 | Build warnings from hexpru tool while generating PRU firmware loader files | ICSS EMAC | 6.03.02 | am571x-idk, am572x-idk, am574x-idk | Warnings during ICSS EMAC LLD build | None |
2.1.7. Supported Platforms¶
2.1.7.1. Devices¶
The following table lists all supported devices for a given installer.
| Installer | Platform/SOC | Supported Devices | |
|---|---|---|---|
| RTOS-AM335X | AM335x | AM3351, AM3352, AM3354, AM3356, AM3357, AM3358, AM3359 | |
| AMIC11x | AMIC110 | ||
| RTOS-AM437X | AM437x | AM4376, AM4377, AM4378, AM4379 | |
| RTOS-AM57X | AM57x | AM5706, AM5708, AM5716, AM5718, AM5726, AM5728, AM5746, AM5748 | |
| RTOS-AM65X | AM65x | AM6526, AM6527, AM6528, AM6546, AM6548, DRA80xM | |
| RTOS-C665X | C665x | C6652, C6654, C6655, C6657 | |
| RTOS-C667X | C667x | C6671, C6672, C6674, C6678 | |
| RTOS-K2E | K2E | 66AK2E02, 66AK2E05, AM5K2E02, AM5K2E04 | |
| RTOS-K2G | K2G | 66AK2G02, 66AK2G12 | |
| RTOS-K2HK | K2H | 66AK2H06, 66AK2H12, 66AK2H14 | |
| K2K | TCI6638K2K | ||
| RTOS-K2L | K2L | 66AK2L06 | |
| RTOS-OMAPL137 | OMAP-L1x | OMAP-L137, C6743, C6745, C6747 | |
| RTOS-OMAPL138 | OMAP-L1x | OMAP-L138, C6742, C6746, C6748 | |
2.1.7.2. Evaluation Modules¶
See Processor SDK Supported Platforms page for a list of supported EVMs per platform and links to more information.
2.1.7.3. Demonstrations¶
See Examples and Demonstrations page for a list of demonstrations per platform and EVM.
2.1.7.4. Drivers¶
The following tables show RTOS driver availability per platform and EVM. A shaded box implies that the feature is not applicable for that platform/EVM.
Sitara devices
| Feature | Platform/SOC | AM335x EVM | AM437x EVM | AM57x EVM | AM65x EVM | J721E EVM | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AM335x | AM437x | AM57x | AM65x | J721E | GP | ICE | SK | BBB | GP | IDK | SK | GP | IDK | GP | IDK | GP | |
| CSL | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| EMAC | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| EDMA3 | X | X | X | X | X | X | |||||||||||
| GPIO | X | X | X | X | X | X | X | X | X | X | X | X | X | X | |||
| GPMC | X | X | X | X | |||||||||||||
| I2C | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| PRUSS-I2C f/w | X | X | X | X | X | X | |||||||||||
| PRUSS-eSPI f/w | X | X | |||||||||||||||
| ICSS-EMAC | X | X | X | X | X | X | X | ||||||||||
| McASP | X | X | X | X | X | X | X | X | X | X | X | ||||||
| McSPI | X | X | X | X | X | X | X | X | X | X | X | ||||||
| MMC-SD | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| PCIe | X | X | X | X | |||||||||||||
| PM | X | X | X | X | X | X | X | X | X | ||||||||
| PRUSS | X | X | X | X | X | X | X | X | X | X | X | ||||||
| QSPI | X | X | X | X | X | X | X | X | |||||||||
| OSPI | X | X | X | X | X | ||||||||||||
| UART | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| USB | X | X | X | X | X | X | X | X | X | X | X | X | |||||
| USB Device Audio | X | X | |||||||||||||||
| USB Device Bulk | X | X | X | X | X | X | X | X | X | X | X | X | |||||
| VPS | X | X | X | ||||||||||||||
| UDMA | X | X | X | X | X | ||||||||||||
| SCICLIENT | X | X | X | X | X | ||||||||||||
| SA | X | X | X | X | X | ||||||||||||
| CAL | X | X | X | X | X | ||||||||||||
| DSS | X | X | X | X | X | ||||||||||||
| FVID2 | X | X | X | X | X | ||||||||||||
DSP devices - K2x, C66x
| Feature | Platform/SOC | K2 EVM | C66x EVM | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| K2H/K2K | K2E | K2L | K2G | C665x | C667x | K2H | K2E | K2L | K2G | K2G-ICE | C665x | C667x | |
| CSL | X | X | X | X | X | X | X | X | X | X | X | X | X |
| AIF2 | X | X | |||||||||||
| BCP | X | X | X | X | |||||||||
| CPPI | X | X | X | X | X | X | X | X | X | X | X | X | X |
| DFE | X | X | |||||||||||
| EDMA3 | X | X | X | X | X | X | X | X | X | X | X | X | X |
| EMAC | X | X | X | X | X | ||||||||
| FFTC | X | X | X | X | |||||||||
| GPIO | X | X | X | X | X | X | X | X | X | X | X | X | X |
| HYPLNK | X | X | X | X | X | X | X | X | |||||
| ICSS-EMAC | X | X | |||||||||||
| I2C | X | X | X | X | X | X | X | X | X | X | X | X | X |
| IQN2 | X | X | |||||||||||
| McASP | X | X | |||||||||||
| McBSP | X | X | X | X | |||||||||
| MMAP | X | X | X | X | |||||||||
| MMC-SD | X | X | X | ||||||||||
| NWAL | X | X | X | X | X | X | X | X | |||||
| PA | X | X | X | X | X | X | X | X | |||||
| PCIe | X | X | X | X | X | X | X | X | X | X | X | X | |
| QMSS | X | X | X | X | X | X | X | X | X | X | X | X | X |
| RM | X | X | X | X | X | X | X | X | X | X | X | X | X |
| SA | X | X | X | X | X | X | X | X | X | X | |||
| SPI | X | X | X | X | X | X | X | X | X | X | X | X | X |
| SRIO | X | X | X | X | X | X | |||||||
| TCP3D | X | X | X | X | X | X | |||||||
| TSIP | X | X | X | X | |||||||||
| UART | X | X | X | X | X | X | X | X | X | X | X | X | X |
| USB | X | X | |||||||||||
| USB Device Audio | |||||||||||||
| USB Device Bulk | X | X | |||||||||||
DSP devices - OMAP-L13x, C674x
| Feature | Platform/SOC | OMAP-L137 EVM | OMAP-L138 EVM | ||
|---|---|---|---|---|---|
| OMAP-L137 | OMAP-L138 | L137/6747 SK | LCDK138 | LCDK6748 | |
| CSL | X | X | X | X | X |
| EDMA3 | X | X | X | X | X |
| EMAC | X | X | X | X | X |
| GPIO | X | X | X | X | X |
| I2C | X | X | X | X | X |
| McASP | X | X | X | X | X |
| MMC-SD | X | X | X | X | X |
| SPI | X | X | X | X | X |
| UART | X | X | X | X | X |
| USB | X | X | X | X | X |
| USB Device Audio | X | X | X | X | X |
| USB Device Bulk | X | X | X | X | X |
Unsupported Features
- In general driver support is available across all cores within an SOC with following exceptions
| Feature | Not supported | |
|---|---|---|
| SOC | CPU/Core | |
| McASP | AM57x | M4 |
| USB | AM57x | C66x |
| USB | AM57x | M4 |
| USB | K2G | C66x |
| McBSP | K2G | A15 |
| McBSP | OMAP-L13x | ARM9 |
| All Drivers | K2E/L/K | A15 |
2.1.7.5. Other Features¶
The following table shows other feature availability per platform and EVM:
Sitara devices
| Feature | Platform/SOC | AM335x EVM | AM437x EVM | AM57x EVM | AM65x EVM | J721E EVM | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AM335x | AM437x | AM57x | AM65x | J721E | GP | ICE | SK | BBB | GP | IDK | SK | GP | IDK | GP | IDK | GP | |
| Board Support | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| Boot (SBL) | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| Diagnostics | X | X | X | X | X | X | X | X | X | X | X | X | |||||
| FATFS | X | X | X | X | X | X | X | X | X | X | X | X | X | X | |||
| NDK-NIMU(CPSW) | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |
| NDK-NIMU(ICSS) | X | X | X | X | X | X | X | X | X | X | X | ||||||
| CC-LINK IE Field Basic(CPSW) | X | X | X | X | X | X | X | X | X | X | X | X | |||||
| CC-Link IE Field Basic(ICSS) | X | X | X | X | X | X | |||||||||||
DSP devices - K2x, C66x
| Feature | Platform/SOC | K2 EVM | C66x EVM | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| K2H/K2K | K2E | K2L | K2G | C665x | C667x | K2H | K2E | K2L | K2G | K2G-ICE | C665x | C667x | |
| Board Support | X | X | X | X | X | X | X | X | X | X | X | X | X |
| Boot (IBL/SBL) | X | X | X | X | X | X | X | X | X | X | X | X | X |
| Diagnostics | X | X | X | ||||||||||
| FATFS | X | X | X | ||||||||||
| Fault Management | X | X | X | X | X | X | |||||||
| IPC Transport (QMSS) | X | X | X | X | X | X | X | X | X | X | |||
| IPC Transport (SRIO) | X | X | X | X | X | X | |||||||
| MAD-UTIL | X | X | X | X | |||||||||
| Network (CPSW) | X | X | X | X | X | X | X | X | X | X | X | X | X |
| Network (ICSS) | X | X | |||||||||||
| CC-Link IE Field Basic(ICSS) | X | X | |||||||||||
| Platform Library (obsolete) | X | X | X | X | X | X | X | X | X | X | |||
| PKTLIB | X | X | X | X | X | X | X | X | |||||
| POST | X | X | X | X | X | X | X | X | X | X | |||
| SERDES Diagnostics | X | X | X | X | X | X | |||||||
| Trace Framework | X | X | X | X | X | X | |||||||
DSP devices - OMAP-L13x, C674x
| Feature | Platform/SOC | OMAP-L137 EVM | OMAP-L138 EVM | ||
|---|---|---|---|---|---|
| OMAP-L137 | OMAP-L138 | 137/6747 SK | LCDK138 | LCDK6748 | |
| Board Support | X | X | X | X | X |
| Boot (SBL) | X | X | X | X | X |
| Diagnostics | X | X | |||
| FATFS | X | X | X | X | X |
| Network (CPSW) | X | X | X | X | X |
2.1.8. Installation and Usage¶
The Getting Started Guide provides instructions on how to setup up your development environment, install the SDK and start your development.
To uninstall the SDK, remove the individual component directories from the installed path. This is safe to do even in Windows since these components do not modify the Windows registry.
2.1.9. Technical Support and Product Updates¶
For further information or to report any problems, contact: - TI E2E Processor Support for all supported platforms
2.1.10. Archived¶
- Processor-SDK RTOS 6.3.0
- Processor-SDK RTOS 6.1.0
- Processor-SDK RTOS 6.0.0
- Processor-SDK RTOS 5.3.0
- Processor-SDK RTOS 5.2.0
- Processor-SDK RTOS 5.1.0
- Processor-SDK RTOS 5.0.0
- Processor-SDK RTOS 5.0.0 AM65x EA Release
- Processor-SDK RTOS 4.3.0
Note: Release Notes prior to 4.3 are not archived. Please see the Migration Guide for information on migration from these releases.