Texas Instruments TMS320F280 Series User manual

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 1

TMS320F2808, TMS320F2806, TMS320F2802 and

TMS320F2801

SDFlash JTAG Flash Programming Utilities

SDFlash Algo V1.1

These algorithms are based on the following Flash APIs from TI:

TMS320F2808 Flash API V3.02

TMS320F2806 Flash API V3.02

TMS320F2802 Flash API V3.02

TMS320F2801 Flash API V3.02

This download includes SDFlash algorithm files used to interface

the TMS320F2808, TMS320F2806, TMS320F2802 and TMS320F2801

FLASH APIs V3.02 to the SDFlash JTAG flash utility.

SDFlash is a product of Spectrum Digital Inc.

(www.spectrumdigital.com)

Document updated:

February 13, 2006

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 2

SDFlash Algo Disclaimer

These algorithms are based on PRELIMINARY Flash APIs for initial TMS silicon sampling.

Please check the Spectrum Digital website for future updates.

The SDFlash Algorithm files in this download include the F280x Flash Application Program

Interface (Flash API) libraries V3.02:

Flash2808_API_V302.lib

Flash2806_API_V302.lib

Flash2802_API_V302.lib

Flash2801_API_V302.lib

Texas Instruments Inc. (TI) reserves the right to update or change any material included with

this release. This includes:

The API functional behavior based on continued TMS320F280x testing.

Improvements in algorithm performance and functionality.

It is the user’s responsibility to check for future updates to the SDFlash Algo Files based on

any updates to the F280x Flash APIs and to use the latest version available for their F280x

silicon.

Updates to the API will be posted on the Texas Instruments Inc website (www.ti.com) and

can also be obtained by contacting Texas Instruments’ support. Updates to the SDFlash

algorithm files will also be posted on the Spectrum Digital website

(www.spectrumdigital.com.)

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 3

Contents:

1. Revision History..............................................................................................................................................4

2. Release Notes.................................................................................................................................................5

3. Known Limitations...........................................................................................................................................5

4. API Revision vs. Silicon Revision ...................................................................................................................6

5. SDFlash Overview ..........................................................................................................................................7

6. Quick Start Guide............................................................................................................................................8

7. PLL and CPU Clock Rate Configuration.......................................................................................................14

8. Code Security Module (CSM) Password Considerations.............................................................................17

9. SDFlash User Options ..................................................................................................................................18

9.1. Specify Which Sectors to Erase: Erase User Option 1 ........................................................................18

9.2. Configure Flash and OTP wait states: Verify User Option 1 and Verify User Option 2 .......................21

9.3. CPU Frequency and PLL Multiplier Configuration Toggle Test: User Option 3...................................22

10. Depletion Recovery Algorithm ......................................................................................................................24

11. Troubleshooting Tips ....................................................................................................................................25

11.1. DSP Reset Fails ...................................................................................................................................25

11.2. All Operations .......................................................................................................................................25

11.3. Erase Fails............................................................................................................................................26

11.4. Programming Fails................................................................................................................................27

11.5. Verify Fails............................................................................................................................................27

11.6. Programmed Application Fails To Run.................................................................................................27

12. API Error Codes............................................................................................................................................29

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 4

1. Revision History

This is the revision history for the F280x algorithm builds for SDFlash. Note that the SDFlash algorithm build

version is separate from the SDFlash front-end utility version.

V1.1

Updated release based on API V3.02. Please continue to check for future updates.

This is an optional update for users of the TMS320F2808, F2806 and F2801 devices. Support for the

F2802 device was added in this revision.

V1.0

Updated release based on API V3.00. Please continue to check for future updates.

All users of the TMX320F2808, F2806 and F2801 must update. The APIs used by this version is required

for revision B silicon and later. It is fully backward compatible with all previous silicon revisions.

User option 3 for all operations (erase, program, and verify) now performs the toggle test.

Any GPIO pin (0-34) can now be used for the toggle test. As before, the pin number is specified in hex (for

example GPIO34 is 0022).

Beta4

Updated to preliminary API V200.

Beta3

Updated the API to beta2 to fix an erase by sector issue.

Beta2

The Beta1 version of the SDFlash linker .cmd file used the memory block L1 as the buffer location ( it was

incorrectly labled as L0). This memory block is not present on the F2801 devices and thus the SDFLash

would program all 0’s instead of the desired code. Verify would also use L1 and so the error went

undetected by SDFlash. This update has corrected the linker file and re-compiled all of the projects to

correctly use the L0 memory block which is present on all F280x devices

