BHFlashBurn v2.0. User Guide. BHFlashBurn-UG-02 April 2008

Transcription

1 BHFlashBurn v2.0 User Guide BHFlashBurn-UG-02 April 2008

2 BH-FlashBurn Utility 2008 EWA Technologies, Inc. All rights reserved. IMPORTANT INFORMATION Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. EWA Technologies Document: BHFlashBurn-UG-02 Warranty this manual The information contained in this document is subject to change without notice. EWA makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. EWA shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. About This Manual This document represents the User Guide for the Blackhawk FlashBurn product. The Blackhawk FlashBurn utility is a module that fit into a personal computer to allow hardware engineers and software programmers to program flash applications on DSP s via standard command prompt. This guide contains some text paragraphs that are very important for proper device functioning and for preventing the Blackhawk FlashBurn files and project target board from being corrupted. These paragraphs are shaded as in the following example. Please read each of these areas of text carefully. Related Documents This is an example of a very important text paragraph. TI Flash Tools: Texas Instruments Running an Application from internal Flash Memory on the TMS320F28xx DSP Rev. F ( spra958f files - Updated: 01/06) Texas Instruments C281x C/C++ Header Files and Peripheral Examples (SPRC097-Updated: 05/07) Texas Instruments Getting Started in C and Assembly Code with the TMS320LF240x DSP SPRA0755b. Texas Instruments Getting Started in C and Assembly Code with the TMS320C28x DSP SPRC324. Texas Instruments Getting Started in C and Assembly Code with the TMS320C28x DSP SPRC191 Texas Instruments Code Composer User's Guide (SPRU296 - Updated: 12/30/1998) Texas Instruments Code Composer Studio User's Guide (SPRU328B - Updated: 03/28/2000) To get the latest documentation from TI, click: Get the latest DSP manuals from TI. Trademarks BLACKHAWK is a trademark of EWA Technologies, Inc. All other marks are trademarks of their respective owners. IMPORTANT INFORMATION Copyright ii

3 TABLE OF CONTENTS INTRODUCTION... 5 OVERVIEW... 5 KEY FEATURES... 5 WHAT S INCLUDED... 6 REQUIREMENTS... 7 System Hardware and Software Requirements... 7 Minimum Configuration...7 Recommended Configuration...7 Installing the BHFlashBurn v2.0 utility for Windows 2000/XP/Vista... 7 INSTALLATION PROCEDURES... 8 SOFTWARE INSTALLATION... 8 EMULATOR INSTALLATION Emulator Hardware Considerations Recommended Connection Procedure...11 Recommended Disconnection Procedure...11 BHFLASHBURN V2.0 UTILITY API DESCRIPTION COMMAND USAGE Example Commands COMMON ERRORS APPENDIX A. FLASH CODE EXAMPLES USING BHFLASHBURN V2.0 WITH F24XX DEVICES LF2407 EVM and LF2407A DSK Examples Modifying F24xx examples with Code Composer Studio USING BHFLASHBURN V2.0 WITH F28XX DEVICES F2812 DSK Example F28044 DSK Example F2808 DSK Example Modifying F28xx examples with Code Composer Studio SUPPORT INFORMATION CONTACT INFORMATION Blackhawk FlashBurn Utility Table of Contents iii

