2. Release Specific

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

2.1.4. Release 05.00.00

Released July 2018.

What’s New

New Features

  • AM335x,AM437x,AM57x,K2G
    • Uniflash Flash programmer: Available as Early Adopter feature in this release. Includes flashing support through JTAG and UART for following peripherals and EVMs
      • SPI: AMIC110 ICE, AM335x EVM, AM335x ICE
      • QSPI: AM437x IDK, AM571x IDK,AM572x IDK,AM574x IDK,K2G ICE,K2G EVM
  • K2G

  • UART AppLoader: Two stage bootloader support through UART interface

  • Improved OOB experience for overall Building SDK with introduction of RULES_MAKE based environment. All envrionment variable dependency for processor SDK updates handled during post installation step

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 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.30 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.47.2.0     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.26.0.0 X X X X X X X X X X X
OPENMP 2.6.2     X X X X X X X    
PDK   1.0.11 1.0.11 1.0.11 4.0.10 4.0.10 4.0.10 1.0.10 2.0.10 2.0.10 1.0.5 1.0.5
SYS/BIOS 6.52.0.12 X X X X X X X X X X X
UIA 2.21.2.07     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.50.03.33 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 6-2017-q1 A8 A9 A15 A15 A15 A15 A15        
TI ARM CGT 16.9.3     M4       A15(SBL)     ARM9 ARM9
TI C6000 CGT 8.2.2     C66x C66x C66x C66x C66x C66x C66x C74x C74x
TI PRU CGT 2.2.1 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 8.0.0.16 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 8.0.0.16
  • PDK for all platforms

2.1.5. Fixed Issues

