CYCLONE-User-Manual.pdf - 第86页

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…

100%1 / 149
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.
User Manual For Cyclone LC Programmers 87
8.3 Cyclone Control Console
The Cyclone Control Console, the next component of the Cyclone Control Suite, is an application
that controls Cyclone operations through the use of simple console commands. This application is
very easy to set up and use and offers functionality very similar to using the Cyclone Control DLL
directly.
To find the Cyclone Control Console application, navigate to the following directory:
[INSTALLDIR]\Cyclone Control\
The Cyclone Control software performs all operations specified in simple commands. A separate
batch file would typically be used to launch the utility with the correct parameters.
BLOG TIP: Please click here to visit the PEmicro blog for detailed examples that show how to use
the Cyclone Control Console to connect to the Cyclone, manage programming images, launch
programming, and more.
8.3.1 Startup
a. Connect all Cyclone units to the PC via RS232, USB, or Ethernet. Any combination of
different connections is allowed. The exception is that only one RS232 serial port con-
nection can be used; no more than one Cyclone can be connected via the RS232
serial port.
b. Connect all Cyclones to their target systems. This is done using a ribbon cable that
connects from the Cyclone to a debug header on the target board.
c. Power up the PC, all Cyclone units, and all target systems that require external power.
d. Run the CycloneControlConsole software from the DOS prompt.
8.3.2 Command-Line Parameters
The command-line utility supports the following commands:
-listcyclones
Shows a list of auto-detected Cyclones
-cyclone=[cyclone identifier]
Opens the Cyclone or Cyclones by name or identifier. The Cyclone argument can be a single
identifier or a comma delimited list. Available identifiers are cyclone name, port number, or IP
address.
-listimages
List the images present on all open Cyclones. If there are no open Cyclones the command will list
the images on all detected Cyclones.
-launchimage=[image name or number]
Launch a specific image on the open Cyclones. The image can be identified by name or image
number.
@parameter paramValue3 Ignored, set it to 0.
@parameter paramReference1
A pointer to an array containing the security code
bytes.
@parameter paramReference2
A pointer to a null-terminated character string
containing the security type string (such as 'MON08',
'RENESAS', 'PPCNEXUS').
@returnvalue
True if the security code was set
False otherwise