CYCLONE-User-Manual.pdf - 第100页

User Manual For Cyclone LC Programmers 100 [imagecontent] This command-line parameter is a string that can be used to describe the SAP image, whether it is stored in a file or on the Cyclone. If the configuration com- ma…

User Manual For Cyclone LC Programmers 99

HC08: CSAPMON08Z.exe

MPC55XX-57XX: CSAPPPCNEXUSZ.exe

RS08: CSAPRS08Z.exe

S12Z: CSAPS12ZZ.exe

STM8: CSAPWIZ01.exe

9.1.2 Filename and Additional Command-Line Parameters

After specifying the executable, the user must also include the [filename] parameter, which

represents the path and filename of the .CFG file. This is shown in blue in the example below. The

user may also include one or more other command-line parameters. The area of the example in

violet shows these other command-line parameters.

>csapacmpz.exe "C:\MyWorkspace\MyProject\KL25Z128_script.cfg"

/imagefile "C:\MyWorkspace\MyProject\KL25Z128_image.sap"

9.1.3 List of Valid Command-Line Parameters

Here is the listing of valid parameters:

[executable] Specifies the particular CSAP executable that is compatible with the user’s device.

Mandatory.

[filename] A configuration file containing configuration commands and comments,

default = PROG.CFG. Mandatory.

[?] Use the '?' character option to cause the utility to wait and display the result of

configuration in the image compiler window. If the user does not use a batch

file to test error level, this provides a method to display the configuration

result. This option should be the FIRST command-line option.

[hideapp] This will cause the CSAP executable programmer to NOT display a visual

presence while running, with the exception of appearing on the taskbar. (32-

bit applications only)

[/logfile logfilename] This option opens a logfile of the name "logfilename" which will cause any

information which is written to the status window to also be written to this file.

The "logfilename" should be a full path name such as c:\mydir\mysub-

dir\mylog.log.

Note: When using Windows, if the logfilename path or filename include any white

spaces then the logfilename path and filename must be surrounded by dou-

ble quotation marks.

[/imagefile imagefilename]Used when the SAP file should be saved to disk instead of stored on the

Cyclone. This specifies the path and filename for the SAP file. A user may

later update a Cyclone with this image file.

Note: If the image path or filename include any white spaces then the image path

and filename must be surrounded by double quotation marks.

User Manual For Cyclone LC Programmers 100

[imagecontent] This command-line parameter is a string that can be used to describe the SAP

image, whether it is stored in a file or on the Cyclone. If the configuration com-

mand :DESCRIBEIMAGE is also present in the .CFG file, this will be overwrit-

ten.

[paramn=s] This is a type of command-line parameter that can be used within the .CFG

file as a placeholder for data, and this data can then be specified on the com-

mand-line. Multiple scripts can potentially reference the same .CFG file, each

specifying different data on the command-line.

The n is a numeral, which allows multiple parameters to be used within the

same .CFG file.

See Section 9.2.4 - Using Command Line Parameters Inside a .CFG File

for more information and examples.

9.2 Configuration (.CFG) File Contents

A Configuration (.CFG) file includes programming commands and the location of the binary files

and programming algorithm to be used during programming. It may also include configuration

commands and may refer to utilities that can augment the programming process, such as

serialization, or setup information for use of a bar code scanner during programming.

Because the CFG file is essential to the process of creating a SAP image, the command-line used

to call CSAP must always use the [filename] parameter to specify a .CFG file. This file will instruct

the image compiler which components will be used to create the eventual SAP image and where to

them, among other things.

9.2.1 Sample .CFG File

A .CFG file is a pure ASCII file that includes one command per line. It will always include two main

types of commands: Configuration Commands and Programming Commands. It can also include a

certain type of command-line parameter that can serve as a placeholder for some of the script

contents.

Below is a sample .CFG for NXP’s Kinetis KL25Z128 device. Lines in the file that begin with

semicolons are comment lines.

The first several lines are comments that describe some of the attributes of the programming

setup. The next several lines, which begin with a colon, are Configuration Commands that are read

before programming. The final several lines are the Programming Commands that will be executed

during the programming process.

; Automatically generated configuration file

; Silicon Manufacturer is NXP

; Silicon Architecture is ARM Based (Kinetis, LPC, etc.)

;

:ALLOWOUTOFRANGE 1

:DEVICE NXP_K7x_K70FN1M0M15

:USESWD 1

:DEBUGFREQUENCY 5560

:SAPGUIVERSION 352E3737

:PROVIDEPOWER

:POWERVOLTAGE 3.0

:POWERDOWNDELAY 250

:POWERUPDELAY 250

:KEEPPOWERON 0

:CUSTOMTRIMREF 31250.00

User Manual For Cyclone LC Programmers 101

:NEWIMAGE

:DESCRIBEIMAGE Test_K70

C:\PEMicro\cyclone\supportfiles\supportFiles_ARM\NXP\K7x\freescale

_k70fn1m0m15_1x32x256k_pflash.arp

SS C:\test\nxp\armcortex\mk_x_32_pflash_dflash_m5_05A0_1FFF.s19

EN ;Erase if not Blank

PM ;Program Module

VC ;Verify Checksum

9.2.2 Configuration Commands

Configuration Commands are commands that will be executed at startup, before the programming

process. You can see configuration commands used inside a sample .CFG file above in Section

9.2.1 - Sample .CFG File. They listed are in the middle of the file. They always begin with a colon.

A listing of valid Configuration Commands and their formats is included below.

9.2.2.1 Target Power Related Configuration Commands

9.2.2.1.1 :PROVIDEPOWER n

Processors: All (EXCEPT MON08)

Determines whether the Cyclone should provide power to the target. (This is the same as legacy

option :USEPRORELAYS n).

Note: Not all hardware interfaces support this command. Valid values of n are:

0 : Cyclone does NOT provide power to target. (default)

1 : Enable Cyclone to provide power to target.

9.2.2.1.2 :POWERVOLTAGE n.n

Processors: All

Use this command if the Cyclone is providing/switching power to the target, otherwise omit this

command. Specifies the target voltage as a real number. Acceptable range is from 1.6V - 5.0V.

:POWERVOLTAGE 3.3 Specifies target voltage as 3.3V

9.2.2.1.3 :KEEPPOWERON n

Processors: All

Determines whether power provided to the target should be turned off when the application

terminates. NOTE: Not all hardware interfaces support this command. Valid values of n are:

0 : Turn power off upon exit (default)

1 : Keep power on upon exit

9.2.2.1.4 :POWERDOWNDELAY n

Processors: All

Amount of time to delay when the power to the target is turned off for the target’s power supply to

drop to below 0.1v. n is the time in milliseconds.

9.2.2.1.5 :POWERUPDELAY n

Processors: All

Amount of time to delay when the power to the target is turned on OR the target is reset, and

before the software attempts to talk to the target. This time can be a combination of power on time

and reset time (especially if a reset driver is used). n is the time in milliseconds.