4 LIST OF FIGURES Figure 1 Welcome screen... 8 Figure 2 License Agreement... 8 Figure 3 User Information... 8 Figure 4 Install Directory... 8 Figure 5 Verification... 9 Figure 6 Installation Status Screen... 9 Figure 7 Completion Screen... 9 Figure 8 Installing JTAG Emulator Figure 9 Flash API Organization Figure 10 No Emulator Connected Error Figure 11 No target detected Error Figure 12 Target is not powered Error Figure 13 F2407A EVM Target Board Figure 14 F2407 ezdsp Target Board Figure 15 Erasing F24xx Flash Figure 16 Erasing F24xx Flash q- option Figure 17 Programming F24xx Flash Figure 18 Programming F24xx Flash q- option Figure 19 CCS F24xx Setup Figure 20 Open F24xx Project File Figure 21 Load the LF2407.GEL File Figure 22 Build the F24xx Project Figure 23 ezdsp F2812 Target Board Figure 24 Erasing F28xx Flash Figure 25 Erasing F28xx Flash q- option Figure 26 Programming F28xx Flash Figure 27 Programming F28xx Flash -q- option Figure 28 ezdsp TMS320F28044 Target Board Figure 29 ezdsp TMS320F2808 Target Board Figure 30 CCS 28xx Setup Figure 31 Open 28xx Project File Figure 32 Load f2812 GEL File Figure 33 Build 28xx Project LIST OF TABLES Table 1 - BHFlashBurn v2.0 Command Usage and Options Blackhawk FlashBurn Utility Table of Figures iv

5 Introduction Introduction Overview The Blackhawk FlashBurn (BHFlashBurn) v2.0 utility is designed for use with TI C2000 digital signal processors (DSP s) with on-chip flash. BHFlashBurn v2.0 is compatible with the Texas Instruments C2000 on-chip API flash plug-in utilities. Code Composer Studio (CCStudio) Integrated Development Environment (IDE) debug tool is not needed for operation. However, you will need CCStudio to compile and link your code or the supplied examples for use with this program. The examples provided with this utility include pre-built executable COFF (.out) files. BHFlashBurn v2.0 and the Blackhawk Emulator drivers are compatible with Windows 2000, XP and Vista. Key Features The Blackhawk FlashBurn v2.0 utility has the following features: Standalone utility (does not require Code Composer Studio) Command line, scriptable utility Compatible with the existing C2000 Flash API algorithms used by CCStudio Flash plug-in and other flash utilities Supports Texas Instruments C2000 Digital Signal Processors 1 o o o o o o TMS320LF24x TMS320LF240x TMS320F283x...Floating point Controllers TMS320F282x TMS320F281x TMS320F280x...Including F28016 and F28044 controllers. Supports Blackhawk USB510L and USB2000 JTAG Controllers 2. 1 See TI Website for a complete list of C2000 devices supported. 2 BH-FlashBurn v2.0 supports USCIF , whereas v1.x supports USCIF Blackhawk FlashBurn Utility Overview 5

