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 AM65x EA2 v05.00.00.09

Released June 30 2018

What’s New

New Features

  • Additional Diagnostic Test support:USB,PCIe,
  • Board library config support for Ethernet config 100Mb/1Gig PHY
  • Additional driver support: USB2.0 Host and Device
  • EMAC driver unit test update to support external port to port testing across all ICSSG ports
  • SBL Boot loader validated for MMCSD boot mode support
  • Release includes unit test support for the drivers enabled through standard makefile. CCS project based example is not yet supported Use make all or gmake all from top level pdk_am65xx_1_0_0packages after setting the environment using pdksetupenv.bat|sh
  • Note documentation updates for all components are in progress and is expected to be complete along with GA release during e/o Sept. Pls refer Release Note to start with

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 AM65x 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 X
CTOOLSLIB 2.2.0.0     X 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
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.0.0     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.1.0     X   X X X X X X X X
MPM 3.0.4.0         X X X X        
NDK 3.40.0.2 X X X X X X X X X X X X
OPENCL 1.1.14.1     X                  
OPENMP Per platform|   X   X X X X X X    
PDK 3.1.1.0 1.0.10 1.0.10 1.0.10 1.0.1 4.0.9 4.0.9 4.0.9 1.0.9 2.0.9 2.0.9 1.0.4 1.0.4
SYS/BIOS 6.73.0.03 X 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 X
XDAIS 7.24.0.4     X X X X X X X X X X
XDCTOOLS 3.50.04.43 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 6-2017-q1 A8 A9 A15   A15 A15 A15 A15        
GNU Linaro GCC 6.2.1 A8 A9 A15 A53 A15 A15 A15 A15        
TI ARM CGT 16.9.4     M4 R5     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 AM65x 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 X
EMU Pack 8.0.598.14     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

  • Support for AM65x SOC

2.1.5. Fixed Issues

Record ID Platform Summary
None AM65x make all from top level failure while building R4 RTSC library for first time
PRSDK-4130 PRSDK-4127 AM65x Diagnostics Test failure: I2C EEPROM, Memory Diagnostic Test
PRSDK-4116 AM65x Using NDK/NIMU FTP application, doing a FTP put operation after a get operation may not complete.

2.1.6. Supported Platforms

2.1.6.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 AM65xx Family of SOCs(AM6526,AM6528,AM6546,AM6548) Available through mySecure
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

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 AM65x EVM
  AM335x AM437x AM57x GP ICE SK BBB GP IDK SK GP IDK GP IDK
CSL 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
EDMA3 X X X X       X     X      
GPIO 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
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   X  
McSPI X X X   X       X     X X X
MMC-SD X X X X X X X X X X X X X X
PCIe     X                 X    
PM X   X X             X   X X
PRUSS X X X   X       X     X X X
QSPI   X X           X X   X    
OSPI                         X X
UART X X X X X X X X X X X X X X
USB X X X X       X     X X X X
USB Device Audio X     X                    
VPS     X               X X    
UDMA                         X X
OSPI                         X X
SCICLIENT                         X X
SA                         X X
CAL                            
DSS                            

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 Audio

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

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 AM65x EVM
  AM335x AM437x AM57x GP ICE SK BBB GP IDK SK GP IDK GP IDK
Board Support 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
Diagnostics X X X X       X     X X X X
FATFS 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
NDK-NIMU(ICSS) 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.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-4050 AM65X Drivers High speed support not functional for OSPI,USB drivers OSPI driver not functional for Full rate 133, 166 MHz with PHY enabled USB3.0 support is not functional in this release
AM65X SBL DDR not initialized Load application into internal memory
PRSDK-4131 AM65X OSPI OSPI RTOS Example Fail Example with or without DMA for RTOS is currently failing. Baremetal example is passing and can be used as reference
AM65X Drivers Following tests are failing -OSPI/A53 -I2C/R5 -UART DMA/R5 None. Pls refer passing cases in aternative core or OS eg: baremetal
AM65X Diagnostics Refer Diagnostic documentation for passing tests  
PRSDK-4116 AM65X NDK over EMAC/ICSS-G Using NDK-FTP application doing a FTP put operation after a get operation may not complete None
PRSDK-4121 AM65X Building Package make all fails for Windows due to missing openSSL Install`Strawberry Perl <http://strawberryperl.com/download/5.26.2.1/strawberry-perl-5.26.2.1-64bit.msi>`__ Run gmake all on DOS prompt with admin priviledge
AM65X Building Package make all fails while building R4 RTSC library Problem seen during first time build. device unplugged Trigger make command again after failure is seen. For additional details related to issue refer RTS Mklib

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 compatibile 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
`AM65x AM654x EVM Alpha

Hardware User’s Guide

Diagnostic Software User Guide

 X   X X
AM654x IDK Alpha

Hardware User’s Guide

Diagnostic Software User Guide

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

All platforms supporting Linux share

  • Linux Kernel 4.9
  • U-Boot 2017.01
  • Linaro GCC 6.2.1 Toolchain

For a full list of components, see the Release Notes for Processor SDK Linux, Processor SDK RTOS, and Processor SDK Android.

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

General

Migration: Applicable for applications migrating from SOCs supporting EDMA LLD to AM65x with updated DMA infrastructure. Additional UDMA driver support is available in package to support enhanced DMA infrastrcuture for AM65x Drivers for AM65x SOC is extended to support UDMA LLD abstracting changes needed by application. Limited change will be required for application using drivers included in Processor SDK. | Additional Details: Modifications needed at application will be limited to initialization of UDMA driver using Udma_init() API in addition to linking UDMA driver library. Driver Test code could be used as reference Additional migration details for all cases are covered in tidrvudmadocs folder inside PDK package |

Archived