StarterWare 01.10.04.01 Release Notes

WORK IN PROGRESS

This article is work-in-progress. Until completed, the contents are expected to change quite frequently. Quality and accuracy is not guaranteed until this message has been removed. Please bookmark the page and visit soon...

May 24, 2013

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 http://creativecommons.org/licenses/by-sa/3.0/us/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

Introduction

StarterWare 01.10.04.01 provides no-OS platform support for the OMAPL138-based Logic PD Evaluation Module (EVM) and the OMAPL138-based LCDK. StarterWare 01.10.04.01 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 OMAPL138.

What is Supported

• Tool Chain (ARM)
  • Code Sourcery GCC for arm-none-eabi - v2009q1 arm-none-eabi
  • TI TMS470 ARM Code Generation Tools - v5.0.1 (CCS v5.3.0)
• Tool Chain (DSP)
  • TI TMS320C6000 DSP Code Generation Tools - v7.4.1 (CCS v5.3.0)
    

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

• Light weight IPC (ipclite)
  • Support for interrupt and polling modes
  • Very low latency compared to other IPC modules

• 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
  • ipclite module
  • 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 01.10.04.01 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

• GCC variable attribute support added in example application and libraries for ARM CG tool chain
• Error concealment for USB library and USB example applications
  
  • USB library provides various error handling support in PIO mode
  • Error handling support is not provided for DMA mode in this release
• USB library provides multi-instance support
• System configuration provides cache layer to interact with CP15 processor related operations
• Utils provides non-blocking interrupt based timer function (Start, Stop and Status)
• Single makefile to build all example applications under EVM
• Demo application provides RTC functionality
  

Fixed in This Release

• Unaligned memory access causing erroneous behavior in USB and Ethernet example applications is corrected.
• Error recovery added for USB Host MSC application
  
• Data transfer transmit and receive count mismatch corrected in SPI example (Non DMA mode)
• Channel swap corrected in McASP audio loopback example application
• Support added for various word size in McASP driver
• Timer count reset added in Platform library
• VPIF LCD loopback example screen freeze is corrected for GCC tool chain
• Screen layout in game example corrected for GCC tool chain
• MAC address corrected in LCDK Ethernet echo example
• FatFs Port buffers alignment corrected to native cache line length
  
• DSP Exception example corrected to enable external exception bit to proceess the external exceptions.
  

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

• 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

• For a jump-start, please refer to the Quick Start Guide

• For detailed build and usage instructions, please refer to the Getting Started Guide

Upgrade and Compatibility Information

Currently no upgrades are available.

Dependencies

Refer to Host Platform Requirements of the User Guide

Device Support

SOCs Supported:

• OMAPL138

EVMs Supported:

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

Validation Information

None.

Technical Support

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