6 Introduction What s included The Blackhawk FlashBurn v2.0 software package contains the following: 1. Executable (base programming files) 2. Emulator Device Drivers o Drivers for All Blackhawk Emulators Preinstalled automatically 3. Documentation o o o User Guide (this guide) Readme and Usage Files Emulator Installation Guides 4. Example Flash Projects The following example projects are provided for certain DSK/EVM boards and meant to be used as a reference for using the utility and setting up a Code Composer Studio flash project for your target board. You do not need Code Composer Studio installed to use the OUT files provided, but they do require that you have the specific target board on which the examples are designed to run. These examples blink the target board s LED (or LED s), which is useful to help determine if the flash is running correctly (LED s blinking), or erased correctly (LED s not blinking). The example projects that are included support the following targets boards: o o o o o LF2407 EVM LF2407A DSK F2812 DSK F2808 DSK F28044 DSK 5. Emulator Utilities o BHProbe 2.0 o BHDetect o LAN Diagnostics 6. Algorithms o F24xx flash API files 3 o F281x flash API files o F280x flash API files o F2801x flash API files o F28044 flash API files o F283x flash API files 3 Link to TI website for free download of APIs provided ( Blackhawk FlashBurn Utility What s included 6

7 Introduction Requirements System Hardware and Software Requirements The following are general requirements needed to install BHFlashBurn: Minimum Configuration 233 MHz or faster Pentium or compatible 50 MB of free hard disk space 256 MB of RAM SVGA (640x480) color display Local CD-ROM drive Microsoft Windows 2000/XP/Vista Recommended Configuration 512 MB of RAM 100 MB of free hard disk space SVGA (1024x768) color display 2.0 GHz or faster Pentium or compatible Installing the BHFlashBurn v2.0 utility for Windows 2000/XP/Vista Before installing the BHFlashBurn v2.0 utility, please ensure that the PC has free hard drive space available. NOTE In order to install BHFlashBurn v2.0 software or new devices, the user must have administrator privileges. Blackhawk FlashBurn Utility Requirements 7

8 Installation Procedures Installation Procedures Software Installation The BHFlashBurn v2.0 disk contains a setup executable that will install all the necessary files to your computer. If the application that installs the files does not start when the CDROM is inserted into the computer s CDROM drive, please follow the directions on the media for starting the setup executable. If you downloaded the software from our web site, please follow the directions included with the distribution. The installation wizard screens for the BHFlashBurn v2.0 utility are as follows: Figure 1 Welcome screen Figure 2 License Agreement Figure 3 User Information Figure 4 Install Directory Blackhawk FlashBurn Utility Software Installation 8

9 Installation Procedures Figure 5 Verification Figure 6 Installation Status Screen Figure 7 Completion Screen Blackhawk FlashBurn Utility Software Installation 9

10 Installation Procedures Emulator Installation Please use care when handling delicate electronic equipment. Caution is necessary to minimize ESD (electro-static discharge) which can damage electronic components. Whenever handling this emulator, please be sure that your environment is ESD controlled and proper materials and practices are employed such as static straps and mats. or Figure 8 Installing JTAG Emulator BHFlashBurn v2.0 is tested and supported for the Blackhawk USB510L and USB2000 JTAG Emulator models. For this documentation, the BH-USB510L has been used for all examples and references. The USB2000 command will be similar. This guide assumes that the user has the following hardware installed and configured on the development computer: JTAG Emulator JTAG Emulator Device Drivers Installed with the USCIF Installed with the Target board with supported C2000 class TI DSP Compiled COFF (.out) file to be loaded into the DSP s Flash For reference on emulator and emulator driver installation, please refer to the emulator s installation guide located in the Docs subfolder of this package: C:\Program Files\Blackhawk\Flashburn_v2\Docs, where Program Files is the root location chosen for the software installation. Blackhawk FlashBurn Utility Emulator Installation 10

11 Installation Procedures Emulator Hardware Considerations Because the Blackhawk JTAG Emulator is an electronic device that directly connects a computer to your target DSP system, it is important to follow established procedures in the safe handling of electronic devices. Basic precautions regarding static electrical discharge and other electrical safety precautions should be followed when connecting or disconnecting the Blackhawk JTAG Emulator to and from the target DSP system or any time electronic devices are handled. If you are unfamiliar with these procedures, consult with a technician. Recommended Connection Procedure 1. Insure you are grounded, and have eliminated the potential for static electrical discharge. 2. Remove power from the target DSP system. 3. Connect the Blackhawk JTAG Emulator to the target system using the keyed JTAG cable assembly that is supplied with the unit. Be sure to check cable orientation. 4. Apply power to the target DSP system. Recommended Disconnection Procedure 1. Insure you are grounded, and have eliminated the potential for static electrical discharge. 2. Remove power from the target DSP system. 3. Disconnect the keyed JTAG ribbon cable from the target DSP system. Blackhawk FlashBurn Utility Emulator Installation 11

12 API Description The Flash API is a simple-to-use interface to the flash programming algorithms. It consists of well documented function calls that the client application calls to perform flash specific operations. In a layered view of the system, the flash API can be seen as a layer which abstracts complex functionality. The flash API provides a simple way to use the flash memory core, registers and algorithm functions. Figure 9 Flash API Organization This helps abstraction of the flash memory details from the application, and leads to better organization of the system. TI provides flash algorithms for performing the operations such as Clear, Erase, and Program on the LF240x Controllers. Using TI supplied algorithms allows you to focus on your application, and frees up developer time to concentrate on your value proposition. The flash API has been written to be easy to integrate into client applications. This means that you are freed up from managing complex timing requirements and verification levels, to focus on getting your application done faster. You can obtain more information on the available flash APIs and examples projects here: Blackhawk FlashBurn Utility API Description 12

13 Command Usage The BHFlashBurn v2.0 utility is command line driven, and can be used with user created batch files, or by typing the command manually into a DOS window. The following steps need to be taken to use the utility: 1. Open a Windows Command prompt. You can do this by: a) clicking on Windows Start button, then b) choosing the Run menu option and c) entering cmd in the dialog box. 2. Change directory to the BHFlashBurn v2.0 utility installation location. The default location is \Program Files\Blackhawk\Flashburn\bin 3. The BHFlashBurn v2.0 utility can be started using the following syntax and options below in Table 1. bhflashburn <options> <alg-file>.out [<coff-file>.out] options -d <dvr> GTI driver file-name (required) -f <dat> Board data file-name (required) -p <port> Emulator port number -n <tgt> Target CPU name or index (default 0) -e[:<pt>] Erase Flash, <opt> -- erase options (default 3FF) -c <oscclk>[x<pllcr>] Clock Configuration (default 20x10) C28xx only -v Verify data after loading -z Zero-fill BSS sections -r Reset CPU -q[-] Quiet mode, "-" will enable all prints -h Command usage This screen <alg-file>.out Specific flash algorithm (.out file) <coff-file>.out Executable file to program into target DSP on-chip flash Table 1 - BHFlashBurn v2.0 Command Usage and Options Blackhawk FlashBurn Utility Command Usage 13

