This section describes the options that are available for the PROMGen command.
This option only applies if the -p option specifies a HEX file for the output of PROMGen. By default (no -b option), bits in the HEX file are swapped compared to bits in the input BIT files. If you enter a -b option, the bits are not swapped. Bit swapping is described in the “Bit Swapping in PROM Files” section.
promgen -d hexaddress0 filename filename...
This option loads one or more BIT files from the starting address in a downward direction. Specifying several files after this option causes the files to be concatenated in a daisy chain. You can specify multiple -d options to load files at different addresses. You must specify this option immediately before the input bitstream file.
Here is the multiple file syntax.
promgen -d hexaddress0 filename filename...
Here is the multiple -d options syntax.
promgen -d hexaddress1 filename -d hexaddress2 filename...
-f command_file
The -f option executes the command line arguments in the specified command_file. For more information on the -f option, see the “-f Option” section of the “Introduction” chapter.
This option displays help that describes the PROMGen options.
-n file1[.bit] file2[.bit]...
This option loads one or more BIT files up or down from the next available address following the previous load. The first -n option must follow a -u or -d option because -n does not establish a direction. Files specified with this option are not daisy-chained to previous files. Files are loaded in the direction established by the nearest prior -u, -d, or -n option.
The following syntax shows how to specify multiple files. When you specify multiple files, PROMGen daisy-chains the files.
promgen -d hexaddress file0 -n file1 file2...
The syntax for using multiple -n options follows. Using this method prevents the files from being daisy-chained.
promgen -d hexaddress file0 -n file1 -n file2...
-o file1[.ext] file2[.ext]...
This option specifies the output file name of a PROM if it is different from the default. If you do not specify an output file name, the PROM file has the same name as the first BIT file loaded.
ext is the extension for the applicable PROM format.
Multiple file names may be specified to split the information into multiple files. If only one name is supplied for split PROM files (by you or by default), the output PROM files are named file_#.ext, where file is the base name, # is 0, 1, etc., and ext is the extension for the applicable PROM format.
promgen -d hexaddress file0 -o filename
-p {mcs | exo | tek | hex}
This option sets the PROM format to one of the following: MCS (Intel MCS86), EXO (Motorola EXORMAX), TEK (Tektronix TEKHEX). The option may also produce a HEX file, which is a hexadecimal representation of the configuration bitstream used for microprocessor downloads. If specified, the -p option must precede any -u, -d, or -n options. The default format is MCS.
-r promfile
This option reads an existing PROM file as input instead of a BIT file. All of the PROMGen output options may be used, so the -r option can be used for splitting an existing PROM file into multiple PROM files or for converting an existing PROM file to another format.
-s promsize1 promsize2...
This option sets the PROM size in kilobytes. The PROM size must be a power of 2. The default value is 64 kilobytes. The -s option must precede any -u, -d, or -n options.
Multiple promsize entries for the -s option indicates the PROM will be split into multiple PROM files.
PROMGen PROM sizes are specified in bytes. The Programmable Logic Data Book specifies PROM sizes in bits for Xilinx serial PROMs (see -x option).
-u hexaddress0 filename1 filename2...
This option loads one or more BIT files from the starting address in an upward direction. When you specify several files after this option, PROMGen concatenates the files in a daisy chain. You can load files at different addresses by specifying multiple -u options.
This option must be specified immediately before the input bitstream file.
-x xilinx_prom1 xilinx_prom2...
The -x option specifies one or more Xilinx serial PROMs for which the PROM files are targeted. Use this option instead of the -s option if you know the Xilinx PROMs to use.
Multiple xilinx_prom entries for the -x option indicates the PROM will be split into multiple PROM files.
To load the file test.bit up from address 0x0000 in MCS format, enter the following information at the command line.
promgen -u 0 test
To daisy-chain the files test1.bit and test2.bit up from address 0x0000 and the files test3.bit and test4.bit from address 0x4000 while using a 32K PROM and the Motorola EXORmax format, enter the following information at the command line.
promgen -s 32 -p exo -u 00 test1 test2 -u 4000 test3 test4
To load the file test.bit into the PROM programmer in a downward direction starting at address 0x400, using a Xilinx XC1718D PROM, enter the following information at the command line.
promgen -x xc1718d -d 0x400 test
To specify a PROM file name that is different from the default file name enter the following information at the command line.
promgen options filename -o newfilename
