StarterWare 02.00.01.01 Release Notes

StarterWare Version 02.00.01.01

Date: 12 July, 2013.

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.01.01 provides no-OS platform support for TI AM335x GP EVM, TI AM335x EVM-SK and Beaglebone which are based on TI AM335x SOC. StarterWare 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.

Features

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

Features	TI AM335x EVM Examples	Beagle Bone (Base board) Examples	EVM-SK Examples
UART	Echo Application in Interrupt Mode Echo Application in DMA Mode	Echo Application in Interrupt Mode Echo Application in DMA Mode	Echo Application in Interrupt Mode Echo Application in DMA Mode
High Speed - I2C	EEPROM Read in Interrupt Mode EEPROM Read in DMA Mode Temperature Sensor (Temperature Display) Accelerometer (Board Tilt Angle Measurement)	EEPROM Read in Interrupt Mode EEPROM Read in DMA Mode Temperature sensor and Accelerometer are not connected on BB (base board)	EEPROM Read in Interrupt Mode EEPROM Read in DMA Mode Accelerometer (Board Tilt Angle Measurement) Temperature sensor is not connected on EVM-SK
Multi-channel SPI	SPI Flash R/W in Interrupt Mode SPI Flash R/W in DMA Mode	No device is connected to McSPI on BB (base board)	No device is connected to McSPI on EVM-SK
DMTimer	ISR Counting	ISR Counting	ISR Counting
Watchdog Timer	WDT Demonstration	WDT Demonstration	WDT Demonstration
GPIO	LCD Backlight On/Off Audio Buzzer	LED On/Off Audio Buzzer is NOT available in BB (base board)	MMC/SD Card Detection Audio Buzzer is NOT available in EVM-SK
High Speed MMCSD	SD Card Access with FAT File System	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	Time Set and Get
USB	CDC Serial Device Mode Custom Bulk Device Mode MSC Device Mode Mouse Device Mode MSC Host Mode Mouse Host Mode MSC Host + MSC Device Mode MSC Host + Mouse Host  Composite CDC Serial (device) + CDC Serial (device)  Composite CDC Serial (device) + Mouse	CDC Serial Device Mode Custom Bulk Device Mode MSC Device Mode MSC Host MSC Host + MSC Device CDC Serial (device) + CDC Serial (device)  Other examples are not supported due to limitations on beaglebone (baseboard) USB0 port is used for debugger connection and serial port emulation LCD cape daughter board is not supported in StarterWare	CDC Serial Device Mode Custom Bulk Device Mode  MSC Device Mode Mouse Device Mode MSC Host Mode Mouse Host Mode MSC Host + MSC Device Mode CDC Serial (device) + CDC Serial (device) Composite CDC Serial (device) + Mouse Other examples are not supported as USB0 port is used for debugger connection and serial port emulation.
Ethernet	Embedded Web Page Access Echo Application with socket-programming	Embedded Web Page Access Echo Application with socket-programming	Embedded Web Page Access - Default in Dual MAC mode Echo Application with socket-programming - Default in Dual MAC mode Undefining CPSW_DUAL_MAC_MODE in lwipopts.h, both examples can be demonstrated in switch mode
McASP	Audio Loop-Back	Audio Jacks are not available in BB (base board)	Tone Play (Audio IN jack is not available in EVM-SK)
EDMA	Memory to memory transfer	Memory to memory transfer	Memory to memory transfer
Raster	Image Display	LCD cape daughter board is not supported in StarterWare	Image Display
GPMC	NAND Read Write	No device is connected to GPMC on BB (base board)	No device is connected to GPMC on EVM-SK
ELM	NAND Read Write (Error Location Detection)	No device is connected to ELM on BB (base board)	No device is connected to ELM on EVM-SK
ECAP	Available only as part of OOB Demo (LCD brightness control)	LCD cape daughter board is not supported in StarterWare	Available only as part of OOB  Demo (LCD brightness control)
DCAN	Board-to-Board communciation	The DB9 connectors are not available in BB (base board)	The DB9 connectors are not available in EVM-SK
TSC-ADC	Touch Screen Calibration	LCD cape daughter board is not supported in StarterWare	Touch Screen Calibration
EHRPWM	Rotation of Haptics Motor (available in EVM daughterboard rev. 1.0E and above only)	No device is connected to EHRPWM in BB (base board)	No device is connected to EHRPWM in EVM-SK
Bootloader	MMCSD Boot UART Boot SPI Boot NAND Boot	MMCSD Boot UART Boot SPI and NAND flash devices are not available in BB (base board)	MMCSD Boot UART Boot SPI and NAND flash devices are not available in EVM-SK
Graphics Library	Graphics Library Demo Maze Game	LCD cape daughter board is not supported in StarterWare	Graphics Library Demo Maze Game
Out Of Box Demo	Driven via Touch and/or Ethernet (web browser) Peripherals demonstrated - LCD, Ethernet, McASP, MMC/SD, Uart, Timer, RTC, eCAP, GPIO, I2C, ADC_TSC Supports Power Management DS0, DS1, STANDBY, RTC Only*  Wake Sources - UART, GPIO, Touch Screen,  Timer and RTC Alarm*  Supports DVFS OPP50 OPP100 OPP120 SR-TURBO Nitro* (*) - Supported from PG2.x SoC ver.	Driven via Ethernet (web browser) Peripherals demonstrated - Ethernet, MMC/SD, Uart, Timer, RTC Supports Power Management DS0, DS1, STANDBY Wake Sources - UART and Timer Not Supports DVFS OPP50 OPP100 OPP120 SR-TURBO	Driven via Touch and/or Ethernet (web browser) Peripherals demonstrated - LCD, Ethernet, McASP, MMC/SD, Uart, Timer, RTC, eCAP, GPIO, I2C, ADC_TSC Supports Power Management DS0, DS1, STANDBY Wake Sources - UART, GPIO, Touch Screen, Timer and RTC Alarm* Supports DVFS OPP50 OPP100 OPP120 SR-TURBO Nitro* (*) - Supported from PG2.x SoC ver.
RTC Only (Low power mode)	Not supported in EVM (PG.1.0) due to 1. Polarity of External wake is wrongly connected in EVM 2. Silicon issue (Refer errata - Advisory 1.0.5 RTC: 32.768-kHZ Clock is Gating Off) Note: This issue is not applicable for AM335x PG2.1	Not supported in BB due to 1. External wake is not accessible in BB 2. Silicon issue (Refer errata - Advisory 1.0.5 RTC: 32.768-kHZ Clock is Gating Off)	Not supported in EVM-SK due to 1. External wake is not accessible in EVM-SK 2. Silicon issue (Refer errata - Advisory 1.0.5 RTC: 32.768-kHZ Clock is Gating Off)
Neon/Vfp	Example includes performance measurement of Vectorized float operations. Math lib (Sine and Cosine functions with and without intrinsics) - GCC alone	Example includes performance measurement of Vectorized float operations. Math lib (Sine and Cosine functions with and without intrinsics) - GCC alone	Example includes performance measurement of Vectorized float operations. Math lib (Sine and Cosine functions with and without intrinsics) - GCC alone
SGX GFX	Not supported in StarterWare	Not supported in StarterWare	Not supported in StarterWare
Crypto	Not supported in StarterWare	Not supported in StarterWare	Not supported in StarterWare
PRU-ICSS	Not supported in StarterWare	Not supported in StarterWare	Not supported in StarterWare
EMAC- IEEE 1588	Not supported in StarterWare	Not supported in StarterWare	Not supported in StarterWare
eQEP	Not supported in StarterWare	No device is connected in BB	No device is connected in EVM-SK
NOR	Not supported in StarterWare	No device is connected in BB	No device is connected in EVM-SK

 

