GangPro430 Flash Programmer
GangPro430 Flash Programmer
The GangPro430 Flash Programmer is designed for programming TI’s
MSP430Fxx microcontrollers. This Command Line Interpreter User’s
Guide provides detailed instructions for using the programmer.
The product is manufactured by Elprotronic Inc., a Canadian
company with the following contact information:
- Address: 16 Crossroads Drive Richmond Hill, Ontario, L4E-5C9
CANADA - Website: www.elprotronic.com
- Email: [email protected]
- Fax: 905-780-5789
- Voice: 905-780-2414
Disclaimer: No part of the user manual 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
license and may only be used or copied in accordance with the terms
of such a license.
End User License Agreement:
You may:
- Use this product on many computers
- 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 - Use the software on a network
You may not:
- 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 - Redistribute, in whole or in part, any part of the software
component of this product - Use this software with a programming adapter (hardware) that is
not a product of Elprotronic Inc.
FCC Compliance:
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.
Product Usage Instructions:
Before using the GangPro430 Flash Programmer, please read the
user manual carefully and ensure you understand all the terms and
conditions of the End User License Agreement.
The programmer is designed for programming TI’s MSP430Fxx
microcontrollers. To use the programmer, follow the instructions
provided in the Command Line Interpreter User’s Guide. Please note
that the software described in the user manual is furnished under a
license and may only be used or copied in accordance with the terms
of such a license.
Please ensure that you comply with FCC compliance regulations
when using the programmer. The device must not cause harmful
interference and must accept any interference received, including
interference that may cause undesired operation. If the equipment
does cause harmful interference to radio or television reception,
which can be determined by turning the equipment off and on, please
try to correct the interference by one of the methods described in
the user manual.
If you have any questions or concerns about using the GangPro430
Flash Programmer, please contact Elprotronic Inc. for
assistance.
GangPro430 Flash Programmer
for the TI’s MSP430Fxx microcontrollers Command Line Interpreter User’s Guide
PM015A03 Rev.0 April-12-2007
Elprotronic Inc.
Elprotronic Inc.
16 Crossroads Drive Richmond Hill, Ontario, L4E-5C9 CANADA
Web site: E-mail: Fax: Voice:
www.elprotronic.com [email protected] 905-780-2414 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.
2
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;
3
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.
4
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. Cet appereil numerique de la classe B respecte toutes les exigences du Reglement sur le material brouilleur du Canada.
5
Table of Contents
1. GangPro430 Command Line interpreter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 6
1. 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 FilesElprotronicMSP430USB GangPro430CMD-line
and contains
GP430-commandline.exe GangPro430FPA.dll GangPro430FPA1.dll MSPlist.ini
-> command line shell interpreter -> standard API-DLL files -> —-,,,,,——–> 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( “*# *” )
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 7
and f_openinstancesandfpas( “*# *” ) are the same.
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 8
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 -> See figure A-1 for result:
Figure A-1 displayed the last report message (from the F_Autoprogram(0))
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 9
Type quit() and press ENTER to close the GP430-commandline.exe program.
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 10
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()
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 11
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 )
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 12
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
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 13
instructions uses pointers are implemented also in the simpler way without pointers.
GangPro430 Command Line Interpreter User’s Guide PM015A03 Rev.0 14
Elprotronic Inc. | Provider of Flash and Gang Programmers
