Tuesday, 18 March 2008

vwjtag options \ Versa Ware JTAG Command Line v2.2.301



Versa Ware JTAG Command Line v2.2.301




Copyright (C) 2007 Ramtron
International Corporation
. All rights reserved.








This program interacts with a Ramtron microcontroller
connected with a VJTAG adaptor on LPT1 or a VJTAG-USB adaptor on a USB port. In
a command prompt or in a batch file, invoke VWJTAG by typing the following:


VWJTAG [options] "filepath"


The file path must be in quotes if it contains
spaces.


Upon success, VWJTAG will return 0 to the caller. If
there is an error, 1 will be returned.






Requirements:



  • Minimum requirements to run Windows 98, Windows ME,
    Windows NT 4.0 Service Pack 6, Windows 2000 Service Pack 3, or Windows XP
    Service Pack 2. For the VJTAG-USB, Windows XP must be used.


  • The file inout32.dll must be in the
    same directory as VWJTAG if using an adaptor that connects to LPT1.


  • The Prolific PL-2303 USB driver must
    be installed if using a VJTAG-USB on a USB port. The VJTAG-USB must be using
    firmware revision 1.1.


  • A PC with a free parallel port (DB25 connector) on LPT1
    or a free USB port (USB 1.1 or USB 2.0). Parallel ports on the PCI bus and
    parallel port to USB adaptors are not supported.







Options:



All options are preceded by a forward slash "/" and are
case insensitive.

/?


A list of all the options available for this software
will be displayed. No files will be accessed, and the parallel port will not be
affected.


/a


Verify all. After programming, all unused portions of
the flash memory will be checked to ensure that it is 0xFF in addition to
verifying that the data is correctly programmed. Use this option when the
loaded program uses in-application programming (IAP). If /v or
/p
is specified, /a is ignored.


/c


Check for correct connection only and then leave the
JTAG connected. VWJTAG will first try to connect to the device. If the manual
power control option is selected ( /m ), VWJTAG may not find
the device on the first try. If that is the case, VWJTAG will display a message
requesting a power cycle. VWJTAG will exit with CM0 low. The busy light on the
adaptor will continue to stay lit. A filename does not have to be specified for
this option.


/e


Erase the device. VWJTAG will connect to the device. If
a device is found, VWJTAG will erase the device and then it will disconnect. A
file path does not have to be specified for this option.



/f


FRAM is read only. Specifying this option on a
FRAM-enhanced MCU, such as the VRS51L3074, will lock any loaded program from
changing values in FRAM. This is similar to setting FRAM block protect from
code, but /f cannot be undone from user code. To unlock a
device from this protection, do not specify /f when
re-programming a device. This option will generate a warning if used on a
device that does not have onboard FRAM, such as the VRS51L2070.

/h


Check for correct Intel Hex file. VWJTAG will not
attempt to connect to the device, but will check the file specified by filepath
for the following:



  • Whether the file is in the Intel Hex File format
    (typically ends in .HEX or .IHX)


  • Whether the hex file's format passes its checksum
    (Indicates possible corruption or tampering)


  • The file's size in bytes (not counting blank space or
    gaps)


  • The CRC for the file (for identification in case file
    names are changed)


  • Whether any errors encountered will prevent the file
    from being used.


(Note: /h used to be invoked by /f
in previous versions)


/i


