CYCLONE-User-Manual.pdf - 第88页
User Manual For Cyclone LC Programmers 88 -putdynamicdata=[cyclone number],[address],[data] ONL Y SUPPOR TED BY CYCLONE FX OR THE CYCLONE CONTROL SUITE ADV ANCED LICENSE. Performs programming of dynamic data with the sel…
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
User Manual For Cyclone LC Programmers 88
-putdynamicdata=[cyclone number],[address],[data]
ONLY SUPPORTED BY CYCLONE FX OR THE CYCLONE CONTROL SUITE ADVANCED LICENSE.
Performs programming of dynamic data with the selected Cyclone unit. [cyclone number] is the index of the
connected Cyclone in the order in which it was entered. [address] is the starting memory address. [data] are
the bytes of data to be programmed. All values should be in hexadecimal format. No more than 255 bytes
may be programmed this way.
A Cyclone unit may only use this command after it has performed its “-launchimage” command.
If the target is reset after programming the image, “-putdynamicdata” will fail. The workaround to this is to
execute a second blank image that will re-load the algorithm before using this command.
-putdynamicstring=[cyclone number],[address],[string]
Performs programming of dynamic data with the selected Cyclone unit. [cyclone number] is the
index of the connected Cyclone in the order in which it was entered. [address] is the starting
memory address. [string] is the data in string format. No more than 255 bytes may be programmed
this way.
A Cyclone unit may only use this command after it has performed its “-launchimage” command.
If the target is reset after programming the image, “-putdynamicstring” will fail. The workaround to
this is to execute a second blank image that will re-load the algorithm before using this command.
-showproperties=[category],[image id if applicable]
List all available properties in a [category] in the open Cyclones or a stored SAP image by using
the [image id if applicable] argument. Refer to the header file for a list of valid category and
property names. Using an empty string as the [category] value will return the available categories.
-addimageinternal=[filename]
Add a specific programming image to the internal memory of the open Cyclones. [filename] is the
path and filename of the image to be programmed into the Cyclones.
-addimageexternal=[filename]
ONLY SUPPORTED WITH CYCLONE FX OR THE CYCLONE MEMORY EXPANSION LICENSE.
Add a specific programming image to the external memory of the open Cyclones. [filename] is the
path and filename of the image to be programmed into the Cyclones.
-eraseallinternalimages
Preform a format of the internal memory connected to the open Cyclones. This will cause all
internal images to be erased.
-eraseallexternalimages
Preform a format of the external memory connected to the open Cyclones. This will cause all
external images to be erased.
-eraseimage=[image name or number]
Erase an individual image from the open Cyclones. The image can be identified by image name or
by image number.
-listserialfiles
List Serial Files in Cyclone
-addserialfile=[file path]
Add Serial File to Cyclone
-deleteserialfile=[object ID or display index]
Delete Serial File from Cyclone. Can be deleted by ID or by display index.
User Manual For Cyclone LC Programmers 89
-firmwareupdate=[firmware update mode]
Set the firmware update mode to “auto”, “dontupdate”, “forceupdate”. The default mode is “auto.”
-help
Display a list of available commands.
The following command-line parameters require a Cyclone FX, or a Cyclone LC with the
ProCryption Security Activation License.
-listencryptionkeys
List Encryption Key Files that reside on Cyclone
-addencryptionkey=[file path]
Add ImageKey file to Cyclone. The file path is the path to the ImageKey.
-deleteencryptionkey=[object ID or display index]
Delete ImageKey File from Cyclone. Can be deleted by ID, or by display index number (-
listencryptionkeys returns a numbered list of ImageKeys; the display index corresponds to these
numbers).
8.3.3 Examples
The commands should be separated by a space. Every command starts with a “-” character,
arguments follow the “=” character.
8.3.3.1 Typical Usage
This example connects to a single Cyclone identified by its IP address 10.0.1.1 and executes its
first image. This is the most common usage of the Cyclone Control Utility.
This example connects to a single Cyclone enumerated on USB1 and executes its first image.
8.3.3.2 Controlling Multiple Cyclones
This example connects to three separate Cyclone units. Two units are connected via USB
(10.0.1.1 and 10.0.1.2) and the third is connected via Ethernet (10.0.1.3). The three Cyclone units
are configured to execute image #2.
CycloneControlConsole.exe –cyclone=10.0.1.1 –launchimage=1
CycloneControlConsole.exe –cyclone=USB1 –launchimage=1
CycloneControlConsole.exe –cyclone=USB1,10.0.1.2,10.0.1.3 –
launchimage=2