CYCLONE-User-Manual.pdf - 第85页
User Manual For Cyclone LC Programmers 85 @parameter paramReference2 A pointer to a null-terminated character string which contains the full path to the specified SAP file. @returnvalue T rue if the CRC32 was read False …
User Manual For Cyclone LC Programmers 84
This function reads the firmware version of the selected Cyclone.
8.2.4.6.2 cycloneSpecialFeatures
bool cycloneSpecialFeatures(uint32_t featureNum, bool setFeature, uint32_t
paramValue1, uint32_t paramValue2, uint32_t paramValue3, void *paramReference1,
void *paramReference2);
This function is used for executing special features described by the featureNum parameter. Refer
to the parameter specifications below for details.
@parameter cycloneHandle The handle of the Cyclone of which to read the firmware version.
@returnvalue
Returns a pointer to a null-terminated character string containing
the firmware version.
@parameter featureNum
CYCLONE_GET_IMAGE_DESCRIPTION_FROM_FILE
@parameter setFeature
Indicates whether the image file has been decoded.
If previous operations has already decoded the file,
then set it to true. Otherwise set it to false.
@parameter paramValue1 Ignored, set it to 0.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to a pointer to a null-terminated character
string that contains the image description of the SAP
file.
@parameter paramReference2
A pointer to a null-terminated character string which
contains the full path to the specified SAP file.
@returnvalue
True if the image description was read
False otherwise
@parameter featureNum
CYCLONE_GET_IMAGE_CRC32_FROM_FILE
@parameter setFeature
Indicates whether the image file has been decoded.
If previous operations has already decoded the file,
then set it to true. Otherwise set it to false.
@parameter paramValue1 Ignored, set it to 0.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to an unsigned 32-bit value containing the
CRC32 of the SAP file.
User Manual For Cyclone LC Programmers 85
@parameter paramReference2
A pointer to a null-terminated character string which
contains the full path to the specified SAP file.
@returnvalue
True if the CRC32 was read
False otherwise
@parameter featureNum
CYCLONE_GET_IMAGE_SETTINGS_FROM_FILE
@parameter setFeature
Indicates whether the image file has been decoded.
If previous operations has already decoded the file,
then set it to true. Otherwise set it to false.
@parameter paramValue1
The type of setting to extract {configuration script=1,
image unique id etc.=2, serial numbers=3, additional
settings=4, crc_exclusive settings=5}.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to a pointer to a null-terminated character
string that contains the settings of the SAP file.
@parameter paramReference2
A pointer to a null-terminated character string which
contains the full path to the specified SAP file.
@returnvalue
True if the image settings was read
False otherwise
@parameter featureNum
CYCLONE_GET_IMAGE_COMMMAND_LINE_PAR
AMS_FROM_FILE
@parameter setFeature
Indicates whether the image file has been decoded.
If previous operations has already decoded the file,
then set it to true. Otherwise set it to false.
@parameter paramValue1 Ignored, set it to 0.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to a pointer to a null-terminated character
string that contains the command line parameters of
the SAP file.
@parameter paramReference2
A pointer to a null-terminated character string which
contains the full path to the specified SAP file.
@returnvalue
True if the command line parameters was read
False otherwise
User Manual For Cyclone LC Programmers 86
@parameter featureNum
CYCLONE_GET_IMAGE_SCRIPT_FILE_FROM_FI
LE
@parameter setFeature
Indicates whether the image file has been decoded. If
previous operations has already decoded the file,
then set it to true. Otherwise set it to false.
@parameter paramValue1 Ignored, set it to 0.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to a null-terminated character string that
contains the name of the script file.
@parameter paramReference2
A pointer to a null-terminated character string which
contains the full path to the specified SAP file.
@returnvalue
True if the script file was read
False otherwise
@parameter featureNum
CYCLONE_TOGGLE_POWER_NO_DEBUG
@parameter setFeature Ignored, set it to false.
@parameter paramValue1 Ignored, set it to 0.
@parameter paramValue2 Ignored, set it to 0.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1 Ignored, set it to null.
@parameter paramReference2 Ignored, set it to null.
@returnvalue
True if the power was toggled.
False otherwise
@parameter featureNum
CYCLONE_SET_ACTIVE_SECURITY_CODE
@parameter setFeature Ignored, set it to true.
@parameter paramValue1
The security code type (e.g. MON08, Renesas, PPC
Nexus 64 bit, PPC Nexus 256 bit ignored, set it to 0).
@parameter paramValue2 The length of the security code bytes.