Check the settings of the device. VWJTAG will connect
to the device and read its settings. The settings returned are:



  • Clock divider: sets a factor to divide the main clock
    (either an internal oscillator or external crystal's frequency) so that it will
    consume less power at power-on. Possible values are 1 (off), 2, 4, 8,16, 32,
    64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768.


  • FRAM protection setting: If using a FRAM-enhanced MCU
    such as the VRS51L3074, indicates whether FRAM is write-protected.


  • Security setting: If active, flash memory will be read
    back as all ones, and no new values can be written to the flash memory from an
    external source (like VWJTAG or Versa Ware JTAG) without completely erasing the
    device first. This ensures that once programmed, the device cannot be tampered
    with.


/j


This option has been removed.


/k [x]


Set the clock divider to CLK/[x] where
[x]
is a power of 2. The clock divider sets a factor to divide the
main clock (either an internal oscillator or external crystal’s frequency) so
that it will consume less power at power-on. Possible values are 1 (off), 2, 4,
8,16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768. All other
values will revert to the next lowest value in the list. If not specified,
VWJTAG will keep the setting that was present on the device before. /k 1
turns the clock divider off.



Because the Nyquist-Shannon
Sampling Theorm states that the frequency of sampling must be at least 2 times
the frequency of the signal being sampled, VWJTAG and Versa Ware JTAG will not
be able to communicate with an MCU that is operating when the self-oscillator
of the device is too slow. For parallel ports, this is when the clock divider
is higher Main Clock / 128. For USB ports this is when the clock divider is
higher than Main Clock / 8. Versa Ware JTAG will prevent a device connected by
a VJTAG-USB from switching to any value slower than Main Clock / 8, but cannot
tell if a device is already operating slower than that. Failure to do so
will result in unstable operation.



This does not affect devices running from a crystal
oscillator, unless there is a configuration that requires the clock divider to
be set above Clock / 8.


/m


Manual power control. Use this setting if VWJTAG is
accessing a device on a system that cannot have its power controlled by an
external source, for example, a system that does not have circuitry to control
the level of VDD for the device. This is not the same as resetting the device
with the reset pin. If the device is conneccted with a VJTAG-USB and the
VJTAG-USB is powering the device, /m will have no effect.


/p


Do not erase before programming (Program only). Use
this option to prevent VWJTAG from erasing the device before programming. This
option is useful if there are multiple file to be loaded on the device, such as
program, and lookup tables. /p also disables the verification
phase if /a was specified.


/q


Quiet mode. VWJTAG will only print error messages when
/q
is specified, otherwise the following is output each time
VWJTAG is executed:



  1. Name and version

  2. File information (see /h for details)

  3. Erase status

  4. Program status

  5. Verification status

  6. Total time for execution

/r


Reads the flash memory to the file specified by filepath
. VWJTAG will read the flash memory to a file in Intel Hex format. Read
status will be displayed only if /q is not specified. All
65535 bytes of the flash memory will be read.


/s


Set security mode. After a successful programming
session, /s will then enable the security mode on the device.
Flash memory will be read back as all ones, and no new values can be written to
the flash memory from an external source (like VWJTAG or Versa Ware JTAG)
without completely erasing the device first. This ensures that once programmed,
the device cannot be tampered with.



/u



Run the device. VWJTAG will check for a connection and
then immediately place the device into JTAG Run mode. No file needs to be
specified.



/v



Skip the verification phase. VWJTAG will disable
automatic verification of flash contents after programming. (NOT RECOMMENDED.)


/w


Do not run the program after loading / wait for further
instructions. VWJTAG will keep the device in its program mode, keeping the
device from running its code. This is useful when loading multiple files to the
device. Without this option, the device will be placed in JTAG run mode.






Examples:


VWJTAG "C:\Your Application.hex"


Connects, verifies the file, erases, programs, verifies
the program, and then disconnects


VWJTAG /r C:\readback.txt


Connects, reads the flash memory to C:\readback.txt
, and then disconnects


VWJTAG /i


Connects, and outputs the device configurations


VWJTAG /p /w C:\loadtables.ihx


Connects, verifies the file, programs the file,
verifies the contents programmed, and then exits without running





Notes:




  • After any operation other than /h, the target device is
    left powered on in JTAG mode.

  • Code that is loaded onto a device by VWJTAG cannot be debugged.


  • If connected to a VJTAG-USB, the USB
    port will power the device while it is connected to the USB port. Rebooting the
    PC may reset the device into JTAG program mode, stopping code that was
    executing.





Disclaimers:



RIGHT TO MAKE CHANGES



Ramtron International Corporation, "Ramtron", reserves
the right to make changes to its products - including circuitry, software and
services - without notice at any time. Customers should obtain the most current
and relevant information before placing orders.



USE IN APPLICATIONS



Ramtron assumes no responsibility or liability for the
use of any of its products, and conveys no license or title under any patent,
copyright or mask work right to these products and makes no representations or
warranties that these products are free from patent, copyright or mask work
right infringement unless otherwise specified. Customers are responsible for
product design and applications using Ramtron parts. Ramtron assumes no
liability for applications assistance or customer product design.



LIFE SUPPORT



Ramtron products are not designed for use in life
support systems or devices. Ramtron customers using or selling Ramtron's
products for use in such applications do so at their own risk and agree to
fully indemnify Ramtron for any damages resulting from such applications.



DEBUGGING



Ramtron provides its debug tools for the
sole purpose of working with the customer’s own circuitry, software and
services. Any attempt to copy, disclose, disassemble, or reverse-engineer
Ramtron's circuitry, software and services, a customer's circuitry, software
and services, or a third party's circuitry, software and services, without
prior consent is not permitted by Ramtron or by its associates. Ramtron assumes
no responsibility for damages caused by any attempt to copy, disclose,
disassemble, or reverse-engineer circuitry, software or services.



No comments:

Post a Comment