User Guide - Signum Systems Corp.
Contents
1. Command data mask for the CFI programmer Example md0xFF FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGG R GU USE ER IDE Options for the internal flash F05 in the TI TMS470R1x devices recommended for production purposes only k lt key0 gt lt key1 gt lt key2 gt lt key3 gt Level 2 security key used to unlock the Flash for writing The key is required if the flash has been protected with values other then all Fs If trailing keys are omitted the last specified key is used at least one key is required Example k0x11223344 0x55667788 is equal to k0x11223344 0x55667788 0x55667788 0x556677 88 knew lt key0 gt lt key1 gt lt key2 gt lt key3 gt New level 2 security key to be set after programming Written to the device as a new security key View the Log tab to verify the new keys kcode New level 2 security key taken from the code at address 0x1 FFO 0x1 FFF For example f17400 p1 in the Options field would pass the programmer a clock frequency of 17 4 MHz and instruct it to update the code signature at address 0x14 Query Device Button for querying the type of the memory device at the base address If a Common Flash Interface CFI compliant flash device is found the size of the flash the number and sizes of the sectors and the programmer recommended name are displayed The flash log files described in the Flash Programming Log section provide more information2. F Paasi Prose Status J Flash Image Flash Device Utilties Log Flash Device LPC2xxx internal flash programmer File Type Linker Output Image Name Support Philips Signum LPC2138 Demo demoflash elf v Address Offset o0 M Erase Before Programming I Verify While Programming I Close After Programmming Program Verify Erase Save Config Close Help FIGURE 4 Selecting the flash image parameters and programming operations 2 Program Verify Erase or Abort This step depends on the intended operation Some of these operations may require selecting additional options before you press the appropriate operation button Select the Close After Programming option to close the flash programming plug in after successful programming or erasing PROGRAM BUTTON Normally programming the flash device requires earlier erasing the flash memory Also it is advisable that you verify the contents of the programmed flash These two operations are controlled by the following options Erase Before Programming Instructs the programmer to erase the entire flash memory prior to uploading data to the device when the Program button is pressed When uploading multiple files to the flash SIGNUM SYSTEM 410 deselect Erase Before Programming and use the Erase button to clear the entire flash only before programming the first file Verify While Programming Instructs the programmer to perform its own prog
3. Programming a block at Ox8000b000 0x100 bytes STapollo Verifying at Ox8000b000 a block of 0x40 dword Programming completed Time elapsed E Log Level Users Log z Save Copy To Clipboard Clear FIGURE 7 The flash programming log window LOG LEVEL The log content can be filtered in several ways Use the Log Level drop down list to select the filtering criteria that fit your needs best The available levels are listed below in increasing order of comprehensiveness Errors Only The log records only error messages Normal In addition to Errors Only level messages the log records commands Erase Program Save Bank Check etc along with their parameters 14 FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER R GU E USE ID User s Log In addition to Normal level messages the log records messages from the programmer execution on the target board The programmet s messages ate prefixed by the target name For example a message from the STapollo target may look like this STapollo Erasing the flash Calls Except Data Access In addition to User s Log level messages the log records requests from the programmer code to the flash programming plug in with the exception of those relating to flash image data All Calls In addition to Calls Except Data Access level messages the log records those requests from the programmer to the plug in that relate to the flash image All Calls and Data In addi
4. gt Open FIGURE 1 Running the flash programmer Configuring the Plug In Before it can program flash memory the programmer needs to be configured The first and critical step in setting the necessary programmer parameters is selecting the appropriate flash device gt To choose the flash device 1 Choose the flash device programmer and set its parameters in the Flash Device tab Figure 2 FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER USER GUIDE Flash Image Flash Device Utilities Log Select the flash programmer from the list in Flash Device field or specify a custom programmer in the Programmer field Enter the programmer loading RAM address Some programmers may require additional Options Flash Device LPC2xnx internal flash programmer Sa Programmer D SIGNUM IceFrame Plugin Flash ARMALPC2xxx LF Ed Base Address 0x0 v RAM Address l z m Erase Chip amp Range Auto Provide the flash image file name to use Auto m Watchdog Address fox8001 _00C0 Value Sequence fi a Startup Cleanup Macros Optionally specify the name of a subroutine in the startup macro preceded by the character or enter the macro file name Startup Cleanup Verbose L Options pl 14700 Query Device Save Config Close Help FIGURE 2 Setting up the flash device and its programmer 2 Select the flash device from the Flash Device drop down list A programmer file as
5. with the use of the character The plug in treats the as representing the path to the debugger installation directory Thus for example it is possible to use in a macro file statements like this lugin paramset lashDevice StartupMacro Arm TestFlashStartup mac lugin paramset lashDevice CleanupMacro Arm TestFlashCleanup mac T S W S Plug In Commands for Flash Programming with Macros In a macro file all plug in programmer commands PROGRAM ERASE and VERIFY nmust be preceded by the keyword flash for example flash program flash erase Plug in programmer commands are case insensitive Putting it Together Commands that configure the programmer and commands operating on flash memory can be combined together to fully automate the process of flash programming An example of a complete macro file that first erases and then programs flash is shown below flash mac program my demo program into the flash 17 SIGNUM SYSTEM 410 th O o o K H O Md Pict so alko ario to ko lugin paramset LPC2xxx elf lugin paramset lugin paramset lugin paramset lugin paramset lash erase lugin paramset lugin paramset lugin paramset lash program lash verify lugin paramset FlashDevice FlashDevice LPC2xxx internal lash programmer lashDevice Programmer D Chameleon Plugin Flash ARM LPC2XX FlashDevice StartupMacro FlashDevice CleanupMacro FlashDevice BaseAddre
6. about the device The Memory Device SIGNUM SYSTEM 410 Information dialog box appears allowing you to set selected parameters to the values returned by the query Figure 3 e Ifa non CFI compliant device or RAM is found a message informing you that ROM or RAM respectively has been found appears Memon VEVICENNMONnauT p 16 bit Intel Sharp Extended Command Set flash device at address 0x50000000 S7 Device size 0x01000000 sectors 128 x 0x20000 Manufacturer Intel 0x89 device ID 0x18 Recommended programmer CFI_be_16 bin Recommended programmer options ma0x7F Detailed information is displayed in the Log tab Do you want to update the Programmer with these parameters Yes No FIGURE3 Flash query using the Query Device button The results can be used to configure the programmer automatically Flash Erasing Programming and Verification gt To program the flash verify the programming or erase the flash 1 Set up the flash programming parameters in the Flash Image tab Choose the image file type in the File Type drop down list box Then enter the flash image file name in the Image Name box or browse for the file You may need to enter the loading address offset in the Address Offset text box This offset specifies the loading address for binary files or the offset added to the loading addresses in HEX SREC and linker output files FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER USER GUIDE
7. Chameleon SIGNUM SYSTEMS CORPORATION Flash Programming Plugin for Chameleon D ebugger User Guide GINO S yY S T E M _S S COPYRIGHT NOTICE Copyright c 2007 by Signum Systems Corporation All rights are reserved worldwide No part of this publication may be reproduced transmitted transcribed stored in a retrieval system or translated into any language or computer language in any form or by any means electronic mechanical magnetic optical chemical manual or otherwise without the prior written permission of Signum Systems DISCLAIMER Signum Systems makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose Also Signum Systems reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Signum Systems to notify any person or organization of such revision or changes WARRANTY Signum Systems warrants to the original purchaser that this product is free of defects in material and workmanship and performs to applicable published Signum Systems specifications for a period of SIX MONTHS from the date of shipment If defective the product must be returned to Signum Systems prepaid within the warranty period and it will be repaired or replaced at our option at no charge Equipment or parts which have been subject to misuse abuse alt
8. To text boxes respectively 2 Press the Save button A file open dialog box appears 3 Enter the file name or browse for the binary file in which the memory range data is to be saved BLANK CHECK The Blank Check function is used to check if all the bits in the specified memory range are set to 1s As flash memory is erased by setting its bits to 1s the function verifies that the flash has been erased The Blank Check function does not depend on any of the parameters set in tabs the Flash Image or Flash Device tabs gt To verify that a memory range has been erased 1 Select the desired memory address range in the Address Range group 2 Press the Blank Check button Flash Programming Log The flash programming plug in creates a log of flash programming activity You can control the amount and type of information stored save copy and clear the log using the controls found in the Log tab 13 SIGNUM SYSTEM 410 STapollo Flash Programming x Status Programming completed Flash Image Flash Device Utilities Log Programming programmer D Signum IceFrame Plugin Flashi ARM address offset Oxs000b000 image name D Alpha STMicro smalli0d0 bin requested erasing before programming requested verification after programming STapollo Erasing the flash STapollo Block O size 0x100 STapollo Block O addr Oxs000b000 STapollo Data offset 0x0 length 0x100 STapollo
9. WhileProgramming 1 lugin paramset FlashImage AddressOffset 0 lugin paramset FlashImage FileType 0 lugin paramset lashImage ImageName D Alpha AT91EB40A Flash demo elf lugin paramset FlashDevice FlashDevice LPC2xxx internal lash programmer lugin paramset lashDevice Programmer D Chameleon Plugin Flash ARM LPC2xx LPC2xxx elf lugin paramset FlashDevice StartupMacro D Chameleon Arm TestFlashStartup mac lugin paramset FlashDevice CleanupMacro D Chameleon Arm TestFlashCleanup mac lugin paramset FlashDevice Options 17400 lugin paramset FlashDevice BaseAddress 0x100_0000 lugin paramset FlashDevice Erase From 0x100_0000 lugin paramset FlashDevice Erase To 0x11F_FFFF ea Tea teal eal O D S lt U lt K W S mho o o o o o 16 FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER USER GUIDE lugin paramset lugin paramset lugin paramset lugin paramset lugin paramset FlashDevice Erase Range 1 lugin paramset Utilities AddressRange From 0x0100_0000 lugin paramset Utilities AddressRange To 0x011F_FFFF lugin paramset tilities Save FileName D Alpha EB40A EB40A bin lugin paramset Log Loghevel 1 lashDevice Watchdog Address 0x8001_00C0 lashDevice Watchdog ValueSequence 1 0 lashDevice Verbose 1 lashDevice Erase Chip 0 13 Ei ie le OES LOLOL CUCHOLOLOLS For added flexibility absolute file pathnames may be converted into relative paths
10. ars the entire flash memory Make sure that the currently selected flash device is the same as the one used for programming No other parameter is required 11 SIGNUM SYSTEM 410 ABORT BUTTON To terminate the programming verification or erasing operation press Note Soe flash devices do not allow the Fae A tr bution erase process to be interrupted Utility Functions The flash programming plug in provides two functions frequently used in connection with flash programming Save and Blank Check To execute these functions select the Utilities tab STapollo Flash Programming i x Status Flash Image Flash Device Utilities Log Address Range From ox8000_0000 To ox8000_1000 Save Blank Check FIGURE 6 The handy Save and Blank Check functions are accessible via the Utilities tab SAVE The Save function saves the flash memory within a given address range in a binary data file It is equivalent to the debuggers SAVE BIN command Recall that debugger commands can be executed in the Chameleon Command window Since the Save function is not limited to flash memory only you can use it to store 12 FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER USER GUIDE memory blocks of any type The Save function does not depend on any of the parameters set in the Flash Image or Flash Device tabs gt To save a memory range to a file 1 Enter the memory range start and end addresses in the From and
11. eration neglect accident unauthorized installation or repair are not covered by warranty This warranty is in lieu of any other warranty expressed or implied IN NO EVENT SHALL SIGNUM SYSTEMS BE LIABLE FOR CONSEQUENTIAL DAMAGES OF ANY KIND It is up to the purchaser to determine the reliability and suitability of this product for his particular application GINO S Y S T E M S 1211 FLYNN RD UNIT 104 CAMARILLO CA 93012 U S A PHONE 805 383 3682 WWW SIGNUM COM UG C Cham FlashProgPlugin 7 19 04 10 27 410 Chameleon Purpose This document explains how to use the flash programming utility built into the Signum Systems Chameleon Debugger software Installation Chameleon Debugger is furnished with a flash programming plug in This plug in is installed by default but can be uninstalled or reinstalled at any time if necessary For details please refer to Chameleon User Manual Flash Programming Processes The process of programming flash using the plug in programmer consists of two phases e configuring setting the parameters of the plug in and e executing proper plug in commands gt To program the flash memory on your target system Open the Flash Programmer plug in dialog by selecting the Flash Programmer option from the Tools menu The Flash Programming dialog box appears Figure 1 SIGNUM SYSTEM 410 Tools Window Help gt i a CPU E PlugIns Macros gt hucoane H Flash Programmer
12. flash If lt mode gt is greater than zero the programmer calculates and programs a valid User Program Signature at the reserved ARM interrupt vector location 0x14 in SIGNUM SYSTEM 410 LPC2xxx of 0x1C in LPC17 xx e i lt device name gt Forces device identification Use when the device cannot be identified uniquely TITMS470R1 intemal flash programmer Use when the DEV 11 0 register does not uniquely identify your device Example TMS470R1A256 ST Microelectronics STR71x intemal flash programmer Used obligatorily Requires a complete part number ISTR712FR2T6 or flash type code i0 stands for 64K flash i1 for 128K flash and i2 for 256K flash E Philips LPC2 00 LPC17xx internal flash programmer Use when the programmer does not recognize the device automatically Example iLPC2212 or iLPC1751 Analog Devices ADuC70xx intemal flash programmer Use to specify the silicon revision F to Z Forces the use of the mass erase flash function to erase the entire chip Without it the chip is erased sector by sector Note that silicon versions earlier than F do not support the mass erase functionality e c lt mode gt Used to check or calculate parity or ECC bits Available modes E ceven even parity bits used codd odd parity bits used ceee ECC code used e ma lt mask gt Command address mask for the CFI programmer Example ma0x7FF e md lt mask gt
13. r address Value Sequence coma separated list of values to be written to the watchdog register to kick the dog Passes to the programmer the w lt addr gt lt value1 gt lt addr gt lt value2 gt FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER R GU E USE ID PARAM DESCRIPTION ETER option Startup The startup macro prepares the processor for flash ae programming This usually consists in configuring the ice flash and RAM memories where the programmer is to be loaded disabling interrupts as well as enabling and configuring semi hosting The cleanup macro can be used to reverse the changes made by the startup macro A subroutine in the target startup macro can be used instead of a macro file when preceded by the character yourSubroutineName Verbose Generates extended debugging information from the programmer for troubleshooting purposes Passes to the programmer the v option Options Text field for entering special purpose programmer options not found on the Flash Device tab As of this writing the following options are supported e f lt cik gt System clock frequency ccLK in kHz for the Philips LPC2xxx programmer HCLK in MHz for the TI TMS570 internal flash programmer e p lt mode gt Flash device dependent option For Mitsubishi flash devices used by the CFI programmers sets the value of the protection pin 0 or 1 E Philips LPC2 00 LPC17xx internal
14. ramming verification This verification is not to be confused with the verification triggered by the Verify button which is performed by the flash programming plug in See the VERIFY BUTTON section further in the text Finally press the Program button Flash programming commences and the Status text box starts displaying progress report messages 10 FLASH PROGRAMMING PLUGIN FOR CHAMELEON DEBUGGER USER GUIDE DAMN ash eNOP Nannie x Status Programming at 0x44000 Flash Image Flash Device Utilities Log Flash Device AT9S1SAM7Sxx internal flash programmer Soll z Image Name D Alpha Debug 4RM at91 sam7s ek at91sam7se ek v El Address Offset fo IV Erase Before Programming IV Verify While Programming I Close After Programmming ey eme toe _ Save Config Close Help FIGURE 5 Programming operation under way The status is displayed at the top of the dialog box VERIFY BUTTON The Verify button is used to compare the data in a flash image file with the data read from the flash memory Please make sure that the Image Name and Address Offset are set appropriately before you press the Verify button Since this verification is performed by the plug in and not by the programmer the Flash Device does not need to be specified Verification performed using the Verify button is possible only if the entire flash memory to be verified can be read by the plug in ERASE BUTTON This button cle
15. sociated with the current flash device appears in the Programmer drop down list Use the Custom option at the bottom of the Flash Device list to add new devices SIGNUM SYSTEM 410 3 If you are using a Custom device select the Programmer file from the Programmer drop down list or navigate to that file using the browse button on the right Set the programmer parameters Refer to your programmer s documentation for a description of the programmer options PARAM ETER DESCRIPTION Base Address The start memory address of the flash Passes to the programmer the b lt base_addr gt option RAM Address If the RAM Address field is enabled for editing enter the address of the RAM accessible to the plug in The minimum amount of memory required is usually specified in the Flash Device description For instance the CFI 16 bit flash programmer fits 64K RAM Erase Flash erase control Chip erases the entire flash device Range erases all sectors containing the specified range Eg to erase one sector at 0x100_0000 the range can be set to 0x100_0000 0x100_0000 Passes to the programmer the e lt addr gt lt addr gt option Auto erases all sectors in the address range calculated from the image file specified in the Image Name text box Figure 4 Watchdog A sequence of operations of writing to the watchdog register that kicks the dog Address watchdog registe
16. ss 0x100_0000 FlashDevice Erase Chip 1 ig le lashImage EraseBeforeProgramming 0 lashImage VerifyWhileProgramming 0 lugin paramset FlashImage FileType 0 O linker file 1 EX 2 binary 3 SREC lashImage ImageName D Alpha AT91EB40A Flash demo el lugin paramset FlashImage AddressOffset 0 End of flash mac 18 Appendix Using the flash programmer with selected evaluation boards Sharp KEV75401 Evaluation Board This target board is equipped with the LH28F320BFE flash device gt To enable the board for flash programming set the jumpers as follows JUMPER SETTING FUNCTION JP19 Opened Flash boot block not protected JP20 Opened Bus width 16 bit JP27 Closed Flash write protection disabled gt To select a flash memory address set the jumpers as follows JUMPER SETTING FUNCTION JP21 2 3 Flash is selected by CSO and JP22 1 2 located at address 0x40000000 JP21 1 2 Flash is selected by CS1 and JP22 DEN located at address 0x44000000 e When the flash is selected by CSO select the Sharp KEV75401 with the LH28F320BFE flash with CSO programmer in the Flash Device tab See the Configuring the Plug In section e Otherwise select Sharp KEV75401 with the LH28F320BFE flash with CS1 gt To refine flash programming set the following Options in the Flash Device tab Figure 2 19 SIGNUM SYSTEMS OPTION SYNTAX FUNCTION b lt flash base address gt Sets
17. the flash base address e lt start_addr gt lt end_addr gt Erases the sectors in the specified address range y Turns the verbose mode on for troubleshooting purposes For example b0x4000_0000 e0x4000_0000 0x4000_FFFF v defines the flash base address as 0x4000_0000 instructs the programmer to erase the flash memory between address 0x4000_0000 through 0x4000_FFFF and enables the verbose mode of the programmer a UG B Cham FlashProgPlugin 11 24 08 17 06 410 20
18. tion to All Calls level messages the log records the flash image data passed from the plug in to the programmer The Normal log level is designed to help you keep track of the performed operation allowing you to verify the data used to program the flash destination addresses and the like The Users Log and higher levels are designed to troubleshoot the programming process or debug the programmer code These levels degrade programming performance considerably and therefore are not recommended to be used routinely SAVE gt To save the current log 1 Click the Save button The Save As dialog appears 2 Enter the name of the log file or browse for the existing file 3 Press OK to save the log to the file 15 SIGNUM SYSTEM 410 COPY TO CLIPBOARD The Copy To Clipboard button copies the entire current log to the MS Windows clipboard CLEAR The Clear button erases the current log from the flash programming log window Flash Programming using Macros Setting Plug In Parameters for Flash Programming with Macros Perhaps the easiest way to create a macro that configures the plug in is to set the parameters via the plug in GUI interface as described earlier in the Configuring the Plug In section and then to save the configuration commands to a file by pressing the Save Config button Figure 2 Plug in Configuration Macrofile Example lugin paramset FlashImage EraseBeforeProgramming 1 lugin paramset FlashImage Verify
Download Pdf Manuals
Related Search