This release still uses the Beta1 version of the API. Only the SDFlash files were changed.

Initial support for F280x TMX silicon sampling only. A preliminary beta version of the API is used (beta1).

Please check Spectrum Digital’s website for future updates.

Beta1

Initial support for F280x TMX silicon sampling only. A preliminary beta version of the API is used. Please

check Spectrum Digital’s website for future updates.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 5

2. Release Notes

This release of the SDFlash Algo’s is based on Flash API V302. This API is available on the TI website

(SPRC193). Please check the TI website for future updates to the API.

Some traditional programming utilities have separate operations for “Clear” and “Erase”. These two

operations have been combined into one operation referred to only as “Erase”.

Note: The CSM will be permanently locked if the CSM password locations are loaded with all 0x0000

and the device is secured. During the combined “Erase” function, a sector clear is immediately

followed by an erase operation without resetting the device. This will help avoid permanently

locking the CSM. Do not program the CSM passwords with all 0x0000.

SDFlash does not support the XDS560 scan controller.

You should not run SDFlash and Code Composer at the same time. This results in two different

applications trying to control the DSP. During programming, SDFlash will have complete control of the

device. No user application code can be running in parallel.

3. Known Limitations

SDFlash only programs sections linked to page 0 (i.e. program) memory. For F280x users it is important to

make sure that sections such as .switch, and .const/.econst section are linked to page 0 and not page 1 for

SDFlash to program it.

When specifying User Options for SDFlash functions do not use a leading 0x in front of the number. Enter

only the hex value with no leading 0x. For example: correct: 03FF incorrect: 0x03FF

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 6

4. API Revision vs. Silicon Revision

The silicon revision can be determined by the lot trace code marked on the top of the package. The figure below

provides an example of the TMS320F280x markings. Some prototype devices may have markings different from

those illustrated. Refer to the TMS320F2808, TMS320F2806, TMS320F2802, TMS320F2801, UCD9501 DSP

Silicon Errata (literature number SPRZ171) for information on how to determine your device’s silicon revision.

Second Letter In

Prefix of Trace Lot

Code

REVID

(Addr 0x883)

Obsolete

SDFlash JTAG Algorithms

These Algorithms are Obsolete

and No Longer Recommended 1

Recommended

SDFlash Version

Blank 0x0000 beta1- beta4 V1.0 or Later2

A 0x0001 beta1- beta4 V1.0 or Later2

B 0x0002 beta1- beta4 V1.0 or Later2

Later >= 0x0002 beta1- beta4 V1.0 or Later2

1Previous versions of the SDFlash algorithms are based on Flash APIs that are obsolete and no longer

recommended for use:

API Version 2.00: F2808_API_V200.lib, F2806_API_V200.lib, F2801_API_V200.lib

SDFlash Beta 4 used the V2.00 API. As of revision B silicon, this API will report a

STATUS_FAIL_API_SILICON_MISMATCH error. The flash will not be modified.

API Version 1.00 and earlier: F2808_API_V100.lib, F2806_API_V100.lib, F2801_API_V100.lib

For proper reliability and programming performance these APIs must not be used.

2SDFlash V1.0 and earlier do not support the F2802 device. V1.1 is the first version to support the F2802.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 7

5. SDFlash Overview

SDFlash is a generic front-end application owned by Spectrum Digital Inc (www.spectrumdigital.com). This

application provides a generic interface to the JTAG communications channel that can be used to support flash

programming.

In order to erase or program flash, SDFlash downloads a flash algorithm file onto the DSP. This algorithm file is an

executable (.out) file for the DSP being programmed and is executed on the DSP target. For the F280x, the

SDFlash algorithm file consists of an SDFlash wrapper and the F280x Flash API library. The SDFlash wrapper has

well defined standard functions and variables that are accessed by SDFlash over the JTAG channel. These

functions in turn make calls to the Flash API Library to perform operations on the flash array. Note: because the

SDFlash interface is separate from the algorithm file, the version of the SDFlash interface will differ from the version

of the algorithm file.

SARAM

Buffer

SDFlash Algo

File

CPU

OTP and

FLASH

ARRAY

JTAG

SDFlash

Wrapper

Flash API

SDFlash

Front-End

F280x/281x DSP PC

SDFlash

Algorithum File

Flash Data File

(.out to be

programmed)

Note:

For future silicon revisions, TI anticipates that no functional changes will be required to these

APIs (and hence no changes should be required to SDFlash algorithms).

Should API changes occur that affect the programming of the flash, it is the user’s