• Ethernet lwIP (a light weight IP stack) Port for AM335X
• MMC/SD Library
• NAND Library
• USB library
• 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.
  
  

New in this Release

• AM335x PG2.1 support
• Power Management features:

1. DS0, DS1, Standby supported on EVM, EVMSK and beaglebone
2. RTC-Only mode supported for GP EVM alone
3. RTC Alarm wake source supported from PG2.x SoC ver.

• J-Link Emulator: Using J-Link to download and debug executables with IAR IDE
• Neon/Vfp support and performance benchmarking
• Semihosting support with GCC and CCS
• GCC tool chain change from Code sourcery to Linaro
• Added generic console utils APIs
• Additional example to demonstrate EDMA memory to memory copy.
• Added ethernet phy configurations and ALE configurations in enet_lwip example

Compatibility with last release

• The DDR part for EVM 1.2 and 1.5 are different. The default IAR projects in this release are configured to point to DDR3 (EVM v1.5) mac file. This need to be changed for v1.2 boards.
• The binary path are updated to be uniform across boards and tool chains, such that each project can create debug and release binaries in the corresponding folder.

Fixed in this release

For the list of issues fixed in this release please refer issues fixed.

What is Not Supported

• Performance Benchmarking: Bench marking for Cortex A8 and peripherals
• Routing of interrupts to FIQ (Not supported in AM335x GP devices)
• Security Extention Features (Not supported in AM335x GP devices)
• Data Cache Enabling on TI AM335x EVM and BeagleBone Examples (not all examples cache)
• Deep Sleep2 is not supported

