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

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 11
Erase Tab:
Algorithm File:
F2801: <SDFlash>\myprojects\tif280x_V1_0\f2801\flash28\Debug\SDFlash2801_erase.out
F2802: <SDFlash>\myprojects\tif280x_V1_0\f2802\flash28\Debug\SDFlash2802_erase.out
F2806: <SDFlash>\myprojects\tif280x_V1_0\f2806\flash28\Debug\SDFlash2806_erase.out
F2808: <SDFlash>\myprojects\tif280x_V1_0\f2808\flash28\Debug\SDFlash2808_erase.out
Timeout: leave as 3000
User Options 1: Erase sector mask default is 000F.
See section 9 for more information.
For all other boxes the default is blank.
Program Tab:
Algorithm File:
F2801: <SDFlash>\myprojects\tif280x_V1_0\f2801\flash28\Debug\SDFlash2801_program.out
F2802: <SDFlash>\myprojects\tif280x_V1_0\f2802\flash28\Debug\SDFlash2802_program.out
F2806: <SDFlash>\myprojects\tif280x_V1_0\f2806\flash28\Debug\SDFlash2806_program.out
F2808: <SDFlash>\myprojects\tif280x_V1_0\f2808\flash28\Debug\SDFlash2808_program.out
Flash Data File: This is the .out file that you want to program into the flash. The sample image
provided with the algorithm is a simple data = address pattern. The code security module
password locations are not programmed by the sample image. That is, the CSM password
locations are left erased (all 0xFFFF’s) so that the CSM can easily be unlocked.
If you have your own .out file ready to be programmed you can specify that file as the data file.
The sample image Flash Data File is located at:
F2801: <SDFlash>\myprojects\tif280x_V1_0\f2801\image\Debug\image2801.out
F2802: <SDFlash>\myprojects\tif280x_V1_0\f2802\image\Debug\image2802.out
F2806: <SDFlash>\myprojects\tif280x_V1_0\f2806\image\Debug\image2806.out
F2808: <SDFlash>\myprojects\tif280x_V1_0\f2808\image\Debug\image2808.out
Timeout: leave as 3000
For all other boxes the default is blank.
Verify Tab:
Algorithm File:
F2801: <SDFlash>\myprojects\tif280x_V1_0\f2801\flash28\Debug\SDFlash2801_verify.out
F2802: <SDFlash>\myprojects\tif280x_V1_0\f2802\flash28\Debug\SDFlash2802_verify.out
F2806: <SDFlash>\myprojects\tif280x_V1_0\f2806\flash28\Debug\SDFlash2806_verify.out
F2808: <SDFlash>\myprojects\tif280x_V1_0\f2808\flash28\Debug\SDFlash2808_verify.out
Timeout: leave as 3000
User Options 1: Flash wait states: default is 0F0F
User Options 2: OTP wait states: default is 001F
For all other boxes the default is blank.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 12
6.7. Save the SDFlash project file: File->Save Project As. Once you have made the required changes
select ok and save the project using the name of your choice: File->Save Project As.
If you changed the Emulator Address/ID setting on the Target Tab, you should get a message that the
current driver was unloaded and a new driver has been loaded. This operation is required to
synchronize the SDFlash project settings with SDConfig. If you did not change the Emulator
Address/ID, then you will not get this message.
You have now created an SDFlash project that can be used anytime you want to erase or program the
device using these settings. Should you want to program a different .out file into the F280x flash, use
this project as a template and change the Flash Data File on the Program Tab.
6.8. Configure the algorithm for the required PLL multiplier and CPU frequency.
For custom CPU frequency and PLL multiplier, you must follow the instructions in section
7 to properly configure the algorithms before continuing. As supplied, the algorithm is
configured for:
PLLCR = 0x000A (PLL x10/2 mode), and CPU frequency = 100MHz
CAUTION
The erase and program operations MUST be configured for the CPU clock rate
(SYSCLKOUT) at which they will run. This configuration is VITAL for proper
operation of the algorithm.
As supplied, the algorithm is configured for:
PLLCR = 0x000A (PLL x10/2 mode), and CPU frequency = 100MHz
For custom CPU frequency and PLL multiplier, you must follow the instructions in
section 7 to properly configure the algorithms before continuing.
6.9. Optional: View which sections are going to be programmed (i.e. loaded) using the
View->Coff/Hex file stats SDFlash function.
Make sure that no RAM locations are marked as load sections.
Constant sections (i.e. .const/.econst) must be linked to page 0 (i.e. program memory) for
SDFlash to program them.
It is suggested to not program the CSM password locations (0x3F7FF8-0x3F7FFF) during
development since flash contents will be changed often.
If programming the OTP, note that it can only be programmed once. It cannot be erased.
6.10. Reset the device: Device->Reset.You will get a pass/fail message in the output window.
6.11. Erase/Program/Verify your device: Device->-Flash.Check or un-check the operation(s) you want to
perform then select start. Each checked operation is executed from left to right, with continue on
success and abort on fail. Refer to Section 11 for tips should a failure occur.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 13
CAUTION
Do not press the SDFlash STOP button during the erase operation.
Pressing STOP will halt the CPU before the Erase algorithm completes. This can leave
the Flash in a depleted state or result in unknown Code Security Module passwords
and lock the device permanently.
Other conditions that can cause the CPU to halt prior to the completion of the Erase
algorithm (e.g., power loss, device reset, PC crash, etc.) can result to the same problem
described above.
Pressing STOP when executing the frequency toggle test described in section 9.3 is ok.
6.12. Optional: Repeat erase/programming for each device to be programmed. If additional devices are
to be programmed, the target can be powered down and a new target connected without closing the
SDFlash utility. Once the new target is connected, reset the part (Device->Reset) and erase, program,
verify (Device->Flash) the device as described in 6.10 and 6.11.
6.13. Optional: View the flash contents using Code Composer StudioTM (CCS). You can view the
programmed flash using CCS, and compare with your source code.
Make sure that the SDFlash utility is closed before starting CCS.
Start CCS and open a memory window to view the flash contents (or use the disassembly window). In
addition you can load the CCS project and load the symbols from the .out file.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 14
7. PLL and CPU Clock Rate Configuration
CAUTION
The F280x Flash API used by SDFlash contains several delay parameters that
are implemented as software delays. Timing of these delays is VITAL to proper
operation. To ensure the proper delays, the flash algorithms must be run at the
correct speed.
As shipped, the algorithms are configured for the following:
20 MHz input clock
x10 PLLCR (0x000A)
½ CLKINDIV enabled
This results in a 100 MHz CPU clock (SYSCLKOUT)
If your hardware requires any of the following:
a different CPU rate (SYSCLKOUT) then 100MHz
or requires a different PLLCR setting then 0x000A
or requires the PLL to be disabled
or requires that CLKINDIV is set (1/2 disabled in this case PLLCR must
be set to 0x0000)
then you must modify and re-compile the flash programming algorithms for
your system’s specific requirements as described below:
The following steps describe how to compile a new SDFlash algorithm file for a custom frequency and
PLL Control Register (PLLCR) setting.
7.1. Using Code Composer Studio (CCS), load the projects for your device. There is one project per
operation and all must be re-compiled for the new PLL configuration. These are the CCS
projects used to build the SDFlash algorithm files. The projects are:
F2801: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2801\flash28\
SDFlash2801_Erase.pjt, SDFlash2801_Program.pjt,
SDFlash2801_Verify.pjt SDFlash2801_DepRecover.pjt
F2802: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2802\flash28\
SDFlash2802_Erase.pjt, SDFlash2802_Program.pjt,
SDFlash2802_Verify.pjt SDFlash2802_DepRecover.pjt
F2806: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2806\flash28\
SDFlash2806_Erase.pjt, SDFlash2806_Program.pjt,
SDFlash2806_Verify.pjt SDFlash2806_DepRecover.pjt
F2808: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2808\flash28\
SDFlash2808_Erase.pjt, SDFlash2808_Program.pjt,
SDFlash2808_Verify.pjt SDFlash2808_DepRecover.pjt

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 15
7.2. Specify the required PLLCR (PLL Control Register) value.
In CCS, open and modify SDFlash280x_Wrapper.h to specify the PLLCR (PLL Control Register) value.
Uncomment the line corresponding to the required PLL Control Register (PLLCR) setting. This is done
by removing the leading // in front of the correct line. Only one line should be uncommented.
For example: To have the algorithms initialize the PLLCR register to 0x0009 uncomment the second
line and comment out the remaining lines as shown:
// #define PLLCR_VALUE 0x000A // SYSCLKOUT = (OSCLK*10)/2
#define PLLCR_VALUE 0x0009 // SYSCLKOUT = (OSCLK*9)/2
// #define PLLCR_VALUE 0x0008 // SYSCLKOUT = (OSCLK*8)/2
etc …..
7.3. Specify the clock rate of the CPU (SYSCLKOUT) in nanoseconds. In CCS, open and modify the
API configuration file Flash280x_API_Config.h to specify the clock rate of the CPU (SYSCLKOUT) in
nanoseconds. This is done by removing the leading // in front of the correct line. Only one line should
be uncommented. The file lists a number of commonly occurring clock rates. If your CPU clock rate is
not listed, then provide your own definition using the examples as a guideline.
For example: Suppose the final CPU clock rate will be 80 Mhz. This corresponds to a 12.5 nS cycle
time. There is no line present for this clock speed, so you should insert your own entry and comment
out all other entries:
//#define CPU_RATE 10.000L // for a 100MHz CPU clock speed (SYSCLKOUT)
#define CPU_RATE 12.5000L // for a 80MHz CPU clock speed (SYSCLKOUT)
//#define CPU_RATE 13.330L // for a 75MHz CPU clock speed (SYSCLKOUT)
//#define CPU_RATE 20.000L // for a 50MHz CPU clock speed (SYSCLKOUT)
etc…..
CAUTION
For flash integrity at operating frequencies, the device should always be programmed
at the fastest possible CPU frequency. For example, if the CLKIN frequency is 20 MHz
program the device at 100 MHz rather then 10 MHz or 20 MHz.
The flash utilities are not designed to function properly below 10 MHz.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 16
7.4. If your system requires any other custom setup such as modifying the CLKINDIV bit then:
Open the SDFlash280x_Main.c file. The code that is executed on startup to setup the PLL is at the
beginning of the main() function within this file. Modify this function as required for your clock
requirements.
7.5. Rebuild each of the algorithms in CCS by selecting Project->Rebuild all.
CAUTION
It is important to rebuild all of the algorithm files: erase, program, verify and depletion
recovery.
7.6. Exit Code Composer Studio
7.7. Run the CPU frequency and PLL multiplier configuration toggle test described in section 9.3
from SDFlash to verify the configuration.
When run, this test will toggle a selected GP I/O pin at a known frequency. This will allow you to
confirm that the algorithms are properly configured for the CPU frequency and PLL multiplier you
specified.
CAUTION
It is strongly recommended that you test the CPU frequency and PLL configuration
using the configuration toggle test described in section 9.3 before erasing or
programming any parts.
If this test fails, DO NOT PROCEED to erase or program the flash until the problem is
corrected, or flash damage can occur.
The SDFlash algorithm file should now be configured for your hardware’s frequency requirements.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 17
8. Code Security Module (CSM) Password Considerations
The F280x SDFlash algos must unlock the Code Security Module (CSM) before an erase, program, or verify
operation. As supplied, the password locations are assumed to be all erased (all 0xFFFFs). During the code
development phase, it is suggested that the CSM passwords be left erased (0xFFFFs) for ease of use. If you
program new passwords into the CSM password locations (0x3F7FF8-0x3F7FFF) and then later need to re-
program the part, you will need to configure the flash algorithms so that the CSM can be unlocked. Refer to
TMS320x280x System Control and Interrupts Peripheral Reference Guide, for details on the proper operation of the
CSM.
The algorithm uses the CSM keys provided in the appropriate CSM key assembly file:
(SDFlash28x_Erase_CsmKeys.asm, SDFlash28x_Program_CsmKeys.asm, or SDFlash28x_Verify_CsmKeys.asm)
to unlock the CSM. Follow these steps to build an SDFlash algorithm file with a new set of CSM passwords.
8.1. Using Code Composer Studio (CCS), load the projects for your device. There is one project per
operation and all must be re-compiled for the new PLL configuration. These are the CCS
projects used to build the SDFlash algorithm files. The projects are:
F2801: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2801\flash28\
SDFlash2801_Erase.pjt, SDFlash2801_Program.pjt,
SDFlash2801_Verify.pjt SDFlash2801_DepRecover.pjt
F2802: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2802\flash28\
SDFlash2802_Erase.pjt, SDFlash2802_Program.pjt,
SDFlash2802_Verify.pjt SDFlash2802_DepRecover.pjt
F2806: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2806\flash28\
SDFlash2806_Erase.pjt, SDFlash2806_Program.pjt,
SDFlash2806_Verify.pjt SDFlash2806_DepRecover.pjt
F2808: Install Dir: <SDFlash>\myprojects\tif280x_V1_0\f2808\flash28\
SDFlash2808_Erase.pjt, SDFlash2808_Program.pjt,
SDFlash2808_Verify.pjt SDFlash2808_DepRecover.pjt
8.2. In CCS, open the appropriate CSM key file: SDFlash28x_Erase_CsmKeys.asm,
SDFlash28x_Program_CsmKeys.asm, or SDFlash28x_Verify_CsmKeys.asm. These files contain
the definition of the CSM passwords used by the algorithm to unlock the CSM during the erase,
program and verify operations.
Note: The passwords in this file will not be programmed into the CSM password locations. The
algorithm uses these passwords only to unlock the CSM prior to an erase, program or verify operation.
8.3. Modify the passwords in the appropriate CSM key file to match those already programmed into
the CSM password locations.
8.4. Rebuild the algorithms in CCS by selecting Project->Rebuild All
8.5. Exit Code Composer Studio
Note: Each step in the process Erase, Program, and Verify separately unlocks the CSM. If you are changing
the passwords during the Program operation, you will need to supply the new passwords for the verify
operation by following the steps above.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 18
CAUTION
When entering the User Options into the SDFlash interface, do not use a leading 0x.
Enter only the hex digits as shown in the examples provided.
9. SDFlash User Options
The SDFlash utility provides user options for each operation: Erase, Program and Verify. The function implemented
by each of the user options is dependent on the algorithm being interfaced to.
The following table shows an overview of which user options are used by the F280x SDflash algorithm V1_1.
Erase Program Verify
User Option 1 Sector Mask Not used Flash bank wait states
User Option 2 Not used* Not used OTP wait states
User Option 3 Run frequency toggle test Run frequency toggle test Run frequency toggle test
User Option 4 Not used Not used Not used
* Note on 281x devices this was the frequency toggle test. This has been moved to the user option 3. The
frequency toggle test is available under all operations since each operation algorithm file is a separate compile.
The following sections describe in detail how to use each option.
9.1. Specify Which Sectors to Erase: Erase User Option 1
For the erase operation, User Option 1 allows
you to select which sectors will be erased. This
information is provided in the form of a mask
value where a set bit indicates that the sector will
be erased.
Bit 0 = Erase Sector A
Bit 1 = Erase Sector B
Bit 2 = Erase Sector C
Bit 3 = Erase Sector D
Bit 4-15 = ignored
To modify the sector mask value:
9.1.1. Open the project settings:
Project -> Settings
9.1.2. Click on the Erase tab
9.1.3. Enter a mask value for User Option 1 that
corresponds to the sectors you want
erased. Enter the hex number digits only.
Do not enter a leading 0x. For the
example shown: Erase User Option 1 =
000F would erase all sectors on an 2808
device.

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 19
CAUTION
The One Time Programmable Block (OTP) can only be programmed once.
The OTP block cannot be erased.
CAUTION
Do not press the SDFlash STOP button during the erase operation.
Pressing STOP will halt the CPU before the Erase algorithm completes. This can leave the Flash in a
depleted state or result in unknown Code Security Module passwords and lock the device
permanently. If you feel your device is in a depleted state (cannot be erased) then try the depletion
recovery algo.
Other conditions that can cause the CPU to halt prior to the completion of the Erase algorithm (e.g.,
power loss, device reset, PC crash, etc.) can result to the same problem described above.
Pressing STOP when executing the frequency toggle test described in section 9.3 is ok.
9.1.4. Select OK and save the project: File->Save Project
F2801 Sector Mask Value: F2801 Sector Addresses:
Bit 0 = Erase Sector A
Bit 1 = Erase Sector B
Bit 2 = Erase Sector C
Bit 3 = Erase Sector D
Bit 4-15 = ignored
F2801 Erase User Option 1 Examples: 0001 Erase only sector A
0003 Erase only sector A and sector B
000F Erase all sectors on an F2801 device

TMS320F280x SDFlash Programming Utilities F280x SDFlash Algo V1.1
Texas Instruments Inc. 20
F2802 Sector Mask Value: F2802 Sector Addresses:
Bit 0 = Erase Sector A
Bit 1 = Erase Sector B
Bit 2 = Erase Sector C
Bit 3 = Erase Sector D
Bit 5-15 = ignored
F2802 Erase User Option 1 Examples: 0001 Erase only sector A
0003 Erase only sector A and sector B
000F Erase all sectors on an F2802 device
F2806 Sector Mask Value: F2806 Sector Addresses:
Bit 0 = Erase Sector A
Bit 1 = Erase Sector B
Bit 2 = Erase Sector C
Bit 3 = Erase Sector D
Bit 5-15 = ignored
F2806 Erase User Option 1 Examples: 0001 Erase only sector A
0003 Erase only sector A and sector B
000F Erase all sectors on an F2806 device