responsibility to update any application that uses the API (programmers, embedded software,

etc) to insure proper long-term operation of the flash. TI will test these APIs on future silicon

revisions as soon as possible when such devices become available. Updates that only add

features are not required.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 8

For SDFlash to erase or program the flash on a device, it must have

the following information:

Location of the SDflash algorithm file

Location of the flash data file – that is the data (.out file)

to program into the device.

Any user defined options.

Which JTAG driver to use

Information about the JTAG scan chain

All of this information is stored in an SDFlash project file (.sdp) that

can be edited though the SDFlash GUI interface. A sample

SDFlash project for each F280x device has been provided in this

download.

Section 6 of this document will guide you through the SDFlash setup and show you how to use the provided sample

SDFlash projects to create your own project and flash the F280x device.

For example F280x code that executes from the flash, refer to the following available from the TI website:

C280x C/C++ Header Files and Peripheral Examples V1.00 (SPRC191)

Running an Application from Internal Memory on the TMS320F281x DSP (SPRA958) This

application note is written for the 281x family of DSPs but can be applied to the 280x family as

well.

6. Quick Start Guide

The following is a step-by-step guide for using the SDFlash utility to program your F280x device.

This quick start guide will refer to the following default directory locations:

<CCS> default Code Composer Studio install directory: "c:\ti"

<SDFlash> default SDFlash directory <CCS>\specdig\SDFlash

These directories may be different for your particular installation.

6.1. Make sure the target and emulator are setup properly:

•If you are using the F2808 onboard eZdsp USB emulator, run the F2808 EzDSP Diagnostics utility.

This diagnostic is included as part of the F2808 eZdsp installation.

•If you are using an XDS510/XDS510pp+/SPI515 emulation controller, use the SDConfig utility. The

F2808 on-board USB emulator is not supported by SDConfig. SDConfig is part of the default

emulation installation and will be installed in your

<CCS>\specdig\sdconfig directory

SDFlash Project

(.sdp)

Flash Data

File

Algo File

Options

Communications

Driver

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 9

CAUTION

6.2. Install the SDFlash flash support utility.

A version of SDFlash is included on the F2808 eZdsp CD. SDFlash will typically be installed in your

<CCS>\specdig\SDFlash directory.

SDFlash is a generic utility supplied by Spectrum Digital Inc. to interface to user written algorithms. In

this case, Texas Instruments Inc has supplied the algorithm file. Users should check the SD website for

updates to this utility.

6.3. Download the latest F280x SDFlash algorithm files.

A version of the algorithms is included on the F2808 eZdsp CD. Future releases and upgrades will be

available for download from the Spectrum Digital website in the Support Utilities->SdFlashAlgo’s

section.

The current version of the algos is considered beta material for initial sampling.

Please check Spectrum Digital’s website for future updates.

6.4. Unzip the F280x SDflash algorithm files into the myprojects

subdirectory of SDFlash. For a typical install this will be the

<CCS>\specdig\SDFlash\myprojects directory.

This will automatically create a directory indicating the processor and

version of the utilities.

Note: If you had installed an earlier release of SDFlash on your system

you may have additional sub-directories to those shown, such as an algo

directory. With the release of SDFlash V1.3 the algo directory was

replaced with the myprojects directory. Presence of this directory will not

effect the operation of SDFlash.

6.5. Run SDFlash.

Load the supplied SDFlash sample project. SDFlash uses project files to store information required

to erase a device and program an .out file into a device. Sample F2801, F2806 and F2808 projects

have been included in tif280x_v1_0.zip for use as project templates.

Using File->Open Project in SDFlash,browse to and load the appropriate sample SDFlash project.

These sample projects program a flash image that is an address = data pattern. The CSM password is

not programmed. For a typical installation, these files will be found in the following location:

F2808 eZdsp*: <SDFlash>\myprojects\tif280x_V1_0\f2808\SampleF2808eZdspUSB.sdp

F2808: <SDFlash>\myprojects\tif280x_V1_0\f2808\SampleF2808.sdp

F2806: <SDFlash>\myprojects\tif280x_V1_0\f2806\SampleF2806.sdp

F2802: <SDFlash>\myprojects\tif280x_V1_0\f2802\SampleF2802.sdp

F2801: <SDFlash>\myprojects\tif280x_V1_0\f2801\SampleF2801.sdp

* This project uses the F280x eZdsp locked on-board USB emulation driver.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1

Texas Instruments Inc. 10

6.6. Modify the SDFlash project (if required) to locate the various elements such as device driver,

