StarterWare 02.00.00.06 Release Notes

StarterWare Version 02.00.00.06

Date: 2 April, 2012.

Document License

This work 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 02.00.00.06 provides no-OS platform support for TI AM335x GP EVM and Beaglebone which are based on TI AM335x SOC. StarterWare 02.00.00.06 provides Device Abstraction Layer, libraries, peripheral/board level sample/demo examples that demonstrate the capabilities of the peripherals of AM335x. StarterWare comes with pre-compiled binaries for bootloader and example applications which can be run from an SD card.

Supported Features

• Device Abstraction Layer and Example Applications for the peripherals on AM335x as listed in the table below.

Peripherals Supported By DAL	TI AM335x EVM Examples	Beagle Bone Examples
UART	Echo Application in Interrupt Mode Echo Application in DMA Mode	Echo Application in Interrupt Mode Echo Application in DMA Mode
High Speed - I2C	EEPROM R/W in Interrupt Mode EEPROM R/W in DMA Mode Temperature Sensor (Temperature Display) Accelerometer (Board Tilt Angle Measurement)	EEPROM R/W in Interrupt Mode EEPROM R/W in DMA Mode
Multi-channel SPI	SPI Flash R/W in Interrupt Mode SPI Flash R/W in DMA Mode	No Support in BB
DMTimer	ISR Counting	ISR Counting
Watchdog Timer	WDT Demonstration	WDT Demonstration
GPIO	LCD Backlight On/Off Audio Buzzer	LED On/Off
High Speed MMCSD	SD Card Access with FAT File System	SD Card Access with FAT File System
Real-Time Clock (RTC)	Time Set and Get	Time Set and Get
USB	CDC Device Mode Custom Bulk Device Mode MSC Device Mode Mouse Device Mode MSC Host Mode Mouse Host Mode MSC Host + MSC Device Mode	CDC Device Mode Custom Bulk Device Mode MSC Device Mode
Ethernet	Embedded Web Page Access Echo Application with socket-programming	Embedded Web Page Access Echo Application with socket-programming
McASP	Audio Loop-Back	No Support in BB
EDMA	Demonstrated in peripheral level  DMA examples	Demonstrated in peripheral level DMA examples
Raster	Image Display	Not Available
GPMC	NAND Read Write	No Support in BB
ELM	NAND Read Write (Error Location Detection)	No Support in BB
ECAP	Available only as part of OOB Demo	No Support in BB
DCAN	Board-to-Board communciation	No Support in BB
TSC-ADC	Touch Screen Caliberation	No Support in BB
EHRPWM	Rotation of Haptics Motor (available in EVM daughterboard rev. 1.0E and above only)	No Support in BB

 

• Bootloader for TI AM335x EVM which supports MMCSD, NAND, UART and SPI Boot Modes.
• Bootloader for Beagle Bone which supports MMCSD  and UART Boot Modes.
• Ethernet lwIP (a light weight IP stack) Port for AM335X
• MMC/SD Library
• NAND Library
• USB library
• Graphics Library Demo application
• Game application
• APIs to configure Cache and MMU.
• Support for IRQ Preemption. StarterWare IRQ handler is now prioritized IRQ handler. However, if preemption is not desired, all interrupts can be assigned the same priority level.
• Support for switching between Privileged and Non-Privileged modes.
• An Out-Of-Box (OOB) application for TI AM335x EVM using multiple peripherals. Demonstrates Dynamic Volatage Frequency Scaling (DVFS) for four different OPPs for MPU(OPP50, OPP100, OPP120 and SR TURBO). Also demonstrates three sleep modes for power management (Deep Sleep0 and Deep Sleep1) with Timer, Touch Screen, UART and GPIO wake sources 
• An Out-Of-Box (OOB) application for Beagle Bone using multiple peripherals.
• Automation test framework for StarterWare.

What is Not Supported

• Routing of interrupts to FIQ
• Security Extention Features
• Applications using standard malloc/calloc
  • StarterWare 02.00.00.06 Startup Code neither call any library nor initializes heap. Hence does not perform initializations required for malloc/calloc.
• Peripherals or features not mentioned in "Supported Features" section are not supported
• Downloading and debugging support for IAR Embedded Work Bench.

New in this Release

• Support for IRQ Preemption
  • StarterWare IRQ handler is now prioritized IRQ handler (Applicable for all examples).
  • IRQs can be assigned priority levels. Higher priority IRQ can preempt lower priority IRQ. However, if preemption is not desired, all interrupts can be assigned the same priority level.
  • Example for demonstrating IRQ premption with three priority levels for UART, RTC and Timer interrupt.
