Page 1 GangPro430 Flash Programmer for the TI’s MSP430Fxx microcontrollers Remote Control Programming User’s Guide Software version 4.5 PM015A02 Rev.15 April-05-2010 Elprotronic Inc.
Page 2 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.
Page 3 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.
Page 4 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.
Page 5 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.
Page 6: Table Of Contents
F_Initialization ..........54 GangPro430 Remote Control Programming User’s Guide...
Page 7 F_Memory_Write ..........95 GangPro430 Remote Control Programming User’s Guide...
Page 8 Appendix A ............. . 118 GangPro430 Command Line interpreter ....... . . 118 GangPro430 Remote Control Programming User’s Guide...
Page 9: Introduction
1. Introduction GangPro430 Flash Programmer (USB ) can be remotely controlled from other software applications (Visual C++, Visual Basic etc.) via a DLL library. The Multi-FPA - allows to remotely control simultaneously up to sixteen Flash Programming Adapters (FPAs) significantly reducing programming speed in production.
Page 10 To support this new Multi-FPA API-DLL feature, the software package contains seventeen dll files - the Multi-FPA API-DLL selector - sixteen standard single FPAs API-DLLs Figure 1.4 shows the logical connections between these dll files. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 11 The main Multi-FPA file (FPA-selector) allows to transfer API-DLL functions coming from application software to desired single application dll (GangPro430FPA1.DLL to GangPro430FPA16.DLL). Note: Software package contains one USB-FPA DLL file - the GangPro430FPA1.DLL. Files GangPro430FPA2.DLL to GangPro430FPA16.DLL will be copied automatically if required. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 12 API-DLL via transparent Multi-FPA dll. When fpa index is 0 (ALL-FPAs) and results are the same from all FPAs, then the same result is passing back to GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 13 DC power target from the programming adapter, Reset target device, Auto program target device ( erase, blank check, program and verify), Password or fuse verification, All or selected part of memory erase, GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 14 Selected part of memory segment read, Security fuse blow. GangPro430 Flash Programmer software package contains all required files to remotely control programmer from a software application. When software package is installed then by default the DLL file, library file and header file are located in:...
Page 15 Config.ini file has default setup information. Config.ini file can be modified and taken directly form the GangPro430 Flash Programmer (GUI) application software. To create required config.ini file the standard GangPro430 Flash programmer software should be open and required setup (memory option, JTAG/SBW communication speed etc) should be created. When this is done, programming software should be closed and the config.ini file with the latest saved configuration copied to...
Page 16: Getting Started
2. Getting Started Self Test Program The software package contains the GangPro430 Self Test program, that allows to test functionality of the flash programming adapter, users target device and connections between these units. Software package use the Multi-FPA API-DLLs. In the test results printout are listed the DLL functions with syntax, that has been used.
Page 17 DCO data if the BSL password is unknown. The DCO data can be calibrated using the GangPro430 GUI package software when the JTAG or Spy- Bi-Wire access is available (when the JTAG fuse is not blown). See the GangPro430 manual for details.
Page 18: Mygp430Prg Projects
To run your application you will need to allow your application access to the Multi-FPA dynamically linked library. A simple way to do this is to copy the following files into your directory where executable file is located: GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 19 The sample project can be opened by selecting the project file MyGP430Prg.vcproj located in directory ...\Elprotronic\MSP430\USB GangPro430\API-DLL-MyPrg\Cpp\MyGP430Prg The following dialogue box will be displayed when project executed (see figure 2.2). Figure 2.2 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 20 API-DLL requires fixed MCU index when selecting the particular MCU. In the structure above the MCU index required by API-DLL is located in DeviceList[k].index and procedure setting the required MCU becomes as follows GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 21 Config.ini (optional) You can modify file GP430SamplePrg.bas to best fit into your application needs. Other files should not be modified. The remaining files in this project are located in directory ...\Elprotronic\MSP430\USB GangPro430\API-DLL-MyPrg\VB6 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 22: Api Dll Demo Programs
The first demo program is small GUI program with a lot of buttons allowing to separately call functions using DLL library package software. Source code and all related project files are located in the following directory: C++ version GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 23 When the particular serial number should be detected, if more then one adapters are connected to PC, then the FPA-Setup.ini file should be created with the listed desired FPA SN. Using the Notepad editor open the default FPA’s configuration file ‘FPAs-setup.ini’ taken from the Elprotronic’s Figure 2.1 Demo program dialogue screen using DLLs.
Page 24 The list of defined FPA’s serial numbers are taken from the FPAs configuration file and assigned all FPAs to desired FPA indexes (1 to 64). Number of instances to be opened is calculated GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 25 When any of these button is pressed, then a function, exactly in the same way how it is done in the starndard MSP430 GangPro430 Flash Programmer software, is executed. Also buttons Power ON/OFF, RESET has the same action as related buttons in standard programmer. Refer to the GangPro430 USB-MSP430 Gang Flash Programmer User’s Manual for details of these functions.
Page 26 Target no 2: 0x20,0x21,0x22,0x23,0x24,0x25,0x26,..,0x2F Target no 3: 0x30,0x31,0x32,0x33,0x34,0x35,0x36,..,0x3F Target no 4: 0x40,0x41,0x42,0x43,0x44,0x45,0x46,..,0x4F Target no 5: 0x50,0x51,0x52,0x53,0x54,0x55,0x56,..,0x5F Target no 6: 0x60,0x61,0x62,0x63,0x64,0x65,0x66,..,0x6F Make sure that your target device has RAM at location 0x0400 and up. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 27 48 target devices. The programming status report of all units are displayed. Source code and all related project files are located in the following directory: C:\Program Files\Elprotronic\MSP430\USB GangPro430\API-DLL-Demo\Cpp\Demo-8x6\release GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 28 “FPA-setup.ini” file will be activated. In the next step the standard GangPro430 software should be used that allows to access up to six target devices. Using the GangPro430 software the required configuration setup should be created (select microcontroller type, memory options etc) and saved using option “Save Setup us..”.
Page 29 “2. Initialization” button should be pressed and as the next one the “3 Setup file” button should be used. Select the configuration file prepared by the GangPro430 software.. The same configuration setup will be used in all FPAs. On the end the “4.Open Code” should be used and required code file should be selected.
Page 30: Example With Fpa Api Dll
Basic, LabView etc. First should be created destination directory, where the executable files and DLLs will be located. Make a copy off all required files from the Elprotronic’s directory to your destination directory. The files described in the chapter 1 should be copied to the executable destination directory.
Page 31: Example With Multi-Fpa Api Dll
Application DLL should be initialized first, before other DLLs instruction can be used. Initialization opening procedure for the USB-FPA can be as follows: F_OpenInstancesAndFPAs( FPAs-setup.ini); // DLL and FPA initialization F_Set_FPA_index( ALL_ACTIVE_FPA // select all FPA’s F_Initialization( ); // init all FPA’s GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 32 (n=1; n<=MAX_FPA_INDEX; n++ ) status[n] = = F_LastStatus( n); ..........else ..........} while(1); //make an infinite loop until last target device programmed ..............//—vvv instruction below should be called only once at the end vvv---- F_CloseInstances(); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 33 //with the independent downloaded data to all target devices. if ( status != TRUE ) if ( status == FPA_UNMACHED_RESULTS ) for (n=1; n<=MAX_FPA_INDEX; n++ ) status[n] = = F_LastStatus( n); ..........else GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 34 ..............//—vvv instruction below should be called only once at the end vvv---- F_CloseInstances(); See source code in the DEMO program written in Visual C++, Visual Basic or LabView for more detail. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 35: List Of The Dll Instructions
When the process is finished, then at the end Close Target Device instruction should be called. When communication is terminated, then sequential instructions can not be executed. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 36 Note: Inputs / outputs has been defined as INP_X, and LONG_X. Both of them are defined as 4 bytes long (see MSPPrg-Dll.h header file ) #define INP_X _int32 #define LONG_X _int32 Make sure that an application using the DLL file has the same length of desired data. Figure 4.1 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 37 Figure 4.2 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 38 Figure 4.3 Gang BSL connection GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 39 6*64 = 384 target devices at a time. Each instance of an FPA- DLL contains its own copy of buffers, as shown in Figure 4.5 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 40 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 41 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 42: Multi-Fpa Instructions
Instruction must be called first - before all other instruction. Instead this function the F_OpenInstancesAndFPAs is recommended. Important: not recommended It is to use this function. Function used only for compatible with the old software. Use the F_OpenInstancesAndFPAs instead. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 43: F_Closeinstances
Instruction must be called first - before all other instruction. Instead this function the F_OpenInstances can be used. Function can be used only when the USB FPA are used. When the USB-FPA is used, then the function F_OpenInstancesAndFPAs is recommended in the initialization GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 44 SN1- FPA’s serial number that should be assigned to FPA-1 index SN2- FPA’s serial number that should be assigned to FPA-2 index etc. As a delimiter the comma ‘,’ or white space ‘ ’ can be used. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 45 Initialization example: F_OpenInstances_AndFPAs( “*# *” ); // only one FPA - any SN F_OpenInstances_AndFPAs( snlist ); // hardcoded SN list 2.The FPA list in the configuration file: String -> “C:\Program Files\Elprotronic\FPAs-setup.ini” GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 46 //select all available FPAs F_Initialization(); //init all FPAs F_ReadConfigFile( filename ); //download the same configuration to all DLLs. F_ReadCodeFile( format, filename ); //download the same code file to all DLLs. status = AutoProgram(1); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 47: F_Set_Fpa_Index
FPA_INVALID_NO - if used fpa index is not activated or out of range note: FPA_INVALID_NO -> -2 (minus 2) IMPORTANT: When any function is trying to access the invalid FPA, then return value from this function is -2 (FPA_INVALID_NO) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 48: F_Get_Fpa_Index
FPA index ragardless if the index is valid or not, simply returning the value set by the function F_Set_FPA_index(..). The Check_FPA_index will return -2 (minus two) FPA_INVALID_NO if FPA is pointing not initialized FPA (dll instance). Syntax: INT_X MSPPRG_API F_Check_FPA_index ( void ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 49: F_Disable_Fpa_Index
Function allows to enable communication with selected FPA adapter if the mentioned FPA has been disabled using the function F_Disable_FPA_index(...). By default, all FPAs are enabled. Syntax: void MSPPRG_API F_Enable_FPA_index ( BYTE fpa ); Parameters: fpa -> 1 to MAX_FPA_INDEX where MAX_FPA_INDEX = 64 GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 50: F_Laststatus
FPA-1, 2, .. up to 64 F_Multi_DLLTypeVer F_Multi_DLLTypeVer function returns integer number with DLL ID and software revision version. Syntax: MSPPRG_API INT_X F_Multi_DLLTypeVer( void ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 51: F_Get_Fpa_Sn
-> 1..64 Return value: Serial number of the selected FPA or FPA_INVALID_NO - if used fpa index is not activated or out of range. note: FPA_INVALID_NO -> -2 (minus 2) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 52: Generic Instructions
Multi-FPA functions. Syntax: MSPPRG_API LONG_X F_Check_FPA_access ( INT_X USB_index ); Parameters: Index: USB driver index from 1 to MAX_USB_DEV_NUMBER where MAX_USB_DEV_NUMBER = 64 Return value: GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 53 F_Check_FPA_access( 4 ); //assign FPA SN[4] = 20060135 to FPA-2 F_Set_FPA_index( // select access to the third instance F_Check_FPA_access( 2 ); //assign FPA SN[2] = 20060147 to FPA-3 F_Set_FPA_index( ALL_ACTIVE_FPA // select all active instances F_Initialization() // All FPAs initialization ......GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 54: F_Initialization
1 - TRUE 4 - Programming adapter not detected. Example: ......F_API_DLL_Directory( “..” ) // optional - see F_API_DLL_Directory() If( F_Initialization() != TRUE ) //required API-Dll - initialization // Initialization error ......GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 55: F_Api_Dll_Directory
- ( 1 to 64 ) or 0 (ALL FPAs) executed sequentially. F_Close_All function should be called as the last one before *.dll is closed. When the F_Close_All is called then communication port becomes closed and all internal dynamic data will be released GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 56: F_Getsetup
Return value: 0 - FALSE 1 - TRUE -2 (0xFFFFFFFE) - FPA_INVALID_NO F_ConfigSetup F_ConfigSetup - Setup programmer’s configuration. VALID FPA index - ( 1 to 64 ) or 0 (ALL FPAs) executed sequentially. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 57 Listed name and indexes in the [] brackets are related to the F_SetConfig and F_GetConfig instructions. Note: See the GangPro430-Dll.h header file for the list of the latest indexes, definitions etc.
Page 58 Indexes used by the F_SetConfig and F_GetConfig functions CFG_INTERFACE (See new function F_Set_MCU_Name(..)) CFG_MICROCONTROLLER CFG_POWERTARGETEN CFG_COMMSPEED CFG_RESETTIME CFG_FLASHERASEMODE CFG_ERASEINFOA CFG_ERASEINFOB CFG_ERASESTARTADDR CFG_ERASESTOPADDR CFG_FLASHREADMODE CFG_READINFOA CFG_READINFOB CFG_READSTARTADDR CFG_READSTOPADDR CFG_VERIFYMODE CFG_BLOWFUSE CFG_APPLSTARTEN CFG_BEEPEN CFG_ERASEINFOC CFG_ERASEINFOD CFG_DEFERASEMAINEN CFG_READINFOC CFG_READINFOD GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 59 CFG_RUNTIMETDIGENEN CFG_RUNTIMETDIGENDIV CFG_RUNTIMETDIGENPRESCALER CFG_DCO1_CAL_ENABLE CFG_DCO2_CAL_ENABLE CFG_DCO3_CAL_ENABLE CFG_DCO4_CAL_ENABLE CFG_DCO5_CAL_ENABLE CFG_DCO6_CAL_ENABLE CFG_DCO7_CAL_ENABLE CFG_DCO8_CAL_ENABLE CFG_DCO1_CAL_FREQ_INDEX CFG_DCO2_CAL_FREQ_INDEX CFG_DCO3_CAL_FREQ_INDEX CFG_DCO4_CAL_FREQ_INDEX CFG_DCO5_CAL_FREQ_INDEX CFG_DCO6_CAL_FREQ_INDEX CFG_DCO7_CAL_FREQ_INDEX CFG_DCO8_CAL_FREQ_INDEX CFG_DCO_DEFINED_ADDR_EN CFG_DCO_DEFINED_ADDRESS CFG_RESERVED_1 61 //empty - for compatibility with FlashPro430 CFG_APPL_RESETVCCTIME CFG_MASSERASE_AND_INFOA_EN CFG_DCO_CONST_2XX_VERIFY_EN GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 60 - Any microcontroller - from F1xx or F4xxst 1 - MSP430F110 2 - MSP430F1101 3 - MSP430F1101A 4 - MSP430F1111A etc. See the latest MSP430 list and indexes in the FlashPro430 (GUI) software. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 61 - in the MSP430F2xx - (0x10C0-0x10fF) FlashEraseModeIndex = ERASE_DEF_CM_INDEX [ CFG_ERASEINFOB 7 ] EraseSegmB - Info Segment B (0x1000-0x107F) Erase/Write/Verify, - in the MSP430F2xx - (0x1080-0x10BF) FlashEraseModeIndex = ERASE_DEF_CM_INDEX [ CFG_ERASEINFOC 19 ] GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 62 - Read from the Info Segment B [ CFG_READINFOC 23 ] ReadSegmD - Read from the Info Segment B FlashReadModeIndex = READ_DEF_MEM_INDEX [ CFG_READSTARTADDR 13 ] ReadStartAddr 0x1100 to 0x1FFFE ;see above [ CFG_READSTOPADDR 14 ] GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 63 25 ] VccIndex - valid for the USB-MSP430-FPA version 2.x and higher VCC_2V2_INDEX VCC_2V4_INDEX VCC_2V6_INDEX VCC_2V8_INDEX VCC_3V0_INDEX VCC_3V2_INDEX VCC_3V4_INDEX VCC_3V6_INDEX [ CFG_CUSTOMRESETPULSETIME 26 ] CustomResetPulseTime value 1 to 1000 step 1 in miliseconds GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 64 Enable retain the DCO Calibration Data for the F2xx family. Data are saved in the INFO flash memory at location 0x10F8 to 0x10FF [ CFG_RETAIN_DEF_DATA_INDEX 35 ] (See FlashPro430 Manual - chapter 6) Disable retain the user defined data in flash. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 65 46 ] [ CFG_DCO5_CAL_ENABLE 47 ] [ CFG_DCO6_CAL_ENABLE 48 ] [ CFG_DCO7_CAL_ENABLE 49 ] [ CFG_DCO8_CAL_ENABLE 50 ] 0-disable, 1-enable [ CFG_DCO1_CAL_FREQ_INDEX 51 ] [ CFG_DCO2_CAL_FREQ_INDEX 52 ] [ CFG_DCO3_CAL_FREQ_INDEX 53 ] GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 66 0 - " n o n e " 1 - "Arithmetic sum ( 8b / 16b )" 2 - "Arithmetic sum ( 8b / 32b )" 3 - "Arithmetic sum (16b / 16b )" GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 67 [ CFG_CS3_START_ADDR [ CFG_CS4_START_ADDR - Start address value [ CFG_CS1_END_ADDR [ CFG_CS2_END_ADDR [ CFG_CS3_END_ADDR [ CFG_CS4_END_ADDR - End address value [ CFG_CS1_RESULT_ADDR [ CFG_CS2_RESULT_ADDR [ CFG_CS3_RESULT_ADDR [ CFG_CS4_RESULT_ADDR - Result address value GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 68 - 0x08 - BSL Segment 3 (0x1600-0x17FF) [ CFG_DCO_EXT_RESISTOR_EN 0 - disable 1 - enable Note: See the GangPro430-Dll.h header file for the list of the latest indexes, definitions etc. Example: Example below shows the method of modification of the programmers configuration setup. First the current setup from the programmer is uploaded to the application, after that some of the parameters have been modified and at the end the modified setup is returned back to the programmer.
Page 69: F_Setconfig
- ( 1 to 64 ) structure is read. Similar to the F_GetSetup, but only one item from the CONFIG_BLOCK Syntax: MSPPRG_API LONG_X F_GetConfig( INT_X index ); Index’s list - see F_SetConfig GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 70: F_Set_Mcu_Name
Return value: >= 0 - Index of the selected MCU -1 - error - invalid MCU name. Example: ....... F_Set_MCU_Name( “MSP430F5438" ); ....... F_Get_Device_Info F_Get_Device_Info - Get information related to selected microcontroller. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 71 Below is an example of the procedure that can take names of all supported devices by the API-DLL. The max size can be tested from the API-DLL, until device name is empty when the microprocessor GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 72 DEVICELIST tmp; tmp.index = 0; *tmp.name = '\0'; index_bak = F_GetConfig( CFG_MICROCONTROLLER ); //get current uP index for(k=0; k<MAX_NO_OF_DEVICES; k++) DeviceList[k] = tmp; //clr device list max_up_index = 0; for(k=0; k<MAX_NO_OF_DEVICES; k++) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 73: F_Dispsetup
); F_DispSetup F_DispSetup - Copy programmer’s configuration to report message buffer in text form. VALID FPA index - ( 1 to 64 ) Syntax: MSPPRG_API INT_X F_DispSetup( void ); Return value: GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 74: F_Reportmessage, F_Report_Message
1000 last characters. Syntax: MSPPRG_API void F_ReportMessage( char * text ); MSPPRG_API char* F_Report_Message( void ); F_Report_Message note: is available only with the Multi-FPA API-DLL. Return value: none GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 75: F_Getreportmessagechar
This function is useful in the Visual Basic application, where all message can not be transfered via pointer like it is possible in the C++ application. Syntax: MSPPRG_API char F_GetReportMessageChar( INT_X index ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 76: F_Dlltypever
Message = text; SetDlgItemText(IDC_REPORT, Message.GetBuffer(Message.GetLength())); CEdit* pEdit = (CEdit*) GetDlgItem(IDC_REPORT); pEdit->LineScroll(pEdit->GetLineCount(), 0); UpdateWindow(); F_DLLTypeVer F_DLLTypeVer - Get information about DLL software type and software revision. VALID FPA index - ( 1 to 64 ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 77: F_Configfileload, F_Config_Fileload
- Single-DLL for the FlashPro430 - Parallel Port DLL ID = 0x2000 - Single-DLL for the FlashPro430 - USB DLL ID = 0x3000 - Single-DLL for the GangPro430 - USB DLL ID = 0x6000 - Multi-DLL for the FlashPro430 DLL ID = 0x7000 - Multi-DLL for the GangPro 430 Version = (0x0FFF &...
Page 78 Below is an example of configuration file. Note, that not all parameters are listed in the configuration example. Example: st = F_ConfigFileLoad( “c:\test\configfile.cfg” ); if(( st & 1 ) == TRUE ) ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 79: F_Power_Target
- FPA_INVALID_NO Example: ..... F_Power_Target( 1 ); // Turn Power ON ..... F_Power_Target( 0 ); // Turn Power OFF ..... F_Reset_Target F_Reset_Target - Generate short RESET pulse on the target’s device RESET line. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 80: F_Get_Targets_Result
INT_X F_Get_Targets_Result( void ); Return value: INT_X - execution result for up to sic target devices. Bit - 0 - false bit - set - true -2 (0xFFFFFFFE) - FPA_INVALID_NO Example: INT_X st; ..........GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 81: F_Get_Active_Targets_Mask
//devices - no 1,2,3 and 4 F_Open_Target_Device(); st = F_Get_Active_Targets_Mask(); //if st == 0x0F then communication //with four selected target //devices have been activated. //if st == 0x0B then access to the target device no ‘3' failed. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 82: F_Get_Targets_Vcc
-> output from FPA RESET - LO -> output from FPA RESET - HI VccOn -> -> output Vcc from FPA - OFF -> output Vcc from FPA - ON (level 2.2V to 3.6V set in CFG_VCCINDEX ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 83: Data Buffers Access Instructions
Function F_ReadCodeFile downloads code from the file to internal memory buffer. Code file format and file name and location path of the desired file must be specified. Three file formats are supported GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 84 -> CODE_IN_ROM CODE_IN_RAM CODE_OUT_OF_FLASH CODE_OVERWRITTEN error -> INVALID_CODE_FILE OPEN_FILE_OR_READ_ERR Example: int st; ....st = F_ReadCodeFile( FILE_TI_FORMAT, “c:\test\demofile.txt” ); if(( st & 1 ) == TRUE ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 85: F_Get_Codecs
All other data is ignored. Code file format and file name and location path of the desired file must be specified. Three file formats are supported - Texas Instruments text GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 86 -> INVALID_CODE_FILE OPEN_FILE_OR_READ_ERR PASSWORD_NOT_FOUND Example: st = F_ReadPasswFile( FILE_TI_FORMAT, “c:\test\demofile.txt” ); if(( st & 1 ) == TRUE ) ....else Info = st & 0xFFFE; ........GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 87: F_Clr_Code_Buffer
Use the F_Clr_Code_Buffer() instruction to fully clear the Code buffer before writing the new data block. Syntax: MSPPRG_API INT_X F_Put_Byte_to_Code_Buffer( LONG_X address, GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 88: F_Get_Byte_From_Code_Buffer
F_Get_Byte_from_Code_Buffer( LONG_X address ); Parameters value: code address - 0x1000 to 0x1FFFF Return value: 0x00 to 0xFF - valid code data -1 (0xFFFFFFFF) - code data not initialized on particular address -2 (0xFFFFFFFE) - FPA_INVALID_NO GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 89: F_Put_Byte_To_Password_Buffer
= 0xFFE0; address <= 0xFFFF; address ++ ) F_Put_Byte_to_Password_Buffer( address, code[address]); ..... F_Get_Byte_from_Password_Buffer F_Get_Byte_from_Password_Buffer - Read code data from password buffer. VALID FPA index - ( 1 to 64 ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 90: F_Put_Byte_To_Gang_Buffer
1 - TRUE if specified address is legal (0x0000 to 0x1FFFF) FALSE - if address is not valid -2 - FPA_INVALID_NO. NOTE: Specified address in the temporary RAM or Flash buffer is the same as a physical RAM/FLASH address. Example: ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 91: F_Get_Byte_From_Gang_Buffer
Requested byte from the specified address of the RAM/Flash temporary buffer. Example: see F_Copy_All_Flash_To_Buffer. NOTE: Specified address in the temporary RAM or Flash buffer is the same as a physical RAM/FLASH address. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 92: Encapsulated Instructions
- erase flash memory - restore retain data (including DCO constants) if enabled, - confirm if memory has been erase, - flash programming and verification, - flash memory check sum verification, - blowing the security fuse ( if flag BlowFuseEn = 3 ). GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 93 F_SetConfig( CFG_TARGET_EN_INDEX, (INT_X)targets_mask ); if( F_AutoProgram(0) == targets_mask ) //all target devices programmed else //some targets has nod been programmed ....//exit if the last microcontrollers // has been programmed } while(1); ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 94: F_Verifyfuseorpassword
= 1 -> erase all Flash memory, regardless FlashEraseModeIndex; Return value: Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 95: F_Memory_Blank_Check
- FPA_INVALID_NO F_Memory_Verify F_Memory_Verify - Verify contents of the selected Target Devices Flash Memory and Code file. VALID FPA index - ( 1 to 64 ) or 0 (ALL FPAs) executed simultaneously. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 96: F_Gang_Flash_Read
F_Get_Byte_from_Gang_Buffer( BYTE target_no, LONG_X addr ); Syntax: MSPPRG_API INT_X F_Gang_Flash_Read( void ); Return value: Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 97 Example: BYTE data[0x20000][MAX_TARGET_DEVICE_NUMBER]; unsigned int addr,n; ....st = F_Gang_Flash_Read(); if ( st != 0 ) for( n=0; n<MAX_TARGET_DEVICE_NUMBER; n++) for( addr=0x1000; addr<=0x1FFFF; addr++) data[addr][n] = F_Get_Byte_from_Gang_Buffer( n, addr ); ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 98: Sequential Instructions
The cumulative time for the older MSP430 microcontrollers ( F1xx, F4xx) is typically 4 ms. For the newer ones - 10 ms. See the device- specific datasheet for specifications. . GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 99: F_Open_Target_Device
Target device is ready to get other sequential instructions. Syntax: MSPPRG_API INT_X F_Open_Target_Device( void ); Return value: Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 100: F_Close_Target_Device
Target device is released from the programming adapter. Syntax: MSPPRG_API INT_X F_Close_Target_Device( void ); Return value: Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 101: F_Segment_Erase
When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO Example: ....F_Segment_Erase(0x4000); // erase segment 0x4000 to 0x41FF F_Segment_Erase(0x4100); // erase the same segment F_Segment_Erase(0x1010); // erase INFO segment 0x1000 to 0x107F ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 102: F_Sectors_Blank_Check
This RAM area is used by stack and firmware for the BSL or Fast BSL. Write one word to any location of the target devices. Write to Flash has no effect. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 103: F_Write_Byte
F_Write_Byte( LONG_X addr, BYTE data ); Return value: Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO Example: F_Write_Byte( 0x33, 0x20 ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 104: F_Copy_Buffer_To_Flash
- Write data block from Write Gang Buffers to Target Devices. - Data from Gang Buffer no’1' to Target Device no ‘1' - Data from Gang Buffer no’2' to Target Device no ‘2' GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 105 ....for( n=0; n<MAX_TARGET_DEVICE_NUMBER; n++) for( addr=0x1000; addr<=0x1020; addr++) F_Put_Byte_to_Gang_Buffer( n, addr, data[addr][n] ); ....mask = 0x3F; //enable all six target devices F_SetConfig( CFG_TARGET_EN_INDEX, (INT_X)mask ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 106: F_Copy_Buffer_To_Ram
Specified address in the temporary RAM/Flash buffer is the same as a physical RAM address. Example: ....for( addr = 0x220; addr<0x300; addr++ ) st = F_Put_Byte_To_Gang_Buffer( 1, addr, data[addr] ); st = F_Copy_Buffer_to_RAM( 0x220, 0xE0 ); ....GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 107: F_Copy_Gang_Buffer_To_Ram
Target devices result mask - 0x00 to 0x3F When bit is ‘1' - TRUE ‘0' - FALSE -2 (0xFFFFFFFE) - FPA_INVALID_NO NOTE: Specified address in the temporary RAM/Flash buffer is the same as a physical RAM address. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 108: F_Copy_Ram_To_Gang_Buffer
Specified address in the temporary RAM/Flash buffer is the same as a physical RAM address. Example: ........st = F_Copy_RAM_to_Gang_Buffer( 0x220, 0xE0 ); if( st == TRUE ) for( n=0; n<MAX_TARGET_DEVICE_NUMBER; n++) for( addr = 0x0220; addr<0x0300; addr++ ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 109: F_Copy_Flash_To_Gang_Buffer
Example: ........st = F_Copy_Flash_to_Gang_Buffer( 0x2220, 0xE0 ); if( st == TRUE ) for( n=0; n<MAX_TARGET_DEVICE_NUMBER; n++) for( addr = 0x2220; addr<0x2300; addr++ ) data[addr][n] = F_Get_Byte_from_Gang_Buffer( n, addr ); else GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 110: F_Set_Pc_And_Run
F_Autoprogram(0); // download the test code F_Open_Target_Device(); ....F_Set_PC_and_RUN( PC1 ) // run the test program from location PC1 for( k = 0; k<1000; k++) F_Capture_PC_Addr( 0 ); st = 1; for( target = 1; target<6; target++) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 111 F_Capture_PC_Addr( target ) > PC_addr_max_3 ) st = 0; if( st == 1 ) break; delay (...) F_Synch_CPU_JTAG(); F_Memory_Read_Data( address, size, byte_buffer ); // read the test-n result from the RAM F_Close_Target_Device(); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 112: F_Capture_Pc_Addr
F_Open_Target_Device can recover the JTAG communication with CPU. VALID FPA index - ( 1 to 64 ) or 0 (ALL FPAs) executed sequentially. NOTE: Instruction not supported in BSL and Fast BSL. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 113: F_Blow_Fuse
BlowFuseEn communication with the target device just before execution of the F_Blow_Fuse instruction and disabled after. NOTE: Instruction not supported in BSL and Fast BSL. Syntax: MSPPRG_API INT_X F_Blow_Fuse( void ); GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 114 = F_Blow_Fuse( void ); // Blow the security Fuse ....// break; if the last microcontroller // has been programmed } while(1); ....// prepare next microcontroller F_SetConfig( CFG_INTERFACE, INTERFACE_JTAG);//select JTAG interface GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 115: F_Adj_Dco_Frequency
DCO_data[target] = F_Get_DCO_constant( target); F_Get_DCO_constant F_Get_DCO_constant - Get the DCO constant after adjusting the DCO with F_Adj_DCO_Frequency(...) Function VALID FPA index - ( 1 to 64 ). Syntax: MSPPRG_API INT_X F_Get_DCO_constant( BYTE target_no GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 116: F_Test_Dco_Frequency
VALID FPA index - ( 1 to 64 ). Syntax: MSPPRG_API INT_X F_Set_DCO_constant( BYTE target_no, INT_X DCO_constant ); Return value: 0 - invalid target number 1 - ok Example: See F_Test_DCO_Frequency(.. ) function GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 117: F_Get_Dco_Freq_Result
F_Test_DCO_Frequency(); VALID FPA index - ( 1 to 64 ). Syntax: MSPPRG_API INT_X F_Get_DCO_Freq_result( BYTE target_no ); Return value: DCO frequency in Hz Example: See F_Test_DCO_Frequency(.. ) function GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 118: Gangpro430 Command Line Interpreter
1. string ( file name etc. ) - "filename" 2. numbers eg. 24 integer decimal integer hex eg. 0x18 Note: Spaces are ignored Instructions are not case sensitive F_OpenInstancesAndFPAs( "*# *" ) f_openinstancesandfpas( "*# *" ) are the same. GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 119 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 )
Page 120 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() GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 121 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 ) GangPro430 Remote Control Programming User’s Guide PM015A02 Rev.15...
Page 122 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 Remote Control Programming User’s Guide PM015A02 Rev.15...

Elprotronic GangPro430 User Manual

Quick Links

Need help?

Questions and answers

Related Manuals for Elprotronic GangPro430

Summary of Contents for Elprotronic GangPro430

Table of Contents