Elprotronic GangPro430 Flash Programmer User Guide

GangPro430 Flash Programmer
for the TI’s MSP430Fxx microcontrollers
Command Line Interpreter User’s Guide
PM015A03 Rev.0
April-12-2007

GangPro430 Flash Programmer

Elprotronic Inc.
16 Crossroads Drive
Richmond Hill,
Ontario, L4E-5C9
CANADA

Web site: www.elprotronic.com
E-mail: info@elprotronic.com
Fax: 905-780-2414
Voice: 905-780-5789

Copyright © Elprotronic Inc. All rights reserved.
Disclaimer:
No part of this document may be reproduced without the prior written consent of Elprotronic Inc.
The information in this document is subject to change without notice and does not represent a commitment on any part of Elprotronic Inc. While the information contained herein is assumed to be accurate, Elprotronic Inc. assumes no  responsibility for any errors or omissions.
In no event shall Elprotronic Inc, its employees or authors of this document be liable for special, direct, indirect, or consequential damage, losses, costs, charges, claims, demands, claims for lost profits, fees, or expenses of any nature or  kind.
The software described in this document is furnished under a licence and may only be used or copied in accordance with the terms of such a licence.
Disclaimer of warranties: You agree that Elprotronic Inc. has made no express warranties to You regarding the software, hardware, firmware and related documentation. The software, hardware, firmware and related documentation being provided to You “AS IS” without warranty or support of any kind. Elprotronic Inc. disclaims all warranties with regard to the software, express or implied, including, without limitation, any implied warranties of fitness for a particular  purpose, merchantability, merchantable quality or noninfringement of third-party rights.
Limit of liability: In no event will Elprotronic Inc. be liable to you for any loss of use, interruption of business, or any direct, indirect, special incidental or consequential damages of any kind (including lost profits) regardless of the form of  action whether in contract, tort (including negligence), strict product liability or otherwise, even if Elprotronic Inc. has been advised of the possibility of such damages.

END USER LICENSE AGREEMENT

PLEASE READ THIS DOCUMENT CAREFULLY BEFORE USING THE SOFTWARE AND THE ASSOCIATED HARDWARE. ELPROTRONIC INC. AND/OR ITS SUBSIDIARIES (“ELPROTRONIC”) IS WILLING TO LICENSE THE  SOFTWARE TO YOU AS AN INDIVIDUAL, THE COMPANY, OR LEGAL ENTITY THAT WILL BE USING THE SOFTWARE (REFERENCED BELOW AS “YOU” OR “YOUR”) ONLY ON THE CONDITION THAT YOU AGREE TO ALL  TERMS OF THIS LICENSE AGREEMENT. THIS IS A LEGAL AND ENFORCABLE CONTRACT BETWEEN YOU AND ELPROTRONIC. BY OPENING THIS PACKAGE, BREAKING THE SEAL, CLICKING “I AGREE” BUTTON OR  OTHERWISE INDICATING ASSENT ELECTRONICALLY, OR LOADING THE SOFTWARE YOU AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THESE TERMS AND CONDITIONS,  CLICK ON THE “I DO NOT AGREE” BUTTON OR OTHERWISE INDICATE REFUSAL, MAKE NO FURTHER USE OF THE FULL PRODUCT AND RETURN IT WITH THE PROOF OF PURCHASE TO THE DEALER FROM WHOM IT  WAS ACQUIRED WITHIN THIRTY (30) DAYS OF PURCHASE AND YOUR MONEY WILL BE REFUNDED.

1. License.
   The software, firmware and related documentation (collectively the “Product”) is the property of Elprotronic or its licensors and is protected by copyright law. While Elprotronic continues to own the Product, You will have certain rights to use the Product after Your acceptance of this license.
   This license governs any releases, revisions, or enhancements to the Product that Elprotronic may furnish to You. Your rights and obligations with respect to the use of this Product are as follows: YOU MAY:
   A. use this Product on many computers;
   B. make one copy of the software for archival purposes, or copy the software onto the hard disk of Your computer and retain the original for archival purposes;
   C. use the software on a network
   YOU MAY NOT:
   A. sublicense, reverse engineer, decompile, disassemble, modify, translate, make any attempt to discover the Source Code of the Product; or create derivative works from the Product;
   B. redistribute, in whole or in part, any part of the software component of this Product;
   C. use this software with a programming adapter (hardware) that is not a product of Elprotronic Inc.

