System software | www.liberouter.org

Main page -> System software -> Manual pages

Name

svf - Tool for programming configuration PROMs via JTAG interface

Synopsis

svf [-d device] [-h] [-v] {-f file}

Description

The svf program is used for programming PROMs which store configuration of Xilinx FPGA's on COMBO6X cards. The programming data is read from Xilinx SVF file generated by Xilinx iMPACT Software.

Program is indeed a file parser and interpreter. It uses the libtap library to communicate with TAP controller in JTAG compliant devices. SVF file contains commands which specify the programming sequence and also the data, which should be shifted into the JTAG device. The program should work with every JTAG-enabled chip connected via implemented TAP connector.

Currently supported chips include:: XC18V04, XC18V512

Warning! Use this tool only if you know what you are doing. It can disable the COMBO6X card to non-bootable state. In this state the COMBO6X card won't boot due to the corrupted configuration PROM's. PROM's need to be then reprogrammed using the USB Xilinx programmer or using the parallel port TAP connector.

Warning! After running the programming process always wait for it to finish. If the process is interrupted before finish after rebooting the card may be unusable and manual assistance is needed.

Options

-d device

Specify JTAG device. Currently only these devices are supported:

/dev/combosix/N - Combo6x card device with JTAG mapped to PCI. N stands for card number.

/dev/parport/0 and /dev/parport/1 - Parallel port device with attached programming cable.

-f file

Specify SVF input file. This option is necessary.

-v

Increase verbose level. Currently two verbosity levels are available.

-h

Display program help.

Usage notes

SVF program has one necessary parameter - the input file. All other parameters are optional. The default device with TAP connector is COMBO6X device /dev/combosix/0.

You can change the default device with TAP connector by using -d option. Currently available TAP connectors are on COMBO6X card device /dev/combosix/N and parallel port device /dev/parport/0 and /dev/parport/1.

If input file is "stdin", the input is read form standard input.

Verbosity level increases its value every time the argument -v appears. Currently two levels of verbosity are available (verbose level 2 writes trace information to stderr).

The usage of the tool can be viewed by executing the tool with -h option.

Using the option "-t" you can specify the delay time between output JTAG operations in microseconds.

The svf tool uses the libtap library. For more information see the libtap doxygen documentation.

Note: The program needs access to devices in /dev directory. This may require root privileges.

Reporting Bugs

To report bug, go to https://www.liberouter.org/bugtrack/

Examples

svf -f combo6x_rev1.svf: Program PROM(s) through TAP connector connected to default device /dev/combosix/0.
svf -v -d /dev/combosix/1 -f combo6x_rev1.svf: Program PROM(s) through TAP connector at /dev/combosix/1. Be verbose.
svf -d /dev/parport/1 -f combo6x_rev1.svf: Program PROM(s) through TAP connector connected to parallel port 2 (0x278).
svf -t1 -vf combo6x_rev1.svf: Program PROM(s) through default TAP connector using delay 1 microsecond between write operations. Be verbose.