ACI Functions

Top  Previous  Next

 

In order to set up and control a ChipProg tool, the program running on the instrumental computer calls the Application Control Interface functions listed in the matrix below. Most of these functions are grouped in "bidirectional couples" (In-Out or Get-Set). Calling some Application Control Interface functions requires structures that specify memory locations, pointers and other objects affiliated with the called function, while other functions do not require any structures. Here is the list of the ChipProg Application Control Interface functions:

 

Application Control Interface function name

Brief description

Associated windows and dialogs

Associated Application Control Interface structures

1. ACI functions that start and stop programming sessions

ACI_Launch

Starts the ChipProgUSB program. This function must always be the very first in the chain of other Application Control Interface functions that form the programming session.

NA

ACI_Launch_Params

ACI_Exit

Closes the ChipProgUSB program. This function must always be the last one in the chain of other Application Control Interface functions. It completes the external control session.

NA

NA

2. ACI functions that configure the programmer or get its current configuration

ACI_LoadConfigFile

Loads the programmer configuration parameters from the host computer to the programmer.

NA

ACI_Config_Params

ACI_SaveConfigFile

Saves the programmer's current configuration parameters to the host computer.
 

NA

ACI_Config_Params

3. ACI functions that get the target device properties or set them

ACI_GetDevice

Gets the manufacturer's name (brand) and the part number of the device currently being programmed from the programmer to the host computer.

Select Device

ACI_Device_Params

ACI_SetDevice

Sets the manufacturer's name and the part number of the device to be programmed in the programmer.

Select Device

ACI_Device_Params

4. ACI functions that get current parameters of the buffers and layers or configure them

ACI_GetLayer

Gets the parameters of a specified memory buffer and layer from the programmer to the host computer.

Buffer Dump

ACI_Layer_Params

ACI_CreateBuffer

Creates a memory buffer with specified parameters in the programmer.

Buffer Dump

ACI_Buffer_Params

ACI_ReallocBuffer

Changes a size of the layer #0 in a specified memory buffer in the programmer.

Buffer Dump

ACI_Buffer_Params

5. ACI functions that read the content of the buffer layer or write into it

ACI_ReadLayer

Reads data from a specified memory buffer in the programmer to the host computer.

Buffer Dump

ACI_Memory_Params

ACI_WriteLayer

Writes data into a specified memory buffer of the host computer to the programmer memory buffer.

Buffer Dump

ACI_Memory_Params

ACI_FillLayer

Fills a whole selected layer of a specified memory buffer with a specified data pattern.

Buffer Dump

ACI_Memory_Params

6. ACI functions that get programming parameters from the programmer or set them in the programmer

ACI_GetProgrammingParams

Gets current programming parameters from the programmer to the host computer.

Program Manager > Options

ACI_Programming_Params

ACI_SetProgrammingParams

Sets programming parameters from the host computer to the programmer.

Program Manager > Options

ACI_Programming_Params

7. ACI functions that get device-specific programming options from the programmer or set them in the programmer

ACI_GetProgOption

Gets current programming options from the programmer to the host computer.

Device and Algorithm Parameters

ACI_ProgOption_Params

ACI_SetProgOption

Sets programming options from the host computer to the programmer.

Device and Algorithm Parameters

ACI_ProgOption_Params

ACI_AllProgOptionsDefault

Sets default programming options and programming algorithms in the programmer.

Device and Algorithm Parameters

ACI_ProgOption_Params

8. ACI functions that control programming operations

ACI_ExecFunction

Initiates a specified programming operation, keeping under control its successful completion or failure.  It controls a single programmer.

Program Manager

ACI_Function_Params

ACI_StartFunction

Initiates a specified programming operation and then does not check the operation result.  It controls a single programmer.

Program Manager

ACI_Function_Params

ACI_GangStart

Used to control multiple device programmers. Initiates auto programming in the gang (multi-programming) mode.
 

Program Manager

ACI_GangStart_Params

ACI_GetStatus

Gets a current programmer status information.

Program Manager

ACI_PStatus_Params

ACI_TerminateFunction

Terminates a current programming operation.

Program Manager

NA

ACI_GangTerminateFunction

Terminates a current programming operation on a specified site of the gang programmer.

Program Manager

ACI_GangTerminate_Params

9. ACI functions that save files from the programmer and load files to the programmer

ACI_FileSave

Saves a specified file from a specified buffer's layer of the programmer into the instrumental computer.

Buffer Dump

ACI_File_Params

ACI_FileLoad

Loads a specified file from the instrumental computer to a specified buffer's layer in the programmer.

Buffer Dump

ACI_File_Params

10. ACI functions that display programmer's windows and dialogs for setting up and debugging external programming sessions

ACI_SettingsDialog

Displays the programmer Preferences dialog.

Configure > Preferences

NA

ACI_SelectDeviceDialog

Displays the Select Device dialog.

Select Device

NA

ACI_BuffersDialog

Displays the memory buffers setting dialog.

Buffer Dump

NA

ACI_LoadFileDialog

Displays the file loading dialog.

Buffer Dump

NA

ACI_SaveFileDialog

Displays the file saving dialog.

Buffer Dump

NA