CYCLONE-User-Manual.pdf - 第102页

User Manual For Cyclone LC Programmers 102 9.2.2.2 T rim Related (If supported) Configuration Commands 9.2.2.2.1 :CUST OMTRIMREF n.nn Processors: All Desired internal reference clock frequency for the “PT ; Program T rim…

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

User Manual For Cyclone LC Programmers 103

5/10/2018, 5/11/2018, and 5/12/2018. Does not

allow it on any other dates.

9.2.2.4.3 :ERRORLIMIT n

Processors: All

Sets a limit to the number of errors that may occur while the Cyclone is programming devices.

Once this limit has been reached, the Cyclone will no longer program devices until the error limit is

removed or reset.

9.2.2.5 Image Launch Settings Configuration Commands

9.2.2.5.1 :BARFILE barfile

Processors: All

Specifies that a .BAR file will be used during programming (programming initiated by bar code

scanner).

barfile Indicates the path and filename of the .bar file.

Example:

:BARFILE C:\PEMicro\cyclone\imageCreation\barcodeTest.bar

9.2.2.6 Connection Related Configuration Commands (ARM)

9.2.2.6.1 :DEVICE string

Processors: ARM, DSC, MAC7xxx

For ARM devices, this is a mandatory parameter that specifies the device. It is required because

the debug protocol changes between manufacturers and sometimes also between families or

devices.

Where:

string: represents the device and follows the “VENDOR_FAMILY_DEVICE” format.

For ARM devices, the easiest way to obtain the device string is from the Device Selection dialog

in the Cyclone Image Configuration Utility software. In the PEMICRO Connection Manager, click

“Select New Device” to open the Device Selection dialog. Expand the device tree to find your

device, then right-click and select “Copy Device String to Clipboard.”

9.2.2.6.2 :DEBUGFREQUENCY n

Processors: ARM, ColdFire, PPC, MAC7xxx

Specifies the communications frequency with the target device.

n Frequency in Kilohertz.

9.2.2.6.3 :USESWD n

Processors: ARM, MAC7xxx

Allows the user to specify SWD (single wire debug) mode instead of JTAG mode.

0 Specifies that JTAG mode will be used during communications (default).

1 Specifies that SWD (single wire debug) mode will be used during communications.

9.2.2.6.4 :JTAGTAPNUM n

Processors: ARM, MAC7xxx

The JTAG Tap Number is the index of the target device in the daisy chain. The first device

connected to TDI is index 0, the next is index 1, and so on. The index of the last device connected

to the TDO of the debugger is the total number of devices in the chain minus 1.

Note: This command is mandatory for JTAG daisy chain configurations. It is also important to specify