2. Copyright
   All rights, title, and copyrights in and to the Product and any copies of the Product are owned by Elprotronic. The Product is protected by copyright laws and international treaty provisions.
   Therefore, you must treat the Product like any other copyrighted material.

3. Limitation of liability.
   In no event shall Elprotronic be liable to you for any loss of use, interruption of business, or any direct, indirect, special, incidental or consequential damages of any kind (including lost profits) regardless of the form of action  whether in contract, tort (including negligence), strict product liability or otherwise, even if Elprotronic has been advised of the possibility of such damages.

4. DISCLAIMER OF WARRANTIES.
   You agree that Elprotronic has made no express warranties to You regarding the software, hardware, firmware and related documentation. The software, hardware, firmware and related documentation being provided to You “AS IS” without warranty or support of any kind. Elprotronic disclaims all warranties with regard to the software and hardware, express or implied, including, without limitation, any implied warranties of fitness for a particular purpose, merchantability, merchantable quality or noninfringement of third- party rights.

This device complies with Part 15 of the FCC Rules.
Operation is subject to the following two conditions: (1) this device may not cause harmful interference and (2) this device must accept any interference received, including interference that may cause undesired operation.

NOTE: This equipment has been tested and found to comply with the limits for a Class B digital devices, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a  residential installation. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. However,  there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on,  the user is encouraged to try to correct the interference by one of more of the following measures:

• Reorient or relocate the receiving antenna
• Increase the separation between the equipment and receiver
• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected
• Consult the dealer or an experienced radio/TV technician for help.
  Warning: Changes or modifications not expressly approved by Elprotronic Inc. could void the user’s authority to operate the equipment.

This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations.

GangPro430 Command Line interpreter

The GangPro430 Multi-FPA API-DLL can be used with the command line interpreter shell. This shell allows to use the standard Command Prompt windows or script file to execute the API-DLL functions. See the GangPro430 Multi-FPA  API-DLL User’s Guide ( PM025A02 ) for detailed descriptions of the API-DLL functions.
When the standard software package is installed then all required files are located in the directory
C:\Program Files\Elprotronic\MSP430\USB GangPro430\CMD-line and contains

GP430-commandline.exe| -> command line shell interpreter
---|---
GangPro430FPA.dll| -> standard API-DLL files
GangPro430FPA1.dll| ->  —-,,,,,——–
MSPlist.ini| -> initialization file

All API-DLL files should be located in the same directory where the GP430-commandline.exe is located. To start the command line interpreter, the GP430-commandline.exe should be executed.

Command Syntax:
instruction_name ( parameter1, parameter2, …. )
parameter:

1. string ( file name etc. ) – “filename”
2. numbers integer decimal eg. 24 or integer hex eg. 0x18
   Note: Spaces are ignored Instructions are not case sensitive F_OpenInstancesAndFPAs( “# ” )
   and f_openinstancesandfpas( “# ” ) are the same.

Example-1:
Run the GP430-commandline.exe
Type:
F_OpenInstancesAndFPAs( “# ” ) // open instances and find the first adapter (any SN)
Press ENTER – result ->1
(OK)
Type:
F_Initialization()
//initialization with config taken from the config.ini
//setup taken from the GangPro430 – with defined MSP430 type, code file etc.
Press ENTER – result ->1
(OK)
Type:
F_AutoProgram( 0 )
Press ENTER – result ->63 ( 63-> 0011 1111 -> programmed six targets -> OK )
Type:
F_Report_Message()

Press ENTER – result ->displayed the last report message (from the F_Autoprogram(0)) See figure A-1 for result:

Type quit() and press ENTER to close the GP430-commandline.exe program.

Example-2:

F_OpenInstancesAndFPAs( “# ” )// open instances and find the first adapter (any SN)
F_Initialization()
F_Report_Message()
F_ConfigFileLoad( “filename” )//put vaild path and config file name
F_ReadCodeFile( 1, “FileName” )//put vaild path and code file name (TI.txt format)
F_AutoProgram( 0 )
F_Report_Message()
……………………
……………………
F_Put_Byte_to_Gang_Buffer( 1, 0x8000, 0x11 )
F_Put_Byte_to_Gang_Buffer( 1, 0x8001, 0x21 )
……………………
F_Put_Byte_to_Gang_Buffer( 1, 0x801F, 0xA6 )
F_Open_Target_Device()
F_Segment_Erase( 0x8000 )
F_Copy_Buffer_to_Flash( 0x8000, 0x20 )
F_Copy_Flash_to_Gang_Buffer( 0x8000, 0x20 )
F_Get_Byte_from_Gang_Buffer( 1, 0x8000 )
F_Get_Byte_from_Gang_Buffer( 2, 0x8000 )
F_Get_Byte_from_Gang_Buffer( 1, 0x8001 )
F_Get_Byte_from_Gang_Buffer( 2, 0x8001 )
……………………
F_Get_Byte_from_Gang_Buffer( 1, 0x801F )
F_Get_Byte_from_Gang_Buffer( 2, 0x801F )
F_Close_Target_Device()
quit()

List of command line instructions

quit();close the command interpreter program
help();display list below
F_Trace_ON()
F_Trace_OFF()
F_OpenInstances( no )
F_CloseInstances()
F_OpenInstancesAndFPAs( “FileName” )
F_Set_FPA_index( fpa )
F_Get_FPA_index()
F_LastStatus( fpa )
F_DLLTypeVer()
F_Multi_DLLTypeVer()
F_Check_FPA_access(index )
F_Get_FPA_SN( fpa
F_APIDLL_Directory( “APIDLLpath” )
F_Initialization()
F_DispSetup()
F_Close_All()
F_Power_Target( OnOff )
F_Reset_Target()
F_Report_Message()
F_ReadCodeFile( file_format, “FileName” )
F_Get_CodeCS( dest )\n” );
F_ReadPasswFile( file_format, “FileName” )
F_ConfigFileLoad( “filename” )
F_SetConfig( index, data )
F_GetConfig( index )
F_Put_Byte_to_Gang_Buffer( target_no, addr, data )
F_Get_Byte_from_Gang_Buffer( target_no, addr )
F_Clr_Code_Buffer()
F_Put_Byte_to_Code_Buffer( addr, data )
F_Put_Byte_to_Password_Buffer( addr, data )
F_Get_Byte_from_Code_Buffer( addr )
F_Get_Byte_from_Password_Buffer( addr )
F_AutoProgram( 0 )
F_VerifyFuseOrPassword()
F_Memory_Erase( mode )
F_Memory_Blank_Check()
F_Memory_Write( mode )
F_Memory_Verify( mode )
F_Gang_Flash_Read()
F_Open_Target_Device()
F_Close_Target_Device()
F_Segment_Erase( address )
F_Sectors_Blank_Check( start_addr, stop_addr )
F_Copy_Buffer_to_Flash( start_addr, size )
F_Copy_Gang_Buffer_to_Flash( start_addr, size )
F_Flash_to_Gang_Buffer( start_addr, size )
F_Blow_Fuse()
F_Write_Word( addr, data )
F_Write_Byte( addr, data )
F_Copy_Buffer_to_RAM( start_addr, size )
F_Copy_Gang_Buffer_to_RAM( start_addr, size )
F_Copy_RAM_to_Gang_Buffer( start_addr, size )
F_Set_PC_and_RUN( PC_addr )
F_Synch_CPU_JTAG()
F_Get_Targets_Vcc()
F_Get_Targets_Result()
F_Get_Active_Targets_Mask()
F_Disable_FPA_index( fpa )
F_Enable_FPA_index( fpa )
F_Customize( dest, data )

See chapter 4 for detailed description of the instructions listed above.
Note:
Not all instructions listed in the chapter 4 are implemented in the command line interpreter. For example – all instructions uses pointers are not implemented, however this is not limiting the access to all features of the API-DLLs, because all instructions uses pointers are implemented also in the simpler way without pointers.

GangPro430 Command Line Interpreter User’s Guide
PM015A03 Rev.0

Documents / Resources

| Elprotronic GangPro430 Flash Programmer [pdf] User Guide
GangPro430, GangPro430 Flash Programmer, Flash Programmer, Programmer
---|---

References

• Elprotronic Inc. | Provider of Flash and Gang Programmers

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>