Processor SDK RTOS Release Notes

From Texas Instruments Wiki
Jump to: navigation, search



Ti stk 1c rev rgb png.png

Last updated: 10/14/2017


NOTE

This Release Notes is for the latest Processor SDK RTOS release. If you are using an older release, see the Archived Section below.


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).


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.


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 [INSTALL-DIR]/processor_sdk_rtos_<SOC>_<version>/docs and 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.


Release 04.01.00

Released September 2017.

What's New

New Features

  • OMAPL13x and C674x
    • USB Driver with host and device MSC Support
    • Extending Secondary Boot Loader support to cover OMAPL1-138
  • K2G
    • SPI: Additional 16 bit word length support
  • PRUSS
    • EMAC Switch firmware Source release
    • Enable promiscous mode support in EMAC firmware
  • ICSS-EMAC
    • Additional queues configuration for multiple protocol scalability
  • General
    • PWM CSL-FL support for AM335x/AM437x/AM57x SOCs
    • CC-Link Industrial Ethernet Field Basic Master and Slave support for AM335x/AM437x/AM57x/K2G

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.

Component Version AM335x AM437x AM57x K2H/K2K K2E K2L K2G C665x C667x OMAP-L137 OMAP-L138
CG_XML 2.41.0 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.0 X X X X X X X X X
EDMA3 LLD 2.12.5.29 X 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.46.2.4 X X X X X X X X
LIBARCH 1.0.0.0 X
LINALG 1.2.0.0 X
MATHLIB 3.1.1.0 X X X X X X X X X
MPM 3.0.4.0 X X X X
NDK 2.25.1.11 X X X X X X X X X X X
OPENCL 1.1.14.1 X
OPENMP 2.6.2.0 X X X X X X X
PDK Per platform 1.0.8 1.0.8 1.0.8 4.0.7 4.0.7 4.0.7 1.0.7 2.0.7 2.0.7 1.0.2 1.0.2
SYS/BIOS 6.46.5.55 X X X X X X X X X X X
UIA 2.0.6.52 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.32.1.22 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 K2H/K2K K2E K2L K2G C665x C667x OMAP-L137 OMAP-L138
GNU ARM Embedded 4.9-2015q3 A8 A9 A15 A15 A15 A15 A15
TI ARM CGT 16.9.3 M4 A15 (SBL) ARM9 ARM9
TI C6000 CGT 8.1.3 C66x C66x C66x C66x C66x C66x C66x C674x C674x
TI PRU CGT 2.1.5 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 K2H/K2K K2E K2L K2G C665x C667x OMAP-L137 OMAP-L138
CCS 7.2.0.13 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.

Change log

Updated

  • CCS 7.2
  • EDMA3 LLD 2.12.5
  • IPC 3.46.2
  • MPM 3.0.4
  • OPENCL 1.1.14
  • OPENMP 2.6.2
  • PDK for all platforms
  • TI ARM CGT 16.9.3

Fixed Issues