14 Example Commands 1. Target board LF erase flash bhflashburn -f lf24xx.dat -d bhemu24x.dvr e Flash24xx\Algos \lf2407\erase\c2xx_bex.out. 2. LF program flash bhflashburn -f lf24xx.dat -d bhemu24x.dvr -v Flash24xx\Algos \lf2407\program\c2xx_bpx.out <path to>\my2407flash.out 3. LF erase flash bhflashburn -f lf28xx.dat -d bhemu28x.dvr -e -c30x6 Flash28xx \Algorithms\2812\FlashAPIInterface2812V2_10.out 4. LF erase, program, and verify flash bhflashburn -f lf28xx.dat -d bhemu28x.dvr -e -v -c30x6 Flash28xx \Algorithms\2812\FlashAPIInterface2812V2_10.out <path to> \my2812flash.out Blackhawk FlashBurn Utility Command Usage 14

15 Common Errors The following screenshots demonstrate common output errors produced by the command line utility: 1. SC_ERR_CTL_PORT This is an error that is typically caused by an emulator that has not enumerated with Windows, or exists at a different I/O port. Sample error results are shown in Figure 10, and you can diagnose this error by checking the following: a. Reset the emulator connected to your development machine. b. Verify that the emulator is shown (enumerated) in the Blackhawk control panel. Figure 10 No Emulator Connected Error 2. SC_ERR_CTL_CBL_BREAK_FAR This error is typical when the emulator is not connected to a target board s JTAG connector. You can check the following: a. Check all cable connection is secure between the emulator and the target. b. Power cycle the target and the emulator. Figure 11 No target detected Error Blackhawk FlashBurn Utility Common Errors 15