• OOB Demo application enhanced
  • Added power managment management for DS0 and DS1 modes. Other independent power management examples are removed.
  • Dynamic Voltage Frequency Scaling (for MPU) support added.
• USB Multi-Instance support
  • MSC Host + MSC Device example to demonstrate multi-instance capability
• UART Bootmode support for StarterWare Bootloader
• Improved APIs to configure MMU and Cache
• Graphics Library Demo application
• Game application
• Device Abstraction Layer for EHRPWM
• Haptics Motor Rotation example for EHRPWM(available in EVM daughterboard rev. 1.0E and above only). Haptics Motor Rotation example for GPIO is removed.
• Automatic generation of binary file with header (<app_name>_ti.bin) for bootloader and example applications when built from CCS and IAR.
• Automation Test framework

Fixed in this release

Issue Identifier	Issue Description	Issue Resolution
SDOCM00088739	StarterWare MMU configuration APIs are not present for ARMv7a	MMU configuration APIs are added in mmu.c/.h files
SDOCM00088057	Domain Access Control CP15 register is not saved in power management application during context switch.	Domain Access Control CP15 register is saved before going to sleep.
SDOCM00089526	StarterWare USB Library HID class; Type errors in values used for 'Type of collection' and data field items in usbhid.h	Typo issues corrected
SDOCM00090414	Logical error in the ECAPCapeEvtPolarityConfig() API of ecap DAL. Parameters are not used correctly	Corrected the logical error by using proper parameters for configuration.
SDOCM00087753	USB MSC Dev Mode executable doesnot work in standalone mode. However the .out file works when loaded from CCS.	The command file for CCS modified such that bss section is not loaded and not taken in the binary.

Known Issues / Limitations

Issue Identifier	Issue Description	Workaround
SDOCM00084262	UART: UART EDMA example application is not working in FIFO Enabled mode. The issue is under investigation.	In case of UART EDMA, disable FIFO.
SDOCM00084263	McSPI: McSPI is not working at 48MHz, eventhough the flash and the McSPI controller supports operation at 48MHz	The frequency of operation can be kept at 24MHz for SPI Flash access
SDOCM00090593	lwip Interface : Phy Autonegotiation Doesnt enable the Transfer mode properly. Also, no advertisement is done for Gigabit.	In /drivers/phy.c, in PhyAutoNegStatusGet() API, replace the line " if(PHY_AUTONEG_INCOMPLETE == (data & (PHY_AUTONEG_STATUS)))" with "if(PHY_AUTONEG_COMPLETE == (data & (PHY_AUTONEG_STATUS)))"
SDOCM00085661	UART EDMA example not working consistently with AM335X EVM and Beagle Bone	None
SDOCM00085925	Cache MMU Example application does not work consistently in AM335x EVM and Beagle Bone	None
SDOCM00086202	Hardware register layer files of peripherals which are not part of AM335x SoC are included in the Starterware release package.	None.
SDOCM00086275	Spurious interrupts generation can happen sometimes and generate an abort and halt the execution.	Dummy ISR is added to handled spurious interrupt to demo application. This can be done in any application to prevent spurious interrupt generation from halting the execution.
SDOCM00086180	Starterware web server takes a long time to start sometimes.	Several options in lwipopts.h file can be changed and fine tuned
SDOCM00086319	Beagle Bone Demo application home web page is not coming consistently, when tested across networks	Several options in lwipopts.h file can be changed and fine tuned
SDOCM00086320	The software implementation of CLZ, NumLeadingZeros() in grlib/string.c, misses a special case: the case of being passed a zero.	Update the code to add a check that, if the parameter passed is zero, return 32.
SDOCM00086390	Unable to load .out file from IAR IDE.	None
SDOCM00090972	AM335X: Stability issues are observed with USB Multi-instance MSC class scenarios when tested with usb_device_host_msc e.g.	None
SDOCM00091010	AM335X: GCC generated .bin file of USB Multi-instance MSC example usb_device_host_msc is non-functional	For testing multi instance capability .out file can be used instead of .bin
SDOCM00091026	DS2 is not supported in 02.00.00.06 release	None
SDOCM00091027	OPP50 is not supported for Core voltage domain.	None

• If the CodeSourcery installation path contains white spaces, Cygwin may give errors while linking.

Installation and Usage

• The StarterWare Quick Start Guide explains how the precompiled binary for the demo application can be run on the target

• For detailed user instructions refer to StarterWare User Guide

Dependencies

Refer to Host Platform Requirements of the User Guide

Device Support

SOCs Supported:

• AM335X

EVMs Supported:

• TI AM335x EVM Rev 1.1A and above
• Beagle Bone Rev A3 and above

Technical Support

For further information or to report any problems, contact http://e2e.ti.com