Elprotronic MSP430 Flash Programmer User Guide

Elprotronic MSP430 Flash Programmer

Product Information

• The MSP430 Flash Programmer is a software tool designed by Elprotronic Inc. for programming MSP430 microcontrollers.
• The software is licensed and may only be used or copied in accordance with the terms of such a license.
• This device complies with Part 15 of the FCC Rules and has been tested and found to comply with the limits for a Class B digital device.
• Elprotronic Inc. assumes no responsibility for any errors or omissions in the information contained in the document.
• The product is not to be used with a programming adapter (hardware) that is not a product of Elprotronic Inc.

Product Usage Instructions

1. Install the MSP430 Flash Programmer software on your computer.
2. Connect your MSP430 microcontroller to your computer using a suitable programming adapter.
3. Launch the MSP430 Flash Programmer software.
4. Select the appropriate settings for your microcontroller and programming adapter.
5. Load the program or firmware you wish to program onto your microcontroller into the MSP430 Flash Programmer software.
6. Program your microcontroller using the MSP430 Flash Programmer software.

Note:
It is important to follow the instructions provided in the user manual carefully and to use the product only as intended to avoid any damage or harm.

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

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.

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:

• 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.

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.

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.

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.

FCC STATEMENT

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.

FlashPro430 Command Line interpreter

The FlashPro430 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 files to execute the API-DLL functions. See the FlashPro430 Multi-FPA API-DLL User’s Guide ( PM010A05 ) 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 FlashPro430\CMD-line

and contains

• FP430-commandline.exe -> command line shell interpreter
• MSP430FPA.dll -> standard API-DLL files
• MSP430FPA1.dll -> —-,,,,,——–
• MSPlist.ini -> initialization file

All API-DLL files should be located in the same directory where the FP430-commandline.exe is located. To start the command line interpreter, the FP430-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 FP430-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 FlashPro430 – with defined MSP430 type, code file etc.

• Press ENTER – result ->1 (OK)

Type:

F_AutoProgram( 0 )
Press ENTER – result ->1 (OK)

Type:

F_Report_Message()
Press ENTER – result -> displayed the last report message (from the F_Autoprogram(0))

See Figure A-1 for the result:

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

Example-2:
Run the FP430-commandline.exe and type the following instructions:

• 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_Buffer( 0x8000, 0x11 )
• F_Put_Byte_to_Buffer( 0x8001, 0x21 )
• F_Put_Byte_to_Buffer( 0x801F, 0xA6 )
• F_Open_Target_Device()
• F_Segment_Erase( 0x8000 )
• F_Copy_Buffer_to_Flash( 0x8000, 0x20 )
• F_Copy_Flash_to_Buffer( 0x8000, 0x20 )
• F_Get_Byte_from_Buffer( 0x8000 )
• F_Get_Byte_from_Buffer( 0x8001 )
• F_Get_Byte_from_Buffer( 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 )
• F_ReadPasswFile( file_format, “FileName” )
• F_ConfigFileLoad( “filename” )
• F_SetConfig( index, data )
• F_GetConfig( index )
• F_Put_Byte_to_Buffer( addr, data )
• F_Copy_Buffer_to_Flash( start_addr, size )
• F_Copy_Flash_to_Buffer( start_addr, size )
• F_Copy_All_Flash_to_Buffer()
• F_Get_Byte_from_Buffer( addr )
• F_GetReportMessageChar( index )
• 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_Open_Target_Device()
• F_Close_Target_Device()
• F_Segment_Erase( address )
• F_Sectors_Blank_Check( start_addr, stop_addr )
• F_Blow_Fuse()
• F_Write_Word( addr, data )
• F_Read_Word( addr )
• F_Write_Byte( addr, data )
• F_Read_Byte( addr )
• F_Copy_Buffer_to_RAM( start_addr, size )
• F_Copy_RAM_to_Buffer( start_addr, size )
• F_Set_PC_and_RUN( PC_addr )
• F_Synch_CPU_JTAG()
• F_Get_Targets_Vcc()

Note:
Not all instructions listed in Chapter 4 are implemented in the command line interpreter. For example – all instructions using pointers are not implemented, however, this is not limiting the access to all features of the API-DLLs, because all instructions using pointers are implemented also in a simpler way without pointers.

References

• Elprotronic Inc. | Provider of Flash and Gang Programmers

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>