StarterWare 01.00.03.03 Release Notes

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 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.00.03.03 provides no-OS platform support for the AM1808-based Logic PD Evaluation Module (EVM). StarterWare 01.00.03.03 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 AM1808.

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)

(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

• lwIP port for AM1808

• 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

• 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.00.03.03 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 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 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 AM1808 devices
  • Added EMIFA support to NANDLIB
  • NAND example application(s) now use NANDLIB instead of custom NAND code

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

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

• AM1808

EVMs Supported:

• AM1808-based Logic PD Evaluation Module

Validation Information

None.

Technical Support

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