16 3. Error <-2092> This is an error generated by the TI s USCIF driver. This error results when a target is not powered when used by the Bhflashburn v2.0 utility. a. Check all cable connection is secure between the emulator and the target. b. Power cycle the target and the emulator c. Verify target power. Figure 12 Target is not powered Error 4. SC_ERR_LCK_TIME This is an error generated by the TI s USCIF driver. This error results returned when the emulator is already opened by another process (it is possibly hung). This can happen if CCStudio is running in parallel with this utility. a. Power cycle the target and the emulator b. Reboot Development machine. 5. SC_ERR_CTL_NO_TRG_CLOCK This error is reported when the emulator cannot sense a return test clock signal (RET_CLK) on pin 9 of the TI JTAG header. a. Check all cable connection is secure between the emulator and the target b. Verify that the target board is routing the test clock (TCK) signal on pin 11 to pin 9. If this is an OMAP or Davinci based board, RET_TCK may be supplied from the RET_TCK pin on the device, and not routed from header pin 11. Blackhawk FlashBurn Utility Common Errors 16

17 Appendix A. Flash Code Examples Using BHFlashBurn v2.0 with F24xx Devices The following section includes examples for using this utility with LF24xx target devices. LF2407 EVM and LF2407A DSK Examples The F24xx Device examples section is based on the document and examples from the Texas Instruments Getting Started in C and Assembly Code with the TMS320LF240x DSP SPRA0755b. This package is downloadable from TI website. The SPRA0755b provides an example that can demonstrate flash coding for the F24xx DSP, and also can be used as a base template for user code, taking into consideration the special setup needed for programs running within the flash and not the RAM on the DSP. In addition you can test the modified example_c.c file for a bootable routine to sequence the led s on the board for 6 seconds, using an ISR with Timer2. (Or blink DS2 on the ezdsp 2407 board) To flash your F2407 EVM board using the.out file, perform the following steps: 1a. Verify the Jumper configuration on your LF2407A EVM board Jumper 5 (2-3) Enabled Flash Programming Jumper 6 (2-3) Microcomputer mode Bootable Flash Enabled 1b. Verify the Jumper configuration on your ezdsp TMS320LF2407 board Jumper 3 (2-3) Enabled Flash Programming (Vpp) Jumper 4 (2-3) Microcontroller mode Bootable Flash Enabled 2. Follow the general usage section to load the out file into your F2407 EVM Board. Figure 13 F2407A EVM Target Board Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 17

18 Figure 14 F2407 ezdsp Target Board The following screenshots below show the BHFlashBurn v2.0 output for erasing and programming the flash for a F2407 target. Figure 15 Erasing F24xx Flash Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 18

19 Figure 16 Erasing F24xx Flash q- option Once the Flash is erased you can continue to program and verify it. Figure 17 Programming F24xx Flash Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 19

20 Figure 18 Programming F24xx Flash q- option Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 20

21 Modifying F24xx examples with Code Composer Studio Although the Utility comes with a pre-compiled.out file that can be used as-is with the BHFlashBurn v2.0 utility, users that wish to modify the project and recompile their own program, can use CCStudio. NOTE The BHFlashburn v2.0 Utility is self contained, and only requires a COFF file to be loaded into the target board. 1. Setup CCStudio for use with the emulator and F24xx target board. 2. Open the project, example_c.pjt, in CCStudio. 3. Load C:\CCStudio_v3.3\cc\gel\f2407.gel file, if not already specified in CCSetup. 4. Rebuild the project. If modifying any source code, include file, or linker parameter, please refer to the SPRA0755b documentation. 5. Follow the Command Usage section to program the.out file into your F2407 EVM board. Figure 19 CCS F24xx Setup Figure 20 Open F24xx Project File Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 21

22 Figure 21 Load the LF2407.GEL File Figure 22 Build the F24xx Project Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F24xx Devices 22

