Dsp/bios 5.32 application programming interface api (599 pages)
Summary of Contents for Texas Instruments TMS320F280 Series
Page 1
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 Texas Instruments Inc.
Page 2
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.
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. Texas Instruments Inc.
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 Texas Instruments Inc.
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. SDFlash V1.0 and earlier do not support the F2802 device. V1.1 is the first version to support the F2802. Texas Instruments Inc.
SDFlash interface is separate from the algorithm file, the version of the SDFlash interface will differ from the version of the algorithm file. SDFlash Wrapper SARAM F280x/281x DSP Buffer Flash API Flash Data File (.out to be programmed) SDFlash Algo File SDFlash JTAG Front-End SDFlash Algorithum File OTP and FLASH ARRAY Texas Instruments Inc.
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 Texas Instruments Inc.
Page 9
<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.
Page 10
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 Texas Instruments Inc.
Page 11
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. Texas Instruments Inc.
Page 12
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. Texas Instruments Inc.
Page 13
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. Texas Instruments Inc.
Page 15
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. Texas Instruments Inc.
Page 16
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. Texas Instruments Inc.
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. Texas Instruments Inc.
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. Texas Instruments Inc.
Page 19
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 Texas Instruments Inc.
Page 20
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 Texas Instruments Inc.
Verify User Option 1 specifies the Flash waitstate register (FBANKWAIT) contents: FBANKWAIT Register The sample SDFlash project uses the default value of 0F0F. This value is also used if the option is left blank. Texas Instruments Inc.
The toggle test is available as user option 3 for erase, program and verify because the algorithm file for each of the operations is a separate compile. At initial setup, it is recommended that the frequency configuration of at least the erase and program operations are verified via the toggle test. Texas Instruments Inc.
Page 23
SDFlash will eventually timeout. The timeout period is as specified in the Timeout box, in seconds (e.g., 3000 seconds). The user can click Stop to halt the toggle test sooner. Texas Instruments Inc.
This algorithm cannot recover the part if the flash passwords are unknown. For example if power is lost during the erase of sector A, where the CSM passwords are located, then the device may be permanently locked and the recovery algorithm cannot operate on the flash. Texas Instruments Inc.
Older versions of the SDFlash algos are based on obsolete Flash APIs and should not be used. Run SDConfig to make sure your target and emulator are setup properly. Examine the project settings Project->Settings and make sure the path names to all files are correct as described in section 6.6. Texas Instruments Inc.
CSM using the default passwords. To avoid having to change the CSM passwords for different operations, it is suggested that the CSM passwords be left erased (FFFFs) for initial development. Refer to section 8 Code Security Module (CSM) Password Considerations if you have changed your passwords from the default (erased) value. Texas Instruments Inc.
“boot to flash” operation. Refer to TMS320x281x Boot ROM Peripheral Reference Guide, literature # SPRU095, for more information. The 3.3V flash power pin, VDD3VFL, should remain connected, as it is required for read operations as well as programming. Texas Instruments Inc.
Page 28
_c_int00. The examples in C280x C/C++ Header Files and Peripheral Examples in C will be available for download from the TI website in December 2004, will illustrate how to disable the watchdog before the c initialization phase. Texas Instruments Inc.
This error code is new as of V2.00 of the API. The expected PARTID did not match the STATUS_FAIL_INCORRECT_PARTID device PARTID. This would indicate that the wrong API was used. For example, using a TMS320F2812 API on the TMS320F2808 device. Texas Instruments Inc.
Page 30
Verify Specific Status Messages The verify operation failed because one or more bits did not match the reference data. STATUS_FAIL_VERIFY Try increasing the Flash or OTP wait states. Texas Instruments Inc.
Page 31
PLLSTS register. This bit indicates that the external clock has at some point gone missing. When this is the case, the flash API should not be executed as it will be at the wrong frequency. Texas Instruments Inc.
Need help?
Do you have a question about the TMS320F280 Series and is the answer not in the manual?
Questions and answers