presto_en.pdf - 第63页

Page 63 On the commandline it is recom mended t o use projec t file, it con tains import ant sett ings for programming. Some project sett ings can be modified u sing co mmandline parameters. Co mmandline param eters have…

100%1 / 101
Page 62
Code/Main Memory Editor
Menu: View ➙ Display code/main memory
Keyboard shortcut to open the window: F10
Keyboard shortcut to close the window: Esc
The code/main memory editor displays the code/main
memory content or the content of the memory itself in
case of serial EEPROM chips (24xx, 93xx,...).
Data Memory (EEPROM) Editor
Menu: View ➙ Display data memory
Keyboard shortcut to open the window: F11
Keyboard shortcut to close the window: Esc
The data memory editor is used for displaying the content
of the additional memory in some devices (typically
EEPROM).
Not all devices have an additional memory. This means
the editor may not be available for some devices.
Configuration Memory Editor
Menu: View ➙ Display configuration memory
Keyboard shortcut to open the window: F12
Keyboard shortcut to close the window: Esc
The configuration memory editor displays settings that
are to be programmed in a device, but are not part of any
of the above memory types.
The configuration memory editor content depends on the
selected device type. It is necessary to get acquainted
with the device's data sheet in order to get a closer
explanation of individual options in this window.
Not all devices need configuration data. This means the
editor may not be available for some devices.
Tips for Advanced Users
Even though the configuration memory may be presented
as a set of settings, in reality it is nothing more than a
memory that can be approached cell by cell. Due to this,
it is possible to display the memory in this way.
This can be achieved by activating Options ➙ Program
settings ➙ Editors ➙ Configuration memory editor:
show cfg word instead of fuses option or by double-
clicking the configuration memory window.
The device's ID positions (do not mistake for Device ID)
can also be found in the configuration memory window. ID
positions can be programmed with values identifying the
device, such as the serial number, for example. ID
positions can always be read - even if the device is locked
against reading.
According to the recommendation of the Microchip, ID
positions should not be programmed with any value; only
a certain number of bits (typically 4) should carry data for
identification while other bits should be programmed with
the default value.
This can be achieved by activating Options ➙ Program
settings ➙ Editors ➙ Mask ID positions....
5.6
Running UP from
Command Line
The UP program can alternatively be controlled from the
command line.
The program itself makes sure that it always runs in one
instance only (with one class name). Should a second
instance (with the same class name) be started,
parameters from the command line are transferred to the
first instance for execution. Only the /p, /pdiff, /blank, /
verify, /erase, /read, /noe, /eeonly, /noboot, /boot, /code, /
cfg parameters are transfered to the running instance. UP
can be started in more instances using different class
name, see /wnd in List of Parameters.
Page 63
On the commandline it is recommended to use project
file, it contains important settings for programming. Some
project settings can be modified using commandline
parameters. Commandline parameters have higher
priority than the settings from the project defined on the
commandline.
5.6.1 List of Parameters
UP.EXE [{/ask | /q | /q1}]
[{/e
File_with_eepromm.hex | [/noe]}] [{/p |[/pdiff]| [/
o]}
File.hex | File.ppr] [/df File.hex] [/part
device_name] [/eeonly] [/erase][/w[nd]
up_window_class] [/cfg] [/devid] [/blank] [/verify File]
[/read
File] [/s SN_programmer's][/progname name] [/
noboot] [/boot] [/code] [/getpartrev] [/sn
serial_number] [/conf file]
Legend
• Text presented here in bold is to be keyed in in the
command line exactly as printed here.
• Text presented here in italics is to be replaced by the
corresponding parameter. For example, file_name
should be replaced with the real name of a file to be
opened.
• Text in braces {} separated by the | sign represents a
selection of one of the presented options. For example,
{ A | B } means “choose either A or B”.
• Text in square brackets [] presents an optional
parameter – it can be keyed in but does not have to.
• Text in quotation marks “ ” is a mnemonic.
/ask To be used linked with /p. The program
always asks if it is to continue before
launching the actual device programming
even if the program settings specify not to
ask. The dialog displays the selected device
type.
/q /quiet “Quiet” mode. The program does not ask
any questions. If it needs to display a
dialog, the execution finishes with an error.
See UP program
return codes. An external
application can monitor UP work flow by
ProgressBar value reading, see
Work flow
monitoring
.
/q1 “Quiet” mode 1. It works same like the /q
parameter, but shows the Status form,
which is closed after programming
regardless of errors. UP does not provide
with the ProgressBar value when the /q1
parameter was used.
/e file “EEPROM” file. For keying in the name of a
file with data for data memory, if needed. If
the file name contains space(s), it must be
enclosed by inverted commas.
/noe “No EEPROM”. The program skips the
device data memory programming. If this
parameter is used for MSP430
microcontroller programming, the
information memory is erased and
programmed.
/p file To “program”. The keyed in file will be
programmed. The file can be a data file,
e.g. hex file, or UP project file. If the file
name contains space(s), it must be
enclosed by inverted commas.
/pdiff file To “program the difference”. The keyed in
file gets programmed by the differential
algorithm. If the file name contains
space(s), it must be enclosed by inverted
commas.
/o file To open. The keyed in file opens. The file
can be a data file, e.g. hex file, or UP
project file. This parameter is optional. If
the file name contains space(s), it must be
enclosed by inverted commas.
Page 64
/df file When there is UP project file specified after
the /p or /o parameter and user wants to
use the project and to change data file
only, the /df parameter with the new data
file name can be used for this purpose. If
the file name contains space(s), it must be
enclosed by inverted commas.
/eeonly This executes the selected operation only
with the data (EEPROM) memory or only
with the information memory in the case of
MSP430.
/part name This selects the required device in
UP.
/erase This erases the device.
/wnd class name A different window class name. More
than one instance of the UP program can
be started using this parameter (running
then simultaneously). Each new instance of
the running UP must have a different class
name.
/cfg If this parameter is used in combination
with parameter /p, only the configuration
memory gets programmed. This is useful
for programming AVR microcontrollers, for
example, which can be switched to a faster
oscillator and then programmed much
faster.
/devid If this parameter is used in combination
with parameter /p, the software only
checks the device's Device ID.
/blank This checks device erasure (blank check)
and returns an error code if the result is not
OK.
/verify file This verifies the device.
/read file This reads the device and saves the read
content to the file.
/s programmer_SN This makes it possible to
select a programmer by its serial number.
The serial number is to be keyed in the way
it is displayed in the UP program and
printed on the programmer bottom.
Example: 016709 or A6016709. When *
sign is used instead of the serial number,
then any available programmer of the
selected type is used.
/progname name This makes it possible to
select a programmer by its name such as
PRESTO or FORTE for example.
/noboot This skips programming of the MSP430 boot
memory.
/boot This performs the selected operation only
with the MSP430 boot memory.
Note
PIC32 microcontrollers also have a boot
memory. This, however, uses variables and
a data memory form for programming, so it
works with parameters for a data memory
and not with parameters for a boot
memory. A similar situation can be found in
the information memory of MSP430 and
CC430 microcontrollers.
/code This performs the selected operation only
with code or main memory.
/getpartrev Only reads the revision of the device
and returns revision + 0x10000 as the error
code.
/sn serial_number Using this parameter it is possible to
enter the value of the serial number, which
is then written to the address in accordance
with the serial numbers settings. In the
settings, the serial numbers have to be
configured as Computed, Manual. The
number is entered as hexadecimal, e.g.
1234ABCD.