23 Using BHFlashBurn v2.0 with F28xx Devices F2812 DSK Example The F28xx examples section is based on the Texas Instruments document, Running an Application from Internal Flash Memory on the TMS320F28xx DSP Rev. F SPRC0958f and the F2812 DSK board. Similar examples are provided for F2808 and F28044 DSK boards. The content of the SPRC0958f package includes an example that demonstrates flash coding for F28xx DSP s. It can also be used as a base template for user code, taking into consideration the special setup needed for programs running from on-chip flash and not the device s RAM space. The best project provided by the SPRC0958f archive is the non-bios flash example. This project builds and loads a non-bios program into the F2812 DSK board s flash that toggles the XF bit in and endless loop, blinking the board s LED. Flashing the F2812 DSK board using the.out file requires the following steps: 1. Verify the Jumper configuration on your F2812 DSK board Jumper 1 (2-3) Microcomputer mode Bootable Flash Enabled Jumper 7 (1-2) enabled for boot mode 3 (Flash). Jumpers 8, 11, and 12 can be on either position (use default) 2. Follow the Command Usage section to load the.out file into your F2812 DSK board. Figure 23 ezdsp F2812 Target Board The following screenshots below show the BHFlashBurn v2.0 output for erasing and programming the flash for a F2812 target. Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 23

24 Figure 24 Erasing F28xx Flash Figure 25 Erasing F28xx Flash q- option Once the Flash is erased you can continue to program and verify it. Figure 26 Programming F28xx Flash Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 24

25 Figure 27 Programming F28xx Flash -q- option Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 25

26 F28044 DSK Example The C28xx Device examples section is based on the document and examples from the Texas Instruments Getting Started in C and Assembly Code with the TMS320C28x DSP SPRC324. This package is downloadable from TI website. The SPRC324 provides an example that can demonstrate flash coding for the F28044 DSP, and also can be used as a base template for user code, taking into consideration the special setup needed for programs running within the flash and not the RAM on the DSP. In addition you can test the modified Example_28044_Flash.c file for a bootable routine to blink the led DS2 on the board. To flash your ezdsp C28044 board using the.out file, perform the following steps: 3. Verify the Jumper configuration on your ezdsp C28044 board Jumper SW1 (1 3) Enabled Flash Programming Figure 28 ezdsp TMS320F28044 Target Board F2808 DSK Example The C28xx Device examples section is based on the document and examples from the Texas Instruments Getting Started in C and Assembly Code with the TMS320C28x DSP SPRC191. This package is downloadable from TI website. The SPRC324 provides an example that can demonstrate flash coding for the F28044 DSP, and also can be used as a base template for user code, taking into consideration the special setup needed for programs running within the flash and not the RAM on the DSP. In addition you can test the modified Example_280xFlash.c file for a bootable routine to blink the led DS2 on the board. Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 26

27 To flash your ezdsp C2808 board using the.out file, perform the following steps: 4. Verify the Jumper configuration on your ezdsp C2808 board Jumper SW1 (1 3) Enabled Flash Programming *Jumper SW1 (4) Enabled EEPROM WP Figure 29 ezdsp TMS320F2808 Target Board Modifying F28xx examples with Code Composer Studio Although the Utility comes with a pre-compiled.out file that can be used as-is with the BHFlashBurn v2.0 utility, users that wish to modify the project and recompile their own program, can use CCStudio. NOTE The is self contained, and only requires a COFF file to be loaded into the target board. 1. Setup CCStudio for use with the emulator and F28xx target board. 2. Open the project, example_nonbios_flash.pjt, in CCStudio. 3. Load C:\CCStudio_v3.3\cc\gel\f28xx.gel file, if not already specified in CCSetup. 4. Rebuild the project. Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 27

28 If modifying any source code, include file, or linker parameter, please refer to the SPRC0958f documentation. 5. Follow the Command Usage section to program the.out file into your F2812 DSK board. 6. Figure 30 CCS 28xx Setup Figure 31 Open 28xx Project File Figure 32 Load f2812 GEL File Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 28

29 Figure 33 Build 28xx Project Blackhawk FlashBurn Utility Using BHFlashBurn v2.0 with F28xx Devices 29

30 Support Information Support Information Support is provided for pre-sales information and registered products. Contact Information Mailing Address Blackhawk 123 Gaither Drive Mt. Laurel, New Jersey Phone (877) (856) FAX (856) World Wide Web Corrections Please report any documentation errors by to Blackhawk FlashBurn Utility Contact Information 30