Known Issues / Limitations

Issue Identifier	Issue Description	Workaround
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
SDOCM00086275	Spurious interrupts generation can happen sometimes and generate an abort and halt the execution.	Dummy ISR is added to handle spurious interrupt during INTC initialization. This ISR just returns to the caller without performing anything.
SDOCM00094747	Uart examples will not work with baud rates - 460800 and 921600.	Use UART_13x_OPER_MODE operating mode for baudRates higher than 230400 for EVMSK and BB boards.
SDOCM00091027	OPP50 is not supported for Core voltage domain.	None
SDOCM00099631	The UartEcho example for EVMSK prints some non-english characters on the serial console when it is tested with BaudRate: 115200/230400; Word length: 7; Stop Bits : 1; Parity : No;	None
SDOCM00102444	Enabling Cache for NAND example with DMA mode of GPMC leads to uncorrectable ECC errors	None. Use PIO mode.
SDOCM00101777	Pen Up interrupts for touch screen http://e2e.ti.com/support/embedded/starterware/f/790/p/248332/876470.aspx#876470	None
SDOCM00101336	The DCAN example does not display an error message to the user if the board is in incorrect profile. Due to this the example hangs and user is not notified what is the root cause for the hang.	Ensure the board is in correct profile before executing the example.
SDOCM00101335	The Ehrpwm_haptics examples do not display an error message to the user if the board is in incorrect profile. Due to this the example hangs and user is not notified what is the root cause for the hang.	Ensure the board is in correct profile before executing the example.
SDOCM00097936	Default interrupt handler simply returns without doing anything. As per discussion in the attachment it should print an error message or wait in infinite loop.	Default handler can be updated to give proper indication.
SDOCM00097509	When a STALL handshake is returned by an MSC device , the endpoint needs to be cleared and depending on whether it is READ10 or WRITE10 the transafer needs to be retried or CSW fetched. This is not being done by the USB stack currently and it is resetting the target. This needs changes to all layers of the USB stack and has to be done in a generic fashion so that the class driver always handles class specific errors.	None
SDOCM00102489	In the SPI boot mode for EVM, the SPI bootloader binary generated using IAR toolChain fails to bootup the application when it is loaded on the SPI flash connected on the EVMAM335x board.	None
SDOCM00102490	The CCS generated binary of NeonVFPBenchmark application for EVMSK and BB for Debug and Release configuration differ in size. With the Debug binary size being lesser in size than the Release configuration.	None

• If the Linaro installation path contains white spaces, Cygwin may give errors while linking.
  
• In RTC Only mode distorted image is observed on LCD with EVM 1.5x.
  

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
• TI AM335x EVM-SK Rev 1.2B and above
• Beagle Bone Rev A3 and above

Technical Support

For further information or to report any problems raise a query in StarterWare e2e forum.