ACI_File_Params

 Top  Previous  Next

 

typedef struct tagACI_File_Params

{

 UINT    Size;               // (in)  Size of structure, in bytes

 LPCSTR  FileName;           // (in)  File name

 UINT    BufferNumber;       // (in)  Buffer number

 UINT    LayerNumber;        // (in)  Layer number

 UINT    Format;             // (in)  File format: see ACI_PLF_... and ACI_PSF_xxx constants

 DWORD   StartAddressLow;    // (in)  Low 32 bits of start address for ACI_FileSave().

                             //       For ACI_FileLoad(): Ignored if Format != ACI_PLF_BINARY

 DWORD   StartAddressHigh;   // (in)  High 32 bits of start address for ACI_FileSave().

                             //       For ACI_FileLoad(): Ignored if Format != ACI_PLF_BINARY

 DWORD   EndAddressLow;      // (in)  ACI_FileSave(): Low 32 bits of end address

 DWORD   EndAddressHigh;     // (in)  ACI_FileSave(): High 32 bits of end address

 DWORD   OffsetLow;          // (in)  Low 32 bits of address offset for ACI_FileLoad()

 DWORD   OffsetHigh;         // (in)  High 32 bits of address offset for ACI_FileLoad()

} ACI_File_Params;

 

FileName

The name of the file to be loaded to the ChipProg buffer.

BufferNumber

The ordinal number of the destination buffer. Buffer numbers begins from zero.

LayerNumber

The ordinal number of the memory layer in the buffer. Layer numbers begins from zero.

Format

The loadable file's format. See the description of the ACI_PLF_XXX* constants in the aciprog.h header file (see below).

StartAddressLow,

StartAddressHigh

1) If used with the ACI_FileSave function this parameter specifies the first (start) address in the source memory layer, from which the file will be saved.
2) If used with the ACI_FileLoad function, but only when it loads a file in the binary format (Format == ACI_PLF_BINARY), this parameter specifies the first (start) address of the destination memory layer, in which the file will be loaded. Binary images do not carry any addresses for the file loading.

EndAddressLow,

EndAddressHigh

If used with the ACI_FileSave function this parameter defines the last (end) address of the source memory layer, from which the file will be saved.

OffsetLow,

OffsetHigh

The address offset that shifts the file position in the destination memory layer. The offset can be negative as well as positive.

 

This is the bit definition from the aciprog.h header file:

 

*// ACI File formats for ACI_FileLoad()

#define ACI_PLF_INTEL_HEX                0  // Standard/Extended Intel HEX

#define ACI_PLF_BINARY                    1  // Binary image

#define ACI_PLF_MOTOROLA_S                2  // Motorola S-record

#define ACI_PLF_POF                      3  // POF

#define ACI_PLF_JEDEC                    4  // JEDEC

#define ACI_PLF_PRG                      5  // PRG

#define ACI_PLF_OTP                      6  // Holtek OTP

#define ACI_PLF_SAV                      7  // Angstrem SAV

#define ACI_PLF_ASCII_HEX                8  // ASCII Hex

#define ACI_PLF_ASCII_OCTAL              9  // ASCII Octal

 

See also: ACI_FileLoad, ACI_FileSave.