Record ID Platform Summary
PRSDK-642 * RTOS: SDK components should be signed to avoid Eclipse/CCS warning when importing
PRSDK-3718 AM57x L3/L4 Interconnect CLKSEL configuration does not take to effect
PRSDK-3030 omap L13x SPI driver Interrupt mode is not functional
PRSDK-3856 AM335x AM437x StarterWare build from the PDK starterware folder fails on Windows OS
IPC-217 C667x,k2h,k2e IPC listMP corruption
PRSDK-3859 am57xx,c665x,c667x omapl13x,keystone2 c674x Audio benchmark starterkit demo fails to build in Windows with Rules.make environment setup
PRSDK-3865 am57xx,c665x,c667x omapl13x,keystone2 c674x SPI driver doesn`t support timeout
PRSDK-4013 k2h Client Socket recv() returns -1 with large stream of data
PRSDK-3749 K2G USB Spurrious interrupt in device mode config
PRSDK-3932 AMIC110 DDR Less bootloader support
PRSDK-4182 AM57xx Global interrupt disabling in EMAC driver breaks real time task
PRSDK-4012 AM335x AM437x Update to use -Wl, –start-group -Wl, –end-group during linking with GCC compiler
PRSDK-3866 AM57xx DSP1 image of IPC ex02_messageq example doesn’t work
PRSDK-3867 c674x, omapl13x MMCSD examples do not detect SD card insertion
PRSDK-3933 AM57x AM57x Board library sets L3MAIN1 and L4CFG CLKSTCTRL to Reserved_2
PRSDK-4000 k2g,omapl13x Aud/CMB loopback test and Audio pre-processing demos failure
PRSDK-4048 k2l K2L boot loader failure in SPI boot mode

2.1.6. Supported Platforms

2.1.6.2. Evaluation Modules

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

2.1.6.3. Demonstrations

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

2.1.6.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
  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
PRUSS-I2C f/w 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       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
USB Device Audio X     X                
USB Device Bulk X X X X       X       X
VPS     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                  

DSP devices - OMAP-L13x, C674x

Feature 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 X X
USB Device Audio 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
McBSP K2G A15
McBSP OMAP-L13x ARM9
All Drivers K2x A15

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

2.1.7. 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-642 * Processor SDK Installer RTOS: SDK components should be signed to avoid Eclipse/CCS warning when importing Ignore the Eclipse/CCS warning
PRSDK-335 AM4X High-Speed Drivers USB host MSC fails to re-enumerat e 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-330 AM4X High-Speed Drivers USB device MSC re-enumerat ion fails while disconnecti ng and reconnectin g on a Windows host Problem not observed with Linux USB Host.
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-2166 AM5X High-Speed Drivers USB3.0 host problem with Sandisk Extreme USB3.0 stick Start the example without the USB plugged in. Once the example is up and waiting for USB stick, plug the USB stick in and it will enumerateproperly.
PRSDK-1975 * Board Diagnostics Timer Diagnostic example does not run on ARM Core 1 Example can run on ARM Core 0
PRSDK-3344 am572x-id,a m574x-idk Board Diagnostics Diagnostics Baremetal icssEmac_TE ST idkAM57{2/4 }x : LINK IS DOWN, pluggin loopback cable ICSS-EMAC LLD TI-RTOS example can be used for similar test.
PRSDK-3482 * CCS CCSV7.4: Intermitten t issue not able to connect target while using DSS script Retry for connection failure in DSS script.
PRSDK-2336 am335x-evm, am437x-evm PM PM Unit Test failure Use debug version of PM library for the test. To build from the top-level makefile in pdk.../packages folder run “make BUILD_CONFIG=debug pm”
PRSDK-3318 K2G 1Ghz EMAC EMAC_CpswRa teLimit_evm K2G_c66xExa mpleProject failure on 1GHz Flip Chip Incorrect Core clock config in test. Fix for to set the correct CPU clock
PRSDK-4184 am57x,k2x Board Diagnostic Hello_World: Baremetal ARM Cortex-A15 test example failure Problem observed with using GCC semihosting support Use UART driver for input and output
PRSDK-4214 k2g-hs Board Diagnostic create-sdcard script does not boot OOB Default generated App image is not signed follow the steps mentioned in section 6.2.1.2 of the Processor SDK Secdev Build and Install Guide to sign the app
PRSDK-642 * Uniflash Uniflash based flashing is not available through GUI Command line option can be used. Refer User Guide
PRSDK-4325 * USB Bulk USB Bulk Mode Python test script missing in package Available from External GIT location
PRSDK-4108 omapl13x USB USB Audio: Lag when trying to adjust volume None
PRSDK-3383 am574x-idk Board Diagnostic Diagnostic lcdTouchscr een_TEST hangs on AM574x IDK None
PRSDK-3369 am574x-idk PCIE-LLD PCIE board to board ARM test examples hangs on idkAM574x platform None
PRSDK-4304 am335x Uniflash Flash Writer Flash writer prebuilt binaries does not work on AM335x platforms Rebuilding the flash writer binaries shall fix this issue. Refer the Rebuilding the flash writer

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


2.1.10. Technical Support and Product Updates

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


2.2. Supported Platforms and Versions

Supported Host Operating Systems

The following operating systems have been validated to work with our SDK.

  • Linux SDK
Operating System Version
Ubuntu 14.04 (64-bit)
Ubuntu 16.04 (64-bit)
  • RTOS SDK
Operating System Version
Windows 7 (64-bit)
Ubuntu 16.04 (64-bit)
  • Android SDK
Operating System Version
Ubuntu 14.04 (64-bit)

Supported Platforms and EVMs

The following platforms and EVMs are supported with Processor SDK

Platform EVM Tested Version Document Processor SDK Linux Processor SDK RT Linux Processor SDK RTOS Processor SDK Android
AM57x AM572x EVM A3 Hardware User’s Guide X X X X
AM572x IDK 1.3A Hardware User’s Guide Hardware Setup with CCS X X X X
AM571x IDK 1.3A Hardware User’s Guide Hardware Setup with CCS X X X X
AM574x IDK 1.0A Hardware User’s Guide Hardware Setup with CCS X X X X
AM437x AM437x EVM 1.5B Hardware User’s Guide X X X  
AM437x SK 1.1A Hardware User’s Guide X   X  
AM437x IDK 1.4A Hardware User’s Guide   X X  
AM335x AM335x EVM 1.6A Hardware User’s Guide X X X  
AM335x SK 1.2 Hardware User’s Guide X   X  
BeagleBone Black B6 Hardware User’s Guide X   X  
AM335x ICE 2.1A Hardware User’s Guide Hardware Setup with CCS   X X  
K2H/K2K 66AK2Hx EVM 4.0 Hardware User’s Guide X X X  
TCI6638K2K EVM 4.0 Hardware User’s Guide X X X  
K2E AK2Ex EVM 1.0.3.0 Hardware User’s Guide X X X  
K2L 66AK2L06 EVM 1.0.3.0 Hardware User’s Guide X X X  
K2G K2G EVM 1.3D

Hardware User’s Guide

Hardware Setup with CCS

 X X X  
K2G Audio Daughtercard D Software Support     X  
K2G ICE EVM 1.0C Beta Hardware User’s Guide Hardware Setup with CCS X X X  
C665x C665x EVM 1.1-44 Hardware User’s Guide N/A N/A X  
C667x C667x EVM 3B Hardware User’s Guide N/A N/A X  
OMAPL137/C6747 OMAP-L137/C6747 Starter kit EVM J Hardware User’s Guide Hardware Setup with CCS N/A N/A X  
OMAPL138/C6748 OMAP-L138/C6748 LCDK A7A Hardware User’s Guide X N/A X  
AMIC110 AMIC110 ICE 1.1 Hardware User’s Guide Hardware Setup with CCS     X  

2.3. Migration Guide

Overview

This page covers migration information for applications built on top of the last Processor SDK for RTOS release.


Processor SDK RTOS 05.00.00

Build

Migration: TOOLS_INSTALL_PATH macro value changed to SDK_INSTALL_PATH No migration impact if tools and SDK are installed in same location. See additional details

Additional Details: TOOLS_INSTALL_PATH macro value is set to SDK_INSTALL_PATH by default. For accessing the tools from a different path, modify TOOLS_INSTALL_PATH in packages/ti/build/Rules.make file or can be overriden from the build console as shown below.

Windows

set TOOLS_INSTALL_PATH=<Path for the tools root folder>

Linux

TOOLS_INSTALL_PATH=<Path for the tools root folder>

Build Setup

Migration: There is no migration need for components used within processor SDK. Application Software outside processor SDK may require a change if there is a dependency to internal Processor SDK environment variables. See more details below

Additional Details: Rules.make file is used instead of pdksetupenv to setup the build environment variables. Components inside processor SDK are updated to align with this change. Any applications making use of pdksetupenv from processor SDK to setup the build environment variables should include below line in the application makefile.

include $(RULES_MAKE)

Archived