Record ID Platform Summary
PRSDK-2089 OMAPL13X MMC/SD LLD is not functional in MMC Mode on OMAPL13x platform
PRSDK-2521 * PCIE LLD: Board to board tests failing for AM571x IDK
PRSDK-1828 AM3X, AM4X, AM5X, K2G USB: usb_host_msc_project test failed on K2G and AM platforms
PRSDK-2049 AM5X RTOS AMIC110: ICSS_EMAC_BasicExample_wSoCFile/Lib_Testproject projects fail
PRSDK-2296 AM57xIDK Examples fail to build due to undefined CSL and OSAL symbol references.
PRSDK-2512 K2GICE ICSS_EMAC_BasicExample(ARM/DSP-LE) : Some tests have failed .
PRSDK-2557 AM572 SR1.1 SR1.1 Pinmux files can't be opened by PINMUX tool
PRSDK-2624 K2G Garbled UART Print output from SBL while loading to slave cores
PRSDK-2996 OMAPL138 Slave boot is failing on OMAPL138
PRSDK-2977 AM57x TX Queue Packet Descriptor does not handled the case for host overflow condition
PRSDK-2967 AM57x Unable to include csl_cpsw.h in application
PRSDK-2923 * I2C driver Error code overlap
PRSDK-2867 AM57x SPI pinmux SLEWCONTROL configuration issue in LLD tests
PRSDK-2792 K2G SBL QSPI writer does not perform read back verification
PRSDK-2786 AM57x UART LLD is not setting Parity bits correctly due to bug in CSL functions
PRSDK-2662 AM57x PRU ICSS EMAC RX rxMisAlignment issue
PRSDK-2654 AM57x emac_open Failure status due to memory not being returned to application
PRSDK-2650 AMIC110 DDR3 test hang on AMIC 110 ICE when loading from UART
PRSDK-2647 OMAPL13x NDK Nimu ping test Intermittent failure on OMAPL138/C6748 DSP core
PRSDK-2542 k2h/k2e Hyperlink reboot test failure due to incorrect initialization sequence
PRSDK-2530 AM570 Board library DDR speed not set to 667MHz to match the GEL file.
PRSDK-2520 AM335x Enable DMTimer4 PRCM Clock in Bootloader
PRSDK-2488 AM335x RTOS PM: DDR uncached due to cfg file settings
PRSDK-2421 AM335x RTOS PM: Changing OPP does not change CPU frequency
PRSDK-2352 AM3/AM4 AM3/AM4: PINMUX files can't be opened by PINMUX tool
PRSDK-2345 K2GHS Bare-metal CSL A15 interrupt support for K2G HS device
PRSDK-1209 K2H/K2E/K1/AM5 PCIE LLD: Board to board tests Failure
PRSDK-3088 C6748 AINTC clock enable shouldn`t be enable for C6748 LCDK

Supported Platforms

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
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
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

Evaluation Modules

See Processor SDK Supported Platforms page for a list of supported EVMs per platform and links to more information.

Demonstrations

See Examples and Demonstrations page for a list of demonstrations per platform and EVM.

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

Driver Platform/SOC AM335x EVM AM437x EVM AM57x EVM
AM335x AM437x AM57x GP ICE SK BBB GP IDK SK GP IDK
CSL 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
EDMA3 X X X X X X
GPIO 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
ICSS-EMAC X X X X X X
McASP X X X X X X
McSPI X X X X X X
MMC-SD X X X X X X X X X X X X
PCIe X X
PM X X X X
PRUSS X X X X
QSPI X X X X X
UART X X X X X X X X X X X X
USB X X X X X X X
VPS X X X

DSP devices - K2x, C66x

Driver 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

DSP devices - OMAP-L13x, C674x

Driver Platform/SOC OMAP-L137 EVM OMAP-L138 EVM
OMAP-L137 OMAP-L138 137/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

Other Features

The following table shows other feature availability per platform and EVM:

Sitara devices

Feature Platform/SOC AM335x EVM AM437x EVM AM57x EVM
AM335x AM437x AM57x GP ICE SK BBB GP IDK SK GP IDK
Board Support 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
Diagnostics X X X X X X X
FATFS X X X X X X X X X
NDK-NIMU(CPSW) X X X X X X X X X X X X
NDK-NIMU(ICSS) 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

Known Issues

This section contains the list of known issues at the time of making the release and any known workaround.

Record ID Platform Area Summary Workaround
PRSDK-1999 * System Linux host: Installation of SDK fails if installer is run with --prefix . (current dir) option Use a absolute path to the --prefix option.
PRSDK-415 AM3X DMA EDMA3 LLD RM code reserves first 64 parameters which are not available to user app using EDMA3_DRV_requestChannel Application needs to make sure that they to not provision these resources.
PRSDK-1932 AM3X, AM4X Networking SORTE firmware: Slave devices report RX_CRC packet errors during Parameterization state No functional issue because of error
PRSDK-335 AM4X High-Speed Drivers USB host MSC fails to re-enumerate Re-enumeration support for the case of device unplugged and plugged back currently fails for the example. Workaround is to avoid disconnecting drive while running example.
PRSDK-1186 AM5X Boot SBL fails to read MMCSD card with multiple blocks aligned to 0x200 This issue appears when there are several sections and a section is aligned to 0x200 boundary. If section is not aligned to 0x200, issue is not seen.
PRSDK-1995 C6678 Optimized Libraries FFTLIB: 3D FFT CCS project example fails to build with Processor-SDK tools (CCS, OpenMP) Use older versions of tools (CCSv5, OpenMP).
PRSDK-497 C6678 System Integration C66x top level makefile needs update to include compiling boot/platform projects Build using individual project makefile.
PRSDK-822 C66X Boot IBL bootmode tests(NAND,TFTP and Ethernet) works intermittently on K1 platforms None
PRSDK-1755 K2G DMA EDMA LLD example project fails to build because CCS project is not updated with components from SDK Manually update CCS project.
PRSDK-1491 K2G, K2H, K2L, K2K Board Support ARM PLL initialization sequence for K2 SOCs needs to be updated to avoid intermittent hang issue due to glitch observed on PLL clocks Enable the glitch-less bypass clock mux (ARM_PLL_EN bit in CHIP_MISC_CTL1, set it to 0) before enabling ARM PLL bypass. And then turn the glitch-less clock mux to PLL after releasing bypass (set ARM_PLL_EN to 1).
PRSDK-316 K2H KeyStone Drivers SRIO LLD board to board throughput test fails for Type 11 None
PRSDK-1070 K2L Diagnostics POST fails at DDR initialization for K2L EVM when using SBL to boot Remove DDR configuration from POST application since SBL does it already.
PRSDK-330 AM4X High-Speed Drivers USB device MSC re-enumeration fails while disconnecting and reconnecting on a Windows host Problem not observed with Linux USB Host.
PRSDK-1975 AM5X Board Support, Chip Support timer_DiagExample_evmAM572x_arm7.out doesn't work on ARM1 core None
PRSDK-1682 AM5X Diagnostics Board diagnostics LCD Touchscreen test does not work with new version of LCD TSC For LCD/Display checkout example under VPS component could be used
PRSDK-2196 AM5X Diagnostics DCAN Diag test failed on AM57x IDK Platforms None
PRSDK-2166 AM5X High-Speed Drivers USB3.0 host problem with Sandisk Extreme USB3.0 stick None
PRSDK-2614 AM437x GPIO Adding GPIO1 instance entry causes other GPIOs to not work None
PRSDK-2263 * DSPLIB CCS test projects don`t have optimized compiler settings. Modify compiler setting:remove -g,Add -O3.Add --mem_model:data=far --symdebug:none
PRSDK-2387 AM335x Posix SMP Demo AM3 Posix-SMP: No response on UART through SBL Use JTAG access
PRSDK-2423 * Mathlib Linker Error while linking MATHLIB RTS override library in the application . link both mathlib library and mathlib_rts library
PRSDK-2575 * DSPLIB DSPLIB header files prevents function declarations from being included None
PRSDK-3087 * UART UART read misses input when returnMode is set to UART_RETURN_FULL Set returnMode to UART_RETURN_NEWLINE
PRSDK-3065 OMAPL13x EMAC EMAC driver doesn`t provide default SOC configuration Application can setup HWI for TX And RX interrupts as shown in example
PRSDK-2982 AM57x EMAC EMAC_GLOBAL_RX_SEM_HANDLE not released Have static channel opened in application without closing and reopening
PRSDK-2941 AM335x Board PLL Settings need to be updated for additional optimal values None
PRSDK-2819 AM335x Board Networking API header files are not compatible with C++ extern "C" can be added to the missing API header file in use by application
PRSDK-1975 * Board Diagnostics Timer Diagnostic example does not run on ARM 1 core None
PRSDK-3051 K2G ICE SBL MLO unable to load/run App for A15/C66x None

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.


Host Support

The recommended development host is

  • Windows: Windows 10 on 64-bit machine
  • Linux: Ubuntu 16.04 on 64-bit machine
NOTE

The Windows installer is a 32-bit binary, but is compatibility with 64-bit machine.


Technical Support and Product Updates

For further information or to report any problems, contact TI E2E:


Archived