algorithm file and flash data file.

If you installed Code Composer Studio (CCS) and SDFlash in the <CCS base> and <SDFlash base>

directories shown below, then usually only the Flash Data File on the Program Tab, and possibly the

Emulator Address/ID on the Target Tab needs to be changed.

By default all flash projects are setup relative to the default TI CCS base directory "c:\ti". For example:

<CCS> default Code Composer install directory: "c:\ti"

<SDFlash> default is <CCS>\specdig\SDFlash

SDFlash binary default is <CCS>\specdig\SDFlash

Flash projects default is <CCS>\specdig\SDFlash\myprojects\<projectname>

To change any of the directory paths or project settings from their default values, open the project settings

dialog box: Project->Settings

The fields that require directory paths in the Project->Settings window are summarized below:

Target Tab: Erase Tab: Programming Tab: Verify Tab:

-Driver -Algorithm File -Algorithm File -Algorithm File

-Board File -Flash Data File

Target Tab:

Driver: This is the Code Composer StudioTM emulation driver (*.dvr) file that is used to communicate

with the target. The driver files can be found in the <CCS>\drivers\ directory.

default for the eZdsp: <CCS>\drivers\ sdgo28xxeZdspusb.dvr.dvr

default for other 510PP+/SPI515 etc: <CCS>\drivers\sdgo28x.dvr

Emulator Address/ID: default is 378 for the 510pp, it is 510 for the USB driver. This address must

match the setting in your SDConfig setup.

Board file: File that provides SDFlash information on how many devices are on the JTAG scan

chain. For a single 28x device on the scan chain, the default board file can be used. For systems

with more devices on the scan chain, use the board file generated by Code Composer Studio to

access your device. This file is found in the <CCS>\cc\bin\BrdDat directory.

The default board file is <SDFlash>\myprojects\tif280x_V1_0\ccBrd028x.dat

Processor name: default is cpu_0

NOTE

The location of the SDFlash directories may be different for your particular installation.

For example, the <CCS base> directory for some Code Composer Studio installations

will be C:\CCStudio_v3.1.

In this case, the SDFlash project will need to be updated to reflect the directory

structure of your install.

To change any of the directory paths or project settings from their default values, open

the project settings dialog box: Project->Settings

This manual suits for next models

Table of contents

Other Texas Instruments Computer Hardware manuals

Texas Instruments

Texas Instruments TMS320C6201 User manual

Texas Instruments

Texas Instruments TPS65981EVM User manual

Texas Instruments

Texas Instruments LM97937EVM R2 User manual

Texas Instruments

Texas Instruments SimpleLink Wi-Fi BoosterPack CC3120 Manual

Texas Instruments

Texas Instruments TMAG5170D User manual

Texas Instruments

Texas Instruments TMDSCNCD28P65X Technical manual

Texas Instruments

Texas Instruments SimpleLink CC3200 Wi-Fi User manual

Texas Instruments

Texas Instruments EDMA3 User manual

Texas Instruments

Texas Instruments TPS65941213-Q1 User manual

Texas Instruments

Texas Instruments TPS62065 User manual

Texas Instruments

Texas Instruments TPS65910A Series User manual

Texas Instruments

Texas Instruments GC5328 User manual

Texas Instruments

Texas Instruments Hercules RM48 User manual

Texas Instruments

Texas Instruments tideP-0095 Guide

Texas Instruments

Texas Instruments BoosterPack BOOSTXL-RS232 User manual

Texas Instruments

Texas Instruments TMS320*2801 Series User manual

Texas Instruments

Texas Instruments AM62A7 Guide

Texas Instruments

Texas Instruments CC3100 SimpleLink User manual

Texas Instruments

Texas Instruments bq78350-R1 User manual

Texas Instruments

Texas Instruments PCI7620 User manual

Texas Instruments

Texas Instruments DUAL SOCKET PC CARD CONTROLLER PCI1520... User manual

Texas Instruments

Texas Instruments ADS125H02 User manual

Texas Instruments

Texas Instruments BT-MSPAUDSOURCE-RD User manual

Texas Instruments

Texas Instruments TS3USB3031 User manual

Popular Computer Hardware manuals by other brands

EMC2

EMC2 VNX Series Hardware Information Guide

Panasonic

Panasonic DV0PM20105 Operation manual

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 user manual

Gigabyte

Gigabyte B660M DS3H AX DDR4 user manual

Raidon

Raidon iT2300 Quick installation guide

National Instruments

National Instruments PXI-8186 user manual

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual