NOTICE: The Processors Wiki will End-of-Life in December of 2020. It is recommended to download any files or other content you may need that are hosted on The site is now set to read only.

StarterWare Release Notes

From Texas Instruments Wiki
Jump to: navigation, search


March 19, 2012

Document License

This work (document) is licensed under the Creative Commons Attribution-Share Alike 3.0 United States License. To view a copy of this license, visit or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.


StarterWare provides no-OS platform support for the C6748-based Logic PD Evaluation Module (EVM) and the C6748-based LCDK. StarterWare provides Device Abstraction Layer (DAL) libraries and example applications that demonstrate the capabilities of the UART, I2C, Timer, GPIO, SPI, LCD, LIDD, Ethernet, McASP, USB, EHRPWM and RTC peripherals of C6748.

What is Supported

  • Tool Chain (ARM)
    • Code Sourcery GCC for arm-none-eabi - v2009q1 arm-none-eabi
    • TI TMS470 ARM Code Generation Tools - v4.6.4 (CCS v5.0.3)
  • Tool Chain (DSP)
    • TI TMS320C6000 DSP Code Generation Tools - v7.2 (CCS v5.0.3)

(TMS470 tool chain usage has certain limitations as explained in the Known Issues section below)

  • StarterWare Boot Loader
  • Standalone Applications running from DDR
  • Driver APIs for the peripherals/devices
    • GPIO
    • I2C
    • RTC
    • SPI
    • EDMA
    • Raster LCD
    • LIDD
    • Timer
    • UART
    • EMAC
    • MDIO
    • LAN8710A
    • LIDD
    • McASP
    • EHRPWM
    • USB (HID, CDC, MSC, Bulk)
    • VPIF
  • APIs for configuring MMU and Cache
  • Support for both IRQ and FIQ handling
  • Support for Switching between privileged and non-privileged modes of ARM
  • Support for DSP interrupt controller
  • lwIP port for C6748
  • Sample Applications to demonstrate the usage of
    • GPIO
    • I2C (interrupt and DMA modes)
    • RTC
    • SPI (interrupt and DMA modes)
    • Raster LCD
    • LIDD
    • Timer (normal and watchdog modes)
    • UART (interrupt and DMA modes)
    • Ethernet (echo and http server)
    • McASP (DMA mode)
    • Cache/MMU
    • Graphics Library
    • EHRPWM
    • USB device (HID, CDC, MSC, and Bulk classes)
    • USB host (HID and MSC classes)
    • NAND flash
    • VPIF loopback
    • DSP exception handling
  • Demo applications for graphics library
    • grlib demo (as seen in StellarisWare)
    • Maze game
  • Out-of-box demo Application that demonstrates several peripherals in combination (GPIO, I2C, RTC, SPI, LCD, Timer, McASP, Ethernet, TouchScreen and UART)

What is Not Supported

  • Tool Chain
    • IAR Embedded Workbench for ARM 6.10
  • Nesting of interrupts within host interrupts
    • One IRQ cannot pre-empt another IRQ
    • One FIQ cannot pre-empt another FIQ
  • Applications using standard malloc/calloc
    • StarterWare Startup Code does not call any library hence does not perform initializations required for malloc/calloc.
  • Peripherals or features not mentioned as part of "What is Supported" section are not supported

New in This Release

  • Added support for LCDK platform
    • LCDK Platform library
    • LCDK example applications for all applicable peripherals
    • LCDK demo application
    • Added NAND flash support to bootloader (no SPI flash on LCDK)
    • Updated SFH utility for LCDK support (use -targetType C6748_LCDK option)
  • Added VPIF to LCD loopback example application
    • Uses CPU to color convert YUV data from the video port into RGB data output to LCD screen
  • Most source code is now provided under BSD license
    • Notable exceptions: graphics library and USB library still use a proprietary license
    • See the software manifest for more information
  • Added C# source code for bmp2c PC utility under BSD license

Fixed in This Release

  • Updated bootloader to use standard entrypoints and common StarterWare libraries (drivers, utils, etc.)
  • Fixed an issue with the usb_host_msc example application on the DSP core
  • Fixed an issue with USB full speed mode in various example applications
    • To use FS mode, rebuild the drivers and USB libraries with the "-DUSB_MODE_HS_DISABLE" compiler option, then rebuild the application
  • Completed NAND library to make it usable on C6748 devices
    • Added EMIFA support to NANDLIB
    • NAND example application(s) now use NANDLIB instead of custom NAND code
    • LCDK bootloader also uses NANDLIB

Known Issues and Limitations

Issue Identifier Issue Description Workaround
SDOCM00079812 Ethernet: enet_lwip example application hangs if the optimization level is O1 - in code sourcery tool chain context and when using IAR tool chain. This issue is observed only in certain networks. The issue is that the DHCP ACK messages are not recieved. This is under investigation In case of Code Sourcery GCC tool chain use O2 or O0 optimization
SDOCM00080255 Unaligned memory accesses results in erroneous behaviour when binaries are generated using TMS470 tool chain. This is because the TMS470 does not support packed attributes for structures. This issue us evident when using ethernet or USB examples where the pointer/address alignment may be adjusted dynamically while parsing/dropping headers at different layers of the IP stack. In case of Out-of-box demo (built by TMS470 ARM tool chain) ethernet cannot be used, and hence do not connect the ethernet cable. also, the USB component of the demo does not work TMS470 cannot be used on such cases. If possible please migrate to CodeSourcery GCC tool chain supported herein
SDOCM00082376 During TX transaction CPPI 4.1 DMA GRNDS mode fails if the chunk data size is > 512 bytes. The USB logs always shows a turn around error at 1042 bytes. This issue is being investigated Please configure the chunk size 512 bytes
SDOCM00082387 The USB MSC example executable built via IAR takes a long time to download. After downloading it does not work. NOTE: This is issue is observed only when the USB/MSC executable is downloaded via IAR. If the same USB/MSC IAR executable is dowloaded via CCS or flash tested, no downloading or working issues are seen. This issue needs to be investigated along with the IAR team
Please use other IDE's like CCS to download and debug the executable
TBD Demo application: touch screen controls are unresponsive in debug profile binaries for C6000 DSP. Use release profile binary
  • Flashing through Serial Flasher only supported on a Windows host.
  • If the code sourcery installation path contains white spaces, Cygwin may give errors while linking.
  • The Serial Flasher sfh_OMAP-L138.exe mandates that the application and bootloader images have to be flashed together. There is no option in sfh_OMAP-L138.exe to flash only the application.

Installation and Usage

Upgrade and Compatibility Information

Currently no upgrades are available.


Refer to Host Platform Requirements of the User Guide

Device Support

SOCs Supported:

  • C6748

EVMs Supported:

  • C6748-based Logic PD Evaluation Module
  • C6748-based LCDK

Validation Information


Technical Support

For further information or support, please visit the TI E2E Community Forums.