Download C/C++ Communication API - Electronic Systems Group

FUSE C/C++ API Developers Guide
Return
A ‘1’ in a particular bit location indicates that the pin is an input, otherwise the pins is
an output. Returns –1 on error.
Description
This returns the setting of the direction for the specified bank.
7.64
DIME_SaveCardDefinition
Syntax
DWORD DIME_SaveCardDefinition (DIME_HANDLE handle, const char *Filename,
DWORD Flags)
Arguments
handle is a valid handle to a DIME carrier card.
Filename is the filename that the card definition is to be saved to.
Flags: This argument allows the developer to configure the information held within the
card definition files to suit their development needs. The table below gives details for
the Flags.
Flags
Description
dcfgEMBEDALLBITS
It is possible not only to save the name of the assigned bit-files into the card
definition but also to save the bit-streams themselves. If this is desired then
this flag should be used.
This flag actually saves the bit-streams from the assigned bit-files or the
assigned bit-streams for each device on the card into the card definition file.
This file can then be used to completely configure the card. It is the only file
required.
Note: If there are several bit-streams associated to large devices then the
saved card definition file will become very large.
Table 35: DIME_SaveCardDefinition Flags argument options
Return
Returns a pointer to the start of the bit-stream that has been assigned to the selected
device. If no bit-stream has been set for the device then a NULL pointer is returned.
Description
This function should be used to save information regarding the current configuration
of your card to a file. Information such as the modules, devices and the assigned bitfiles/bit-streams to particular devices is all saved.
Notes
By using the dcfgEMBEDALLBITS flag a complete system ‘snapshot’ is created. This can
be very useful for back up purposes or when porting the set up to different PCs.
7.65
DIME_SaveSystemDefinition
Syntax
DWORD DIME_SaveSystemDefinition (DIME_HANDLE **handles, char
**CardFilenames, const char *SysFilename, DWORD NumOfCards, DWORD Flags)
Arguments
handles is a pointer to an array containing the valid card handles for the system.
CardFilenames is a pointer to an array containing the card definition filenames that
correspond with the card handle array.
SysFilename is a pointer to the system definition filename to be created.
NumOfCards is the number of cards that are to be used to create this system. This
number should correspond with the number of elements in the handles array and the
CardFilenames array.
Flags: This argument is used to customise the saving of the system definition file.
Currently there are no flags and this argument is not used. 0 Should be used.
Return
Returns 0 on success. Returns non-zero otherwise.
Description
This function takes a group of card handles and card definition files and creates one
system definition file. This file can then be used to load the complete system without
the requirement of locating or opening the cards.
NT107-0068 Issue 4 19-05-2003
www.nallatech.com
69