CYCLONE-User-Manual.pdf - 第101页

User Manual For Cyclone LC Programmers 101 :NEWIMAGE :DESCRIBEIMAGE Test_K70 CM C:\PEMicro\cyclone\supportfiles\supportFiles_ARM\NXP\K7x\freescale _k70fn1m0m15_1x32x256k_pflash.arp SS C:\test\nxp\armcortex\mk_x_32_pflash…

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.

User Manual For Cyclone LC Programmers 102

9.2.2.2 Trim Related (If supported) Configuration Commands

9.2.2.2.1 :CUSTOMTRIMREF n.nn

Processors: All

Desired internal reference clock frequency for the “PT; Program Trim” command. This frequency

overrides the default internal reference clock frequency. Valid values for “n.nn” depend on the

particular device being programmed. Please refer to the electrical specifications of your device for

valid internal reference frequency clock range.

Where:

n.nn : Frequency in Hertz with two decimal places

9.2.2.3 Information Processing Configuration Commands

9.2.2.3.1 :CLEARSTATUS n

Processors: All

Specifies the amount of time after programming, in milliseconds, before the Success indicator

(LED) will be turned off.

9.2.2.3.2 :DESCRIBEIMAGE string

Processors: All

string This is a string that describes the SAP image. Will overwrite the command-line parameter

“imagecontent” if both are present in the .CFG file.

Example:

:DESCRIBEIMAGE KL25Z128 TEST IMAGE

9.2.2.3.3 :ALLOWOUTOFRANGE n

Processors: All

Sets whether programming will continue when data is out of range.

:ALLOWOUTOFRANGE 1 Allows programming to continue when some data is out of

range (addresses not in module). Out of range data is

ignored.

:ALLOWOUTOFRANGE 0 Requires all programming data to be in range of the module.

Out of range data causes an error on image creation.

9.2.2.4 Image Security Configuration Commands

9.2.2.4.1 :PROGRAMLIMIT n

Processors: All

Sets a limit to the number of devices that the Cyclone may program, until this limit is removed or

reset.

9.2.2.4.2 :DATERANGE mm/dd/yyyy mm/dd/yyyy

Processors: All

Sets a starting date and ending date for Cyclone programming operations. The Cyclone will then

only allow devices to be programmed on or between these two dates, until the date limit is

removed or reset. Dates always refer to the Cyclone’s internal calendar. The character between

the two dates should be a single space. The dates should be listed in chronological order, first to

last.

Example:

:DATERANGE 05/10/2018 05/12/2018 Allows Cyclone programming operations on