StarterWare 02.00.01.01 Release Notes

From Texas Instruments Wiki
Jump to: navigation, search

TIBanner.png

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)

  1. USB0 port is used for debugger connection and serial port emulation
  2. 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

  1. Vectorized float operations.
  2. Math lib (Sine and Cosine functions with and without intrinsics) - GCC alone

Example includes performance measurement of

  1. Vectorized float operations.
  2. Math lib (Sine and Cosine functions with and without intrinsics) - GCC alone

Example includes performance measurement of

  1. Vectorized float operations.
  2. 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

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.